--- name: onec-external-processors-and-delivery description: "Проектирует и сопровождает внешние отчёты и обработки (EPF/ERF), подключение к подсистеме ДополнительныеОтчетыИОбработки БСП, поставку обновлений CF/CFU/CFE и безопасное резервное копирование и восстановление стендов 1С. Используй при разработке внешних артефактов, регламенте релизов и подготовке тестовых копий ИБ." --- # Внешние отчёты и обработки, поставка релизов и восстановление баз 1С Используй навык при разработке или обновлении внешних обработок (`.epf`) и внешних отчётов (`.erf`), их регистрации в БСП, подготовке пакетов поставки (`.cf`, `.cfu`, `.cfe`) и проверке резервного копирования / развёртывания копий информационных баз. Операции с проектами внешних объектов в EDT выполняй через навык `edt-mcp-project-external-objects`. ## Тройная идентичность внешнего отчёта или обработки (`EPF` / `ERF`) При доработке внешней обработки или печатной формы не путай три отдельных представления: 1. **Исходники внешнего объекта в проекте EDT** (модуль объекта, формы, макеты); 2. **Собранный бинарный файл `.epf` / `.erf` на диске** (требует пересборки из исходников после каждой правки); 3. **Экземпляр в справочнике `ДополнительныеОтчетыИОбработки` информационной базы** (хранит бинарные данные во внутреннем хранилище значения — замена файла в папке на диске **не обновляет** обработку внутри базы до перезагрузки файла в карточку справочника!). При обновлении карточки в `ДополнительныеОтчетыИОбработки` сохраняй назначение объектам, размещение в разделах, расписание регламентных вызовов и список пользователей быстрого доступа; не удаляй существующий элемент справочника с созданием нового `Ссылка`, чтобы не разрушить настройки пользователей и задания. ## Контракт `СведенияОВнешнейОбработке` в БСП Для подключаемых отчётов, обработок заполнения, создания на основании и внешних печатных форм проверь экспортную функцию модуля объекта `СведенияОВнешнейОбработке()`: - Явно укажи `Вид` (`ПечатнаяФорма`, `ЗаполнениеОбъекта`, `СозданиеСвязанныхОбъектов`, `Отчет`, `ДополнительнаяОбработка`), `ВерсияБСП`, `Версия` самой обработки и `БезопасныйРежим` (`Истина` везде, где не требуются привилегии вне песочницы; отключение безопасного режима требует явного обоснования). - Для каждой строки таблицы `Команды` согласуй **`ВариантЗапуска`** с фактической реализацией: - `ОткрытиеФормы` — открывает управляемую форму обработки на клиенте; - `ВызовКлиентскогоМетода` — вызывает экспортную процедуру модуля формы; - `ВызовСерверногоМетода` — вызывает экспортную процедуру `ВыполнитьКоманду` в модуле объекта (для фоновых/пакетных команд и формирования печатных форм без предварительного диалога). - Для печатной формы идентификаторы макетов и названия команд в `УправлениеПечатью` обязаны совпадать со строками таблицы `Команды`. - **Ловушка потери ссылочных типов при разборке/сборке `.epf` и `.erf`**: никогда не разбирай в исходники и не собирай внешнюю обработку/отчёт с ссылочными реквизитами или набором записей регистра на форме в **пустой базе без целевой конфигурации** — платформа без ошибки заменит `СправочникСсылка.<Имя>` на строку или висячий идентификатор типа и сбросит `ПутьКДанным` колонок! Всегда выполняй сборку и выгрузку на базе с соответствующей конфигурацией и совместимым `FormatVersion` целевой платформы. ## Пакеты поставки (`CF`, `CFU`, `CFE`), хранилище конфигурации и окно обновления - При работе с базой, подключённой к **хранилищу конфигурации 1С**, полная загрузка из файлов недоступна: соблюдай строгую последовательность `обновление из хранилища → захват нужных объектов (и корня конфигурации при создании нового объекта) → обязательная частичная выгрузка захваченных объектов на диск (чтобы не затереть чужие свежие изменения в хранилище!) → внесение правок → частичная загрузка и обновление БД → помещение в хранилище`. У каждого расширения — собственное хранилище. - Различай полный файл поставки **`.cf`** (загружает конфигурацию целиком) и файл обновления **`.cfu`** (применяется **строго** к перечисленным в его манифесте исходным версиям конфигурации поставщика). Перед выпуском сверяй номер версии и поставщика в свойствах конфигурации. - При регламентном обновлении рабочей базы фиксируй полный цикл: проверка актуальной резервной копии → установка блокировки сеансов и регламентных заданий с кодом разрешения → завершение активных фоновых задач → загрузка и обновление конфигурации БД → запуск обработчиков обновления БСП в монопольном/служебном режиме → **обязательное снятие блокировки сеансов и включение регламентных заданий** (включая ветку аварийного отката!). ## Доказательство резервного копирования и изоляция тестовой копии Наличие файла бэкапа в каталоге не доказывает возможность восстановления (RPO / RTO проверяются только тестовым развёртыванием). - Различай свойства способов копирования: - **Выгрузка `.dt`** удобна для переноса небольших тестовых и файловых баз, но требует монопольного режима, сильно нагружает память и не позволяет восстановить базу на произвольную секунду транзакционного лога; - **Штатный бэкап СУБД (PostgreSQL / MS SQL Server)** обеспечивает консистентность на горячей базе и Point-in-Time Recovery; - **Снимок виртуальной машины** без координации с СУБД соответствует аварийному отключению питания и требует проверки целостности таблиц после подъёма. - **Обязательная изоляция восстановленной копии**: сразу после восстановления рабочей базы в тестовый/разработческий контур (до запуска регламентных заданий!) заблокируй выполнение регламентных заданий на уровне кластера ИБ, очисти или перенаправь учётные записи электронной почты, СМС, ЭДО, банковских обменов, вебхуков, касс и узлов РИБ. Иначе тестовая копия начнёт рассылать реальным клиентам дубли писем, забирать сообщения из продуктовой очереди или списывать коды маркировки! ## Дополнительная памятка и парные навыки - [Совместимость `FormatVersion`, ловушки разборки `EPF`/`ERF` и заимствования `CFE`](format-versions-and-dump-traps.md) - Протокол захватов и частичной загрузки в Хранилище 1С: [`onec-configuration-repository`](../onec-configuration-repository/SKILL.md) - Для импорта, проверки и сборки внешних обработок и отчётов (`.epf`/`.erf`) через EDT-MCP применяй в паре [`edt-mcp-project-external-objects`](../edt-mcp-project-external-objects/SKILL.md).