创建首选项
首选项创建通过 XML 加载文件完成。创建首选项时，需要确定以下信息：
• 唯一首选项名称
• 可见性：首选项是否会出现在首选项管理器 UI 中，以及在哪一上下文中可见：SITE, ORGANIZATION, CONTAINER 还是 USER。
◦ 首选项类别：新首选项将在“首选项管理”实用程序中显示在该类别下。
◦ 显示名称：这是“首选项管理”实用程序中的名称列 - 形式如下的字符串 <RBINFO>:< RBINFO key>
◦ 说明：这是“首选项管理”实用程序中的说明列 - 形式如下的字符串
<RBINFO>:<RBINFO key>
◦ 详细说明：此说明显示在编辑首选项用户界面中，提供了更详细的说明，包括预期值。
▪ 形式如下的字符串 <RBINFO>:<RBINFO key>
• 默认值
• 值标题
在下面的示例中，我们将创建一个名为 /com/mycompany/MyNewPreference 的新首选项以及将显示在首选项管理器用户界面中的关联首选项类别。
1. 针对用于新首选项的标签创建资源束。首选项类别的显示名称和说明需要有标签，其中新首选项会在“首选项管理”用户界面中显示在该首选项类别下。首选项的显示名称、说明和详细说明也需要标签。在包 com.mycompany.pref 中创建文件 mycompanyPreferenceResource.rbInfo。在本示例中，此文件将被添加到 <WT_HOME>/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 shell 中执行以下命令来构建资源束：
ResourceBuild com.mycompany.pref.mycompanyPreferenceResource
3. 重新启动 servlet 引擎和 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>