Changes

{{noteNew_6.0|Custom defined fields must have a unique combination of item, label, '''name''' and data type. }}

To add a custom defined field[[Image:DIM category.png|600px|center]]

<li>From In the '''Customisation''' menu, select &rarr; '''Data Inventory Manager'''.</li>:The <li>'''[[Filter Item Attributes | Search]]''' the Data Inventory Manager window displaysbefore you add a CDF in order to make sure that a suitable system field does not already exist.</li><li>From In 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.</li><li>From In the right pane of the Data Inventory Manager window, click the [[Image:FieldTemplateIcon.png]] button.</li>:The CDF Editor window displays.</ol>

</div></li><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. <ol br/>::* cannot contain . , / \ ( ) ! ? - @ ::* cannot contain space/blanks::* cannot contain capital/upper case character::* cannot start="4"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. The label should be no longer than 50 characters and should not contain periods (.) or underscores (_).</li><li>Select the data type for the custom defined field from the '''Data Type''' list.<The general recommendation is to avoid text fields if the CDF will be used for search/li><filter, statistics, maps and/ol>or data quality. Users will enter data differently in text fields e.g. many different spellings of an organisation name so it is preferable to use data entry widgets where the user selects over text widget.

! colspan="2" | Table 46. Data Types for Custom Defined Fields

| ≤250 unlimited characters

| Month, day, yeartimestamp (2016-12-01 15:33:59.187)

| ≤15 decimal pointswith 6 decimals

| Allows the user to select organisational dataan Organisation

| Allows the user to select place dataa Place

| Allows the user to select country from the Country structure level data

| Allows the user to select zero or more values provided in the '''List CDF Values''' field.

| Allows the user to select one value from provided values in the '''List CDF Values''' field.

<li>If Go through the CDF is active, check the '''Active''' checkbox.</li><li>If you selected the ''Multiple Select'' or 'checklist for implementation of 'Single Select'' option, click the [[Image:FieldTemplateIcon.pngCustom Defined Fields]] button.</li>:The Add window displays.<li>Enter the value for the list in the '''Value''' field.</li>

{{note|When entering === Adding values for listsmulti- and single-select CDFs===__NOEDITSECTION__ If you selected the ''Multiple Select'' or ''Single Select'' option, be sure toclick the [[Image:FieldTemplateIcon.png]] button.[[Image:CDF value.png|center|300px|''Add multi- and single-select value window'']]<div align="center">''Add multi- and single-select value window''</div>*Enter values the value for the list in the order that '''Value''' field.When you would like them to display to have completed entering the user*Enter values in for the language in which list, click the users will use IMSMA}}'''Done''' button.

<ol start="10"><li>Do one of the following:</li>*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.<li>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.</li> <li>Enter a description for the custom defined field in the '''Description''' field.</li></ol> {{noteNote|You can also translate the label and, if applicable, list option values by clicking the '''Translate''' button at this time. }} <ol start="12"><li>Do one of the following:</li>*To save the custom defined field and close the CDF Editor window, click the '''Save''' button.:If the custom defined field See [[Translate Custom Defined Fields]] for more information is successfully saved, the CDF Editor window closes and the custom defined field is listed in the Data Inventory Manager window. After the custom defined field is added, it becomes available from the folder of the data category in which it was created in the Data Entry Form Manager. </ol> {{note|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.}} <ol>*To discard the custom defined field and close the CDF Editor window, click the '''Cancel''' button.</ol>