Beispiel: Migrieren eines Serviceprozesses zum vereinheitlichten Katalog

Vereinfachen Sie die Verwaltung von Aufnahmeanforderungen, indem Sie Ihre Serviceprozessdefinitionen in Service Process Studio in Standardproduktdatensätze konvertieren. Verwalten Sie alle Ihre Produkt- und Serviceangebote an einem Ort.

Erforderliche Editionen

Verfügbarkeit: Lightning Experience

Verfügbarkeit: Enterprise, Unlimited und Developer Edition mit Financial Services Cloud und dem einheitlichen Katalog.

Stellen Sie zunächst sicher, dass Sie über einen aktiven Zahlungsserviceprozess vom Typ "Check stoppen" verfügen, der ursprünglich in Service Process Studio erstellt wurde.

Diese Aufgabe verwendet den Serviceprozess "Zahlung stoppen" als Beispiel, um die Migrationsschritte zu veranschaulichen. In diesem Szenario enthält die ursprüngliche Serviceprozessdefinition drei Attribute wie Prüfnummer, Prüfdatum und Betrag mit den entsprechenden API-Namen "Check_Number", "Check_Date" und "Amount". Führen Sie die folgenden Schritte aus, um diesen spezifischen Prozess zu migrieren, und passen Sie die Logik an, um Ihre eigenen Serviceprozesse zu migrieren.

Erstellen Sie den Service im zusammengeführten Katalog.

Der einheitliche Katalog verwendet Product2-Datensätze zum Definieren von Services. Erstellen Sie diesen Datensatz, um eine eindeutige Produkt-ID für den Service zu generieren.
1. Suchen Sie im App Launcher den einheitlichen Katalog und wählen Sie ihn aus.
2. Klicken Sie auf der Startseite auf Neu und wählen Sie Service aus.
  
  Sie können auch auf die Registerkarte "Services" und dann auf die Schaltfläche Neuer Service klicken.
3. Geben Sie als Namen Scheckzahlung stoppen ein und füllen Sie die restlichen Felder aus.
4. Speichern Sie Ihre Änderungen.
Führen Sie im Service-Designer des zusammengeführten Katalogs die folgenden Aktionen aus.
1. Klicken Sie auf Weiter.
2. Erstellen Sie im Schritt "Attribute" die Attribute Ihrer ursprünglichen Serviceprozessdefinition neu.
  
  Verwenden Sie für das Attribut "Nummer prüfen" Text als Datentyp. Verwenden Sie für das Attribut "Check Date" (Datum überprüfen) Datum als Datentyp. Verwenden Sie für das Attribut "Betrag" "Zahl" als Datentyp. Entsprechende Informationen finden Sie unter Konfigurieren von Prozessattributen.
  
  Hinweis Stellen Sie sicher, dass Sie den API-Namen jedes Attributs mit dem API-Namen in Ihrer ursprünglichen Service Process Studio-Definition abgleichen, um Fehler bei der Aufnahme oder Abwicklung zu vermeiden.
3. Hängen Sie im Schritt "Formular zur Aufnahme" das Aufnahmeformular und den Abwicklungs-Flow an, die Sie dem Service "Zahlung stoppen" zuordnen möchten. Entsprechende Informationen finden Sie unter Entwurfsanforderungs-Aufnahmeformular.
4. Fügen Sie im Schritt "Abwicklungs-Flow" den Abwicklungs-Flow hinzu, den Sie dem Service "Scheckzahlung stoppen" zuordnen möchten. Entsprechende Informationen finden Sie unter Konfigurieren der Anforderungsabwicklung.
5. Fügen Sie unter "Erweiterte Optionen" im Schritt "Integrationen" die Integrationsdefinitionen hinzu, die Sie dem Service "Scheckzahlung stoppen" zuordnen möchten.
6. Kopieren Sie im Browser-URL dieses neuen Service die Datensatz-ID, beispielsweise 01tDn00000Wxyz.
  01tDn00000Wxyz ist die Produkt-ID für den Service.
Speichern Sie Ihre Änderungen und aktivieren Sie den Service "Scheckzahlung stoppen".
Erstellen Sie eine OmniStudio-Datenzuordnungstransformation.

Ordnen Sie die Daten Ihres Aufnahmeformulars der JSON-Struktur "CustomAttributes" zu. Für die Connect-API für den einheitlichen Katalog sind alle servicespezifischen Daten erforderlich, die in einem bestimmten JSON-Knoten namens CustomAttributes eingeschlossen sind. Ihr vorhandenes OmniScript speichert Daten wahrscheinlich in einem flachen Schlüsselwertformat. Daher ist diese Transformation erforderlich, um die Nutzlast für die API richtig zu strukturieren.
1. Navigieren Sie in der von Ihnen erstellten Datenzuordnungstransformation zur Registerkarte "Umwandeln".
2. Klicken Sie auf Eingabe-/Ausgabetyp verwalten.
3. Geben Sie im Feld Eingabe-JSON bearbeiten Ihre Eingabe-JSON ein.
  Die Eingabe-JSON stellt die Daten genau so dar, wie sie in Ihrem OmniScript vorhanden sind, kurz bevor Sie die Serviceprozessanforderung senden.
  
  Im Folgenden finden Sie eine JSON-Beispielstruktur für Eingaben für den Serviceprozess "Scheckzahlung stoppen":
