Формирование "CardPackage" и "SqlPackage"

На этапе установки решения, в Docsvision могут быть импортированы определённые данные, например: данные справочников, карточки и бизнес-процессы, для чего должен быть подготовлен специальный пакет — CardPackage, содержащий файлы с данными карточек и т.д., а также файл со ссылками на эти файлы.

Один из сценариев использования пакета CardPackage — настроить разметку своего типа карточки в Конструкторе разметок, после чего выгрузить эту разметку и распространить её с пакетом установки на целевые сервера Docsvision. Аналогично можно поступить с Конструктором состояний и Конструктором ролей.

Файлы пакета CardPackage расположены в подкаталоге CardPackage приложенного архива.

Все действия, связанные с формированием пакетов CardPackage и SqlPackage, должны выполняться на отдельном сервере Docsvision.

Предварительная подготовка

Прежде всего необходимо загрузить библиотеку карточек в базу данных Docsvision (см. раздел Загрузка схем карточек в базу данных), а также разместить на клиенте компоненты карточки и библиотеки карточек.

Компонент карточки на данном этапе достаточно разместить в каталоге Docsvision Windows-клиент.

Компонент библиотеки карточек должен быть зарегистрирован командой: regsvr32.exe Полный-путь-к-сборке, к примеру, regsvr32.exe NetstatSolutionCardLib.dll.

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

Формирование данных

Когда в Docsvision был загружен новый тип карточки, настраиваем его при помощи конструкторов, заполняем справочник, если решение его содержит, первоначальными данными, создаем необходимые бизнес-процессы и карточки.

Тип "Карточка учета сетевого оборудования" была настроен с использованием:

  • Конструктора разметок — создана разметка с привязкой к данным карточки.

  • Конструктора состояний — добавлено начальное состояние.

  • Конструктора ролей — добавлены типовые права на работу с карточкой.

Также были внесены изменения (создан корневой вид карточки) в Справочник видов карточек.

Дополнительно был сформирован пустой (реализация бизнес-процесса выходит за рамки примера) бизнес-процесс "Проверка доступности сетевых узлов", а также экземпляр карточки учета сетевого оборудования.

Все эти данные предполагается автоматически загружать в Docsvision при установке решения.

Выгрузка данных

Сформированные данные необходимо выгрузить из Docsvision в формате XML, т.к. при установке решения они просто импортируются средствами платформы.

Карточки (включая бизнес-процессы) экспортируются стандартными средствами Docsvision Windows-клиент.

Также возможно выгрузить данные из справочников и конструкторов.

Создание "CardPackage"

Чтобы закончить формирование пакета CardPackage, требуется создать файл CardPackage.xml следующего формата:

<?xml version="1.0" encoding="UTF-8"?>
<CardPackage>
 <Card Path="относительный_путь_к_файлу_XML" ID="ID_карточки" Replace=""/> (1)
 …
</CardPackage>

Replace="1" если карточка должна заменить существующую, 0 — если дополнить.

Создание "SqlPackage"

Готовый файл (NetstatSolutionInstall.xml) пакета "SqlPackage" содержится в каталоге Database приложенного архива.

Помимо CardPackage, для пакета установки решения требуется создать пакет SqlPackage, состоящий из единственного файла, в котором указано расположение файлов со схемами метаданных библиотек карточек. Файл должен быть загружен в базу данных при установке решения.

"CardPackage" должен соответствовать формату:
<?xml version="1.0" encoding="UTF-8"?>
<SqlPackage>
 <SqlFile>"относительный_путь_к_файлу_XML"</SqlFile>
 ...
</SqlPackage>

Как правило SqlPackage содержит одну единственную ссылку на файл со схемой библиотеки карточек.