This tab is used to define lists of codified information that will be used throughout the survey to provide options for specific fields during the data entry phase. If the user selected one of the pre-filled templates, several Code lists are loaded automatically. They include codified lists to define, for example, accessibility, land use classes, ownership etc. These fields are set up in accordance to pre-defined classification schemes however the user is free to add, remove or modify them. Code lists can be used to classify a wide range of attributes such as administrative levels, personnel, topographic elements and many more.
Adding a Code list
Code lists can be added in two ways: "manually" or by importing a pre-prepared file in csv format.
To add a code list manually click on the Green "+" button (bottom left corner of the window) and proceed to fill in: Name [mandatory field] (eg. region), Label: (eg. AdmLev-1-Reg), and Description (any additional specification). Then select the List type: whether the code list is flat or hierarchical. A flat list has a binary structure while a hierarchical list allows for sub (nested) levels. [See list types examples below].
Once a code list has been named, the actual items (codes and labels) should be entered.
Code and Label of each item of the code list can be added by clicking the smaller green "+" button and filling in Code [mandatory field] (eg. "1") and Label (eg. Northern). This should be repeated for as many items there are in the Code list. Each item can then be edited (click on edit icon) or deleted (red "-") button.
The user can also wish to include a Specify field by clicking the appropriate box. In this way, it will be possible to specify unlisted values in a text input field that will appear next to the code list item in the data entry form.
In order to keep a separate record of the code list, it is suggested to Export the code list by clicking the Export button (at the bottom of the window). This will automatically generate and download a csv file.
In the case of hierarchical Code lists, multple levels can be added by clicking on the "Add level" button.
While the manual process for adding code lists is perfectly legitimate and can be used for simple lists, for more complex list (eg. list that have many items or with a hierarchical structure) it is strongly recommended to prepare them in advance and upload them into Collect by clicking the Import button (at the bottom of the window). When clicking Import a pop up window will open and the user can import a code list (flat or hierarchical) from a csv file. From the same window the user can also download an example file, while clicking on the blue "i" button will open a window with specifications on how to set up the csv file.
To import the csv file, click on Select file, locate the file within your directory and then click on Start import. Upon successful upload an Import completed message will appear, click ok and proceed with a new upload or, if done, click close at the bottom of the window.