Plug-in Salesforce du composant CX

Installez et configurez le plug-in UiPath CX Companion Salesforce pour intégrer CX Companion à Salesforce à l'aide d'événements externes.

Le plug-in UiPath CX Componion SFh permet l'intégration prête à l'emploi de CX Companion avec Salesforce lors de l'utilisation d'événements externes. Lisez les sections suivantes pour apprendre à installer et configurer le plugin.

Prérequis

Avant de commencer, vérifiez les éléments suivants:

• Vous disposez d’un accès au profil d’administrateur système .

  Remarque :

  Vous pouvez utiliser votre organisation Salesforce actuelle ou tester dans une org. de développement.

• Votre édition Salesforce est Enterprise, Clicklimit ou Developer.

Installation du package géré

1. Accédez à la liste AppExchange.

Suivez ces étapes pour installer le package géré UiPath-CX-Companion-SF-Plugin :

1. Ouvrez un navigateur Web et accédez à Salesforce AgentExchange.

2. Dans la barre de recherche, saisissez : Plug-in UiPath CX Component SFin.

3. Sélectionnez la liste de l'application, puis sélectionnez Obtenir maintenant.

4. Connectez-vous à l'aide de vos informations d'identification Salesforce.

5. Choisissez où installer et pour qui.

   1. Sélectionnez l'environnement vers lequel vous souhaitez installer :
      • Production : choisissez cette option si vous êtes prêt à utiliser l'application dans votre environnement Salesforce en direct.
      • Sandbox : choisissez cette option si vous souhaitez tester l'application avant de l'utiliser en production.
      Remarque :

      Cette étape n’est pas disponible si vous utilisez la version préliminaire du plug-in.

   2. Sélectionnez Installer pour des utilisateurs spécifiques.

   Vous pouvez choisir que ce package géré soit disponible à certains ou à tous les utilisateurs. 3. Sélectionnez « Je reconnais que j'installe une application non-Salesforce qui n'est pas autorisée pour la distribution dans le cadre du programme de partenaire AppExchange de Salesforce.» 4. Sélectionnez Installer. 5. Approuver l'accès de tiers pour https://*.uipath.com, ce qui permettra l'accès approuvé à l'application du CX Companion hébergée sur uipath.com. 6. Une fois l'installation terminée, sélectionnez Terminé.

   Après l'installation, le package géré nouvellement installé UiPath CX Componation SFin s'affiche dans la liste Packages installés.

   

Attribution des autorisations et du cache de la plate-forme

1. Attribuer des ensembles d'autorisations Suivez ces étapes pour vous assurer que les autorisations requises sont disponibles pour les utilisateurs pour lesquels vous avez installé le package géré.

   1. Accédez à Configuration > Utilisateurs > Ensemble d'autorisations et localisez le composant UiPath CX.
   2. Sélectionnez Gérer les affectations > Ajouter des affectations.
   3. Sélectionnez les utilisateurs requis.
   4. Sélectionnez Suivant, puis Attribuer.

2. Attribuer un cache de plate-forme Nous devons configurer le cache de plate-forme comme mémoire réutilisable pour cette application afin de stocker les données de l'ID d'enregistrement Salesforce actif. Assurez-vous que le cache de la plate-forme est alloué comme suit :

   1. Accédez à Configuration > Cache de la plateforme.
   2. Localisez CxCompanionCache et sélectionnez Modifier.
   3. Spécifiez la capacité suivante
      • Allocation de cache de session - Organisation ou essai (si disponible) : 2
      • Allocation de cache de l'organisation - Organisation ou essai (si disponible) : 1
      Remarque :

      Pour Salesforce Developer Edition (DE), si la capacité d'essai n'est pas disponible, vous pouvez la demander en cliquant sur Demander la capacité d'essai.

   4. Sélectionnez Enregistrer.

   

Connexion de l'application CX Component au plug-in

1. Identifiez l’URL où le composant CX est hébergé. Pour plus d'informations sur l'obtention de l'URL de l'application, consultez Configuration de l'application CX Componation > Intégration de l'application.

2. Configurez une URL approuvée.

   Pour permettre à l'iframe de CX d'être rendu dans le composant Lightning Web Robot (LWC), l'instance Salesforce doit être configurée de façon à approuver le site où CX Companion est hébergé.

   1. Accédez à Configuration > URL approuvées.
   2. Recherchez CXCompanion_Iframe dans la liste et sélectionnez Modifier.
   3. Sélectionnez Contexte CSP sur Tous.
   4. Sélectionnez les options connect-src et framework-src , puis sélectionnez Enregistrer

3. Modifiez les types de métadonnées personnalisés.

   Le LWC nécessite la configuration des métadonnées personnalisées pour que CX Companion puisse fournir du contenu dans l’application iframe CX Companion.

   1. Accédez à Configuration > Types de métadonnées personnalisées.
   2. Pour le paramètre CX du composant CX, sélectionnez Gérer les enregistrements. Ce libellé est automatiquement créé lorsque vous installez le package géré.

   3. Pour le libellé Par défaut , sélectionnez Modifier. 4. Collez l'URL d'application de votre CX Companion dans le champ URL de l'application . 5. Indiquez l' origine cible comme nom d'hôte de l'URL de votre complément CX, par exemple https://cloud.uipath.com. 6. Si la compilation CX est lancée à partir d’un bouton d’action sur une page d’enregistrement SF, les champs suivants définissent les dimensions de la fenêtre invoquée. Ces valeurs peuvent être modifiées selon les besoins. Les valeurs par défaut sont:

   • Largeur du composant d'action d'enregistrement: 1 200
   • Hauteur du composant d'action de l'enregistrement: 800
   Remarque :

   Ces dimensions et le titre ne seront applicables que lorsque le composant CX est configuré comme bouton d'action sur la page d'enregistrement de l'objet.

   7. Sélectionnez Enregistrer,

   

