Задача / по шагам
Перенести справочник решения вместе с доработкой
Учебный словарь статусов КОР Парус 8 — манифест, конструктор набора данных, отбор одного словаря, построчный план и проверка результата.
На этой странице
- 01Разработка
Словарь и его значения
- 02Набор данных
Граница и построчный план
- 03Приёмка
Тот же справочник решения
Пример выполнен на двух учебных базах PostgreSQL. Словарь HKSITE_STATUS и три его значения перенесены через Holkas. Повторный план пустой; значения и описания дополнительно сверены запросом к обеим базам.
Учебный пример
Доработке часто нужны не только класс и функция, но и небольшой справочник: статусы, виды или настройки решения. В Holkas такой состав описывает набор данных. Он позволяет увидеть границу переноса на схеме, проверить отобранные строки и разобрать команды до записи в приёмник.
В учебной доработке согласования договоров есть словарь с тремя статусами. Перенесём только его. Документы договоров в этот набор не входят.
Читаемый JSON учебного набора, ключи, границы и вложенные ссылки — в справочнике Описание набора данных.
Один словарь
Учебные статусы согласования договоров. Другие словари в набор не включаем.
Корень и часть
EXTRA_DICTS — описание словаря; EXTRA_DICTS_VALUES — принадлежащие ему значения.
Три значения
«Черновик», «На согласовании» и «Согласован», каждое со своим описанием.
Перед началом
- 01
Словарь уже существует в источнике
Подготовьте учебные записи в Парусе. Конструктор Holkas описывает, какие строки переносить; значения справочника он за вас не придумывает.
- 02
Два подключения
Нужны чтение разработки и запись в приёмку. В примере таблицы и раздел «Дополнительные словари» уже есть в обеих базах.
- 03
Манифест доработки
Используем состав из первого переноса. Можно создать отдельный манифест для справочника. Он хранит выбор объектов и описание набора; строки читаются из источника при построении плана.
Добавьте набор в состав доработки
Откройте манифест. В блоке «Пополнить» переключитесь на ручное добавление и нажмите «Набор данных». Выберите базу разработки, корневую таблицу EXTRA_DICTS и задайте имя «Статусы согласования».
На скриншоте показан уже сохранённый состав. Строка «Набор данных» живёт рядом с классом, таблицей и функцией. Позже её можно открыть и уточнить описание.
Ограничьте набор одним словарём
На схеме выберите корень EXTRA_DICTS. Укажите ключ строки CODE. В границе «Список ключей» введите HKSITE_STATUS. В этом примере Holkas также показывает часть EXTRA_DICTS_VALUES, связанную с родителем колонкой PRN.
Ключ — как найти ту же запись
CODE позволяет сопоставить словарь в разных базах. Локальный RN для этого не подходит.
Граница — какие записи брать
В нашем списке один код. «Все строки» включило бы другие словари, поэтому для первого примера этот вариант не выбираем.
Часть — что принадлежит словарю
Значения берутся вместе со своим родителем. Связь PRN будет указывать на запись словаря в приёмнике.
Оставьте «Удалять лишнее» выключенным. Этот переключатель относится к строкам корня. Лишние строки частей внутри выбранного родителя могут удаляться и при выключенном переключателе — проверяйте команды плана.
Проверьте описание и посмотрите строки
Нажмите «Проверить» и разберите находки. Затем откройте «Строки». В предпросмотре корня должна быть одна запись с CODE = HKSITE_STATUS. Сохраните новое описание кнопкой «Добавить в манифест»; при редактировании она называется «Сохранить описание».
Одна строка в предпросмотре — это один словарь, а не одно его значение. Три строки части увидим отдельно в плане. Проверка описания по источнику ещё не подтверждает готовность приёмника.
Постройте план и прочитайте его построчно
В «Перенести» выберите разработку источником, приёмку — приёмником. На шаге объектов откройте «Манифест» и выберите набор «Статусы согласования». Для повторения этого примера оставьте только его и запустите план.
При первом переносе получилось пять команд Create — команда набора, строка словаря и три строки значений. Это не пять словарей. Если справочник уже есть в приёмке, результат сравнения будет другим.
Откройте отдельную строку
Нажмите на команду значения «Черновик» и прочитайте поля. Сверьте само значение и описание «Договор готовят к согласованию». Ниже видны зависимость от родительского словаря и SQL — ссылка на него находится по CODE, а не копируется как RN из источника.
Смотрите не только общее число команд, но и их действия и поля. При следующих переносах изменения части с пустым ключом могут выглядеть как удаление старой строки и создание новой.
Примените проверенный план
Когда состав и команды понятны, нажмите «Применить». Дождитесь завершения, проверьте статусы строк и журнал. В нашем переносе все пять команд исполнены успешно.
На рабочей базе заранее нужен способ восстановления. Запись выполняется с обычными триггерами Паруса; в обычном режиме отказ команды не означает общего отката. Для PostgreSQL можно выбрать одну транзакцию.
Сравните ещё раз и проверьте справочник
Повторите тот же маршрут с тем же описанием набора. Пустой план подтверждает совпадение внутри выбранной границы. Затем проверьте значения справочника в приёмнике и их использование в вашей доработке.
Черновик
Договор готовят к согласованию.
На согласовании
Ответственный проверяет условия.
Согласован
Проверка завершена.
Для этого примера отдельным запросом к обеим базам сверены все три значения и их описания. Повторное сравнение не проверяет остальные словари или работу прикладной логики Паруса.
Граница задана
Выбран конкретный словарь и принадлежащие ему значения.
Строки проверены
Действия и содержимое команд просмотрены; применение завершилось успешно.
Результат совпал
Повторный план пустой; значения проверены в приёмнике.
Если что-то пошло не так
В предпросмотр попали другие словари
Вернитесь к границе корня. Проверьте режим «Список ключей», выбранные колонки ключа и введённые значения.
Нужной таблицы нет в приёмнике
Набор переносит строки. При необходимости включите таблицу и раздел, регистрирующий её в Парусе, в тот же перенос. Holkas не добавляет раздел автоматически. Правила набора.
Есть предупреждение об отсутствующей ссылке
Проверьте, существует ли нужная запись в приёмнике. Внешние строки не дотягиваются автоматически; их можно подготовить отдельно или перенести подходящим набором в том же плане.
Выключено «Удалять лишнее», но в плане есть Delete
Настройка защищает отсутствующие в источнике строки корня. Части сравниваются внутри родителя, и лишние строки частей удаляются. Разберите каждую такую команду перед применением.