Exchange with mobile application
There are some limitations to Data and Template XML file used for exchange data with mobile application:
- only GUIDs are used to identify items and enumerations
- coordinates X and Y are specified in GPS coordinates as Latitude and Longitude
<Item ID="{A80C49D2-091F-4AAC-8430-75C602F3BD6C}" ItemType="Double">
<Name Lang="CS" Text="Zeměpisná šířka" />
<Name Lang="EN" Text="Latitude" />
<Settings UnitType="Angle" UnitDefMetric="deg" DecimalDigitsMetric="7" ExponentMetric="false" />
</Item>
<Item ID="{112D9BFC-F300-43FA-994E-A57DE8FD3E0F}" ItemType="Double">
<Name Lang="CS" Text="Zeměpisná délka" />
<Name Lang="EN" Text="Longitude" />
<Settings UnitType="Angle" UnitDefMetric="deg" DecimalDigitsMetric="7" ExponentMetric="false" />
</Item>
- mapové značky jsou definovány enumerací s určeným GUID
<Item ID="{9E0528F6-0B21-4044-BEAD-242C907934C5}" ItemType="Enum">
Formatted text for mobile application
- texts in template use the formatting capabilities 1., 2., 3., 4., 7., 8., 9., 10.
- texts in data are plain for the first version - no formatting is used
Data file for exchange with mobile application
- Data file has ZIP format with extension
.g5zip
- Contains the file
Index.xml
specifying "what is in the ZIP file" - Contains other XML files with Template specifications
- Optionally contains XML files with Data definitions
- Contains other files with attachments of various types (
jpg
,pdf
, ...)
Example of Index.xml
<?xml version="1.0" encoding="utf-8"?>
<G5ZipIndex>
<UnitSystem Value="Metric" />
<Language Value="EN" />
<Category TemplateType="Single" Template="ProjectTemplate.xml" DataType="Single" Data="ProjectData.xml">
<Category TemplateType="Single" Template="PointsTemplate.xml" DataType="Multi" Data="Points.xml">
<Category TemplateType="Multi" Template="FieldTests.xml" DataType="Multi" Data="FieldTests.xml">
</G5ZipIndex>
- UnitSystem specifies system of units (not included for default template - for USA use imperial, otherwise metric)
- Language specifies app language (not included for default template - language is determined by operating system)
- TemplateType speciifies, whether there is only one Template (
Single
) for entering data or user selects from list of Templates (Multi
) when creating new data item - DataType specifies if data have only single instance (
Single
) (exactly one) or user can add/edit/delete data in table (Multi
)
Template has boolean attribute PreferIdent
, if true
, in application shows Ident instead of Name of elements, if Ident is non-empty.
Example of other XMLs
TemplateXML Type="Single"
<?xml version="1.0" encoding="utf-8"?>
<Root>
<Template GUID="{2BBF3527-B079-423B-9A34-AC5666693C36}" PreferIdent="false">
...
</Template>
</Root>
TemplateXML Type="Multi"
<?xml version="1.0" encoding="utf-8"?>
<Root>
<Name>
<Item Lang="CS" Text="Polní zkoušky" />
</Name>
<Template GUID="..." PreferIdent="false">
...
</Template>
<Template GUID="..." PreferIdent="true">
...
</Template>
...
</Root>
DataXML Type="Single"
<?xml version="1.0" encoding="utf-8"?>
<Root>
<Data Template="{2BBF3527-B079-423B-9A34-AC5666693C36}">
...
</Data>
</Root>
DataXML Type="Multi"
<?xml version="1.0" encoding="utf-8"?>
<Root>
<Data Template="...">
...
</Data>
<Data Template="...">
...
</Data>
...
</Root>