Главная

Руководство: FAQ

FAQ

Документы

Как в документе отключить сообщение о не проданных товарах стандартного ассортимента?
Необходимо добавить action-скрипт на точку расширения stmobile://module/skudocs/config в котором конфигурируется соответствующий параметр:
function doAction() {
    var conf = {
        "isNeedCheckUnsoldAssortment": false
    }

    api.result.setConfig(conf);
}
Как добавить в документ свою колонку с каким-то значением?
Добавление кастомной колонки в документ осуществлется двумя action-скриптами: один на preopen, другой на iteminit.
Скрипт на preopen будет вызван однажды при открытии документа и служит для добавления колонки, а скрипт на iteminit будет вызван для каждой строки документа и служит для заполнения значения.
Создайте два каталога: preopen и iteminit.
Метафайл action-скрипта на событие preopen будет выглядеть следующим образом:
{
    "uri": "stmobile://action/<ДОКУМЕНТ>/preopen",
    "type": "action",
    "datascript": {
        "script_file": "preopen.js"
    }
}
Где <ДОКУМЕНТ> - название документа, например preorder.

Теперь создайте соответствующий data-скрипт с именем preopen.js.
Создание колонки осуществляется следующим образом:
var newAttr = api.form.newRowsAttribute('columnNameHere'); // Добавление колонки
newAttr.title = "Название колонки";                        // Установка заголовка
Более подробно о доступных полях: Attribute

Добавьте схожим образом метафайл скрипта на событие iteminit:
{
    "uri": "stmobile://action/<ДОКУМЕНТ>/iteminit",
    "type": "action",
    "datascript": {
        "script_file": "iteminit.js"
    }
}
И создайте data-скрипт iteminit.js.
В data-скрипте необходимо получить доступ к конкретному строчному атрибуту:
var currAttr = api.form.rowAttribute('columnNameHere', api.context.rowItemId);
currAttr.value = 42; // установка значения
Для обмена данными между двумя скриптами используйте кэш.
Как добавить в меню (три точки) свои пункты?
Для работы необходимо создать метафайл обработчика действия (action) на URI stmobile://document/<ДОКУМЕНТ>/form/config.
Дата-скрипт должен содержать следующую функцию (имя функции предопределено):
function mtcall_menuAdditionalItems() {

    var items = [{
                    "name": "photoReport",
                    "title": "Фотоотчет",
                    "onclick": openPhotoReport
                }];

    api.result.setConfig(items);

}
Здесь items - массив объектов с полями:
name - имя пункта меню
title - выводимый текст
onclick - JavaScript-функция вызываемая при нажатии на пункт меню

api.result.setConfig принимает в качестве параметра этот массив и устанавливает конфигурацию формы.
Почему я не могу установить новое значение в документе из точки расширения itemchange?
Точка расширения itemchange срабатывает при изменении значения в колонке. Однако, если установить новое значение (value) у объекта, возвращаемого методом api.form.rowAttribute, то значение в дальнейшем перезапишется тем, что хранится в памяти калькулятора. Поэтому единственно верным вариантом является установка необходимого значения в точках расширения itempresave или itempostsave, а точка расширения itemchange может служить лишь для получения очередного вводимого значения.

Визиты

Как отменить автоматический вывод выбора результата посещения ТТ и вернуть своё значение?
Для отмены автоматического запроса результата визита необходимо вернуть из скрипта visit/presave resultId посредством api.result.setData. Получение модели результатов посещения осуществляется методом api.visits.reasonModel
Примерный скрипт на presave визита:
var reasons = api.visit.reasonModel();
var ret = api.interactive.selectSingleValue("Результат посещения", reasons, reasons[0].value);
if (!ret.success) {
   // нажали "Отмена"
   ...
}
else {
    var reasonId = ret.value;
    api.result.setData("reasonId", reasonId);
}

Формы

