CX-Companion Salesforce-Plugin

Das UiPath CX-Companion- SF-Plugin ermöglicht die sofort einsatzbereite Integration von CX-Companion in Salesforce, wenn externe Ereignisse verwendet werden . Lesen Sie die folgenden Abschnitte, um zu erfahren, wie Sie das Plugin installieren und konfigurieren.

Voraussetzungen

Bevor Sie beginnen, stellen Sie Folgendes sicher:

• Sie haben Zugriff auf das Systemadministratorprofil .
  Hinweis: Sie können Ihre aktuelle Salesforce-Organisation verwenden oder in einer Entwicklungsorganisation testen.

• Ihre Salesforce Edition ist Enterprise, Unlimited oder Developer.

Installieren des verwalteten Pakets

1. Greifen Sie auf die AppExchange-Auflistung zu.

   Führen Sie die folgenden Schritte aus, um das verwaltete Paket „UiPath-CX-Companion- SF-Plugin“ zu installieren:

   1. Öffnen Sie einen Webbrowser und wechseln Sie zu Salesforce AgentExchange.
   2. Geben Sie in der Suchleiste Folgendes ein: UiPath CX-Companion SF-Plugin.
   3. Klicken Sie auf die App-Auflistung und wählen Sie dann Jetzt abrufen aus.
   4. Melden Sie sich mit Ihren Salesforce-Anmeldeinformationen an.
   Wichtig:

   Das CX-Companion- SF-Plugin befindet sich derzeit in der Vorschau und muss noch von Salesforce genehmigt werden. Sie können die Vorschauversion auf eine der folgenden Arten erhalten:

   • Herunterladen mithilfe der URL des verwalteten Pakets: https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPa000002FWpeIAG
   • Von https://<yourSalesforceDomain>.lightning.force.com/packaging/installPackage.apexp?p0 p0=04tPa000002FWpeIAGherunterladen
     wobei <yourSalesforceDomain> die Domäne Ihrer tatsächlichen Salesforce-Organisation ist.
2. Wählen Sie aus, wo und für wen installiert werden soll.
   1. Wählen Sie aus, in welcher Umgebung Sie installieren möchten:
      • Produktion – Wählen Sie diese Option aus, wenn Sie bereit sind, die App in Ihrer Live-Salesforce-Umgebung zu verwenden.
      • Sandbox – Wählen Sie diese Option aus, wenn Sie die App testen möchten, bevor Sie sie in der Produktion verwenden.

      Hinweis:

      Dieser Schritt ist nicht verfügbar, wenn Sie die Vorschauversion des Plugins verwenden.

   2. Wählen Sie Für bestimmte Benutzer installieren aus.
      Sie können dieses verwaltete Paket für einige oder alle Benutzer verfügbar machen.
   3. Wählen Sie „Ich bestätige, dass ich eine Nicht-Salesforce-Anwendung installiere, die nicht für die Verbreitung im Rahmen des AppExchange-Partnerprogramms von Salesforce autorisiert ist.“
   4. Klicken Sie auf Installieren.
   5. Genehmigen Sie den Zugriff von Drittanbietern für https://*.uipath.com, wodurch ein vertrauenswürdiger Zugriff auf die CX-Companion-App ermöglicht wird, die auf uipath.com gehostet wird.
   6. Klicken Sie nach Abschluss der Installation auf Fertig.

      Nach der Installation wird das neu installierte verwaltete Paket UiPath CX-Companion SF-Plugin in der Liste Installierte Pakete angezeigt.

      

Zuweisen von Berechtigungen und Plattform-Cache

1. Zuweisen von Berechtigungssätzen
   Führen Sie die folgenden Schritte aus, um sicherzustellen, dass die erforderlichen Berechtigungen für die Benutzer verfügbar sind, für die Sie das verwaltete Paket installiert haben.
   1. Navigieren Sie zu Einrichtung > Benutzer > Berechtigungssatz und suchen Sie UiPath CX Companion.
   2. Wählen Sie Zuweisungen verwalten > Zuweisungen hinzufügen aus.
   3. Wählen Sie die erforderlichen Benutzer aus.
   4. Klicken Sie auf Weiter und dann auf Zuweisen.
2. Plattform-Cache zuweisen
   Wir müssen den Plattform-Cache als wiederverwendbaren Speicher für diese App konfigurieren, um die Daten der aktiven Salesforce-Datensatz-ID zu speichern. Stellen Sie sicher, dass der Plattform-Cache wie folgt zugeordnet ist:
   1. Navigieren Sie zu Einrichtung > Plattform-Cache.
   2. Suchen Sie CxCompanionCache und klicken Sie auf Bearbeiten.
   3. Folgende Kapazität angeben (MB)
      • Zuweisung des Sitzungs-Cache – Organisation oder Testversion (je nachdem, was verfügbar ist): 2
      • Org.-Cache-Zuweisung – Organisation oder Testversion (je nachdem, was verfügbar ist): 1

      Hinweis: Wenn bei der Salesforce Developer Edition (DE) keine Testkapazität verfügbar ist, können Sie diese anfordern, indem Sie auf Testkapazität anfordern klicken .
   4. Klicken Sie auf Speichern,
      

