Тема: 1Cv8: Бухгалтерия предприятия, редакция 2.0
Буду собирать в этой теме некоторую полезную информацию, касающуюся поддержки и настройки этого популярного продукта .
Справочник «Внешние обработки, печатные формы, обработки по заполнению табличных частей»
Справочник содержит список произвольных обработок, отчётов, дополнительных печатных форм и обработок для заполнения табличных частей объектов.
Меню программы «Сервис» - «Дополнительные отчеты и обработки» имеет четыре подпункта («Дополнительные внешние обработки», «Дополнительные внешние отчеты», «Дополнительные внешние обработки табличных частей», «Дополнительные внешние печатные формы»), каждый из которых открывает один и тот же справочник «Внешние обработки», но с различным отбором элементов.
Справочник позволяет загрузить и хранить файлы внешних отчётов и обработок в виде двоичных данных. Таким образом, загруженные в справочник файлы будут являться для 1С:Предприятия обычными данными пользователя и будут храниться непосредственно в информационной базе. В любой момент ранее загруженный в справочник файл внешнего отчёта или обработки можно сохранить на диск, изменить средствами Конфигуратора, а затем загрузить обратно.
Реализованный в конфигурации механизм работы с внешними отчётами, обработками и внешними печатными формами (частью которого и является этот справочник) позволяет достаточно существенно расширять и модифицировать функционал программы, не затрагивая структуру конфигурации, что может существенно облегчить регулярное обновление конфигурации стандартным способом.
Для внешних отчетов, обработок и печатных форм имеется возможность назначать права доступа, если в конфигурации включено использование ограничения прав доступа на уровне записей (меню «Сервис» - «Настройка программы», вкладка «Права доступа»).
Дополнительные внешние отчёты и обработки
Для произвольных отчётов и обработок достаточно только загрузки внешней обработки, которая находится на диске, в реквизит элемента справочника. Можно использовать любую внешнюю обработку с определенной основной формой.
Двойной щелчок в списке справочника внешних обработок приводит к непосредственному запуску внешней обработки или отчёта. Для замены, выгрузки файла обработки или отчёта на диск или изменения его свойств следует использовать стандартную команду справочника «Изменить».
Дополнительные внешние печатные формы
Внешняя печатная форма представляет из себя обычную внешнюю обработку 1С:Предприятия, удовлетворяющую некоторым специальным критериям.
Механизм внешних печатных форм позволяет:
• указать список дополнительных параметров, которые будут передаваться внешней печатной форме при запуске;
• назначить список объектов (документов/справочников конфигурации), для которых данная печатная форма используется;
• задать для каждого объекта (документа/справочника конфигурации) несколько условий, при выполнении которых печатная форма становится доступной для использования;
• заменять встроенные печатные формы внешними, внешне незаметно для конечного пользователя.
Корректно зарегистрированная внешняя печатная форма будет выводиться в общем списке печатных форм объекта, вызываемого по кнопке «Печать». При этом форма будет помещена в конец этого списка и отделена разделителем. Если подключаемая печатная форма заменяет стандартную, то она появляется в списке стандартных печатных форм, до разделителя.
Табличная часть на форме элемента справочника внешних печатных форм содержит следующие реквизиты:
• «Представление объекта» — здесь выбирается вид документа/справочника конфигурации, для которого используется данная печатная форма;
• «Представление кнопки» — здесь указывается текст команды меню, который будет отображаться в списке при нажатии кнопки «Печать»;
• «Отбор» — здесь настраивается список условий, при выполнении которых печатная форма становится доступной для использования, в терминах реквизитов объекта; например, можно сделать печатную форму доступной, только если документ проведён и т.п.;
• «Файл печатной формы» — здесь можно загрузить отдельный файл внешней обработки, который будет использован вместо загруженного в шапке (опционально);
• «Заменяемая печатная форма» — здесь выбирается заменяемая встроенная печатная форма объекта, если это необходимо;
• «Параметры обработки» — здесь настраивается список параметров (имя-значение), которые будут переданы внешней печатной форме при запуске, если это необходимо; в коде внешней печатной формы каждый такой параметр будет доступен как «ДополнительныеПараметры.Свойство("<ИмяПараметра>", Значение);».
Требования к обработке внешней печатной формы:
• реквизит обработки «СсылкаНаОбъект», в который при вызове будет передана ссылка на объект, для которого необходимо выполнить печать;
• функция «Печать()», объявленная с ключевым словом «Экспорт», без параметров, возвращающая табличный документ; в принципе, эта функция может содержать любой код и не возвращать табличный документ; при вызове внешней печатной формы запускается именно эта функция;
• Необязательный реквизит обработки «ДополнительныеПараметры» произвольного типа, в который будут передаваться дополнительные параметры примитивного типа в виде структуры;
• если обработка имеет в своем составе макет «Параметры_Авторегистрации», он может быть использован для автоматического заполнения принадлежности печатной формы в табличной части справочника внешних обработок в момент загрузки файла обработки; в макете должна быть колонка, содержащая полные имена метаданных в формате «Документы.ИмяДокумента»;.
Дополнительные внешние обработки табличных частей
Табличная часть на форме элемента справочника внешних обработок табличных частей содержит следующие реквизиты:
• «Представление объекта» — здесь выбирается вид документа/справочника конфигурации, для которого используется данная обработка;
• «Табличная часть» — здесь выбирается табличная часть объекта, для которой используется данная обработка;
• «Представление кнопки» — здесь указывается текст команды меню, который будет отображаться в списке при нажатии кнопки «Заполнить»;
• «Параметры обработки» — здесь настраивается список параметров (имя-значение), которые будут переданы внешней печатной форме при запуске, если это необходимо; в коде внешней печатной формы каждый такой параметр будет доступен как «ДополнительныеПараметры.Свойство("<ИмяПараметра>", Значение);»
Требования к внешней обработке табличной части:
• Процедура «Инициализировать(Объект, ИмяТабличнойЧасти, ТабличноеПолеОбъекта)», объявленная с ключевым словом «Экспорт», где:
Объект — ДокументОбъект или СправочникОбъект, откуда был произведён вызов обработки;
ИмяТабличнойЧасти — строка, имя табличной части, для которой вызвана обработка;
ТабличноеПолеОбъекта — элемент формы, табличное поле формы, для которого вызвана обработка;
• Необязательный реквизит обработки «ДополнительныеПараметры» произвольного типа, в который будут передаваться дополнительные параметры примитивного типа в виде структуры;
• если обработка имеет в своем составе макет «Параметры_Авторегистрации», он может быть использован для автоматического заполнения принадлежности обработки в табличной части справочника внешних обработок в момент загрузки файла обработки; в макете должно быть две колонки, содержащие соответственно полные имена метаданных в формате «Документы.ИмяДокумента» и имена их табличных частей;.
В названии ветки всегда должен быть указан язык программирования или среда исполнения скрипта, если это возможно.