Как написать внешнюю обработку 1с

Обработка 1С – это прикладной объект конфигурации, который служит для выполнения различных действий над информацией в базе 1С, таких как преобразование данных, добавление, удаление и т.д. Обработки в 1с можно разделить на два вида:

• Внутренние обработки (встроенные в конфигурацию). Полный список таких обработок мы можем увидеть в режиме конфигуратора, открыв окно конфигурации:
  
• Внешние обработки (можно хранить в виде отдельных файлов с расширением .epf). Список подключённых внешних обработок в управляемом интерфейсе мы можем найти в подсистеме «НСИ и Администрирование» — «Печатные формы, отчёты и обработки» — «Дополнительные отчёты и обработки».

Если появляется необходимость расширить функционал конфигурации с помощью обработки, то следует использовать именно внешние обработки. Это позволит оставить структуру конфигурации неизменной, и облегчит возможность её дальнейшей поддержки.

Пример создания простейшей внешней обработки в 1С 8.3

Постановка задачи:

На форме обработки необходимо дать возможность пользователю ввести текст, а по нажатию на кнопку вывести этот текст в окно сообщений.

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

В открывшемся окне задаём имя для нашей обработки «МояПерваяОбработка».  Определим реквизит «ТекстДляВывода» (тип <Строка>, длина  <100>).

Далее добавляем форму обработки, не забудем включить наш реквизит «ТекстДляВвода» в состав формы.

Добавляем команду формы, назначив ей имя «Вывести текст», а так же в окне свойств по нажатию на лупу определим обработчик этой команды на «клиенте».

Код обработки в модуле формы может выглядеть так:

&НаКлиенте
Процедура ВывестиТекст(Команда)
	Сообщить(Объект.ТекстДляВывода);
КонецПроцедуры

Чтобы мы могли видеть нашу созданную кнопку на форме её необходимо добавить в раздел элементов формы. Это можно сделать простым перетаскиванием.

Наша обработка готова, её можно сохранить в виде файла на диск.

Запустив 1С в режиме предприятия и выбрав наш файл обработки через меню «Файл» — «Открыть» можем проверить её работоспособность.

Результат:

СведенияОВнешнейОбработке — функция для подключения внешней обработки

Технология подключения внешних обработок и отчётов в управляемом интерфейсе несколько отличается от подключения в обычном режиме. Попытавшись подключить нашу обработку через подсистему «НСИ и Администрирование» — «Печатные формы, отчёты и обработки» — «Дополнительные отчёты и обработки» мы неизменно получим следующую ошибку.

Связана она с тем, что в конфигурациях использующих БСП(библиотеку стандартных подсистем), необходимо предоставлять некие сведения описывающие внешнюю обработку. Такие сведения необходимо возвращать из экспортной функции «СведенияОВнешнейОбработке»  в виде структуры. А саму функцию разместить в модуле объекта обработки.

Пример такой функции для нашей обработки может выглядеть так:

Функция СведенияОВнешнейОбработке() Экспорт
ПарамРег = Новый Структура();
ПарамРег.Вставить("Наименование", "МояПерваяОбработка");
ПарамРег.Вставить("БезопасныйРежим", Истина);
ПарамРег.Вставить("Версия ", "ver.: 1.0");
ПарамРег.Вставить("Информация", "Обработка для вывода введённого текста в окно сообщений");
ПарамРег.Вставить("Вид", "ДополнительнаяОбработка");

ТЗ_Команды = Новый ТаблицаЗначений;
ТЗ_Команды.Колонки.Добавить("Идентификатор");
ТЗ_Команды.Колонки.Добавить("Использование");
ТЗ_Команды.Колонки.Добавить("Представление");

НоваяСтрока = ТЗ_Команды.Добавить();
НоваяСтрока.Идентификатор = "ОткрытьОбработку";
НоваяСтрока.Использование = "ОткрытиеФормы";
НоваяСтрока.Представление = "Открыть обработку";
ПарамРег.Вставить("Команды", ТЗ_Команды);

Возврат ПарамРег;

КонецФункции

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

