Servigistics InService のパブリッシングおよびロード > 追加情報 > TAL のカスタマイズ > アクセスオプションのカスタマイズ
  
アクセスオプションのカスタマイズ
追加の属性にアクセス制御を適用してコンテンツのアクセスフィルタをさらに自在に制御するには、次の 3 つのカスタマイズを行う必要があります。
OptionsDefinition ファイルを使用してオプションと選択肢を追加
FilterDefinition-Mapping ファイルを使用してフィルタリングするデータに対するアクセスオプションの適用性を設定
フィルタリングに有効なアクセスオプションのロード
これらの各手順について、個別のセクションで説明します。
OptionsDefinition ファイルへの追加
これは、システムで使用可能なサポートされているすべてのオプションとその対応する選択肢がリストされた、バンドル内のファイルです。既存のオプション (および関連する選択肢) をさらに追加したり、除去したりできます。一般に、1 つの Option エレメントに 1 つまたは複数の 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_ホーム/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>
1 つの FilterDefinitions エレメントには、各エレメントが特定のバンドルタイプとその親子関係に固有の、複数の FilterDefinition エレメントが含まれます。
次の表に、エレメントおよびその属性の使用方法と目的を示します。
プロパティ名
タイプ
目的
FilterDefinition
エレメント
このエレメントは、特定のバンドルタイプおよびその親子関係に特有のものです。
type
属性
指定した FilterDefinition が適用可能なバンドルタイプを指定します。
使用できる値は、IS、PARTSLIST、GRAPHIC、PDFM、および IEXML です。
xmd
属性
特定のノードに適用性を設定するか、文書全体に設定するかを指定します。
true の場合、ドキュメント全体に適用性が設定されます。
false の場合、特定のノードに適用性が設定されます。
FilterProperty
エレメント
適用するフィルタプロパティを指定します。
label
属性
設定されている適用性の名前を指定します。
例: Color、Region、Source など。
xpath
属性
適用性が設定されているバンドルデータエレメントへの XPATH 定義式。
例 1:

Metadata[@id='EPMDocument_1678511']
/Property[@token='Region']
/Value
これは、id 属性が EPMDocument_1678511 である Metadata という名前のエレメントの下で、token 属性が Region である Property という名前のエレメントの下にある Value という名前のエレメントに存在するデータを探すことを意味します。
例 2:

*[@applic_Region]/@applic_Region
これは、任意のエレメントの applic_Region という名前の属性に存在するデータを探すことを意味します。
例 3:

Metadata[@id='EPMDocument_8978311']
/Property[@token='name']
/Value/@xml:lang
これは、id 属性が EPMDocument_8978311 である Metadata という名前のエレメントの下で、Value という名前のエレメントの xml:lang という名前の属性に存在するデータを探すことを意味します。このエレメントは、token 属性が name である Property という名前のエレメントの下にあります。
例 4:

Metadata/Property[@token='Region']
/Value
これは、Metadata という名前のエレメントの下で、token 属性が Region である Property という名前のエレメントの下にある Value という名前のエレメントに存在するデータを探すことを意味します。
delimiter
属性
そのエレメントに複数の値が存在する場合に値を区切るために使用する区切り記号。
例: コンマ、コロン、スペースなど。
システムへのロードアクセスオプション
システムで使用可能なすべてのオプションとその選択肢のうち、一部またはすべてを使用して、ユーザーのアクセスを制限できます。
そのためには、アクセスオプションとしてのオプションと選択肢のサブセットと、Windchill ローダーを使用してロードされる有効なオプションをリストします。ロードするファイルには、有効なオプションとそのタイプのリストが含まれています。
オプションの名前とそのタイプを含む XML ファイルを作成して、INSERVICE_ホーム/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
エレメント
1 つの AccessOption を定義するプレースホルダー
accessOptionLabel
エレメント
オプションの名前
accessOptionType
エレメント
オプションのタイプ
* 
現在サポートされている唯一のタイプは、IE です。