Difference between revisions of "Add Custom Defined Fields"
From IMSMA Wiki
Line 17: | Line 17: | ||
<ol start="4"> | <ol start="4"> | ||
− | <li>Enter a name in the Name field. The name should be | + | <li>Enter a name in the Name field. The name should be |
+ | # maximum 60 characters long | ||
+ | # only allowed characters are a - z and 0 - 9 i.e. <br/> | ||
+ | ::* cannot contain . , / \ ( ) ! ? - @ | ||
+ | ::* cannot contain space/blanks | ||
+ | ::* cannot contain capital/upper case character | ||
+ | ::* cannot start with a digit.</li> | ||
<li>Enter a label in the Label field. The label is the default custom defined field’s name that the user will see in the Data Entry Form Manager window. </li> | <li>Enter a label in the Label field. The label is the default custom defined field’s name that the user will see in the Data Entry Form Manager window. </li> | ||
<li>Select the data type for the custom defined field from the '''Data Type''' list.</li> | <li>Select the data type for the custom defined field from the '''Data Type''' list.</li> |
Revision as of 18:06, 3 July 2015
![]() |
Custom defined fields must have a unique combination of item, name and data type. |
To add a custom defined field:
- From the Customisation menu, select Data Inventory Manager.
- The Data Inventory Manager window displays.
- From the left pane of the Data Inventory Manager window, select the item and the data category to which you would like to add a CDF.
- From the right pane of the Data Inventory Manager window, click the
button.
- The CDF Editor window displays.
CDF Editor Window
- Enter a name in the Name field. The name should be
- maximum 60 characters long
- only allowed characters are a - z and 0 - 9 i.e.
- cannot contain . , / \ ( ) ! ? - @
- cannot contain space/blanks
- cannot contain capital/upper case character
- cannot start with a digit.
- Enter a label in the Label field. The label is the default custom defined field’s name that the user will see in the Data Entry Form Manager window.
- Select the data type for the custom defined field from the Data Type list.
Data Types for Custom Defined Fields | |
---|---|
Data Type | Description and Comments |
Text Field | unlimited characters |
Date | Month, day, year |
Number | ≤15 decimal points |
Organisation | Allows the user to select organisational data |
Place | Allows the user to select place data |
Country Structure | Allows the user to select country structure level data |
Multiple Select | Allows the user to select zero or more values provided in the CDF Values field |
Single Select | Allows the user to select one value from provided values in the CDF Values field |
- Enter a description for the custom defined field in the Description field.
- For Text and Single Select CDFs, there are two different display formats to choose between.
- If you selected the Multiple Select or Single Select option, click the
button.
- The Add window displays.
- Enter the value for the list in the Value field.
Display formats
![]() |
In version 6.0 two different display formats for Text fields has been introduced. |
![]() |
When entering values for lists, be sure to:
|
- Do one of the following:
- If you would like to save the value and enter additional values, click the Save button.
- If you have completed entering the values for the list, click the Done button.
- If you selected the Single Select option, chose an option from the Selection Display field to display the CDF as either a list of radio buttons or as a combo box.
![]() |
You can also translate the label and, if applicable, list option values by clicking the Translate button at this time. See Translate Custom Defined Field Labels for more information. |
- Do one of the following:
- To save the custom defined field and close the CDF Editor window, click the Save button.
- If the custom defined field information is successfully saved, the CDF Editor window closes and the custom defined field is listed in the Data Inventory Manager window.
![]() |
If you would like to add the custom defined field to existing data entry form templates, you will need to update and republish the data entry form template. |
- To discard the custom defined field and close the CDF Editor window, click the Cancel button.
|