Intégrer Salesforce

L’intégration Salesforce vous permet d’accéder aux leads, aux comptes, aux opportunités, aux requêtes et aux contrats à partir de n’importe quel emplacement.

Utilisez le processus suivant pour activer l’intégration Salesforce. Assurez-vous de remplir les conditions préalables, puis configurez l’intégration Salesforce. 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.

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

Vérifier les conditions préalables

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

  • Nom d’utilisateur
  • Mot de passe
  • Jeton de sécurité

Pour OAuth 2.0 :

  • Clé du client
  • Secret du client

Remarque :

Nous vous recommandons de toujours utiliser OAuth 2.0 comme méthode d’authentification de service lorsque cette méthode est disponible. OAuth 2.0 garantit que votre intégration respecte la conformité maximale en matière de sécurité avec votre micro-app configurée.

L’intégration nécessite un accès régulier à l’API pour votre instance Salesforce. Nous vous recommandons donc de créer un compte utilisateur dédié dans Salesforce. Utilisez ensuite ce compte pour configurer l’intégration Salesforce. Ce compte doit répondre aux exigences suivantes :

  • Disposer de privilèges d’accès complet aux données
  • Avoir l’accès à API activé
  • Ne pas autoriser l’authentification à deux facteurs

L’utilisation d’un compte dédié est utile pour les journaux d’audit car il permet de distinguer les activités effectuées via Workspace. Cette page contient des didacticiels pour Salesforce Classic et Salesforce Lightning Experience. Les deux didacticiels supposent que vous êtes administrateur système dans Salesforce.

Remarque :

Les éditions « Contact » et « Group » de Salesforce ne prennent en charge aucune API. L’édition « Professional » n’inclut pas l’API automatiquement. Cependant, le support peut être activé sur demande.

Le nombre de requêtes d’API est également limité dans Salesforce. Si vous prévoyez de synchroniser fréquemment un grand nombre de données, consultez la section Salesforce API Request Limits and Allocations.

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

Ajouter un nouveau profil

Procédez comme suit :

  1. Connectez-vous à www.salesforce.com.
  2. Accédez à l’icône Setting et sélectionnez Setup > Administration > Manage Users > Profiles > New Profile.
  3. Définissez le champ Existing Profile sur System Administrator pour vous assurer que l’utilisateur que vous créez pour ce profil dispose de privilèges d’accès complet aux données.
  4. Donnez un nom au profil, puis sélectionnez Save. Nous vous recommandons d’utiliser un nom de profil tel que Citrix Workspace Access pour faciliter l’ajout du profil en tant que nouvel utilisateur dans une procédure ultérieure.

    Un panneau Profile s’ouvre et affiche votre nouveau profil.

Activer l’accès à l’API pour le profil créé

  1. Dans le panneau Profile, sélectionnez Edit.
  2. Faites défiler la page jusqu’à la section Administrative Permissions et cochez la case API Enabled.
  3. (Facultatif) Pour désactiver l’expiration du mot de passe, cochez la case Password Never Expires.

    Remarque :

    L’utilisation de cette option représente une faille de sécurité potentielle.

  4. Sélectionnez Save.

Ajouter des URL de rappel

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

  1. Connectez-vous à Salesforce en tant qu’administrateur.
  2. Accédez à Platform Tools > Apps > App Manager.
  3. Sélectionnez New Connected App.
  4. Sous Basic Information, renseignez les champs suivants :
    • Connected App Name
    • API Name
    • Contact Email
  5. Sous API, activez la case à cocher Enable OAuth Settings.
  6. Dans le champ Callback URL, ajoutez les adresses URL de redirection autorisées suivantes, ainsi que l’adresse URL de votre serveur de micro-app :

    • https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.salesforce.SalesforceService/auth/serverContext
    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
  7. En regard de Selected OAuth Scopes, choisissez les champs d’application suivants sous Available OAuth Scopes, puis sélectionnez Add pour les déplacer dans le champ Selected OAuth Scopes :
    • Access and manage your data (api)
    • Access your basic information (id, profile, email, address, phone)
    • Perform requests on your behalf any time (refresh_token, offline_access)
  8. Sélectionnez Save.

(Facultatif) Restreindre les plages d’adresses IP de connexion

Si votre organisation définit des plages d’adresses IP pour les profils utilisateur, vous pouvez contrôler l’accès à la connexion au niveau de l’utilisateur. Spécifiez une plage d’adresses IP autorisées sur le profil d’un utilisateur. Pour de plus amples informations, consultez Restrict Log-in IP Ranges in the Enhanced Profile User Interface.

