Plug-in Salesforce du composant CX

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, effectuez les actions suivantes :

• Vous disposez d’un accès au profil d’administrateur système .
  Remarque : vous pouvez utiliser votre organisation Salesforce actuelle ou effectuer un test 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. Cliquez sur la liste de l'application, puis sélectionnez Obtenir l'application maintenant.
   4. Connectez-vous à l'aide de vos informations d'identification Salesforce.
   Important :

   Le plug-in CX Componion SF est actuellement en aperçu public, en attente de l’approbation de Salesforce. Vous pouvez obtenir la version préliminaire de l’une des manières suivantes :

   • Téléchargez à l’aide de l’URL du package géré : https://login.salesforce.com/packaging/installPackage.apexp0=04tPa000002FWpeIAG
   • Télécharger depuis https://<yourSalesforceDomain>.lightning.force.com/packaging/installPackage.apexp?p0 p0=04tPa000002FWpeIAG
     où <yourSalesforceDomain> est le domaine réel de votre organisation Salesforce.
2. 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 de rendre ce package géré disponible à certains des utilisateurs ou à tous.
   3. Sélectionnez « Je reconnais que j’installe une application Non-Salesforce qui n’est pas autorisée à être distribuée dans le cadre du programme Partenaires AppExchange de Salesforce ».
   4. Cliquez sur Installer (Install).
   5. Approuver l'accès tiers pour https://*.uipath.com, ce qui permettra d'accéder de manière approuvée à l'application CX Companion hébergée sur uipath.com.
   6. Une fois l'installation terminée, cliquez sur 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. Cliquez sur Suivant, puis sur Affecter.
2. Attribuer un cache de plate-forme
   Nous devons configurer le Cache de la 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 cliquez sur 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. Cliquez sur 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 cliquez sur Modifier.
   3. Sélectionnez Contexte CSP sur Tous.
   4. Sélectionnez les options connect-src et framework-src et cliquez sur 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 , cliquez sur Modifier.
   4. Collez l'URL de l'application de votre CX dans le champ URL de l'application .
   5. Mentionz l' origine cible comme nom d'hôte de l'URL de votre composant CX, par exemple https://cloud.uipath.com
   6. Si le composant CX est lancé à partir d'un bouton d'action dans une page d'enregistrement SF, les champs suivants définissent les dimensions de la fenêtre invoquée. Ceux-ci peuvent être modifiés au besoin. 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 s'appliqueront que lorsque le composant CX est configuré en tant que bouton d'action sur la page d'enregistrement de l'objet.
   7. Cliquez sur 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 de service (Understanding uniquement) dans le panneau de gauche, cliquez sur Ajouter un élément de service.
   • 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.

   • Cliquez sur Enregistrer (Save).

     
4. Pour Alignement de la barre d'utilité, sélectionnez l'alignement souhaité, puis cliquez sur 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 cliquez sur 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. Cliquez sur Enregistrer (Save).

   
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. Cliquez sur Pages d'enregistrement Lightning dans le panneau de gauche.
11. Accédez à n'importe quelle page d'enregistrement Salesforce et cliquez sur Modifier.
12. Sélectionnez le panneau de surbrillance sur la page d'enregistrement et, dans le panneau de droite, cliquez sur Ajouter une action pour ajouter une action dynamique.
13. Recherchez le Compatibilité CX et cliquez sur Terminé.

14. Cliquez sur Enregistrer (Save).

    
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. Cliquez sur Lanceur d'applications, recherchez et sélectionnez l'application CX Configuration du composant.
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 cliquez sur Récupérer les métadonnées. Par exemple, pour ajouter l'objet Contact , saisissez l'ID d'enregistrement FS 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. Cliquez sur Enregistrer pour enregistrer la configuration. Cela peut prendre un certain temps pour que les valeurs soient enregistrées et que les modifications soient prises en compte dans le composant CX.