Просмотр исходного текста страницы Справочник "Служебные обработки"

<noinclude>[[Категория: Справочники администрирования (КУС)]]</noinclude>
Справочник «Служебные обработки» предназначен для хранения списка программных обработок (скриптов). Используется для выполнения программных действий над объектами информационной базы.

Справочник находится в разделе АДМИНИСТРИРОВАНИЕ — '''Сервис''' или его можно найти [[Интерфейс программы (КУС)#Поиск по интерфейсу|поиском по интерфейсу]].

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

См. также [[Обезличивание персональных данных (КУС)]] — на этой странице описан пример использования служебной обработки «Универсальная обработка данных» для обезличивания базы физлиц.

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

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

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

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

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

: [[Файл:Создание внешней обработки.png]]

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

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

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

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

: [[Файл:Конструктор формы обработки.png]]

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

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

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

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

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

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

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

Пример:

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

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

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

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

'''ПередаватьМассивОбъектов''' (тип: булево, значение по-умолчанию: «Ложь») — если значение параметра «Истина», то параметр процедуры-обработчика команды «СсылкаНаОбъект» будет содержать массив объектов (документов или справочников), вызвавших обработку, в противном случае объекты будут передаваться в параметр по одному.
  
Пример обработки можно скачать по адресу: [https://docs.google.com/file/d/0Bz3ipFFaHn5MUUZGb1hkaHE1Vzg/edit https://docs.google.com/file/d/0Bz3ipFFaHn5MUUZGb1hkaHE1Vzg/edit]