Verbinden der CX-Companion-App mit dem Plugin

1. Ermitteln Sie die URL, unter der CX Companion gehostet wird. Informationen zum Abrufen der App-URL finden Sie unter Konfigurieren der CX-Companion-App > Einbetten der App.
2. Richten Sie eine vertrauenswürdige URL ein.

   Damit das Iframe von CX Companion in der Lightning-Webkomponente (LWC) gerendert werden kann, muss die Salesforce-Instanz so konfiguriert werden, dass sie der Site vertraut, auf der CX Companion gehostet wird.

   1. Navigieren Sie zu Einrichtung > Vertrauenswürdige URLs.
   2. Suchen Sie CXCompanion_Iframe in der Liste und klicken Sie auf Bearbeiten.
   3. Wählen Sie CSP-Kontext als Alle aus.
   4. Wählen Sie die Optionen Connect-src und Frame-src aus und klicken Sie auf Speichern
3. Ändern Sie benutzerdefinierte Metadatentypen.

   Das LWC erfordert, dass benutzerdefinierte Metadaten konfiguriert werden, damit CX Companion Inhalte in die CX Companion-Iframe-Anwendung bereitstellen kann.

   1. Navigieren Sie zu Einrichtung > Benutzerdefinierte Metadatentypen.
   2. Wählen Sie für die CX-Companion-Einstellung für die Beschriftung die Option Datensätze verwalten aus. Diese Beschriftung wird automatisch erstellt, wenn Sie das verwaltete Paket installieren.
      
   3. Klicken Sie für die Standardbeschriftung auf Bearbeiten.
   4. Fügen Sie die App-URL Ihres CX-Companion in das Feld App-URL ein.
   5. Geben Sie den Zielherkunft als Hostnamen der URL Ihres CX-Companion an, z. B https://cloud.uipath.com.
   6. Wenn CX Companion über eine Aktionsschaltfläche auf einer SF-Datensatzseite gestartet wird, definieren die folgenden Felder die Abmessungen des aufgerufenen Fensters. Diese können nach Bedarf geändert werden. Die Standardwerte sind:
      • Breite der Datensatzaktionskomponente: 1200
      • Höhe der Aufzeichnungsaktionskomponente: 800

      Hinweis: Diese Dimensionen und der Titel gelten nur, wenn CX-Companion als Aktionsschaltfläche auf der Datensatzseite des Objekts konfiguriert ist.
   7. Klicken Sie auf Speichern,
      

Positioning CX-Begleiter

Es gibt zwei Optionen, um die Startschaltfläche für CX-Companion in der Salesforce-Benutzeroberfläche zu positionieren:

• Als Element in der Dienstprogrammleiste, das für alle Objekte sichtbar ist.
• Als Aktionsschaltfläche auf der Seite des Objektdatensatzes.

Position als Element in der Dienstprogrammleiste

Führen Sie diese Schritte für jede App aus, bei der Sie CX-Companion aktivieren möchten (z. B Vertriebskonsole). Dadurch wird sichergestellt, dass CX Companion im Dienstprogramm-Tray sichtbar ist, wenn sich der Benutzer in dieser App befindet.

In den folgenden Anweisungen wird CX Companion als Element der Dienstprogrammleiste in der Servicekonsole hinzugefügt.

1. Navigieren Sie zu Einrichtung > App-Manager.
2. Wählen Sie Bearbeiten für Dienstkonsole aus.
3. Klicken Sie unter Dienstprogrammelemente (Nur Desktop) im linken Bereich auf Dienstprogrammelement hinzufügen.
   • Suchen Sie im Popup nach der Lightning-Webkomponente cxCompanion und wählen Sie diese aus.
   • Geben Sie die Beschriftung ein, die in der Dienstprogrammleiste angezeigt wird (z. B CX-Companion) und wählen Sie ein entsprechendes Symbol aus.
   • Geben Sie die Bereichsbreite (empfohlen: 1000 px) und die Bereichshöhe (empfohlen: 520 px) an.
   • Wählen Sie Schaltfläche zur Aktualisierung aktivieren aus, die innerhalb des LWC angezeigt wird und es ermöglicht, CX Companion mit Daten aus dem aktiven SF-Objekt zu aktualisieren.

   • Klicken Sie auf Speichern.

     
