setActiveStage (Client API reference)

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

構文

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

注意

エンティティとテーブルの違いがわかりませんか? Microsoft Dataverse で「開発者: 用語を理解する」を参照してください。

パラメーター

Name 種類​​ 必須出席者 内容
stageId String 有効 アクティブなステージを作成するためのテーブルの完了したステージの ID。
callbackFunction Function 無効 操作が完了したときに呼び出す関数。 このコールバック関数には、操作の状態を示すために次のいずれかの文字列値が渡されます。
Value 理由
成功 操作が成功しました。
invalid この値が返される可能性がある理由は次の 3 つです。
  • *stageId* パラメーターが存在しないステージ ID 値である。
  • アクティブ ステージが選択したステージではない。
  • レコードがまだ保存されていない。
到達不能 ステージが異なるパスに存在します。
dirtyForm この値は、ページ内のデータが保存されない場合に返されます。
preventDefault この値は、`OnPreStageChange` イベントハンドラーが preventDefault を呼び出した場合に返されます。

重要

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

getActiveStage

formContext.data.process

注意

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

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