Si vous décidez de restreindre les plages d’adresses IP de connexion, vous n’avez pas besoin de générer un jeton de sécurité dans la procédure suivante.

Ajouter un nouvel utilisateur

Créez un compte utilisateur dédié utilisé pour se connecter à Salesforce. Utilisez le nouveau profil que vous avez ajouté dans la procédure précédente, Ajouter un nouveau profil.

Procédez comme suit :

  1. Accédez à Setup > Administer > Manage Users > Users > New User.
  2. Renseignez les champs obligatoires en rouge.
  3. Définissez User License sur Salesforce.
  4. Définissez Profile sur le profil que vous avez ajouté lors de la procédure précédente. Dans l’exemple ci-dessus, nous avons recommandé Citrix Workspace Access pour une référence facile lors de l’ajout du profil.
  5. Cliquez sur Save.

Configurer le nouvel utilisateur

Une fois un compte utilisateur dédié ajouté, vous recevez un e-mail à l’adresse que vous avez fournie.

Procédez comme suit :

  1. Recherchez l’e-mail et cliquez sur le lien comme indiqué.
  2. Connectez-vous à Salesforce.
  3. Définissez un mot de passe et une question liée au mot de passe.

Générer un jeton de sécurité

Si vous avez restreint les plages d’adresses IP de connexion pour le profil d’utilisateur dédié, vous pouvez ignorer cette étape. Le jeton de sécurité n’est pas requis pour les comptes se connectant à l’API Salesforce à partir d’un bloc d’IP sur liste blanche.

Procédez comme suit :

  1. Connectez-vous et sélectionnez le nom du compte.
  2. Accédez à My Settings > Personal > Reset My Security Token.
  3. Sélectionnez Reset Security Token.

    Le nouveau jeton de sécurité est envoyé à l’adresse e-mail que vous avez fournie dans les paramètres personnels de ce compte. Vous obtenez également un nouveau jeton de sécurité chaque fois que le mot de passe de ce compte est réinitialisé.

Vous pouvez maintenant terminer l’ajout de l’intégration. Renseignez les champs Username et Password du compte utilisateur dédié dans les champs de saisie de la définition du service Salesforce.

Si vous avez répertorié l’adresse IP sur liste blanche, vous n’avez pas besoin d’entrer un jeton de sécurité. Sinon, collez le jeton de sécurité qui a été envoyé à l’adresse e-mail du compte dédié.

Filtrer les requêtes

La plupart des entités Salesforce prennent en charge le filtrage. Choisissez entre des requêtes prédéfinies ou écrivez vos propres requêtes personnalisées à l’aide du langage SOQL Salesforce. Pour de plus amples informations, consultez Documentation Salesforce Object Query Language.

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

Ajoutez l’intégration Salesforce 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 Salesforce.
  4. Donnez un nom à l’intégration.

    Paramètres du connecteur Salesforce : Nom d'utilisateur, Mot de passe, Authentification utilisateur, Jeton de sécurité

  5. Renseignez les sections Authentification de service et Paramètres du connecteur en utilisant les informations que vous avez obtenues dans les procédures précédentes.
    • Entrez vos informations d’identification Nom d’utilisateur et Mot de passe pour l’authentification du service de systèmes cibles.
    • Sélectionnez la Méthode d’authentification OAuth 2.0.
      • Entrez la Clé du client et le Secret du client que vous avez obtenus dans la procédure Vérifier les conditions préalables.
    • Entrez un Jeton de sécurité.
    • Activez Sandbox si vous souhaitez charger vos données dans un environnement sandbox.
    • Laissez le bouton bascule Interroger les enregistrements supprimés lors de la synchronisation incrémentielle pour les supprimer du cache activé. Si le système génère l’erreur suivante après votre première synchronisation incrémentielle, Impossible de charger les entités supprimées de type, vous pouvez désactiver cette option pour contourner le problème.
  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 Salesforce.

Utiliser les micro-apps Salesforce

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 Salesforce

L’intégration Salesforce 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 une vue détaillée d’un compte et de ses détails correspondants, y compris les contacts et les coordonnées associées.
Page Détails du contact Fournit la vue en lecture seule d’un contact et de ses détails correspondants.
Page Modifier le compte Fournit un formulaire permettant d’envoyer des modifications à un compte.
Page Mes comptes Fournit une liste personnalisée des comptes.

