カスタマイズポイント

クラス com.ptc.core.components.forms.CreateObjectFormProcessor は、永続可能オブジェクトを作成するウィザードで、デフォルトのフォームプロセッサとして使用することができます。このクラスは、必要に応じて拡張することができます。

既存の Windchill ビジネスクラスを拡張する場合、CreateObjectFormProcessor の代わりに使用または拡張する必要のある、そのクラスに特有のプロセッサが存在します。以下の表でこれらのクラスを示します。これらのクラスの動作の詳細については、Javadoc を参照してください。

クラスによる拡張対象	使用するプロセッサクラス
WTPart	ワークスペースから起動するウィザードを作成する場合: com.ptc.windchill.enterprise.part.forms.CreatePartFromW orkspaceFormProcessor 「構造を編集」クライアントから起動するウィザードを作成する場合: com.ptc.windchill.enterprise.part.forms.CreatePartFromTa bularInputProcessor その他すべての単一オブジェクトの作成ウィザードの場合: com.ptc.windchill.enterprise.part.forms.CreatePartFormPro cessor
WTDocument	テンプレートからドキュメントを作成する場合: com.ptc.windchill.enterprise.doc.forms.CreateDocFromTe mplateFormProcessor ドキュメントテンプレートを作成する場合: com.ptc.windchill.enterprise.doc.forms.CreateDocTemplat eFormProcessor その他すべての単一オブジェクトの作成ウィザードの場合: com.ptc.core.windchill.enterprise.doc.forms.CreateDocFor mProcessor
WTChangeIssues	com.ptc.windchill.enterprise.change2.forms.processors.Cre ateProblemReportFormProcessor
WTChangeRequest2	com.ptc.windchill.enterprise.change2.forms.processors.Cre ateChangeRequestFormProcessor
WTChangeOrder2	com.ptc.windchill.enterprise.change2.forms.processors.Cre ateChangeNoticeFormProcessor
WTChangeActivity2	com.ptc.windchill.enterprise.change2.forms.processors.Cre ateChangeTaskFormProcessor
WTVariance	com.ptc.windchill.enterprise.change2.forms.processors.Cre ateVarianceFormProcessor.

提供されているフォームプロセッサのいずれかの動作がニーズを満たしているのであれば、独自のプロセッサを作成する必要はありません。単に、ウィザード操作のコマンドサブタグのクラス属性値としてプロセッサを指定します。いずれの動作もニーズを満たさない場合は、ウィザードフォームデータを処理するためにプロセッサのサブクラスを作成する必要があります。単に属性を設定するために特別なコードを提供する場合は、独自のプロセッサを作成する必要はありません。その場合は、このタスクを処理するために FormProcessorDelegate を書き込むだけです。非表示フォームフィールドで FormProcessorDelegate を登録し、CreateObjectFormProcessor によって認識される特別な属性名が属性入力フィールドに指定されていないことを確認してください。詳細については、属性テーブルを参照してください。

単に属性を設定するために特別なコードを提供する場合は、独自のプロセッサを作成する必要はありません。その場合は、このタスクを処理するために FormProcessorDelegate を書き込むだけです。非表示フォームフィールドで FormProcessorDelegate を登録し、CreateObjectFormProcessor によって認識される特別な属性名が属性入力フィールドに指定されていないことを確認してください。

たとえば、ウィザードの終了時に起動ページを再表示せずに新規のページをロードする場合です。あるいは、ウィザードを複数の位置から起動でき、起動ページを再表示する場合や、新規のページをロードする場合です。

ソリューション: 定義済みのプロセッサを部分的に分類し、setResultNextAction メソッドをオーバーライドします。NmCommand.getCompContext() メソッドから、ウィザードの起動コンテキストに関する情報を入手できます。以下にベースライン作成クライアントでこれを実行する例を示します。

