Changes

IMSMA and maXML

1,214 bytes added, 15:39, 24 July 2019

no edit summary

{{IMSMANG}} exchanges data by exporting and importing maXML files containing information in the form Note | The selection of fields used for Data Entry Forms differs between countries. Mine Action Programs also have the possibility to add its own fields or Auxiliary Datamodify the existing standard ones. Data Entry Forms in This means that {{IMSMANG}} uses data can be very different between countries. It is therefore necessary to understand a selection country’s specific set of fields from a certain topic depending on needs data collection forms in order to be able to collect or enter exchange information ex. Accident can either use fields for civilian accidents in non-surveyed areas or for demining accidents in Land during clearance activitieswith that country’s {{IMSMANG}}. }}

Currently ==Artifacts ==__NOEDITSECTION__ The Artifact pages reflect the structure and sequence of elements as '''defined and exported''' by {{IMSMANG}} can only export auxiliary data, not import it. The latest review form of maXML has focused mainly on updating the maXML schema for those parts that can be exported and imported into by {{IMSMANG}}. The schemas description of auxiliary data still '''differs in many cases ''' slightly from how the maXML defined by the generic maXML schema and therefore some exports will not validate to the original schema. Anyone who would like to exchange information with {{IMSMANG}} exports this information and should not be considered representative of follow {{IMSMANG}} maXML dictionary to construct or read a maXML file correctly formatted for {{IMSMANG}}.

{{IMSMANG}} imports its main objects in the form of field reports. The selection different types of fields used for Data Entry Forms usually differs between countriesfield reports are all collected under the parents MineActionFieldReport, FieldReport in maXML. Mine Action Programs also have the possibility In order to add its own fields or modify the existing standard ones. This means that correctly form a field report for import by {{IMSMANG}} data can be very different between countries. It is therefore necessary one would need to understand construct a country’s specific set maXML document containing the elements DocumenHeader (not required see below), FieldReportInfo and the desired type of data collection forms in order field report, there is also the option to include the element attachment if relevant. The different types of field report are Accident, Hazard, HazardReduction, Location, MREActivity, QAActivity, Victim, and VictimAssistance. Multiple field reports of various types can be able to exchange information with that country’s included in one file and imported by {{IMSMANG}}each separate field report should then be contained within its own FieldReport tags.

==Documentation structure==__NOEDITSECTION__ The Some elements in each Artifact are explained in detail used by several Artifacts such as DocumentHeader, GeospatialInfo etc. and they are specified in the sub Common pages by specifying all . The common elements within are listed in the Artifacts. Each element has a short description together artifacts they appear to reflect their location in maXML but with a table listing its type, IMSMA Field Name, IMSMA Type and its IMSMA Enum Categoryreference to find their specification in common elements.

Some elements are used by several Artifacts such as DocumentHeader, GeospatialInfo etcFor radiobuttons and checkboxes {{IMSMANG}} uses enumeration values retrieved from an enumeration table to restrict the choices available. and they are specified at IMSMA Enum Category refers to the end category of enumeration values for the chapter under common elements{{IMSMANG}} field in question. The common elements are still listed enumeration value is often translated to a different value when displayed in the artifacts they appear to reflect their location application {{IMSMANG}}, either in a different language or in maXML the same language but with another value (e.g. the Land status enumeration list/category contains ''Active'' (a.k.a reference . Base Term) but the value displayed in {{IMSMANG}} is ''Open''. An enumeration list may be obtained by contacting your [[Information Management Team | GICHD IM advisor]]. Choices in {{IMSMANG}} can be customised to find their specification in common elementsfit the needs of specific Mine Action programmes. Customised values are added to the IMSMA enumeration list when created. It is therefore recommended to request specific lists of enumeration values from each country.

The IMSMA type is In addition to the type field reports there are eight elements for Auxiliary data. {{IMSMANG}} does not currently import Auxiliary data but it does export it. It will be of field in interest to read Auxiliary data from {{IMSMANG}} Data Entry Forms for any system that records the intends to exchange information contained by the elementwith {{IMSMANG}} as there are often many references to Auxiliary data in a field report. IMSMA Type Information about organisations, places, country structure and more are referred to in a field report through GUIDs which can only be * Any Value, * any Number, * Multiple Values, * Single Value* Dateobtained from an {{IMSMANG}}installation.

Any Value means ==Required/recommended elements and attributes ==__NOEDITSECTION__ There are very few elements in maXML that are absolutely required in order for {{IMSMANG}} to import the data. Non required elements can be excluded from an import but obviously any information is collected through a textbox without any restrictions on what can they may contain will not be enteredimported. Any number The attribute ''originalValue'' is a textbox restricted to numbers only. Multiple values means that used and exported by {{IMSMANG}} collects the information through checkboxes for all multiple and therefore that the values are predefined but that multiple values can be selected. Single value indicates that single select fields in {{IMSMANG}} collects . They are always the information through radiobuttons where values are predefined same as the value of the element and only one value can be selected. Date is a field restricted to the date format. For radiobuttons and checkboxes IMSMA uses enumeration values retrieved from an enumeration table to restrict the choices available. IMSMA Enum Category refers to the category excluded without any loss of enumeration values for the IMSMA field in questioninformation. The enumeration value is often translated to a different value when displayed in the application IMSMA, either in a different language or in the same language but with another value (e.g. the Land status enumeration list/category contains element ''ActiveUnitOfMeasure'' (a.k.a. Base Term) but and all children of the value displayed in {{IMSMANG}} is ''Open''. An enumeration list may be obtained same are exported by contacting your [[Information Management Team | GICHD IM advisor]]. Choices in {{IMSMANG}} can be customised but are automatically set to fit the needs of specific mine Action programmes. Customised default values are added to the IMSMA enumeration list when created. It is during import and can therefore recommended to request specific lists be excluded without any loss of enumeration values from each countryinformation.

The only value within ''DocumentHeader'' that will be stored by {{IMSMANG}} if included is the ''FileCreationDateTime'', all others will have values automatically assigned by {{IMSMANG}} whether they contain anything or not. If left out the ''FileCreationDateTime'' will be assigned to the moment of import by {{IMSMANG}}. The ''DocumentHeader'' element can be left out entirely from a xml file and {{IMSMANG}} will still import it without errors or information lost.

{{NavBox XML Documentation}}

[[Category:NAA]]

• ← Older edit

Alnaucler

NoPublic, bureaucrat, administrator

6,632

edits