Документація/Формати даних

Адміністратору

exchange.xml

Профілі обміну, таблиці, файли та документи, які передає мобільний застосунок.

exchange.xml визначає, які дані мобільний застосунок отримує із сервера та які документи або файли надсилає назад. Інтегратор готує цей файл і розміщує його безпосередньо в outbox під назвою exchange.xml.

Після оновлення файла в outbox виконайте на пристрої системну дію Завантажити файл обміну. Застосунок замінить локальну конфігурацію та покаже доступні профілі.

Профілі обміну

Кореневий елемент — <palm-client>. Усередині нього розміщуються один або кілька профілів <exchange>.

<?xml version="1.0" encoding="UTF-8"?>
<palm-client>
  <exchange name="complete" view="Завантажити дані">
    <get>
      <dbs>
        <db name="ref_products"/>
        <db name="ref_customers"/>
      </dbs>
    </get>
  </exchange>
</palm-client>
ЕлементПризначення
<exchange>Один профіль, доступний користувачу під назвою з view.
<get>Дані й файли, які пристрій отримує із outbox.
<post>Документи й файли, які пристрій надсилає серверу.
<db>Ім'я XML-таблиці без розширення .xml.
<file>Звичайний файл або маска файлів для передавання.

Документи, які надсилає пристрій

У профілі <post> елемент <document> описує один тип документа. Він містить назву документа, таблицю шапки, умови передавання та перелік полів.

<document name="order" view="Замовлення" tableName="doc_orders">
  <syncFields>
    <field name="send_status" value="0" set="1"/>
  </syncFields>
  <docHead>
    <field name="number"/>
    <field name="customer_code"/>
  </docHead>
  <docTable tableName="doc_orders_products">
    <field name="code"/>
    <field name="count"/>
  </docTable>
</document>
  • <syncFields> визначає поля та значення, за якими застосунок вибирає документи для передавання.
  • <docHead> задає поля шапки документа.
  • <docTable> задає поля табличної частини.

В атрибуті value задається значення поля для вибору документів, а в set — значення, яке застосунок запише після успішного передавання. У прикладі send_status="0" означає, що документ ще не надісланий; після передавання застосунок встановлює send_status="1".

Документ може не мати табличної частини. Якщо вона є, у кожному <document> дозволений лише один <docTable>.

Приклад

Для першого обміну використайте готовий приклад exchange.xml. Він містить профілі для передавання документів, завантаження таблиць, зображень, налаштувань і форм друку.

Практичний порядок підготовки даних описано на сторінці Перший обмін.