String compContext = cb.getCompContext();
if (compContext != null) {
try {
NmContext compContextObj = NmContext.fromString(compContext);
Stack<NmContextItem> contextItems = compContextObj.getContextItems();
for (NmContextItem contextItem : contextItems) {
String action = contextItem.getAction();
if ("addToBaseline".equals(action) ||
"addToBaselineSingle".equals(action) ||
"addToBaselineStep".equals(action)) {

< set some next action >
}
}
.
.
.

テーブルからウィザードを起動し、ウィーザード操作で ajax="row" を指定した場合は、FormResult で refreshInfo 属性を設定し、システムに再表示する行を通知するようにします。通常、DynamicRefreshInfo オブジェクトの属性は以下のようになります。

詳細については、Windchill JSP フレームワークを使用した HTML クライアントのカスタマイズの章のAjax による UI のカスタマイズのセクションと、FormResult および FormProcessingStatus クラスについての Javadoc を参照してください。

たとえば、変更管理オブジェクトウィザードには、作成後にユーザーがただちにオブジェクトをワークフローに送信できるダイアログがあります。この場合、オブジェクトの作成後に別の操作を実行する必要があります。このような条件は、入力フィールドで ObjectFormProcessorDelegate を作成し、そこでインフラストラクチャによって自動的に呼び出される postProcess() または postTransactionProcess() メソッドを実装することによって処理できる場合があります。ただし、それ以外の場合は、この処理を実行するためにフォームプロセッサを使用できます。たとえば、操作の順序が要件になっているとフォームプロセッサで操作を実行する必要があるため、FormProcessorDelegates を呼び出す順番を制御できません。

ソリューション: 定義済みのプロセッサを部分的に分類し、doOperation() メソッドをオーバーライドします。独自メソッドではスーパーメソッドを呼び出せませんが、登録済みの FormProcessorDelegates の doOperation() メソッドが呼び出されることを確認する必要があります。これは、DefaultObjectFormProcessor から継承される processDelegates() メソッドを呼び出すことによって実行できます。次に例を示します。

FormResult doOperationResult = new FormResult();
doOperationResult.setStatus(FormProcessingStatus.SUCCESS);
doOperationResult = processDelegates (DO_OPERATION, clientData,
objectBeanList);
if (!continueProcessing(doOperationResult)) {
return doOperationResult;
}
try
{
< persist the object >
}
catch(WTException e)
{
< do error handling >
}
return doOperationResult;

委任は、多くの処理フェーズでフォームプロセッサタスクの後に呼び出されますが、doOperation フェーズでは、フォームプロセッサがタスクを実行する前に委任が呼び出される必要があります。これによって、すべての属性が設定され、オブジェクトの永続化が行われる前に、委任が操作を実行できるようになります。

• FormProcessorDelegate を作成し、その preProcess() メソッドを実装します。このメソッドで、ObjectBean のオブジェクトに属性値を設定します。委任の名前を指定するウィザード JSP に非表示フォームフィールドを追加します。このフィールドは、フレームワークによって自動的にインスタンス化が行われます。次に例を示します。

• 定義済みのプロセッサを部分的に分類し、preProcess() メソッドをオーバーライドします。スーパークラスの createItemInstance() メソッドを呼び出して Persistable を作成し、この Persistable に目的の属性を設定することができます。次に例を示します。

FormResult preProcessResult = new
FormResult(FormProcessingStatus.SUCCESS);
for (ObjectBean objBean: objectBeans) {
FormResult objectResult =
new FormResult(FormProcessingStatus.SUCCESS);
objBean.setObject(createItemInstance(clientData,
objBean, objectResult));
preProcessResult =
mergeIntermediateResult(phaseResult, objectResult);
if (!continueProcessing(preProcessResult)) {
return preProcessResult;
}
Object newObj = objBean.getObject();
< set additional attributes on the new object here>
}
// Call processDelegates() which will call registered
processor delegates
delegatesResult = processDelegates(DO_OPERATION,
clientData, objectBeanList);
preProcessResult =
mergeIntermediateResult(preProcessResult, delegatesResult);
if (!continueProcessing(preProcessResult)) {
return preProcessResult;
}