フルカスタムグラフィック製品表現の作成

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>”;
};

• 最初の 2 行によって名前空間が作成されます。以下の関数により、グラフィック製品表現のクライアント側 UI が実装されます。これらの関数は、まず、サーバーで生成された JSON 値を "data" に読み込みます。この値はクライアントでキャッシュされるため、これを呼び出してもクライアント-サーバートラフィックは発生しません。次に、各関数が戻り値を計算して、その UI の要素を反映させます。サーバーに重大な問題があれば、データの値が、必要とされる JSON 値ではなく、単純な文字列であることがあります。したがって、これらの関数は、一般的に、値が必要とされる値であるかどうかを最初にチェックします。例:

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

• 1 つ目の主要な "renderer()" 関数は、レンダリングされたページでこのエレメントを表す HTML を生成します。サーバーがエラー文字列を送信した場合、それはこの関数の結果として返されます。そうでない場合は、データ内の JSON 値を使用して、HTML が望まれるあらゆるものを生成できます。

• 2 つ目の "exportRenderer()" 関数は、エクスポートされるこのエレメントの文字列値を返します。このエクスポート値は、Windchill UI の「リストをファイルにエクスポート」操作によって生成されるどのファイルにも表示される可能性があります。

• 3 つ目の "exportRendererForGWT()" 関数は、GWT、Cadx、および PSB ベースの UI でエクスポートされるこのエレメント文字列値を返します。このエクスポート値は、Windchill GWT ベースの UI の「リストをファイルにエクスポート」操作によって生成されるどのファイルにも表示される可能性があります。

• 4 つ目の "searchFunc()" 関数は、テーブル内サーチオペレーション中に、このエレメントを表す文字列値を返します。サーチ文字列がこの関数の戻り値の部分文字列と一致すると、対応するエレメントがサーチ結果に含められます。

• 最後に、5 つ目の "groupFunc()" 関数は、このエレメントを含んでいるグループを識別するために使用されるラベルを返します。テーブルの列ヘッダーメニュー「このフィールドでグループ化」を使用すると、テーブルが並べ替えられ、テーブル内の同じグループラベルを持つ連続する行が、そのグループを識別するためのラベルを使用してグループ化されます。

• exportRenderer、searchFunc、および groupFunc 関数はすべて、レンダラー関数 XyzCorp.pieChart.renderer によって定義されることに注意してください。この命名規則は、これらの機能が有効になるために必要です。異なる方法でこれらの関数に名前を付けたり、別のプレフィックスを使用したりすると、これらは無視されます。