Подключение внешней обработки в режиме 1С:Предприятие

Теперь можем добавить нашу обработку, указав в каких подсистемах программы, она будет располагаться.

Внешние обработки – очень удобный инструмент для компаний, использующих типовые конфигурации на 1С:Предприятие 8.3. Они позволяют не тратить силы и средства на обновления 1С, давая возможность обновлять базы одной кнопкой в режиме простого пользователя. Используя механизм библиотеки стандартных подсистем, можно добавить различные кнопки в документы и справочники, не изменяя типовую конфигурацию. Рассмотрим пример создания и подключения внешней обработки в одной из конфигураций 1С.

Создаем внешнюю обработку в 1С 8.3

Чтобы создать новую внешнюю обработку, используем конфигуратор. Через меню «Файл» выбираем команду создания «Новый…» и определяемся, что мы будем создавать внешнюю обработку. В открывшемся окне задаем имя, и при нажатии «Enter» оно заполняется автоматически. Также это имя вам предложит система в качестве названия файла при сохранении.

Добавим форму обработки, нажав на кнопку с изображением лупы в соответствующем окне. Для примера создадим обработку, показывающую, в каких заказах клиента используется определенная номенклатура. Для этого нам необходимо разместить на форме:

• Реквизит – поле для установки номенклатуры;
• Кнопку, которая выполнит вызов кода.

Добавляем реквизит «Номенклатура» с типом данных «СправочникСсылка.Номенклатура» в соответствующем разделе и кнопку «Показать» в меню «Команды» -> «Команды формы».

Чтобы на форме отразились добавленные данные, их необходимо перетащить в элементы формы, расположенные в левой верхней части. Есть возможность поменять местами элементы с помощью синих стрелок. Чтобы созданная нами кнопка выполняла задуманное, ей нужно назначить процедуру. Через контекстное меню выберем «Действие команды», и на вопрос, где нужен обработчик, ответим: «Создать на клиенте и процедуру на сервере».

Фрагмент 1

&НаКлиенте
Процедура Показать(Команда)
       ПоказатьНаСервере();
КонецПроцедуры

&НаСервере
Процедура ПоказатьНаСервере()
       //Вставить содержимое обработчика.
КонецПроцедуры

Мы выбрали создание процедуры на сервере, так как хотим в качестве результата получить выборку из базы данных. На клиенте у нас нет такой возможности, поэтому потребуется подключение к серверу, который и обменивается с БД данными. Теперь нам необходимо написать код, который реализует задуманное нами. Будет использоваться запрос и вывод всех документов через функцию «Сообщить()».

Фрагмент 2

&НаСервере
Процедура ПоказатьНаСервере()
	
	Запрос = Новый Запрос;
	Запрос.Текст = 
	"ВЫБРАТЬ
	|	ЗаказКлиентаТовары.Ссылка КАК Ссылка,
	|	ЗаказКлиентаТовары.Ссылка.Представление КАК Представление
	|ИЗ
	|	Документ.ЗаказКлиента.Товары КАК ЗаказКлиентаТовары
	|ГДЕ
	|	ЗаказКлиентаТовары.Номенклатура = &Номенклатура";
	
	Запрос.УстановитьПараметр("Номенклатура", Номенклатура);
	
	РезультатЗапроса = Запрос.Выполнить();
	
	ВыборкаЗаказКлиента = РезультатЗапроса.Выбрать();
	
	Пока ВыборкаЗаказКлиента.Следующий() Цикл

		Сообщение = Новый СообщениеПользователю;
		Сообщение.Текст = ВыборкаЗаказКлиента.Представление;
		Сообщение.Сообщить(); 	
		
	КонецЦикла;
	
КонецПроцедуры

&НаКлиенте
Процедура Показать(Команда)
	ПоказатьНаСервере();
КонецПроцедуры

