Micro-apps

Intégrer MS Dynamics CRM

L’intégration Microsoft Dynamics CRM vous permet de surveiller et de gérer les leads, les opportunités et les incidents sans nécessiter de connexions supplémentaires.

Utilisez le processus suivant pour activer l’intégration MS Dynamics CRM. Vérifiez les conditions préalables, enregistrez la nouvelle application, obtenez la valeur de clé et déléguez les autorisations.

Pour obtenir une liste complète des micro-apps Jira prêtes à l’emploi, consultez la section Utiliser les micro-apps MS Dynamics CRM.

Vérifier les conditions préalables

Créez un compte Office 365 dédié pour configurer l’intégration. Une fois ce processus terminé, votre niveau de journalisation d’audit existant est conservé, y compris toute action effectuée par l’utilisation des micro-apps Citrix.

Une fois l’intégration dans MS Dynamics CRM configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace :

  • Adresse URL d’autorisation d’authentification unique
  • ID de l’application (client)
  • Valeur de clé secrète
  • Détails du compte MS Dynamics CRM valide

Assurez-vous de remplir les conditions préalables suivantes.

  • Si votre serveur interne hébergeant Workspace se trouve derrière un pare-feu, autorisez l’accès au nom d’hôte www.dynamics.com avec le port 443, afin que Workspace puisse se connecter au cloud MS Dynamics CRM.

  • Adresse URL d’autorisation d’authentification unique (fournie par Citrix). Configurez Citrix Gateway pour prendre en charge l’authentification unique pour MS Dynamics : une fois que les utilisateurs se connectent, ils sont automatiquement reconnectés sans avoir à entrer leurs informations d’identification une seconde fois. Pour plus d’informations sur la configuration de l’authentification unique (SSO, Single Sign-ON), consultez la section Citrix Gateway Service.

  • Compte Office 365 dédié que vous utilisez pour configurer l’intégration MS Dynamics CRM. Ce compte dédié doit disposer de privilèges d’accès complet aux données dans MS Dynamics CRM (Administrateur système). Pour de plus amples informations, consultez Create users in Dynamics 365 for Customer Engagement apps and assign security roles.

Enregistrer vos URL d’application et de rappel

Enregistrez votre nouvelle application, ajoutez des URL de rappel et obtenez l’ID de l’application.

  1. Connectez-vous à https://portal.azure.com.
  2. Sélectionnez Azure Active Directory > Inscriptions des applications > + Nouvelle inscription.
  3. Entrez le nom que vous souhaitez utiliser pour l’application, sélectionnez vos types de compte pris en charge en fonction de vos besoins organisationnels. Sélectionnez M’aider à choisir pour obtenir des conseils sur cette option.
  4. Ajoutez une adresse URL personnalisée à votre configuration d’instance pour accorder l’accès aux données privées et activer les actions utilisateur authentifiées par OAuth. Sous URI de redirection (facultatif), sélectionnez Web et entrez les deux URL de rappel suivantes et l’URL de base de votre instance MS Dynamics. Il s’agit de la même URL que vous devez entrer dans l’interface utilisateur des micro-apps lors de la configuration de l’intégration. Le premier rappel répertorié ne change pas. Le second rappel dépend de l’application cible et se trouve dans votre barre d’adresse URL lors de la création de l’intégration. La section {yourmicroappserverurl} est composée d’une partie locataire, d’une partie région et d’une partie environnement : https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com :

    • https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.dynamics.DynamicsCrmService/auth/serverContext
    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
    • Votre URL de base est la partie cohérente de votre adresse Web que vous utilisez pour cette intégration. Pa exemple : https://app.{yoursaasapp}.com
  5. Copiez l’ID de l’application (client) que vous utiliserez lorsque vous ajoutez l’intégration aux micro-apps Citrix Workspace. Copiez également l’URI de l’ID d’application et stockez-le pour une utilisation ultérieure si nécessaire.

Activer les autorisations déléguées

L’utilisation d’autorisations déléguées permet à l’application d’agir en tant qu’utilisateur connecté lors des appels à la ressource cible.

  1. Dans la vue de votre application enregistrée, sélectionnez Autorisations d’API et + Ajouter une autorisation.
  2. Sélectionnez la vignette Dynamics CRM et sous Quel type d’autorisation votre application nécessite-t-elle ?, sélectionnez la vignette Autorisations déléguées.
  3. Cochez la case correspondant aux autorisations à ajouter, puis sélectionnez Ajouter des autorisations en bas de la page.

Générer une valeur de clé secrète

