Dynamics 365 CRM
Microsoft Dynamics 365 CRM est une plateforme d'applications métier dans le Cloud qui combine des composants de CRM (gestion de la relation client) et d'ERP (planification des ressources de l'entreprise) ainsi que des applications de productivité et des outils d'intelligence artificielle.
Le CRM est une catégorie de solutions intégrées, orientées données, qui améliorent la façon dont vous interagissez et traitez avec vos clients. Les systèmes et applications CRM sont conçus pour optimiser la gestion et le développement de la relation client, le suivi des engagements et des ventes, ainsi que la production de données exploitables, le tout de manière centralisée.
Les outils CRM apportent une précieuse contribution aux fonctions de l'entreprise en contact avec le client, en aidant notamment l'utilisateur à :
• centraliser les informations client ;
• automatiser les interactions marketing ;
• produire de l'information décisionnelle ;
• faciliter les communications ;
• assurer le suivi des opportunités de vente ;
• analyser les données ;
• assurer un service clientèle réactif.
Avec le connecteur Dynamics 365 CRM, vous pouvez exécuter des opérations de lecture, de création, de mise à jour et de suppression sur les entités, ainsi que des opérations de création, de mise à jour et de suppression sur les associations. Vous pouvez réaliser des importations d'actions et de fonctions Dynamics 365 CRM.
Pour utiliser les actions Dynamics 365 CRM, vous devez autoriser le connecteur au moyen de la procédure ci-après.
Disponibilité du connecteur
Le connecteur Dynamics 365 CRM est disponible depuis la version 8.4.1.
Actions prises en charge
Déclencheurs pris en charge
Autorisation prise en charge
OAuth
 |
Autoriser Dynamics 365 CRM
Une autorisation Dynamics 365 CRM est nécessaire pour chaque action du connecteur Dynamics 365 CRM. Pour autoriser le connecteur Dynamics 365 CRM, procédez comme suit :
1. Dans le champ Autoriser Dynamics 365 CRM, sélectionnez Ajouter nouvelle session Dynamics 365. La fenêtre Paramètres s'ouvre.
2. Définissez ce qui suit :
◦ ID du locataire : ID de locataire Dynamics 365 CRM. Si vous n'en disposez d'aucun, spécifiez common.
◦ URL de ressource : URL de ressource Dynamics 365 CRM.
◦ Set Access : la case à cocher User Impersonation permet d'exécuter la logique applicative (code) pour le compte d'un autre utilisateur Dynamics 365 CRM afin de fournir une fonctionnalité ou un service souhaité en utilisant le rôle approprié et la sécurité objet de cet utilisateur impersonné.
3. Cliquez sur AUTORISER.
4. Spécifiez vos informations d'identification, puis cliquez sur Sign in.
5. Renommez l'Etiquette d'autorisation, si nécessaire, puis cliquez sur AJOUTER. Une nouvelle autorisation est ajoutée à la liste.
| | Cliquez sur TESTER pour valider l'autorisation. |
Personnalisation du connecteur Dynamics 365 CRM
La section ci-après fournit des instructions détaillées pour le chargement de fichiers de personnalisation. Assurez-vous que les outils ThingWorx Flow sont installés sur votre système avant d'entamer les étapes de personnalisation. Les outils ThingWorx Flow sont automatiquement installés avec votre installation. Pour pouvoir exécuter cette opération, vous devez disposer d'informations d'identification d'administrateur ThingWorx. Pour plus d'informations sur les outils ThingWorx Flow, consultez la rubrique
Déploiement de connecteurs.
Vous pouvez personnaliser le connecteur Dynamics 365 CRM de l'une des manières suivantes :
• Mise à jour des métadonnées OData : les packages Dynamics 365 CRM Connector version 9.0 des métadonnées OData. Il se peut que vous ayez besoin d'une version différente ou que vous ayez ajouté des personnalisations à votre version. Ceci nécessitera une mise à jour de ce fichier. Vous pouvez télécharger la version packagée du fichier des métadonnées Dynamics 365 CRM pour référence et charger votre version ou une version mise à jour sur votre instance de ThingWorx Flow.
• En standard, ThingWorx Flow ne prend en charge que quelques entités du modèle Dynamics 365 CRM. Le fichier
settings.json tel que fourni prêt à l'emploi inclut uniquement ces entités prises en charge. En revanche, les métadonnées OData packagées incluent toutes les entités, associations et tout ce que Microsoft prend en charge. Vous pouvez tester le connecteur pour d'autres entités et les inclure dans la liste des entités, propriétés et éléments connexes disponibles pour le connecteur en mettant à jour le fichier
settings.json. Ensuite, il ne vous reste qu'à charger celui-ci sur votre instance de ThingWorx Flow. Soyez prudent lors de la modification de ce fichier, toute erreur syntaxique pourrait rendre le connecteur inutilisable. Pour comprendre comment mettre à jour ce fichier, téléchargez le fichier packagé et faites des comparaisons croisées avec le fichier des métadonnées OData en vigueur.
La table suivante fournit des informations sur les attributs que vous pouvez mettre à jour dans le
fichier settings.json du connecteur Dynamics 365 CRM pour personnaliser le connecteur Dynamics 365 CRM :
Attribut | Description | ||
|---|---|---|---|
DynamicsApiVersion | Spécifie la version de l'API Dynamics 365 CRM. Par défaut, la valeur est 9.0. | ||
EntitySetDefinitions propertyDefinitions | Définit les jeux d'entités Dynamics 365 CRM à afficher dans l'interface utilisateur de ThingWorx Flow. Par exemple : pour inclure le jeu d'entités accounts dans l'interface utilisateur, sous l'attribut EntitySetDefinitions, spécifiez ce qui suit : "name": "accounts", "include": true, "label": "Account", où name indique le nom du jeu d'entités Dynamics 365 CRM. Définissez include sur vrai pour afficher le jeu d'entités dans l'interface utilisateur. L'attribut label définit le nom sous lequel vous souhaitez afficher le jeu d'entités dans l'interface utilisateur. Chaque jeu d'entités possède des propriétés. Définissez les propriétés de tout jeu d'entités que vous souhaitez afficher dans l'interface utilisateur sous l'attribut propertyDefinitions. Vous pouvez limiter le nombre de propriétés d'un jeu d'entités à afficher dans l'interface utilisateur en spécifiant des tableaux name et label pour chaque propriété à afficher. Par exemple : pour afficher la propriété accountid, sous l'attribut propertyDefinitions de l'attribut accounts EntitySetDefinitions, spécifiez ce qui suit : { "name": "accountid", "label": "Account ID" } où name spécifie le nom de la propriété. L'attribut label définit le nom sous lequel vous souhaitez afficher la propriété dans l'interface utilisateur. Si vous souhaitez inclure toutes les propriétés du jeu d'entités, donnez à propertyDefinitions la valeur d'un tableau vide, à savoir "propertyDefinitions": [].
| ||
relatedItems | Si vous ajoutez des éléments connexes, les données du jeu d'entités renvoyées incluront celles des éléments connexes pour ce jeu d'entités particulier. Par exemple : pour afficher la propriété attachments, sous l'attribut relatedItems de l'attribut accounts EntitySetDefinitions, spécifiez ce qui suit : { "name": "attachments", "label": "Attachments" } où name spécifie le nom de l'élément connexe. L'attribut label définit le nom sous lequel vous souhaitez afficher l'élément connexe dans l'interface utilisateur. Si vous ne souhaitez pas inclure d'éléments connexes pour le jeu d'entités, donnez à relatedItems la valeur d'un tableau vide, à savoir relatedItems: []. |
Chargement du fichier des métadonnées OData
1. Téléchargez votre version du fichier des métadonnées en y accédant à partir de votre instance de Dynamics 365 CRM. Par exemple : https://host.dynamics.com/api/data/v9.0/$metadata. Notez que le numéro de version doit correspondre à la version de votre instance.
Vous pouvez également télécharger la version packagée avec ThingWorx Flow en exécutant la commande suivante :
flow-deploy settings file-download -t <URL_de_base_ThingWorx> -u <Nom_utilisateur_administrateur_ThingWorx> -p '<Mot_de_passe_administrateur_ThingWorx>' -f <Chemin_vers_fichier_XML_métadonnées> -s default -c dynamics365 --fileId DynamicsMetadata --contentType application/xml
| | La valeur du paramètre fileId doit être définie sur DynamicsMetadata. |
2. Ouvrez le fichier XML et vérifiez que votre personnalisation requise, le cas échéant, figure dans le fichier XML téléchargé. Modifiez le fichier pour ajouter votre personnalisation, si nécessaire.
3. Exécutez la commande suivante pour charger votre fichier des métadonnées OData personnalisé sur votre instance ThingWorx Flow :
flow-deploy settings file-upload -t <URL_de_base_ThingWorx> -u <Nom_utilisateur_administrateur_ThingWorx> -p '<Mot_de_passe_administrateur_ThingWorx>' -f <Chemin_vers_fichier_XML_métadonnées> -s default -c dynamics365 --fileId DynamicsMetadata --contentType application/xml
| | La valeur du paramètre fileId doit être définie sur DynamicsMetadata. |
Chargement du fichier settings.json
1. Exécutez la commande suivante pour télécharger le fichier settings.json packagé avec ThingWorx Flow :
flow-deploy settings download -t <URL_base_ThingWorx> -u <Nom_utilisateur_administrateur_ThingWorx> -p '<Mot_de_passe_administrateur_ThingWorx>' -f <Chemin_vers_fichier_paramètres_connecteur> -s default -c dynamics365
2. Modifiez le fichier settings.json et assurez-vous qu'il est compatible avec le fichier des métadonnées OData que vous souhaitez utiliser et qu'il est prêt à être chargé.
Assurez-vous que la valeur de DynamicsApiVersion dans le fichier settings.json correspond à la version figurant dans le fichier des métadonnées OData que vous avez chargé précédemment.
3. Exécutez la commande suivante pour charger le fichier settings.json du connecteur Dynamics 365 CRM :
flow-deploy settings upload -t <URL_base_ThingWorx> -u <Nom_utilisateur_administrateur_ThingWorx> -p '<Mot_de_passe_administrateur_ThingWorx>' -f <Chemin_vers_fichier_paramètres_connecteur> -s default -c dynamics365
Une fois les chargements effectués, redémarrez tous les services ThingWorx Flow. Votre personnalisation est désormais visible pour toutes les actions Dynamics 365 CRM.