Настройка правила экспорта

Настройка правила экспорта – создание модели выгружаемых данных на основе метаданных базы данных ЛОЦМАН:PLM. Способы формирования модели:

•через интерфейс Модуля управления Интеграционной шиной предприятия;

•путем расширения функционала ИШП предварительно созданными на SQL-сервере процедурами; в этом случае набор данных, возвращаемых такими SQL-процедурами, должен иметь обязательные поля, используемые ИПШ для формирования файлов с выгружаемыми данными, и позволяющими расширять возможности формирования модели данных без нарушения логики работы модуля интеграции;

•путем подключения внешних библиотек и их последующей настройки через окно настройка правила экспорта.

Настройка правила экспорта через интерфейс Модуля управления Интеграционной шиной предприятия заключается в формировании дерева выгружаемых сущностей с указанием типов выгружаемых объектов и документов, их выгружаемых атрибутов и состояний. Экспортироваться могут также данных о структурах и применяемости.

Чтобы настроить ранее созданное правило экспорта, выполните следующие действия.

1.В Каталоге правил укажите правило экспорта, которое нужно настроить.

2.Вызовите из контекстного меню команду Открыть правило экспорта.

•Если для правила экспорта не введено значение атрибута База данных (не указана база данных, из которой будет осуществляться экспорт данных), появится сообщение о необходимости ввода этого значения.

•Если для правила экспорта не введено значение атрибута Маска файла (не задана маска XML-файлов с выгружаемыми данными), откроется сообщение с предложением использовать маску по умолчанию. Нажмите кнопку Да, чтобы согласиться. Нажмите кнопку Нет, чтобы продолжить без маски.

•Если для правила экспорта не введено значение атрибута Путь (не указана папка, в которую будут выгружаться файлы с экспортируемыми данными, созданные в соответствии с правилом экспорта), откроется сообщение с предложением указать папку для экспорта данных. Нажмите кнопку Да, чтобы указать папку в стандартном окне Windows Обзор папок. Нажмите кнопку Нет, чтобы продолжить без указания папки.

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

Команды главного меню окна настройки правила экспорта


	Название	Назначение

	Группа «Правило»
	Сохранить	Сохранение открытого правила в файле формата XML
	Открыть	Открытие файла формата XML для загрузки информации в окно настройки правила экспорта
	Добавить	Добавление в правило корневого элемента. Корневой элемент в правиле может быть только один
	Экспорт	Запуск правила экспорта
	Опции	Выбор опций правила экспорта
	Группа «Параметры экспорта»
	Фрагментарная выгрузка	Выгружать данные во множество XML-файлов, каждый из которых содержит информацию только об одном выгружаемом объекте ЛОЦМАН:PLM, в том числе, о его связях на один уровень вложенности
	Новые	При фрагментарной выгрузке данных не останавливаться на шаге, где результат содержит ранее экспортированные объекты, а продолжать формировать XML-файлы
	Выгружать устаревшие	•Опция выключена – выгружать объекты по этому правилу только один раз (не выгружать объекты, которые уже выгружались по этому правилу, но с тех пор не изменились, т. н. «устаревшие» объекты). •Опция включена – выгружать объекты, соответствующие правилу, с каждым срабатыванием правила, даже если они раньше выгружались по этому правилу
	Настройки	Настройка выгрузки устаревших объектов
	Группа «Сохранение»
	Путь
	Файл	Имя файла, в который будут выгружены данные. Если маска файла задана при создании правила, она подставляется в данное поле автоматически
	Схема	Зарезервировано на развитие функционала
	Группа «Справка»
	Справка	Вызов справочной системы

Сразу после создания правила окно может содержать только параметры, которые были заданы в окне Создание правила экспорта или в окне Интеграционная шина предприятия. Это параметры, представленные в главном меню окна в группах Параметры экспорта, Опции, Сохранение. Все области окна пусты.

Чтобы сформировать модель передаваемых данных – настроить правило экспорта – нужно:

•либо открыть существующее правило из ранее сохраненного файла при помощи команды Открыть;

•либо создать новую модель, воспользовавшись командой Добавить.

В окне Настройка правила экспорта вы будете оперировать метаданными той базы данных ЛОЦМАН:PLM, которая указана при создании правила или при редактировании его свойств в окне Интеграционная шина предприятия.

В области Структура данных отображается дерево правила экспорта – структура выгружаемых данных в виде иерархического списка типов объектов. Дерево правила может иметь только один корневой элемент. С него начинается будет начинаться выбор данных из базы данных ЛОЦМАН:PLM. В дерево по связям, определенным в конфигурации базы данных, могут входить типы объектов и документов ЛОЦМАН:PLM. Для каждого элемента дерева создается свой набор условий выгрузки – определяются связанные объекты, их состояния для выгрузки, указываются атрибуты, которые будут выгружаться.

