ウィザードおよびウィザードステップの操作の作成
ウィザードの各ステップとウィザード自体には、関連付けられているページの操作宣言が必要になります。操作は、オブジェクトタイプを使用してグループ化します。これらのオブジェクトタイプは、いずれかの *actions.xml ファイルに含まれている <listofactions> タグの内部で宣言します。操作の機能の詳細については、
Windchill クライアントアーキテクチャの操作フレームワークを参照してください。
Windchill では、このオブジェクトタイプに関連付けられているすべての JSP ページは、<Windchill>\codebase\netmarkets\jsp\<オブジェクトタイプ> に配置してください。次のサンプルコードでは、<Windchill>\codebase\netmarkets\jsp\changeTask\ を指定しています。
ウィザードページに create 操作を定義します。デフォルトでは、command タグに url 属性を指定しないかぎり、操作の名前属性は
codebase/netmarkets/jsp に関連するウィザードのメイン JSP ページを示します。そのため、次に示す操作の場合、
Windchill では
create.jsp が
<Windchill>\codebase\netmarkets\jsp\changeTask\ フォルダに存在すると見なされます。この操作はウィザード用なので、
<command> タグ内で windowType を "popup" と指定する必要があります。
windowType 属性の詳細については、
Windchill クライアントアーキテクチャの操作フレームワークを参照してください。
ウィザードステップに、affectedAndResultingItemsStep 操作を定義します。これに該当する jsp ファイルは、<Windchill>\codebase\netmarkets\jsp\changeTask\affectedAndResultingItemsStep.jsp に配置してください。この操作はウィザードステップ用なので、windowType を "wizard_step" と指定する必要があります。
コマンドクラスは、ウィザードデータの処理のために呼び出される Java クラスです。通常、これによって CreateObjectFormProcessor が拡張されます。
フォームプロセッサクラスによって DefaultObjectFormProcessor または CreateObjectFormProcessor が拡張されるのであれば、command タグに method 属性を指定する必要はありません。
ステップの command サブタグの windowType 属性は必ず "wizard_step" に設定してください。
以下の表に、オプションの操作タグの属性を示します。
|
操作タグ属性
|
デフォルト値
|
有効な値
|
説明
|
|
ajax
|
なし
|
page
component
row
|
ウィザードでの処理が完了したときに、親ページのどの領域を再表示するかを指定します。
値 "page" は、ページ全体を再表示します (ajax を使用しないことと同等)。値 "component" は、ウィザードが起動されたテーブルを再表示します。
値 "row" は、1 つまたは複数のテーブル行を再表示します。
値 "row" を使用するには、フォームプロセッサが、追加する行 (オブジェクト) をシステムに通知しなければなりません。
|
|
UIComponent
|
なし
|
|
ウィザード操作への役割ベースのアクセスを指定するための roleaccessprefs.xml (uic 名) のエントリを参照します。
|
以下に "MyPart" オブジェクトで作成ウィザードを起動するための操作の例を示します。
前述の操作で示されている validateCreateLocation() JavaScript メソッドは、フォルダブラウザから起動できるウィザードの作成に適しています。詳細については、
ソリューションの「ソリューション要素」を参照してください。
操作と command タグの属性の詳細については、
操作の追加と UI への組み込みを参照してください。
ウィザード操作の作成に加え、操作名、ウィザードウィンドウのタイトル、操作のツールチップなどのテキストを作成する必要があります。これについては、
操作の追加と UI への組み込みで説明されています。