Налаштування колонок

tables_columns.xml визначає вигляд колонок у довідниках, журналах і табличних частинах документів Android-застосунку. Інтегратор готує файл і розміщує його в outbox для передавання пристроям.

Структура файла

Кореневий елемент — <tables-columns>. Кожен <table> задає таблицю та її вигляд, а вкладені <column> — колонки в потрібному порядку.

Кодування файла має збігатися зі значенням encoding в оголошенні XML.

Приклад показує три колонки довідника товарів: код, назву та роздрібну ціну.

<?xml version="1.0" encoding="utf-8"?>
<tables-columns>
  <table name="ref_products">
    <column name="code">
      <displayName>Код</displayName>
      <width>80</width>
      <visible>true</visible>
      <type>0</type>
    </column>
    <column name="name">
      <displayName>Назва</displayName>
      <width>200</width>
      <stretchable>true</stretchable>
      <wrap_text>true</wrap_text>
      <type>0</type>
    </column>
    <column name="price_Retail">
      <displayName>Ціна</displayName>
      <width>90</width>
      <align>2</align>
      <type>2</type>
      <decimalScale>2</decimalScale>
    </column>
  </table>
</tables-columns>

column name має збігатися з назвою поля відповідної таблиці. Наприклад, price_Retail використовується лише тоді, коли в довіднику товарів є поле з такою назвою.

Для кожної пари «таблиця та вигляд» файл замінює весь набір стандартних налаштувань колонок. Перелічіть колонки, для яких потрібно задати оформлення. Поля таблиці, яких немає в цьому наборі, застосунок може додати до вигляду зі стандартними параметрами. Щоб приховати поле, задайте для нього visible=false. Інші таблиці, яких немає у файлі, зберігають свої налаштування.

Властивості колонки

Назви елементів чутливі до регістру: використовуйте саме displayName і decimalScale.

Порядок колонок визначається порядком <column> у файлі. Параметр position задавати не потрібно. type змінює формат показу, а не тип даних у вихідній XML-таблиці.

Таблиці та вигляди

Для таблиці підбору товарів у замовленні або стор-чеку використовуйте ref_products з атрибутом layout="multiselect":

<table name="ref_products" layout="multiselect">
  <column name="name">
    <displayName>Товар</displayName>
    <width>200</width>
    <stretchable>true</stretchable>
  </column>
  <column name="doc_orders_products_count">
    <displayName>Кількість</displayName>
    <width>90</width>
    <align>2</align>
    <type>2</type>
    <decimalScale>3</decimalScale>
  </column>
</table>

Це окремий вигляд зі своїми колонками. Розмістіть фрагмент усередині <tables-columns>. Для стандартного довідника товарів і підбору можна мати два окремі елементи <table name="ref_products"> у тому самому файлі: без layout та з layout="multiselect".

Як передати файл

1. Покладіть файл під назвою tables_columns.xml безпосередньо в теку outbox, налаштовану для потрібного пристрою.

2. Додайте отримання файла в профіль exchange.xml. Наприклад, у наявному профілі Завантажити налаштування всередині <get><files> розмістіть:

   <file name="tables_columns" files="tables_columns.xml"/>
   

3. На пристрої виконайте дію Завантажити файл обміну, а потім профіль Завантажити налаштування.

4. Перевірте журнал обміну на пристрої: файл має бути встановлений без помилок.

5. Відкрийте Налаштування → Скидання налаштувань таблиць, позначте потрібні таблиці та підтвердьте скидання.

6. Відкрийте таблицю повторно й перевірте назви, порядок і формат колонок.

Завантаження файла оновлює стандартні налаштування колонок, а скидання переносить їх у поточний вигляд таблиці. Воно замінить попередні зміни колонок, зроблені на пристрої для позначених таблиць. Для прикладу з layout="multiselect" виберіть Підбір товарів для документа «Замовлення» / «Стор-чек».

Якщо вигляд не змінився

Спочатку перевірте журнал обміну на пристрої. Помилки імпорту tables_columns.xml показує мобільний застосунок.