Если для корневого объекта указан ключевой атрибут – правило будет работать только в контексте этого объекта. Если ключевой атрибут не указан – в контексте всех объектов такого типа, находящихся в состоянии, указанном в области Состояния.

Объекты, входящие в дерево правила экспорта, в служебной базе данных имеют тип Тип Лоцман.

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


	Название	Назначение

	Группа «Атрибуты служебные»
	Тип	Тип объектов, соответствующий выбранному элементу дерева правила в служебной базе данных
	Уровень доступа	Уровень доступа к выбранному элементу дерева в служебной базе данных
	Создал	Пользователь служебной базы данных, добавивший элемент в дерево правила
	Дата создания	Дата создания выбранного элемента дерева правила
	Дата изменения	Дата изменения выбранного элемента дерева правила
	Группа «Атрибуты типа»
	GUID	Уникальный идентификатор выбранного объекта типа Тип Лоцман
	Выгружать как...	Зарезервировано для развития функционала
	Запуск библиотеки до	Момент запуска экспортной функции библиотеки-адаптера. Работает совместно с атрибутами Путь к библиотеке и Экспортная функция библиотеки. Если Запуск библиотеки до=Да, то указанная экспортная функция библиотеки-адаптера запустится после запуска правила экспорта в момент начала формирования в результирующем XML-файле тэга выбранного типа (в момент, когда тэг с атрибутами сформирован, но не сформирован ни один тэг потомков выбранного типа)
	Запуск библиотеки после	Момент запуска экспортной функции библиотеки-адаптера. Работает совместно с атрибутами Путь к библиотеке и Экспортная функция библиотеки. Если Запуск библиотеки после=Да, то указанная экспортная функция библиотеки-адаптера запустится после запуска правила экспорта в момент окончания формирования в результирующем XML-файле тэга выбранного типа (в момент, когда тэг с атрибутами сформирован, и полностью сформированы тэги потомков выбранного типа)
	Значение ключа	Значение ключевого атрибута выбранного в дереве правила объекта ЛОЦМАН:PLM. Если значение введено – выбор экспортируемых данных будет осуществляться только в контексте объекта ЛОЦМАН:PLM с таким значением ключевого атрибута. Если значение не введено – (пустое значение), то выборка объектов при экспорте не будет ограничена по ключевому атрибуту.
	Наименование типа	Тип объекта ЛОЦМАН:PLM, выбранного в дереве правила. Раскрывающийся список поля содержит наименования типов, которые, согласно конфигурации текущей базы данных ЛОЦМАН:PLM, могут быть связаны с объектом, являющимся для выбранного объекта родительским. Для корневого элемента дерева – это полный список типов объектов, зарегистрированных в текущей базе данных ЛОЦМАН:PLM
	Путь к библиотеке	Путь к файлу библиотеки-адаптера, которая будет запускаться после запуска правила экспорта до момента начала экспорта
	Типы выгружаемых файлов	Типы файлов, которые будут выгружаться из базы данных ЛОЦМАН:PLM вместе с документами рассматриваемого типа. Варианты значений: •пусто (значение атрибута не введено) – выгрузки файлов не будет; •* (звездочка) – с документом будут выгружены все файлы всех типов; •маска файлов – с документом будут выгружены файлы (например: .txt – будут выгружены файла с расширением txt, [??520] – будут выгружены все файлы, соответствующие маске, например: 00520Документ.doc, 11520.01.01.xls, 00520любые_символы В одном значении атрибута могут быть заданы несколько масок через запятую, например: .txt;.doc;*.xls. Если при выборе опций правила экспорта включена опция Не выгружать файлы – файлы не будут выгружены ни у одного документа
	Экспортная функция библиотеки	Наименование экспортной функции библиотеки-адаптера, которая будет выполняться после запуска правила экспорта до момента начала экспорта. Работает совместно с атрибутом Путь к библиотеке
	Группа «Атрибуты связи» (отображается для потомков корневого типа)
	Наименование связи	Тип связи между выбранным в дереве объектом ЛОЦМАН:PLM и его родительским объектом. По этой связи будут отыскиваться потомки вышестоящего типа для включения в результирующий XML-файл. Раскрывающийся список поля содержит наименования типов связи, которыми, согласно конфигурации текущей базы данных ЛОЦМАН:PLM, выбранный в дереве тип может быть связан со своим родительским объектом
	Рекурсивная выгрузка типа	Если Рекурсивная выгрузка=Да, все объекты, типы которых совпадают с родительским, будут выгружены по правилу родительского типа. Если типы родительского объекта и объекта-потомка различаются, данная опция будет проигнорирована. Распространяется только на случаи, когда одноименные типы входят в друг друга.

Свойства, которые находятся в группе Атрибуты служебные, приводятся для справки.

Свойства, которые находятся в группах Атрибуты типа и Атрибуты связи, можно редактировать:

•вводить и изменять значения в режиме текстового редактора (GUID, Значение ключа, Путь к библиотеке, Экспортная функция библиотеки);

•выбирать из раскрывающегося списка (Запуск библиотеки до, Запуск библиотеки после, Наименование типа, Наименование связи, Рекурсивная выгрузка типа).

Используя свойства Наименование типа и Наименования связи, можно вносить точечные изменения в дерево правила экспорта. Но при этом нужно помнить, что после изменения типа объекта в дереве тип его связи с родительским объектом не поменяется автоматически – связь нужно будет выбрать из раскрывающегося списка поля Наименование связи. Список содержит только те связи, которые, согласно конфигурации текущей базы данных ЛОЦМАН:PLM, могут соединить текущий объект с родительским. Также потребуется визуальный контроль возможности установки и, при необходимости, изменения связи объекта, тип которого был изменен, с потомками.

В области Состояния показан список состояний, в которых, согласно конфигурации базы данных, может находиться выбранный в дереве правила выгружаемый объект. Здесь осуществляется выбор состояний, в которых должен находиться объект, чтобы его можно было выгрузить.

•фильтрация по состояниям при помощи инструмента

Фильтр;

•выбор всех состояний и сброс флажков со всех состояний при помощи команд контекстного меню списка Отметить все и Снять отметки.

В области Применяемость для типа объектов, выбранного в дереве правила, показан список типов применяемости, которые, согласно конфигурации базы данных, могут определять условия присутствия версий объектов этого типа в динамической структуре изделия. Поскольку в ЛОЦМАН:PLM применяемость может задаваться для версий, для связей и для абсолютных связей, список имеет три корневых узла:

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

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

Для списка типов применяемости доступна фильтрация по наименованию при помощи инструмента Фильтр

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

дерево правила экспорта в контекст выбранного элемента, формируя тем самым структуру выгружаемых данных.

•фильтрация по наименованию и по типу связи при помощи инструмента Фильтр;

•выбор всех пар Тип – Связь и сброс флажков со всех пар при помощи команд контекстного меню списка Отметить все и Снять отметки.

В области Атрибуты для типа объектов, выбранного в дереве правила, показан список атрибутов, сопоставленных ему в конфигурации базы данных. Эти атрибуты могут выгружаться с объектом рассматриваемого типа.

Наряду с атрибутами объектами ЛОЦМАН:PLM списке могут присутствовать системные атрибуты, необходимые для передачи данных.


	Название	Описание

	_Product	Ключевой атрибут объекта. Ключевым атрибутом в конфигурации ЛОЦМАН: PLM может быть назначен любой атрибут. У каждого типа ключевым может быть назначен свой собственный атрибут. Атрибут, который назначен ключевым невозможно заполнять, используя ЛОЦМАН Клиент
	_Type	Наименование типа объектов ЛОЦМАН: PLM
	_Version	Значение версии объекта ЛОЦМАН: PLM. Неверсионные типы получают при выгрузке значение "" (пусто).
	_State	Наименование состояния объекта ЛОЦМАН: PLM
	_Link	Наименование связи между объекта ЛОЦМАН: PLM
	_dtModified	Системная дата изменения объекта ЛОЦМАН: PLM. Пользователь может самостоятельно создать в метаданных атрибут Дата изменения, который может быть редактируемым, но не содержать значения требуемого свойства
	_Id_Version	Идентификатор версии объекта ЛОЦМАН: PLM. Не может быть изменен с использованием ЛОЦМАН Клиент
	_MIN_QUANTITY	Значение минимального количества системного атрибута объектов, связанных количественной связью
	_MAX_QUANTITY	Значение максимального количества системного атрибута объектов, связанных количественной связью
	_BObjectLocation	Атрибут для передачи справочных объектов системы ЛОЦМАН:PLM. Может применяться по назначению только в рамках систем, использующих Комплекс решений АСКОН. С помощью этого атрибута можно быстро идентифицировать объекты в ПОЛИНОМ:MDM или в устаревших справочниках: УТС (Универсальный справочник технолога), МиС (Справочник материалов и сортаментов) и т.д.

Для каждого атрибута в режиме текстового редактора может быть задано значение:

•Выгружать как – наименование атрибута, которое заменит существующее наименование; используется:

•либо в случае возникновения требований с принимающей стороны к наименованию атрибутов;

•либо в случае, когда наименование атрибута содержит символы, нарушающие структуру выгружаемых данных; пробелы в наименовании атрибута автоматически заменяются знаком «_»;

•Значение по умолчанию – значение, которое автоматически будет присваиваться атрибуту, если значение экспортируемого атрибута не введено.

•фильтрация по любому из столбцов при помощи инструмента Фильтр;

•выбор всех атрибутов и сброс флажков со всех атрибутов при помощи команд контекстного меню списка Отметить все и Снять отметки.

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

Для каждого атрибута в режиме текстового редактора может быть задано значение Выгружать как – наименование атрибута, которое заменит существующее наименование.

Для списка атрибутов измеряемой сущности доступна фильтрация по любому из столбцов при помощи инструмента Фильтр.