VLIntegrator

Top  Previous  Next

VLIntegrator200        Компонент VLIntegrator предназначен для управления обменом данными между пользовательской базой данных системы ЛОЦМАН:PLM и файлом документа, зарегистрированным в той же базе данных. Непосредственно связан с компонентом VLDocFilePanel, привязан к типу документа. При наступлении любого из событий головного компонента (OnInsert - создать документ, OnOpen - открыть документ, OnGetInfo - получить информацию из документа) загружает соответствующий список предустановленных администратором VL-проекта процедур. Как правило в состав данного списка входят процедуры ExportXML (процедура экспорта информации во временный файл формата XML), ImportXML (процедура импорта информации из файла XML в базу данных) и UserAction (пользовательская процедура - EXE модуль, написанный пользователем и производящий заполнение документа атрибутами из временного XML файла). Таким образом администратор VL-проекта может зарегистрировать в пользовательской базе данных любое количество типов документов, создать для них предустановленные шаблоны и зарегистрировать в базе данных VL-проекта соответствующие модули интеграции.

       Для редактирования свойств интегратора используется специальное окно конфигуратора, которое содержит две закладки:

 

VLIntegratorConfig

Атрибуты - для редактирования доступен лишь один атрибут:

Тип документа - тип документа зарегистрированного в пользовательской базе данных, для которого создан данный интегратор.


VLIntegratorConfigEventsActions

События - содержит конфигуратор событий и базовых процедур для компонента (См. подробнее Конфигуратор событий и базовых процедур). Здесь пользователь-администратор VL-проекта может назначить три  события:

OnInsert - данное событие возникает при создании нового файла документа;
OnOpen - данное событие возникает при открытии зарегистрированного в пользовательской базе данных файла документа;
OnGetInfo - данное событие используется для получения данных из файла документа и передаче их в пользовательскую базу данных.

 

 

 

Для событий 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).

 

clip0092

В контекстном меню таблицы процедур конфигуратора компонента VLIntegrator присутствует пункт Создать интегратор (см. рисунок слева). Указанный пункт меню загружает на экран подменю базовых процедур-интеграторов (см. ниже). С помощью данного подменю в список процедур события компонента VLIntegrator можно установить базовую процедуру-интегратор.

 



clip0093

Подменю базовых процедур-интеграторов, где:

OpenOfficeToWriter - процедура-интегратор, позволяющая загрузить информацию из пользовательской базы данных в текстовый документ OpenOffice Writer.