Difference between revisions of "Add a Local ID Generator"

From IMSMA Wiki
Jump to: navigation, search
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
Local ID generators are used when generating a Local ID in a Data Entry Form. The Local ID of a Data Entry Template is built up five parts:
 +
# ''Prefix'' from the Local ID generator
 +
# divider (usually hyphen) i.e. -
 +
# ''System Name'' set in IMSMA Client Configuration Tool (optional)
 +
# divider (usually hyphen) i.e. -
 +
# ''Next Number'' from the Local ID generator
 +
which for an Activity may look like ''CR-MAG HQ-1'' or for a Victim ''Vic-MACC3-4581''.
 +
 +
{| class="wikitable"
 +
|-
 +
| '''Prefix''' || A text string that represents the item category or subcategory. For example, a completion report could be represented by “CR.”
 +
|-
 +
| '''System Name''' || A value specified in the Client Configuration Tool of the {{IMSMANG}} [[Starting and Stopping IMSMANG | TrayLauncher]] where system administrators can set a separate system name for each computer where {{IMSMANG}} is installed. For example, the MAG Head quarter's computer could have “MAG HQ” as a system name while a regional installation could have “ MAG R1.”
 +
|-
 +
| '''Next Number''' || A value that increases with 1 each time a new ID is generated. Information managers can specify the next number to be generated when the local ID generator button is clicked. For example, a new local ID starting with CR-MAG HQ-1 and proceeding to CR-MAG HQ-2 and so on will be generated each time the Completion Report local ID generator is clicked.
 +
|}
 +
 
To add a local ID generator:
 
To add a local ID generator:
 
<ol>
 
<ol>
−
<li>Open the '''Customisation''' menu, and then select '''Data Entry Form Customisation > Local ID Generator'''.</li>
+
<li>In the '''Customisation''' menu &rarr;  '''Data Entry Form Templates''' &rarr;  '''Local ID Generator'''.</li>
−
::The Local ID Generator window displays.
+
 
−
<li>Click the [[File:Add.png|20px|<span title=""></span> | Add]] button.</li>
+
<li>Click the [[File:FieldTemplateIcon.png|20px | Add]] button.</li>
−
::The Local ID Generator window displays.
+
The Local ID Generator window displays.
  
 
[[File:AddLocalIDGeneratorWindow.png|240px|''Add a local ID generator'']]
 
[[File:AddLocalIDGeneratorWindow.png|240px|''Add a local ID generator'']]
  
 
<li>Enter the name for the new local ID generator in the '''Prefix''' field.</li>
 
<li>Enter the name for the new local ID generator in the '''Prefix''' field.</li>
−
::The figure below provides an example naming convention for local IDs.
 
−
 
−
[[File:Example Local ID Naming Convention.png|440px|''Figure 167. Example Local ID Naming Convention '']]
 
−
 
−
 
 
<li>In the '''Next Number''' field, enter the number you want to assign to the next object of that type that is added to IMSMA.  
 
<li>In the '''Next Number''' field, enter the number you want to assign to the next object of that type that is added to IMSMA.  
−
IMSMA will automatically assign the next sequential number to each subsequent object of the same type that is added to IMSMA. See the following table for an example of how local IDs are assigned.</li>  
+
IMSMA will automatically assign the next sequential number to each subsequent object of the same type that is added to IMSMA. </li>  
−
 
 
−
[[File:Example Assignment of a Local ID.png|440px|''Table 49.Example Assignment of a Local ID'']]
 
  
 
<li> Click the '''Save''' button.
 
<li> Click the '''Save''' button.
−
::If you do not want to save the local ID generator, click the '''Cancel''' button.</li>
+
<li> Click the '''Done''' button to close the Local ID Generator window.</li>
−
<li> Click the '''Done''' button to close the Local ID Generator window and return to the IMSMA Navigation window.</li>
 
 
</ol>
 
</ol>
 +
 +
Now is the new Local ID number series ready to be used in Data Entry Form template designer, see [[Apply a Local ID Generator]].
  
 
{{NavBox HowTo ID Generator}}
 
{{NavBox HowTo ID Generator}}
  
−
[[Category:ELR]]
+
[[Category:NAA]]

Latest revision as of 22:27, 17 June 2017

Local ID generators are used when generating a Local ID in a Data Entry Form. The Local ID of a Data Entry Template is built up five parts:

  1. Prefix from the Local ID generator
  2. divider (usually hyphen) i.e. -
  3. System Name set in IMSMA Client Configuration Tool (optional)
  4. divider (usually hyphen) i.e. -
  5. Next Number from the Local ID generator

which for an Activity may look like CR-MAG HQ-1 or for a Victim Vic-MACC3-4581.

Prefix A text string that represents the item category or subcategory. For example, a completion report could be represented by “CR.”
System Name A value specified in the Client Configuration Tool of the IMSMANG TrayLauncher where system administrators can set a separate system name for each computer where IMSMANG is installed. For example, the MAG Head quarter's computer could have “MAG HQ” as a system name while a regional installation could have “ MAG R1.”
Next Number A value that increases with 1 each time a new ID is generated. Information managers can specify the next number to be generated when the local ID generator button is clicked. For example, a new local ID starting with CR-MAG HQ-1 and proceeding to CR-MAG HQ-2 and so on will be generated each time the Completion Report local ID generator is clicked.

To add a local ID generator:

  1. In the Customisation menu → Data Entry Form Templates → Local ID Generator.
  2. Click the Add button.

    3. The Local ID Generator window displays.

    Add a local ID generator

  3. Enter the name for the new local ID generator in the Prefix field.
  4. In the Next Number field, enter the number you want to assign to the next object of that type that is added to IMSMA. IMSMA will automatically assign the next sequential number to each subsequent object of the same type that is added to IMSMA.
  5. Click the Save button.
  6. Click the Done button to close the Local ID Generator window.

Now is the new Local ID number series ready to be used in Data Entry Form template designer, see Apply a Local ID Generator.

Configuring the Items ID Generator
Retrieved from "http://mwiki.gichd.org:8090/mediawiki/index.php?title=Add_a_Local_ID_Generator&oldid=23648"