Sie befinden sich hier:
Verwenden von Formeln in OmniStudio-Datenzuordnungen
Definieren Sie Formeln, um der Ausgabe einer Datenzuordnung Daten hinzuzufügen. Verschiedene Arten von Datenzuordnungen (Extrahieren, Umwandeln und Laden) unterstützen Formeln. Wenn Sie eine Formel definieren, ordnen Sie ihre Ausgabe der Ausgabe-JSON (für Extrakte und Transformationen) oder dem Salesforce-Objektfeld (für Lasten) zu.
Details zu den Operatoren und Funktionen, die Sie in Formeln verwenden können, finden Sie unter OmniStudio-Formeln und -Funktionen.
Wenn ein Variablenname Leerzeichen oder nicht alphanumerische Zeichen enthält, setzen Sie den Variablennamen in doppelte Anführungszeichen und setzen Sie ihm var: in Formeln voran. Wenn der JSON-Knotenname beispielsweise Primary Guardian lautet, geben Sie ihn in Formeln als var:"Primary Guardian" an.
Wenn der Name eines benutzerdefinierten Felds Sonderzeichen enthält, können Sie manchmal nicht auf das Feld in einer Formel verweisen.
In der OmniStudio-Standardlaufzeit gibt die Eingabe der falschen Abfrageformel für Datenzuordnungen null zurück, zeigt jedoch keine Fehlerprotokolle an. Wenn Sie von einer Abfrage eine Nullantwort erhalten, aktualisieren Sie die Abfrage.
- Navigieren Sie auf der Seite "Datenzuordnungsoberfläche" zur Registerkarte "Formeln".
- Klicken Sie auf Formel hinzufügen. Der Liste wird eine leere Formel hinzugefügt.
-
Geben Sie im Feld "Formel" die gewünschte Logik an. Wenn Sie beispielsweise den Gesamtpreis der Kaufartikel durch einen Kunden bestimmen möchten, geben Sie eine Formel ein, beispielsweise:
SUM(Products:Price)Sie können auch die Beziehungsnotation in Formeln verwenden, um auf Felder in einem übergeordneten Objekt zu verweisen. Entsprechende Informationen finden Sie unter Beziehungsnotation im Vergleich zu mehreren Extraktionsschritten.
- Geben Sie im Feld Formelergebnispfad einen JSON-Knoten an, in dem das Formelergebnis gespeichert werden soll.
-
Ordnen Sie das Ergebnis der endgültigen Ausgabe zu.
- Ordnen Sie bei einer Datenzuordnung extrahieren auf der Registerkarte "Ausgabe" der Ausgabestruktur das Formelergebnis zu. Verwenden Sie einen Doppelpunkt (:), um Ebenen in den Eingabe- und Ausgabepfaden in Zuordnungen zu begrenzen.
- Ordnen Sie bei einer Datenzuordnung vom Typ "Umwandeln" auf der Registerkarte "Umwandeln" das Formelergebnis der Ausgabestruktur zu. Verwenden Sie einen Doppelpunkt (:), um Ebenen in den Eingabe- und Ausgabepfaden in Zuordnungen zu begrenzen.
- Ordnen Sie bei einer Ladedatenzuordnung für jedes zu aktualisierende sObject auf der Registerkarte "Felder" das Formelergebnis dem zu aktualisierenden Feld zu.
- Laden: Wechseln Sie für jedes zu aktualisierende sObject zur Registerkarte "Felder" und ordnen Sie das Formelergebnis dem spezifischen Feld zu, das Sie aktualisieren möchten.
Erstellen eines OmniStudio-Datenzuordnungsbeispiels mit einer Formel
Im folgenden Beispiel wird eine Liste der Preise akzeptiert und eine Formel zur Berechnung des Gesamtpreises verwendet.
Führen Sie zum Erstellen dieser Datenzuordnungstransformation die folgenden Schritte aus:
- Navigieren Sie zur Registerkarte OmniStudio-Datenzuordnungs-Designer und klicken Sie auf Neu. Das Dialogfeld "Erstellen" wird angezeigt.
-
Geben Sie einen Namen für die Datenzuordnung an und konfigurieren Sie ihre Einstellungen wie folgt:
- Schnittstellentyp: Umwandeln
- Eingabetyp: JSON
- Ausgabetyp: JSON
- Klicken Sie auf Speichern. Die Seite "Datenzuordnungsschnittstelle" wird angezeigt.
- Wechseln Sie zur Registerkarte "Formeln" und klicken Sie auf Formel hinzufügen.
- Geben Sie im Feld "Formel" den Text SUM(Products:Price) ein.
- Geben Sie im Feld "Formelergebnispfad" den Text TotalPrice ein.
-
Erweitern Sie auf der Registerkarte "Umwandeln" das Fenster "Eingabe-JSON" und fügen Sie die folgende JSON-Struktur ein:
{ "CustomerName": "Bob Smith", "Products": [ { "Name": "iPhone", "Price": 600 }, { "Name": "iPhone Case", "Price": 30 }, { "Name": "Ear Buds", "Price": 200 } ] } -
Erweitern Sie den Bereich "Erwartete JSON-Ausgabe" und fügen Sie die folgende JSON-Struktur ein:
{ "CustomerName": "Bob Smith", "TotalPrice": 830, "Products": [ { "Name": "iPhone", "Price": 600 }, { "Name": "iPhone Case", "Price": 30 }, { "Name": "Ear Buds", "Price": 200 } ] } - Klicken Sie auf Schnellübereinstimmung. Klicken Sie im Fenster "Schnellübereinstimmung" auf Automatischer Abgleich und dann auf Speichern.
-
Klicken Sie auf der Registerkarte "Vorschau" auf Ausführen.
Wenn Sie das Beispiel richtig erstellt haben, stimmt die JSON-Struktur im Antwortbereich mit der erwarteten JSON-Ausgabe überein, mit Ausnahme der Reihenfolge der Knoten der obersten Ebene.
-
Ändern Sie im Eingabebereich einen oder mehrere der Preise und klicken Sie dann erneut auf Ausführen.
Beachten Sie, wie sich der
TotalPriceändert.