Générez une chaîne secrète que l’application utilise pour prouver son identité lors de la demande d’un jeton.

  1. Sélectionnez Certificats et secrets. Sélectionnez + Nouvelle clé secrète client.
  2. Entrez une description associée à la clé secrète client.
  3. Sous Expire, sélectionnez Jamais. Sélectionnez Ajouter.
  4. Copiez et enregistrez la valeur de la clé secrète client qui a été créée. Celle-ci n’est pas visible une fois que vous quitté cette page.

Ajouter l’intégration aux micro-apps Citrix Workspace

Ajoutez l’intégration MS Dynamics CRM aux micro-apps Citrix Workspace pour vous connecter à votre application. Des micro-apps prêtes à l’emploi sont proposées, ainsi que des notifications et des actions préconfigurées qui sont prêtes à être utilisées dans votre espace de travail.

Procédez comme suit :

  1. Dans la page de vue d’ensemble, sélectionnez Démarrer.

    La page Gérer les intégrations s’ouvre.

  2. Sélectionnez Ajouter une nouvelle intégration et Ajouter une nouvelle intégration à partir des modèles fournis par Citrix.
  3. Choisissez la vignette MS Dynamics CRM à ajouter.
  4. Donnez un nom à l’intégration.

    Paramètres du connecteur MS Dynamics CRM : URL, ID de l'application, Clé, Autorisation OAuth

  5. Renseignez la section Paramètres du connecteur avec les informations que vous avez obtenues dans les procédures précédentes.
    • Entrez l’URL.
    • Renseignez les champs ID de l’application et Clé.
    • Activez Utiliser l’autorisation OAuth utilisateur dans Actions si vous avez besoin d’OAuth dans les actions de micro-app.
    • Sélectionnez Se connecter avec le compte MS Dynamics CRM pour activer l’autorisation OAuth. Une page de connexion s’ouvre dans un nouvel onglet. Vous êtes invité à entrer un nom de compte, à confirmer l’accès et à entrer un mot de passe.
  6. Sélectionnez Ajouter.

La page Intégrations de micro-apps s’ouvre avec votre intégration ajoutée et ses micro-apps associées. À partir de là, vous pouvez ajouter une autre intégration, continuer à configurer vos micro-apps prêtes à l’emploi ou créer une nouvelle micro-app pour cette intégration.

Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données. Vous pouvez extraire une grande quantité de données de vos applications intégrées vers la plate-forme de micro-apps. Par conséquent, nous vous recommandons d’utiliser la page Tableau pour filtrer les entités de votre première synchronisation de données afin d’accélérer la synchronisation.

Pour plus d’informations, consultez les sections Vérifier les entités requises et Définir la synchronisation des données dans l’article Configurer l’intégration.

Pour plus d’informations sur les points de terminaison d’API et les entités de table, consultez la section Spécifications du connecteur MS Dynamics.

Utiliser les micro-apps MS Dynamics CRM

Les intégrations d’application existantes sont fournies avec des micro-apps prêtes à l’emploi. Commencez avec ces micro-apps et personnalisez-les en fonction de vos besoins.

Micro-apps MS Dynamics CRM

L’intégration MS Dynamics CRM est fournie avec les micro-apps prêtes à l’emploi préconfigurées suivantes :

Comptes : permet de rechercher, d’afficher et de modifier des comptes.

Notification ou Page Workflows de cas d’utilisation
Notification Compte qui vous a été attribué (existant) Lorsque le propriétaire d’un compte est modifié, le nouveau propriétaire reçoit une notification.
Notification Compte qui vous a été attribué (nouveau) Lorsqu’un nouveau compte est attribué à un utilisateur, celui-ci reçoit une notification.
Page Détails du compte Fournit les détails d’un compte et ses contacts répertoriés, y compris un lien vers les coordonnées correspondantes.
Page Détails du contact Fournit les détails associés à un contact.
Page Modifier le compte Fournit un formulaire permettant de mettre à jour les détails d’un compte.
Page Mes comptes Fournit une vue tabulaire des comptes d’un utilisateur avec fonctionnalité de recherche, y compris un lien vers les détails correspondants.

Rendez-vous : permet de rechercher, d’afficher et de modifier les rendez-vous.

