Выгрузка зарегистрированных объектов между одинаковыми базами БГУ 2.0

Что лежит в обработке

Обработка называется «Выгрузка зарегистрированных объектов», версия 1.0. Номер версии выводится в заголовке формы. Правила обмена формата Конвертации данных 2 вшиты в макет и при открытии заполняют дерево на закладке «Выгрузка». Отдельный файл правил при выгрузке выбирать не нужно. При загрузке правила читаются уже из файла обмена.

Над закладками форма показывает направление правил: конфигурацию-источник и конфигурацию-приёмник с номерами релизов. Для текущего макета обе стороны — «Бухгалтерия государственного учреждения, редакция 2.0 (2.0.110.66)».

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

Подготовка узла

План обмена «Полный» в командный интерфейс не выведен. Узел создаётся в базе-источнике.

1. Включите режим технического специалиста: «Сервис и настройки → Настройки → Параметры».
2. Откройте «Функции для технического специалиста → Планы обмена → Полный» и создайте узел.
3. Заполните наименование. По нему узел выбирается в обработке.
4. Код узла — три символа фиксированной длины, например 001. Пустой код обработка заполнит сама перед первой выгрузкой и напишет назначенный код в протокол. Узел «Этот узел» для выгрузки не используется.

Дальше объекты ставятся на регистрацию типовой обработкой «Регистрация изменений для обмена данными»:

1. Выберите созданный узел.
2. В поле «Отображать» оставьте «Все», чтобы в дереве были и уже зарегистрированные объекты, и те, по которым изменений ещё нет.
3. Отметьте нужные ветки. Строка «Справочники» регистрирует все справочники, строка «Документы» — все документы.
4. Нажмите «Зарегистрировать», дождитесь окончания и нажмите «Обновить».

В колонке «Количество» дробь означает «зарегистрировано / всего в базе». Надпись «Нет изменений» означает, что по этому виду объектов на узле ничего не стоит. Регистрация данные не выгружает: она только помечает объекты для следующей выгрузки этого узла.

Выгрузка

Выгрузка выполняется в базе-источнике. Если платформа спрашивает разрешение на опасные действия, его нужно дать: без этого приёмник не сможет записать объекты.

1. Откройте обработку и сверьте строки «Откуда» и «Куда» с релизами баз.
2. На закладке «Выгрузка» выберите тот же узел, на котором регистрировали объекты. В колонке «Количество» появится число объектов правила, зарегистрированных на узле. У группы колонка пустая: число показано на вложенных строках.
3. Отметьте правила. Кнопки «Отметить все» и «Снять отметки» действуют на всё дерево. В файл попадают только отмеченные правила и только зарегистрированные на узле объекты.
4. Укажите файл выгрузки. Выгрузка считается на сервере, готовый XML записывается на клиенте по выбранному пути.
5. Флажок «Снять регистрацию после выгрузки» оставьте выключенным, если объекты должны остаться зарегистрированными для повторной выгрузки.
6. Нажмите «Выгрузить». Ход и ошибки пишутся в протокол, после завершения протокол прокручивается к последней строке.

Виды объектов, которых нет в открытой базе, пропускаются. Их список обработка пишет в протокол при открытии и в выгрузку не включает. Так правила, собранные по полной конфигурации, можно применять в базе, где часть документов или справочников отсутствует.

Загрузка

Файл загружается той же обработкой в базе-приёмнике. На закладке «Загрузка» выбирается XML, кнопка командной панели меняется на «Загрузить». Правила из макета при этом не подменяют правила файла: читается то, что записано при выгрузке.

Для уже выгруженного файла обработка дополняет правила документов признаком продолжения поиска. Если объект с тем же идентификатором в приёмнике не найден, документ ищется по номеру и дате. Повторно выгружать файл из-за этого не нужно.

Типовая обработка «Универсальный обмен данными XML» с включённым флажком «Безопасный режим» этот файл не дочитывает до данных. В безопасном режиме не записывается регистр сведений «Идентификатор объекта метаданных», и загрузка останавливается на первом таком объекте. Здесь безопасный режим выключен.

Как сопоставляются объекты

Базы одинаковые, поэтому внутренний идентификатор для справочников только мешает: один и тот же элемент в двух базах имеет разные ссылки. Ключи поиска в правилах заданы так.

Продолжение поиска документов по номеру и дате нужно для повторной загрузки. Документ с тем же регистрационным номером за год в приёмнике уже есть, а идентификатор у него другой. Без поиска по номеру и дате платформа отказывается записать второй документ с тем же номером.

На что обратить внимание

• Протокол «Загрузка объекта № …» с пустым кодом сообщения — это ход загрузки, а не ошибка. Ошибка в протоколе имеет числовой код и слово «Ошибка».
• Строка «Загружено объектов: 0» сразу после начала загрузки означает, что чтение файла закрылось на правилах и до данных не дошло. В этой обработке перед загрузкой устанавливается режим «Загрузка», поэтому файл читается дальше правил.
• Код сообщения 25 при записи документа означает, что провести документ не удалось. Обработка записывает его непроведённым и идёт дальше. Для «Поступление ОС, НМА, НПА» такая ошибка возникала уже при формировании проводок типовой операции: в таблице источника не удавалось создать колонку дополнительного реквизита. Имя колонки собирается из поля «Имя для формулы». Проверьте реквизиты типовой операции на одинаковые имена для формулы и на имена с пробелом, дефисом, скобками или с цифры в начале. Типовая операция открывается из документа, закладка «Бухгалтерская операция».
• Значение перечисления, которого нет в базе, останавливает чтение правил с сообщением «Поле объекта не обнаружено». В правилах остаются только значения, которые есть в конфигурации релиза 2.0.110.66.
• Пустой код узла обмена даёт ошибку «Код узла не может быть пустым» в момент начала записи сообщения обмена. Обработка заполняет пустые коды узлов этого плана до выгрузки.

Состав поставки

• Внешняя обработка ВыгрузкаЗарегистрированныхОбъектов.epf, версия 1.0.
• Макет правил обмена между двумя конфигурациями «Бухгалтерия государственного учреждения», релиз 2.0.110.66.
• Команда открытия формы для подключения через «Дополнительные отчёты и обработки».

Обработка рассчитана на перенос между одинаковыми релизами. После обновления одной из баз правила нужно собрать заново и заменить макет: ключи поиска привязаны к составу реквизитов этого релиза.