Руководство: 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 срабатывает при изменении значения в колонке. Однако, если установить новое значение (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://action/visit/preclose.
Для отключения серийных проверок необходимо установить из скрипта значение checksDisabled посредством api.result.setData Для показа/скрытия информационного сообщения об ошибках при завершении визита используется api.result. Пример:

    if (shouldClose) {
        // закрыть визит без проверок
        api.result.setData('checksDisabled', true);
    } else {
        // показать ошибку при завершении визита
        api.result.isShow = true;
        api.result.text = 'Отсутствует фотография фасада торговой точки';
        api.result.type = 'error';
    }

Серийные проверки, которые отключаются скриптом:

• проверка на наличие незавершенных документов или черновиков
• проверка на незавершенные задачи
• проверка на завершение всех обязательных шагов сценария

Проверка на наличие и получение координат визита не отключается

Примеры использования данной точки расширения:

• Разместить пользовательские проверки на завершение визита и отключить серийные проверки
• Вызвать диалог с исходами визита и, в зависимости от выбранного исхода, заменить серийные проверки на пользовательские. Для реализации данного варианта необходимо дополнительно использовать точку расширения stmobile://action/visit/presave и api.cache для передачи идентификатора выбранного исхода в скрипт точки расширения visit/presave.

1. Откройте файл manifest.json карточки ТТ в вашей папке МТ:
\extensions\reports\outletreport\manifest.json

2. Найдите в файле manifest.json пункт "config", подпункт "modules".
Для каждого подключенного модуля есть свой набор свойств в подпункте "modules".

Cписок доступных модулей (актуально для версии 4.4.8):

        1. last_visits     - Последние визиты
        2. limits          - Лимиты
        3. matched_outlets - Сопоставленные точки
        4. outlet_photos   - Фотографии точки
        5. properties      - Общая информация
        6. visits_calendar - Календарь визитов
    

Содержимое файла manifest.json

    {
        ...
        "config": {
            "settingsKey": "myreport_open_modules",
            "modules": [
            {
                "name": "my_module",            // имя подключенного модуля (обязат.)
                "position": 1,                  // порядок сортировки (обязат.)
                "uiName": "qsTr(My module)",    // заголовок, который будет отображен в интерфейсе (обязат.)
                "visibilityCheck": true,        // проверка отображения модуля
                "reloadCheck": "self",          // проверка необходимости перезагрузки модуля
                "isDisabled": false             // отключение загрузки модуля
            }
            ]
        }
        ...
    }
    

Изменение порядка модулей

• Модули выстраиваются в колонку (сверху вниз). На порядок сортировки указывает свойство "position".
• Чем меньше значение "position", тем ближе к началу.
• Чтобы изменить положение модуля, замените для него свойство "position", например, "position": 4,.

Загрузка модуля

• Для того, чтобы модуль не загружался установите для него свойство "isDisabled" в значение true.

ВАЖНО!

формат json очень требователен к синтаксису:

• строки в двойных кавычках
• числа и булевы значения без кавычек
• сохраняйте знаки препинания
• комментарии запрещены

Необходимо создать расширение на точку 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);

}

Чтобы настройки для атрибута применялись из скрипта, а не из конфига, для атрибута необходимо установить флаг force:

    // Скрываем колонку
    const rest = api.form.rowAttribute('NameRestStore');
    rest.force = true;
    rest.view = false;

Скорее всего в регулярном выражении используется флаг 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;
}
...

Встроенный в МТ шаблонизатор 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 %}

Получится:
* * * *

В документации в заголовках api могут присутствовать некорректные символы, а именно, одна из точек является другим символом юникода. Копирование методов из документации в код может привести к синтаксическим ошибкам при исполнении.

    // Примерный текст ошибки
    Can not call method of undefined

При этом линтер не подчеркнёт некорректные символы, а внешне они будут выглядеть одинаково.

Сократите количество выражений 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";

}