На текущем этапе мы можем в запущенной базе 1С осуществить открытие внешней обработки как обыкновенного файла, и она уже будет работоспособна. Но если у нас много пользователей, нам придется разослать им всем этот файл, снабдив при этом его инструкцией о том, как его, собственно, открывать в 1С, что крайне неудобно. Чтобы этого избежать, наша обработка должна располагаться внутри одного из разделов 1С. Для этого нам необходимо еще немного ее доработать через конфигуратор, указав определенные настройки.

Чтобы разместить внешнюю обработку в разделе 1С, необходимо ей в модуле объекта прописать процедуру «СведенияОВнешнейОбработке». В основном меню обработки нажмите «Действия» и выберите «Модуль объекта». Здесь необходимо прописать все нужные для 1С настройки, чтобы система поняла, что от нее требуется и что за файл перед ней. На скриншоте изображен код функции «СведенияОВнешнейОбработке».

Фрагмент 3

Функция СведенияОВнешнейОбработке() Экспорт
	
	ДанныеДляРег = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("2.4.4.106");
	ДанныеДляРег.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиДополнительнаяОбработка();
	   
       ТабЗнКоманды = Новый ТаблицаЗначений;
       ТабЗнКоманды.Колонки.Добавить("Идентификатор");
       ТабЗнКоманды.Колонки.Добавить("Использование");
       ТабЗнКоманды.Колонки.Добавить("Представление");
	   
       НовСтрока = ТабЗнКоманды.Добавить();
       НовСтрока.Идентификатор = "НоваяВнешняяОбработка";
       НовСтрока.Использование = "ОткрытиеФормы";
       НовСтрока.Представление = "Новая внешняя обработка";
	   
       ДанныеДляРег.Вставить("Команды", ТабЗнКоманды);
	   
       Возврат ДанныеДляРег;
	   
КонецФункции

Подключение внешней обработки в 1С

Перед тем, как подключать внешнюю обработку к типовой конфигурации, необходимо включить использование этого инструмента. В «Администрировании» в подпункте «Печатные формы, отчеты и обработки» устанавливаем флаг напротив нужного нам механизма. Нам становится доступна кнопка перехода к справочнику дополнительных обработок и отчетов.

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

• Указать размещение объекта. Нажатием на «Не определено» мы открываем окно разделов и укажем, в каких разделах будет доступна операция;
• Выбрать пользователей, у которых данная команда появится в меню «Дополнительные обработки» выбранных разделов без лишних настроек. Для этого в табличной части нужно выбрать пункт «Быстрый доступ» и добавить в правую половину ответственных пользователей;
• На вкладке «Дополнительная информация» вы можете указать папку, в которой будет находиться загруженная обработка;
• После нажатия клавиши «Записать» в выбранном разделе в меню «Дополнительные обработки» пользователи обнаружат нашу команду и смогут ею воспользоваться.

Если мы хотим внести изменения в нашу обработку, необходимо сначала выгрузить ее из базы. Для этого в справочнике «Дополнительные обработки и отчеты» найдите нужную строчку и воспользуйтесь командой «Выгрузить в файл…». Внесите изменения, сохраните обработку и через клавишу «Загрузить из файла…» найдите измененный файл epf, не меняя параметры. После записи все пользователи увидят внесенные изменения.

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

Работа с внешними обработками весьма удобна и позволяет избежать многих конфликтов. Единственный их существенный недостаток – они не обновляются автоматически вместе с конфигурацией. То есть, если разработчики поменяли название документа или справочника в основной конфигурации, нам придется вручную выполнять настройку обработки.

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

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

Создание обработки

Для создания новой обработки в 1С необходимо запустить 1С. в режиме «Конфигуратор».

В Конфигураторе в меню «Файл» необходимо выбрать пункт «Новый», так же можно воспользоваться комбинацией клавиш Ctrl+N или кнопкой на панели быстрого доступа.

В появившемся окне выбираем вариант «Внешняя обработка» и нажимаем «ОК».

В открывшемся окне новой обработки необходимо задать ей имя. Назовём нашу обработку «ИнформацияОТекущемДне», автоматически формируется синоним, который будет виден пользователям.

У внешней обработки могут быть реквизиты и табличные части. Так же можно добавить макеты и формы.

