配置组织选取器

基本自定义 > 用户界面自定义 > 在 JSP 客户端合并选取器 > 配置组织选取器

配置组织选取器

目标

问题：您想要在自定义 UI 中添加组织选取器，且需要将选取器配置为：

• 仅搜索特定类型的对象

• 仅搜索某些容器中的对象

• 显示某些搜索条件输入字段

• 在搜索结果表格中显示对象的某些属性

背景

当需要根据特定条件选择特定组织并在应用程序中加以使用时，会用到组织选取器。典型用例可能是您可能需要在特定组织中查找可用部件。在这种情况下，您可以使用组织选取器来选择组织，并将其传递给搜索条件以执行部件的搜索。

范围/适用性/假设

假定要在其中放置标记的 <MyPage>.jsp 文件包括 "\netmarkets\jsp\begin.jspf" 或 "\netmarkets\jsp\beginPopuf.jspf" 文件和 "\netmarkets\jsp\end.jspf" 文件。

预期结果

使用组织选取器标记后，应该会显示一个文本框和一个“查找”按钮及其指定标签。单击“查找...”按钮后，将启动组织选取器。

单击“查找...”按钮时，您应该会看到一个组织选取器。

解决方案

在 JSP 文件中使用组织选取器公用组件将组织选取器包括在应用程序中。

必备知识

要实现此目标，需要了解以下内容：

• 涉及 JSP、JavaScript 和自定义 taglib 的基本开发

• 关于资源束文件自定义的管理

• Windchill xconfmanager 概念

解决方案元素

元素	类型	说明
PickerAttributes.xml	XML	pickerAttributes.xml XML 文件应使用此文件为选取器的对象类型自定义搜索条件属性。运行时位置：<Windchill>\codebase\pickerAttributes.xml
searchClientResource.java	资源束文件	应使用此文件来本地化选取器的内容。
organizationPicker.tag	自定义 JSP 标记文件	此文件包含此标记所支持的参数的相关信息。运行时位置：<Windchill>\codebase\WEB-INF\tags\ContextPicker.tag
SearchableTypes.properties.xconf	xconf 特性文件	应在此文件中指定组件 ID 和相应的对象类型，然后运行 xconfmanager。运行时位置： <Windchill>\codebase\com\ptc\windchill\enterprise\search\server\SearchableTypes.properties.xconf
custom.js	JavaScript 文件	应在此文件中为选取器指定自定义 pickerCallback 函数。运行时位置：<Windchill>\codebase\netmarkets\jsp\search\custom.js

您想要在上下文选取器中禁用类型选取器。

过程 - 在 JSP 页面中包括组织选取器

通过调用 organizationPicker 标记从 JSP 启动组织选取器：

自定义点

参数	默认值	可能的值	必需？	说明
Id		页面中任何唯一的内容	False	ID 与调用应用程序中的每个选取器均关联。对于一个页面中的所有选取器 (无论是否为同一类型)，此 ID 都必须是唯一的。ID 不应在名称中包含 "." (点)。
componentId	pickerSearch	在 pickerAttributes.xml 中指定的任何有效组件 ID	否	componentId 用于确定应出现在给定选取器的搜索条件面板中的属性。
pickerCallback	如果用户未指定此参数，则在运行时生成	回调函数的名称	否	用户必须实现的自定义回调函数的名称。建议在 custom.js 文件中指定 pickerCallback 函数
defaultValue	"" (空白)	任何值	否	由选取器呈现的文本框的默认值。
defaultHiddenValue	"" (空白)	任何值	否	与选取器关联的隐藏文本框的默认值。
Label	上下文选取器	任何值	否	选取器的标签。
displayAttribute	名称	任何属性	否	在从组织选取器中选择结果后，应在选取器文本框中显示的属性的名称
containerRef	"" (空白)	任何容器	否	用户要在其中限制搜索的 containerRef 的值。
baseWhereClause	"" (空白)	任何有效的 I*E where 子句查询	否	需要根据某些特定条件筛选搜索结果而无需考虑用户输入时使用的附加 where 子句。此 where 子句通过内部 where 子句将仅获得 "ANDed"。
pickerTitle	上下文	任何值	否	选取器的标题。
pickedDataFetcher	<WebApp>/netmarkets/jsp/search/pickedData.jsp	获取器文件的 URL 位置	否	将由 AJAX 调用使用以处理选定结果的数据获取器文件的 URL。
Editable	True	true/false	否	此属性用于定义是否要将“查找”图标与文本框一同使用。
readOnlyPickerTextBox	False	true/false	否	此属性用于定义选取器文本框是否应为可编辑。
Inline	False	true/false	否	当需要从表格级别操作或内联启动选取器时，应将此参数的值指定为 true。
pickedAttributes	名称	有效属性的任何逗号分隔列表	否	此参数包含用户希望选取器提取的属性的逗号分隔列表。仅当内联为 "true" 时才适用。
pickerType	search	search/picker	否	此参数用于定义选取器类型，即 "search" 选取器或 "picker" 选取器。对于 "search" 选取器，您能够在该选取器中看到搜索条件，然后必须单击“搜索”按钮才能查看结果；而对于 "picker" 选取器，您将直接看到结果表格，而看不到任何搜索条件。
pickerTextBoxLength	25	任何数值	否	此参数用于定义选取器文本框的长度。
searchResultsViewId	"" (空白)	任何有效视图 ID	否	此参数允许用户为选取器搜索结果表格定义自定义视图 ID。
extraSuggestAttributes	emaild	用户想要搜索的任何字段	False	此参数用于指定要用于自动建议的额外属性
showSuggestion	false	True/false	False	如果将此特性设为 true，则会显示最近使用的多选上下文选取器。在这种情况下，需要修改 callback 函数和 onchange 函数。默认值为 false。仅针对搜索页面实现。此特性用于对选取器启用自动建议。
suggesMinChars	1	整数值	False	此参数用于指定在启用时启动自动建议的最小字符
suggestServiceKey	选取器特定	userPicker、partPicker 等。	False	用于选择 suggestable 类 (例如 ContextServicePickerSuggestable) 以调用需要出现在 search-service.properties.xconf 文件中的 service.Key 查询的键。

在结果表格中配置包含多选选项的组织选取器

<wctags:organizationPicker id="orgPickerId" multiSelect="true" />

在组织选取器中配置 baseWhereClause

<wctags:organizationPicker id="orgPickerId"
baseWhereClause="(name=’myOrg*’)" />

在组织选取器中配置 pickerCallback 函数

<wctags:organizationPicker id="orgPickerId"
pickerCallback="myPickerCallback" />
myPickerCallback function can be like:
function myPickerCallback(objects, pickerID)
{
var updateHiddenField = document.getElementById(pickerID);
var updateDisplayField = document.getElementById(pickerID +
"$label$");
var myJSONObjects = objects.pickedObject;
for(var i=0; i< myJSONObjects.length;i++) {
var oid = myJSONObjects[i].oid;
// Here “name” is the displayAttribute requested
var displayAttr = eval("myJSONObjects[i].name");
updateHiddenField.value=oid;
updateDisplayField.value=displayAttr;
}
}

这对您有帮助吗?