Changes

Jump to: navigation, search

Documenting Customisations

529 bytes added, 16:41, 20 February 2013
no edit summary
After the desired data elements and field report templates are customised and published, the next step is to define and document the information workflow for each type of field report. This is a critical step for ensuring the quality of the data stored in IMSMANG. It involves combining the workflow rules identified in Chapter 1 with the field report templates defined in Chapter 2 to create a set of workflows that can be documented as instructions or SOPs for entering and reconciling data in IMSMANG. Each workflow and SOP should include rules for:
*assigning locations *updating and replacing items*linking items
With these rules defined, information managers can help improve data consistency and ease of searching and reporting while reducing data entry errors and the effort to correct them later. Information managers can also develop data quality searches and reports that identify and enforce the information workflows. The diagram below identifies a basic information workflow, but information managers should provide guidance to data entry personnel for how the workflow should proceed in their programmes.
 
[[Image:AdminGuide_ExampleBasicInformationWorkflow.png|center|500px|''Example of a Basic Information Workflow'']]
<div align="center">
''Example of a Basic Information Workflow''
</div>
==Creating a Programme Specific User Guide==
Creating a programme-specific user guide is a critical step in communicating information management concepts and decisions to IMSMANG users, particularly because IMSMANG is so customisable. With a programme-specific user guide information managers can:
* ensure faster training of information management and operations staff* reduce the likelihood and impact of data quality problems* provide an easy reference for data entry personnel and users of IMSMANG information
The following sections provide guidance on creating a programme-specific user guide that supplements the IMSMANG User Guide with specialised steps for how information should be managed within the programme.
In this section, information managers should define each item and process that will be tracked in IMSMANG. Following the recommendations in XXX, this information should include:
* description of each item category and subcategory that will be used (see Items)* definition of what each item category and subcategory will be used for (see Items)* list of key data elements including custom-defined fields (see Items)* description of the relationships among items (see Assigning and Linking)* list of the status values for each item (see Status Changes)* direction for how locations will be used (see Location)* description for how tasking will be used (see Tasking Tool)
===Workflow and Business Rules===
When the relevant items, processes and workflows are identified and documented, information managers should provide guidelines to assist data entry personnel in correctly entering, reconciling and linking data according to the processes. The guidelines should include an entry for each of the field report templates to be used and a description for how each should be entered. At a minimum, these guidelines should include:
* name and description for each field report template* list of required fields and what the values should be* definition of how the items in the field report should be reconciled (as new or as updates)* description of how to determine the location for each item in the form if it is new* definition of which existing items should be linked to the items in the field report
===Outline to Follow===
Below is an outline of a programme-specific user guide with suggestions for content to include in each section.
1. <ol><li>Overview</li>2. <li>Items and Processes</li><ol type="a. "><li>Locations</li>b. <li>Hazards</li><ol type="i. "><li>Suspected hazardous areas (SHA)</li>ii. <li>Confirmed hazardous areas (CHA)</li>iii. <li>Minefields</li>iv. <li>UXO spots</li></ol>c. <li>Hazard reductions</li><ol type="i. "><li>Technical surveys</li>ii. <li>Clearances</li>iii. <li>Progress reports</li>iv. <li>Completion reports</li></ol>d. <li>MRE activities</li>e. <li>Quality management</li><ol type="i. "><li>Quality assurance reports</li>ii. <li>Quality management reports</li></ol>f. <li>Accidents and victims</li><ol type="i. "><li>Demining accidents</li>ii. <li>Mine accidents</li>iii. <li>Civilian victims</li>iv. <li>Demining victims</li></ol>g. <li>Auxiliary data</li><ol type="i. "><li>Places</li>ii. <li>Organisations</li>iii. <li>Ordnance</li></ol></ol>3. <li>Workflow and business rules</li><ol type="a. "><li>CHA/minefield clearance workflow</li>b. <li>Spot UXO clearance workflow</li></ol>4. <li>Data entry guide</li><ol type="a. "><li>Entering a new minefield form</li>b. <li>Entering a minefield update form</li>c. <li>Entering a hazard status change form</li>d. <li>Entering a new clearance form</li>e. <li>Entering progress reports</li></ol></ol>
0
edits

Navigation menu