Как настроить атрибуты в форме редактирования торговой точки?
Необходимо создать расширение на точку stmobile://outlet/attributes
function doAction() {

    var attributes = api.context.config,
        attributesLength = attributes.length;

    for (var i = 0; i < attributesLength; i++) {
        // Структура атрибута:
        // {
        //     isReadonly:    bool,   (только для чтения)
        //     isRequired:    bool,   (обязательный для заполнения)
        //     defValue:      string, (значение по-умолчанию, используется только при создании новой ТТ)
        //     isShared:      bool,   (разделяемый или нет)
        //     distributorId: id,     (задано, если атрибут разделяемый)
        //     isUsed:        bool,   (признак использования атрибута)
        //     isVisible:     bool,   (признак отображения на форме. Атрибут может существовать в невидимом виде.
        //                             Если при этом атрибуту назначено значение по-умолчанию, то оно сохранится при записи)
        //     param:         string  (параметр атрибута, обычно указывает на классификатор, например, "ClassifierTT1")
        //     title:         string  (заголовок атрибута)
        //     type:          string  (внутреннее название атрибута, см. структуру AttributeType)
        //     valueHint:     string  (подсказка-placeholder для текстовых полей)
        // }
        attributes[i].isRequired = true;
    }

    // Установка новых значений параметров
    api.result.setConfig(attributes);

}

JavaScript

Почему в новых версиях МТ у меня не работает регулярное выражение? (а раньше работало)
Скорее всего в регулярном выражении используется флаг g. JS-движок старых версий МТ не совсем точно следовал букве стандарта, в связи с чем значение свойства lastIndex сбрасывалось при повторном выполнении сравнения. Однако, это не верно, необходимо сбрасывать указатель. Пример:
// Было
...
for (var i = 0; i <= length; i++) {
    var reg = /(привет)?/g;
    var match = reg.exec(data[i]);
    if (match[1]) result.push(match[1]);
}
...
// Надо
...
var reg = /(привет)?/g;
for (var i = 0; i <= length; i++) {
    var match = reg.exec(data[i]);
    if (match[1]) result.push(match[1]);
    reg.lastIndex = 0;
}
...

HTML

Как вывести шаблонизатором несколько раз одно и то же
Встроенный в МТ шаблонизатор Grantlee имеет недокументированный тэг range, работающий аналогично одноименной функции языка Python. Примеры:
<ul>
{% range 5 as num %}
<li>{{ num }}</li>
{% endrange %}
</ul>
Получится:
  • 0
  • 1
  • 2
  • 3
  • 4
<ul>
{% range 5 10 as num %}
<li>{{ num }}</li>
{% endrange %}
</ul>
Получится:
  • 5
  • 6
  • 7
  • 8
  • 9
<ul>
{% range 5 30 5 as num %}
<li>{{ num }}</li>
{% endrange %}
</ul>
Получится:
  • 5
  • 10
  • 15
  • 20
  • 25
Датаскрипт:
...
mapper.rating = 4;
...
{% range rating %}
  *
{% endrange %}
Получится:
* * * *

SQL

Почему на устройстве я получаю ошибку "too many terms in compound SELECT"?
Сократите количество выражений SELECT, превышен их лимит (500), скорее всего неудачно сформирован запрос.

Общее

Как поменять глобальное меню и/или добавить свои пункты?
Создайте action-скрипт на URI stmobile://globalmenu/items
В функции doAction необходимо получить посредством api.context.config массив объектов в формате JSON, который содержит структуры, описывающие каждый элемент меню. Далее можно заменить или добавить пользовательские элементы, после чего отдать полученный массив обратно при помощи api.result.setConfig.
Внимание: в примере проверка по совпадению имени модуля является регистронезависимой.
Пример реализации расширения для кастомизации глобального меню:
function doAction() {

    var defaultItems = api.context.config;
    var userDefinedItems = [
            {
                "name":  "Summary",
                "icon":  "globalmenu/dashboard",
                "title": "Summary",
                "uri":   "stmobile://dashboard"
            },
            {
                "name":     "route",
                "icon":     "globalmenu/route",
                "title":    "Supervisor Routes",
                "uri":      "stmobile://route",
                "subtitle": "Ленинградский р-н"
            }
        ];

    for (var i = 0; i < userDefinedItems.length; i++) {
        var isFound = false;
        for(var j = 0; j < defaultItems.length; j++) {
            var userObject = userDefinedItems[i];
            var defaultObject = defaultItems[j];
            if (defaultObject.hasOwnProperty["name"] &&
                defaultObject["name"].toLowerCase() === userObject["name"].toLowerCase())
            {
                defaultObject["title"]    = userObject["title"];
                defaultObject["icon"]     = userObject["icon"];
                defaultObject["uri"]      = userObject["uri"];
                defaultObject["subtitle"] = userObject["subtitle"];
                isFound = true;
            }
        }
        if (!isFound) defaultItems.push(userObject);
    }

    api.result.setConfig(defaultItems);
    api.result.type = "ok";

}