Публикация и загрузка в Servigistics InService > Дополнительная информация > Настройка TAL > Настройка опций доступа
  
Настройка опций доступа
Чтобы применять управление доступом к дополнительным атрибутам и более эффективно управлять фильтрацией доступа к содержимому, необходимо выполнить три следующих действия настройки.
• Добавление опций и вариантов с помощью файла OptionsDefinition
• Использование применимости опций доступа для данных, которые фильтруются с помощью файла FilterDefinition-Mapping
• Загрузка опции доступа, которая подходит для фильтрации.
Каждый из этих шагов рассматривается в отдельном разделе.
Дополнения для файла OptionsDefinition
Этот файл в пакете содержит список всех опций и соответствующих вариантов, которые доступны и поддерживаются в системе. Пользователь может добавить дополнительные или удалить существующие опции (и связанные варианты). Вообще говоря, один элемент Option может содержать один или несколько элементов Choice.
Ниже представлена запись в этом файле:

<OptionSet container="OR:wt.pdmlink.PDMLinkProduct:115636" label="OptionSet" token="_oset4562692">
<Option label="Release" token="_opt4318852">
<Name>Release</Name>
<Choice label="postRelease" token="_ch4318861">
<Name>postRelease</Name>
</Choice>
<Choice label="preRelease" token="_ch4318862">
<Name>preRelease</Name>is
</Choice>
</Option>
</OptionSet>
* 
Наименование Option и наименование Choice можно локализовать с помощью файла translation.xml
В этой таблице представлены сведения об использовании и предназначении элементов и соответствующих атрибутов.
Имя свойства
Тип
Назначение
OptionSet
Элемент
Местозаполнитель с несколькими элементами Option
Option
Элемент
Местозаполнитель с несколькими элементами Choice
Choice
Элемент
Местозаполнитель для вариантов, разрешенных для данной опции
token
Атрибут
Используется для поиска перевода на другой язык в файле translation.xml.
label
Атрибут
Наименование добавляемой опции.
Name
Элемент
Наименование добавляемой Option или Choice.
Применение применимости с помощью файла FilterDefinition-Mapping
Описанные в вышеприведенном разделе опции с соответствующими вариантами используются в файле FilterDefinition-Mapping.xml для ограничения доступа к некоторым данным посредством их применения к этим данным в ходе выполнения процесса TAL. Файл сопоставления определения фильтра используется для применения применимости опций доступа к конкретным данным, определяемым по XPATH и типу объекта.
Это конфигурируемый файл сопоставления, который хранится в структуре папок INSERVICE_HOME/InS_SW/Config/System/Config. Этот файл можно обновлять для контроля или применения применимости для конкретных данных пакета в ходе выполнения процесса TAL.
Ниже представлен пример этого файла:

<?xml version="1.0" encoding="UTF-8"?>
<FilterDefinitions>
<FilterDefinition type="IS" xmd="false">
FilterProperty label="Color" xpath="metadata[@id='PartList_4119316']/data[@name='Color']" delimiter=","/>
<FilterProperty label="number" xpath="metadata[@id='EPMDocument_4336801']/data[@name='number']" delimiter=","/>
<FilterProperty label="number" xpath="metadata[@id='EPMDocument_2042453']/data[@name='number']" delimiter=","/>
<FilterProperty label="Color" xpath="metadata[@id='EPMDocument_2053239']/data[@name='Color']" delimiter=","/>
</FilterDefinition>
<!--At entire document level -->
<FilterDefinition type="PDFM" xmd="true">
<!--For a specific pdf. -->
<FilterProperty label="number" xpath="Metadata[@id='EPMDocument_4336801']/Property[@token='number']/Value" delimiter=" "/>
<!--For every pdf. -->
<FilterProperty label="number" xpath="Metadata/Property[@token='number']/Value" delimiter=" "/>
</FilterDefinition>
<FilterDefinition type="IEXML" xmd="true">
<!--For a specific xml. -->
<FilterProperty label="number" xpath="Metadata[@id='EPMDocument_2042453']/Property[@token='number']/Value" delimiter=" "/>
<!--For every xml. -->
<FilterProperty label="number" xpath="Metadata/Property[@token='number']/Value" delimiter=" "/>
</FilterDefinition>
<FilterDefinition type="PARTSLIST" xmd="true">
<FilterProperty label="Color" xpath="Metadata[@id='PartList_4119316']/Property[@token='Color']/Value" delimiter=","/>
</FilterDefinition>
<FilterDefinition type="GRAPHIC" xmd="true">
<FilterProperty label="Color" xpath="Metadata[@id='EPMDocument_2053239']/Property[@token='Color']/Value" delimiter=" "/>
</FilterDefinition>
<!--For inline applicability. -->
<FilterDefinition type="IEXML" xmd="false">
<FilterProperty label="role" xpath="*[@applic_role]/@applic_role" delimiter=" "/>
</FilterDefinition>
<FilterDefinition type="PARTSLIST" xmd="false">
<FilterProperty label="DriveType" xpath="Metadata[@id='PartListItem_4119324']/Property[@token='DriveType']/Value" delimiter=","/>
</FilterDefinition>
<FilterDefinition type="PRT" xmd="false">
<FilterProperty label="Color" xpath="Metadata[@id='WTPart_3443834']/Property[@token='Color']/Value" delimiter=","/>
</FilterDefinition>
<!--For 3rd Party Bundle-->
<FilterDefinition type="KIT2PRT" xmd="false">
</FilterDefinition>
<FilterDefinition type="KIT2PRTLST" xmd="false">
</FilterDefinition>
<FilterDefinition type="PH" xmd="false">
</FilterDefinition>
<FilterDefinition type="PX" xmd="false">
</FilterDefinition>
</FilterDefinitions>
Один элемент FilterDefinitions содержит несколько элементов FilterDefinition, каждый из которых специфичен для конкретного типа пакета и его использования.
В этой таблице представлены сведения об использовании и предназначении элементов и соответствующих атрибутов.
Имя свойства
Тип
Назначение
FilterDefinition
Элемент
Этот элемент специфичен для конкретного типа пакета и его использования.
type
Атрибут
Определяет тип пакета, для которого применимо данное FilterDefinition.
Допустимые значения: IS, PARTSLIST, GRAPHIC, PDFM и IEXML.
xmd
Атрибут
Определяет, должна ли применимость применяться для конкретного узла или всего документа.
Если установлено значение true, применимость применима для всего документа.
Если установлено значение false, применимость применима для конкретного узла.
FilterProperty
Элемент
Определяет применяемое свойство фильтра.
label
Атрибут
Определяет наименование применяемой применимости.
Примеры: "Цвет", "Регион", "Источник" и т. д.
xpath
Атрибут
Выражение XPATH для элемента данных пакета, для которого применяется применимость.
Пример 1:

