Главная

Руководство: Data-скрипт

Data-скрипт

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

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

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

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

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

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

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

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

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