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

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Avec Microsoft Dynamics 365 (Online et local), 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.

À partir de la Mise à jour de décembre 2016 pour Dynamics 365 (en ligne et local), différentes définitions de flux de processus d'entreprise peuvent être associées à différents rôles et les instances peuvent s'exécuter simultanément sur le même enregistrement d'entité. Les utilisateurs peuvent permuter entre des instances de processus d'entreprise simultanées et reprendre leur travail à une étape actuelle du processus.

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'une des instances de processus activées comme instance active ou créer une instance de processus.

• Modifier l'instance de processus d'un enregistrement d'entité
  Utilisez getProcessInstances pour récupérer des informations sur toutes les instances de processus d'un enregistrement d'entité et setActiveProcessInstance pour définir une instance de processus comme instance active.

• 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 6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_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

• 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.

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.setVisiblepour afficher ou non le contrôle du flux des processus d'entreprise.

• 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 les nouveaux événements ci-après 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 (d88d5f21-6385-443b-91f2-0ec0c16b1324#BKMK_OnStageChange) ou lorsqu'une phase est sélectionnée (d88d5f21-6385-443b-91f2-0ec0c16b1324#BKMK_OnStageSelected).

• Vous pouvez exécuter du code lorsque le statut d'une instance de flux des processus d'entreprise change (d88d5f21-6385-443b-91f2-0ec0c16b1324#BKMK_OnProcessStatusChange). Une instance de flux des processus d'entreprise peut avoir un des statuts suivants : Active, Finished ou Aborted.

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 :f451f339-bcee-4260-9904-abc8c0efa153#BKMK_BPFControl

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
f451f339-bcee-4260-9904-abc8c0efa153#BKMK_BPFControl
TechNet : flux des processus d'entreprise

Microsoft Dynamics 365

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