ソリューション

基本的なカスタマイズ > ユーザーインタフェースのカスタマイズ > 情報ページ > 情報ページのコンポーネントのカスタマイズ > ソリューション

ソリューション

DefaultInfoComponentBuilder を拡張するビルダー Java クラスを作成します。この Java クラスは、特定のビジネスオブジェクトタイプの情報ページにレンダーされるエレメントを定義します。属性のレイアウトは「タイプおよび属性の管理」ユーティリティの属性レイアウトマネージャによって制御されます。

前提となる知識

この情報を適用するには、次のことを理解している必要があります。

• Java ビルダークラスを作成するための MVC フレームワーク (MVC コンポーネントを参照)

• Windchill における JSP ベースのクライアントアーキテクチャフレームワーク (Windchill クライアントアーキテクチャの概要を参照)

• Windchill クライアントアーキテクチャの操作フレームワーク (Windchill クライアントアーキテクチャの操作フレームワークを参照)

• 「タイプおよび属性の管理」(Type and Attribute Management) ユーティリティを使用した属性レイアウトの管理方法 (「タイプおよび属性の管理」ユーティリティを参照)

ソリューションエレメント

開発者はこのコンポーネントを使用して DefaultInfoComponentBuilder を拡張することでビルダーを作成する必要があります。

エレメント	タイプ	説明
DefaultInfoComponentBuilder.java	Java クラス	その他すべての情報ページビルダーの拡張元となるデフォルトのビルダー。このビルダーは必要なデータをサーバーから集めます。

情報ページの生成に使用される主なエレメントを以下に示します。これらは開発者によってオーバーライドされません。ビルダーでは、特定のビジネスオブジェクトの情報ページに表示するアイテムを開発者が制御したり、「タイプおよび属性の管理」ユーティリティを使用して属性のレイアウトを制御したりすることができます。

エレメント	タイプ	説明
infoPage.jsp	JSP	情報ページのすべての操作が呼び出す必要がある JSP。begin.jspf/end.jspf を呼び出して、MVC taglib 内の infoPage タグを呼び出します。
infoPage.tag	MVC taglib で定義されているタグ。	JSP コンテキストを設定し、情報ページの ComponentDefinition オブジェクトを作成します。コンポーネント taglib 内の renderInfoPageModel タグを呼び出して、JavaScript レンダラーを呼び出して情報ページの HTML を生成します。
RenderInfoPageModelTag.java	Java タグ。コンポーネントの taglib で定義されます。	ビルダー内のデータから JSON オブジェクト (別名: InfoModel) を作成し、JSON オブジェクトを print stream に書き込みます。
infoPage.jsfrag	JavaScript フラグメント	JSON InfoModel オブジェクトを取り込む JavaScript レンダラー。情報ページの HTML を生成します。
myTab.jsfrag	JavaScript フラグメント	トップレベルのタブをレンダーし、タブコンテンツ領域内でアイテムを移動可能にします。

サポートされているエレメント

エレメント	タイプ	説明
attributePanel.jsp	JSP	属性パネルをレンダーするために呼び出す JSP。属性パネルのコンポーネントを使用して、"属性" および "Visualization と属性" ウィジェットが表示されます。属性パネルの属性のレイアウトは「タイプおよび属性の管理」ユーティリティの属性レイアウトマネージャによって制御されます。詳細については、属性パネルを参照してください。
attributePanel.tag	MVC taglib で定義されているタグ。	JSP コンテキストを設定し、属性パネルの ComponentDefinition オブジェクトを作成します。コンポーネント taglib 内の renderAttributePanel タグを呼び出して、JavaScript レンダラーを呼び出して属性パネルの HTML を生成します。
RenderAttributePanelTag.java	Java タグ。コンポーネントの taglib で定義されます。	ビルダー内のデータから JSON オブジェクト (別名: InfoModel) を作成し、JSON オブジェクトを print stream に書き込みます。
attributePanel.jsfrag	JavaScript フラグメント	JSON InfoModel オブジェクトを取り込む JavaScript レンダラー。属性パネルの HTML を生成します。

情報ページのプロセスの流れ

ビルダーが最初に呼び出されて、必要なデータをサーバーから集めます。ビルダーがリクエストをビュー (infoPage.jsp) に転送します。デフォルトビュー infoPage.jsp に infoPage タグが取り込まれます。このタグによって、ビルダーが集めたデータから、infoModel オブジェクトと呼ばれる JSON オブジェクトが作成されます。(JSON 文字列として JSP ライターに書き出すことで) infoModel がシリアライズされて JavaScript レンダラーに渡され、最終的に HTML が生成されます。

情報ページのレンダリングのプロセスシーケンスを以下に示します。

情報ページのビルダーデザイナ

新規ビジネスオブジェクトタイプに情報ページを作成する場合、開発者は DefaultInfoComponentBuilder を拡張するビルダーを作成する必要があります。そのビジネスオブジェクトタイプに適したビルダーが呼び出されるように、ビルダークラスに以下の Java アノテーションを含める必要があります。

@ComponentBuilder(value = ComponentId.INFOPAGE_ID)
@TypeBased(value = "wt.part.WTPart")
public class PartInfoBuilder extends DefaultInfoComponentBuilder {
….

ビルダー ID のアノテーションはスーパークラス DefaultInfoComponentBuilder で指定します。アノテーションは継承されるので、このクラスを拡張する場合、ComponentBuilder アノテーションは必要ありません。このアノテーションがある場合にこのクラスを拡張しなくても問題はないので、このアノテーションを必ず含めるようにします。

ビルダークラスまたはパッケージの登録方法の詳細については、MVC コンポーネントを参照してください。

オーバーライドする必要がある唯一のメソッドが buildInfoConfig() メソッドです。このメソッドでは、そのビジネスオブジェクトタイプの情報ページに表示するエレメントを設定します。このメソッドによって、それらのエレメントのデータを集めるために必要なサービス API が呼び出されます。これらのエレメントの詳細については、情報ページビルダー内のカスタマイズオプションを参照してください。

ビルダーのアノテーションにはハードタイプまたはサブタイプを含めることができます。

@TypeBased(value = "wt.part.WTPart")
@TypeBased(value = " com.company.SoftType")

詳細については、MVC コンポーネントの概要のTypeBasedを参照してください。