The Metadata example.ini file that comes with our installation looks like this:
The resulting Metadata dialog looks like this:
Blocks
#BLOCK: Specifies a group of variables. It requires a unique 'paramname' and a 'label', which serves as a header for the information block.
In this example, the paramname=general and the label=General data. The Metadata dialog image shows how that looks.
The min= value specifies if the block is part of the Metadata-form per default or not:
1=visible, 0=not visible.
In the example the General data block is always visible.
The max= value specifies how often a block can be used per session.
In this example, the general block is always visible and can only occur once.
The participant block is visible once but can be filled out 3 times in total.
This means the user can add the participant block up to three times, so it can be used for up to three participants.
Type
#PARAM: specifies the fields for each block. It requires a unique 'paramname' and a 'label' which names the field.
Per field you need to specify its type behind edittype=
The following field types are available:
oedit - results in a free text field in which the user can enter anything
olist - requires the specification of Values and the user can make a selection from those predefiend answers.
olistedit - requires the specification of Values and the user can make a selection from those predefiend answers but is also able to enter custom information instead.
oCheck - results in a check-box with a label that can be selected or cleared.
In this example, the Exact location is a free text field without default text, but filling it out is required.
The field Study offers a value list with three values (Study A, Study B, and Study C), the default value is 'Study A' but a selection is not required.
The Researcher information is again required but needs to be entered manually in a free text field.
Values
Values for a values list must be entered behind Values= and must be separated by a vertical line character, like this:
Values=Study A|Study B|Study C
If you want to specify a default value, enter that value behind default= .
Required
To label a specific field as Required, add ', required' at the end of the field parameter line. Required fields are labeled with a * in the Metadata recording form.
Extend Metadata Form
The way this Metadata example.ini is created enables the operator to add up to five participate blocks and unlimited Observer blocks to collect the requested information for as many observers as present. |
Delete unused Blocks
You cannot delete required blocks, but if you added a block too many manually, you can use the Delete block menu to delete obsolete blocks from the last one up: |
