setActiveProcess (klient-API-referens)

Anger en process som aktiv process.

Om affärsprocessen som anges som aktiv redan har en instans markeras instansen som aktiv och det primära postformuläret läses in igen för att visa den. Om det inte finns någon instans för processen skapas en ny instans, markerad som aktiv, och det primära postformuläret läses in igen för att visa den.

Om det finns flera instanser av processen väljs en av dessa enligt standardlogik som ska markeras som aktiv. Detta är vanligtvis den senast använda processinstansen av den aktuella användaren.

Anmärkning

  • Metoden setActiveProcess ska användas när du skapar eller redigerar en post. setActiveProcess Använd metoden för att ange den aktiva processen för ett affärsprocessflöde i stället för processId och processInstanceId med Xrm.Navigation.openForm metoden .
  • Metoden setActiveProcess läser in formuläret igen och alla data som inte har sparats kommer att gå förlorade.

Syntax

formContext.data.process.setActiveProcess(processId, callbackFunction);

Parameter

Namn Typ Krävs Description
processId String Yes ID:t för den process som ska anges som den aktiva processen.
callbackFunction Funktion Nej En funktion som ska anropas när åtgärden är klar. Den här återanropsfunktionen skickas ett av följande strängvärden för att ange om åtgärden lyckades:
- success: Åtgärden lyckades.
- invalid: ProcessId är inte giltigt eller så är processen inte aktiverad.

getActiveProcess
setActiveProcessInstance
formContext.data.process