Exemple : Utiliser les flux de processus d’entreprise

Cet exemple illustre comment utiliser par programme les flux de processus d’entreprise, tels que la récupération d’instances de flux de processus d’entreprise pour une ligne de table, la récupération du chemin d’accès actif d’une instance de flux de processus d’entreprise et de ses phases de processus et le changement de phase active. Pour plus d’informations sur ces concepts, consultez Utiliser des flux de processus métier à l’aide de code

Cet exemple peut être téléchargé à partir de Exemple : Utiliser les flux de processus d’entreprise.

Conditions préalables

Avant d’exécuter l’exemple, vous devez :

1. Avoir accès à un environnement Dataverse.

2. Disposer des privilèges appropriés sur les tables Prospect, Opportunité et Workflow et les lignes de table de définition de flux de processus d’entreprise utilisées dans cet exemple.

3. Disposer de Visual Studio 2015 ou d’une version ultérieure pour exécuter l’exemple.

4. Une connexion Internet est requise pour télécharger l’exemple de projet et restaurer les packages NuGet utilisés dans l’exemple de projet.

En quoi consiste cet exemple :

1. Crée un exemple de ligne Prospect. Une instance du flux de processus d’entreprise « Processus de vente Prospect-Opportunité » est automatiquement créée pour la ligne Prospect.

2. Convertit la ligne Prospect en ligne Opportunité.

3. Récupère les instances de flux de processus d’entreprise associées à la ligne « Opportunité » à l’aide du message RetrieveProcessInstances. La première ligne dans la collection retournée est l’instance active du flux de processus d’entreprise pour la ligne d’opportunité, à savoir « Processus de vente prospect-opportunité ».

4. Récupère le chemin d’accès actif et les phases de processus pour l’instance « Processus de vente prospect-opportunité » à l’aide du message RetrieveActivePath.

5. Récupère la phase actuellement active pour l’instance « Processus de vente prospect-opportunité », et demande à l’utilisateur s’il souhaite passer à la phase suivante. Après confirmation de l’utilisateur, définit la phase suivante dans le chemin d’accès actif comme phase active pour l’instance « Processus de vente prospect-opportunité ».

6. Enfin, l’utilisateur est invité à supprimer les lignes créées pendant l’exécution de l’exemple.

   Voici la sortie de l’exemple :

   

Exécuter l’exemple

1. Téléchargez l’exemple de projet WorkWithBPFVisual Studio et extrayez-le dans un dossier de votre ordinateur.

2. Recherchez le fichier WorkWithBPF.sln dans le dossier d’extraction et ouvrez-le dans Visual Studio.

3. L’exemple de projet utilise des packages NuGet qui doivent être restaurés avant d’exécuter l’exemple. Vérifiez que la restauration automatique des packages NuGet est activée dans Visual Studio. Pour plus d’informations : Activation et désactivation de la restauration des packages NuGet

   Sinon, sélectionnez Projet>Gérer les packages NuGet, puis sélectionnez Restaurer pour restaurer manuellement les packages utilisés dans l’exemple.

4. Appuyez sur F5 ou sélectionnez Débogage>Démarrer le débogage.

5. Si vous n’avez pas encore exécuté un des exemples, vous devez entrer des informations pour exécuter le code, sinon, entrez le numéro d’une des instances que vous avez configurées.

   Invite	Description
   Entrer un nom de serveur Dynamics 365 et de port CRM [crm.dynamics.com]	Tapez le nom du serveur Dynamics 365. La valeur par défaut est Dynamics 365 (online) (crm.dynamics.com) en Amérique du Nord. Exemple : crm5.dynamics.com
   Est-ce que cette organisation est mise en service dans les services en ligne de Microsoft (y/n) [n] ?	Tapez y s’il s’agit d’une organisation mise en service dans les services en ligne de Microsoft. Sinon, tapez n.
   Entrez le domaine\nomutilisateur.	Tapez votre compte Microsoft.
   Entrez le mot de passe.	Tapez votre mot de passe. Dans la fenêtre, les caractères s’afficheront sous la forme de « * ». Le mot de passe est enregistré de façon sécurisée dans le gestionnaire d’informations d’identification Microsoft pour être réutilisé ultérieurement.
   Spécifiez un numéro d’organisation (1-n) [1]	Dans la liste des organisations auxquelles vous appartenez, tapez le numéro correspondant. La valeur par défaut est 1, indiquant la première organisation de la liste.

6. L’exemple effectuera les opérations décrites dans En quoi consiste cet exemple ? et pourra vous demander des options supplémentaires.

7. À la fin de l’exemple, appuyez sur ENTRÉE pour fermer la fenêtre de la console.