Перший обмін — Документація PalmOrder

На цій сторінці

Цей сценарій перевіряє весь робочий шлях PalmOrder Server: облікова система готує дані в outbox, пристрій їх отримує, а створене замовлення повертається в inbox.

Перед початком

Потрібно, щоб:

PalmOrder Server був встановлений і запущений;
у панелі керування були задані правильні теки inbox та outbox;
сервер мав активну ліцензію або доступний демо-пристрій;
Android-пристрій був спарований із сервером;
пристрій міг відкрити адресу сервера через локальну мережу або HTTPS.

1. Підготуйте таблиці в outbox

Запишіть безпосередньо в теку outbox XML-таблиці, потрібні для створення замовлення:

outbox/
├── ref_customers.xml
├── ref_products.xml
├── vl_cat_prices.xml
├── vl_delivery_types.xml
├── vl_pay_types.xml
├── vl_trade_points.xml
├── doc_debts.xml
├── doc_debts_products.xml
├── customer_product_data.xml
└── routes.xml

Файли таблиць має сформувати облікова система з актуальними клієнтами, товарами, цінами та точками продажу. Кожен файл повинен мати кореневий елемент <table> і бути повністю записаний до початку обміну. Найпростіше спочатку створити тимчасовий файл, а після завершення запису атомарно перейменувати його на потрібну назву.

2. Завантажте готовий exchange.xml

Завантажте приклад exchange.xml і покладіть його безпосередньо в теку outbox під цією назвою. Він містить профілі:

Передати документи — замовлення, оплати, стор-чеки та файли;
Завантажити дані — таблиці з переліку вище;
Завантажити зображення, Завантажити налаштування та Завантажити форми для друку — додаткові файли, коли вони з’являться в outbox.

3. Завантажте файл обміну

На Android-пристрої відкрийте обмін і запустіть системну дію Завантажити файл обміну. Ця дія доступна навіть до встановлення власного exchange.xml.

Застосунок отримає exchange.xml із outbox, перевірить XML і замінить локальну конфігурацію обміну. Після завершення у списку мають з’явитися профілі Передати документи, Завантажити дані та додаткові профілі файлів.

Якщо файл не завантажився, спочатку перевірте, що він називається саме exchange.xml, лежить у теці outbox, налаштованій для цього syncName, і має коректне XML-кодування.

4. Отримайте таблиці

Запустіть профіль Завантажити дані. PalmOrder Server для кожного запитаного імені:

знаходить однойменний XML-файл в outbox;
створює SQLite-базу у власній теці cache;
передає базу спарованому пристрою;
повторно використовує кеш, доки вихідний XML не зміниться.

У журналі обміну на пристрої всі запитані таблиці мають завершитися без помилок. У журналі сервера знайдіть події цього самого syncName.

Вихідні табличні XML-файли залишаються в outbox. Вони не відображаються пристрою як звичайні файли й не видаляються після завантаження.

5. Створіть і надішліть замовлення

У PalmOrder створіть замовлення для клієнта й товару з підготовлених таблиць. Збережіть документ, відкрийте обмін і запустіть Передати документи.

Після успішного надсилання сервер створить у inbox окремий XML-файл. Його ім’я починається з типу документа та містить syncName, наприклад:

order_sales-kyiv-1_6aa1d0ae1.xml

Точний часовий суфікс генерує сервер, тому облікова система не повинна намагатися його передбачити.

6. Перевірте отриманий документ

Відкрийте новий файл з inbox. Замовлення повинно містити шапку та рядки товарів:

<?xml version="1.0" encoding="utf-8"?>
<post user="sales-kyiv-1" connType="remote">
  <docs name="order">
    <doc>
      <head>
        <field name="number" value="ЗК-1"/>
        <field name="customer_code" value="C-001"/>
      </head>
      <table>
        <row>
          <field name="code" value="P-001"/>
          <field name="count" value="2"/>
          <field name="price" value="42.5"/>
          <field name="sum" value="85"/>
        </row>
      </table>
    </doc>
  </docs>
</post>

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

Ознаки успішного обміну

пристрій завантажив актуальний exchange.xml;
профіль Завантажити дані встановив усі запитані таблиці;
на пристрої можна вибрати клієнта й товар та зберегти замовлення;
профіль Передати документи завершився без помилок;
в inbox з’явився XML-файл із правильним типом документа та syncName;
облікова система прочитала документ лише один раз.

Якщо обмін не виконався

Спочатку відкрийте Журнал у панелі керування. Знайдіть подію за часом обміну та syncName пристрою: її повідомлення зазвичай пояснює, на якому кроці сервер зупинився. Якщо причина неясна, перевірте таке:

Симптом	Що перевірити після журналу
Пристрій не з’єднується	Адресу, порт, HTTP/HTTPS, доступ у брандмауері та стан парування.
`exchange.xml` не знайдено	Теку `outbox`, налаштовану для `syncName`, точне ім’я файла та права сервера на читання.
Таблиця не завантажується	Ім’я в `<db>`, ім’я XML-файла, кореневий `<table>`, схему та кількість `<f>` у записах.
Замовлення не з’явилося в `inbox`	`send_status`, теку `inbox`, налаштовану для `syncName`, і права на запис.
Документ приходить повторно	Чи оновив застосунок `send_status` зі значення `0` на `1` та чи ERP прибирає оброблений файл з `inbox`.