Как программно установить или изменить главный узел в распределенной базе 1С

← На главную

Работа с распределенными информационными базами (РИБ) требует от разработчика четкого понимания механизмов синхронизации метаданных и данных. Одной из ключевых задач при администрировании или восстановлении таких систем является управление «главным узлом». В этой статье мы разберем, как программно определить статус базы, как назначить или отменить главный узел, и какие нюансы следует учитывать при работе в режиме управляемых форм.

Определение статуса базы: главная или подчиненная

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

Визуальный метод (через Конфигуратор):

Рассмотрим дерево конфигурации. Если мы обратим внимание на самый верхний корень дерева (название конфигурации), то увидим специальные иконки. В подчиненной базе рядом с названием конфигурации отображаются две иконки (наложенные друг на друга прямоугольники), а при наведении курсора появляется подсказка о том, что конфигурация заблокирована для редактирования, так как база является подчиненной.

Программный метод:

Проанализируем ситуацию с точки зрения встроенного языка. Для проверки текущего состояния используется метод ПланыОбмена.ГлавныйУзел(). Пропишем простую логику:

Вызываем функцию ПланыОбмена.ГлавныйУзел().
Если результат равен Неопределено, значит, перед нами главная (корневая) база.
Если функция возвращает ссылку на элемент плана обмена, значит, эта база подчиненная, а возвращенная ссылка указывает на её «родителя» (главный узел).

Метод УстановитьГлавныйУзел: синтаксис и особенности

Для изменения или установки связи используется процедура менеджера планов обмена УстановитьГлавныйУзел. Посмотрим на её синтаксис:

ПланыОбмена.УстановитьГлавныйУзел(Параметр)

Здесь важно понимать, что именно мы передаем в качестве параметра:

Ссылка на узел плана обмена: устанавливает указанный узел в качестве главного. Важно, чтобы у плана обмена в свойстве «Распределенная информационная база» стояла соответствующая галочка.
Неопределено: полностью «отвязывает» базу от главного узла, делая её автономной. Это необходимо для внесения правок в конфигурацию напрямую в подчиненном узле или для «лечения» базы после сбоев динамического обновления.

Создание внешней обработки для установки узла

Поскольку в подчиненной базе мы не можем менять код конфигурации, нам потребуется создать внешнюю обработку (файл .epf). Разберем по шагам, как её реализовать для управляемого приложения.

В управляемых формах выполнение этого метода обязательно должно происходить на сервере. Если попытаться вызвать процедуру на клиенте или без параметров, система выдаст ошибку «Недостаточно фактических параметров». Рассмотрим пример правильной реализации кода в форме обработки:


&НаСервере
Процедура УстановитьУзелНаСервере(ВыбранныйУзел)
    // Если ВыбранныйУзел равен Неопределено, база станет главной
    // Если это ссылка на узел Плана Обмена, база станет подчиненной
    ПланыОбмена.УстановитьГлавныйУзел(ВыбранныйУзел);
КонецПроцедуры

&НаКлиенте
Процедура ВыполнитьУстановку(Команда)
    // Здесь СсылкаНаПланОбмена - это реквизит формы с типом СсылкаПланаОбмена
    УстановитьУзелНаСервере(Объект.СсылкаНаПланОбмена);
    Сообщить("Статус главного узла успешно изменен. Перезагрузите сеанс.");
КонецПроцедуры

Где найти «Ссылку на узел»?

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

Критические нюансы и системные требования

Проанализируем дополнительные технические аспекты, которые часто остаются за кадром, но могут привести к ошибкам:

Права доступа: Выполнение процедуры УстановитьГлавныйУзел требует административных прав. Если пользователь не обладает ролью «Полные права», система заблокирует выполнение кода.
Контроль версий конфигурации: Если вы «отвязали» базу, внесли изменения в конфигурацию и решили «привязать» её обратно, будьте крайне осторожны. При повторном назначении главного узла конфигурации в обеих базах должны совпадать байт-в-байт. В противном случае первый же обмен данными завершится критической ошибкой несоответствия версий. Чтобы избежать подобных проблем, автоматически обновлять и тестировать несколько баз 1С перед синхронизацией удобнее в пакетном режиме.
Использование командной строки: Существует альтернативный способ сделать базу автономной без написания кода. При запуске 1С через командную строку можно использовать ключ /ResetMasterNode. Это сбросит настройку главного узла.
Таблица Params: На уровне базы данных информация о главном узле хранится в служебной таблице Params (запись masterNode). Программный вызов процедуры 1С корректно модифицирует эту запись, обеспечивая целостность структуры РИБ.
Префиксация: Помните, что как только база становится подчиненной, система начинает использовать префиксы для новых документов и справочников, чтобы избежать конфликтов номеров при синхронизации. При ручной смене узла убедитесь, что префиксы в планах обмена настроены верно, а для контроля результата можно автоматически сравнивать бухгалтерские и налоговые проводки между базами 1С для поиска расхождений.

Когда это действительно нужно?

Рассмотрим типичные ситуации применения этого метода:

Аварийное восстановление: При динамическом обновлении в РИБ иногда происходит сбой, и база перестает принимать пакеты обновлений. В этом случае базу «отвязывают», загружают в неё актуальный файл конфигурации (.cf) из главного узла и «привязывают» обратно.
Разделение баз: Когда необходимо превратить филиальную базу в полностью самостоятельную организацию.
Переезд на другой сервер: Если при переносе данных настройки обмена «потерялись» или требуют корректировки без создания начального образа.

Таким образом, использование ПланыОбмена.УстановитьГлавныйУзел является мощным инструментом в руках программиста 1С, позволяющим гибко управлять архитектурой распределенной системы, не прибегая к долгому процессу пересоздания начальных образов. Для комплексного разделения учета и отключения от обмена можно использовать решение для выноса организации в отдельную базу с отвязкой от РИБ.