Құжаттама/Деректер пішімдері

Әкімшіге

Еркін кестелер

Қосымша кестелер, custom_tables.xml, мәзір тармақтары және алмасу арқылы жүктеу мысалы.

Еркін кестелер құрылғыда бухгалтерлік есеп жүйесінің қосымша деректерін, мысалы сату жоспарын немесе талдамалық есепті көрсетуге мүмкіндік береді. Әр кесте үшін негізгі мәзірде бөлек тармақ пайда болады. Бұл мүмкіндік Medium және Full клиенттік лицензияларында қолжетімді.

Еркін кестенің атауын интегратор таңдайды. Төмендегі ct_sales_plan — «Сату жоспары» кестесіне арналған мысал ғана, міндетті немесе резервтелген атау емес. Өз кестеңіз үшін техникалық атау таңдап, оны файл атауында, <table name> атрибутында, <name> элементінде және <db name> профиль жазбасында бірдей қолданыңыз.

Қажетті файлдар

ФайлКім дайындайдыМақсаты
Кестеңіздің деректер файлыБухгалтерлік есеп жүйесі.Кестелік XML пішіміндегі деректер. Файл атауын интегратор таңдайды.
custom_tables.xmlИнтегратор.Еркін кестелер тізімі және олардың мәзірдегі атаулары.
exchange.xmlИнтегратор.Деректер мен custom_tables.xml файлын жүктеу профилі.

Барлық файлдар құрылғыға бапталған outbox қалтасына тікелей орналастырылады. Кесте деректері мен оның custom_tables.xml ішіндегі жазбасында бірдей атау қолданылуы керек.

Атау қайда қолданылады«Сату жоспары» кестесінің мысалы
Деректер файлыct_sales_plan.xml
Деректердің түбірлік элементі<table name="ct_sales_plan">
custom_tables.xml ішіндегі жазба<name>ct_sales_plan</name>
exchange.xml ішіндегі жүктеу<db name="ct_sales_plan"/>

Кесте деректері

Төменде «Сату жоспары» кестесінің деректер файлы көрсетілген. ct_sales_plan атауы тек осы мысалда қолданылады:

<?xml version="1.0" encoding="utf-8"?>
<table name="ct_sales_plan">
  <schema>
    <field name="product_name" type="TEXT"/>
    <field name="plan" type="REAL"/>
    <field name="actual" type="REAL"/>
  </schema>
  <data>
    <record>
      <f>Су 1 л</f>
      <f>500</f>
      <f>420</f>
    </record>
    <record>
      <f>Шырын 1 л</f>
      <f>300</f>
      <f>315</f>
    </record>
  </data>
</table>

XML-файл мысалын жүктеу.

Кесте атауларында латын әріптерін, цифрларды және астын сызу белгісін қолданып, әріптен бастаңыз. ct_ префиксі міндетті емес, бірақ еркін кестелерді стандартты кестелерден ажыратуға көмектеседі. Мысалы, сату есебі үшін sales_report қолдануға болады: файл sales_report.xml, ал name атрибутының мәні sales_report болады.

Өріс атауларын интегратор анықтайды. Әр жазбадағы <f> саны мен реті <schema> бөліміне сәйкес келуі керек. Файлдың кодтауы XML декларациясындағы encoding мәніне сәйкес болуы тиіс.

Мәзір тармақтары — custom_tables.xml

<?xml version="1.0" encoding="utf-8"?>
<custom-tables>
  <table>
    <name>ct_sales_plan</name>
    <label>Сату жоспары</label>
  </table>
</custom-tables>

custom_tables.xml жүктеу.

  • <name> — кеңейтімі бар файл атауы емес, .xml кеңейтімінсіз кесте атауы.
  • <label> — негізгі мәзір тармағының мәтіні.

Бірнеше кесте үшін сол файлға бөлек <table> элементтерін қосыңыз. Әрқайсысында бір бос емес <name> және бір бос емес <label> болуы керек. Кесте атауларын қайталамаңыз. Тізімдегі әр кестенің outbox ішінде өз деректер файлы болуы тиіс.

