Налаштування друку — Документація PalmOrder

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

Друковані форми визначають, як документ виглядатиме на папері або у PDF. Інтегратор готує конфігурацію й шаблони, розміщує їх у outbox, а Android-застосунок отримує їх через обмін.

Файли форм

Результат	Конфігурація	Шаблон	Дія в документі
PDF для перегляду або надсилання	`pdf_forms.xml`	HTML-файл.	Перегляд або Поділитися.
Друк на Bluetooth-принтері	`print_forms.xml`	Файл `.prn`.	Друк.

Для PDF і Bluetooth-друку використовуються окремі переліки форм. Один документ може мати кілька форм для кожного способу виведення.

В обох видах шаблонів використовується мова Chunk Templates: вона підставляє поля документа, повторює рядки товарів і показує фрагменти за умовами.

У застосунку вже є PDF-форми рахунку-фактури та видаткової накладної для замовлення. Якщо вони підходять, власні файли передавати не потрібно. Створення власної форми описано на сторінці PDF-форми.

Які дані використовує форма

Форма отримує дані відкритого документа, його рядків і пов'язаних довідників. Для замовлення це, зокрема:

номер і дата, клієнт, сума та знижка;
товари, кількість, коефіцієнт фасовки, ціна й сума кожного рядка;
реквізити вашої компанії з налаштувань застосунку.

Перелік полів у профілі надсилання документів не визначає склад даних друкованої форми. Поля документа й довідників описано в розділах Схеми документів та Довідники та маршрути.

Реквізити компанії

На пристрої відкрийте Налаштування → Друк → Реквізити й заповніть:

Налаштування	Значення в шаблоні
Назва компанії	`{$we.company}`
Адреса	`{$we.address}`
ЄДРПОУ або ІПН	`{$we.registration}`
Банківські реквізити	`{$we.billing}`
Примітка	`{$we.comment}`

Шаблон показує лише ті реквізити, які в ньому використані. Якщо дані компанії відсутні у готовому PDF, перевірте і заповнення реквізитів на пристрої, і відповідні поля шаблону.

Передавання форм на пристрій

Підготуйте файл конфігурації та всі шаблони, на які він посилається.
Покладіть їх безпосередньо в теку outbox, налаштовану для пристрою.
Додайте отримання цих файлів у <get><files> потрібного профілю exchange.xml.
На пристрої виконайте Завантажити файл обміну, а потім профіль отримання форм.
Перевірте журнал обміну на пристрої, відкрийте документ і виберіть потрібну дію в його меню.

Залишайте стандартне місце збереження конфігурації та шаблонів на пристрої: у профілі не потрібно задавати storage="external" або destinationFolder. Імена файлів у конфігурації та профілі обміну мають збігатися.

У стандартному exchange.xml профіль Завантажити форми для друку отримує print_forms.xml і файли *.prn. Для PDF додайте отримання pdf_forms.xml та потрібних HTML-файлів. Готовий профіль є в прикладі PDF-форми.

Під час наступного оновлення шаблону достатньо знову виконати профіль отримання форм. Повторно завантажувати exchange.xml потрібно лише після зміни самого профілю.

Перевірка результату

Відкрийте замовлення з товарами та перевірте:

назву компанії та реквізити;
номер, дату й клієнта документа;
назви товарів, кількість і коефіцієнти фасовок;
ціни, знижки й підсумкові суми;
українські літери та перенесення довгих назв.

Для PDF спочатку скористайтеся Переглядом, а потім Поділитися, щоб перевірити надсилання файла. Для Bluetooth-друку також потрібно вибрати принтер у Налаштування → Друк → Принтер і перевірити результат на ньому.

Якщо форма недоступна

Симптом	Що перевірити
Файли не завантажилися	Журнал обміну, теку `outbox` пристрою та перелік `<file>` у профілі.
Немає форми для документа	Ім'я документа в конфігурації форм і наявність потрібного запису `<form>`.
Форма є, але не відкривається	Наявність шаблону на пристрої та збіг його імені з `<file>` у конфігурації.
Форма показує попередній вигляд	Чи отримано оновлений шаблон під тим самим ім'ям і чи повторно сформовано PDF або виконано друк.
Реквізити або поля порожні	Значення в документі, довідниках і налаштуваннях реквізитів; написання тегів у шаблоні.

Помилки обміну перевіряйте в журналі пристрою. Якщо файл не вдалося отримати із сервера, скористайтеся також сторінкою Журнали та підтримка.