Главная

Руководство: Расширение как шаг сценария

Расширение как шаг сценария

Общая информация

В МТ можно задать расширение(отчет) как шаг сценария. Для таких шагов сценария работа может отличаться от стандартных (серийных) шагов сценария. То что описано ниже - характерно именно для шагов сценария типа расширение. Обработчик действия (action) не может быть назначен как шаг сценария.

По умолчанию шаг сценария считается выполненым если пользователь открыл этот шаг. Так же выполнение\невыполнение шага сценария может регулироваться из скрипта - через возвращение результата true\false.

Рассмотрим пример.

Пример установки скрипта как шага сценария

Допустим у нас есть отчет Custom Sales, который должен быть выведен как шаг сценария.

В отчете Торговый Агент заполняет информацию по товарам. Если он заполнил всю информацию шаг считается выполненным. Если информация заполнена частично или не заполнена - шаг считается невыполненным.

Отчет состоит из manifest.json и файла скрипта custom_sales.js. В первую очередь в Чикаго наш отчет должен быть указан в соответствующих настройках (указывается имя скрипта без .js). Ответственному за часть Чикаго передаем имя скрипта - custom_sales.

Далее, в manifest.json необходимо установить параметр visible в значение false чтобы отчет отображался как шаг сценария и не был виден в списке отчетов своей группы.

{
    "uri": "stmobile://report/outletreports/custom_sales",
    "type": "report",
    "title": "Custom Sales",    
    "visible" : false,
    "datascript": {
        "script_file": "custom_sales.js"
    },
    "template": {
        "template_file": "custom_sales.html"
    }
}

Чтобы определить шаг сценарий как выполненный, в скрипте - custom_sales.js необходимо вернуть из функции data значение true (return true).

Соответственно невыполеннный - return false.

Дополнительная информация

  • Если шаг сценария был выполнен, при повторном открытии - если скрипт вернул false, статус шага сценария будет изменен обратно на невыполненный.