На цій сторінці
PalmOrder Server відокремлює облікову систему від мобільного обміну. Облікова система працює лише з файлами у теках outbox та inbox; підключення пристроїв і передавання даних виконує сервер.
Дані для пристроїв
Інтегратор розміщує в outbox файл exchange.xml та інші файли конфігурації мобільного застосунку.
Для стандартної конфігурації можна використовувати готовий стандартний exchange.xml. Завантажте його та розмістіть у теці outbox під назвою exchange.xml.
Облікова система розміщує в outbox:
- XML-таблиці з довідниками, цінами, залишками, маршрутами й іншими даними;
- зображення та інші файли з даними для мобільного застосунку.
Назва XML-таблиці має відповідати імені, вказаному в exchange.xml. Наприклад, для <db name="ref_products"/> потрібен файл ref_products.xml у outbox.
Облікова система має публікувати лише повністю записані файли. Наприклад, запишіть таблицю в outbox/ref_products.xml.tmp, закрийте файл і атомарно перейменуйте його на ref_products.xml у тій самій теці. Тимчасове ім'я не повинно потрапляти під маски файлів у профілях обміну.
Документи від пристроїв
Коли працівник надсилає документ, сервер створює окремий XML-файл у inbox. Ім'я містить тип документа та syncName; не використовуйте його як бізнес-ідентифікатор і не намагайтеся передбачити суфікс, який створює сервер.
Один XML-файл може містити кілька документів. Облікова система має для кожного нового файла:
- прочитати всі документи;
- імпортувати кожен документ у свою базу та зберегти результат його обробки;
- лише після успішної обробки всіх документів перемістити файл до архівної теки або видалити його.
Якщо імпорт перервався, під час наступного запуску облікова система має пропустити вже імпортовані документи. Для цього зберігайте результат обробки кожного документа за стабільним ключем, визначеним інтегратором.
Точна структура документа описана на сторінці Документи від пристрою.
Файли від пристроїв
Файли, які пристрій надсилає окремо від документів, сервер записує в inbox/files. Наприклад, це можуть бути фотографії. Облікова система має забирати їх за власним правилом так само, як документи з inbox.
Окремі теки для пристроїв
За замовчуванням усі пристрої використовують спільні inbox та outbox. Для окремого syncName адміністратор може задати власну вхідну або вихідну теку. Це корисно, коли різні працівники працюють з різними підрозділами чи обліковими базами.
Порядок налаштування описано на сторінці Зберігання даних.