setActiveStage (Client API reference)

完了したステージをアクティブ ステージとして設定します。

構文

formContext.data.process.setActiveStage(stageId, callbackFunction);

Parameters

件名	タイプ	Required	Description
stageId	String	はい	アクティブなステージを作成するためのテーブルの完了したステージの ID。
callbackFunction	Function	いいえ	操作が完了したときに呼び出す関数。 callbackFunction パラメータ を見る

callbackFunction パラメータ

このコールバック関数には、操作の状態を示すために次のいずれかの文字列値が渡されます。

価値	Reason
success	操作が成功しました。
invalid	この値が返される可能性がある理由は次の 3 つです。 - stageId パラメーターが存在しないステージ ID 値です。 - アクティブ ステージが選択したステージではありません。 - レコードがまだ保存されていません。
unreachable	ステージが異なるパスに存在します。
dirtyForm	この値は、ページ内のデータが保存されない場合に返されます。
preventDefault	この値は、OnPreStageChange イベントハンドラーが preventDefault を呼び出した場合に返されます。

重要

このメソッドを使用できるのは、選択したステージとアクティブ ステージが同じである場合のみです。 OnStageChange イベントからコードが起動されるときは、現在のステージが選択されます。 コードが OnStageSelected イベントから起動されるときは、getActiveStage メソッドを使用して、選択したステージもアクティブなステージであることを確認する必要があります。 その他すべてのフォーム イベントでは、どのステージが現在選択されているかを判断することはできません。 最善の結果を得るには、OnStageChange イベントと OnStageSelected イベントによって起動される関数で呼び出されるコードでのみ、このメソッドを使用する必要があります。

関連記事

getActiveStage
formContext.data.process

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。