Exchange with mobile application

From wiki.fine.cz
Revision as of 16:13, 20 June 2022 by Petr.Bures (talk | contribs)
Jump to navigation Jump to search

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>

Data file for exchange with mobile application

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" Root="ProjectData">

  <Category TemplateType="Single" Template="PointsTemplate.xml" DataType="Multi" Data="Points.xml" Root="Points">

  <Category TemplateType="Multi" Template="FieldtTests.xml" DataType="Multi" Data="FieldTests.xml" Root="FieldTests">

</G5ZipIndex>

  • UnitSystem specifies system of units (for default template can be here both unit systems)
  • Language specifies app language (for default template can be here more language elements)
  • TemplateType speifies, whether there is only one Template for entering data or user selects from list of Templates when creating new data item
  • DataType specifies if data have only single instance (exactly one) or user can add/edit/delete data in table
  • Root is the name of root element in XML files

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>