Condividi tramite


Evento OnPreStageChange (informazioni di riferimento sull'API client)

Questo evento si verifica prima della modifica della fase di un controllo del flusso di processo aziendale. Questo evento si verifica dopo che l'utente seleziona la fasesuccessiva, passa alla fase precedente o imposta fase attiva nell'interfaccia utente o quando uno sviluppatore usa i formContext.data.process.moveNextmetodi , formContext.data.process.movePreviouso .formContext.data.process.setActiveStage

Annotazioni

L'evento OnPreStageChange è supportato solo in Unified Interface.

Dall'interno di uno script di risorsa Web registrato nell'evento onPreStageChange, uno sviluppatore può richiamare quanto segue nell'oggetto executionContext passato nello script della risorsa Web:

executionContext.getEventArgs().preventDefault();

Quando si richiama preventDefault:

  • Lo spostamento della fase non verrà elaborato. L'istanza del processo rimarrà nella fase originale.
  • In uno spostamento tra tabelle, la forma della tabella della fase di destinazione non verrà aperta.
  • Il salvataggio del modulo principale non verrà elaborato. Se la forma principale era in uno stato dirty, rimarrà in uno stato dirty.
  • Tutte le risorse Web registrate suStageChange non verranno richiamate.

Un oggetto contesto di esecuzione viene passato ai gestori eventi per questo evento. È possibile utilizzare il metodo getEventArgs per recuperare un oggetto con i metodi seguenti:

  • getDirection: restituisce una stringa che è Next o Previous per mostrare la direzione della modifica della fase.
  • getStage: restituisce un oggetto stage. Tranne quando lo spostamento passa a una nuova tabella, la fase restituita rappresenta l'oggetto fase di destinazione, ovvero la fase attiva successiva. Quando lo spostamento passa a una nuova tabella, la fase è la fase da cui si passa, ovvero l'oggetto fase attiva precedente. Altre informazioni: Metodi di staging.

Metodi supportati per questo evento

Eventi (informazioni di riferimento sulle API client)
Eventi in moduli e griglie nelle app basate su modello