Notification ou Page Workflows de cas d’utilisation
Notification Rendez-vous qui vous a été attribué (existant) Lorsque le propriétaire d’un rendez-vous est modifié, le nouveau propriétaire reçoit une notification.
Notification Rendez-vous qui vous a été attribué (nouveau) Lorsqu’un nouveau rendez-vous est attribué à un utilisateur, celui-ci reçoit une notification.
Page Détails du compte Fournit les détails d’un compte et ses contacts répertoriés, y compris un lien vers les coordonnées correspondantes.
Page Détails du rendez-vous Fournit les détails associés à un rendez-vous.
Page Détails de la requête Fournit les détails associés à un incident.
Page Détails du contact Fournit les détails associés à un contact.
Page Modifier rendez-vous Fournit un formulaire permettant de mettre à jour les détails associés à un rendez-vous.
Page Détails du lead Fournit les détails associés à un lead.
Page Mes rendez-vous actifs Fournit une vue tabulaire des rendez-vous d’un utilisateur avec fonctionnalité de recherche, y compris un lien vers les détails correspondants.
Page Détails de l’opportunité Fournit les détails associés à une opportunité.

Incidents : permet de rechercher, d’afficher et de modifier des incidents.

Notification ou Page Workflows de cas d’utilisation
Notification Requête qui vous a été attribuée (existante) Lorsque le propriétaire d’une requête est modifié, le nouveau propriétaire reçoit une notification.
Notification Requête qui vous a été attribuée (nouveau) Lorsqu’une nouvelle requête est attribuée à un utilisateur, celui-ci reçoit une notification.
Page Détails du compte Fournit les détails d’un compte et ses contacts répertoriés, y compris un lien vers les coordonnées correspondantes.
Page Détails de la requête Fournit les détails associés à un incident.
Page Incident résolu Fournit un formulaire permettant de résoudre un incident.
Page Détails du contact Fournit les détails associés à un contact.
Page Modifier la requête Fournit un formulaire permettant de mettre à jour les détails d’un incident.
Page Mes requêtes en cours Fournit une vue tabulaire des incidents ouverts d’un utilisateur avec fonctionnalité de recherche, y compris un lien vers les détails correspondants.

Contacts : permet de rechercher, d’afficher et de modifier des contacts.

Notification ou Page Workflows de cas d’utilisation
Notification Contact qui vous a été attribué (existant) Lorsque le propriétaire d’un contact est modifié, le nouveau propriétaire reçoit une notification.
Notification Contact qui vous a été attribué (nouveau) Lorsqu’un nouveau contact est attribué à un utilisateur, celui-ci reçoit une notification.
Page Détails du compte Fournit les détails d’un compte et ses contacts répertoriés, y compris un lien vers les coordonnées correspondantes.
Page Détails du contact Fournit les détails associés à un contact.
Page Modifier le contact Fournit un formulaire permettant de mettre à jour les détails d’un contact.
Page Mes contacts Fournit une vue tabulaire des contacts d’un utilisateur avec fonctionnalité de recherche, y compris un lien vers les détails correspondants.

Créer un compte : permet de créer un compte.

Notification ou Page Workflows de cas d’utilisation
Page Créer un compte Fournit une page permettant d’envoyer un nouveau compte, ainsi que ses détails correspondants.

Créer un rendez-vous : permet de créer un rendez-vous.

Notification ou Page Workflows de cas d’utilisation
Page Créer un rendez-vous Fournit une page permettant d’envoyer un nouveau rendez-vous, ainsi que ses détails correspondants.

Créer un incident : permet de créer un incident.

Notification ou Page Workflows de cas d’utilisation
Page Créer une requête Fournit une page permettant d’envoyer un nouvel incident, ainsi que ses détails correspondants.

Créer un contact : permet de créer un contact.

Notification ou Page Workflows de cas d’utilisation
Page Créer un contact Fournit une page permettant d’envoyer un nouveau contact, ainsi que ses détails correspondants.

Créer un lead : permet de créer un lead.

Notification ou Page Workflows de cas d’utilisation
Page Créer un lead Fournit une page permettant d’envoyer un nouveau lead, ainsi que ses détails correspondants.

Créer une opportunité : permet de créer une opportunité.

Notification ou Page Workflows de cas d’utilisation
Page Créer une opportunité Fournit une page permettant d’envoyer une nouvelle opportunité, ainsi que ses détails correspondants.

Créer un appel téléphonique : permet de créer un appel téléphonique.

Notification ou Page Workflows de cas d’utilisation
Page Créer un appel téléphonique Fournit une page permettant d’envoyer un nouvel appel téléphonique, ainsi que ses détails correspondants.

Créer une tâche : permet de créer une tâche.

Notification ou Page Workflows de cas d’utilisation
Page Créer une tâche Fournit une page permettant d’envoyer une nouvelle tâche, ainsi que ses détails correspondants.

