Berechnete Felder zum Exportieren von Arrays als Zeichenfolgen verwenden use-calculated-fields-to-export-arrays-as-strings

Erfahren Sie, wie Sie Arrays über berechnete Felder aus Real-Time CDP als Zeichenfolgen in Cloud-Speicher-Ziele exportieren. Lesen Sie dieses Dokument, um die durch diese Funktion aktivierten Anwendungsfälle zu verstehen.

Erhalten Sie umfassende Informationen zu berechneten Feldern - was diese sind und warum sie wichtig sind. Auf den unten verlinkten Seiten erhalten Sie eine Einführung in berechnete Felder in der Datenvorbereitung sowie weitere Informationen zu allen verfügbaren Funktionen:

Arrays und andere Objekttypen in Platform arrays-strings-other-objects

Unter Experience Platform können Sie XDM-Schemas verwenden, um verschiedene Feldtypen zu verwalten. Bevor die Unterstützung für Array-Exporte hinzugefügt wurde, konnten Sie einfache Schlüssel-Wert-Paarfelder wie Zeichenfolgen aus dem Experience Platform in Ihre gewünschten Ziele exportieren. Ein Beispiel für ein solches Feld, das zuvor für den Export unterstützt wurde, ist personalEmail.address:johndoe@acme.org.

Andere Feldtypen im Experience Platform umfassen Array-Felder. Erfahren Sie mehr über Verwalten von Array-Feldern in der Experience Platform-Benutzeroberfläche. Zusätzlich zu den zuvor unterstützten Feldtypen können Sie jetzt Array-Objekte wie das folgende Beispiel exportieren, die mithilfe der Funktion array_to_string in eine Zeichenfolge verkettet werden.

organizations = [{
  id: 123,
  orgName: "Acme Inc",
  founded: 1990,
  latestInteraction: "2024-02-16"
}, {
  id: 456,
  orgName: "Superstar Inc",
  founded: 2004,
  latestInteraction: "2023-08-25"
}, {
  id: 789,
  orgName: 'Energy Corp',
  founded: 2021,
  latestInteraction: "2024-09-08"
}]

Weitere Informationen dazu, wie Sie mit verschiedenen Funktionen auf Elemente von Arrays zugreifen, Arrays umwandeln und filtern, Array-Elemente in eine Zeichenfolge einbinden und vieles mehr, finden Sie unter umfassende Beispiele .

Bekannte Einschränkungen known-limitations

Beachten Sie die folgenden bekannten Einschränkungen, die derzeit für diese Funktion gelten:

Voraussetzungen prerequisites

Verbinden Sie mit einem gewünschten Cloud-Speicher-Ziel, gehen Sie durch die Aktivierungsschritte für Cloud-Speicher-Ziele und gehen Sie zum Schritt Zuordnung .

Berechnete Felder exportieren how-to-export-calculated-fields

Wählen Sie im Zuordnungsschritt des Aktivierungs-Workflows für Cloud-Speicher-Ziele Berechnetes Feld hinzufügen aus.

Dadurch wird ein modales Fenster geöffnet, in dem Sie Funktionen und Felder auswählen können, um Attribute aus der Experience Platform zu exportieren.

Verwenden Sie beispielsweise die Funktion array_to_string im Feld organizations , wie unten dargestellt, um das Organisations-Array als Zeichenfolge in eine CSV-Datei zu exportieren. Weitere Informationen dazu und weitere Beispiele finden Sie weiter unten unter 🔗.

Wählen Sie Speichern aus, um das berechnete Feld beizubehalten und zum Zuordnungsschritt zurückzukehren.

Füllen Sie im Zuordnungsschritt des Workflows das Feld Ziel mit dem Wert der Spaltenüberschrift aus, die Sie für dieses Feld in den exportierten Dateien verwenden möchten.

Wenn Sie bereit sind, wählen Sie Weiter aus, um mit dem nächsten Schritt des Aktivierungs-Workflows fortzufahren.

Beispielunterstützte Funktionen zum Exportieren von Arrays supported-functions

Bei der Aktivierung von Daten für dateibasierte Ziele werden alle dokumentierten Datenvorbereitungsfunktionen unterstützt.

Die folgenden Funktionen, die speziell für die Verarbeitung von Arrays-Exporten gelten, werden zusammen mit Beispielen dokumentiert.

