Мобильная Торговля
Версия
Data-скрипт

Data-скрипт - это текстовый файл, в кодировке UTF-8, с javascript кодом.
Скрипт предназначен для получения данных, подготовки их к отображению, выполнения действий, взаимодействия с программой и пользователем, вызова методов API

В зависимости от типа расширения, у скриптов разные точки входа.

Для визуальных расширений (отчет, печатная форма, форма просмотра):

function init() {
   // здесь находится код инициализации
}

function data() {
   // в данном методе пишется основной код подготовки данных
}
  • init - функция для различного рода инициализаций, выполняется один раз при создании расширения
  • data - основная функция для получения и подготовки данных, может выполняться несколько раз, например, при необходимости обновить данные (api.builder.reload)

Для обработчиков действий:

function doAction() {
   // здесь находится код действия
}
  • doAction - функция для выполнения действий.

Для кастомных компонентов ввода:

function value() {
   // в данном методе возвращается значение, которое будет установлено атрибуту
}
  • value - функция для возврата значения, которое должно быть установлено атрибуту. Используется в кастомных компонентах ввода для атрибутов документов. Возвращаемое значение должно передаваться через return. В случае, если функция value вернет ошибку, значение у атрибута изменено не будет.

Для создания первого простого расширения смотрите Быстрый старт

Для настройки форм Некоторые расширения предназначены для конфигурирования(настройки) форм. Функция для выполнения действий в таких расширениях начинается с mtcall_. Так же такое название функции можно встретить в некоторых расширениях специального назначения (например акции). Эта особенность вызвана тем что такие функции могут быть вызваны не только из расширений JS но и в основном коде приложения. Смотри пример в разделе FAQ (Как добавить в меню три точки свои пункты).