Теперь необходимо создать форму для нашей обработки. Выбираем в списке «Формы» и нажимаем «Добавить».

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

Перед нами простейшая обычная форма. Нажимаем правой кнопкой мыши на кнопку «Выполнить» и выбираем пункт «КнопкаВыполнитьНажатие».

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

Теперь сохраним нашу обработку в файл. Для этого в меню «Файл» выберем пункт «Сохранить»

Указываем каталог для сохранения файла. По умолчанию имя файла заполняется именем, которое мы указали при создании обработки.

Запуск обработки

Для запуска обработки запустим 1С в режиме «Предприятие».

Чтобы запустить обработку в меню «Файл» выберем пункт «Открыть».

Выбираем файл нашей обработки. Открывается окно обработки, нажимаем кнопку «Выполнить» и видим, что обработка выводит информационное сообщение о текущей дате. Всё работает корректно.

Добавление обработки в систему

Пользователям будет неудобно каждый раз для запуска обработки указывать путь к файлу. Так же файл может затеряться или удалиться. Чтобы у наших пользователей всегда был доступ к только что созданной обработке поместим её в справочник «Внешние обработки».

В меню «Операции» выберем пункт «Справочник».

В открывшемся окне выберем справочник «Внешние обработки».

В данном справочнике хранятся все внешние обработки, внешние отчеты и внешние печатные формы добавленные в систему. Нажмём кнопку добавить на панели справочника.

В появившемся окне нового элемента справочника необходимо указать вид элемента. Выбираем значение «Обработка».

Теперь нажимаем на кнопку выбора файла. Система выдаст предупреждение безопасности. Нажимаем «Продолжить».

Выбираем файл нашей обработки.  Имя элемента справочника подтянулось автоматически из поля «Синоним» указанного в обработке. Нажимаем «ОК»

Наша обработка появилась в списке. Теперь пользователя достаточно дважды щёлкнуть на неё для запуска.

Сделать это можно двумя основными способами:

• Иметь в штате квалифицированных специалистов, которые имеют достаточную компетенцию для решения основных вопросов.

• Обратиться за сопровождением 1С к сторонним специалистам.

Почему клиенты обращаются именно к нам?

• Мы предлагаем не только внедрение, настройку и сопровождение, но и разработку под 1С, которая позволит оптимизировать ваши бизнес-процессы.

• На вас работает не один человек, а целая команда. Вы не зависите от того, захочет ли специалист пойти в отпуск или взять больничный.

• Вам не нужно оплачивать больничные, отпускные и готовить рабочее место для нового сотрудника.

• Среди наших сотрудников не только специалисты 1С, но и опытные бухгалтера и юристы, поэтому мы подходим всесторонне к вопросу документооборота и отчетности.

• Мы выстраиваем взаимодействие с клиентами так, чтобы вам удобно было оперативно обратиться по любому вопросу.

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

Наряду с обычным режимом работы, в 1С:Предприятие версии 8.2 и 8.3 существует режим управляемого приложения, где используется механизм управляемых форм.

Чтобы создать обработку в управляемом приложении 1С, нужно вместо обычной формы создать управляемую. Покажем этапы создания обработки на примере простой задачи. Предположим, есть строка текста (поле «Текст»). По кнопке «Выполнить» нужно рассчитать её длину.

Первые 4 шага будут такими же, как при создании обычной обработки: https://life1c.ru/post/1687.

1. Выбираем информационную базу из списка, заходим в режим конфигуратора 1С. В качестве базы будет выбрана демо база 1С:Бухгалтерия 3.0.

2. В конфигураторе выбираем пункт меню Файл – Новый…

3. Выбираем из списка вид объекта – Внешняя обработка.

4. Задаём имя обработки. В данном случае имя нашей обработки будет «РассчитатьДлинуСтроки».

5. Определяем структуру данных обработки. По условию нашей задачи в структуру реквизитов нужно добавить строковое поле «Текст».

6. Создаём пользовательскую форму обработки. Тип формы: Управляемая.

7. Определяем обработчик нажатия на кнопку «Выполнить» с помощью команд формы. Для этого добавляем новую команду и называем её «ДействиеВыполнить».

