1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ДополнительныеОтчетыИОбработки |
| Полное имя | Справочник.ДополнительныеОтчетыИОбработки |
| Синоним | Дополнительные отчёты и обработки |
| Конфигурация | Бухгалтерия для Казахстана, редакция 3.0 (версия 3.0.74.2) |
| Подсистема БСП | «Дополнительные отчёты и обработки» (AdditionalReportsAndDataProcessors) |
Назначение. Справочник предназначен для регистрации и администрирования дополнительных (внешних) отчётов и обработок, которые расширяют функциональность конфигурации без модификации исходного кода (без снятия с поддержки). Он позволяет загрузить в базу файл .epf (обработка) или .erf (отчёт), задать статус публикации, определить видимость команд в интерфейсе, назначить обработку пользователям и распределить её команды по разделам меню и формам объектов.
Работа с объектом ведётся нечасто — при внедрении новой обработки, обновлении её версии или изменении публикации. Это сервисный (административный) справочник: он не участвует в бухгалтерском учёте и сам по себе не хранит учётных данных предприятия.
Где найти в 1С: раздел «Администрирование» → «Печатные формы, отчёты и обработки» → «Дополнительные отчёты и обработки».
Навигационная ссылка: e1cib/list/Справочник.ДополнительныеОтчетыИОбработки
2. Реквизиты шапки и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обязательность | Зачем нужен |
|---|---|---|---|
| БезопасныйРежим | Булево | Нет | Флаг выполнения обработки в безопасном режиме (изоляция от файловой системы, COM, внешних компонент и прочих системных ресурсов) |
| Версия | Строка | Нет | Версия внешней обработки; заполняется из сведений о внешней обработке (СведенияОВнешнейОбработке) при загрузке файла |
| Вид | Перечисление.ВидыДополнительныхОтчетовИОбработок | Нет | Тип объекта: дополнительный отчёт, обработка, заполнение объектов, создание связанных объектов, печатная форма и т. д. Определяет способ вызова и поведение |
| ИмяОбъекта | Строка | Нет | Программное имя объекта из метаданных внешней обработки/отчёта |
| ИмяФайла | Строка | Нет | Имя загруженного файла .epf/.erf |
| Информация | Строка | Нет | Описание назначения обработки и рекомендации по использованию (из сведений о внешней обработке) |
| ИспользоватьДляФормыОбъекта | Булево | Нет | Разрешает вызов команд обработки из форм объектов (например, формы документа) |
| ИспользоватьДляФормыСписка | Булево | Нет | Разрешает вызов команд обработки из форм списков |
| Комментарий | Строка | Нет | Произвольный комментарий администратора |
| Ответственный | Справочник.Пользователи | Да | Пользователь, ответственный за обработку |
| Публикация | Перечисление.ВариантыПубликацииДополнительныхОтчетовИОбработок | Да | Статус: «Используется» / «Отключено» / «Отладка» |
| ХранилищеНастроек | ХранилищеЗначения | Нет | Хранилище пользовательских настроек обработки |
| ХранилищеОбработки | ХранилищеЗначения | Нет | Двоичные данные файла обработки (epf/erf), загруженные в базу |
| ИспользуетХранилищеВариантов | Булево | Нет | Признак использования подсистемы вариантов отчётов (для дополнительных отчётов на СКД) |
| ТеснаяИнтеграцияСФормойОтчета | Булево | Нет | Признак расширенной интеграции с формой основного отчёта |
| РежимСовместимостиРазрешений | Перечисление.РежимыСовместимостиРазрешенийДополнительныхОтчетовИОбработок | Нет | Режим проверки запрашиваемых разрешений (совместимость со старыми версиями платформы/БСП) |
| ВнешнийОбъектИспользовать | Число | Нет | Технический реквизит контроля доступности внешнего объекта |
Реквизит Наименование (стандартный) хранит представление обработки в списке. Реквизит Родитель отсутствует, если справочник неиерархический; группировка выполняется через назначение по разделам (см. ТЧ «Разделы»).
2.2 Табличные части
Команды — список команд (пунктов меню), которые обработка предоставляет пользователю.
| Имя | Тип | Назначение |
|---|---|---|
| Идентификатор | Строка | Уникальный идентификатор команды из метаданных обработки |
| Представление | Строка | Текст пункта меню, отображаемый пользователю |
| ВариантЗапуска | Перечисление | Способ запуска: открытие формы, вызов клиентского метода, вызов серверного метода, формирование печатной формы, сценарий |
| ПоказыватьОповещение | Булево | Показывать ли индикатор выполнения длительной операции |
| Модификатор | Строка | Служебное уточнение поведения команды (например, тип печатной формы) |
| СочетаниеКлавиш | Строка | Горячая клавиша вызова команды |
Разделы — разделы командного интерфейса и объекты назначения, в которых доступны команды обработки (для видов «Обработка», «Дополнительный отчёт», «Печатная форма» — привязка к разделам; для «Заполнение объектов»/«Печатная форма» — привязка к типам объектов-владельцев).
Назначения (при типовой реализации БСП) — список типов документов/справочников, для форм которых обработка применима.
РазрешенияИспользованияПрофилейБезопасности / Разрешения — перечень запрашиваемых обработкой разрешений (доступ к файлам, интернету, внешним компонентам), используемых при работе через профили безопасности сервера.
3. Формы
| Форма | Назначение |
|---|---|
| ФормаЭлемента | Карточка обработки: загрузка файла, просмотр сведений, настройка публикации, состав команд и разделов, назначение ответственных, включение безопасного режима |
| ФормаСписка | Список зарегистрированных обработок с отбором по виду и публикации; команды загрузки новой обработки и обновления из файла |
| ФормаВыбора | Выбор обработки в других механизмах конфигурации |
| НастройкиКоманд (вспомогательная) | Настройка видимости и расписания команд, назначение пользователям |
| Настройка списка команд по расписанию | Управление регламентным (по расписанию) запуском команд обработок вида «Дополнительная обработка» |
Формы самой обработки (ФормаНастроек, произвольные формы) хранятся внутри загруженного .epf/.erf и вызываются динамически, а не описаны в метад��нных справочника.
4. Ключевые процедуры и механизмы
Evidence с исходным BSL не приложено, поэтому ниже — типовые механизмы этого объекта в составе подсистемы БСП «Дополнительные отчёты и обработки». Основная логика вынесена в общие модули ДополнительныеОтчетыИОбработки (клиент/сервер) и ДополнительныеОтчетыИОбработкиВызовСервера.
- Загрузка обработки в базу. При выборе файла считываются двоичные данные, помещаются в
ХранилищеОбработки, извлекаютсяСведенияОВнешнейОбработке()— вид, версия, информация, состав команд. РеквизитыВид,Версия,ИмяОбъекта,Информацияи ТЧ «Команды» заполняются автоматически. ПодключитьВнешнююОбработку/ПолучитьОбъектВнешнейОбработки. Создаёт экземпляр внешнего объекта изХранилищеОбработкидля выполнения команды. При установленномБезопасныйРежимподключение выполняется с изоляцией черезБезопасныйРежим.УстановитьБезопасныйРежим().ВыполнитьКоманду. По идентификатору команды иВариантуЗапускаоткрывает форму, вызывает клиентский/серверный метод обработки или формирует печатную форму. Для длительных операций используется фоновое задание с индикатором.- Проверка разрешений. Перед подключением проверяются запрошенные обработкой разрешения (
РазрешенияИспользованияВнешнихРесурсов) с учётомРежимаСовместимостиРазрешенийи включённых профилей безопасности сервера. - Контроль публикации. При статусе
Публикация = Отключенокоманды в интерфейсе не отображаются;Отладка— обработка доступна только автору/администратору для отладки. - Обработчик заполнения (
ОбработкаЗаполнения). По умолчанию подставляетОтветственный = Пользователи.ТекущийПользователь()иПубликация = Используется. ОбработкаПроверкиЗаполнения. Контролирует заполнение обязательныхОтветственныйиПубликация.
Требует проверки (версионно-специфично): точный состав общих модулей и сигнатуры методов зависят от версии БСП, встроенной в 3.0.74.2.
5. Проведение и движения
Справочник не является проводимым объектом и не формирует бухгалтерских проводок и движений по регистрам учёта. У него нет обработчика ОбработкаПроведения, он не создаёт записей в регистре бухгалтерии (типовой план счетов РК — 1210, 1030, 1330, 3310, 3130, 6010, 7010 — данным справочником не затрагивается), не влияет на расчёт НДС (16 %), ИПН, ОПВ/ОПВР, ОСМС/ВОСМС, СО и соцналог и не участвует в формировании ЭСФ/СНТ.
Все результаты работы (проводки, печатные формы, заполнение реквизитов) создаёт сама подключённая внешняя обработка, когда пользователь запускает её команду — например, дополнительная обработка может провести документ реализации, который уже сформирует доход по счёту 6010, себестоимость по 7010 и НДС к уплате по 3130 по ставке 16 %. Ответственность за корректность таких движений лежит на внешней обработке, а не на справочнике.
Изменение элемента справочника фиксируется только в служебных регистрах платформы (журнал регистрации, версионирование объектов, если оно включено).
6. Связанные объекты и ввод на основании
- Перечисление.ВидыДополнительныхОтчетовИОбработок — определяет тип и способ вызова.
- Перечисление.ВариантыПубликацииДополнительныхОтчетовИОбработок — статусы публикации.
- Перечисление.РежимыСовместимостиРазрешенийДополнительныхОтчетовИОбработок — режим проверки разрешений.
- Справочник.Пользователи — реквизит
Ответственныйи назначение видимости команд по пользователям. - Справочник.ИдентификаторыОбъектовМетаданных — привязка команд к разделам и объектам назначения.
- Регистр сведений «НастройкиКомандДополнительныхОтчетовИОбработок» / «РасписанияРегламентныхЗаданий» — расписания запуска команд по регламенту.
- Регламентное задание «ЗапускДополнительныхОбработокПоРасписанию» — фоновый запуск команд обработок.
Ввод на основании для данного справочника не предусмотрен: он не является источником и не принимает ввод на основании. Загрузка выполняется из внешнего файла .epf/.erf, а не копированием из других объектов.
7. Точки расширения
- Внешние обработки как таковые — это и есть основной штатный механизм расширения конфигурации без снятия с поддержки; данный справочник является входной точкой для них.
- Расширения конфигурации — можно добавлять реквизиты справочника, изменять формы (
ФормаЭлемента,ФормаСписка) и переопределять обработчики через подписки и модули-расширения. - Модуль
ДополнительныеОтчетыИОбработкиПереопределяемый— типовая точка настройки: разрешённые виды обработок, разделы для размещения, ограничения по безопасному режиму. - Профили безопасности сервера — управление правами внешних обработок на доступ к файлам, интернету и внешним компонентам.
- Подписки на события (
ПередЗаписью,ПриУстановкеСтандартныхНастроекРаздела) — для контроля публикации и назначения при внедрении собственных политик.
Требует проверки: доступность безопасного режима и профилей безопасности зависит от режима работы (файловый/клиент-серверный) конкретной информационной базы.