创建完全自定义的图形表示

XyzCorp = {};
XyzCorp.pieChart = {};
XyzCorp.pieChart.renderer = function(table, column, row) {
var data = jsca.columns.getCellValue(column, row);
…
return “<the html value as a string>”;
}
XyzCorp.pieChart.renderer.exportRenderer = function(table, column, row) {
var data = jsca.columns.getCellValue(column, row);
…
return <the export value>;
};
XyzCorp.pieChart.renderer.exportRendererForGWT = function(data) {
…
return <the export value>;
};
XyzCorp.pieChart.renderer.searchFunc = function(table, column, row) {
var data = jsca.columns.getCellValue(column, row);
…
return “<the search value as a string>”;
};
XyzCorp.pieChart.renderer.groupFunc = function(table, column, row) {
var data = jsca.columns.getCellValue(column, row);
…
return “<the group label as a string>”;
};

• 前两行可创建名称空格。下面的每个函数均可实现图形表示的一段客户端 UI。每个函数首先将在服务器上生成的 JSON 值加载到 "data" 中。该值在客户端上缓存，并且提取该值不会增大客户端-服务器流量。然后，每个函数均会计算返回值以反映其 UI 方面的情况。如果服务器出现严重问题，则数据的值可能是简单字符串，而不是预期的 JSON 值。因此，这些函数通常会首先检查值是否符合预期。例如：

if (data && data.myExpectedField1) {
… handle expected values …
} else {
… handle the server-generated error string …
}

• 第一个和主 "renderer()" 函数会生成在呈现的页面上表示此元素的 HTML。如果服务器发送了错误字符串，则该字符串应作为此函数的结果返回。否则，您可以使用数据中的 JSON 值来生成所需的任何 HTML。

• 第二个 "exportRenderer()" 函数可返回要为此元素导出的字符串值。此导出值可能会出现在 Windchill UI 中“导出列表至文件”操作所产生的任何文件中。

• 第三个 "exportRendererForGWT()" 函数可返回要在基于 GWT、Cadx 和 PSB 的 UI 中为此元素导出的字符串值。此导出值可能会出现在 Windchill 基于 GWT 的 UI 中的“导出列表至文件”操作所产生的任何文件中。

• 第四个 "searchFunc()" 函数可返回在执行表内搜索操作期间表示此元素的字符串值。如果搜索字符串与该函数的返回值的任何子串匹配，则相应的元素将包括在搜索结果中。

• 最后，第五个 "groupFunc()" 函数可返回用于标识包含此元素的组的标签。当用户使用表格列标题菜单“按此字段分组”时，系统将对表格进行排序，并且具有相同组标签的表格的任何连续行都将通过用于标识组的该标签聚集在一起。

• 请注意，exportRenderer、searchFunc 和 groupFunc 函数均针对呈现器函数 XyzCorp.pieChart.renderer 进行定义。要使这些函数生效，需要使用此命名约定。如果尝试以不同方式命名函数或使用不同的前缀，则忽略这些函数。