```
        {
        "Check_Number": "1042",
        "Check_Date": "2026-02-15",
        "Amount": "2500"
        }
       
```
4. Geben Sie unter "Erwartete JSON-Ausgabe bearbeiten" Ihre erwartete JSON-Ausgabe ein.
  Die JSON für die erwartete Ausgabe ist das Nutzlastformat, das die Connect-API für den einheitlichen Katalog benötigt.
  
  Im Folgenden finden Sie eine JSON-Beispielstruktur für die erwartete Ausgabe mit dem Knoten "CustomAttributes" für den Serviceprozess "Stopp-Scheckzahlung":
```
        {
        "CustomAttributes": {
        "checkNumber": "1042",
        "checkDate": "2026-02-15",
        "amount": "2500"
        }
        }
       
```
5. Ordnen Sie die Eingabefelder Ihres OmniScripts den entsprechenden Ausgabefeldern im Knoten "CustomAttributes" zu. Entsprechende Informationen finden Sie unter Zuordnen von Ein- und Ausgaben für Transformationen.
  
  Hier ein Beispiel für die zugeordneten Eingabe- und Ausgabefelder.
Erstellen Sie ein OmniStudio-Integrationsverfahren.

Konfigurieren Sie ein Integrationsverfahren, um die Connect-API für den einheitlichen Katalog aufzurufen und Ihre Serviceprozessdaten weiterzugeben. Das ursprüngliche Service Process Studio hat die Service Process Connect-API verwendet, um Kundenvorgänge für die Serviceprozessanforderungen zu erstellen. Der zusammengeführte Katalog verwendet eine produktgesteuerte API mit dem Namen "ServiceRequestCaseApiService". Für diese API müssen Sie die productId übergeben, um den neu erstellten Kundenvorgang mit Ihrem Katalogelement zu verknüpfen. Außerdem müssen Sie jedes spezifische Serviceattribut als ein eigenes Schlüssel-Wert-Paar zuordnen. Dadurch wird sichergestellt, dass der zusammengeführte Katalog Ihre Aufnahmedaten genau liest und für den Kundenvorgangs-Datensatz richtig strukturiert. Kopieren Sie den Namen des Integrationsverfahrens zur späteren Verwendung.
1. Fügen Sie im von Ihnen erstellten Integrationsverfahren einen Remote-Aktionsschritt hinzu.
2. Geben Sie serviceprocess.ServiceRequestCaseApiService als Remote-Klasse ein.
3. Geben Sie callServiceRequestApiToCreateCase als Remote-Methode ein.
4. Erweitern Sie den Abschnitt "Zusätzliche Eingabe", "Zusätzliche Ausgabe" und "Fehlerantwort".
5. Fügen Sie im Abschnitt "Zusätzliche Eingabe" die Schlüssel productId, svcCatalogItemDefApiName und inputToRequestPayloadTransformDataMapper hinzu.
6. Geben Sie für den productId-Schlüssel die Produkt-ID des Service ein. Beispiel: 01tDn00000Wxyz.
7. Geben Sie für den Schlüssel svcCatalogItemDefApiName den Namen Ihres Service ein. Beispiel: Stop a Check Payment (Stoppen einer Scheckzahlung).
8. Geben Sie für den Schlüssel inputToRequestPayloadTransformDataMapper den API-Namen der von Ihnen erstellten Datenzuordnungstransformation ein.
9. Fügen Sie im selben Abschnitt "Zusätzliche Eingabe" jedes Attribut des Serviceprozesses als neues Schlüssel-Wert-Paar hinzu. Legen Sie beispielsweise den Schlüssel auf Betrag fest und den Wert, mit dem die Daten aus Ihrem OmniScript dem Integrationsverfahren zugeordnet werden sollen.
  
  Im Folgenden finden Sie eine Beispieleingabe für das Integrationsverfahren für den Serviceprozess "Scheckzahlung stoppen".
Speichern und aktivieren Sie das Integrationsverfahren.
Aktualisieren Sie das Aufnahme-OmniScript des Serviceprozesses "Stopp Check Payment".
1. Erstellen Sie eine Version Ihres vorhandenen OmniScripts.
2. Suchen Sie den Schritt CreateCase, der den Kundenvorgang für die Serviceprozessanforderung erstellt, und wählen Sie ihn aus.
3. Fügen Sie unter "Eigenschaften der Integrationsverfahrensaktion" im Feld "Integrationsverfahren" den Namen des von Ihnen erstellten Integrationsverfahrens hinzu.
4. Fügen Sie im Abschnitt "Zusätzliche Nutzlast" alle Attribute des Serviceprozesses als Schlüssel-Wert-Paare hinzu.
Aktivieren Sie das OmniScript.