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