Difference between revisions of "Exchange with mobile application"
Petr.Bures (talk | contribs) m  | 
				Petr.Bures (talk | contribs)  m  | 
				||
| Line 22: | Line 22: | ||
<code></Item></code>  | <code></Item></code>  | ||
* mapové značky jsou definovány enumerací s určeným GUID  | |||
<code><Item ID="{9E0528F6-0B21-4044-BEAD-242C907934C5}" ItemType="Enum"></code>  | |||
'''[[Formatted text value|Formatted text]] for mobile application'''  | '''[[Formatted text value|Formatted text]] for mobile application'''  | ||
Revision as of 09:04, 3 August 2022
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.xmlspecifying "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>
  <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>