📋Lists

The list is a type of field pre-filled with several values.

By default there are already pre-filled lists, like the list of all countries or the most used migration routes.

Default pre-filled lists

Here is a look at the list of countries :

List of countries

Use a list as a field

For example, we would like to create a field for our form where the user would have to fill in the initial destination country of a person.

Bottom of the Field creation page : we choose the country list

If we create a field called "Destination" and attach the list countries to it (as seen in the image above), then the user will have a dropdown in his creation form containing all the countries and will be able to select one for the value of this field :

Once you selected list type in Person creation page : the user have to choose a country from the list as a destination.

Create a new List

If you have a particular need you can create new lists that you can populate manually. For example, you could create the list "birds" which contains the 20 most common bird species ( => "Add list" button on the List index page).

You wil have 3 fields to fill during the creation process :

• List's title : This is simply the name given to your list

• List's fields : In this section, you may define all the fields that are required to describe an element of your list. As an example you can create 'name', 'color' if you want to create a list related to Birds.

• Displayed value : here you have to choose one of the fields of the elements of your list as displayed value : if you choose the 'name' field, the name of the element will be shown in the dropdown when choosing one of the birds.

You will then have the following view: your list is empty, you just have to populate it with the "Add an element to the list" button.

empty list of common birds

When adding a new element to the list, you will need to fill all the required fields :

add to common birds view

You will then have your list, populated with the elements you want :

common bird populated list

Now, if you want to use our solution to reference the birds you saw in your garden, you just have to create a new team, and create one field as an extension of the common birds list :

Using common birds list as the associated list when creating the field

So, when a user of your team adds an item it will look like this :

adding a 'person' inside the new team "birds_lover" with asingle field bird (with associated list "common bird")

You now know all the details of SCAN's modularity, and your form is ready to be used by all the users in your team.

In the next section, we will detail the classic use of SCAN on the editor/viewer side.