此事件會在商務程序流程控制變更的階段 之前 發生。 此事件會在使用者在使用者介面中選取 [下一個階段]、[ 移至上一個階段] 或 [ 設定作用中階段] 按鈕之後，或當開發人員使用 formContext.data.process.moveNext、 formContext.data.process.movePrevious或 formContext.data.process.setActiveStage 方法時發生。
備註
OnPreStageChange 事件僅在整合介面上受支援。
從註冊至 onPreStageChange 事件的 Web 資源指令碼中，開發人員可以在傳遞至 Web 資源指令碼的 executionContext 物件上叫用下列專案：
executionContext.getEventArgs().preventDefault();
當您呼叫 preventDefault：
- 不會處理舞台導航。 程序例項將保留在原始階段。
- 在跨表格導覽中，目的地階段的表格表單將不會開啟。
- 不會處理主表單的儲存。 如果主形態處於髒狀態，它將保持髒狀態。
- 不會叫用任何註冊onStageChange的Web資源。
執行內容物件會傳遞至此事件的事件處理常式。 您可以使用 getEventArgs 方法來擷取具有下列方法的物件：
-
getDirection：傳回 或
Previous的Next字串，以顯示階段變更的方向。 - getStage：傳回階段物件。 除非導覽移至新表格，否則傳回的階段代表目的地階段物件，亦即下一個作用中階段。 當導覽移至新表格時，階段是從中導覽的階段，亦即前一個作用中階段物件。 其他資訊： 暫存方法。
此事件支援的方法
- formContext.data.process。addOnPreStageChange 方法來新增此事件的事件處理常式。
- formContext.data.process。removeOnPreStageChange 方法來移除此事件的事件處理常式。