Peristiwa OnPreStageChange (rujukan API Klien)

Peristiwa ini berlaku Sebelum peringkat kawalan aliran proses perniagaan berubah. Peristiwa ini berlaku selepas pengguna memilih butang Peringkat Seterusnya, Pindah ke peringkat sebelumnya atau Tetapkan Peringkat Aktif dalam antara muka pengguna atau apabila pembangun menggunakan formContext.data.process.moveNextkaedah , formContext.data.process.movePreviousatau formContext.data.process.setActiveStage .

Nota

Acara OnPreStageChange disokong hanya pada Antara Muka Disatukan.

Daripada dalam skrip sumber web yang didaftarkan kepada peristiwa onPreStageChange, pembangun boleh memanggil perkara berikut pada objek executionContext yang dihantar ke dalam skrip sumber web:

executionContext.getEventArgs().preventDefault();

Apabila anda memanggil preventDefault:

• Navigasi peringkat tidak akan diproses. Contoh proses akan kekal pada peringkat asal.
• Dalam navigasi merentas jadual, bentuk jadual peringkat destinasi tidak akan dibuka.
• Simpanan borang utama tidak akan diproses. Jika borang utama berada dalam keadaan kotor, ia akan kekal dalam keadaan kotor.
• Mana-mana sumber web yang didaftarkan diStageChange tidak akan digunakan.

Objek konteks pelaksanaan dihantar kepada pengendali peristiwa untuk peristiwa ini. Anda boleh menggunakan kaedah getEventArgs untuk mendapatkan semula objek yang mempunyai kaedah berikut:

• getDirection: Mengembalikan rentetan yang sama ada Next atau Previous untuk menunjukkan arah perubahan peringkat.
• getStage: Mengembalikan objek peringkat. Kecuali apabila navigasi bergerak ke jadual baharu, peringkat yang dikembalikan mewakili objek peringkat destinasi—iaitu, peringkat aktif seterusnya. Apabila navigasi bergerak ke jadual baharu, peringkat ialah peringkat yang dinavigasi daripada—iaitu, objek peringkat aktif sebelumnya. Maklumat lanjut: Kaedah peringkat.

Kaedah yang disokong untuk acara ini

• formContext.data.process. addOnPreStageChange untuk menambah pengendali acara untuk acara ini.
• formContext.data.process. removeOnPreStageChange untuk mengalih keluar pengendali peristiwa untuk acara ini.

Artikel berkaitan

Peristiwa (rujukan API Klien)
Acara dalam borang dan grid dalam aplikasi dipacu model