Қашықтан баптау — Құжаттама PalmOrder

Осы бетте

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

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

Түбірлік элемент — <preferences>. Оның ішінде баптау бөлімдері, ал әр бөлімде параметрлер мен олардың мәндері орналасады.

<?xml version="1.0" encoding="utf-8"?>
<preferences>
  <global>
    <theme>light</theme>
  </global>
  <references>
    <back-hierarchy-up>true</back-hierarchy-up>
  </references>
  <document-order>
    <set-custom-price>false</set-custom-price>
    <forbid-edit-sent-document>true</forbid-edit-sent-document>
  </document-order>
</preferences>

Тек өзгерту қажет параметрлерді қосыңыз. Қалған баптаулардың ағымдағы мәндері сақталады. Логикалық параметрлер үшін true немесе false қолданыңыз. Файлдың нақты кодтауы XML декларациясындағы encoding мәніне сәйкес келуі керек.

Баптауларды жіберу

preferences.xml файлын қажетті құрылғыға бапталған outbox қалтасына тікелей салыңыз.
exchange.xml ішінде осы файлды жүктейтін профиль бар екенін тексеріңіз. Стандартты алмасу файлында ол Завантажити налаштування (Баптауларды жүктеу) деп аталады.
exchange.xml файлын өзгертсеңіз, алдымен құрылғыда Алмасу файлын жүктеу әрекетін орындаңыз.
Завантажити налаштування (Баптауларды жүктеу) профилін немесе оның view атрибутында көрсетілген атаудағы профильді іске қосып, құрылғыдағы алмасу журналын тексеріңіз.
Қосымша баптауларының тиісті бөлімін ашып, алынған мәндерді тексеріңіз. Тақырыптың өзгергенін көру үшін қосымшаны қайта іске қосыңыз.

exchange.xml файлындағы <palm-client> ішіне қосылатын профиль мысалы:

<exchange name="preferences" view="Баптауларды жүктеу">
  <get>
    <files>
      <file name="preferences" files="preferences.xml"/>
    </files>
  </get>
</exchange>

Стандартты exchange.xml файлында осы файл үшін deleteOnServer="true" көрсетілген: сәтті орнатылғаннан кейін қосымша серверден файлды жоюды сұрайды. Бірнеше құрылғы баптауларды ортақ outbox қалтасынан алуы керек болса, осы атрибутты алып тастаңыз немесе deleteOnServer="false" деп орнатыңыз. Барлық қажетті құрылғылар файлды алғаннан кейін интегратор оны outbox ішінен алып тастай алады.

Жалпы параметрлер — global

Параметр	Мәндер	Мақсаты
`theme`	`dark`, `light`	Қосымшаның қараңғы немесе ашық тақырыбы.
`table-font-size`	`small`, `normal`, `large`, `extra-large`	Кестелердегі қаріп өлшемі.
`debug-mode`	`true`, `false`	Диагностикаға арналған жөндеу режимі.

Анықтамалықтар — references

Параметр	Мәндер	Мақсаты
`back-hierarchy-up`	`true`, `false`	«Артқа» түймесі анықтамалықты жабудың алдында жоғарғы деңгейдегі топқа өтеді.
`show-parents-in-details`	`true`, `false`	Тауар карточкасында жоғарғы деңгейдегі топтарды көрсетеді.
`recursive-filter`	`true`, `false`	Сүзгілеу кезінде сәйкес элементтері жоқ топтарды жасырады.
`view-type`	`0`, `1`, `2`	Тауарлар анықтамалығының көрінісі: `0` — кесте, `1` — тақташалар, `2` — галерея.

Тапсырыстар — document-order

Осы бөлімдегі барлық параметрлер true немесе false мәнін қабылдайды.

Параметр	`true` мәні нені қосады
`calculate-rest`	Тапсырыстағы тауар санын ескере отырып, қалдықты қайта есептеуді.
`set-custom-price`	Тауарды таңдау кезінде бағасын өзгерту мүмкіндігін.
`products-in-package`	Тауар санын қаптамамен енгізуді.
`customer-own-prices-only`	Тек клиентке белгіленген баға санатын таңдауды.
`forbid-new-document-with-expired-debt`	Мерзімі өткен қарызы бар клиентке жаңа тапсырыс жасауға тыйым салуды.
`check-photo`	Клиент үшін `photo_required` белгісі орнатылған болса, тапсырысқа тауар таңдаудың алдында фото түсіру талабын.
`forbid-edit-sent-document`	Жіберілген тапсырыстарды өңдеуге тыйым салуды.

Төлемдер — document-payment

Осы бөлімдегі барлық параметрлер true немесе false мәнін қабылдайды.

Параметр	`true` мәні нені қосады
`forbid-edit-saved`	Сақталған төлемдерді өңдеуге тыйым салуды.
`forbid-delete-not-sent`	Әлі жіберілмеген төлемдерді жоюға тыйым салуды.
`forbid-edit-sent-document`	Жіберілген төлемдерді өңдеуге тыйым салуды.