Positionnement du composant CX

Il existe deux options pour positionner le bouton de lancement du composant CX dans l'interface utilisateur Salesforce :

• En tant qu’élément de la barre d’utilité visible par tous les objets.
• En tant que bouton d'action sur la page d'enregistrement d'objet.

Position en tant qu’élément de la barre d’utilité

Suivez ces étapes pour chaque application pour laquelle vous souhaitez activer la fonction CX (par exemple Console de vente). Cela garantira que le composant CX est visible dans le panneau d'utilitaires lorsque l'utilisateur se trouve dans cette application.

Dans les instructions suivantes, le composant CX est ajouté en tant qu'élément de la barre d'utilité dans la console de service.

1. Accédez à Configuration > Gestionnaire d'applications.

2. Sélectionnez Modifier pour la console de service.

3. Sous Éléments utilitaires (Bureau uniquement) dans le panneau gauche, sélectionnez Ajouter un élément utilitaire.

   • Recherchez le composant Web Lightning cxCompanion dans la fenêtre contextuelle et sélectionnez-le.
   • Saisissez le libellé qui apparaîtra dans la barre d’utilité (par ex. Composant CX) et sélectionnez une icône appropriée.
   • Spécifiez la largeur du panneau (recommandé 1000 px) et la hauteur du panneau (recommandé 520 px).
   • Sélectionnez Activer le bouton d’actualisation qui apparaît à l’intérieur de LWC et permet d’actualiser le composant CX avec les données de l’objet FS actif.
   • Sélectionnez Enregistrer.

   

4. Pour Alignement des barres d'utilitaires, sélectionnez l'alignement souhaité, puis sélectionnez Enregistrer.

   • Si vous sélectionnez Par défaut, la barre d’utilités s’affiche en bas à gauche de l’écran.
   • Si vous sélectionnez Mise en miroir, la barre d'utilité apparaît en bas à droite de l'écran.

Positionnement en tant que bouton d'action sur la page Enregistrement de l'objet

Suivez ces étapes pour chaque objet pour lequel vous souhaitez créer le nouveau bouton d'action pour la page Enregistrement d'objet. Les instructions ci-dessous vous guideront pour ajouter le CX Component comme bouton d'action sur la page Enregistrement de l'incident.

1. Accédez à Configuration > Gestionnaire d'objets pour créer une nouvelle action pour un objet.

2. Recherchez un objet pour lequel vous souhaitez ajouter une action rapide (par exemple cas) et ouvrez-le.

3. Sélectionnez Boutons, Liens et Actions dans le panneau de gauche, puis sélectionnez Nouvelle action.

4. Pour Type d'action, sélectionnez Composant Web Lightning.

5. Pour le Composant Web Lightning, sélectionnez uipathsf:cxCompanionRecordAction.

6. Dans la zone Libellé , saisissez le libellé qui apparaîtra sur le bouton (par exemple CX Companion) et sélectionnez une icône appropriée. Le champ Nom sera automatiquement renseigné.

7. Sélectionnez Enregistrer.

   

8. Accédez à Configuration > Gestionnaire d'objets pour ajouter cette action à une page d'enregistrement Lightning.

9. Recherchez un objet pour lequel vous souhaitez ajouter une action rapide (par exemple cas) et ouvrez-le.

10. Sélectionnez Lightning Record Pages dans le panneau de gauche.

11. Accédez à n’importe quelle page d’enregistrement Salesforce et sélectionnez Modifier.

12. Sélectionnez le panneau de surbrillance sur la page d'enregistrement et, dans le panneau de droite, sélectionnez Ajouter une action pour ajouter une action dynamique.

13. Recherchez Compatibilité CX et sélectionnez Terminé.

14. Sélectionnez Enregistrer.

    

15. Un bouton est ajouté sur la page d'enregistrement du cas qui lance le composant CX dans une nouvelle fenêtre contextuelle.

    Remarque :

    Les dimensions et le titre de la fenêtre du composant CX seront déterminés par ce qui a été spécifié à l'étape précédente Modifier les types de métadonnées personnalisées.

Transmission des champs d'objet SF au composant CX

Suivez ces étapes pour configurer les champs d'objet à partir de l'application de configuration CX Componion.

1. Sélectionnez App Launcher (Lanceur d'applications), recherchez et sélectionnez l'application CX Companion Setup.

2. Sélectionnez l’onglet Configuration de l’objet de complément CX .

3. Dans la liste déroulante Objet , sélectionnez tout objet que vous avez déjà activé avec CX Component (par exemple Objet de compte).

   Si l'objet que vous souhaitez ajouter n'est pas disponible dans la liste déroulante Objet :

   1. Sélectionnez l'option Autre.
   2. Indiquez l’ID d’enregistrement Salesforce (15 ou 18 chiffres) de l’objet dans la zone de texte, puis sélectionnez Récupérer les métadonnées. Par exemple, pour ajouter l’objet Contact , saisissez l’ID d’enregistrement SF de n’importe quel contact valide, par exemple 003Ox00000eUIKSIA4 dans la zone de texte.
   3. Les champs de l'objet sont maintenant affichés. Passez à l'étape 4.

4. Dans la section Champs , sélectionnez les champs qui doivent être envoyés au composant CX. Assurez-vous que les utilisateurs finaux ont des autorisations d'accès aux champs sélectionnés.

   

5. Sélectionnez jusqu’à deux champs dans la section En-tête qui seront affichés comme en-tête du composant CX.

6. Sélectionnez Enregistrer pour enregistrer la configuration. L'enregistrement des valeurs et la prise en compte des modifications dans CX Companion peuvent prendre un certain temps.