custom_tables.xml мәзір тармақтарының толық тізімін белгілейді. Жаңартқанда мәзірде қалуы тиіс барлық еркін кестелерді сақтаңыз.

Алмасу профилі

Осы профильді exchange.xml файлыңыздың <palm-client> бөлігіне қосыңыз. Онда мысалдағы бір еркін кесте бар; ct_sales_plan атауын өз атауыңызға ауыстырыңыз:

<exchange name="custom_tables" view="Қосымша кестелерді жүктеу">
  <get>
    <dbs>
      <db name="ct_sales_plan"/>
    </dbs>
    <files>
      <file name="custom_tables" files="custom_tables.xml"/>
    </files>
  </get>
</exchange>

Кестені <db>, ал custom_tables.xml файлын <file> ретінде жүктеу керек. Конфигурация файлы үшін әдепкі сақтау орнын қалдырыңыз: storage="external" немесе destinationFolder қоспаңыз.

Бұл элементтерді бар профильге де қосуға болады. Кестелер бірнешеу болса, әрқайсысын <dbs> ішінде көрсетіңіз.

Жүктеу және көрінісін баптау

  1. Деректер файлы мен custom_tables.xml файлын құрылғының outbox қалтасына салыңыз.
  2. exchange.xml файлын жаңартып, құрылғыда Алмасу файлын жүктеу әрекетін орындаңыз.
  3. Қосымша кестелерді жүктеу профилін іске қосып, құрылғыдағы алмасу журналын тексеріңіз.
  4. Негізгі мәзірге оралып, <label> ішінде берген атауыңыз бар тармақты ашыңыз.
  5. Кесте мәзірінде баған баптауларын ашыңыз. Түсінікті атауларды, ретті, көрінуін және пішімдерін орнатыңыз. Мысалда plan және actual үшін бөлшек санды, product_name үшін мәтінді таңдаңыз.

Қазіргі tables_columns.xml импорты стандартты кестелерді баптайды. Еркін кестелердің бағандары құрылғыда бапталады. Жаңа өрістер алдымен техникалық атауларымен көрсетіледі.

Кестеде қарау, сұрыптау, сүзгілеу және бағандарды баптау қолжетімді. Деректер жаңартулары бухгалтерлік есеп жүйесінен сол алмасу профилі арқылы келеді.

Иерархиялық кесте

Топтар мен ішкі жазбаларды көрсету үшін схемаға code, parent және group өрістерін қосыңыз. Мәндер иерархиялық анықтамалықтар ережелеріне сәйкес болуы керек: жоғарғы деңгей үшін бос parent, ішкі жазба үшін ата-аналық топтың коды, элемент үшін group=0 және топ үшін group=1.

Үш өріс те бар болса, қосымша кестені иерархиялық деп таниды. Қажет болмаса, оларды жазық есепке қоспаңыз.

Кесте пайда болмаса

Алдымен жүктеу уақытындағы құрылғының алмасу журналын және сервер журналын тексеріңіз.

БелгіНені тексеру керек
Мәзір тармағы жоқcustom_tables.xml жүктелгенін, <name> және <label> дұрыстығын, Medium немесе Full клиенттік лицензиясын. Алмасудан кейін негізгі мәзірге оралыңыз.
Тармақ бар, бірақ дерек жоқКестеңіздің профильдің <get><dbs> бөлігінде, файлының outbox ішінде бар екенін және барлық файлдардағы кесте атауының сәйкестігін.
Конфигурация файлының қатесі<custom-tables> түбірін, бос емес <name> және <label>, қайталанулардың жоқтығын және тізімдегі барлық кестелердің outbox ішінде бар екенін.
Сандар не күндер дұрыс көрсетілмейдіҚұрылғыдағы кесте баптауларында тиісті бағандардың пішімін.
Жазбалар иерархияда көрінбейдіАта-аналық топ кодтарын, жоғарғы деңгейдегі бос parent және group мәндерін.