Evenimentul OnPreStageChange (referință API client)

Acest eveniment are loc Înainte de modificarea etapei unui control al fluxului de procese de firmă. Acest eveniment are loc după ce utilizatorul selectează Etapa următoare, Treceți la etapa anterioară sau Setați butoanele Etapă activă din interfața utilizator sau atunci când un dezvoltator utilizează formContext.data.process.moveNextmetodele , formContext.data.process.movePrevioussau formContext.data.process.setActiveStage .

Notă

Evenimentul OnPreStageChange este acceptat doar în interfața unificată.

Dintr-un script de resursă web înregistrat la evenimentul onPreStageChange, un dezvoltator poate invoca următoarele în obiectul executionContext transmis în scriptul de resurse web:

executionContext.getEventArgs().preventDefault();

Atunci când invocați preventDefault:

  • Navigarea pe etape nu va fi procesată. Instanța procesului va rămâne în etapa inițială.
  • Într-o navigare încrucișată, forma tabelului de destinație nu se va deschide.
  • Salvarea formularului principal nu va fi procesată. În cazul în care forma principală a fost într-o stare murdară, ar rămâne într-o stare murdară.
  • Orice resurse web care s-au înregistrat peStageChange nu vor fi invocate.

Un obiect contextual de execuție este transmis rutinei de tratare a evenimentelor pentru acest eveniment. Puteți utiliza metoda getEventArgs pentru a regăsi un obiect care are următoarele metode:

  • getDirection: Returnează un șir care este fie Next pentru Previous a afișa direcția modificării etapei.
  • getStage: Returnează un obiect de etapă. Cu excepția cazului în care navigarea se mută într-un tabel nou, etapa returnată reprezintă obiectul etapă destinație, adică următoarea etapă activă. Atunci când navigarea se mută într-un tabel nou, etapa este etapa din care se navighează, adică obiectul de etapă activ anterior. Mai multe informații: Metode de etapă.

Metode acceptate pentru acest eveniment

  • formContext.data.process. addOnPreStageChange metoda de adăugare a rutinei de tratare a evenimentelor pentru acest eveniment.
  • formContext.data.process. removeOnPreStageChange metoda de eliminare a rutinei de tratare a evenimentelor pentru acest eveniment.

Evenimente (Referință API client)
Evenimente în formulare și grile în aplicații bazate pe model

  • Last updated on