Справочник "Служебные обработки"

Материал из КинтВики
Перейти к: навигация, поиск

Справочник «Служебные обработки» предназначен для хранения списка программных обработок (скриптов). Используется для выполнения программных действий над объектами информационной базы.

Справочник находится в разделе АДМИНИСТРИРОВАНИЕ — Сервис или его можно найти поиском по интерфейсу.

(см. также Универсальная форма списка)

Добавление новых скриптов

Список обработок можно редактировать, вводить новые записи или редактировать имеющиеся. Для нового скрипта необходимо заполнить наименование и написать программный код (тело). Код должен вводиться на внутреннем языке программирования «1С Предприятие».

Скрипты могут быть закреплены за справочниками и документами, тело скрипта может содержать ссылку на справочник или документ вызвавший скрипт, имя переменной: СсылкаНаОбъект.

Работа со скриптами категории «Внешняя обработка»

Шаг 1. Создание внешней обработки.

В конфигурации откройте меню ФайлНовый и в появившемся списке выберите вид документа «Внешняя обработка».

Создание внешней обработки.png

Шаг 2. Создание основной формы обработки.

Укажите имя и синоним обработки. Выделите курсором свойство обработки «Формы» и нажмите кнопку Добавить (Ins).

В появившемся окне укажите тип формы: «Форма обработки», поставьте флаг «Назначить форму основной», укажите имя и синоним формы.

Нажмите кнопку Готово.

Конструктор формы обработки.png

Шаг 3. Создание команд форм.

В окне формы перейдите на закладку Команды. На закладке Команды формы создайте новую команду, используя кнопку контекстного меню Добавить или аналогичную команду контекстного меню.

В меню Свойства в поле «Имя», укажите представление команды в слитном написании, отдельные слова должны начинаться с большой буквы. Имя команды должно начинаться с префикса «яъ».

Шаг 4. Создание обработчиков команд.

Нажмите клавишу открытия поля «Действие», в появившемся списке укажите среду исполнения кода обработчика «Создать на клиенте».

Система автоматически сформирует процедуру обработчика с пустым содержимым, после закрывающей скобки параметров процедуры добавьте постфикс «Экспорт».

В теле процедуры может быть написан программный код на внутреннем языке программирования «1С Предприятие», который будет исполняться при вызове данной команды обработки в режиме «1С Предприятие».

Пример:

&НаКлиенте
Процедура ВывестиСообщение(Команда) Экспорт
       яъСообщить("Вызвана из %%", Команда.СсылкаНаОбъект);
       яъСообщить("Заголовок формы %%", Команда.Форма.Заголовок);
КонецПроцедуры

Параметр «Команда» представляет собой структуру вида («СсылкаНаОбъект,Форма»), где:

  • СсылкаНаОбъект — ссылка на документ или справочник, вызвавший обработку.
  • Форма — форма, из которой вызвана обработка.

Есть возможность передавать параметры запуска команды с помощью экспортной функции модуля формы обработки «ПараметрыКоманды(ИмяКоманды)», где параметр это имя команды, указанное в шаге 3. Функция должна возвращать структуру вида: (ИмяПараметра, ЗначениеПараметра).

Допустимые имена параметров:

ПередаватьМассивОбъектов (тип: булево, значение по-умолчанию: «Ложь») — если значение параметра «Истина», то параметр процедуры-обработчика команды «СсылкаНаОбъект» будет содержать массив объектов (документов или справочников), вызвавших обработку, в противном случае объекты будут передаваться в параметр по одному.

Пример обработки можно скачать по адресу: https://docs.google.com/file/d/0Bz3ipFFaHn5MUUZGb1hkaHE1Vzg/edit