Requêtes : permet de rechercher, d’afficher et de modifier des requêtes qui vous sont attribuées.

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.
Notification Nouvelle requête liée à votre compte Lorsqu’une nouvelle requête concernant un compte utilisateur est créée, l’utilisateur reçoit une notification.
Page Détails du compte Fournit une vue détaillée d’un compte et de ses détails correspondants, y compris les contacts et les coordonnées associées.
Page Détails de la requête Fournit une vue détaillée d’une requête, ainsi qu’un bouton permettant d’ouvrir la page de modification.
Page Détails du contact Fournit la vue en lecture seule d’un contact et de ses détails correspondants.
Page Modifier la requête Fournit un formulaire permettant d’envoyer des modifications à une requête.
Page Mes requêtes en cours Fournit une liste personnalisée des requêtes attribuées à un utilisateur.

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 contact Fournit une vue détaillée d’un contact, ainsi qu’un bouton permettant d’ouvrir la page de modification.
Page Modifier le contact Fournit un formulaire permettant d’envoyer des modifications à un contact.
Page Mes contacts Fournit une liste personnalisée de contacts.

Contrats : permet de rechercher, d’afficher et de modifier des contrats.

Notification ou Page Workflows de cas d’utilisation
Notification Contrat mis à jour Lorsqu’un détail d’un contrat est modifié, le propriétaire du contrat reçoit une notification.
Notification Contrat arrivant à expiration Lorsqu’un contrat dépasse un seuil défini avant ou après sa date de fin (par exemple, 3 jours par défaut), le propriétaire reçoit une notification.
Notification Nouveau contrat pour activation Lorsqu’une nouvelle demande d’approbation d’activation de contrat en attente est attribuée à un utilisateur, celui-ci reçoit une notification.
Page Détails du compte Fournit une vue détaillée d’un compte et de ses détails correspondants, y compris les contacts et les coordonnées associées.
Page Détails du contact Fournit la vue en lecture seule d’un contact et de ses détails correspondants.
Page Détails du contrat Fournit une vue détaillée d’un contrat, ainsi qu’un bouton permettant d’ouvrir la page de modification et d’activer le contrat.
Page Modifier le contrat Fournit un formulaire permettant d’envoyer des modifications à un contrat.
Page Mes contrats en attente d’activation Fournit une liste personnalisée des contrats en attente d’activation.

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

Notification ou Page Workflows de cas d’utilisation
Page Créer un compte Fournit un formulaire permettant d’envoyer un nouveau compte.

Créer une requête : permet de créer une requête.

Notification ou Page Workflows de cas d’utilisation
Page Créer une requête Fournit un formulaire permettant d’envoyer une nouvelle requête.

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

Notification ou Page Workflows de cas d’utilisation
Page Créer un contact Fournit un formulaire permettant d’envoyer un nouveau contact.

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

Notification ou Page Workflows de cas d’utilisation
Page Créer un contrat Fournit un formulaire permettant d’envoyer un nouveau contrat.

Créer un événement : permet de créer un événement.

Notification ou Page Workflows de cas d’utilisation
Page Créer un événement Fournit un formulaire permettant d’envoyer un nouvel événement.

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

Notification ou Page Workflows de cas d’utilisation
Page Créer un lead Fournit un formulaire permettant d’envoyer un nouveau lead.

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

Notification ou Page Workflows de cas d’utilisation
Page Créer une opportunité Fournit un formulaire permettant d’envoyer une nouvelle opportunité.

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 un formulaire permettant d’envoyer une nouvelle tâche.

Événements : permet de rechercher, d’afficher et de modifier les événements.

Notification ou Page Workflows de cas d’utilisation
Notification Rappel d’événement Lorsqu’un événement dépasse un seuil défini avant ou après sa date et son heure d’activité (par exemple, 1 heure par défaut), le propriétaire reçoit une notification.
Page Détails du compte Fournit une vue détaillée d’un compte et de ses détails correspondants, y compris les contacts et les coordonnées associées.
Page Détails du contact Fournit la vue en lecture seule d’un contact et de ses détails correspondants.
Page Modifier l’événement Fournit un formulaire permettant d’envoyer des modifications à un événement.
Page Détail de l’événement Fournit une vue détaillée d’un événement, ainsi qu’un bouton permettant d’ouvrir la page de modification.
Page Mes événements Fournit une liste personnalisée d’événements.

