Difference between revisions of "Exchange with mobile application"

From wiki.fine.cz
Jump to navigation Jump to search
m
m
Line 2: Line 2:


* only GUIDs are used to identify items and enumerations
* only GUIDs are used to identify items and enumerations
*coordinates X and Y are specified in GPS coordinates
*coordinates X and Y are specified in GPS coordinates as Latitude and Longitude -


'''Data file for exchange with mobile application'''
'''Data file for exchange with mobile application'''


* Data file has ZIP format with extension <code>.g5zip</code>
* Data file has ZIP format with extension <code>.g5zip</code>
* It must contain XML file with basic specification - Index.xml
*Contains file <code>Index.xml</code> specifying "what is in the ZIP file"
**Unit System
*Contains other XML files with Template specifications
**Language
*Optionally conains XML files with Data definitions
**Structure of templates (mandatory Project, optional PointsOfInterest, optional FieldTestTemplates) - specify one data/table of data, every data type defined by template has attachments
*Contains other files with attachments of various types (<code>jpg</code>, <code>pdf</code>, ...)
* It must contain templates for various items
 
** ProjectTemplate.xml
==== Example of Index.xml ====
** PointsOfInterestTemplate.xml
<code><?xml version="1.0" encoding="utf-8"?></code>
** FieldTestsTemplate.xml
 
* It can contain data for various items - media files attachments are specified here (OriginalFilename, OriginalTimeStamp, FileType)
<code><G5ZipIndex></code>
** ProjectData.xml
 
** PointsOfInterestData.xml
<code>  <UnitSystem Value="Metric" /></code>
** FieldTestsData.xml
 
* It can contain media files in various formats, filename is <code>GUID.EXT</code>, where <code>GUID</code> is unique GUID and <code>EXT</code> specifies file type
<code>  <Language Value="EN" /></code>
 
<code>  <Category TemplateType="Single" Template="ProjectTemplate.xml" DataType="Single" Data="ProjectData.xml" Root="ProjectData"></code>
 
<code>  <Category TemplateType="Single" Template="PointsTemplate.xml" DataType="Multi" Data="Points.xml" Root="Points"></code>
 
<code>  <Category TemplateType="Multi" Template="FiledtTests.xml" DataType="Multi" Data="FieldTests.xml" Root="FieldTests"></code>
 
<code></G5ZipIndex></code>
 
==== Example of other XMLs ====
'''TemplateXML Type="Single"'''
 
<code><?xml version="1.0" encoding="utf-8"?></code>
 
<code><Root></code>
 
<code>  <Template GUID="{2BBF3527-B079-423B-9A34-AC5666693C36}"></code>
 
<code>    ...</code>
 
<code>  </Template></code>
 
<code></Root></code>
 
 
'''TemplateXML Type="Multi"'''
 
<code><?xml version="1.0" encoding="utf-8"?></code>
 
<code><Root></code>
 
<code>  <Template GUID="..."></code>
 
<code>    ...</code>
 
<code>  </Template></code>
 
<code>  <Template GUID="..."></code>
 
<code>    ...</code>
 
<code>  </Template></code>
 
<code>  ...</code>
 
<code></Root></code>
 
 
'''DataXML Type="Single"'''
 
<code><?xml version="1.0" encoding="utf-8"?></code>
 
<code><Root></code>
 
<code>  <nowiki><Data Template="{2BBF3527-B079-423B-9A34-AC5666693C36}"></nowiki></code>
 
<code>    ...</code>
 
<code>  <nowiki></Data></nowiki></code>
 
<code></Root></code>
 
 
'''DataXML Type="Multi"'''
 
<code><?xml version="1.0" encoding="utf-8"?></code>
 
<code><Root></code>
 
<code>  <nowiki><Data Template="..."></nowiki></code>
 
<code>    ...</code>
 
<code>  <nowiki></Data></nowiki></code>
 
<code>  <nowiki><Data Template="..."></nowiki></code>
 
<code>    ...</code>
 
<code>  <nowiki></Data></nowiki></code>
 
<code>  ...</code>
 
<code></Root></code>

Revision as of 23:39, 27 March 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 -

Data file for exchange with mobile application

  • Data file has ZIP format with extension .g5zip
  • Contains file Index.xml specifying "what is in the ZIP file"
  • Contains other XML files with Template specifications
  • Optionally conains 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" Root="ProjectData">

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

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

</G5ZipIndex>

Example of other XMLs

TemplateXML Type="Single"

<?xml version="1.0" encoding="utf-8"?>

<Root>

  <Template GUID="{2BBF3527-B079-423B-9A34-AC5666693C36}">

    ...

  </Template>

</Root>


TemplateXML Type="Multi"

<?xml version="1.0" encoding="utf-8"?>

<Root>

  <Template GUID="...">

    ...

  </Template>

  <Template GUID="...">

    ...

  </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>