Table of contents
Import Submissions
Importing Submissions into Zite allows you to take data collected outside of your project and import it into Zite as if it were a new submission. This can be useful if you have data from before you started using Zite Manager that you want to add or if you have data collected through the same kobo form but not in Zite Manager. For example, if you or a partner conducted an assessment in Kobo and then want to add this into your project, this feature will help you a lot. You can also use this feature to import data from one project in Zite into another. Some things to note:
The form you want to import data into must be deployed to your project.
You must download the template for that specific form through the interface.
The form will have the same field structure as a regular ODK/Kobo data export with some additional fields (discussed below).
Data must be formatted in the same way ODK/Kobo reads and understand form submissions. Some question types, such as select-one, select-multiple, geopoint, and date require specifically formatted inputs in order to be read correctly by Zite after the import.
Data imported through this feature will have all workflows and form settings applied as if it were manually submitted.
Additional Fields
The template will have three fields at the end that you manually have to fill out:
site_identifier - Refers to the site ID of the site you want to import the submission into.
form_id - Refers to the id of the form you want to import data into. This can be found on the import submission section or on the form section of the settings page.
bu_track_id - Is an index of your submissions. The first row should be given the value of 1, the second as 2, and so on until the end of your rows.
Example
This is the survey that we want to import data into, it has the id 79.
type | name | label::English (en) |
integer | age | What is their age? |
text | name | What is their name? |
select_multiple fruit | fruit | What fruits do they like? |
select_one fruit | favourite_fruit | What is their favourite fruit? |
This is the choice list of the survey
list_name | name | label::English (en) |
fruit | fruit_1 | Apple |
fruit | fruit_2 | Pear |
fruit | fruit_3 | Orange |
This is an example of the information that needs to be included to import data into this form.
Field Names | Submission 1 | Submission 2 |
age | 16 | 18 |
name | Candice | Gyapan |
fruit | fruit_2 fruit_3 | fruit_1 |
favourite_fruit | fruit_3 | fruit_1 |
site_identifier | australia | nepal |
form_id | 79 | 79 |
bu_track_id | 1 | 2 |