Компонент VLIntegrator предназначен для управления обменом данными между пользовательской базой данных системы ЛОЦМАН:PLM и файлом документа, зарегистрированным в той же базе данных. Непосредственно связан с компонентом VLDocFilePanel, привязан к типу документа. При наступлении любого из событий головного компонента (OnInsert - создать документ, OnOpen - открыть документ, OnGetInfo - получить информацию из документа) загружает соответствующий список предустановленных администратором VL-проекта процедур. Как правило в состав данного списка входят процедуры ExportXML (процедура экспорта информации во временный файл формата XML), ImportXML (процедура импорта информации из файла XML в базу данных) и UserAction (пользовательская процедура - EXE модуль, написанный пользователем и производящий заполнение документа атрибутами из временного XML файла). Таким образом администратор VL-проекта может зарегистрировать в пользовательской базе данных любое количество типов документов, создать для них предустановленные шаблоны и зарегистрировать в базе данных VL-проекта соответствующие модули интеграции.
Для редактирования свойств интегратора используется специальное окно конфигуратора, которое содержит две закладки:
|
Атрибуты - для редактирования доступен лишь один атрибут:
|
||||||
|
События - содержит конфигуратор событий и базовых процедур для компонента (См. подробнее Конфигуратор событий и базовых процедур). Здесь пользователь-администратор VL-проекта может назначить три события:
|
Для событий OnInsert и OnOpen рекомендуется использовать следующий порядок загрузки процедур:
| • | При возникновении указанных событий уникальные идентификаторы объекта базы данных, выбранного документа и имя выбранного файла помещается в системный буфер; |
| • | ExportXML - экспортировать информацию из пользовательской базы данных в указанный файл формата XML, в зависимости от настроек, указанная процедура позволяет: |
| 1. | экспортировать системные и пользовательские атрибуты текущего документа (информация берется из системного буфера Visual Loodsman, а помещается туда автоматически компонентом VLDocFilePanel); |
| 2. | экспортировать полное имя выбранного файла документа (информация также берется из системного буфера Visual Loodsman, а помещается туда автоматически компонентом VLDocFilePanel); |
| 3. | экспортировать системные и пользовательские атрибуты объекта пользовательской базы данных (информация берется из системного буфера Visual Loodsman, а помещается туда процедурой GetId); |
| 4. | экспортировать таблицу системных и пользовательских атрибутов объектов, подчиненных головному объекту (полученному процедурой GetId) по установленной в процедуре связи с предустановленными фильтром; |
| • | UserAction - процедура (EXE файл зарегистрированный в базе данных VL-проекта), написанная пользователем-администратором VL- проекта для передачи информации из XML файла в файл документа, используя интерфейс соответствующего редактора. |
Для события OnGetInfo рекомендуется использовать следующий порядок загрузки процедур:
| • | При возникновении указанного события уникальные идентификаторы объекта базы данных, выбранного документа и имя выбранного файла помещается в системный буфер; |
| • | ExportXML - экспортировать информацию из пользовательской базы данных в указанный файл формата XML, в зависимости от настроек, указанная процедура позволяет: |
| 1. | экспортировать системные и пользовательские атрибуты текущего документа (информация берется из системного буфера Visual Loodsman, а помещается туда автоматически компонентом VLDocFilePanel); |
| 2. | экспортировать полное имя выбранного файла документа (информация также берется из системного буфера Visual Loodsman, а помещается туда автоматически компонентом VLDocFilePanel); |
| 3. | экспортировать системные и пользовательские атрибуты объекта пользовательской базы данных (информация берется из системного буфера Visual Loodsman, а помещается туда процедурой GetId); |
| • | UserAction - процедура (EXE файл зарегистрированный в базе данных VL-проекта), написанная пользователем-администратором VL- проекта для передачи информации из файла документа в XML файл, используя интерфейс соответствующего редактора; |
| • | ImportXML - процедура импорта информации из XML файла в базу данных ЛОЦМАН:PLM, в зависимости от настроек указанная процедура позволяет: |
| 1. | импортировать системные и пользовательские атрибуты головного объекта пользовательской базы данных; |
| 2. | импортировать системные и пользовательские атрибуты объектов подчиненных головному по указанной в процедуре связи. |
Кроме указанных выше базовых процедур в системе Visual Loodsman представлены, так называемые, базовые процедуры-интеграторы (см. Базовые процедуры-интеграторы). Данные процедуры специально разработаны для передачи информации из пользовательской базы данных в различные документы, созданные с помощью сторонних редакторов (например текстовых документов OpenOffice Writer).
|
В контекстном меню таблицы процедур конфигуратора компонента VLIntegrator присутствует пункт Создать интегратор (см. рисунок слева). Указанный пункт меню загружает на экран подменю базовых процедур-интеграторов (см. ниже). С помощью данного подменю в список процедур события компонента VLIntegrator можно установить базовую процедуру-интегратор.
|
||
|
Подменю базовых процедур-интеграторов, где:
|
