Difference between revisions of "Add values to enumeration list"

From IMSMA Wiki
Jump to: navigation, search
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{note|Adding a value to an enumeration list will not automatically update existing Data Entry Form Templates that use the enumeration list.  
+
{{Warning | Several of the enumeration lists are used by more than one field. Adding a value to an enumeration list will affect '''ALL''' fields that use that same enumeration list.
}}
+
The enumeration list/category ''Yes No Answer'' are used by 86 fields. 42 of the 186 enumeration lists/categories are used by more than one field. }}
 +
 
 +
<center>
 +
{| class="wikitable"
 +
|-
 +
| [[Image:CustomOptionsList warning1.png|400px]]
 +
| width="10pt" |
 +
| [[Image:CustomOptionsList warning2.png|400px]]
 +
|-
 +
| The values ''Ferrimagnetic'' and ''Titanomagnetites'' are added.
 +
|
 +
| The other fields that uses the same enumeration list are also affected.
 +
|}
 +
</center>
 +
 
 +
Before adding values to enumeration lists:
 +
# consult the '''[[Data Dictionary]]'''
 +
# look up which enumeration list/category is used
 +
# consult the page [[Enumeration categories]] and verify that the category that you are about to update is not listed.
 +
# is it possible to edit slightly the translation of an existing enumeration value instead of adding a value?
  
 
As an example the field ''Type of Infrastructure Blocked'' which used the enumeration list/category ''InfrastructureBlock'' will be used.  
 
As an example the field ''Type of Infrastructure Blocked'' which used the enumeration list/category ''InfrastructureBlock'' will be used.  
 
<ol>
 
<ol>
<li>From the '''Customisation''' menu, select '''Data Inventory Manager'''.</li>
+
<li>In the '''Customisation''' menu &rarr; '''Data Inventory Manager'''.</li>
 +
[[Image:DIM enum.png|600px|center]]
 
<li>In the left pane of the Data Inventory Manager window, expand the item and data category where the the field is which uses the enumeration list.</li>
 
<li>In the left pane of the Data Inventory Manager window, expand the item and data category where the the field is which uses the enumeration list.</li>
<li>In the right pane, click the row associated with the item attribute that you would like add a custom option value.  
+
<li>In the right pane, click the row associated with the field that you would like to add a enumeration value to.  
 
: Only system fields of types Multiple Select or Single Select use enumeration lists.</li>
 
: Only system fields of types Multiple Select or Single Select use enumeration lists.</li>
 
<li>Click the [[Image:FieldViewIcon.png]] button. </li>
 
<li>Click the [[Image:FieldViewIcon.png]] button. </li>
Line 26: Line 46:
 
<li>In this example the next step is to '''[[Inactivate values in enumeration lists | inactivate]]''' the value ''Medical facility''.</li>
 
<li>In this example the next step is to '''[[Inactivate values in enumeration lists | inactivate]]''' the value ''Medical facility''.</li>
 
</ol>
 
</ol>
{{note|After adding an option, you should update Data Entry Form Templates that use the custom options field.}}
+
{{Note|Adding a value to an enumeration list will not automatically update existing Data Entry Form Templates that use the enumeration list.
 +
If the enumeration list/category that you would like to add a value to are used by more than one field and the value(s) you would like to add is '''not''' suitable for all affected fields <br/>
 +
then it is recommended to use a '''[[Add Custom Defined Fields | CDF]]''' instead.}}
 
{{NavBox HowTo Data Elements}}
 
{{NavBox HowTo Data Elements}}
 
[[Category:NAA]]
 
[[Category:NAA]]

Latest revision as of 19:16, 17 June 2017

Warning.jpg Several of the enumeration lists are used by more than one field. Adding a value to an enumeration list will affect ALL fields that use that same enumeration list.

The enumeration list/category Yes No Answer are used by 86 fields. 42 of the 186 enumeration lists/categories are used by more than one field.

CustomOptionsList warning1.png CustomOptionsList warning2.png
The values Ferrimagnetic and Titanomagnetites are added. The other fields that uses the same enumeration list are also affected.

Before adding values to enumeration lists:

  1. consult the Data Dictionary
  2. look up which enumeration list/category is used
  3. consult the page Enumeration categories and verify that the category that you are about to update is not listed.
  4. is it possible to edit slightly the translation of an existing enumeration value instead of adding a value?

As an example the field Type of Infrastructure Blocked which used the enumeration list/category InfrastructureBlock will be used.

  1. In the Customisation menu → Data Inventory Manager.
  2. DIM enum.png
  3. In the left pane of the Data Inventory Manager window, expand the item and data category where the the field is which uses the enumeration list.
  4. In the right pane, click the row associated with the field that you would like to add a enumeration value to.
    Only system fields of types Multiple Select or Single Select use enumeration lists.
  5. Click the FieldViewIcon.png button.
  6. Custom Options List Window

    Custom Options List Window

  7. As an example: it has been decided that Medical Facility is not detailed enough. Health Care Center and Hospital should be used instead.
  8. In the Custom Options List window, click the FieldTemplateIcon.png button.
  9. Options Editor

    Options Editor

  10. Enter the option in the Option field. The value can be maximum 50 characters and can contain letters and numbers. Other characters should be avoided.
  11. Click the Save button.
  12. Repeat until all values are added.
  13. In this example the next step is to inactivate the value Medical facility.
Note.jpg Adding a value to an enumeration list will not automatically update existing Data Entry Form Templates that use the enumeration list.

If the enumeration list/category that you would like to add a value to are used by more than one field and the value(s) you would like to add is not suitable for all affected fields
then it is recommended to use a CDF instead.