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

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

Перенести пользовательское приложение с действиями

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

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

    Файл, действия и подключения

  2. 02
    План

    Текст скрипта и команды частей

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

    Права и запуск из раздела

Пример выполнен на двух учебных базах PostgreSQL. Приложение HKSiteV30App с коротким скриптом DelphiScript и действием OPEN создано в приёмнике; файл и описание сверены запросом к обеим базам, повторный план пустой. Запуск программы в клиенте Паруса в примере не проверялся.

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

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

В Holkas это тип «Пользовательское приложение» (UAP). В учебном примере у приложения HKSiteV30App короткий скрипт без бизнес-логики и одно действие OPEN — этого достаточно, чтобы пройти весь путь. Рабочая программа после переноса требует проверки поведения в клиенте Паруса.

UAP

HKSiteV30App

Пользовательское приложение — код, название, тип программы и сам файл скрипта.

UAP.Action

OPEN

Действие приложения. Именно код действия указывают в кнопке формы.

Парус

Права и запуск

В перенос не входят. Настраиваются и проверяются в приёмнике.

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

  • 01

    Приложение готово в источнике

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

  • 02

    Окружение программы в приёмнике

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

  • 03

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

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

  • 04

    Доступ в Парус приёмника

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

Выберите пользовательское приложение

Откройте «Перенести», задайте источник и приёмник. На шаге «Объекты» во вкладке «Каталог» найдите приложение среди объектов типа «Пользовательское приложение». Другой путь — вкладка «Вручную». Выберите этот тип, введите код HKSiteV30App и нажмите «Добавить». Заполните «Основание».

В списке типов есть похожее название «Приложение» (APP) — это рабочее место Паруса с его меню. Программа с действиями — «Пользовательское приложение» (UAP). Они не взаимозаменяемы: сверьте тип и код.

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

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

Блок «Программа» в команде создания пользовательского приложения HKSiteV30App
Текст учебного скрипта begin end. в плане. Это проверка переноса файла, а не его запуска в клиенте.

Файл сравнивается побайтно и записывается без перекодировки. Библиотеки XLA и COM текстом не показываются — для них сверяйте сохранённые имя, размер и дату файла. В учебном приложении только скрипт и действие OPEN; у вашего состав будет своим.

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

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

Исполненный план — пользовательское приложение HKSiteV30App и действие приложения OPEN
Приложение и его действие перенесены отдельными командами.

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

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

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

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

Программа в приёмнике

Команды приложения и его частей исполнены, повторный план пустой.

Права выданы

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

Действие запускается

Программа вызвана из раздела или формы в рабочем клиенте, параметры дошли.

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

Кнопка формы не запускает программу

В кнопке указан код действия, например OPEN, а не код приложения. Действие должно быть подключено к разделу этой формы. Если приложение и форма идут одним переносом, форма записывается после подключения. Если приложение в перенос не вошло, прочитайте предупреждения плана и включите его. Как дополнить состав.

Перенос прошёл, но пользователь не видит действие

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

В плане изменение приложения, хотя текст не меняли

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

После переноса в приёмнике пропало действие или подключение

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

Подключение к разделу отклонено

Раздел подключения должен существовать в приёмнике. Включите его класс в тот же перенос или подготовьте заранее.

Программа написана под другую СУБД или использует COM

Между Oracle и PostgreSQL файл не переводится — если программа обращается к конкретной базе, проверьте её отдельно. Идентификатор COM и байты библиотеки не устанавливают компонент на компьютерах пользователей.