Бағандарды баптау — Құжаттама PalmOrder

Осы бетте

tables_columns.xml Android қосымшасындағы анықтамалықтарда, журналдарда және құжаттардың кестелік бөліктерінде бағандардың көрінісін анықтайды. Интегратор файлды дайындап, құрылғыларға жіберу үшін outbox қалтасына орналастырады.

Файл құрылымы

Түбірлік элемент — <tables-columns>. Әр <table> кесте мен оның көрінісін, ал ішкі <column> элементтері бағандарды қажетті ретпен белгілейді.

Файлдың нақты кодтауы XML декларациясындағы encoding мәніне сәйкес келуі керек.

Мысалда тауарлар анықтамалығының үш бағаны көрсетілген: код, атау және бөлшек сауда бағасы.

<?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 қолданыңыз.

Элемент	Мәндер	Мақсаты
`displayName`	Мәтін	Экрандағы баған атауы. Көрсетілмесе, `column name` қолданылады.
`visible`	`true`, `false`	Бағанды көрсету немесе жасыру. Әдепкі мәні — `true`.
`width`	Оң бүтін сан	Экран масштабын ескеретін баған ені. Әдепкі мәні — `100`.
`stretchable`	`true`, `false`	Бос орынды толтыру үшін бағанды кеңейту. Әдепкі мәні — `false`.
`wrap_text`	`true`, `false`	Ұзын мәтінді баған ішінде келесі жолға тасымалдау. Әдепкі мәні — `false`.
`from_new_line`	`true`, `false`	Өрісті жазба ішіндегі жаңа жолдан бастап көрсету. Әдепкі мәні — `false`.
`align`	`0`, `1`, `2`	Туралау: `0` — сол жаққа, `1` — ортаға, `2` — оң жаққа. Әдепкі мәні — `0`.
`type`	`0`, `1`, `2`, `3`	Көрсету пішімі: `0` — мәтін, `1` — бүтін сан, `2` — бөлшек сан, `3` — күн. Әдепкі мәні — `0`.
`decimalScale`	Теріс емес бүтін сан	`type=2` үшін ондық бөлгіштен кейінгі таңбалар саны. Әдепкі мәні — `2`.

Бағандардың реті файлдағы <column> ретімен анықталады. position параметрін көрсету қажет емес. type бастапқы XML-кестедегі дерек түрін емес, көрсету пішімін өзгертеді.

Кестелер мен көріністер

`<table>` элементінің `name` атрибутының мәні	Қайда қолданылады
`ref_products`	Тауарлар анықтамалығы.
`ref_customers`	Клиенттер анықтамалығы.
`routes`	Бағыттар.
`doc_orders`	Тапсырыстар журналы.
`doc_invoices`	Төлемдер журналы.
`doc_storechecks`	Стор-чектер журналы.
`doc_debts`	Қарыздар журналы.
`doc_orders_products`	Тапсырыс жолдары.
`doc_storechecks_products`	Стор-чек жолдары.
`doc_debts_products`	Қарыз жолдары.

Тапсырысқа немесе стор-чекке тауар таңдау кестесі үшін layout="multiselect" атрибуты бар ref_products пайдаланыңыз:

<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" атрибутымен.

Файлды жіберу

tables_columns.xml деп аталған файлды қажетті құрылғыға бапталған outbox қалтасына тікелей салыңыз.
Файлды жүктеуді exchange.xml профиліне қосыңыз. Мысалы, стандартты алмасу файлындағы Завантажити налаштування (Баптауларды жүктеу) профилінің <get><files> бөлігіне мынаны орналастырыңыз:
```
<file name="tables_columns" files="tables_columns.xml"/>
```
Құрылғыда Алмасу файлын жүктеу әрекетін, содан кейін Завантажити налаштування (Баптауларды жүктеу) профилін орындаңыз. Профильдің view атрибутын өзгертсеңіз, сол атауды пайдаланыңыз.
Құрылғыдағы алмасу журналын тексеріңіз: файл қатесіз орнатылуы керек.
Баптаулар → Кесте баптауларын қалпына келтіру бөлімін ашып, қажетті кестелерді белгілеңіз және қалпына келтіруді растаңыз.
Кестені қайта ашып, баған атауларын, ретін және пішімін тексеріңіз.

Файлды жүктеу бағандардың әдепкі баптауларын жаңартады, ал қалпына келтіру оларды кестенің ағымдағы көрінісіне қолданады. Ол белгіленген кестелер үшін құрылғыда бұрын жасалған баған өзгерістерін ауыстырады. layout="multiselect" мысалы үшін «Тапсырыс» / «Стор-чек» құжатына тауар таңдау тармағын таңдаңыз.

Көрініс өзгермесе

Алдымен құрылғыдағы алмасу журналын тексеріңіз. tables_columns.xml импорттау қателерін мобильді қосымша көрсетеді.

Белгі	Нені тексеру керек
Файл жүктелмеді	Дәл `tables_columns.xml` атауын, құрылғының `outbox` қалтасын және файлды жүктеу профилін.
Орнату қатесі	XML дұрыстығын, кесте мен баған қасиеттерінің атауларын, артық бос орынсыз бүтін сан мәндерін.
Файл орнатылды, бірақ кесте бұрынғыдай көрінеді	Жүктеуден кейін қажетті кестенің баптаулары қалпына келтірілгенін.
Анықтамалық өзгерді, бірақ тауар таңдау өзгермеді	`layout="multiselect"` атрибутын және қалпына келтіру кезінде дәл тауар таңдаудың белгіленгенін.
Баған жоғалды	Өрістің жүктелген кестеде бар екенін және осы көрініс баптауларындағы `visible` мәнін.