View source for Standardising Auxiliary Data

{{Rewrite| Under review, has broken links, HowTo's needs edit, add text about possible to add as CDFs, review Import}} 
{{TOC right}}
Auxiliary data provide supplementary or additional information to [[Items Pane| '''items''']] and include Assistance classification, Cause classification, Country structure, Needs classification, Ordnance classification, Organisations and Places. Note that Tasks are not included in neither items or auxiliary data.


==Country Structure==__NOEDITSECTION__
The Country structure represents a gazetteer, the political or administrative divisions within a country. In {{IMSMANG}}, the Country structure allows a Mine Action Programme to link Mine Action information to areas and report statistics such as number of victims per province or district. So the Country structure should be set up before beginning data entry. 

Ideally, a Mine Action Programme uses an official, countrywide country structure that ensures mine action information is compatible with other national datasets. Implementing an existing gazetteer requires two steps:

# defining the levels of the Country structure
# defining the nodes of the Country structure

===Define the Country Structure Levels===__NOEDITSECTION__
{{HowTo's
|[[Hierarchy Manager#Add level | Add levels]]
}}
Defining the levels of the Country structure includes defining the number of levels and the names of the levels. For Country structure the maximum number of levels are seven. For example, in one country the Country structure has four levels, while another country has five levels in the Country structure, and the levels are not called the same in the countries.

[[Image:AdminGuide_ExampleCountryStructures.png|center|400px|''Example Country Structures'']]
<div align="center">
''Example Country Structures''
</div>

Ideally, the country structure in {{IMSMANG}}, covers all levels of the existing Country structure, from the country level down to a level that can be represented with a single point such as a town or village. If a Mine Action programme has special areas such as Areas of Responsibility that do not exists in the Country structure, artificial areas may be inserted into the Country structure in {{IMSMANG}}.

{{Note | When the Country structure is established, it is not easy to add intermediate levels within the Country structure, so careful thought must be given to correctly establishing the Country structure prior to entering data.}}

===Define the Country Structure===__NOEDITSECTION__
{{HowTo's
|[[Add to the Country Structure]]
|[[Change in the Country Structure]]
|[[Remove from the Country Structure]]
}}
When defining the Country Structure nodes, it may be desirable to add only the nodes for the portions of the country affected by mines rather than the entire official country structure. This reduces the amount of data in {{IMSMANG}} to only that which is important, improving performance and usability when entering and searching for data. 

To display a Country structure node like a town or village on the map, it is necessary to add a geographic coordinate for the node.

As with all objects in {{IMSMANG}}, the Country structure supports the incorporation of Custom Defined Fields (CDFs. These fields can be used to collect and track information such as population, numbers of families and infrastructure information that is helpful in planning Mine Action activities.

{{Note|
* If the map extent is set {{IMSMANG}} automatically zoom and centre the map when the user clicks in the Country structure pane in the main navigation window.
* For ease of reporting, it is recommended to associate the majority of the Locations with one of the levels in the Country structure, normally the lowest level such as town or village. 
* Alternative names may be in different languages and alphabets. It is also common to add PCode as an alternative name.}}

==Assistance, Cause and Needs assessment classifications==__NOEDITSECTION__
These classifications are used in [[Assistance Summary Window | Assistance]] and [[Victim Summary Window | Victim]] items. 
* ''Cause'' for someone having become a victim
* ''Needs'' that the victim is assessed to have
* ''Assistance'' that the victim has received

They are as Country structure a tree structure and should be set up before beginning data entry. 

Ideally, a Mine Action Programme uses official, countrywide classifications that ensures mine action information is compatible with other national datasets. Implementing these classifications requires two steps:

# defining the levels of the classifications
# defining the nodes of the classifications

===Define the Classifications Levels===__NOEDITSECTION__
{{HowTo's
|[[Hierarchy Manager#Add level | Add levels]]
}}
{{IMSMANG}} contains a set of pre-defined levels of classifications. These should be seen as a starting point for discussions in each Mine Action and/or Assistance Programme.

{| class="wikitable"
! 
! Cause
! Needs
! Assistance
|-
| Level 1 
| Cause
| Needs
| Assistance
|-
| Level 2
| Event
| Phase
| Phase
|-
| Level 3
| Type
| Type
| Type
|-
| Level 4
| Subtype
| Subtype
| Subtype
|-
| Level 5
| Specification
| Specification
| Specification
|-
| Level 6
| Detail
| Detail
| Detail
|}

These classifications may have maximum of ten levels.

===Define the Classifications===__NOEDITSECTION__
{{HowTo's
|[[Add Assistance classification]]
|[[Edit Tree Classifications]]
|[[Delete Tree Classifications]]
}}

{{IMSMANG}} contains a set of pre-defined classifications. These should be seen as a starting point for discussions in each Mine Action and/or Assistance Programme.

{{Note | Contact your GICHD IM focal point if you need help with adjusting levels or classifications }}

==Define Other Auxiliary Data==__NOEDITSECTION__
In addition to establishing the Assistance classification, Cause Classification, Country Structure and Needs assessment classifications in {{IMSMANG}}, information managers can establish other Auxiliary data, including data for:
* Ordnance Classification
* Organisations
* Places 

While this information is easily updated during operational use of {{IMSMANG}}, it is helpful to establish a baseline of information prior to proceeding with Data Entry Form template design and data entry. Many {{IMSMANG}} users already have a baseline set of information created for each of the Auxiliary data types, either through the standard, predefined data available within {{IMSMANG}} or by migrating auxiliary data from a previous IMSMA version. Auxiliary data can also be augmented by creating [[Custom Defined Fields | '''CDFs''' ]] to track additional information.

===Ordnance Classification===__NOEDITSECTION__
This classification is used in Land, Activities and Accidents. {{IMSMANG}} includes from the installation more than 5,000 predefined ordnance models.
 
{{HowTo's
|[[List Window | Ordnance Classification List window]]
|[[Filter Lists | Filter Ordnance Classification]]
|[[Add Ordnance Classification]]
|[[View and Edit | View and/or edit Ordnance Classification]]
|[[Delete Auxiliary Data | Delete Ordnance Classification]]
}}
All ordnance is grouped according to categories and subcategories. For example, an explosive ordnance may have a category of “Landmine” and a subcategory of “Antipersonnel.” In this way, {{IMSMANG}} provides the ability not only to search and report on models but summarise information on categories and subcategories. This allows queries such as “how many landmines or bombs were cleared in a specific period?” or “how many anti-personnel mines were found?”.

{{Note | Other categories than ''Landmines'' have ordnance that belong to the subcategory ''Anti-Personnel'' so if you only want to report on AP-mines you need to filter on both category '''and''' subcategory. }}

Furthermore, programmes can limit which ordnance can be used for data entry by making ordnance inactive. To making only the ordnance that may be found in the country facilitates both data entry and data quality.

{{note|
*Before beginning data entry, standardise the ordnance available for use to ensure data consistency of reports. 
*When adding an ordnance to the database, determine if the ordnance already exists in {{IMSMANG}} and the correct classification.
}}

{{New_6.0 | IED, Less-lethal weapons, Light weapons, MANPADS, Small Arm Ammunitions and Small Arms have been added as Category. 
The new field ''Statistic Group'' has been added in order to facilitate flexible reporting }}

===Organisations===__NOEDITSECTION__
{{HowTo's
|[[List Window | Organisation List window]]
|[[Filter Lists | Filter Organisatons]]
|[[Add an Organisation]]
|[[View and Edit | View and/or edit Organisations]]
|[[Delete Auxiliary Data | Delete Organisations]]
}}
{{IMSMANG}} provides the ability to track information about Organisations participating in Mine Action. Organisations can be categorised by type and assigned “work areas” based on the country structure. To display Organisations on the map, they must have geospatial data (minimum one set of coordinates). 

Additionally, {{IMSMANG}} supports the creation of parent-child relationships with organisations so that information managers can create hierarchies of organisations. For example, a mine clearance organisation may be responsible for several clearance teams within a country. As shown in the figure below, this relationship can be mapped by creating one organisation for the mine clearance organisation (NGO1) and one organisation for each team (TeamA, TeamB and TeamC), then specifying the parent organisation of each team as NGO1.

[[Image:AdminGuide_ExampleHierarchyOfOrganisations.png|center|300px|''Example Hierarchy of Organisations'']]
<div align="center">
''Example Hierarchy of Organisations''
</div>

This kind of hierarchical relationship allows for complex searching and reporting on information such as how many square meters were cleared by each team and the total square meters that were cleared by the entire organisation.

{{IMSMANG}} also supports the tracking of competencies and accreditations for each organisation. 

===Places===__NOEDITSECTION__
{{IMSMANG}} offers the option to track information about specific places or infrastructure elements within a country that are relevant to Mine Action. These can be ammunition storages, armouries, airports, community centres, hospitals, refugee camps or any other structures/buildings which designate a political, economic, social, and/or logistical value. 
{{HowTo's
|[[List Window | Place List window]]
|[[Filter Lists | Filter Places]]
|[[Add a Place]]
|[[View and Edit | View and/or edit Places]]
|[[Delete Auxiliary Data | Delete Places]]
}}

Places can be linked to:
* Land and Activities to represent the nearest medical facilities
* Land and Activities to represent ammunition storage or armoury
* Victim to represent hospital
* Assistance to represent Place where the Assistance took place
* Education activities to represent the location of the activity

As with other {{IMSMANG}} data, Places can be customised using CDFs and represented on the map by adding geospatial information.

{{New_6.0 | Ammunition storage and Armoury have been added to ''Place Type''}}

==Import Auxiliary Data==__NOEDITSECTION__
To import auxiliary data using an Excel spreadsheet, refer to [[Importing and Exporting Data with IMSMANG#XLS Import | XLS import]].

{{NavBox Getting started with IMSMA}}

[[Category:DSA]]