Difference between revisions of "Reconcile"

From IMSMA Wiki
Jump to: navigation, search
 
(52 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{| style="border-top:2px solid lightgray; border-bottom:2px solid lightgray; margin:10px;"
+
{{TOC right}}
|align="left" style="padding: 5px 10px 5px 10px"| To reconcile data entry forms, you must have access to the Data Entry Form and Link permissions.
+
The Data Entry process consists of three major steps:
 +
# Reconcile
 +
# Data Entry
 +
# Approve.
 +
 
 +
The major steps consist in their turn of several subtasks which may be carried out by one or more different persons and/or stakeholders in the Mine Action programme. For data quality purposes, it is important that the data is adequately checked. With multiple permission levels for the Approval workflow, different users can be assigned different permissions, allowing Mine Action Programmes to implement a data-entry workflow that distinguishes between data '''entry''' and data '''verification''' roles.
 +
 
 +
{| class="wikitable"
 +
|-
 +
|  '''Reconcile'''||
 +
# Does it exists in DB?
 +
# Select Action
 +
# Select template
 +
|-
 +
| '''Data Entry'''||
 +
# Data Entry itself
 +
# Link(s)?
 +
|-
 +
| '''Approve'''||
 +
# Save
 +
# Peer-review
 +
# Submit
 +
# Final review/Data QA
 +
# Approve
 
|}
 
|}
  
<p>Before a data entry form can be approved, you must decide whether the item records in the data entry form create new item records, update existing item records, or are associated with existing item records of different item types. This process is called ''reconciliation''.</p>
+
==Reconcile==__NOEDITSECTION__
<p>New item records will create a new accident, land, activity, location, education, QM, or victim in IMSMA. New item records will need to be assigned to a location.</p>
+
Reconcile means to make two sets of numbers add up to the same total which with IMSMA terms is the process of getting all different subsets of Mine Action information in a country (e.g. operators' clearance information) to a correct and coherent national database.
<p>data entry form item records can also update existing item records. Updates to existing item records can either replace an existing item record or combine certain item record attributes. When an existing item record is replaced, the summary of the existing item record is replaced with the data from the new item record. When an item record in a data entry form is combined with an existing item record, certain item record attributes are overwritten with the data from the new item record while other item record attributes are combined. Refer to the ''Combining item records'' section for more details on which item attributes are combined for each item.</p>
 
<p>data entry form item records can also be associated with existing item records that are of a different type. For example, a victim that is created by a new data entry form can be associated with an existing accident. To establish a relationship between item records of different item types, you create a ''link'' between the item records.</p>
 
<p>Item records can be reconciled from either the Reconciliation tab on the Data Entry Form Editor window or the Report Items tab on the IMSMA Navigation window, which is accessed from the Reconciliation tab by clicking the [[Image:ShadesIcon.png]] button. The Reconciliation tab and the Report Items tab display all item records from the data entry form that need to be reconciled.</p>
 
  
[[Image:ItemRecordsFieldReportEditorWindow.png|center|600px|''Item Records on Data Entry Form Editor and IMSMA Navigation Windows'']]
+
=== New or existing item ===__NOEDITSECTION__
<div align="center">
+
Before a data entry may start, both at data providers such as operators and at National Mine Action Authority, the first and very important task is to determine if the piece of information that is received on a paper or as xml already exists in the database or not.
''Item Records on Data Entry Form Editor and IMSMA Navigation Windows''
+
 
</div>
+
New information can be of two different types:
 +
* information about a new item: For example a Land or a Victim that is previously not reported/entered into {{IMSMANG}}. The Land might have been contaminated 10 years ago or the Victim injured 5 years ago but from our {{IMSMANG}} perspective it is '''new''' due to it is '''not''' in the database.
 +
* new information about an existing item: For example a polygon of an existing Land that previously did not have that recorded in the database or a correction of date of birth for an existing Victim.
 +
 
 +
The report that is received in both cases may not look any different so it is vital that the process of new information classification is thorough. Read more about Summary items and Data Entry Forms '''[[Understanding IMSMA Information Model#Data Entry Forms and Summaries | here]]'''.
  
Reconciling item records from the Data Entry Form Editor window allows you to select existing item records from a list. Reconciling item records from the IMSMA Navigation window allows you to browse existing item records using the items pane and the map. The reconciliation icons used in the Data Entry Form Editor window and IMSMA Navigation window are similar and described in Table 24. The sections in this chapter provide instructions for reconciling item records from both the Data Entry Form Editor window and the IMSMA Navigation window.
+
{{Decision node| It should be outlined in the Data Entry SOP whose responsibility it is to determine if it is a new item or updating information about an existing item.}}
  
 +
=== Select Data Entry Action ===__NOEDITSECTION__
 
<center>
 
<center>
{| class="wikitable" width="600"
+
{| align="center"
 +
|- valign="top"
 +
|
 +
{| class="wikitable" width="950"
 +
! colspan="4" align="center"| Data Entry Actions
 
|-
 
|-
| align="center" colspan="2" | '''Reconciliation Icons'''
+
! Type
 +
! Name
 +
! When to use
 +
! Action
 
|-
 
|-
| width="125pt" | '''Icon'''
+
| rowspan="2"| '''From Data Entry menu'''
| width="475pt" | '''Description'''
+
| [[Reconcile as New]]
 +
| '''Only''' for New Locations
 +
| New
 
|-
 
|-
| align="center" | [[Image:AssignLocIcon.png]] || Creates a new item record.
+
| [[Reconcile as Existing Item]]
 +
| Is '''not''' recommended anymore (Replace/Combine)
 +
| Replace/Combine
 
|-
 
|-
| align="center" | [[Image:ReconItemRecIcon.png]] || Allows you to reconcile item records with existing item records that you select from a list.
+
| rowspan="3"| '''From Summary window'''
 +
| [[Add a Data Entry Form from the Summary Window | Add from Summary Window]]
 +
| Not for New Locations
 +
| New
 
|-
 
|-
| align="center" | [[Image:LinkItemRecIcon.png]] || Allows you to create a link between two item records of different item types.
+
| [[Update from Summary Window]]
 +
| To update existing data
 +
| Update
 
|-
 
|-
| align="center" | [[Image:RemoveReconIcon.png]] || Removes the reconciliation or link between the item records.
+
| [[Delete from the Summary Window | Delete from Summary Window]]
 +
| If the item should be Deleted from the database
 +
| Delete
 
|-
 
|-
| align="center" | [[Image:ShadesIcon.png]] || Allows you to reconcile item records with existing item records that you select from the map. This icon is only available from the Data Entry Form Editor window.
+
| rowspan="4"| '''Other Reconcile Actions'''
 +
| [[Link to Existing Item]]
 +
| Link may be used in combination which several of the other Actions
 +
| Link
 
|-
 
|-
| align="center" | [[Image:ReturnReconIcon.png]] || Returns any reconciliation done from the IMSMA Navigation window to the Data Entry Form Editor window. This icon is only available from the IMSMA Navigation window.
+
| [[Reassign Item to another Location]]
 +
| Special updating Action when to which Location an item is assigned
 +
| Change Location
 +
|-
 +
| [[Unlink Items]]
 +
| Special updating Action when items need to be Unlinked
 +
| Unlink
 +
|-
 +
| [[Unapprove a Data Entry Form from the Summary Window | Unapprove a Data Entry Form]]
 +
| If this Action is used, all traceability and transparency is lost
 +
| N/A
 
|}
 
|}
 
</center>
 
</center>
 +
 +
Depending on which Action you choose the Reconciliation tab of the Data Entry Form will be populated different. The Actions in the ''From Summary window'' and ''Other Actions'' automatically populates the Reconciliation tab.
 +
 +
[[Image:Recon tab Add from non-Location.png|600px|center]]
 +
<div align="center">
 +
'' Example of Reconciliation Tab ''
 +
</div>
 +
 +
{{New_6.0 | Add, Update and Delete from Summary window were added in version 6.0.}}
 +
 +
=== Select Data Entry Form template===__NOEDITSECTION__
 +
Next decision is to choose which template to use for the Data Entry. It might be appropriate to have more than one Data Entry template for one item, e.g. one for the information about the Victim and another template for Victim Needs Assessment. The item Activity is an example where each process has their own template, i.e. Non-Technical Survey, Technical Survey, EOD Spot Task, Completion Report, Post-Clearance Survey, etc.
 +
 +
[[Image:Select Template New.png|500px|center]]
 +
<div align="center">
 +
'' Select Template for New Data Entry Form window''
 +
</div>
 +
 +
==Data Entry ==__NOEDITSECTION__
 +
=== Data Entry itself===__NOEDITSECTION__
 +
For more information on how to do data entry, see [[Use the Data Entry Form Editor Window]].
 +
 +
[[Image:Fig42.png|400px|center]]
 +
 +
{{Warning | When updating information the updating Data Entry Form's Date of information must be a later date than the Data Entry Form(s) that created the information since the calculation of the Summary item is based on Date of Information. If the date is earlier or the same, the Summary items will '''not''' be updated.}}
 +
 +
=== Links? ===__NOEDITSECTION__
 +
The last step of the Data Entry is to specify on the Reconciliation tab if the item should be linked to another item. In {{IMSMANG}} the links implicate a relationship between the items. For example:
 +
* a link between an Activity and a Victim means that the Victim is a Demining Victim;
 +
* a link between two Victims means that they are family.
 +
 +
[[Image:Understanding IMSMA Information Model - Example Relationships Among Items.png|center|550px|''Example Relationships Among Items'']]
 +
<div align="center">
 +
''Note: Connections to Country Structure and Location have been omitted from the example''
 +
</div>
 +
 +
==Approve==__NOEDITSECTION__
 +
[[Image:WB_Status.png|thumb|225px|Approval workflow / Data Entry Form Statuses]]
 +
 +
=== Save===__NOEDITSECTION__
 +
The first step in the Approval workflow is done by the Data Entry staff and saves the Data Entry Form. It may now be found in the Workbench. Until a Data Entry Form is approved, it exists only in the Workbench and does not update any Summary items. The report can still be modified or deleted.
 +
 +
=== Peer review===__NOEDITSECTION__
 +
The next step in the Approval workflow is to have another person to review the contents of the Data Entry Form.
 +
 +
=== Submit===__NOEDITSECTION__
 +
When the Data Entry staff feels that the contents of the Data Entry Form has good enough data quality for the last review, they click on the button Submit and the status changes. The Data Entry Form is still in the Workbench.
 +
 +
=== Final review ===__NOEDITSECTION__
 +
If the Data Verifier does not consider the content of the Data Entry Form to meet the Data Quality standard of the Mine Action programme e.g. a QM item should always be linked to an Activity then the Data Entry Form will be ''Rejected''.
 +
 +
=== Reject or Approve?===__NOEDITSECTION__
 +
If the Data Verifier is not satisfied then the Data Entry Form will be Rejected. When the Data Quality is good enough the Data Entry Form may be Approved. The Approval will trigger an update of an existing item (Summary) or creating of a new item depending of chosen Action.
 +
 +
 +
{{NavBox HowTo Reconcile and Approve}}
 +
[[Category:NAA]]

Latest revision as of 10:30, 18 March 2019

The Data Entry process consists of three major steps:

  1. Reconcile
  2. Data Entry
  3. Approve.

The major steps consist in their turn of several subtasks which may be carried out by one or more different persons and/or stakeholders in the Mine Action programme. For data quality purposes, it is important that the data is adequately checked. With multiple permission levels for the Approval workflow, different users can be assigned different permissions, allowing Mine Action Programmes to implement a data-entry workflow that distinguishes between data entry and data verification roles.

Reconcile
  1. Does it exists in DB?
  2. Select Action
  3. Select template
Data Entry
  1. Data Entry itself
  2. Link(s)?
Approve
  1. Save
  2. Peer-review
  3. Submit
  4. Final review/Data QA
  5. Approve

Reconcile

Reconcile means to make two sets of numbers add up to the same total which with IMSMA terms is the process of getting all different subsets of Mine Action information in a country (e.g. operators' clearance information) to a correct and coherent national database.

New or existing item

Before a data entry may start, both at data providers such as operators and at National Mine Action Authority, the first and very important task is to determine if the piece of information that is received on a paper or as xml already exists in the database or not.

New information can be of two different types:

  • information about a new item: For example a Land or a Victim that is previously not reported/entered into IMSMANG. The Land might have been contaminated 10 years ago or the Victim injured 5 years ago but from our IMSMANG perspective it is new due to it is not in the database.
  • new information about an existing item: For example a polygon of an existing Land that previously did not have that recorded in the database or a correction of date of birth for an existing Victim.

The report that is received in both cases may not look any different so it is vital that the process of new information classification is thorough. Read more about Summary items and Data Entry Forms here.

SopIcon.png It should be outlined in the Data Entry SOP whose responsibility it is to determine if it is a new item or updating information about an existing item.

Select Data Entry Action

Data Entry Actions
Type Name When to use Action
From Data Entry menu Reconcile as New Only for New Locations New
Reconcile as Existing Item Is not recommended anymore (Replace/Combine) Replace/Combine
From Summary window Add from Summary Window Not for New Locations New
Update from Summary Window To update existing data Update
Delete from Summary Window If the item should be Deleted from the database Delete
Other Reconcile Actions Link to Existing Item Link may be used in combination which several of the other Actions Link
Reassign Item to another Location Special updating Action when to which Location an item is assigned Change Location
Unlink Items Special updating Action when items need to be Unlinked Unlink
Unapprove a Data Entry Form If this Action is used, all traceability and transparency is lost N/A

Depending on which Action you choose the Reconciliation tab of the Data Entry Form will be populated different. The Actions in the From Summary window and Other Actions automatically populates the Reconciliation tab.

Recon tab Add from non-Location.png

Example of Reconciliation Tab

New 6.0.png Add, Update and Delete from Summary window were added in version 6.0.

Select Data Entry Form template

Next decision is to choose which template to use for the Data Entry. It might be appropriate to have more than one Data Entry template for one item, e.g. one for the information about the Victim and another template for Victim Needs Assessment. The item Activity is an example where each process has their own template, i.e. Non-Technical Survey, Technical Survey, EOD Spot Task, Completion Report, Post-Clearance Survey, etc.

Select Template New.png

Select Template for New Data Entry Form window

Data Entry

Data Entry itself

For more information on how to do data entry, see Use the Data Entry Form Editor Window.

Fig42.png
Warning.jpg When updating information the updating Data Entry Form's Date of information must be a later date than the Data Entry Form(s) that created the information since the calculation of the Summary item is based on Date of Information. If the date is earlier or the same, the Summary items will not be updated.

Links?

The last step of the Data Entry is to specify on the Reconciliation tab if the item should be linked to another item. In IMSMANG the links implicate a relationship between the items. For example:

  • a link between an Activity and a Victim means that the Victim is a Demining Victim;
  • a link between two Victims means that they are family.
Example Relationships Among Items

Note: Connections to Country Structure and Location have been omitted from the example

Approve

Approval workflow / Data Entry Form Statuses

Save

The first step in the Approval workflow is done by the Data Entry staff and saves the Data Entry Form. It may now be found in the Workbench. Until a Data Entry Form is approved, it exists only in the Workbench and does not update any Summary items. The report can still be modified or deleted.

Peer review

The next step in the Approval workflow is to have another person to review the contents of the Data Entry Form.

Submit

When the Data Entry staff feels that the contents of the Data Entry Form has good enough data quality for the last review, they click on the button Submit and the status changes. The Data Entry Form is still in the Workbench.

Final review

If the Data Verifier does not consider the content of the Data Entry Form to meet the Data Quality standard of the Mine Action programme e.g. a QM item should always be linked to an Activity then the Data Entry Form will be Rejected.

Reject or Approve?

If the Data Verifier is not satisfied then the Data Entry Form will be Rejected. When the Data Quality is good enough the Data Entry Form may be Approved. The Approval will trigger an update of an existing item (Summary) or creating of a new item depending of chosen Action.