Документы
Как в документе отключить сообщение о не проданных товарах стандартного ассортимента?
Необходимо добавить action-скрипт на точку расширения stmobile://module/skudocs/config в котором конфигурируется соответствующий параметр:
function doAction() { var conf = { "isNeedCheckUnsoldAssortment": false } api.result.setConfig(conf); }
Как добавить в документ свою колонку с каким-то значением?
Добавление кастомной колонки в документ осуществлется двумя action-скриптами: один на preopen, другой на iteminit.
Скрипт на preopen будет вызван однажды при открытии документа и служит для добавления колонки, а скрипт на iteminit будет вызван для каждой строки документа и служит для заполнения значения.
Создайте два каталога: preopen и iteminit.
Метафайл action-скрипта на событие preopen будет выглядеть следующим образом:
Теперь создайте соответствующий data-скрипт с именем preopen.js.
Создание колонки осуществляется следующим образом:
Добавьте схожим образом метафайл скрипта на событие iteminit:
В data-скрипте необходимо получить доступ к конкретному строчному атрибуту:
Скрипт на 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.
Дата-скрипт должен содержать следующую функцию (имя функции предопределено):
name - имя пункта меню
title - выводимый текст
onclick - JavaScript-функция вызываемая при нажатии на пункт меню
api.result.setConfig принимает в качестве параметра этот массив и устанавливает конфигурацию формы.
Дата-скрипт должен содержать следующую функцию (имя функции предопределено):
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 визита:
Примерный скрипт на 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.
Внимание: в примере проверка по совпадению имени модуля является регистронезависимой.
Пример реализации расширения для кастомизации глобального меню:
В функции 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"; }