Changes

Jump to: navigation, search

Documenting Customisations

136 bytes added, 11:53, 8 July 2013
no edit summary
{{TOC right}}
__NOEDITSECTION__
==Document Workflows and Business Rules==__NOEDITSECTION__
After the desired data elements and Data Entry Form templates are customised and published, the next step is to define and document the information workflow for each type of Data Entry Form. This is a critical step for ensuring the quality of the data stored in IMSMA<sup>NG</sup>. It involves combining the workflow rules identified in Chapter 1 with the Data Entry Form 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 IMSMA<sup>NG</sup>. Each workflow and SOP should include rules for:
</div>
==Creating a Programme Specific User Guide==__NOEDITSECTION__
Creating a programme-specific user guide is a critical step in communicating information management concepts and decisions to IMSMA<sup>NG</sup> users, particularly because IMSMA<sup>NG</sup> is so customisable. With a programme-specific user guide information managers can:
}}
===Content to Include===__NOEDITSECTION__
The guide should document the programme-specific customisations of IMSMA<sup>NG</sup> as discussed in Chapter 1 and Chapter 2 of this manual. It should provide straightforward, task-specific guidance and avoid complicated discussions of possible options and conditions. Ideally, the guide is an intermediate document that bridges the gap between the goals, objectives and terms of reference of information management and the specific “how-to” instructions in the IMSMA<sup>NG</sup> User Guide.
===Overview===__NOEDITSECTION__
The Overview section should cover basic information about the guide, its purpose and intent and about information management responsibilities. It should describe the overall workings of IMSMA<sup>NG</sup> including the configuration of the IMSMA<sup>NG</sup> system within the programme as well as the number of users and basic roles and responsibilities.
===Items and Processes===__NOEDITSECTION__
In this section, information managers should define each item and process that will be tracked in IMSMA<sup>NG</sup>. Following the recommendations in XXX, this information should include:
*description for how tasking will be used (see Tasking Tool)
===Workflow and Business Rules===__NOEDITSECTION__
This section should define the workflows and business rules that are to be followed when collecting and updating land and activity information. Workflows identify the processes (activities) undertaken on a land and the resulting status changes, from identification to clearance and completion. Include a workflow for each different kind of land in use
===Data Entry Process and Guidelines===__NOEDITSECTION__
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 Data Entry Form templates to be used and a description for how each should be entered. At a minimum, these guidelines should include:
*definition of which existing items should be linked to the items in the Data Entry Form
===Outline to Follow===__NOEDITSECTION__
Below is an outline of a programme-specific user guide with suggestions for content to include in each section.
4,913
edits

Navigation menu