8. В модуле формы определяем соответствующую процедуру для исполнения. Для создания обработчика в сплывающем окне выбираем пункт «Создать на клиенте».

9. Прописываем соответствующий код для управляемого приложения.

10. На форме создаём кнопку «Выполнить» для команды формы «ДействиеВыполнить».

11. Сохраняем файл обработки на диске.

12. Заходим в режим управляемого приложения 1С:Предприятие. Для примера работоспособности внешней обработки будем использовать демо базу 1С:Бухгалтерия 3.0 с интерфейсом «Такси».

13. Открываем обработку созданную нами обработку. Выбираем пункт меню Файл – Открыть…

14. В управляемой форме обработки набираем произвольное сообщение в поле «Текст» и нажимаем кнопку «Выполнить». Внизу окна появится результат выполнения обработки – количество символов написанного сообщения.

Таким образом, в этой статье мы научились создавать внешние обработки в режиме управляемого приложения. Так же можно создавать обработки и отчёты любой сложности.

Пример готовой внешней обработки можно скачать ниже по ссылке.

P.S.: Остались вопросы? Спрашивайте в комментариях!

Дополнительные отчеты и обработки — подсистема 1С БСП, предназначена для расширения функционала без изменения конфигурации.

Для более полного ознакомления можно развернуть демонстрационную конфигурацию по БСП. В ней есть необходимые примеры.

Что можно подключить

• внешние обработки (файлы с расширением “epf”) ;
• внешние отчеты (файлы с расширением «erf»).

Виды разработок

• Дополнительная обработка.
• Дополнительный отчет.
• Заполнение объекта. Возможность установить свои кнопки по заполнению документа (ранее были только кнопки по заполнению табличной части).
• Печатная форма. Дополнительная печатная форма. Добавляется кнопка «Дополнительные печатные формы».
• Отчет. Прикрепляемый к справочникам и документам.
• Создание связанных объектов. Свой ввод на основании. В пункт меню «Ввод на основании» добавляется кнопка «Создание связанных объектов…».

Возможности БСП:

• В документах можно добавлять кнопки по заполнению всего документа, кнопки по вводу на основании.
• Обработка может содержать несколько команд меню.
• Вводить на основании и заполнять объекты сразу на основании нескольких объектов.
• Задавать расписание выполнение серверных команд (на сервере).
• Задавать режим «Безопасный» или «Небезопасный», т.е. запускать обработку с учетом ограничением прав или полные права
• Задать режим использования: «Не использовать», «Отладка», «Использовать».
• Включить использование в формах объекта и в форма списков
• Привязать ко всем указанным объектам обработку или отчет.
• Настроить быстрый доступ к определенным командам внешних обработок.
• Возможность указать в каких разделах интерфейса должны появляться дополнительные обработки и отчеты.

Сведения о внешней обработке

«Вид»

Минимальным условием для регистрации разработки является заполнение поля «Вид».

Значение поле может принимать одно из значений, возвращаемых функциями: ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработки<Вид>().

Таблица. Поле «ВИД».

«Назначение»

Содержит массив объектов конфигурации в формате «<Тип>.<Вид>», для которых будет назначен внешний отчет/обработка.

«Наименование»

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

 «Команды»

Таблица значений. Загружается в одноименную табличную часть элемента справочника «Дополнительные отчеты и обработки» при регистрации внешней обработки.

Эту табличную часть можно заполнить и вручную.

Колонки таблицы:

Идентификатор – строка (идентификатор команды).

Представление – описание команды.

Модификатор — строка (используется для дополнительных печатных форм).

ПоказыватьОповещение – окно оповещение будет появляться перед началом и после окончания выполнения (для команд клиентских и серверных без формы).

Использование – режим запуска обработки.

В колонке «Использование» указывается тип вызываемой команды. По сочетанию Вид-Тип команды система определяет какая предопределенная процедура будет вызвана из внешней обработки/отчета, и где она будет объявлена — на клиенте или на сервере.

