Écriture d'événements pour les flux de processus d'entreprise

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Avec Mise à jour de Microsoft Dynamics CRM 2015 et de Microsoft Dynamics CRM Online 2015, vous disposez d'un objet côté client vous permettant d'interagir avec les flux de processus d'entreprise dans vos scripts. L'espace de noms Xrm.Page.data est étendu de manière à inclure des méthodes dans le cadre du Xrm.Page.data.process. L'espace de noms Xrm.Page.ui est étendu de manière à inclure des méthodes dans le cadre du Xrm.Page.ui.process.

Contenu de la rubrique

Structure des flux de processus d'entreprise

Actions pouvant être automatisées

Événements du flux des processus d'entreprise

Structure des flux de processus d'entreprise

Les flux de processus d'entreprise sont composées d'une série de phases contenant chacune un certain nombre d'étapes. Seule l'une d'entre elles est la phase active. Lorsque les étapes nécessaires de chaque phase sont terminées, le processus peut passer à la phase suivante qui devient la phase active. La phase suivante peut être définie selon des conditions du flux des processus d'entreprise illustrées dans le diagramme suivant.

Les phases peuvent être associées à des entités connexes spécifiques, afin qu'un flux des processus d'entreprise puisse s'étendre à plusieurs entités. Le processus d'entreprise reste le même et mène l'utilisateur à une conclusion souhaitée.Pour plus d'informations :TechNet : flux des processus d'entreprise

Actions pouvant être automatisées

Généralement, la progression du processus d'entreprise dépend de l''entrée de données de la part de l'utilisateur. En tant que développeur, vous pouvez effectuer les mêmes opérations par programme dans des scripts de formulaire.

• Modifiez le processus lorsqu'il existe plusieurs processus disponibles pour l'entité.
  Utilisez Xrm.Page.data.process. getEnabledProcesses pour récupérer des informations sur les processus actifs que l'utilisateur peut choisir pour l'entité. Utilisez ensuite Xrm.Page.data.process. getActiveProcess pour définir l'un des processus activés comme le processus actif.

• Passez à la phase suivante si toutes les étapes nécessaires sont terminées afin d'en faire la phase active actuelle.
  Utiliser des Xrm.Page.data.process. moveNext

• Passez à la phase précédente pour en faire la phase active actuelle.
  Utiliser des Xrm.Page.data.process. movePrevious

• Sélectionnez une phase pour consulter le statut des étapes de celle-ci.
  Utilisez Xrm.Page.data.process. getActivePath pour récupérer des informations sur les phases terminées, la phase active actuelle et les phases valides disponibles auprès de la phase active actuelle. Consultez les étapes incluses dans cette phase et comparez les valeurs d'attribut de formulaire correspondantes pour déterminer si elles sont terminées.

• Achèvement d'une étape
  Les étapes sont terminées lorsque les données correspondante sont entrées dans le formulaire. Vous pouvez déterminer l'attribut via la méthode getAttribute de l'étape. Cela renvoie le nom logique de l'attribut. Utilisez ensuite Xrm.Page.getAttribute pour extraire l'attribut de la collection d'Xrm.Page.data.entity.attributes puis utilisez la méthode setValue d'attribut pour définir la valeur.

• Détection de la nécessité d'une étape
  Utilisez la méthode isRequired d'étape pour déterminer si une étape est nécessaire pour le flux des processus d'entreprise.

• Développement ou réduction du contrôle du flux des processus d'entreprise
  Utiliser des Xrm.Page.ui.process.setDisplayState

En tant que développeur, vous pouvez effectuer des opérations que les utilisateurs ne peuvent pas faire.

• Masquer le contrôle du processus
  Utilisez Xrm.Page.ui.process. 1468bab0-f6b3-4320-a60c-a88c9d4fcf1f#BKMK_setVisiblepour afficher ou non le contrôle du flux des processus d'entreprise.

• Passez à une phase terminée valide.
  Utilisez Xrm.Page.data.process.getActiveStage pour définir l'une des phases terminées valides de l'entité actuelle.

• Interroger la définition de processus, notamment les phases actuellement non visibles
  Utilisez Xrm.Page.data.process.getActiveProcess pour interroger la définition du flux des processus d'entreprise, notamment les étapes qui pourraient ne pas être visibles en raison de la logique de branchement du processus.

Événements du flux des processus d'entreprise

Vous pouvez faire interagir tout événement fourni par le formulaire avec les flux de processus d'entreprise, mais deux nouveaux événements vous permettent d'exécuter du code basé sur les événements uniquement pour le contrôle du flux des processus d'entreprise. Vous pouvez exécuter du code lorsque la phase active d'un flux des processus d'entreprise change (Événement OnStageChange) ou lorsqu'une phase est sélectionnée (Événement OnStageSelected).

Aucun de ces nouveaux événements ne fournit d'interface utilisateur inscrire vos gestionnaires d'événements. Vous devez utiliser les méthodes fournies pour ajouter ou supprimer les gestionnaires de ces événements dans l'événement OnLoad de formulaire.Pour plus d'informations :Événements de contrôle du flux des processus d'entreprise

Voir aussi

Utiliser le modèle d’objet Xrm.Page
Xrm.Page.data.process (référence côté client)
Exemple : Xrm.Page.data.process.getEnabledProcesses
Exemple : Xrm.Page.data.process.getActivePath
Événements de contrôle du flux des processus d'entreprise
TechNet : flux des processus d'entreprise

© 2017 Microsoft. Tous droits réservés. Copyright