Metadata[@id='EPMDocument_1678511']
/Property[@token='Region']
/Value
Это означает поиск данных, содержащихся в элементе с наименованием Value под элементом с наименованием Property с атрибутом token со значением Region под элементом с наименованием Metadata с атрибутом id со значением EPMDocument_1678511.
Пример 2:

*[@applic_Region]/@applic_Region
Это означает поиск данных, содержащихся в атрибуте с наименованием applic_Region для любого элемента.
Пример 3:

Metadata[@id='EPMDocument_8978311']
/Property[@token='name']
/Value/@xml:lang
Это означает поиск данных, содержащихся в атрибуте с наименованием xml:lang для элемента с наименованием Value под элементом с наименованием Property с атрибутом token со значением name под элементом с наименованием Metadata с атрибутом id со значением EPMDocument_8978311.
Пример 4:

Metadata/Property[@token='Region']
/Value
Это означает поиск данных, содержащихся в элементе с наименованием Value под элементом с наименованием Property с атрибутом token со значением Region под элементом с наименованием Metadata.
delimiter
Атрибут
Разделитель используется для разделения значений в тех случаях, когда для элемента существует несколько значений.
Примеры: запятая, двоеточие, пробел и т. д.
Загрузки опции доступа в систему
Некоторые или все из доступных в системе опций с соответствующими вариантами можно использовать для ограничения доступа для определенных пользователей.
Для этого нужно загрузить список поднабора опций и вариантов в качестве опций доступа и допустимых опций с помощью загрузчика Windchill. Файл загрузки содержит список допустимых опций с соответствующими типами.
Создайте XML-файл с наименованиями и типами опций и поместите его в следующее расположение: INSERVICE_HOME/InS_SW/SW/Applications/Windchill.ear/loadXMLFiles/servicecenter. Пример: SCAccessOption.xml.
Выполните следующую команду в оболочке Windchill:
windchill wt.load.LoadFromFile -u wcadmin -p wcadmin -d loadXMLFiles/servicecenter/SCAccessOption.xml
Ниже представлен пример этого файла:
<? xml version="1.0"?>
<! DOCTYPE InSObjects SYSTEM "standardX26.dtd">
<InSObjects>
<SCAccessOption>
<accessOptionLabel>Source</accessOptionLabel>
<accessOptionType>IE</accessOptionType>
</SCAccessOption>
<SCAccessOption>
<accessOptionLabel>Region</accessOptionLabel>
<accessOptionType>IE</accessOptionType>
</SCAccessOption>
</InSObjects>
В этой таблице представлены сведения об использовании и предназначении элементов.
Имя свойства
Тип
Назначение
SCAccessOption
Элемент
Местозаполнитель для определения одной опции AccessOption
accessOptionLabel
Элемент
Наименование опции
accessOptionType
Элемент
Тип опции
* 
В настоящее время поддерживается только тип IE.