Тауар таңдау кезіндегі қосымша өрістер — product-count-dialog-info-fields

Осы бөлімдегі параметр атауы тауарлар анықтамалығындағы өріс атауына сәйкес келеді. true мәні өрісті сан енгізу терезесінің қосымша деректерінде көрсетеді, ал false — жасырады.

<product-count-dialog-info-fields>
  <code>true</code>
  <packaging>true</packaging>
</product-count-dialog-info-fields>

Тек жүктелген тауарлар анықтамалығында бар өрістерді пайдаланыңыз. Осы үзіндіні <preferences> ішіне орналастырыңыз.

Тауар суреттері — product-reference-images

Параметр	Мәндер	Мақсаты
`path`	Жол	Android құрылғысындағы суреттер қалтасы.
`extensions`	`;` арқылы бөлінген кеңейтімдер, мысалы `jpg;jpeg;png`	Қосымша тауар суреттерін іздейтін файл түрлері.

path құрылғыдағы жолды көрсетеді. Ол алмасу кезінде суреттер сақталатын орынға сәйкес келуі керек.

Серверге қосылу — palmorder-server

Осы бөлім бапталған қосымшаның мекенжайын және қосылым параметрлерін өзгертеді. Алғашқы қосылу Құрылғыны байланыстыру бетінде сипатталған.

Параметр	Мәндер	Мақсаты
`server-version-7-plus`	`true`	PalmOrder Server 7.x режимі.
`https`	`true`, `false`	`true` — HTTPS арқылы, `false` — HTTP арқылы қосылу. Жергілікті және интернет арқылы алмасу мекенжайларына қолданылады. Параметр көрсетілмесе, ағымдағы мән сақталады.
`local-address`	IP мекенжайы немесе домен атауы	Жергілікті алмасу серверінің мекенжайы, `http://`, `https://` және портсыз.
`remote-address`	IP мекенжайы немесе домен атауы	Интернет арқылы алмасу серверінің мекенжайы, хаттамасыз және портсыз.
`port`	`1` мен `65535` аралығындағы бүтін сан	Қосылу порты.
`timeout-seconds`	`0`-ден үлкен бүтін сан	Сервер жауабын күту уақыты, секундпен.

<palmorder-server>
  <server-version-7-plus>true</server-version-7-plus>
  <https>false</https>
  <local-address>192.168.1.20</local-address>
  <port>8888</port>
  <timeout-seconds>60</timeout-seconds>
</palmorder-server>

Осы үзіндіні <preferences> ішіне орналастырып, мекенжай мен портты өз мәндеріңізге ауыстырыңыз. HTTPS сервері үшін <https>true</https> және тиісті портты орнатыңыз. Жұптастыру құпиясы preferences.xml арқылы берілмейді. Құрылғы басқа серверге ауысса, оны сол сервермен жұптастырыңыз.

GPS бақылау — gps-tracking

Параметр	Мәндер	Мақсаты
`enabled`	`true`, `false`	GPS бақылауды қосу.
`required`	`true`, `false`	Қосымшаны пайдалану үшін орналасқан жерді анықтау қызметінің қосулы болуын талап ету.
`interval`	`0`-ден үлкен бүтін сан	Координаттарды сақтау аралығы, секундпен.
`on`	`HH:mm` пішіміндегі уақыт, мысалы `08:00`	Бақылау уақытының басталуы.
`off`	`HH:mm` пішіміндегі уақыт, мысалы `18:00`	Бақылау уақытының аяқталуы.
`login`	Мәтін	GPS бақылау тіркелгісінің логині.
`password`	Мәтін	GPS бақылау тіркелгісінің құпиясөзі.
`send-interval`	`0`-ден үлкен бүтін сан	Координаттарды жіберу аралығы, секундпен.
`service-check-interval`	`0`-ден үлкен бүтін сан	GPS қызметін тексеру аралығы, минутпен.

on және off бірдей болса, бақылау тәулік уақыты бойынша шектеусіз жұмыс істейді. Орналасқан жерді анықтау рұқсаттары Android жүйесінде бөлек беріледі.

Баптаулар қолданылмаса

Алдымен құрылғыдағы алмасу журналын тексеріңіз: preferences.xml файлын қосымша оқиды және орнату нәтижесін хабарлайды.

Хабарлама немесе белгі	Нені тексеру керек
Файл жүктелмеді	`preferences.xml` атауын, қажетті `syncName` үшін `outbox` қалтасын және файлдың алмасу профиліне қосылғанын.
Белгісіз бөлім немесе параметр	Атаудың дәл жазылуын және жоғарыдағы кестелерде бар екенін. Белгісіз параметрлер ескертумен өткізіледі.
Орнату қатесі	XML дұрыстығын, кодтауды және параметрлердің рұқсат етілген мәндерін. Қатеден кейін қайта жүктемес бұрын нақты баптауларды тексеріңіз.
Файлды тек бір құрылғы алды	Ортақ `outbox` ішінен файлдың `deleteOnServer="true"` арқылы жойылғанын.