Leads : permet de rechercher, d’afficher, de modifier et de convertir 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 Convertir lead Fournit un formulaire permettant de convertir un lead.
Page Modifier lead Fournit un formulaire permettant d’envoyer des modifications à un lead.
Page Mes leads actifs Fournit une liste personnalisée de leads.

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 une vue détaillée d’un compte et de ses détails correspondants, y compris les contacts et les coordonnées associées.
Page Détails du contact Fournit la vue en lecture seule d’un contact et de ses détails correspondants.
Page Modifier opportunité Fournit un formulaire permettant d’envoyer des modifications à une opportunité.
Page Mes opportunités ouvertes Fournit une liste personnalisée d’opportunités.
Page Détails de l’opportunité Fournit une vue détaillée d’une opportunité, ainsi qu’un bouton permettant d’ouvrir la page de modification.

Approbations de compte en attente : permet de rechercher, d’approuver ou de rejeter des comptes.

Notification ou Page Workflows de cas d’utilisation
Notification Nouveau compte pour approbation Lorsqu’un nouveau compte est envoyé à un responsable pour approbation, celui-ci reçoit une notification.
Page Approuver le compte Fournit un formulaire permettant d’approuver ou de rejeter un compte.
Page Mes approbations de compte en attente Fournit une liste personnalisée des approbations de compte en attente, ainsi que des liens vers la page d’approbation.

Approbations de contacts en attente : permet de rechercher et d’approuver les contacts.

Notification ou Page Workflows de cas d’utilisation
Notification Nouveau contact pour approbation Lorsqu’un nouveau contact est envoyé à un responsable pour approbation, celui-ci reçoit une notification.
Page Approuver le contact Fournit un formulaire permettant d’approuver ou de rejeter un contact.
Mes approbations de contacts en attente Fournit une liste personnalisée des approbations de contacts en attente, ainsi que des liens vers la page d’approbation.

Approbations de contrats en attente : permet de rechercher et d’approuver les contrats.

Notification ou Page Workflows de cas d’utilisation
Notification Nouveau contrat pour approbation Lorsqu’un nouveau contrat est envoyé à un responsable pour approbation, celui-ci reçoit une notification.
Page Approuver le contrat Fournit un formulaire permettant d’approuver ou de rejeter un contrat.
Mes approbations de contrats en attente Fournit une liste personnalisée des approbations de contrats en attente, ainsi que des liens vers la page d’approbation.

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

Notification ou Page Workflows de cas d’utilisation
Notification Rappel de tâche Lorsqu’une tâche dépasse un seuil défini avant ou après sa date et son heure d’activité (par exemple, 1 heure par défaut), le propriétaire reçoit une notification.
Page Détails du compte Fournit une vue détaillée d’un compte et de ses détails correspondants, y compris les contacts et les coordonnées associées.
Page Détails du contact Fournit la vue en lecture seule d’un contact et de ses détails correspondants.
Page Modifier la tâche Fournit un formulaire permettant d’envoyer des modifications à une tâche.
Page Mes tâches en cours Fournit une liste personnalisée de tâches.
Page Détails de la tâche Fournit une vue détaillée d’une tâche, ainsi qu’un bouton permettant d’ouvrir la page de modification.

Ajouter un tableau de valeurs avec liste de sélection

En raison de la nature du schéma Salesforce, toutes les données ne sont pas disponibles en tant qu’entités de tableau. Utilisez le tableau de valeurs avec liste de sélection (picklistvalue) pour afficher les listes de sélection de chaque objet Salesforce et toutes ses options.

  1. Ouvrez une micro-app Salesforce et accédez au générateur de pages.
  2. Sélectionnez et faites glisser l’option Sélectionner associée à un composant vers le champ.
  3. Sous Sélectionner propriétés, désactivez le bouton Assigner à la colonne de données. Cela vous permet d’afficher tous les objets Salesforce.
  4. Sélectionnez l’élément de liste de sélection picklistvalue dans le menu Table de données.
  5. Sélectionnez Modifier le filtre pour ouvrir le filtre de données.
  6. Sélectionnez l’objet et le champ à partir desquels vous avez besoin de données. Sélectionnez Toutes les conditions doivent concorder et Enregistrer pour fermer le filtre. La capture d’écran suivante montre un exemple de configuration du filtre : Définir des filtres de valeur avec liste de sélection Cette capture d’écran montre les objets et les champs de la base de données auxquels nous essayons d’accéder : Exemple de base de données Salesforce
  7. Terminez la configuration de ce composant. Pour de plus amples informations, consultez Composants du générateur de pages.