Leads : permet de rechercher, d’afficher et de modifier des leads.

Notification ou Page Workflows de cas d’utilisation
Notification Lead qui vous a été attribué (existant) Lorsque le propriétaire d’un lead est modifié, le nouveau propriétaire reçoit une notification.
Notification Lead qui vous a été attribué (nouveau) Lorsqu’un nouveau lead est attribué à un utilisateur, celui-ci reçoit une notification.
Page Modifier lead Fournit un formulaire permettant de mettre à jour les détails d’un lead.
Page Détails du lead Fournit les détails associés à un lead.
Page Mes leads actifs Fournit une vue tabulaire des leads actifs d’un utilisateur avec fonctionnalité de recherche, y compris un lien vers les détails correspondants.

Opportunités : permet de rechercher, d’afficher et de modifier des opportunités.

Notification ou Page Workflows de cas d’utilisation
Notification Opportunité qui vous a été attribuée (existante) Lorsque le propriétaire d’une opportunité est modifié, le nouveau propriétaire reçoit une notification.
Notification Opportunité qui vous a été attribuée (nouvelle) Lorsqu’une nouvelle opportunité est attribuée à un utilisateur, celui-ci reçoit une notification.
Page Détails du compte Fournit les détails d’un compte et ses contacts répertoriés, y compris un lien vers les coordonnées correspondantes.
Page Clôturé car non conclu Fournit un formulaire permettant de clôturer une opportunité car elle n’a pas été conclue, ainsi que ses détails correspondants.
Page Clôturé car conclu Fournit un formulaire permettant de clôturer une opportunité car elle a été conclue, ainsi que ses détails correspondants.
Page Détails du contact Fournit les détails associés à un contact.
Page Modifier opportunité Fournit un formulaire permettant de mettre à jour les détails d’une opportunité.
Page Mes opportunités ouvertes Fournit une vue tabulaire des opportunités ouvertes d’un utilisateur avec fonctionnalité de recherche, y compris un lien vers les détails correspondants.
Page Détails de l’opportunité Fournit les détails associés à une opportunité.

Appels téléphoniques : permet de rechercher, d’afficher et de modifier des appels téléphoniques.

Notification ou Page Workflows de cas d’utilisation
Notification Appel téléphonique qui vous a été attribué (existant) Lorsque le propriétaire d’un appel téléphonique est modifié, le nouveau propriétaire reçoit une notification.
Notification Appel téléphonique qui vous a été attribué (nouveau) Lorsqu’un nouvel appel téléphonique est attribué à un utilisateur, celui-ci reçoit une notification.
Page Détails du compte Fournit les détails d’un compte et ses contacts répertoriés, y compris un lien vers les coordonnées correspondantes.
Page Détails de la requête Fournit les détails associés à un incident.
Page Détails du contact Fournit les détails associés à un contact.
Page Modifier un appel téléphonique Fournit un formulaire permettant de mettre à jour les détails d’un appel téléphonique.
Page Mes appels téléphoniques actifs Fournit une vue tabulaire des appels téléphoniques actifs d’un utilisateur avec fonctionnalité de recherche, y compris un lien vers les détails correspondants.
Page Détails de l’opportunité Fournit les détails associés à une opportunité.
Page Détails de l’appel téléphonique Fournit les détails associés à un appel téléphonique.

Tâches : permet de rechercher, d’afficher et de modifier des tâches.

Notification ou Page Workflows de cas d’utilisation
Notification Tâche qui vous a été attribuée (existante) Lorsque le propriétaire d’une tâche est modifié, le nouveau propriétaire reçoit une notification.
Notification Tâche qui vous a été attribuée (nouvelle) Lorsqu’une nouvelle tâche est attribuée à un utilisateur, celui-ci reçoit une notification.
Page Détails du compte Fournit les détails d’un compte et ses contacts répertoriés, y compris un lien vers les coordonnées correspondantes.
Page Détails de la requête Fournit les détails associés à un incident.
Page Détails du contact Fournit les détails associés à un contact.
Page Modifier la tâche Fournit un formulaire permettant de mettre à jour les détails d’une tâche.
Page Détails du lead Fournit les détails associés à un lead.
Page Mes tâches en cours Fournit une vue tabulaire des tâches en cours d’un utilisateur avec fonctionnalité de recherche, y compris un lien vers les détails correspondants.
Page Détails de l’opportunité Fournit les détails associés à une opportunité.
Page Détails de la tâche Fournit les détails associés à une tâche.