Changes

__NOEDITSECTION__The country structure represents a gazetteer, or the political Auxiliary data provide supplementary or administrative divisions within a country. In IMSMA^NG, the country structure allows a mine action programme to link mine action additional information to areas [[Items Pane|'''items''']] and report statistics such as number of hazards per province include * Country Structure, * Assistance classification, * Cause classification, * Needs classification, * Ordnance classification, * Organisation,* Place. {{Note | [[Using_the_Tasking_Tool_in_IMSMANG|Tasks]] are not included in neither items or district. So the country structure should be set up before beginning auxiliary data entry. }}

Ideally, a mine action programme uses an It is important to standardise the Auxiliary data i.e. ensure that duplicates with different spellings are not created and that official, countrywide classifications for the Mine Action Programme / country structure that ensures mine action information are used in {{IMSMANG}}. Therefore it is compatible important to limit the number of users who have permission to change Auxiliary Data. As with other national datasetsall objects in {{IMSMANG}}, it is possible to add Custom Defined Fields ([[Custom Defined Fields | CDFs]]) to the Auxiliary Data. Implementing an existing gazetteer requires two steps:

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

==Define the Country Structure Levels==Defining the levels of the country structure includes defining the number of levels and the names of the levels. For exampleIdeally, a programme may wish to implement a four-level country structureMine Action Programme uses an official, while another programme wants to use a five-level country structure. The figure below shows an example of each optioncountrywide Country Structure that ensures mine action information is compatible with other national datasets.Setting up Country Structure in {{IMSMANG}} is done in 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 levels | Add levels]]|[[Hierarchy Manager#Edit levels | Edit levels]]|[[Hierarchy Manager#Delete levels | Delete 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.  [[Image:AdminGuide_ExampleCountryStructures.png|center|500px400px|''Example Country Structures'']]

Both the number of levels and the name of each level can be customised to match the programme’s existing country structure. Ideally, the country structure Country Structure in IMSMA^NG{{IMSMANG}}, covers all levels of the existing country structureCountry Structure, from the country level down to a level that can be represented with a single point such as a town, city or village. If a Mine Action programme has special areas or districts levels such as Areas of Responsibility that are do not consistent with exists in the defined country structure levelsCountry Structure, the programme can insert artificial or unofficial areas to keep levels may be inserted into the country structure consistent across Country Structure in {{IMSMANG}}. ===Define the entire country.Country Structure Nodes===__NOEDITSECTION__

|[[HowTo:Setup Add Country Structure Levels in a New Installation]]|[[HowTo:Add a View and Edit Auxiliary Data | View and/or edit Country Structure Level]]|[[HowTo:Change a Country Structure Level Name]]Delete Auxiliary Data|[[HowTo:Remove a Delete Country Structure Level]]

{{Important|When To display a Country Structure node like a town or village on the country structure is establishedmap, it is not possible necessary to add intermediate levels within a geographic coordinate for the country structure, so careful thought must be given to correctly establishing the country structure prior to entering data}}node.

{{note| To addIf information such as population, changenumbers of families and infrastructure information that is helpful in planning Mine Action activities, or remove country structure levels, you must have the this information may be collected and tracked either as CDFs to either Country Structure Mgmt permissionor Location.

The country structure levels associated with the country structures are created using the Hierarchy It is possible to add Country Structure as [[Data Inventory Manager window| CDF to other items]] but should not be used instead of / duplication of reconciling to Location.

The Hierarchy Manager window displays {{Note|* If the names of any defined country structure levels. If no country structure levels are defined, map extent is set {{IMSMANG}} automatically zoom and centre the window displays <Enter Level Name> for map when the levels. When user clicks in the window initially displays, only Country Structure pane in the [[Image:FieldTemplateIcon.pngIMSMA Navigation Window | Main Navigation window]] button and .* For ease of reporting, it is recommended to associate the majority of the Done button are available. The [[Image:FieldViewIcon.pngLocation Summary Window | 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 [[Image:EcksButtonalphabets. It is also common to add P-code as an alternative name.png]] buttons become available after you select a country structure level* It is important to keep the Country Structure inside {{IMSMANG}} in synch with the official Country Structure.}}

==Define {{New_6.0 | In order to facilitate updates of the Country Structure Areas==When defining the country structure areas, it may be desirable to add only the areas for the portions of the country affected by mines rather than the entire official country structureCountry Structure ID has been made visible. This reduces the amount of data in IMSMA^NG Contact your [[Information Management Team | GICHD IM advisor]] if you would like to only that which is important, improving performance and usability when entering and searching for dataupdate your Country Structure. }}

IMSMA^NG provides several ways to add country ==Assistance, Cause and Needs classifications==__NOEDITSECTION__[[Image:Tree structure areas. png|200px|right]]These include manually entering the information starting with the country classifications are used in [[Assistance Summary Window | Assistance]] and working down through each level or importing the data from an [[Victim Summary Window | Victim]] items.XLS file using customised routines to import data automatically from an official gazetteer. To display * ''Cause'' for someone having become a country structure area like a town or village on victim* ''Needs'' that the map, it victim is necessary assessed to add a geographic coordinate for the area. Typically, a single coordinate is sufficient for displaying an area on have* ''Assistance'' that the map.victim has received

As with all data elements in IMSMA^NG, They are as the country structure supports the incorporation of CDFs to augment predefined Country Structure tree structures and should be set up before beginning data fields. These fields can be used to collect and track information such as population, numbers of families and other socioeconomic and infrastructure information that is helpful in planning mine action activitiesentry.

{{note|* For ease of accessIdeally, a Mine Action Programme uses official, it countrywide classifications that ensures mine action information is recommended to associate IMSMA^NG locations compatible with one level in the country structure, normally the lowest level such as town or villageother national datasets. Implementing these classifications requires two steps: * Setting # defining the preferred map extent for each area allows users to zoom and centre levels of the map automatically on classifications# defining the area from nodes of the main navigation window.* Adding alternative names for areas lets users incorporate official and unofficial names for areas as well as internationally recognized PCodes}}classifications

|[[HowTo:Hierarchy Manager#Add a Country Structure Arealevels | Add levels]]|[[HowTo:Change a Country Structure AreaHierarchy Manager#Edit levels | Edit levels]]|[[HowTo:Remove a Country Structure AreaHierarchy Manager#Delete levels | Delete levels]]

{{note|class="wikitable"To add, change, or remove country structures, you must have the Country Structure Mgmt permission.! The country structure names displayed in the IMSMA Navigation window’s country structure pane are created using the Country Structure Manager window. ! 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|}

*organisations===Define the Classifications===__NOEDITSECTION__*places {{HowTo's*ordnance|[[Add Assistance Classification]]*cause|[[Add Cause Classification]]*needs|[[Add Needs Classification]]*assistance While this information is easily updated during operational use of IMSMA^NG, it is helpful to establish a baseline of information prior to proceeding with field report template design |[[View and Edit Auxiliary Data | View and data entry. Many IMSMA^NG users already have a baseline set of information created for each of the auxiliary data types, either through the standard, predefined data available within IMSMA^NG or by migrating auxiliary data from a previous IMSMA version. edit classifications]]|[[Delete Auxiliary data can also be augmented by creating CDFs to track additional information.Data| Delete classifications]]}}

===Organisations===IMSMA^NG provides the ability to track information about organisations participating in mine action{{IMSMANG}} contains a set of pre-defined classifications. Organisations can These should be categorized by type seen as a starting point for discussions in each Mine Action and assigned “work areas” based on the country structure/or Assistance Programme. To display organisations on the map, users can provide geospatial data for each organisationThey may be as Excel files '''[[Downloads | here]]'''.

Additionally, IMSMA^NG supports the creation of parent-child relationships {{Note | Contact your [[Information Management Team | GICHD IM advisor]] if you need help 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 NGO1adjusting levels or classifications.}}

[[Image==Define Other Auxiliary Data==__NOEDITSECTION__In addition to establishing the Assistance classification, Cause Classification, Country Structure and Needs classifications in {{IMSMANG}}, information managers can establish other Auxiliary data, including data for:AdminGuide_ExampleHierarchyOfOrganisations.png|center|400px|''Example Hierarchy of Organisations'']]<div align="center">* Ordnance Classification''Example Hierarchy of * Organisations''</div>* Places

This kind While this information is easily updated during operational use of hierarchical relationship allows for complex searching {{IMSMANG}}, it is helpful to establish a baseline of information prior to proceeding with Data Entry Form template design and reporting on data entry. Many {{IMSMANG}} users already have a baseline set of information such as how many square meters were cleared by created for each team and of the Auxiliary data types, either through the total square meters that were cleared standard, predefined data available within {{IMSMANG}} or by the entire organisationmigrating auxiliary data from a previous IMSMA version.

IMSMA^NG also supports the tracking of competencies ===Ordnance Classification===__NOEDITSECTION__This classification is used in Land, Activities and accreditations for each organisationAccidents. The lists of specific competencies and accreditations can be managed in {{IMSMANG}} includes from the Data Inventory Managerinstallation more than 5,000 predefined ordnance models.

|[[HowTo:List Window | Ordnance Classification List window]]|[[Filter Lists | Filter Ordnance Classification]]|[[Add an OrganizationOrdnance Classification]]|[[HowTo:View and Edit Auxiliary Data | View and/or change an Organizationedit Ordnance Classification]]|[[HowTo:Deactivate an OrganizationDelete Auxiliary Data | Delete Ordnance Classification]]

{{note| To view the list of organisations in the Organisation List Window, you must have read-only access All ordnance is grouped according to the Organisations permissioncategories and subcategories. To addFor example, change, or remove organisations, you must an ordnance may have read a category of “Landmine” and write access to the Organisations permissiona subcategory of “Antipersonnel. Organisations are government” In this way, non-government, military, civilian, commercial, or non-profit groups who are responsible for performing activities {{IMSMANG}} provides the ability not only to search and report on, monitoring ongoing activities models but summarise information on, categories and subcategories. This allows queries such as “how many landmines or recording the existence of locations, hazards, activities, and/bombs were cleared in a specific period?” or events}}“how many anti-personnel mines were found?”.

===Places===IMSMA^NG offers {{Note | Other categories than ''Landmines'' have ordnance that belong to the option subcategory ''Anti-Personnel'' so if you only want to track information about specific places or infrastructure elements within a country that are relevant report on AP-mines you need to mine actionfilter on both category '''and''' subcategory. These }} Furthermore, programmes can limit which ordnance can be airports, water sources, hospitals, community centres, refugee camps or any other structures or buildings which designate a political, economic, social, 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/or logistical valuedata quality.  {{HowTo'snote||[[HowTo:Add a Place]]*Before beginning data entry, standardise the ordnance available for use to ensure data consistency of reports. |[[HowTo:View *When adding an ordnance to the database, determine if the ordnance already exists in {{IMSMANG}} and/or change a Place]]|[[HowTo:Remove a Place]]the correct classification.

As with other IMSMA^NG data{{New_6.0 | # '''[[IED Classification | IED]]''', Less-lethal weapons, Light weapons, MANPADS, places can be customised using CDFs Small Arm Ammunitions and represented on Small Arms are new Categories. # The new models belonging to the map by adding geospatial informationabove categories are ''Inactive''.# The new field ''Statistic Group'' has been added in order to facilitate flexible reporting. }}{{note| To view If the list of places in new field ''Statistic Group'' is not used the Place List windowbelow table shows how ''category'', you must have read''subcategory'' and ''model name'' may be used as grouping criteria for statistics by ordnance. {| class="wikitable"! Grouping !! Criteria|-| AP||Category = Landmines AND Subcategory = AP|-| AV ||Category = Landmines AND Subcategory = AT|-only access to the Places permission| Country specific e.g. To addRoadside, changeAnti-group, or remove places, you must have read Trip-ware||1-10 models|-| Cluster||Category = Scatterable munitions + Clusters and write access to dispensers|-| IED||Category = IED|-| UXO||Category = Bombs + Grenades + Guided Missiles + Projectiles + Rockets|-| SALW||Models from the Places permission}other categories + SALW Categories|-| UNK||Category = Unknown|-| Other||Category = Pyrotechnics and Flares + Misc Nonexplosive Devices + Misc Explosive Devices + Naval Mines|-|}

===OrdnanceOrganisations===Another type of auxiliary data available in IMSMA^NG is ordnance. This data is used to represent the various kinds of ordnance found or cleared from lands or that are causing accidents. IMSMA^NG includes more than 5,000 predefined ordnance types with the ability to create additional ordnance required for a mine action programme. __NOEDITSECTION__

|[[HowTo:List Window | Organisation List window]]|[[Filter Lists | Filter Organisatons]]|[[Add Explosive OrdnanceOrganisation]]|[[HowTo:View and Edit Auxiliary Data | View and/or change Explosive Ordnanceedit Organisations]]|[[HowTo:Remove Explosive OrdnanceDelete Auxiliary Data | Delete Organisations]]

All ordnance is grouped according to categories and subcategories, which allows for detailed categorization of each device. For example, an explosive device may have a category of “Landmine” and a subcategory of “Antipersonnel.” In this way, IMSMA^NG {{IMSMANG}} provides the ability not only to search track information about Organisations participating in Mine Action. Organisations can be categorised by type and report assigned “work areas” based on types of ordnance but also the Country Structure. To display Organisations on the specific characteristics map, they must have geospatial data (minimum one set of ordnancecoordinates). This allows queries such as “how many landmines or bombs were cleared in a specific period?” or “how many anti-personnel mines were found?”

FurthermoreAdditionally, programmes can limit which ordnance {{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 used responsible for several clearance teams within a country. As shown in the system figure below, this relationship can be mapped by making individual devices active or inactive. This facilitates rapid data entry by making available only creating one organisation for the mine clearance organisation (NGO1) and one organisation for each team (TeamA, TeamB and TeamC), then specifying the devices that are found locally to a programmeparent organisation of each team as NGO1.

{| class="wikitable"|-| [[FileImage:NoteAdminGuide_ExampleHierarchyOfOrganisations2.jpg png| 40pxcenter|200px|''Example Hierarchy of Organisations'']] || *Before beginning data entry, standardise the devices or types <div align="center">''Example Hierarchy of devices available for use to ensure data consistency for reports. Organisations''*When adding a device to the database, determine if the device already exists in the predefined dataset as there are more than 5,000 devices from the ORDATA ordnance catalogue already in the system.</div>

{{note| To view ordnance in IMSMANG}} also supports the Ordnance List window, you must have read-only access to the Ordnance permissiontracking of competencies and accreditations for each organisation. To add, change, or remove ordnance, you must have read and write access to the Ordnance permission}}

===Cause, Needs, and Assistance===IMSMA^NG offers the option It is possible to add Organisation as [[Data Inventory Manager | CDF to track information concerning victimsother items]]. There are three auxiliary data types available:* The ''Cause'' for someone having become a victim* The ''Needs'' that the victim is assessed to have* The ''Assistance'' that the victim has received

IMSMA^NG ===Places===__NOEDITSECTION__{{IMSMANG}} offers the option to track information about specific places or infrastructure elements within a country that are relevant to mine actionMine Action. These can be airportsammunition storages, water sourcesarmouries, hospitalsairports, community centres, hospitals, refugee camps or any other structures or /buildings which designate a political, economic, social, and/or logistical value.

|[[HowTo:List Window | Place List window]]|[[Filter Lists | Filter Places]]|[[Add a Place]]|[[HowTo:View and Edit Auxiliary Data | View and/or change a Placeedit Places]]|[[HowTo:Remove a PlaceDelete 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 IMSMA^NG {{IMSMANG}} data, places Places can be customised using CDFs and represented on the map by adding geospatial information. It is possible to add Place as [[Data Inventory Manager | CDF to other items]].

{{noteNew_6.0 | To view the list of places in the Place List window, you must Ammunition storage and Armoury have read-only access been added to the Places permission. To add, change, or remove places, you must have read and write access to the Places permission''Place Type''}}

==Import Auxiliary Data==__NOEDITSECTION__{{Warning | Note that neither xml or csv/xls '''cannot''' be imported back into an {{IMSMANG}} system without the help of a [[Information Management Team | GICHD IM advisor]]. }}When the import routine is set up then all users that has permission to import Excel spreadsheet may do so, refer to [[Importing and Exporting Data with IMSMANG#XLS Import | XLS import]] on how to import Excel files.