Как найти обработку в конфигураторе

Теги:

Похожие темы (4)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Результат:

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример разработки дополнительного отчета

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

Чтобы создать эту функцию, необходимо открыть режим конфигуратора и через основное меню «Файл» — «Новый…», создать внешний отчет. Открыть модуль объекта и добавить функцию «СведенияОВнешнейОбработке» с отметкой «Экспорт». В каждом дополнительном внешнем отчете в 1С 8.3 эта экспортная функция должна возвращать структуру с определенными ключами и значениями:

ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("2.1.3.1");

ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиДополнительныйОтчет();
ПараметрыРегистрации.Версия = "1.0";
ПараметрыРегистрации.БезопасныйРежим = Ложь;

НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
НоваяКоманда.Представление = НСтр("ru = 'Лицевая Карточка Рабочего1'");
НоваяКоманда.Идентификатор = "ЛицеваяКарточкаРабочего";
НоваяКоманда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыОткрытиеФормы();
НоваяКоманда.ПоказыватьОповещение = Истина;
Возврат ПараметрыРегистрации;

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

МасНазначений = Новый Массив;
МасНазначений.Добавить("Справочник.ДоговорыКонтрагентов");
МасНазначений.Добавить("Документ.ПриобретениеТоваровУслуг");
МасНазначений.Добавить("Документ.ПриобретениеУслугПрочихАктивов");
МасНазначений.Добавить("Документ.ПриобретениеУслугПоЛизингу");
МасНазначений.Добавить("Документ.ЗаказПоставщику");
МасНазначений.Добавить("Документ.РеализацияУслугПрочихАктивов");
МасНазначений.Добавить("Документ.РеализацияТоваровУслуг");
МасНазначений.Добавить("Документ.АктВыполненныхРабот");

ПараметрыРегистрации.Назначение = МасНазначений;

• Команды – таблица, содержащая все необходимые команды с определенным набором характеристик. Отвечает за кнопку, запускающую обработку или отчет;
• БезопасныйРежим – принимает значения «Истина» или «Ложь», отвечает за безопасный режим запуска. Это специальный режим, когда для пользователя ограничиваются возможности. Если его включить, то в процессе работы отчета будут недоступны:
  • Привилегированный режим;
  • Библиотеки Dll;
  • COM-соединение;
  • Доступ к файлам и интернету.
• Версия – данные строкового типа для поддержания версионирования дополнительного отчета или обработки. Вспомогательный параметр;
• ВерсияБСП – иногда указывают для контроля совместимости механизма библиотеки стандартных подсистем. Зачастую не указывается;
• Информация – комментарий, дающий определение дополнительному отчету или обработке. Вспомогательный параметр.

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

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

Откроется окно создания макета, нажмите «Готово» и в сформировавшемся окне настройки схемы вызовите контекстное меню на наборах данных.

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

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

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

Подключение дополнительного внешнего отчета к конфигурации

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

При добавлении в данный перечень с помощью кнопки «Создать» 1С откроет форму дополнительной обработки и предложит выбрать файл. Для выбора доступны только файлы формата erf – внешние отчеты, и epf – обработки. При выборе 1С считывает информацию из экспортной функции «СведенияОВнешнейОбработки» и отражает информацию на форме.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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