Beispiele für Funktionen zum Exportieren von Arrays examples

In den folgenden Abschnitten finden Sie Beispiele und weitere Informationen zu einigen der oben aufgeführten Funktionen. Die übrigen aufgelisteten Funktionen finden Sie in der Dokumentation zu den allgemeinen Funktionen im Abschnitt "Datenvorbereitung"🔗.

array_to_string -Funktion zum Exportieren von Arrays array-to-string-function-export-arrays

Verwenden Sie die Funktion array_to_string , um die Elemente eines Arrays mithilfe eines gewünschten Trennzeichens wie _ oder | in eine Zeichenfolge zu verketten.

Sie können beispielsweise die folgenden XDM-Felder wie im Screenshot der Zuordnung gezeigt mit einer array_to_string('_',organizations) -Syntax kombinieren:

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus. Beachten Sie, wie die Elemente des Arrays mithilfe des Zeichens _ in eine einzelne Zeichenfolge verkettet werden.

First_Name,Last_Name,Personal_Email,Organization
John,Doe,johndoe@acme.org, "{'id':123,'orgName':'Acme Inc','founded':1990,'latestInteraction':1708041600000}_{'id':456,'orgName':'Superstar Inc','founded':2004,'latestInteraction':1692921600000}_{'id':789,'orgName':'Energy Corp','founded':2021,'latestInteraction':1725753600000}"

filterArray -Funktion zum Exportieren gefilterter Arrays

Verwenden Sie die Funktion filterArray , um die Elemente eines exportierten Arrays zu filtern. Sie können diese Funktion mit der oben beschriebenen Funktion array_to_string kombinieren.

Wenn Sie mit dem Array-Objekt organizations von oben fortfahren, können Sie eine Funktion wie array_to_string('_', filterArray(organizations, org -> org.founded > 2021)) schreiben und die Organisationen mit einem Wert für founded im Jahr 2021 oder höher zurückgeben.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus. Beachten Sie, wie die beiden Elemente des Arrays, die die Bedingung erfüllen, mithilfe des Zeichens _ in einer einzelnen Zeichenfolge verkettet werden.

John,Doe,johndoe@acme.org, "{'id':123,'orgName':'Acme Inc','founded':1990,'latestInteraction':1708041600000}_{'id':789,'orgName':'Energy Corp','founded':2021,'latestInteraction':1725753600000}"

transformArray -Funktion zum Exportieren transformierter Arrays

Verwenden Sie die Funktion transformArray , um die Elemente eines exportierten Arrays zu transformieren. Sie können diese Funktion mit der oben beschriebenen Funktion array_to_string kombinieren.

Wenn Sie mit dem Array-Objekt organizations von oben fortfahren, können Sie eine Funktion wie array_to_string('_', transformArray(organizations, org -> ucase(org.orgName))) schreiben und die Namen der Organisationen zurückgeben, die in Großbuchstaben konvertiert wurden.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus. Beachten Sie, wie die drei Elemente des Arrays transformiert und mit dem Zeichen _ in eine einzelne Zeichenfolge verkettet werden.

John,Doe,johndoe@acme.org,ACME INC_SUPERSTAR INC_ENERGY CORP

iif -Funktion zum Exportieren von Arrays iif-function-export-arrays

Verwenden Sie die Funktion iif , um Elemente eines Arrays unter bestimmten Bedingungen zu exportieren. Wenn Sie beispielsweise mit dem Array-Objekt organizations von oben fortfahren, können Sie eine einfache bedingte Funktion wie iif(organizations[0].equals("Marketing"), "isMarketing", "isNotMarketing") schreiben.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus. In diesem Fall ist das erste Element des Arrays Marketing, sodass die Person Mitglied der Marketing-Abteilung ist.