Наиболее часто используются процедуры Печать() и ВыполнитьКоманду(), а также открытие формы без обращения к методу.

Это поле может принимать одно из значений, возвращаемых функциями ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКоманды<Тип>(), например, ТипКомандыВызовСерверногоМетода().

Таблица. Возможные варианты использования в таблице.

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

«Версия БСП»

Строка, версия встроенной в конфигурации БСП. Необходима для поддержки совместимости. Можно не заполнять.

«Безопасный Режим»

Булево, отображает режим запуска обработка. В безопасном режиме недоступен привилегированный режим, COM-соединение, загрузка dll, доступ к файловой системе и интернету.

«Информация»

Строка, комментарий, который характеризует обработку.

«Версия»

Строка, версия обработки.

Подготовка разработки к подключению.

Для подключения разработки в базу необходимо задать параметры в экспортной функции модуля объекта «СведенияОВнешнейОбработке».

Пример

Функция СведенияОВнешнейОбработке() Экспорт

         ОбъектыНазначенияФормы = Новый Массив;
         ОбъектыНазначенияФормы.Добавить("Документ.РеализацияТоваровУслуг");

         ПараметрыРегистрации = ПолучитьПараметрыРегистрации(ОбъектыНазначенияФормы, "ТОРГ - 12 (альтернативная)");
         ПараметрыРегистрации.Версия = "2017.03.07";
         ПараметрыРегистрации.Информация = "Внешняя печатная форма документа реализации товаров и услуг ТОРГ - 12 (альтернативная)";

         ТаблицаКоманд = ПолучитьТаблицуКоманд();

         ДобавитьКоманду(ТаблицаКоманд,
         "ТОРГ - 12 (альтернативная)",      // Представление команды в пользовательском интерфейсе
         "ТОРГ_12_альтернативная",          // Уникальный идентификатор команды
         "ВызовСерверногоМетода",           // Использование команды //ОткрытиеФормы
         Истина,                            // Показывать оповещение.
         "ПечатьMXL"                        // Дополнительный модификатор команды.);

         ПараметрыРегистрации.Вставить("Команды", ТаблицаКоманд);

         Возврат ПараметрыРегистрации;

КонецФункции

Функция ПолучитьПараметрыРегистрации(ОбъектыНазначенияФормы = Неопределено, НаименованиеОбработки = "", Информация = "", Версия = "1.0.0")

         Если ТипЗнч(ОбъектыНазначенияФормы) = Тип("Строка") Тогда
                  ОбъектНазначенияФормы = ОбъектыНазначенияФормы;
                  ОбъектыНазначенияФормы = Новый Массив;
                  ОбъектыНазначенияФормы.Добавить(ОбъектНазначенияФормы);
         КонецЕсли;

         ПараметрыРегистрации = Новый Структура;
         ПараметрыРегистрации.Вставить("Вид", "ПечатнаяФорма");
         ПараметрыРегистрации.Вставить("БезопасныйРежим", Истина);
         ПараметрыРегистрации.Вставить("Назначение", ОбъектыНазначенияФормы);

         Если Не ЗначениеЗаполнено(НаименованиеОбработки) Тогда
                  НаименованиеОбработки = ЭтотОбъект.Метаданные().Представление();
         КонецЕсли;

         ПараметрыРегистрации.Вставить("Наименование", НаименованиеОбработки);

         Если Не ЗначениеЗаполнено(Информация) Тогда
                  Информация = ЭтотОбъект.Метаданные().Комментарий;
         КонецЕсли;

         ПараметрыРегистрации.Вставить("Информация", Информация);
         ПараметрыРегистрации.Вставить("Версия", Версия);

         Возврат ПараметрыРегистрации;

КонецФункции

Функция ПолучитьТаблицуКоманд()

         Команды = Новый ТаблицаЗначений;
                  Команды.Колонки.Добавить("Представление", Новый ОписаниеТипов("Строка"));
                  Команды.Колонки.Добавить("Идентификатор", Новый ОписаниеТипов("Строка"));
                  Команды.Колонки.Добавить("Использование", Новый ОписаниеТипов("Строка"));
                  Команды.Колонки.Добавить("ПоказыватьОповещение", Новый ОписаниеТипов("Булево"));
                  Команды.Колонки.Добавить("Модификатор", Новый ОписаниеТипов("Строка"));

         Возврат Команды;

КонецФункции

Процедура ДобавитьКоманду(ТаблицаКоманд, Представление, Идентификатор, Использование, ПоказыватьОповещение = Ложь, Модификатор = "")

// Добавляем команду в таблицу команд по переданному описанию.
// Параметры и их значения можно посмотреть в функции ПолучитьТаблицуКоманд

         НоваяКоманда = ТаблицаКоманд.Добавить();
                  НоваяКоманда.Представление = Представление;
                  НоваяКоманда.Идентификатор = Идентификатор;
                  НоваяКоманда.Использование = Использование;
                  НоваяКоманда.ПоказыватьОповещение = ПоказыватьОповещение;
                  НоваяКоманда.Модификатор = Модификатор;

КонецПроцедуры

Функция Печать(СсылкаНаОбъект, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода) Экспорт // Запускается при печати

         КоллекцияПечатныхФорм = Новый ТаблицаЗначений;
                  КоллекцияПечатныхФорм.Колонки.Добавить("ИмяМакета");
                  КоллекцияПечатныхФорм.Колонки.Добавить("ИмяВРЕГ");
                  КоллекцияПечатныхФорм.Колонки.Добавить("СинонимМакета");
                  КоллекцияПечатныхФорм.Колонки.Добавить("ТабличныйДокумент");
                  КоллекцияПечатныхФорм.Колонки.Добавить("Экземпляров");
                  КоллекцияПечатныхФорм.Колонки.Добавить("Картинка");
                  КоллекцияПечатныхФорм.Колонки.Добавить("ПолныйПутьКМакету");

         Настройка=КоллекцияПечатныхФорм.Добавить();
                  Настройка.ИмяВРЕГ= "ТОРГ_12_АЛЬТЕРНАТИВНАЯ";
                  Настройка.Экземпляров = 1;

         Возврат УправлениеПечатью.ВывестиТабличныйДокументВКоллекцию(КоллекцияПечатныхФорм,
                  "ТОРГ_12_Альтернативная", "ТОРГ 12 (Альтернативная)",
                  ПолучитьТабличныйДокументТорг12(СсылкаНаОбъект, ОбъектыПечати)); // Функция «ПолучитьТабличныйДокументТорг12» вернет табличный документ для печати

КонецФункции

Подключение к базе.

Открываем справочник «Дополнительные отчеты и обработки». Кнопкой «Добавить» создаем элемент справочника. После чего система предложит прикрепить вашу разработку. Система автоматически заполнит поля формы функцией «СведенияОВнешнейОбработке.

Отладка

Единственный минус дополнительных отчетов и обработок заключается в том, что внутри них не работает встроенный в платформу отладчик.

Связано это в первую очередь с тем, что, запуская такую форму, система создает временный файл, и точки останова не срабатывают.

Способы отладки

1. Создать форму. Реквизит ссылочного типа на объект. Вызвать экспортную функцию модуля объекта и необходимыми параметрами.
2. Внести изменения в общий модуль «ДополнительныеОтчетыИОбработки». По владельцу формы организовать выбор действия.
3. В разработку добавить код с ошибкой внутри «Попытка Исключения КонецПопытки». Для режима отладки устанавливаем флаг «Останавливаться по ошибке»
4. В СведенияОВнешнейОбработке устанавливаете БезопасныйРежим = Ложь. Загружаете в справочник ДополнительныеОтчетыИОбработки. Запускаете эту обработку через Файл-Открыть. Закрываете обработку. Запускаете подключенную команду. Точки останова сработают в файле.
5. Открывать разработку через обработку в которой вызывается разработка из справочника «Дополнительный отчеты и обработки». То же самое что п. 2 только в обработке.
6. Тот же пункт 5 только в расширение конфигурауции.

Не забывайте обновить обработку в базе.