Partager via


setActiveProcess (référence de l’API client)

Définit un Processus comme processus actif.

Si le processus métier défini comme actif a déjà une instance, l’instance sera marquée comme active et le formulaire d’enregistrement principal sera rechargé pour l’afficher. Si aucune instance n’existe pour le processus, une instance est créée, marquée comme active, et le formulaire d’enregistrement principal sera rechargé pour l’afficher.

Si plusieurs instances du processus existent, l’une d’entre elles sera choisie selon la logique par défaut pour être marquée comme active. En règle générale, il s’agit de l’instance de processus la plus récemment utilisée par l’utilisateur actuel.

Notes

  • La méthode setActiveProcess doit être utilisée à la création ou à la modification d’un enregistrement. Utilisez la méthode setActiveProcess pour définir le processus actif pour un flux des processus d’entreprise au lieu de processId et processInstanceId avec la méthode Xrm.Navigation.openForm.
  • La méthode setActiveProcess rechargera le formulaire et toutes les données non enregistrées seront perdues.

Syntaxe

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

Paramètre

Nom Type Requise Description
processId String Oui ID du processus permettant à définir comme processus actif.
callbackFunction Function Non Fonction à appeler lorsque l’opération est terminée. Cette fonction de rappel reçoit l’une des valeurs de chaîne suivantes pour indiquer si l’opération a réussi :
- success  : L’opération a réussi.
- invalid  : Le processId n’est pas valide ou le processus n’est pas activé.

Articles associés

getActiveProcess
setActiveProcessInstance
formContext.data.process

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).