Defining itemset properties
To define the properties of an itemset, select the itemset icon in the Form definition window and edit the itemset’s properties in the Properties window. As you specify properties that have an effect on the appearance of the form, the preview pane of the New Form window is updated to show the change.
The following table describes the properties that you specify to create an itemset definition:
Property |
Description |
---|---|
RefName |
RefName of the component. REQUIRED. For rules about the use of RefNames, see RefNames |
UUID |
String that uniquely identifies the component across all databases, trials, and machines. Note that the InForm Architect application automatically capitalizes UUID strings that contain lower-case characters. OPTIONAL, not needed for itemsets. |
Item Required |
Indicates whether the itemset must be completely filled in for data entry on the form to be complete. Select either True (the default) or False. If you select False, the itemset has a gray background on the CRF after submission to indicate that entry is not required. OPTIONAL. |
SV Required |
Indicates whether the itemset requires source verification. Select either True (the default) or False. If you select False, the itemset has a gray background on the SV view of the CRF to indicate that source verification is not required. OPTIONAL. |
Display Override |
Indicates whether the itemset is visible and the items within it editable. Select Read-Only to make the itemset visible but make the items within it not editable. Select Editable to make the itemset always visible and the items within it editable. Select Hidden to make the itemset invisible on a form. The item display overrides can themselves be overridden through item-level overrides in rights group permissions. For details, see Assigning display overrides to rights groups. REQUIRED. Note: To make some items within an itemset hidden, you must make the whole itemset editable, and then specify the individual items as hidden or non-editable. |
Design Note |
Free-form text, with a maximum of 255 characters, containing any information you want to capture about the design of the component. This information is for documentation only. OPTIONAL. |
Unique Key |
True or False, specifying whether items specified as Key Items for an itemset must be unique to each row of the itemset. False is the default. If Key Items are defined as unique keys and two rows are submitted with any of the same Key Item values, the InForm application rejects the input of the second row. For information about defining Key Items, see Using key items. OPTIONAL. |
The following figure shows how the new form window looks after an itemset and its properties are defined. The itemset includes one default item definition and is ready for inclusion of additional items, as necessary.