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

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

Перенести назначения форм ролям, пользователям и приложениям

Визуальная форма КОР Парус 8 назначена ролям, пользователям и приложениям — как перенести эти связи через Holkas, если роли Паруса в приёмнике называются иначе.

На этой странице
  1. 01
    Форма в источнике

    Назначения ролям, пользователям, приложениям

  2. 02
    План

    Соответствие ролей и команды связей

  3. 03
    Парус приёмника

    Нужный пользователь получает форму

Пример выполнен на двух учебных базах PostgreSQL. Форма SiteForm класса HKSiteV30 перенесена с назначениями роли «Все права» и пользователю PARUS и со связью с приложением Admin. Затем роль «Все права» заменена на «Учебные операторы» через соответствие ролей Паруса; повторный план пустой. Сверены записи обеих баз; выбор формы клиентом Паруса в примере не проверялся.

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

Визуальную форму в Конструкторе отраслевых расширений можно назначить ролям и пользователям Паруса и привязать к приложениям — тогда разные люди в одном разделе видят разные формы. В источнике эти связи настроены. В приёмнике форма должна попасть к тем же адресатам, хотя роли там могут называться по-другому.

Holkas переносит каждую связь отдельной командой, и её можно проверить до записи. Назначение формы — это только связь. Оно не создаёт пользователя, не выдаёт ему роль СУБД и не меняет членство в роли Паруса. В учебном примере форма SiteForm класса HKSiteV30 назначена роли «Все права» и пользователю PARUS и связана с приложением Admin, а в приёмнике вместо «Все права» используется роль «Учебные операторы».

CLS.VF

SiteForm

Визуальная форма класса — её свойства и два признака, включающих использование назначений и привязки к приложениям.

CLS.VF.Priv

«Все права» и PARUS

Назначения формы роли Паруса и пользователю Паруса. Каждое — отдельная команда.

CLS.VF.App

Admin

Связь формы с приложением.

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

  • 01

    Роли и пользователи Паруса есть в приёмнике

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

  • 02

    Приложения есть в приёмнике

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

  • 03

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

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

  • 04

    Тестовый пользователь

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

Выберите владельца формы

Откройте «Перенести», задайте источник и приёмник. На шаге «Объекты» отметьте класс HKSiteV30 — его формы и их назначения входят в состав класса. Если форма принадлежит пользовательской процедуре или отчёту, выберите «Польз. процедура» (PCE) или «Польз. отчёт» (REP); команды назначений у них называются так же, с кодами PCE.VF.* и REP.VF.*. Заполните «Основание».

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

Сопоставьте роли Паруса

Перейдите на шаг «Параметры». Если роль в приёмнике называется иначе, найдите блок «Соответствие ролей Паруса». Слева введите роль источника, справа роль приёмника и нажмите «Добавить пару». В примере это «Все права» → «Учебные операторы». Не перепутайте с блоком «Соответствие ролей» выше — он относится к ролям СУБД, владельцам объектов и правам. Если имена ролей совпадают, пары не нужны. Нажмите «Запустить план».

Блок «Соответствие ролей Паруса» на шаге «Параметры» с парой Все права → Учебные операторы
На одном экране различены роли СУБД, владельцы и роли Паруса. Пара Все права → Учебные операторы задана для этого плана.

Имена чувствительны к регистру. Роль приёмника должна уже существовать. Параметр меняет только имя роли в назначениях форм — пользователей, их членство в ролях и роли СУБД он не трогает. В API и MCP тот же параметр называется parusRoleMap.

Прочитайте команды формы и её связей

На вкладке «План» у формы три вида строк. «Визуальная форма класса» — свойства и содержимое. «Назначение формы роли или пользователю» — по строке на каждую роль и каждого пользователя; ключ заканчивается на role:Имя роли или user:Логин. «Связь формы с приложением» — по строке на приложение. Откройте каждую команду создания и удаления и сверьте, кому форма назначается и у кого назначение снимается. В команде формы проверьте поля «Привязка к пользователям» и «Привязка к приложениям» — эти признаки включают отбор формы по назначениям и по приложениям.

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

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

Примените план

Нажмите «Применить» и подтвердите запуск. Дождитесь завершения — у каждой строки должна стоять отметка «исполнено». Если форма уже была перенесена со старым именем роли, план с соответствием содержит две команды — удаление прежнего назначения и создание нового.

План с соответствием ролей — удаление назначения роли «Все права» и создание назначения роли «Учебные операторы»
После применения старая роль снята, новая назначена. Состав пользователей роли не меняется.

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

Сравните ещё раз и откройте форму под пользователем

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

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

Пустой план проверяет перенос записей. Какую форму покажет клиент, зависит ещё от приложения, пользователя, его ролей и признаков использования назначений.

Связи перенесены

Команды формы, назначений и связей с приложениями исполнены без отказов.

Повторный план пустой

Сравнение с теми же парами соответствия ролей не содержит команд.

Форма открывается у адресата

Пользователь целевой роли в нужном приложении Паруса видит именно эту форму.

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

План предупреждает, что в приёмнике нет роли или пользователя Паруса

Для роли есть два пути — создать её в Парусе приёмника или задать пару в «Соответствии ролей Паруса». Для пользователя пути замены нет; заведите учётную запись в приёмнике. После этого постройте план заново.

Форма перенесена, но пользователь её не получает

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

Задали соответствие, а роль в назначении не изменилась

Пара добавлена в блок «Соответствие ролей» вместо «Соответствие ролей Паруса» либо имя роли отличается регистром. Исправьте пару и постройте план заново.

После загрузки старого пакета назначения в приёмнике остались прежними

Если в файле пакета нет сведений о назначениях, существующие назначения и связи приёмника сохраняются. Чтобы перенести их, выгрузите форму из источника заново. Явно пустой список в файле, наоборот, снимает все назначения формы.

Изменение формы отклонено из-за языка обработчиков

Парус позволяет задать язык обработчиков формы один раз. Его смена или сброс у существующей формы отклоняется целиком, вместе с остальными изменениями этой формы; план предупреждает об этом заранее. Holkas форму не пересоздаёт — подготовьте новую форму с нужным языком и перенесите на неё назначения.