Шаблон адреси визначає, як ERPNext форматує адресу в документах, друкованих формах, попередньому перегляді та листуванні. Шаблони для окремих країн дають змогу кожному регіону використовувати звичний порядок, підписи й необов'язкові поля.
ERPNext вибирає шаблон за країною, вказаною в адресі. Якщо шаблону для цієї країни немає, використовується шаблон, позначений як шаблон за замовчуванням.
Перш ніж почати
Вам знадобляться:
- права «Менеджер системи» або рівнозначні;
- країна, для якої задається формат;
- зразок адреси з усіма потрібними полями;
- базове знання HTML і шаблонів Jinja;
- тестовий документ або друкована форма, на якій можна перевірити результат.
Перед суттєвою зміною скопіюйте наявний текст шаблону. Синтаксична помилка може зіпсувати кожен документ, що виводить адресу для цієї країни.
Створення шаблону адреси
- Відкрийте CRM > Шаблон адреси.
- Натисніть Додати шаблон адреси.
- Виберіть Країну.
- Введіть шаблон на Jinja та HTML.
- Вмикайте За замовчуванням лише тоді, коли цей шаблон має бути резервним для країн без власного шаблону.
- Збережіть шаблон адреси.
Зазвичай для кожної країни створюють один шаблон. Залишайте лише один відповідний резервний шаблон за замовчуванням.
Редагування наявного шаблону
- Відкрийте шаблон потрібної країни.
- Скопіюйте поточний шаблон, щоб мати змогу повернутися до нього.
- Внесіть мінімально потрібну зміну.
- Збережіть.
- Відкрийте типову адресу клієнта чи постачальника й перевірте, як вона виглядає.
- Перевірте щонайменше одну комерційну пропозицію, рахунок-фактуру або відповідний попередній перегляд друку.
Успішне збереження ще не означає, що результат правильний. Перевірте розриви рядків, відсутні значення, підписи, розділові знаки й вигляд у вузьких друкованих формах.
Основні поля та поняття
| Поле або поняття | Що воно визначає |
|---|---|
| Країна | Які адреси використовують цей шаблон |
| За замовчуванням | Робить шаблон резервним, якщо шаблону для країни немає |
| Шаблон | Jinja та HTML, за якими форматується адреса |
address_line1 |
Перший рядок: вулиця або будинок |
address_line2 |
Необов'язковий другий рядок адреси |
city |
Місто або селище |
county |
Округ або аналогічна регіональна одиниця |
state |
Штат, провінція чи область |
pincode |
Поштовий індекс, ZIP або PIN |
country |
Назва країни |
| Контактні поля | Необов'язкові телефон, факс і електронна пошта, доступні в шаблоні |
| Користувацькі поля | Додаткові поля адреси, доступні за їхніми службовими іменами |
Службові імена полів чутливі до регістру. Використовуйте службове ім'я з «Налаштування форми» або метаданих DocType, а не підпис поля, який бачать користувачі.
Як безпечно писати Jinja
Обгортайте необов'язкові значення умовами, щоб порожні поля не залишали «висячих» підписів чи розділових знаків:
{{ address_line1 }}<br>
{% if address_line2 %}{{ address_line2 }}<br>{% endif %}
{{ city }}{% if state %}, {{ state }}{% endif %} {{ pincode }}<br>
{{ country }}
Для навмисних розривів рядків адреси використовуйте <br>. Не виносьте в шаблон складну бізнес-логіку — краще зберігайте в адресі вже впорядковані дані.
Шаблонізатор має доступ до стандартних і користувацьких полів адреси. Перш ніж посилатися на користувацьке поле, ознайомтеся з налаштуванням форми.
Шаблони для країн і шаблон за замовчуванням
Для адреси в США шаблон може виводити місто, штат і ZIP в одному рядку, а округ — лише за потреби. В іншій країні поштовий індекс може стояти перед містом.
ERPNext визначає шаблон у момент виведення адреси — за країною, вказаною в адресі. Тому:
- якщо застосовується не той шаблон, виправте країну;
- створюйте шаблон для країни, лише коли є реальна регіональна відмінність;
- використовуйте шаблон за замовчуванням як надійний загальний резервний варіант;
- не позначайте за замовчуванням кілька шаблонів, що суперечать один одному.
Шаблони адрес впливають на клієнтів, постачальників, організації, склади, контакти та документи, як-от видаткові накладні, — скрізь, де виводяться відформатовані адреси.
Збереження та подальші кроки
Шаблон адреси зберігають, а не проводять. Після збереження:
- перевірте кілька повних і неповних адрес;
- перевірте адреси для рахунків і доставки;
- перегляньте замовлення на продаж і рахунок-фактуру на покупку;
- протестуйте відповідні власні друковані форми;
- задокументуйте залежності від користувацьких полів для майбутніх адміністраторів.
Усунення проблем
| Проблема | Що перевірити |
|---|---|
| Виводиться не той формат | Перевірте країну в адресі та шаблон для цієї країни |
| Немає шаблону для країни | ERPNext має використати шаблон, позначений «За замовчуванням» |
| З'являються порожні підписи чи зайві розділові знаки | Обгорніть увесь необов'язковий рядок або підпис умовою Jinja |
| Поле ніколи не виводиться | Перевірте точне службове ім'я поля та чи заповнене воно в адресі |
| Збереження успішне, але друк ламається | Перевірте структуру HTML, блоки Jinja та доступну ширину друкованої форми |
| Користувацьке поле спричиняє помилку | Переконайтеся, що поле існує в кожному цільовому середовищі, або додайте відповідну перевірку |
Часті запитання
Чи можна використовувати користувацькі поля?
Так. Користувацькі поля адреси доступні в шаблоні за службовими іменами.
Чи потрібен шаблон для кожної країни?
Ні. Створюйте шаблони лише там, де формат відрізняється; решту покриває шаблон за замовчуванням.
Чи можна в шаблоні змінити підписи полів, наприклад PIN на ZIP?
Так. Просто напишіть потрібний підпис у шаблоні для відповідної країни.
Чи оновлюють зміни шаблону проведені документи?
Вони можуть змінити адресу, яка виводиться наново, — залежно від того, як документ чи друкована форма зберігає або отримує адресу. Перш ніж покладатися на поведінку для старих документів, перевірте конкретний тип документа.
Чи можна використовувати CSS?
Оформлення має бути стриманим і сумісним із цільовою друкованою формою. Для адрес краще використовувати семантичний HTML і прості розриви рядків.
Пов'язані теми
Переклад сторінки «Address Template» з документації ERPNext. © Frappe Technologies Pvt. Ltd., ліцензія CC BY-SA 3.0. Переклад — OpenOblik, на тих самих умовах. Переклад машинний, вичитка триває: помітили неточність — напишіть нам.