4. Wählen Sie für Ausrichtung der Dienstprogrammleiste die gewünschte Ausrichtung aus und klicken Sie dann auf Speichern.
   • Wenn Sie Standard auswählen, wird die Dienstprogrammleiste auf der unteren linken Seite des Bildschirms angezeigt.
   • Wenn Sie Gespiegelt auswählen, wird die Dienstprogrammleiste auf der unteren rechten Seite des Bildschirms angezeigt.

Positionieren Sie sich als Aktionsschaltfläche auf der Datensatzseite des Objekts

Führen Sie die folgenden Schritte für jedes Objekt aus, in dem Sie die neue Aktionsschaltfläche für die Seite „Objektdatensatz“ erstellen möchten. Die folgenden Anweisungen führen Sie zum Hinzufügen von CX Companion als Aktionsschaltfläche auf der Seite Falldatensatz.

1. Navigieren Sie zu Einrichtung > Objektmanager, um eine neue Aktion für ein Objekt zu erstellen.
2. Suchen Sie nach einem Objekt, für das Sie eine Schnellaktion hinzufügen möchten (z. B case) und öffnen Sie es.
3. Wählen Sie im linken Bereich Schaltflächen, Links und Aktionen aus und klicken Sie dann auf Neue Aktion.
4. Wählen Sie für Aktionstyp die Option Lightning-Webkomponente aus.
5. Wählen Sie für Lightning-Webkomponente die Option uipathsf:cxCompanionRecordAction aus.
6. Geben Sie im Feld Beschriftung die Beschriftung ein, die auf der Schaltfläche angezeigt wird (z. B CX Companion) und wählen Sie ein geeignetes Symbol aus. Das Feld Name wird automatisch ausgefüllt.

7. Klicken Sie auf Speichern.

   
8. Navigieren Sie zu Einrichtung > Objektmanager, um diese Aktion zu einer Lightning-Datensatzseite hinzuzufügen.
9. Suchen Sie nach einem Objekt, für das Sie eine Schnellaktion hinzufügen möchten (z. B case) und öffnen Sie es.
10. Klicken Sie im linken Bereich auf Lightning-Datensatzseiten .
11. Wechseln Sie zu einer beliebigen Salesforce-Datensatzseite und klicken Sie auf Bearbeiten.
12. Wählen Sie den Hervorhebungsbereich auf der Datensatzseite aus und klicken Sie im rechten Bereich auf Aktion hinzufügen , um eine dynamische Aktion hinzuzufügen.
13. Suchen Sie nach CX Companion und klicken Sie auf Fertig.

14. Klicken Sie auf Speichern.

    
15. Auf der Seite „Falldatensatz“ wird eine Schaltfläche hinzugefügt, die den CX-Companion in einem neuen Popup-Fenster startet.
    Hinweis: Die Abmessungen und der Titel des CX-Companion-Fensters werden durch das bestimmt, was im vorherigen Schritt Benutzerdefinierte Metadatentypen ändern angegeben wurde.

Übergeben von SF-Objektfeldern an CX Companion

Führen Sie diese Schritte aus, um die Objektfelder in der CX Companion Setup App zu konfigurieren.

1. Klicken Sie auf App Launcher, suchen Sie die App CX Companion Setup und wählen Sie sie aus.
2. Wählen Sie die Registerkarte Konfiguration des CX-Begleiters aus.
3. Wählen Sie in der Dropdownliste Objekt ein beliebiges Objekt aus, das Sie zuvor mit CX-Companion aktiviert haben (z. B Kontoobjekt).
   Wenn das Objekt, das Sie hinzufügen möchten, in der Dropdownliste Objekt nicht verfügbar ist:
   1. Wählen Sie die Option Sonstige aus.
   2. Geben Sie die Salesforce-Datensatz-ID (15 oder 18 Ziffern) des Objekts im Textfeld an und klicken Sie dann auf Metadaten abrufen. Um beispielsweise das Kontaktobjekt hinzuzufügen, geben Sie die SF-Datensatz-ID eines gültigen Kontakts ein, z. B 003Ox00000eUIKSIA4 in das Textfeld ein.
   3. Die Felder für das Objekt werden nun angezeigt. Fahren Sie mit Schritt 4 fort.
4. Wählen Sie im Abschnitt Felder die Felder aus, die an CX Companion gesendet werden müssen. Stellen Sie sicher, dass Endbenutzer über Zugriffsberechtigungen für die ausgewählten Felder verfügen.
   
5. Wählen Sie bis zu zwei Felder aus dem Abschnitt Header aus, die als Header des CX-Companion angezeigt werden.
6. Klicken Sie auf Speichern, um die Konfiguration zu speichern. Es kann einige Zeit dauern, bis die Werte gespeichert werden und die Änderungen in CX-Companion angezeigt werden.