Difference between revisions of "Understanding IMSMA Information Model"

From IMSMA Wiki
Jump to: navigation, search
 
(51 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
{{TOC right}}
 
{{TOC right}}
Understanding the {{IMSMANG}} information model is a prerequisite for information manager to adapt {{IMSMANG}} to their country specific mine action requirements. Some sections will include a list of requirements that can be used by information managers to define and document the information model for a programme.
+
Understanding the {{IMSMANG}} information model is a prerequisite for an information manager to adapt the system to their country specific mine action requirements. Some sections will include a list of requirements that can be used by information managers to define and document the information model for a programme.
  
 
==Data Types==__NOEDITSECTION__
 
==Data Types==__NOEDITSECTION__
 
===Core Data===__NOEDITSECTION__
 
===Core Data===__NOEDITSECTION__
In the {{IMSMANG}} information model, items are the containers for core data, such as mine action data. An item is an area, activity or event that a programme records information about and stores in {{IMSMANG}}. There are six categories of items, which are described in the table below. Each category can be characterized by a type that reflects whether the item is designed to track process or activity information or the object or product of an activity.
+
In the {{IMSMANG}} information model, items are the containers for core data, such as mine action data. An item is an area, activity or event that a programme records information about and stores in {{IMSMANG}}. There are six categories of items, which are described in the table below. Each category can be characterised by a type that reflects whether the item is designed to track process or activity information or the object or product of an activity.
 
 
  
 
{| class="wikitable"
 
{| class="wikitable"
|+ Items
 
 
! Item
 
! Item
 
! Description
 
! Description
Line 31: Line 29:
 
| Assistance
 
| Assistance
 
| Information about assistance for a person injured or affected by an accident
 
| Information about assistance for a person injured or affected by an accident
| Object/Product
+
| Process/Activity
 
|-
 
|-
 
| Education activity
 
| Education activity
| Information about an activity designed to inform or educate people, such as about local hazards
+
| Information about an activity designed to inform or educate people (e.g. Risk Education or Victim rights)
| Object/Product
+
| Process/Activity
 
|-
 
|-
 
| Quality Management (QM) activity
 
| Quality Management (QM) activity
 
| Information about an quality-improvement activity, such as an effort to control and monitor the clearance and/or reduction of land or activities
 
| Information about an quality-improvement activity, such as an effort to control and monitor the clearance and/or reduction of land or activities
| Object/Product
+
| Process/Activity
 
|-
 
|-
 
|}
 
|}
  
 +
Items are entered into {{IMSMANG}} by means of a Data Entry Form. Typically, each category of items has its own Data Entry Form template for recording information specific to that category. When entered into {{IMSMANG}}, all Data Entry Form items must be assigned to a Location, which is tied to the country’s gazetteer, or political or administrative structure. The items can then be traced back to the Country Structure so that users can easily report data such as the number and size of hazardous areas within a particular province.
  
Items are entered into {{IMSMANG}} by means of a Data Entry Form. Typically, each category of items has its own Data Entry Form template for recording information specific to that category. When entered into {{IMSMANG}}, all Data Entry Form items must be assigned to a location, which is tied to the country’s gazetteer, or political or administrative structure. The items can then be traced back to the country structure so that users can easily report data such as the number and size of hazardous areas within a particular province.
+
<center>
 
 
Part of defining and documenting an information model includes defining the useful information attributes for each {{IMSMANG}} item. {{IMSMANG}} comes with more than 1,000 data elements already defined as well as the capability to create additional custom-defined fields (CDFs). This makes it important to critically assess which data elements are useful to a programme for decision-making, analysis and reporting and to focus on those while ignoring data elements that don’t provide additional value. Limiting information to only that which is useful to the programme provides long-term benefits including reducing the data collection and data entry burden and improving system performance. And, while many data elements may be collected for each {{IMSMANG}} item, some elements may be more important for analysis than others. For example, whether a victim has been injured or killed may be more important for analysis than the victim’s nationality.
 
 
 
 
 
 
{| class="wikitable"
 
{| class="wikitable"
|+ Item Subcategories
+
|+  
 
! Item
 
! Item
! Subcategory Examples
+
! Category Examples
 
|-
 
|-
 
| Land
 
| Land
 
|
 
|
* Battle area
+
* SHA
* Dangerous area
 
* Minefield
 
 
* CHA
 
* CHA
* UXO spot
+
* EOD Spot Task
 +
* Ammunition Storage
 
|-
 
|-
 
| Activity
 
| Activity
 
|
 
|
 +
* Non-Technical survey
 +
* Technical survey
 
* Clearance
 
* Clearance
 
* Completion survey
 
* Completion survey
* Technical survey
 
* Progress report
 
 
|-
 
|-
 
| Accident
 
| Accident
Line 73: Line 67:
 
* Demining accident
 
* Demining accident
 
* Mine accident
 
* Mine accident
|-
 
| Victim
 
|
 
* Civilian
 
* Deminer
 
|-
 
| Victim assistance
 
|
 
* Medical
 
* Financial
 
|-
 
| Education activity
 
|
 
* Peer-to-peer
 
|-
 
| Quality Management (QM) activity
 
|
 
* Quality management
 
* Quality control
 
 
|-
 
|-
 
|}
 
|}
 +
</center>
 +
Part of defining and documenting an information model includes defining the useful information attributes for each {{IMSMANG}} item. {{IMSMANG}} comes with more than 1,000 [[Data Dictionary| data fields already defined]] as well as the capability to create additional custom-defined fields (CDFs). This makes it important to critically assess which data fields are useful to a programme for decision-making, analysis and reporting and to focus on those while ignoring data fields that don’t provide additional value. Limiting information to only that which is useful to the programme provides long-term benefits including reducing the data collection and data entry burden and improving system performance. And, while many data fields may be collected for each {{IMSMANG}} item, some fields may be more important for analysis than others. For example, whether a victim has been injured or killed may be more important for analysis than the victim’s nationality.
  
 +
Each of the items can be divided into categories or types so users can collect information for each category/type. For example, Land are normally divided into different categories/types and each category of land are managed differently. Using categories/types, information managers can:
  
Each of the seven categories of items can be divided into subcategories or types so users can collect information for each subcategory. For example, users can specify different types of land such as dangerous areas, confirmed hazardous areas (CHAs), minefields and battle areas and manage each kind of land differently. Using subcategories, information managers can:
+
* create separate workflows for each category/type of Land
 +
* create and manage separate Data Entry Form templates per category/type
 +
* differentiate between item categories/types on the map
  
* create separate workflows for each type of land
+
Additionally, information managers can customise the categories so that unused categories can be inactivated and other categories added. The same is true for all top-level items within {{IMSMANG}}, which lets information managers specify their exact information model, including the relationships among item categories, and adjust the model as their needs change over time. To accurately map the information model for a Mine Action Programme, it’s helpful to evaluate the available item categories and determine if changes to the information model in {{IMSMANG}} are required. While these values can be customised after system setup, understanding the types of information for each item is critical to implementing an effective workflow in {{IMSMANG}}.
* create and manage separate data entry forms
 
* differentiate between item categories on the map
 
  
Additionally, information managers can customise the subcategories so that unused subcategories can be removed and other subcategories added. The same is true for all top-level items within {{IMSMANG}}, which lets information managers specify their exact information model, including the relationships among item categories, and adjust the model as their needs change over time. To accurately map the information model for a programme, it’s helpful to evaluate the available item subcategories and determine if changes to the information model in {{IMSMANG}} are required. While these values can be customized after system setup, understanding the types of information for each item is critical to implementing an effective workflow in {{IMSMANG}}. Table 5 shows examples of the possible subcategories of {{IMSMANG}} items.
+
{{note|<b>Document the following decisions about items:</b>
 
+
* data to be collected and managed in {{IMSMANG}}
 
+
* data fields that are not predefined in {{IMSMANG}} and should be created as CDFs
{{Document|<b>Document the following decisions about items:</b>
+
* particularly important, or key, data for the programme
 
+
* relevant categories/types for each item
* data elements to be collected and managed in {{IMSMANG}}
 
* data elements that are not predefined in {{IMSMANG}} and should be created as CDFs
 
* particularly important, or key, data elements for the programme
 
* relevant subcategories for each item
 
 
* status values for each item
 
* status values for each item
 
}}  
 
}}  
  
 
+
[[Image:Understanding IMSMA Information Model - Example of Documented Land.png|center|300px]]
Below is an example of a fully-documented hazard.
 
 
 
 
 
[[Image:Understanding IMSMA Information Model - Example of Documented Hazard.png|center|500px|''Example of Documented Hazard'']]
 
 
<div align="center">
 
<div align="center">
''Example of Documented Hazard''
+
''Example of documentation''
 
</div>
 
</div>
  
 
===Auxiliary Data===__NOEDITSECTION__
 
===Auxiliary Data===__NOEDITSECTION__
In addition to defining the required information for {{IMSMANG}} items, it is important to define the relevant information to be collected about auxiliary data. This includes defining and documenting the [[Setup Country Structure Levels in a New Installation|Country Structure]], [[Access the Ordnance Classification List Window|Explosive Ordnance]], [[Organisation List window|Organisation]] and [[Place List window|Place]], such as military bases, hospitals and cultural sites; any additional CDFs that should be created; and any subcategories for each of the auxiliary data types.
+
In addition to defining the required information for {{IMSMANG}} items, it is important to define the relevant information to be collected about Auxiliary data. This includes defining and documenting the [[Standardising_Auxiliary_Data#Country_Structure|Country Structure]], [[Standardising_Auxiliary_Data#Ordnance Classification | Ordnance classification]], [[Standardising_Auxiliary_Data#Organisations |Organisation]] and [[Standardising_Auxiliary_Data#Places|Place]], such as military bases, hospitals and cultural sites; any additional CDFs that should be created; and any subcategories for each of the Auxiliary data types.
  
 +
{{New_6.0 | In version 6.0 two classifications used for Victim; Cause and Needs assessment, and Assistance classification used for Assistance have been added. All three are hierarchy tree-structures using levels.}}
  
{{Document|<b>Document the following decisions about auxiliary data:</b>
+
{{note|<b>Document the following decisions about Auxiliary data:</b>
  
* data elements to be collected and managed in {{IMSMANG}}
+
* data to be collected and managed in {{IMSMANG}}
* data elements that are not already configured in {{IMSMANG}} and can be created as CDFs
+
* data fields that are not already configured in {{IMSMANG}} and can be created as CDFs
 
* relevant subcategories for each data type
 
* relevant subcategories for each data type
 
}}  
 
}}  
  
 
+
[[Image:Understanding IMSMA Information Model - Example of Documented Auxiliary Data ver2.png|center|300px]]
Below is an example of a fully-documented place.
 
 
 
 
 
[[Image:Understanding IMSMA Information Model - Example of Documented Auxiliary Data.png|center|500px|''Understanding IMSMA Information Model - Example of Documented Auxiliary Data'']]
 
 
<div align="center">
 
<div align="center">
''Understanding IMSMA Information Model - Example of Documented Auxiliary Data''
+
''Example of Documented Auxiliary Data''
 
</div>
 
</div>
  
==Data Entry Forms and Summaries==__NOEDITSECTION__
+
==Data Entry Forms and Summary items==__NOEDITSECTION__
A <b>Data Entry Form</b> is a data entry form used to record and store information about an item.
+
A '''Data Entry Form''' is a template used for data entry of information e.g. about a victim.
  
A <b>Summary</b> is a summary of all the information collected about an item on Data Entry Forms.
+
The Data Entry Form(s) for a specific object (e.g. the Victim ''Jane Doe'') are summarised and displayed in a '''Summary'''.
  
<b>Reconciliation</b> is the process of assigning the information in a Data Entry Form to an existing item or creating a new item/Summary.
+
'''Reconciliation''' is the process of deciding if information should update an existing object or creating a new object/Summary.
  
All information is entered into {{IMSMANG}} via a Data Entry Form, a data entry form used to collect information about an item. When a Data Entry Form is completed, it is either reconciled to an existing item (that is, it is determined to be information about an item that already exists in {{IMSMANG}}) or it is reconciled as new (that is, it is determined to be information about an item that does not already exist in {{IMSMANG}}).
+
Or with other words, when a Data Entry process is started the first decision is to choose which of the several different methods/actions for Data Entry to use.  
  
With this approach, users can collect and store multiple Data Entry Forms about the same item over time so that the entire history of the item is preserved in the system. The approach also provides a complete audit trail of all changes made to any information so that information managers can answer the question, "What did we know and when did we know it?"
+
With this approach, users can collect and store multiple Data Entry Forms about the same item over time so that the entire history of the item is preserved in the system. The approach also provides a complete [[Audit log | audit trail]] of all changes made to any information so that information managers can answer the question, "What did we know and when did we know it?"
  
{{IMSMANG}} also provides a constantly updated Summary of the item which represents the sum of information about the item at any given time. As subsequent information is collected about a specific attribute of an item, {{IMSMANG}} updates the item’s Summary on an attribute-by-attribute basis. For example, Data Entry Form #1 collects some initial information about a hazardous land area. It sets the priority to "Medium" and specifies that the land contains AP mines and is 25,000 sqm. Data Entry Form #2 updates information about the land area after a subsequent assessment. The report sets the priority to "High" and specifies the presence of AP and AT mines, but it does not change the size or the status of the land area. Data Entry Form #3 updates the land area's size and status after clearance operations are complete. The figure below shows how the land area's Summary is updated after all three reports are entered into the system.
+
As subsequent information is collected about a specific attribute of an item, {{IMSMANG}} updates the item’s Summary on an attribute-by-attribute basis. The calculation of the Summary is done based on '''Date of Information''' and therefore it is important that Date of information is reflecting the age of the information and not the date of entry into {{IMSMANG}}.
  
[[Image:Understanding_IMSMA_Information_Model_-_Updating_CVs.png|center|500px|''Example of Updating Summaries'']]
+
[[Image:Understanding_IMSMA_Information_Model_-_Updating_CVs ver2.png|center|400px]]
 
<div align="center">
 
<div align="center">
''Example of Updating Summaries''
+
''Example of Updating Summary items''
 
</div>
 
</div>
  
Summary calculations are based on the date of the Data Entry Form, so it is possible to enter data into the system out of chronological order (that is, to collect past information about an item) without disrupting the Summary. For example, if a fourth Data Entry Form were collected and dated between Data Entry Form #1 and Data Entry Form #2, it would have no effect on the Summary as all information in the example was updated with Data Entry Form #2 or later.
+
Data Entry Form #1 collects some initial information about a Land. It sets the priority to "Medium" and specifies that the land contains AP mines and is 25,000 sqm.  
  
===Location Folder===__NOEDITSECTION__
+
Data Entry Form #2 updates information about the land area after a subsequent assessment. The report sets the priority to "High" and specifies the presence of AP and AT mines, but it does not change the size or the status of the land area.  
A location in {{IMSMANG}} is a grouping of information, whether logical, geographical or sociopolitical. Using locations, users can group data that belongs together or is associated with each other and handle it as a group, including facilitating data entry, searching and running reports. To do this, locations must link the data to the country’s political or administrative structure (existing gazetteer), whether at the province, district or town level. This method also provides geographical context to the data. As shown in the figure below, locations in {{IMSMANG}} are governed by two simple rules:
 
  
*all data must be linked to a location
+
Data Entry Form #3 updates the land area's size and status after clearance operations are complete. The figure above shows how the land area's Summary is updated after all three reports are entered into the system.
*all locations must be linked to the country structure
 
  
 +
{{Warning| A Data Entry Form that is changing existing information must have a Date of information that is later than the Data Entry Form that it is updating the calculation of the Summary item(s) are based on Date of Information. When the date is earlier or the '''same''', the Summary item will '''not''' be updated.}}
  
[[Image:Understanding IMSMA Information Model - Using Locations to Link Mine Action Data to the Country Structure.png|center|''Using Locations to Link Mine Action Data to the Country Structure'']]
+
===Location ===__NOEDITSECTION__
<div align="center">
+
A country's official administrative structure, also known as Gazetteer, should be the base for the Country Structure used in {{IMSMANG}}. Sometimes the official administrative structure has not been updated for a long time or it is not detailed enough using it for a geographical placeholder, worksite, for the Mine Action programme and that is why the item Location has been introduced in {{IMSMANG}}. Two fundamental decisions to make when customising {{IMSMANG}} is to decide what Country Structure level Locations will be consistently linked to and what concept Locations will represent. Typical concepts that a Location is used to represent include:
''Using Locations to Link Mine Action Data to the Country Structure''
 
</div>
 
  
 +
*a work area (where activities are taking place)
 +
*a community (a group of people affected by the mine/UXO/IED threat)
 +
*the nearest town (the town closest to where the activity is taking place)
  
Two fundamental decisions to make when customizing {{IMSMANG}} is to decide what country structure level locations will be consistently linked to and what concept locations will represent. Typical concepts that a location is used to represent include:
+
Using Locations, users can group data that belongs together or is associated with each other and in that way get a better overview, facilitate searching and creating reports. The Locations is the link between the Country Structure, whether at the province, district or town level and the Mine Action data. As shown in the figure below, data in {{IMSMANG}} are governed by two simple rules:
  
*a work area (where activities are taking place)
+
*all data must be assigned to a Location
*a community (a group of people affected by the mine/UXO threat)
+
*all Locations must be linked to the Country Structure
*the nearest town (the town closest to where the activity is taking place)
 
  
{{Document|<b>Document the following decisions about locations:</b>
+
[[Image:Understanding IMSMA Information Model - Using Locations to Link Mine Action Data to the Country Structure.png|center]]
 +
<div align="center">
 +
''Using Locations to Link Mine Action Data to the Country Structure''
 +
</div>
  
* what concept locations will represent
+
{{note|<b>Document the following decisions about Locations:</b>
* what country structure level locations will be linked to
+
* what concept Locations will represent
 +
* what Country Structure level Locations will be linked to
 
}}  
 
}}  
 
  
 
===Assigning and Linking===__NOEDITSECTION__
 
===Assigning and Linking===__NOEDITSECTION__
<b>Assigning</b> refers to the assignment of an item to a location for the purposes of grouping information. All items must be assigned a location.
+
<b>Assigning</b> refers to the assignment of an item to a Location for the purposes of grouping information. All items must be assigned a Location.
 
 
<b>Linking</b> refers to the association between items for the purposes of analysis. Linking is optional, for example, when linking clearances to minefields.
 
 
 
{{IMSMANG}} provides the capability to assign items to locations and create links between items, a function that shows the relationships between items and processes and that enriches the data collected. Assignments and links are defined during the Data Entry Form approval process. An item is assigned to one location, which ties the item to the country structure and allows for reporting data by area. The same item can then be linked to as many other items as necessary. In this way, {{IMSMANG}} supports the idea of linking activities to land, victims to accidents or any item to any other item. When used with item subcategories, linking adds a powerful capacity to implement an information workflow and create rich and useful data for decision makers. To ensure the integrity of this data, system administrators must clearly specify the kinds of links to track in {{IMSMANG}}.
 
 
 
The example below shows how users can build a workflow of complex relationships among top-level items and item subcategories to model the information management process for their programmes.
 
 
 
  
[[Image:Understanding IMSMA Information Model - Example of How Relationships Among Items are Created.png|center|400px|''Example of How Relationships Among Items are Created'']]
+
<b>Linking</b> refers to the association between items for the purposes of analysis. Linking is optional, for example, when linking Activities to Accidents but linking is very important to do so effective reporting will be possible.
<div align="center">
 
''Example of How Relationships Among Items are Created''
 
</div>
 
  
 +
{{IMSMANG}} provides the capability to assign items to Locations and create links between items, a function that shows the relationships between items and processes and that enriches the data collected. Assignments and links are defined during the Data Entry Form approval process. An item is assigned to one Location, which ties the item to the country structure and allows for reporting data by area. The same item can then be linked to as many other items as necessary. In this way, {{IMSMANG}} supports the idea of linking activities to land, victims to accidents or any item to any other item. When used with item categories, linking adds a powerful capacity to implement an information workflow and create rich and useful data for decision makers. To ensure the integrity of this data, system administrators must clearly specify the kinds of links to track in {{IMSMANG}}.
  
The next figure shows how the Summary changes with each activity that is linked to the original land. The CHA starts with a status of "Open." When the technical survey is linked to the land, it changes the landsubcategory to "Minefield." Then, linking the clearance updates the land's status to "Worked On." Finally, linking the completion survey changes the land's status to "Closed." The result is one land whose information is updated over time by the four activities linked to the land. This way to track information can be used to represent the information management process and status rules accurately for a land release, risk management or other process model.
+
The example below shows how users can build a workflow of relationships among items to model the information management process for their Mine Action Programmes. The figure shows how the Summary changes with each activity that is linked to the original Land.  
 +
# The Land starts its life-cycle as ''SHA'' with a status of Open in this example.  
 +
# When the clearance starts and the first Progress report is linked to the Land, the status should be changed to ''Worked On''.  
 +
# Finally, after linking the Completion Report the land's status should be updated to ''Closed''.  
  
 +
The result is one Land whose information is updated over time by the three Activities linked to the land. This way to track information can be used to represent the information management process and status rules accurately for a Land Release, Risk management or other process model.
  
[[Image:Understanding IMSMA Information Model - Example of How Current View Statuses Change.png|center|400px|''Example of How Summary Statuses Change'']]
+
[[Image:Understanding IMSMA Information Model - Example of How Current View Statuses Change.png|center|400px]]
 
<div align="center">
 
<div align="center">
 
''Example of How Summary Statuses Change''
 
''Example of How Summary Statuses Change''
 
</div>
 
</div>
  
 +
The {{IMSMANG}} information model is flexible enough for each Mine Action Programme to customise the system to support its needs. For example, implementations that do not cover Education activities do not need to complete information about Education activities, and they still retain full utility of the system. Similarly, implementations that only cover Victim tracking and Education activities only can disregard Land and Activities without any loss of utility.
  
The {{IMSMANG}} information model is flexible enough for each programme to customise the system to support its needs. For example, programmes that do not conduct education activities do not need to complete information about education activities, and they still retain full utility of the system. Similarly, programmes that conduct victim tracking and education activities only can disregard land and activities without any loss of utility. This flexibility, however, requires that programmes define the relevant uses of each item.
+
Although any item can be linked to any other item, not all relationships necessarily make sense for every implementation. The diagrams below describe some of the more common logical relationships among items and can serve as the basis for an information model when implementing {{IMSMANG}}.
 
 
Although any item can be linked to any other item, not all relationships necessarily make sense for every programme. The diagrams below describe some of the more common logical relationships among items and can serve as the basis for an information model when implementing {{IMSMANG}}.
 
 
 
  
[[Image:Understanding IMSMA Information Model - Example Relationships Among Items.png|center|400px|''Example Relationships Among Items'']]
+
[[Image:Understanding IMSMA Information Model - Example Relationships Among Items.png|center|550px]]
 
<div align="center">
 
<div align="center">
''Example Relationships Among Items''
+
''Note: Connections to Country Structure and Location have been omitted from the example''
 
</div>
 
</div>
  
 +
The rationale for each relationship or link should also be documented so the meaning is understood. These relationships are used when entering data to ensure that the links between items are available for searching and reporting, like when searching for all Land that have Accidents linked to them.
  
The rationale for each relationship or link should also be documented so the meaning is understood. For example, an activity may be conducted on a land and an accident may be a result of a hazardous land or produce a victim. These relationships are used when entering data to ensure that the links between items are available for searching and reporting, like when searching for all land that have clearances linked to them.
+
{{note|<b>Document the following business rules about assigning and linking:</b>
 
+
* which items will have links between them, for example, Victims should always be linked to Accidents
{{Document|<b>Document the following business rules about assigning and linking:</b>
+
* rationale or logical meaning of the relationships between items, for example, a link between a Clearance and an Accident means that the Accident happened during the Clearance
 
+
* what effects linking has on the items, for example, a link between a Clearance and Land may indicate that the land status should change from ''Open'' to ''Worked on''
* which items will have links between them, for example, victims will always be linked to accidents
 
* rationale or logical meaning of the relationships between items, for example, a link between a clearance and a minefield means that the clearance was conducted on the minefield
 
* what effects linking has on the items, for example, a link between a clearance and land may indicate that the land status should change from "Open" to "Worked on"
 
 
}}  
 
}}  
 
 
  
 
===The Workbench===__NOEDITSECTION__
 
===The Workbench===__NOEDITSECTION__
Items, Data Entry Forms, Summaries, assigning and linking come together at the Workbench. The Workbench is a holding area where users enter data into Data Entry Forms and reconcile each item in the Data Entry Form either as a new item or as an update to an existing item. Users have the ability to assign Data Entry Form items to locations and to link items to other items (like linking a technical survey to an existing CHA). They then save the reports in the Workbench pending the appropriate quality checks and approvals.
+
[[Image:WB_Status.png|175px|center]]
 
 
Until a Data Entry Form is approved, it exists only in the Workbench and does not update any Summaies. The report can still be modified or deleted. When a Data Entry Form is approved, however, it becomes part of the Summaries and cannot be deleted.
 
 
 
 
 
[[Image:Understanding IMSMA Information Model - Adding Field Report Information to the Current View.png|center|''Adding Data Entry Form Information to the Summary'']]
 
 
<div align="center">
 
<div align="center">
''Adding Data Entry Form Information to the Summary''
+
'' Approval workflow / Data Entry Form Statuses''
 
</div>
 
</div>
 +
The Workbench is a holding area / import inbox where Data Entry Forms are found until they are approved. There are four possible steps in the Approval process:
 +
# [[Save Data Entry Forms| Save]]
 +
# [[Submit Data Entry Forms | Submit]]
 +
# [[Reject Data Entry Forms | Reject ]]
 +
# [[Approve Data Entry Forms | Approve]]
  
 +
For data quality purposes, it is important that the data is adequately checked. With multiple permission levels for the Approval, 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.
  
For data quality purposes, it is important that the data is adequately checked at this stage. {{IMSMANG}} allows information managers to control permissions for the Workbench and other areas of {{IMSMANG}} through the management of users and roles. With multiple permission levels for the Workbench, different users can be assigned different permissions, allowing programmes to implement a data-entry workflow that distinguishes between data entry and data verification roles. It is recommended to set up a permission structure that reserves approval authority for Data Entry Forms for the most trusted users.
+
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. The Approval will trigger an update of an existing item (Summary) or creating of a new item depending of chosen Action. If the Summary item has geospatial data, it may be visible in the Map Pane.
 
 
  
 
{{NavBox Information Management}}
 
{{NavBox Information Management}}
 
+
[[Category:NAA]]
[[Category:Information management]]
 

Latest revision as of 13:34, 9 July 2019

Understanding the IMSMANG information model is a prerequisite for an information manager to adapt the system to their country specific mine action requirements. Some sections will include a list of requirements that can be used by information managers to define and document the information model for a programme.

Data Types

Core Data

In the IMSMANG information model, items are the containers for core data, such as mine action data. An item is an area, activity or event that a programme records information about and stores in IMSMANG. There are six categories of items, which are described in the table below. Each category can be characterised by a type that reflects whether the item is designed to track process or activity information or the object or product of an activity.

Item Description Type
Land Information about an area Object/Product
Activity Information about an activity, such as efforts to survey, clear, or reduce the threat of a hazard Process/Activity
Accident Information about an accidental event Object/Product
Victim Information about a person injured or affected by an accident Object/Product
Assistance Information about assistance for a person injured or affected by an accident Process/Activity
Education activity Information about an activity designed to inform or educate people (e.g. Risk Education or Victim rights) Process/Activity
Quality Management (QM) activity Information about an quality-improvement activity, such as an effort to control and monitor the clearance and/or reduction of land or activities Process/Activity

Items are entered into IMSMANG by means of a Data Entry Form. Typically, each category of items has its own Data Entry Form template for recording information specific to that category. When entered into IMSMANG, all Data Entry Form items must be assigned to a Location, which is tied to the country’s gazetteer, or political or administrative structure. The items can then be traced back to the Country Structure so that users can easily report data such as the number and size of hazardous areas within a particular province.

Item Category Examples
Land
  • SHA
  • CHA
  • EOD Spot Task
  • Ammunition Storage
Activity
  • Non-Technical survey
  • Technical survey
  • Clearance
  • Completion survey
Accident
  • Demining accident
  • Mine accident

Part of defining and documenting an information model includes defining the useful information attributes for each IMSMANG item. IMSMANG comes with more than 1,000 data fields already defined as well as the capability to create additional custom-defined fields (CDFs). This makes it important to critically assess which data fields are useful to a programme for decision-making, analysis and reporting and to focus on those while ignoring data fields that don’t provide additional value. Limiting information to only that which is useful to the programme provides long-term benefits including reducing the data collection and data entry burden and improving system performance. And, while many data fields may be collected for each IMSMANG item, some fields may be more important for analysis than others. For example, whether a victim has been injured or killed may be more important for analysis than the victim’s nationality.

Each of the items can be divided into categories or types so users can collect information for each category/type. For example, Land are normally divided into different categories/types and each category of land are managed differently. Using categories/types, information managers can:

  • create separate workflows for each category/type of Land
  • create and manage separate Data Entry Form templates per category/type
  • differentiate between item categories/types on the map

Additionally, information managers can customise the categories so that unused categories can be inactivated and other categories added. The same is true for all top-level items within IMSMANG, which lets information managers specify their exact information model, including the relationships among item categories, and adjust the model as their needs change over time. To accurately map the information model for a Mine Action Programme, it’s helpful to evaluate the available item categories and determine if changes to the information model in IMSMANG are required. While these values can be customised after system setup, understanding the types of information for each item is critical to implementing an effective workflow in IMSMANG.

Note.jpg Document the following decisions about items:
  • data to be collected and managed in IMSMANG
  • data fields that are not predefined in IMSMANG and should be created as CDFs
  • particularly important, or key, data for the programme
  • relevant categories/types for each item
  • status values for each item
Understanding IMSMA Information Model - Example of Documented Land.png

Example of documentation

Auxiliary Data

In addition to defining the required information for IMSMANG items, it is important to define the relevant information to be collected about Auxiliary data. This includes defining and documenting the Country Structure, Ordnance classification, Organisation and Place, such as military bases, hospitals and cultural sites; any additional CDFs that should be created; and any subcategories for each of the Auxiliary data types.

New 6.0.png In version 6.0 two classifications used for Victim; Cause and Needs assessment, and Assistance classification used for Assistance have been added. All three are hierarchy tree-structures using levels.
Note.jpg Document the following decisions about Auxiliary data:
  • data to be collected and managed in IMSMANG
  • data fields that are not already configured in IMSMANG and can be created as CDFs
  • relevant subcategories for each data type
Understanding IMSMA Information Model - Example of Documented Auxiliary Data ver2.png

Example of Documented Auxiliary Data

Data Entry Forms and Summary items

A Data Entry Form is a template used for data entry of information e.g. about a victim.

The Data Entry Form(s) for a specific object (e.g. the Victim Jane Doe) are summarised and displayed in a Summary.

Reconciliation is the process of deciding if information should update an existing object or creating a new object/Summary.

Or with other words, when a Data Entry process is started the first decision is to choose which of the several different methods/actions for Data Entry to use.

With this approach, users can collect and store multiple Data Entry Forms about the same item over time so that the entire history of the item is preserved in the system. The approach also provides a complete audit trail of all changes made to any information so that information managers can answer the question, "What did we know and when did we know it?"

As subsequent information is collected about a specific attribute of an item, IMSMANG updates the item’s Summary on an attribute-by-attribute basis. The calculation of the Summary is done based on Date of Information and therefore it is important that Date of information is reflecting the age of the information and not the date of entry into IMSMANG.

Understanding IMSMA Information Model - Updating CVs ver2.png

Example of Updating Summary items

Data Entry Form #1 collects some initial information about a Land. It sets the priority to "Medium" and specifies that the land contains AP mines and is 25,000 sqm.

Data Entry Form #2 updates information about the land area after a subsequent assessment. The report sets the priority to "High" and specifies the presence of AP and AT mines, but it does not change the size or the status of the land area.

Data Entry Form #3 updates the land area's size and status after clearance operations are complete. The figure above shows how the land area's Summary is updated after all three reports are entered into the system.

Warning.jpg A Data Entry Form that is changing existing information must have a Date of information that is later than the Data Entry Form that it is updating the calculation of the Summary item(s) are based on Date of Information. When the date is earlier or the same, the Summary item will not be updated.

Location

A country's official administrative structure, also known as Gazetteer, should be the base for the Country Structure used in IMSMANG. Sometimes the official administrative structure has not been updated for a long time or it is not detailed enough using it for a geographical placeholder, worksite, for the Mine Action programme and that is why the item Location has been introduced in IMSMANG. Two fundamental decisions to make when customising IMSMANG is to decide what Country Structure level Locations will be consistently linked to and what concept Locations will represent. Typical concepts that a Location is used to represent include:

  • a work area (where activities are taking place)
  • a community (a group of people affected by the mine/UXO/IED threat)
  • the nearest town (the town closest to where the activity is taking place)

Using Locations, users can group data that belongs together or is associated with each other and in that way get a better overview, facilitate searching and creating reports. The Locations is the link between the Country Structure, whether at the province, district or town level and the Mine Action data. As shown in the figure below, data in IMSMANG are governed by two simple rules:

  • all data must be assigned to a Location
  • all Locations must be linked to the Country Structure
Understanding IMSMA Information Model - Using Locations to Link Mine Action Data to the Country Structure.png

Using Locations to Link Mine Action Data to the Country Structure

Note.jpg Document the following decisions about Locations:
  • what concept Locations will represent
  • what Country Structure level Locations will be linked to

Assigning and Linking

Assigning refers to the assignment of an item to a Location for the purposes of grouping information. All items must be assigned a Location.

Linking refers to the association between items for the purposes of analysis. Linking is optional, for example, when linking Activities to Accidents but linking is very important to do so effective reporting will be possible.

IMSMANG provides the capability to assign items to Locations and create links between items, a function that shows the relationships between items and processes and that enriches the data collected. Assignments and links are defined during the Data Entry Form approval process. An item is assigned to one Location, which ties the item to the country structure and allows for reporting data by area. The same item can then be linked to as many other items as necessary. In this way, IMSMANG supports the idea of linking activities to land, victims to accidents or any item to any other item. When used with item categories, linking adds a powerful capacity to implement an information workflow and create rich and useful data for decision makers. To ensure the integrity of this data, system administrators must clearly specify the kinds of links to track in IMSMANG.

The example below shows how users can build a workflow of relationships among items to model the information management process for their Mine Action Programmes. The figure shows how the Summary changes with each activity that is linked to the original Land.

  1. The Land starts its life-cycle as SHA with a status of Open in this example.
  2. When the clearance starts and the first Progress report is linked to the Land, the status should be changed to Worked On.
  3. Finally, after linking the Completion Report the land's status should be updated to Closed.

The result is one Land whose information is updated over time by the three Activities linked to the land. This way to track information can be used to represent the information management process and status rules accurately for a Land Release, Risk management or other process model.

Understanding IMSMA Information Model - Example of How Current View Statuses Change.png

Example of How Summary Statuses Change

The IMSMANG information model is flexible enough for each Mine Action Programme to customise the system to support its needs. For example, implementations that do not cover Education activities do not need to complete information about Education activities, and they still retain full utility of the system. Similarly, implementations that only cover Victim tracking and Education activities only can disregard Land and Activities without any loss of utility.

Although any item can be linked to any other item, not all relationships necessarily make sense for every implementation. The diagrams below describe some of the more common logical relationships among items and can serve as the basis for an information model when implementing IMSMANG.

Understanding IMSMA Information Model - Example Relationships Among Items.png

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

The rationale for each relationship or link should also be documented so the meaning is understood. These relationships are used when entering data to ensure that the links between items are available for searching and reporting, like when searching for all Land that have Accidents linked to them.

Note.jpg Document the following business rules about assigning and linking:
  • which items will have links between them, for example, Victims should always be linked to Accidents
  • rationale or logical meaning of the relationships between items, for example, a link between a Clearance and an Accident means that the Accident happened during the Clearance
  • what effects linking has on the items, for example, a link between a Clearance and Land may indicate that the land status should change from Open to Worked on

The Workbench

WB Status.png

Approval workflow / Data Entry Form Statuses

The Workbench is a holding area / import inbox where Data Entry Forms are found until they are approved. There are four possible steps in the Approval process:

  1. Save
  2. Submit
  3. Reject
  4. Approve

For data quality purposes, it is important that the data is adequately checked. With multiple permission levels for the Approval, 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.

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. The Approval will trigger an update of an existing item (Summary) or creating of a new item depending of chosen Action. If the Summary item has geospatial data, it may be visible in the Map Pane.