プリファレンスの作成
プリファレンスは XML ロードファイルを使用して作成します。プリファレンスを作成するには、以下の情報を決定する必要があります。
• 一意のプリファレンス名
• 表示: プリファレンスがプリファレンスマネージャ UI で表示されるかどうかおよび、SITE, ORGANIZATION, CONTAINER または USER のどのコンテキストで表示されるか
◦ プリファレンスカテゴリ: 「プリファレンス管理」ユーティリティで新しいプリファレンスを表示するカテゴリ
◦ 表示名: 「プリファレンス管理」ユーティリティの「名前」列 - 文字列の形式: <RBINFO>:< RBINFO key>
◦ 説明: 「プリファレンス管理」ユーティリティの「説明」列 - 文字列の形式:
<RBINFO>:<RBINFO key>
◦ 長い説明: この説明は、予想される値を含む詳細説明で、編集プリファレンス UI に表示されます。
▪ 文字列の形式 <RBINFO>:<RBINFO key>
• デフォルト値
• 値ヘッダー
以下の例では、/com/mycompany/MyNewPreference という名前のプリファレンスを作成するとともに、プリファレンスマネージャ UI に表示する関連プリファレンスカテゴリを作成します。
1. 新しいプリファレンスに使用するラベルのリソースバンドルを作成します。ラベルは、「プリファレンス管理」UI に表示される新しいプリファレンスが所属するプリファレンスカテゴリの表示名と説明に必要です。また、プリファレンスの表示名、説明、長い説明についてもラベルが必要です。パッケージ com.mycompany.pref に mycompanyPreferenceResource.rbInfo ファイルを作成します。この例では、このファイルは <Windchill>/src/mycompany/pref ディレクトリに追加されます。
ResourceInfo.class=wt.tools.resource.StringResourceInfo
ResourceInfo.customizable=true
ResourceInfo.deprecated=false
# Preference Category labels
MyNewPreferenceCategory.displayName.value=My Preference Category
MyNewPreferenceCategory.description.value=Preference Category for my
custom preferences.
# Preference Definition labels
MyNewPreference.displayName.value=Display name of preference /com/my
company/
MyNewPreference
MyNewPreference.description.value=Description of preference /com/myc
ompany/
MyNewPreference.
MyNewPreference.longDescription.value=Long description of preference
/com/mycompany/MyNewPreference.
2. windchill シェルで以下のコマンドを実行して、リソースバンドルを構築します。
ResourceBuild com.mycompany.pref.mycompanyPreferenceResource
3. サーブレットエンジンおよび MethodServer を再起動します。
4. プリファレンスロードファイル createMyNewPreference.xml を作成します。これには、新しいプリファレンスカテゴリの定義と新しいプリファレンスの定義が含まれます。
<?xml version="1.0"?><!DOCTYPE NmLoader SYSTEM "standardX10.dtd">
<NmLoader>
<csvPreferenceCategory handler="wt.preference.LoadPreference.createPref
erenceCategory">
<csvname>CUSTOM_PREFERENCE_CATEGORY</csvname>
<csvparentName></csvparentName>
<csvdisplayName>
com.mycompany.pref.mycompanyPreferenceResource:
MyNewPreferenceCategory.displayName
</csvdisplayName>
<csvdescription>
com.mycompany.pref.mycompanyPreferenceResource:MyNewPreferenceCategory.
description
</csvdescription>
</csvPreferenceCategory>
<csvPreferenceDefinition handler="wt.preference.LoadPreference.createPref
erence
Definition">
<csvname>/com/mycompany/MyNewPreference</csvname>
<csvvisibility>USER</csvvisibility>
<csvcategoryName>CUSTOM_PREFERENCE_CATEGORY</csvcategoryName>
<csvdisplayName>com.mycompany.pref.mycompanyPreferenceResource:MyNew
Preference.displayName</csvdisplayName>
<csvdescription>com.mycompany.pref.mycompanyPreferenceResource:MyNew
Preference.description</csvdescription>
<csvlongDescription>com.mycompany.pref.mycompanyPreferenceResource:
MyNewPreference.longDescription</csvlongDescription>
<csvdefaultValue>Default Value</csvdefaultValue>
<csvhandler>com.ptc.windchill.enterprise.preference.handler.
StringPreferenceValue
Handler:4000</csvhandler>
</csvPreferenceDefinition>
<csvLinkPreferenceClientDefinition handler="wt.preference.LoadPreference.set
ClientDefinitionLink">
<csvname>/com/mycompany/MyNewPreference</csvname>
<csvclientName>WINDCHILL</csvclientName>
</csvLinkPreferenceClientDefinition>
</NmLoader>
5. 以下のコマンドを使用して、プリファレンスカテゴリとプリファレンス定義をロードします。
windchill wt.load.LoadFromFile -d <full
path>/createMyNewPreference.xml