Holkas
Написать в поддержку Поддержка

Задача / по шагам

Перенести справочник решения вместе с доработкой

Учебный словарь статусов КОР Парус 8 — манифест, конструктор набора данных, отбор одного словаря, построчный план и проверка результата.

На этой странице
  1. 01
    Разработка

    Словарь и его значения

  2. 02
    Набор данных

    Граница и построчный план

  3. 03
    Приёмка

    Тот же справочник решения

Пример выполнен на двух учебных базах PostgreSQL. Словарь HKSITE_STATUS и три его значения перенесены через Holkas. Повторный план пустой; значения и описания дополнительно сверены запросом к обеим базам.

Учебный пример

Доработке часто нужны не только класс и функция, но и небольшой справочник: статусы, виды или настройки решения. В Holkas такой состав описывает набор данных. Он позволяет увидеть границу переноса на схеме, проверить отобранные строки и разобрать команды до записи в приёмник.

В учебной доработке согласования договоров есть словарь с тремя статусами. Перенесём только его. Документы договоров в этот набор не входят.

Читаемый JSON учебного набора, ключи, границы и вложенные ссылки — в справочнике Описание набора данных.

HKSITE_STATUS

Один словарь

Учебные статусы согласования договоров. Другие словари в набор не включаем.

DAT

Корень и часть

EXTRA_DICTS — описание словаря; EXTRA_DICTS_VALUES — принадлежащие ему значения.

3

Три значения

«Черновик», «На согласовании» и «Согласован», каждое со своим описанием.

Перед началом

  • 01

    Словарь уже существует в источнике

    Подготовьте учебные записи в Парусе. Конструктор Holkas описывает, какие строки переносить; значения справочника он за вас не придумывает.

  • 02

    Два подключения

    Нужны чтение разработки и запись в приёмку. В примере таблицы и раздел «Дополнительные словари» уже есть в обеих базах.

  • 03

    Манифест доработки

    Используем состав из первого переноса. Можно создать отдельный манифест для справочника. Он хранит выбор объектов и описание набора; строки читаются из источника при построении плана.

Добавьте набор в состав доработки

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

Манифест доработки с классом, таблицей, функцией и набором «Статусы согласования»
Один манифест объединяет структуру доработки и нужный ей справочник. Он не закрепляет содержимое базы на дату сохранения.

На скриншоте показан уже сохранённый состав. Строка «Набор данных» живёт рядом с классом, таблицей и функцией. Позже её можно открыть и уточнить описание.

Ограничьте набор одним словарём

На схеме выберите корень EXTRA_DICTS. Укажите ключ строки CODE. В границе «Список ключей» введите HKSITE_STATUS. В этом примере Holkas также показывает часть EXTRA_DICTS_VALUES, связанную с родителем колонкой PRN.

Схема набора с корнем EXTRA_DICTS, частью EXTRA_DICTS_VALUES и границей HKSITE_STATUS
Сохранённое описание набора. Корень ищется по CODE; у части ключ пуст — строки сопоставляются по всем значениям, что видно на карточке.

Ключ — как найти ту же запись

CODE позволяет сопоставить словарь в разных базах. Локальный RN для этого не подходит.

Граница — какие записи брать

В нашем списке один код. «Все строки» включило бы другие словари, поэтому для первого примера этот вариант не выбираем.

Часть — что принадлежит словарю

Значения берутся вместе со своим родителем. Связь PRN будет указывать на запись словаря в приёмнике.

Оставьте «Удалять лишнее» выключенным. Этот переключатель относится к строкам корня. Лишние строки частей внутри выбранного родителя могут удаляться и при выключенном переключателе — проверяйте команды плана.

Проверьте описание и посмотрите строки

Нажмите «Проверить» и разберите находки. Затем откройте «Строки». В предпросмотре корня должна быть одна запись с CODE = HKSITE_STATUS. Сохраните новое описание кнопкой «Добавить в манифест»; при редактировании она называется «Сохранить описание».

Предпросмотр границы набора — одна корневая строка HKSITE_STATUS
Отбор проверен до переноса. В списке нет других словарей.

Одна строка в предпросмотре — это один словарь, а не одно его значение. Три строки части увидим отдельно в плане. Проверка описания по источнику ещё не подтверждает готовность приёмника.

Постройте план и прочитайте его построчно

В «Перенести» выберите разработку источником, приёмку — приёмником. На шаге объектов откройте «Манифест» и выберите набор «Статусы согласования». Для повторения этого примера оставьте только его и запустите план.

Первый план набора — пять команд Create для набора, корня и трёх значений
Реальный план перед первым применением. Родитель и его значения видны отдельными строками.

При первом переносе получилось пять команд Create — команда набора, строка словаря и три строки значений. Это не пять словарей. Если справочник уже есть в приёмке, результат сравнения будет другим.

Откройте отдельную строку

Нажмите на команду значения «Черновик» и прочитайте поля. Сверьте само значение и описание «Договор готовят к согласованию». Ниже видны зависимость от родительского словаря и SQL — ссылка на него находится по CODE, а не копируется как RN из источника.

Детали команды для значения «Черновик» учебного словаря
Детали сохранённой операции доступны и после применения. Здесь можно проверить, какие значения входили в команду.

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

Примените проверенный план

Когда состав и команды понятны, нажмите «Применить». Дождитесь завершения, проверьте статусы строк и журнал. В нашем переносе все пять команд исполнены успешно.

Перенос справочника завершён — все пять команд исполнены
Словарь и три его значения записаны в учебную приёмку.

На рабочей базе заранее нужен способ восстановления. Запись выполняется с обычными триггерами Паруса; в обычном режиме отказ команды не означает общего отката. Для PostgreSQL можно выбрать одну транзакцию.

Сравните ещё раз и проверьте справочник

Повторите тот же маршрут с тем же описанием набора. Пустой план подтверждает совпадение внутри выбранной границы. Затем проверьте значения справочника в приёмнике и их использование в вашей доработке.

Повторный план набора данных — расхождений не выявлено
Повторная проверка того же набора. Перенос больше не требуется.

Черновик

Договор готовят к согласованию.

На согласовании

Ответственный проверяет условия.

Согласован

Проверка завершена.

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

Граница задана

Выбран конкретный словарь и принадлежащие ему значения.

Строки проверены

Действия и содержимое команд просмотрены; применение завершилось успешно.

Результат совпал

Повторный план пустой; значения проверены в приёмнике.

Если что-то пошло не так

В предпросмотр попали другие словари

Вернитесь к границе корня. Проверьте режим «Список ключей», выбранные колонки ключа и введённые значения.

Нужной таблицы нет в приёмнике

Набор переносит строки. При необходимости включите таблицу и раздел, регистрирующий её в Парусе, в тот же перенос. Holkas не добавляет раздел автоматически. Правила набора.

Есть предупреждение об отсутствующей ссылке

Проверьте, существует ли нужная запись в приёмнике. Внешние строки не дотягиваются автоматически; их можно подготовить отдельно или перенести подходящим набором в том же плане.

Выключено «Удалять лишнее», но в плане есть Delete

Настройка защищает отсутствующие в источнике строки корня. Части сравниваются внутри родителя, и лишние строки частей удаляются. Разберите каждую такую команду перед применением.