`First_Name,Last_Name, Personal_Email, Is_Member_Of_Marketing_Dept
John,Doe, johndoe@acme.org, "isMarketing"

add_to_array -Funktion zum Exportieren von Arrays add-to-array-function-export-arrays

Verwenden Sie die Funktion add_to_array , um einem exportierten Array Elemente hinzuzufügen. Sie können diese Funktion mit der oben beschriebenen Funktion array_to_string kombinieren.

Wenn Sie mit dem Array-Objekt organizations von oben fortfahren, können Sie eine Funktion wie source: array_to_string('_', add_to_array(organizations,"2023")) schreiben und die Organisationen zurückgeben, zu denen eine Person im Jahr 2023 gehört.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus. Beachten Sie, wie die drei Elemente des Arrays mithilfe des Zeichens _ in eine einzelne Zeichenfolge verkettet werden und 2023 ebenfalls am Ende der Zeichenfolge angehängt wird.

`First_Name,Last_Name,Personal_Email,Organization_Member_2023
John,Doe, johndoe@acme.org,"Marketing_Sales_Finance_2023"

flattenArray -Funktion zum Exportieren von reduzierten Arrays

Verwenden Sie die Funktion flattenArray , um ein exportiertes mehrdimensionales Array zu reduzieren. Sie können diese Funktion mit der oben beschriebenen Funktion array_to_string kombinieren.

Wenn Sie mit dem Array-Objekt organizations von oben fortfahren, können Sie eine Funktion wie array_to_string('_', flattenArray(organizations)) schreiben. Beachten Sie, dass die Funktion array_to_string das Eingabe-Array standardmäßig in eine Zeichenfolge reduziert.

Die resultierende Ausgabe entspricht der oben beschriebenen array_to_string -Funktion.

coalesce -Funktion zum Exportieren von Arrays coalesce-function-export-arrays

Verwenden Sie die Funktion coalesce , um auf das erste Element, das nicht null ist, eines Arrays zuzugreifen und es in eine Zeichenfolge zu exportieren.

Sie können beispielsweise die folgenden XDM-Felder wie im Screenshot der Zuordnung gezeigt kombinieren, indem Sie eine coalesce(subscriptions.hasPromotion) -Syntax verwenden, um den ersten true von false -Wert im Array zurückzugeben:

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus. Beachten Sie, wie der erste Wert, der nicht null ist, im Array in die Datei exportiert wird.true

First_Name,Last_Name,hasPromotion
John,Doe,true

size_of -Funktion zum Exportieren von Arrays sizeof-function-export-arrays

Verwenden Sie die Funktion size_of , um anzugeben, wie viele Elemente in einem Array vorhanden sind. Wenn Sie beispielsweise über ein Array-Objekt purchaseTime mit mehreren Zeitstempeln verfügen, können Sie mit der Funktion size_of angeben, wie viele separate Käufe von einer Person getätigt wurden.

Sie können beispielsweise die folgenden XDM-Felder wie im Screenshot der Zuordnung gezeigt kombinieren.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus. Beachten Sie, wie die zweite Spalte die Anzahl der Elemente im Array anzeigt, die der Anzahl der separaten Käufe des Kunden entsprechen.

`Personal_Email,Times_Purchased
johndoe@acme.org,"5"

Indexbasierter Array-Zugriff index-based-array-access

Sie können auf einen Index eines Arrays zugreifen, um ein einzelnes Element aus dem Array zu exportieren. Beispiel: Wenn Sie wie im obigen Beispiel für die Funktion size_of nur beim ersten Kauf eines bestimmten Produkts auf ein bestimmtes Produkt zugreifen und es exportieren möchten, können Sie mit purchaseTime[0] das erste Element des Zeitstempels exportieren, mit purchaseTime[1] das zweite Element des Zeitstempels exportieren, mit purchaseTime[2] das dritte Element des Zeitstempels exportieren usw.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus und exportiert den Kunden zum ersten Mal, wenn er einen Kauf tätigt:

`Personal_Email,First_Purchase
johndoe@acme.org,"1538097126"

Funktionen first und last zum Exportieren von Arrays first-and-last-functions-export-arrays

Verwenden Sie die Funktionen first und last , um das erste oder letzte Element in ein Array zu exportieren. Wenn Sie beispielsweise mit dem Array-Objekt purchaseTime mit mehreren Zeitstempeln aus den vorherigen Beispielen fortfahren, können Sie diese verwenden, um Funktionen zum Exportieren der ersten oder letzten von einer Person getätigten Kaufzeit zu verwenden.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus und exportiert das erste und letzte Mal, dass der Kunde einen Kauf tätigt:

`Personal_Email,First_Purchase, Last_Purchase
johndoe@acme.org,"1538097126","1664327526"