Managing lists

Lists contain coded and labelled values and are used in forms in order to helps users select values instead of writing them. In a MICHAEL instance, lists are stored in a special folder at the root, called Lists . The platform provides some help in order to create and manage lists.

All functionalities described below are available to users members of the group list-managers .

1) Creating a list

Please note that newly created lists are not used in the forms unless these forms are configured to do so. To create a new list, you must go through the standard process of creating a document. Anywhere in the database, you can click on the Create a document button:

Then you will get a form, where you can select the datatypes/default/list datatype and the following form and templates:

Once you click on the Create the document button, you will be asked to confirm the saving of the list:

Click on the Save the document button, and then you will be asked for the identifier:

Write a unique identifier for your list and then click on the Create the identifier button. The list will be created, and you will be back to browsing. To add items in the list, please follow the next section.

2) Modifying list contents

A list contains item. An item must have unique code and one or more labels or values. A label has a language. To modify the items of a list, browse to the Lists directory at the root of the database, and then click on the Edit icon in front of the appropriate list:

Once this is done, you will get a form like this one:

To update an item, select it in the drop-down list at the top, and then you can either modify the values, add a value or remove the item. To add a new item, type in a code and at least one value (with its associated language). To change the order of items, click on the Organize your items link. You will get this form:

You can use the drop-down list to select an item (by its code) and to move it before or after another item.