DokumentationExperience PlatformDatenvorbereitungsanleitung

Funktionen zur Datenvorbereitung

Last update: Tue Mar 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Developer

Mit Datenvorbereitung-Funktionen können Werte basierend auf den in Quellfeldern eingegebenen Werten berechnet und berechnet werden.

Felder

Ein Feldname kann eine beliebige gültige Kennung sein - eine unbegrenzte Sequenz von Unicode-Buchstaben und -Ziffern, beginnend mit einem Buchstaben, dem Dollarzeichen ($) oder dem Unterstrich (_). Bei Variablennamen wird auch zwischen Groß- und Kleinschreibung unterschieden.

Wenn ein Feldname dieser Konvention nicht entspricht, muss der Feldname mit ${}. Wenn der Feldname beispielsweise "Vorname"oder "Vorname"lautet, muss der Name wie folgt umgebrochen werden: ${First Name} oder ${First\.Name} bzw.

TIP
Wenn Sie mit Hierarchien arbeiten und ein untergeordnetes Attribut einen Punkt (.) enthält, müssen Sie einen Backslash (\) verwenden, um Sonderzeichen zu umgehen. Weitere Informationen finden Sie im Handbuch unter Maskieren von Sonderzeichen.

Wenn ein Feldname any der folgenden reservierten Schlüsselwörter, muss sie mit ${}:

new, mod, or, break, var, lt, for, false, while, eq, gt, div, not, null, continue, else, and, ne, true, le, if, ge, return, _errors

Auf Daten in Unterfeldern kann mithilfe der Punktnotation zugegriffen werden. Wenn beispielsweise eine name -Objekt, um auf die firstName Feld, verwenden name.firstName.

Funktionsliste

In den folgenden Tabellen sind alle unterstützten Zuordnungsfunktionen aufgeführt, einschließlich Beispielausdrücke und der resultierenden Ausgaben.

Zeichenfolgen-Funktionen string

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
concat
Verkettet die angegebenen Zeichenfolgen.
  • STRING: Die verketteten Zeichenfolgen.
concat(STRING_1, STRING_2)
concat("Hi, ", "There", "!")
"Hi, there!"
explode
Teilt die Zeichenfolge basierend auf einem Regex und gibt ein Array von Teilen zurück. Kann optional regex enthalten, um die Zeichenfolge zu teilen. Standardmäßig wird die Aufteilung in ","aufgelöst. Die folgenden Trennzeichen need zu maskieren \: +, ?, ^, |, ., [, (, {, ), *, $, \ Wenn Sie mehrere Zeichen als Trennzeichen angeben, wird das Trennzeichen als Trennzeichen mit mehreren Zeichen behandelt.
  • STRING: Erforderlich Die Zeichenfolge, die geteilt werden muss.
  • REGEX: Optional Der reguläre Ausdruck, der zum Aufteilen der Zeichenfolge verwendet werden kann.
explode(STRING, REGEX)
explode("Hallo, da!", "")
["Hi,", "there"]
instr
Gibt die Position/den Index einer Unterzeichenfolge zurück.
  • EINGABE: Erforderlich Die gesuchte Zeichenfolge.
  • SUBSTRING: Erforderlich Die Unterzeichenfolge, nach der in der Zeichenfolge gesucht wird.
  • START_POSITION: Optional Die Position, an der die Suche in der Zeichenfolge beginnen soll.
  • VORKOMMEN: Optional Das n-te Vorkommen, nach dem von der Startposition aus gesucht werden soll. Standardmäßig ist dies 1.
instr(INPUT, SUBSTRING, START_POSITION, OCCURRENCE)
instr("adobe.com", "com")
6
replacestr
Ersetzt die Suchzeichenfolge, sofern sie in der ursprünglichen Zeichenfolge vorhanden ist.
  • EINGABE: Erforderlich Die Eingabezeichenfolge.
  • TO_FIND: Erforderlich Die Zeichenfolge, die in der Eingabe nachgeschlagen werden soll.
  • TO_REPLACE: Erforderlich Die Zeichenfolge, die den Wert in "TO_FIND"ersetzt.
replace(INPUT, TO_FIND, TO_REPLACE)
replacestr("This is a string re test", "re", "replace")
"Dies ist ein string replace-Test"
substr
Gibt eine Teilzeichenfolge einer angegebenen Länge zurück.
  • EINGABE: Erforderlich Die Eingabezeichenfolge.
  • START_INDEX: Erforderlich Der Index der Eingabezeichenfolge, in der die Teilzeichenfolge beginnt.
  • LÄNGE: Erforderlich Die Länge der Teilzeichenfolge.
substr(INPUT, START_INDEX, LENGTH)
substr("This is a substring test", 7, 8)
"a subst"
lower /
lcase
Konvertiert einen String in Kleinbuchstaben.
  • EINGABE: Erforderlich Die Zeichenfolge, die in Kleinbuchstaben umgewandelt wird.
lower(INPUT)
lower("HeLLo")
lcase("HeLLo")
"hello"
upper /
ucase
Konvertiert einen String in Großbuchstaben.
  • EINGABE: Erforderlich Die Zeichenfolge, die in Großbuchstaben umgewandelt wird.
upper(INPUT)
upper("HeLLo")
ucase("HeLLo")
"HELLO"
split
Teilt eine Eingabezeichenfolge auf einem Trennzeichen. Das folgende Trennzeichen need zu maskieren \: \. Wenn Sie mehrere Trennzeichen einschließen, wird die Zeichenfolge auf any der in der Zeichenfolge vorhandenen Trennzeichen. Hinweis: Diese Funktion gibt nur Indizes zurück, die nicht null sind, unabhängig vom Vorhandensein des Trennzeichens. Wenn alle Indizes, einschließlich Nullen, im resultierenden Array erforderlich sind, verwenden Sie stattdessen die Funktion "explode".
  • EINGABE: Erforderlich Die Eingabezeichenfolge, die geteilt werden soll.
  • SEPARATOR: Erforderlich Die Zeichenfolge, die zum Aufteilen der Eingabe verwendet wird.
split(INPUT, SEPARATOR)
split("Hello World", "")
["Hello", "world"]
join
Verbindet eine Liste von Objekten mithilfe des Trennzeichens.
  • SEPARATOR: Erforderlich Die Zeichenfolge, die zum Verbinden der Objekte verwendet wird.
  • OBJEKTE: Erforderlich Ein Array von Zeichenfolgen, die verknüpft werden.
join(SEPARATOR, [OBJECTS])
join(" ", to_array(true, "Hello", "world"))
"Hello World"
lpad
Fügt die linke Seite einer Zeichenfolge mit der anderen angegebenen Zeichenfolge ein.
  • EINGABE: Erforderlich Die Zeichenfolge, die eingefügt werden soll. Diese Zeichenfolge kann null sein.
  • COUNT: Erforderlich Die Größe der Zeichenfolge, die eingefügt werden soll.
  • HINZUFÜGEN: Erforderlich Die Zeichenfolge, mit der die Eingabe aufgefüllt werden soll. Wenn null oder leer, wird es als einzelnes Leerzeichen behandelt.
lpad(INPUT, COUNT, PADDING)
lpad("bat", 8, "yz")
"yzyzybat"
rpad
Fügt die rechte Seite einer Zeichenfolge mit der anderen angegebenen Zeichenfolge ein.
  • EINGABE: Erforderlich Die Zeichenfolge, die eingefügt werden soll. Diese Zeichenfolge kann null sein.
  • COUNT: Erforderlich Die Größe der Zeichenfolge, die eingefügt werden soll.
  • HINZUFÜGEN: Erforderlich Die Zeichenfolge, mit der die Eingabe aufgefüllt werden soll. Wenn null oder leer, wird es als einzelnes Leerzeichen behandelt.
rpad(INPUT, COUNT, PADDING)
rpad("bat", 8, "yz")
"batyzyzy"
left
Ruft die ersten n Zeichen der angegebenen Zeichenfolge ab.
  • STRING: Erforderlich Die Zeichenfolge, für die Sie die ersten n Zeichen erhalten.
  • COUNT: Erforderlich Die "n"-Zeichen, die aus der Zeichenfolge abgerufen werden sollen.
left(STRING, COUNT)
left("abcde", 2)
"ab"
right
Ruft die letzten n Zeichen der angegebenen Zeichenfolge ab.
  • STRING: Erforderlich Die Zeichenfolge, für die Sie die letzten n Zeichen erhalten.
  • COUNT: Erforderlich Die "n"-Zeichen, die aus der Zeichenfolge abgerufen werden sollen.
right(STRING, COUNT)
right("abcde", 2)
"de"
ltrim
Entfernt den Leerraum am Anfang des Strings.
  • STRING: Erforderlich Die Zeichenfolge, aus der Sie den Leerraum entfernen möchten.
ltrim(STRING)
ltrim(" hello")
"hello"
rtrim
Entfernt den Leerraum am Ende des Strings.
  • STRING: Erforderlich Die Zeichenfolge, aus der Sie den Leerraum entfernen möchten.
rtrim(STRING)
rtrim("hello ")
"hello"
trim
Entfernt den Leerraum vom Anfang und vom Ende der Zeichenfolge.
  • STRING: Erforderlich Die Zeichenfolge, aus der Sie den Leerraum entfernen möchten.
trim(STRING)
trim(" hello ")
"hello"
gleich
Vergleicht zwei Zeichenketten, um sicherzustellen, dass sie gleich sind. Diese Funktion unterscheidet zwischen Groß- und Kleinschreibung.
  • STRING1: Erforderlich Die erste Zeichenfolge, die Sie vergleichen möchten.
  • STRING2: Erforderlich Die zweite Zeichenfolge, die Sie vergleichen möchten.
STRING1. ​equals( ​ STRING2)
"string1". ​equals ​("STRING1")
false (falsch)
equalsIgnoreCase
Vergleicht zwei Zeichenketten, um sicherzustellen, dass sie gleich sind. Diese Funktion ist not Groß-/Kleinschreibung beachten.
  • STRING1: Erforderlich Die erste Zeichenfolge, die Sie vergleichen möchten.
  • STRING2: Erforderlich Die zweite Zeichenfolge, die Sie vergleichen möchten.
STRING1. ​equalsIgnoreCase ​(STRING2)
"string1". ​equalsIgnoreCase ​("STRING1)
wahr

Funktionen mit reguläreren Ausdrücken

Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
extract_regex
Extrahiert basierend auf einem regulären Ausdruck Gruppen aus der Eingabezeichenfolge.
  • STRING: Erforderlich Die Zeichenfolge, aus der Sie die Gruppen extrahieren.
  • REGEX: Erforderlich Der reguläre Ausdruck, mit dem die Gruppe übereinstimmen soll.
extract_regex(STRING, REGEX)
extract_regex ​("E259,E259B_009,1_1" ​, "([,]+),[,]*,([^,]+)")
["E259,E259B_009,1_1", "E259", "1_1"]
matches_regex
Überprüft, ob die Zeichenfolge mit dem eingegebenen regulären Ausdruck übereinstimmt.
  • STRING: Erforderlich Die Zeichenfolge, die Sie überprüfen, entspricht dem regulären Ausdruck.
  • REGEX: Erforderlich Der reguläre Ausdruck, mit dem Sie vergleichen.
matches_regex(STRING, REGEX)
matches_regex("E259,E259B_009,1_1", "([,]+),[,]*,([^,]+)")
wahr

Hashfunktionen hashing

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
sha1
Nimmt eine Eingabe und erzeugt einen Hash-Wert mit Secure Hash Algorithm 1 (SHA-1).
  • EINGABE: Erforderlich Der Klartext, der gehasht werden soll.
  • CHARSET: Optional Der Name des Zeichensatzes. Mögliche Werte sind UTF-8, UTF-16, ISO-8859-1 und US-ASCII.
sha1(INPUT, CHARSET)
sha1("my text", "UTF-8")
c3599c11e47719df18a24 ​ 48690840c5dfcce3c80
sha256
Nimmt eine Eingabe und erzeugt einen Hash-Wert mithilfe des Secure Hash Algorithm 256 (SHA-256).
  • EINGABE: Erforderlich Der Klartext, der gehasht werden soll.
  • CHARSET: Optional Der Name des Zeichensatzes. Mögliche Werte sind UTF-8, UTF-16, ISO-8859-1 und US-ASCII.
sha256(INPUT, CHARSET)
sha256("my text", "UTF-8")
7330d2b39ca35eaf4cb95fc846c21 ​ ee6a39af698154a83a586ee270a0d372104
sha512
Nimmt eine Eingabe und erzeugt einen Hash-Wert mithilfe des Secure Hash Algorithm 512 (SHA-512).
  • EINGABE: Erforderlich Der Klartext, der gehasht werden soll.
  • CHARSET: Optional Der Name des Zeichensatzes. Mögliche Werte sind UTF-8, UTF-16, ISO-8859-1 und US-ASCII.
sha512(INPUT, CHARSET)
sha512("my text", "UTF-8")
a3d7e45a0d9be5fd4e4b9a3b8c9c2163c21ef ​ 708bf11b4232bb21d2a8704ada2cdcd7b367dd07 88a89 ​ a5c908cfe377aceb1072a7b386b7d4fd2ff68a8fd24d16
md5
Nimmt eine Eingabe und erzeugt einen Hash-Wert mit MD5.
  • EINGABE: Erforderlich Der Klartext, der gehasht werden soll.
  • CHARSET: Optional Der Name des Zeichensatzes. Mögliche Werte sind UTF-8, UTF-16, ISO-8859-1 und US-ASCII.
md5(INPUT, CHARSET)
md5("my text", "UTF-8")
d3b96ce8c9fb4 ​ e9bd0198d03ba6852c7
crc32
Eine Eingabe verwendet einen CRC-Algorithmus (zyklische Redundanzprüfung), um einen 32-Bit-zyklischen Code zu erzeugen.
  • EINGABE: Erforderlich Der Klartext, der gehasht werden soll.
  • CHARSET: Optional Der Name des Zeichensatzes. Mögliche Werte sind UTF-8, UTF-16, ISO-8859-1 und US-ASCII.
crc32(INPUT, CHARSET)
crc32("my text", "UTF-8")
8df92e80

URL-Funktionen url

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
get_url_protocol
Gibt das Protokoll aus der angegebenen URL zurück. Wenn die Eingabe ungültig ist, wird null zurückgegeben.
  • URL: Erforderlich Die URL, aus der das Protokoll extrahiert werden soll.
get_url_protocol ​(URL)
get_url_protocol("https://platform ​ .adobe.com/home")
https
get_url_host
Gibt den Host der angegebenen URL zurück. Wenn die Eingabe ungültig ist, wird null zurückgegeben.
  • URL: Erforderlich Die URL, aus der der Host extrahiert werden muss.
get_url_host ​(URL)
get_url_host ​("https://platform ​ .adobe.com/home")
platform.adobe.com
get_url_port
Gibt den Port der angegebenen URL zurück. Wenn die Eingabe ungültig ist, wird null zurückgegeben.
  • URL: Erforderlich Die URL, aus der der Port extrahiert werden muss.
get_url_port(URL)
get_url_port ​("sftp://example.com//home/ ​ joe/employee.csv")
22
get_url_path
Gibt den Pfad der angegebenen URL zurück. Standardmäßig wird der vollständige Pfad zurückgegeben.
  • URL: Erforderlich Die URL, aus der der Pfad extrahiert werden muss.
  • FULL_PATH: Optional Ein boolean -Wert, der bestimmt, ob der vollständige Pfad zurückgegeben wird. Wenn der Wert auf "false"gesetzt ist, wird nur das Ende des Pfads zurückgegeben.
get_url_path ​(URL, FULL_PATH)
get_url_path ​("sftp://example.com// ​ home/joe/employee.csv")
"//home/joe/​ employee.csv"
get_url_query_str
Gibt die Abfragezeichenfolge einer angegebenen URL als Zuordnung des Abfragezeichenfolgennamens und des Abfragezeichenfolgenwerts zurück.
  • URL: Erforderlich Die URL, von der Sie die Abfragezeichenfolge abrufen möchten.
  • ANCHOR: Erforderlich Bestimmt, was mit dem Anker in der Abfragezeichenfolge ausgeführt wird. Kann einer von drei Werten sein: "keep", "remove"oder "append".

    Wenn der Wert "keep"lautet, wird der Anker an den zurückgegebenen Wert angehängt.
    Wenn der Wert "remove"lautet, wird der Anker aus dem zurückgegebenen Wert entfernt.
    Wenn der Wert "append"lautet, wird der Anker als separater Wert zurückgegeben.
get_url_query_str ​(URL, ANCHOR)
get_url_query_str ​("foo://example.com:8042 ​/over/dahin?name= ​ ferret#nose", "keep")
get_url_query_str ​("foo://example.com:8042 ​/over/dahin?name= ​ ferret#nose", "remove")
get_url_query_str ​("foo://example.com ​:8042/over/gibt ​?name=ferret#nose", "append")
{"name": "ferret#nose"}
{"name": "ferret"}
{"name": "ferret", "_anchor_": "nose"}
get_url_encoded
Diese Funktion akzeptiert eine URL als Eingabe und ersetzt oder kodiert die Sonderzeichen durch ASCII-Zeichen. Weitere Informationen zu Sonderzeichen finden Sie im Abschnitt Liste der Sonderzeichen im Anhang dieses Dokuments.
  • URL: Erforderlich Die Eingabe-URL mit Sonderzeichen, die Sie ersetzen oder mit ASCII-Zeichen kodieren möchten.
get_url_encoded(URL)
get_url_encoded("https://example.com/partneralliance_asia-pacific_2022")
https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022
get_url_decoded
Diese Funktion akzeptiert eine URL als Eingabe und dekodiert die ASCII-Zeichen in Sonderzeichen. Weitere Informationen zu Sonderzeichen finden Sie im Abschnitt Liste der Sonderzeichen im Anhang dieses Dokuments.
  • URL: Erforderlich Die Eingabe-URL mit ASCII-Zeichen, die Sie in Sonderzeichen dekodieren möchten.
get_url_decoded(URL)
get_url_decoded("https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022")
https://example.com/partneralliance_asia-pacific_2022

Datums- und Uhrzeitfunktionen date-and-time

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen. Weitere Informationen zu date -Funktion finden Sie im Abschnitt Datumsangaben des Handbuch zur Handhabung von Datenformaten.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
now
Ruft die aktuelle Zeit ab.
now()
now()
2021-10-26T10:10:24Z
Zeitstempel
Ruft die aktuelle Unix-Zeit ab.
timestamp()
timestamp()
1571850624571
format
Formatiert das Eingabedatum in einem angegebenen Format.
  • DATUM: Erforderlich Das Eingabedatum als ZonedDateTime -Objekt, das Sie formatieren möchten.
  • FORMAT: Erforderlich Das Format, in das das Datum geändert werden soll.
format(DATE, FORMAT)
format(2019-10-23T11):24:00+00:00, "yyyy-MM-dd HH:mm:ss")
2019-10-23 11:24:35
dformat
Konvertiert einen Zeitstempel in eine Datums-Zeichenfolge in einem angegebenen Format.
  • ZEITSTEMPEL: Erforderlich Der Zeitstempel, den Sie formatieren möchten. Dies wird in Millisekunden geschrieben.
  • FORMAT: Erforderlich Das Format, in dem der Zeitstempel verwendet werden soll.
dformat(TIMESTAMP, FORMAT)
dformat(1571829875000, "yyyy-MM-dd'T'HH:mm:ss.SSSX")
2019-10-23T11:24:35.000Z
date
Konvertiert eine Datums-Zeichenfolge in ein ZonedDateTime-Objekt (ISO 8601-Format).
  • DATUM: Erforderlich Die Zeichenfolge, die das Datum darstellt.
  • FORMAT: Erforderlich Die Zeichenfolge, die das Format des Quelldatums darstellt.Hinweis: Dies geschieht not das Format darstellen, in das Sie die Datums-Zeichenfolge konvertieren möchten.
  • DEFAULT_DATE: Erforderlich Das Standarddatum, das zurückgegeben wird, wenn das angegebene Datum null ist.
date(DATE, FORMAT, DEFAULT_DATE)
date("2019-10-23 11:24", "yyy-MM-dd HH:mm", now())
2019-10-23T11:24:00Z
date
Konvertiert eine Datums-Zeichenfolge in ein ZonedDateTime-Objekt (ISO 8601-Format).
  • DATUM: Erforderlich Die Zeichenfolge, die das Datum darstellt.
  • FORMAT: Erforderlich Die Zeichenfolge, die das Format des Quelldatums darstellt.Hinweis: Dies geschieht not das Format darstellen, in das Sie die Datums-Zeichenfolge konvertieren möchten.
date(DATE, FORMAT)
date("2019-10-23 11:24", "yyy-MM-dd HH:mm")
2019-10-23T11:24:00Z
date
Konvertiert eine Datums-Zeichenfolge in ein ZonedDateTime-Objekt (ISO 8601-Format).
  • DATUM: Erforderlich Die Zeichenfolge, die das Datum darstellt.
date(DATE)
date("2019-10-23 11:24")
"10.10.2011:24:00Z"
date_part
Ruft die Datumsbereiche ab. Die folgenden Komponentenwerte werden unterstützt:

"year"
"yyyy"
"yy"

"quarter"
"qq"
"q"

"month"
"mm"
"m"

"dayofyear"
"dy"
"y"

"day"
"dd"
d

"week"
"ww"
"w"

"Wochentag"
"dw"
"w"

"hour"
"hh"
"hh24"
"hh12"

"minute"
"mi"
"n"

"second"
"ss"
"s"

"millisecond"
"SSS"
  • KOMPONENTE: Erforderlich Eine Zeichenfolge, die den Teil des Datums darstellt.
  • DATUM: Erforderlich Das Datum in einem Standardformat.
date_part ​(COMPONENT, DATE)
date_part("MM", date("2019-10-17 11":55:12")
10
set_date_part
Ersetzt eine Komponente an einem bestimmten Datum. Folgende Komponenten werden akzeptiert:

"year"
"yyyy"
"yy"

"month"
"mm"
"m"

"day"
"dd"
d

"hour"
"hh"

"minute"
"mi"
"n"

"second"
"ss"
"s"
  • KOMPONENTE: Erforderlich Eine Zeichenfolge, die den Teil des Datums darstellt.
  • WERT: Erforderlich Der für die Komponente für ein bestimmtes Datum festzulegende Wert.
  • DATUM: Erforderlich Das Datum in einem Standardformat.
set_date_part ​(COMPONENT, VALUE, DATE)
set_date_part("m", 4, date("2016-11-09T11":44:44.797")
"2016-04-09T11:44:44Z"
make_date_time
Erstellt ein Datum aus Teilen. Diese Funktion kann auch mit make_timestamp ausgelöst werden.
  • JAHR: Erforderlich Das Jahr, vierstellig geschrieben.
  • MONAT: Erforderlich Der Monat. Die zulässigen Werte sind 1 bis 12.
  • TAG: Erforderlich Der Tag. Die zulässigen Werte sind 1 bis 31.
  • STUNDE: Erforderlich Die Stunde. Die zulässigen Werte sind 0 bis 23.
  • MINUTE: Erforderlich Die Minute. Die zulässigen Werte sind 0 bis 59.
  • NANOSECOND: Erforderlich Die Nanosekundenwerte. Die zulässigen Werte sind 0 bis 999999999.
  • ZEITZONE: Erforderlich Die Zeitzone für die Datum/Uhrzeit.
make_date_time ​(YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, NANOSECOND, TIMEZONE)
make_date_time ​(2019, 10, 17, 11, 55, 12, 999, "America/Los_Angeles")
2019-10-17T11:55:12Z
zone_date_to_utc
Konvertiert ein Datum in einer beliebigen Zeitzone in ein Datum in UTC.
  • DATUM: Erforderlich Das Datum, das Sie konvertieren möchten.
zone_date_to_utc ​(DATE)
zone_date_to_utc​(2019-10-17T11:55:​12 PST
2019-10-17T19:55:12Z
zone_date_to_zone
Konvertiert ein Datum aus einer Zeitzone in eine andere Zeitzone.
  • DATUM: Erforderlich Das Datum, das Sie konvertieren möchten.
  • ZONE: Erforderlich Die Zeitzone, in die Sie das Datum konvertieren möchten.
zone_date_to_zone ​(DATE, ZONE)
zone_date_to_utc​(now(), "Europe/Paris")
2021-10-26T15:43:59Z

Hierarchien - Objekte objects

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
is_empty
Prüft, ob ein Objekt leer ist.
  • EINGABE: Erforderlich Das Objekt, das Sie überprüfen möchten, ist leer.
is_empty(INPUT)
is_empty([1, null, 2, 3])
false (falsch)
arrays_to_object
Erstellt eine Liste von Objekten.
  • EINGABE: Erforderlich Eine Gruppierung von Schlüssel- und Array-Paaren.
arrays_to_object(INPUT)
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])
[{ "sku": "id1", "price": 22.5 }, { "sku": "id2", "price": 14.35 }]
to_object
Erstellt ein Objekt basierend auf den angegebenen flachen Schlüssel/Wert-Paaren.
  • EINGABE: Erforderlich Eine flache Liste von Schlüssel/Wert-Paaren.
to_object(INPUT)
to_object ​("firstName", "John", "lastName", "Doe")
{"firstName": "John", "lastName": "Doe"}
str_to_object
Erstellt ein Objekt aus der Eingabezeichenfolge.
  • STRING: Erforderlich Die Zeichenfolge, die zum Erstellen eines Objekts analysiert wird.
  • VALUE_DELIMITER: Optional Das Trennzeichen, das ein Feld vom Wert trennt. Das Standardtrennzeichen ist :.
  • FIELD_DELIMITER: Optional Das Trennzeichen, das Feldwertpaare trennt. Das Standardtrennzeichen ist ,.
str_to_object ​(STRING, VALUE_DELIMITER, FIELD_DELIMITER) Hinweis: Sie können die get() -Funktion zusammen mit str_to_object() , um Werte für die Schlüssel in der Zeichenfolge abzurufen.
  • Beispiel 1: str_to_object("firstName - John ; lastName - ; - 123 345 7890", "-", ";")
  • Beispiel 2: str_to_object("firstName - John ; lastName - ; phone - 123 456 7890", "-", ";").get("firstName")
  • Beispiel 1:{"firstName": "John", "lastName": "Doe", "phone": "123 456 7890"}
  • Beispiel 2: "John"
contains_key
Überprüft, ob das Objekt in den Quelldaten vorhanden ist. Hinweis: Diese Funktion ersetzt die veraltete is_set() -Funktion.
  • EINGABE: Erforderlich Der Pfad, der überprüft werden soll, wenn er in den Quelldaten vorhanden ist.
contains_key(INPUT)
contains_key("evars.evar.field1")
wahr
nullify
Legt den Wert des Attributs auf null. Dies sollte verwendet werden, wenn Sie das Feld nicht in das Zielschema kopieren möchten.
nullify()
nullify()
null
get_keys
Analysiert die Schlüssel/Wert-Paare und gibt alle Schlüssel zurück.
  • OBJEKT: Erforderlich Das Objekt, aus dem die Schlüssel extrahiert werden.
get_keys(OBJECT)
get_keys({"book1": "Pride and Prejustice", "book2": "1984"})
["book1", "book2"]
get_values
Analysiert die Schlüssel-Wert-Paare und gibt den Wert der Zeichenfolge basierend auf dem angegebenen Schlüssel zurück.
  • STRING: Erforderlich Die Zeichenfolge, die Sie analysieren möchten.
  • SCHLÜSSEL: Erforderlich Der Schlüssel, für den der Wert extrahiert werden muss.
  • VALUE_DELIMITER: Erforderlich Das Trennzeichen, das das Feld und den Wert trennt. Wenn eine null oder eine leere Zeichenfolge angegeben wird, lautet dieser Wert :.
  • FIELD_DELIMITER: Optional Das Trennzeichen, das Feld- und Wertpaare trennt. Wenn eine null oder eine leere Zeichenfolge angegeben wird, lautet dieser Wert ,.
get_values(STRING, KEY, VALUE_DELIMITER, FIELD_DELIMITER)
get_values("firstName - John , lastName - Cena , phone - 555 420 8692", "firstName", "-", ",")
John
map_get_values
Nimmt eine Zuordnung und eine Schlüsseleingabe. Wenn die Eingabe ein einzelner Schlüssel ist, gibt die Funktion den mit diesem Schlüssel verknüpften Wert zurück. Wenn die Eingabe ein Zeichenfolgen-Array ist, gibt die Funktion alle Werte zurück, die den bereitgestellten Schlüsseln entsprechen. Wenn die eingehende Zuordnung doppelte Schlüssel enthält, muss der Rückgabewert die Schlüssel deduplizieren und eindeutige Werte zurückgeben.
  • MAP: Erforderlich Die Eingabemaps.
  • SCHLÜSSEL: Erforderlich Der Schlüssel kann eine einzelne Zeichenfolge oder ein Zeichenfolgen-Array sein. Wenn ein anderer primitiver Typ (Daten/Zahl) angegeben wird, wird er als Zeichenfolge behandelt.
get_values(MAP, KEY)
Lesen Sie hierzu die Anhang für ein Codebeispiel.
map_has_keys
Wenn ein oder mehrere Eingabeschlüssel angegeben sind, gibt die Funktion "true"zurück. Wenn ein Zeichenfolgen-Array als Eingabe bereitgestellt wird, gibt die Funktion beim ersten gefundenen Schlüssel "true"zurück.
  • MAP: Erforderlich Die Eingabemap-Daten
  • SCHLÜSSEL: Erforderlich Der Schlüssel kann eine einzelne Zeichenfolge oder ein Zeichenfolgen-Array sein. Wenn ein anderer primitiver Typ (Daten/Zahl) angegeben wird, wird er als Zeichenfolge behandelt.
map_has_keys(MAP, KEY)
Lesen Sie hierzu die Anhang für ein Codebeispiel.
add_to_map
akzeptiert mindestens zwei Eingaben. Eine beliebige Anzahl von Karten kann als Eingaben bereitgestellt werden. Data Prep gibt eine einzelne Zuordnung zurück, die alle Schlüssel-Wert-Paare aus allen Eingaben enthält. Wenn ein oder mehrere Schlüssel wiederholt werden (in derselben Zuordnung oder über mehrere Maps hinweg), dedupliziert Data Prep die Schlüssel so, dass das erste Schlüssel-Wert-Paar in der Reihenfolge beibehalten wird, in der sie in der Eingabe übergeben wurden.
MAP: Erforderlich Die Eingabemaps.
add_to_map(MAP 1, MAP 2, MAP 3, …)
Lesen Sie hierzu die Anhang für ein Codebeispiel.
object_to_map (Syntax 1)
Verwenden Sie diese Funktion, um Map -Datentypen zu erstellen.
  • SCHLÜSSEL: Erforderlich Schlüssel müssen eine Zeichenfolge sein. Wenn andere Primitive-Werte wie Ganzzahlen oder Datumswerte angegeben werden, werden sie automatisch in Zeichenfolgen konvertiert und als Zeichenfolgen behandelt.
  • ANY_TYPE: Erforderlich Bezieht sich auf jeden unterstützten XDM-Datentyp mit Ausnahme von Maps.
object_to_map(KEY, ANY_TYPE, KEY, ANY_TYPE, … )
Lesen Sie hierzu die Anhang für ein Codebeispiel.
object_to_map (Syntax 2)
Verwenden Sie diese Funktion, um Map -Datentypen zu erstellen.
  • OBJEKT: Erforderlich Sie können ein eingehendes Objekt oder Objekt-Array angeben und als Schlüssel auf ein Attribut innerhalb des Objekts verweisen.
object_to_map(OBJECT)
Lesen Sie hierzu die Anhang für ein Codebeispiel.
object_to_map (Syntax 3)
Verwenden Sie diese Funktion, um Map -Datentypen zu erstellen.
  • OBJEKT: Erforderlich Sie können ein eingehendes Objekt oder Objekt-Array angeben und als Schlüssel auf ein Attribut innerhalb des Objekts verweisen.
object_to_map(OBJECT_ARRAY, ATTRIBUTE_IN_OBJECT_TO_BE_USED_AS_A_KEY)
Lesen Sie hierzu die Anhang für ein Codebeispiel.

Informationen zur Objektkopierfunktion finden Sie im Abschnitt . below.

Hierarchien - Arrays arrays

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
coalesce
Gibt das erste Objekt zurück, das nicht null ist und sich in einem angegebenen Array befindet.
  • EINGABE: Erforderlich Das Array, von dem Sie das erste Objekt finden möchten, dessen Wert nicht null ist.
coalesce(INPUT)
coalesce(null, null, null, "first", null, "second")
"first"
first
Ruft das erste Element des angegebenen Arrays ab.
  • EINGABE: Erforderlich Das Array, für das Sie das erste Element suchen möchten.
first(INPUT)
first("1", "2", "3")
"1"
last
Ruft das letzte Element des angegebenen Arrays ab.
  • EINGABE: Erforderlich Das Array, für das Sie das letzte Element suchen möchten.
last(INPUT)
last("1", "2", "3")
"3"
add_to_array
Fügt Elemente am Ende des Arrays hinzu.
  • ARRAY: Erforderlich Das Array, dem Sie Elemente hinzufügen.
  • WERTE: Die Elemente, die an das Array angehängt werden sollen.
add_to_array ​(ARRAY, VALUES)
add_to_array ​(["a", "b"], 'c', 'd')
['a', 'b', 'c', 'd']
join_arrays
Kombiniert die Arrays miteinander.
  • ARRAY: Erforderlich Das Array, dem Sie Elemente hinzufügen.
  • WERTE: Die Arrays, die an das übergeordnete Array angehängt werden sollen.
join_arrays ​(ARRAY, VALUES)
join_arrays ​(["a", "b"], ['c'], ["d", "e"])
['a', 'b', 'c', 'd', 'e']
to_array
Nimmt eine Liste von Eingaben und konvertiert sie in ein Array.
  • INCLUDE_NULLS: Erforderlich Ein boolean -Wert, der angibt, ob Nullen in das Antwort-Array aufgenommen werden sollen.
  • WERTE: Erforderlich Die Elemente, die in ein Array konvertiert werden sollen.
to_array ​(INCLUDE_NULLS, VALUES)
to_array(false, 1, null, 2, 3)
[1, 2, 3]
size_of
Gibt die Größe der Eingabe zurück.
  • EINGABE: Erforderlich Das Objekt, dessen Größe Sie ermitteln möchten.
size_of(INPUT)
size_of([1, 2, 3, 4])
4
upsert_array_append
Mit dieser Funktion werden alle Elemente im gesamten Eingabe-Array an das Ende des Arrays in Profil angehängt. Diese Funktion ist only anwendbar während Aktualisierungen. Wenn diese Funktion im Kontext von Einfügen verwendet wird, gibt sie die Eingabe unverändert zurück.
  • ARRAY: Erforderlich Das Array, an das das Array im Profil angehängt werden soll.
update_array_append(ARRAY)
upsert_array_append([123, 456])
[123.456]
upsert_array_replace
Diese Funktion wird verwendet, um Elemente in einem Array zu ersetzen. Diese Funktion ist only anwendbar während Aktualisierungen. Wenn diese Funktion im Kontext von Einfügen verwendet wird, gibt sie die Eingabe unverändert zurück.
  • ARRAY: Erforderlich Das Array, das das Array im Profil ersetzen soll.
upsert_array_replace(ARRAY)
upsert_array_replace([123, 456], 1)
[123.456]

Hierarchien - Zuordnung map

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
array_to_map
Diese Funktion akzeptiert ein Objekt-Array und einen Schlüssel als Eingabe und gibt eine Zuordnung des Schlüsselfelds mit dem Wert als Schlüssel und dem Array-Element als Wert zurück.
  • EINGABE: Erforderlich Das Objekt-Array, für das Sie das erste Objekt ungleich null finden möchten.
  • SCHLÜSSEL: Erforderlich Der Schlüssel muss ein Feldname im Objekt-Array und das Objekt als Wert sein.
array_to_map(OBJECT[] INPUTS, KEY)
Lesen Sie die Anhang für ein Codebeispiel.
object_to_map
Diese Funktion akzeptiert ein Objekt als Argument und gibt eine Zuordnung von Schlüssel-Wert-Paaren zurück.
  • EINGABE: Erforderlich Das Objekt-Array, für das Sie das erste Objekt ungleich null finden möchten.
object_to_map(OBJECT_INPUT)
"object_to_map(address), wobei die Eingabe " + "address: {line1 : "345 park ave",line2: "bldg 2",City : "san jose",State : "CA",type: "office"}" ist
Gibt eine Zuordnung mit angegebenen Feld-Name- und Wert-Paaren zurück oder null, wenn die Eingabe null ist. Beispiel: "{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"
to_map
Diese Funktion akzeptiert eine Liste von Schlüssel-Wert-Paaren und gibt eine Zuordnung von Schlüssel-Wert-Paaren zurück.
to_map(OBJECT_INPUT)
"to_map("firstName", "John", "lastName", "Doe")"
Gibt eine Zuordnung mit angegebenen Feld-Name- und Wert-Paaren zurück oder null, wenn die Eingabe null ist. Beispiel: "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Logische Operatoren logical-operators

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
decode
Bei einem Schlüssel und einer Liste mit Schlüsselwertpaaren, die als Array reduziert werden, gibt die Funktion den Wert zurück, wenn der Schlüssel gefunden wird, oder gibt einen Standardwert zurück, wenn er im Array vorhanden ist.
  • SCHLÜSSEL: Erforderlich Der Schlüssel, der abgeglichen werden soll.
  • OPTIONS: Erforderlich Ein reduziertes Array von Schlüssel/Wert-Paaren. Optional kann ein Standardwert am Ende gesetzt werden.
decode(KEY, OPTIONS)
decode(stateCode, "ca", "California", "pa", "Pennsylvania", "N/A")
Wenn der angegebene stateCode "ca"ist, "California".
Wenn der angegebene stateCode "pa"ist, "Pennsylvania".
Wenn der stateCode nicht mit dem folgenden übereinstimmt, "N/A".
iif
Wertet einen bestimmten booleschen Ausdruck aus und gibt den angegebenen Wert basierend auf dem Ergebnis zurück.
  • AUSDRUCK: Erforderlich Der boolesche Ausdruck, der ausgewertet wird.
  • TRUE_VALUE: Erforderlich Der Wert, der zurückgegeben wird, wenn der Ausdruck "true"ergibt.
  • FALSE_VALUE: Erforderlich Der Wert, der zurückgegeben wird, wenn der Ausdruck false ergibt.
iif(EXPRESSION, TRUE_VALUE, FALSE_VALUE)
iif("s".equalsIgnoreCase("S"), "True", "False")
"True"

Aggregation aggregation

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
min
Gibt das Minimum der angegebenen Argumente zurück. Verwendet die natürliche Reihenfolge.
  • OPTIONS: Erforderlich Ein oder mehrere Objekte, die miteinander verglichen werden können.
min(OPTIONS)
min(3, 1, 4)
1
max
Gibt das Maximum der angegebenen Argumente zurück. Verwendet die natürliche Reihenfolge.
  • OPTIONS: Erforderlich Ein oder mehrere Objekte, die miteinander verglichen werden können.
max(OPTIONS)
max(3, 1, 4)
4

Typkonvertierungen type-conversions

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
to_bigint
Konvertiert einen String in einen BigInteger-Wert.
  • STRING: Erforderlich Die Zeichenfolge, die in einen BigInteger konvertiert werden soll.
to_bigint(STRING)
to_bigint ​("100000.34")
1000000,34
to_decimal
Konvertiert einen String in einen Double-String.
  • STRING: Erforderlich Die Zeichenfolge, die in ein Double-Zeichen umgewandelt werden soll.
to_decimal(STRING)
to_decimal("20.5")
20,5
to_float
Konvertiert einen String in einen Float-Wert.
  • STRING: Erforderlich Die Zeichenfolge, die in eine Gleitkommazahl konvertiert werden soll.
to_float(STRING)
to_float("12.3456")
12,34566
to_integer
Konvertiert eine Zeichenfolge in eine Ganzzahl.
  • STRING: Erforderlich Die Zeichenfolge, die in eine Ganzzahl umgewandelt werden soll.
to_integer(STRING)
to_integer("12")
12

JSON-Funktionen json

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
json_to_object
Deserialisieren Sie den JSON-Inhalt aus der angegebenen Zeichenfolge.
  • STRING: Erforderlich Die zu deserialisierende JSON-Zeichenfolge.
json_to_object ​(STRING)
json_to_object ​({"info":{"firstName":"John","lastName": "Doe"})
Ein Objekt, das die JSON darstellt.

Sondermaßnahmen special-operations

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
uid /
guid
Generiert eine Pseudo-Zufallskennung.
uuid()
guid()
uuid()
guid()
7c0267d2-bb74-4e1a-9275-3bf4fccda5f4
c7016dc7-3163-43f7-afc7-2e1c9c206333
fpid_to_ecid
Diese Funktion akzeptiert eine FPID-Zeichenfolge und konvertiert sie in eine ECID, die in Adobe Experience Platform- und Adobe Experience Cloud-Anwendungen verwendet werden soll.
  • STRING: Erforderlich Die in ECID zu konvertierende FPID-Zeichenfolge.
fpid_to_ecid(STRING)
fpid_to_ecid("4ed70bee-b654-420a-a3fd-b58b6b65e991")
"28880788470263023831040523038280731744"

Benutzeragenten-Funktionen user-agent

Jede der in der folgenden Tabelle enthaltenen Benutzeragenten-Funktionen kann einen der folgenden Werte zurückgeben:

  • Telefon - Ein Mobilgerät mit kleinem Bildschirm (allgemein < 7")
  • Mobile : Ein Mobilgerät, das noch nicht identifiziert wurde. Bei diesem Mobilgerät kann es sich um einen eReader, ein Tablet, ein Telefon, eine Uhr usw. handeln.

Weitere Informationen zu Gerätefeldwerten finden Sie im Abschnitt Liste der Gerätefeldwerte im Anhang dieses Dokuments.

NOTE
Bitte scrollen Sie nach links/rechts, um den gesamten Tabelleninhalt anzuzeigen.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
ua_os_name
Extrahiert den Betriebssystemnamen aus der Benutzeragenten-Zeichenfolge.
  • USER_AGENT: Erforderlich Die Benutzeragenten-Zeichenfolge.
ua_os_name ​(USER_AGENT)
ua_os_name ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 wie Mac OS X) AppleWebKit/534.46 (KHTML, wie Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS
ua_os_version_major
Extrahiert die Hauptversion des Betriebssystems aus der Zeichenfolge des Benutzeragenten.
  • USER_AGENT: Erforderlich Die Benutzeragenten-Zeichenfolge.
ua_os_version_major ​(USER_AGENT)
ua_os_version_major ​ s("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 wie Mac OS X) AppleWebKit/534.46 (KHTML, wie Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
IOS 5
ua_os_version
Extrahiert die Betriebssystemversion aus der Zeichenfolge des Benutzeragenten.
  • USER_AGENT: Erforderlich Die Benutzeragenten-Zeichenfolge.
ua_os_version ​(USER_AGENT)
ua_os_version ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 wie Mac OS X) AppleWebKit/534.46 (KHTML, wie Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
5.1.1
ua_os_name_version
Extrahiert den Namen und die Version des Betriebssystems aus der Zeichenfolge des Benutzeragenten.
  • USER_AGENT: Erforderlich Die Benutzeragenten-Zeichenfolge.
ua_os_name_version ​(USER_AGENT)
ua_os_name_version ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 wie Mac OS X) AppleWebKit/534.46 (KHTML, wie Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
iOS 5.1.1
ua_agent_version
Extrahiert die Agentenversion aus der Benutzeragenten-Zeichenfolge.
  • USER_AGENT: Erforderlich Die Benutzeragenten-Zeichenfolge.
ua_agent_version ​(USER_AGENT)
ua_agent_version ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 wie Mac OS X) AppleWebKit/534.46 (KHTML, wie Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
5,1
ua_agent_version_major
Extrahiert den Namen des Agenten und die Hauptversion aus der Zeichenfolge des Benutzeragenten.
  • USER_AGENT: Erforderlich Die Benutzeragenten-Zeichenfolge.
ua_agent_version_major ​(USER_AGENT)
ua_agent_version_major ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 wie Mac OS X) AppleWebKit/534.46 (KHTML, wie Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Safari 5
ua_agent_name
Extrahiert den Agentennamen aus der Benutzeragenten-Zeichenfolge.
  • USER_AGENT: Erforderlich Die Benutzeragenten-Zeichenfolge.
ua_agent_name ​(USER_AGENT)
ua_agent_name ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 wie Mac OS X) AppleWebKit/534.46 (KHTML, wie Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Safari
ua_device_class
Extrahiert die Geräteklasse aus der Benutzeragenten-Zeichenfolge.
  • USER_AGENT: Erforderlich Die Benutzeragenten-Zeichenfolge.
ua_device_class ​(USER_AGENT)
ua_device_class ​("Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 wie Mac OS X) AppleWebKit/534.46 (KHTML, wie Gecko) Version/5.1 Mobile/9B206 Safari/7534.48.3")
Telefon

Analytics-Funktionen analytics

NOTE
Sie dürfen nur die folgenden Analysefunktionen für WebSDK- und Adobe Analytics-Datenflüsse verwenden.
Funktion
Beschreibung
Parameter
Aufbau
Ausdruck
Beispielausgabe
aa_get_event_id
Extrahiert die Ereignis-ID aus einer Analytics-Ereignis-Zeichenfolge.
  • EVENT_STRING: Erforderlich Die kommagetrennte Analytics-Ereigniszeichenfolge.
  • EVENT_NAME: Erforderlich Der Ereignisname, aus dem extrahiert und die ID abgerufen werden soll.
aa_get_event_id(EVENT_STRING, EVENT_NAME)
aa_get_event_id("event101=5:123456,scOpen", "event101")
123456
aa_get_event_value
Extrahiert den Ereigniswert aus einer Analytics-Ereigniszeichenfolge. Wenn der Ereigniswert nicht angegeben ist, wird 1 zurückgegeben.
  • EVENT_STRING: Erforderlich Die kommagetrennte Analytics-Ereigniszeichenfolge.
  • EVENT_NAME: Erforderlich Der Ereignisname, aus dem ein Wert extrahiert werden soll.
aa_get_event_value(EVENT_STRING, EVENT_NAME)
aa_get_event_value("event101=5:123456,scOpen", "event101")
5
aa_get_product_categories
Extrahiert die Produktkategorie aus einer Analytics-Produktzeichenfolge.
  • PRODUCTS_STRING: Erforderlich Die Analytics-Produktzeichenfolge.
aa_get_product_categories(PRODUCTS_STRING)
aa_get_product_categories(";Beispielprodukt 1;1;3.50,Beispielkategorie 2;Beispielprodukt 2;1;5.99")
[null,"Beispielkategorie 2"]
aa_get_product_names
Extrahiert den Produktnamen aus einer Analytics-Produktzeichenfolge.
  • PRODUCTS_STRING: Erforderlich Die Analytics-Produktzeichenfolge.
aa_get_product_names(PRODUCTS_STRING)
aa_get_product_names(";Beispielprodukt 1;1;3.50,Beispielkategorie 2;Beispielprodukt 2;1;5.99")
["Beispiel Produkt 1","Beispiel Produkt 2"]
aa_get_product_quantity
Extrahiert die Mengen aus einer Analytics-Produktzeichenfolge.
  • PRODUCTS_STRING: Erforderlich Die Analytics-Produktzeichenfolge.
aa_get_product_quantity(PRODUCTS_STRING)
aa_get_product_quantity(";Beispielprodukt 1;1;3.50,Beispielkategorie 2;Beispielprodukt 2")
["1", null]
aa_get_product_price
Extrahiert den Preis aus einer Analytics-Produktzeichenfolge.
  • PRODUCTS_STRING: Erforderlich Die Analytics-Produktzeichenfolge.
aa_get_product_price(PRODUCTS_STRING)
aa_get_product_price(";Beispiel für Produkt 1;1;3.50,Beispielkategorie 2;Beispielprodukt 2")
["3.50", null]
aa_get_product_event_values
Extrahiert Werte für das benannte Ereignis aus der Produktzeichenfolge als Zeichenfolgen-Array.
  • PRODUCTS_STRING: Erforderlich Die Analytics-Produktzeichenfolge.
  • EVENT_NAME: Erforderlich Der Ereignisname, aus dem Werte extrahiert werden sollen.
aa_get_product_event_values(PRODUCTS_STRING, EVENT_NAME)
aa_get_product_event_values(";Beispielprodukt 1;1;4.20;event1=2.3|event2=5:1,;Beispielprodukt 2;1;4.20;event1=3|event2=2:2", "event1")
["2.3", "3"]
aa_get_product_evars
Extrahiert die eVar-Werte für das benannte Ereignis aus der Produktzeichenfolge als Zeichenfolgen-Array.
  • PRODUCTS_STRING: Erforderlich Die Analytics-Produktzeichenfolge.
  • EVAR_NAME: Erforderlich Der zu extrahierende eVar.
aa_get_product_evars(PRODUCTS_STRING, EVENT_NAME)
aa_get_product_evars(";Beispielprodukt;1;6.69;;eVar1=Merchandising-Wert", "eVar1")
["Merchandising-Wert"]

Objektkopie object-copy

TIP
Die Funktion zum Kopieren von Objekten wird automatisch angewendet, wenn ein Objekt in der Quelle einem Objekt in XDM zugeordnet wird. Benutzer müssen keine weiteren Aktionen durchführen.

Sie können die Funktion zum Kopieren von Objekten verwenden, um Attribute eines Objekts automatisch zu kopieren, ohne Änderungen an der Zuordnung vorzunehmen. Wenn Ihre Quelldaten beispielsweise folgende Struktur aufweisen:

address{
        line1: 4191 Ridgebrook Way,
        city: San Jose,
        state: California
        }

und eine XDM-Struktur von:

addr{
    addrLine1: 4191 Ridgebrook Way,
    city: San Jose,
    state: California
    }

Anschließend wird die Zuordnung zu:

address -> addr
address.line1 -> addr.addrLine1

Im obigen Beispiel wird die Variable city und state -Attribute werden auch automatisch zur Laufzeit erfasst, da die address -Objekt wird zugeordnet zu addr. Wenn Sie eine line2 -Attribut in der XDM-Struktur verwenden, und Ihre Eingabedaten enthalten auch eine line2 im address -Objekt, wird es auch automatisch erfasst, ohne dass die Zuordnung manuell geändert werden muss.

Um sicherzustellen, dass die automatische Zuordnung funktioniert, müssen die folgenden Voraussetzungen erfüllt sein:

  • Übergeordnete Objekte sollten zugeordnet werden;
  • Neue Attribute müssen im XDM-Schema erstellt worden sein.
  • Neue Attribute sollten über übereinstimmende Namen im Quellschema und im XDM-Schema verfügen.

Wenn eine der Voraussetzungen nicht erfüllt ist, müssen Sie das Quellschema mithilfe von data prep manuell dem XDM-Schema zuordnen.

Anhang

Im Folgenden finden Sie weitere Informationen zur Verwendung der Zuordnungsfunktionen für die Datenvorbereitung

Sonderzeichen special-characters

Die nachstehende Tabelle enthält eine Liste der reservierten Zeichen und der zugehörigen kodierten Zeichen.

Reserviertes Zeichen
Kodiertes Zeichen
space
%20
!
%21
“
%22
#
%23
$
%24
%
%25
&
%26
'
%27
(
%28
)
%29
*
%2A
+
%2B
,
%2C
/
%2F
:
%3A
%3B
<
%3C
=
%3D
>
%3E
?
%3F
@
%40
[
%5B
]
%5D
^
%5E
`
%60
~
%7E

Gerätefeldwerte device-field-values

Die nachstehende Tabelle enthält eine Liste der Gerätefeldwerte und der zugehörigen Beschreibungen.

Gerät
Beschreibung
Desktop
Ein Desktop- oder Laptop-Gerät.
Anonymisiert
Ein anonymes Gerät. In einigen Fällen sind dies useragents die von einer Anonymisierungssoftware geändert wurden.
Unbekannt
Ein unbekanntes Gerät. Diese sind normalerweise useragents die keine Informationen über das Gerät enthalten.
Mobile
Ein Mobilgerät, das noch nicht identifiziert wurde. Bei diesem Mobilgerät kann es sich um einen eReader, ein Tablet, ein Telefon, eine Uhr usw. handeln.
Tablet
Ein Mobilgerät mit einem großen Bildschirm (normalerweise > 7").
Telefon
Ein Mobilgerät mit kleinem Bildschirm (normalerweise < 7").
Watch
Ein Mobilgerät mit einem winzigen Bildschirm (normalerweise < 2"). Diese Geräte dienen normalerweise als zusätzlicher Bildschirm für Geräte vom Typ Telefon/Tablet.
Erweiterte Realität
Ein Mobilgerät mit AR-Funktionen.
Virtuelle Realität
Ein Mobilgerät mit VR-Funktionen.
eReader
Gerät, das einem Tablet ähnelt, in der Regel jedoch mit einem eInk angezeigt.
Set-Top-Box
Ein angeschlossenes Gerät, das die Interaktion über einen TV-Bildschirm ermöglicht.
TV
Ein Gerät, das der Set-Top-Box ähnelt, aber in den Fernseher integriert ist.
Hauseinheit
Ein (normalerweise großes) Haushaltsgerät, wie ein Kühlschrank.
Spielekonsole
Ein festes Spielsystem wie Playstation oder XBox.
Handheld Game Console
Ein mobiles Gaming-System wie ein Nintendo Switch.
Stimme
Ein stimmgesteuertes Gerät wie ein Amazon Alexa oder Google Home.
Auto
Ein fahrzeugbasierter Browser.
Robot
Roboter, die eine Website besuchen.
Robot Mobile
Roboter, die eine Website besuchen, aber angeben, dass sie als mobiler Besucher angesehen werden sollen.
Robot Imitator
Roboter, die eine Website besuchen, tun so, als wären Roboter wie Google, aber nicht. Hinweis: In den meisten Fällen sind Roboterimmitatoren tatsächlich Roboter.
Cloud
Eine Cloud-basierte Anwendung. Das sind weder Roboter noch Hacker, aber es sind Anwendungen, die eine Verbindung herstellen müssen. Dazu gehören Mastodon Server.
Hacker
Dieser Gerätewert wird verwendet, falls Skripterstellung im useragent Zeichenfolge.

Code-Beispiele code-samples

map_get_values map-get-values

Auswählen zum Anzeigen des Beispiels
code language-json 
 example = "map_get_values(book_details,\"author\") where input is : {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}",
      result = "{\"author\": \"George R. R. Martin\"}"

map_has_keys map_has_keys

Auswählen zum Anzeigen des Beispiels
code language-json 
 example = "map_has_keys(book_details,\"author\")where input is : {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}",
      result = "true"

add_to_map add_to_map

Auswählen zum Anzeigen des Beispiels
code language-json 
example = "add_to_map(book_details, book_details2) where input is {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}" +
        "{\n" +
        "    \"book_details2\":\n" +
        "    {\n" +
        "        \"author\": \"Neil Gaiman\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-0-380-97365-0\"\n" +
        "        \"publisher\": \"William Morrow\"\n" +
        "    }\n" +
        "}",
      result = "{\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "        \"publisher\": \"William Morrow\"\n" +
        "    }\n" +
        "}",
      returns = "A new map with all elements from map and addends"

object_to_map object_to_map

Syntax 1

Auswählen zum Anzeigen des Beispiels
code language-json 
example = "object_to_map(\"firstName\", \"John\", \"lastName\", \"Doe\")",
result = "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

Syntax 2

Auswählen zum Anzeigen des Beispiels
code language-json 
example = "object_to_map(address) where input is " +
  "address: {line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}",
result = "{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"

Syntax 3

Auswählen zum Anzeigen des Beispiels
code language-json 
example = "object_to_map(addresses,type)" +
        "\n" +
        "[\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City\": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"home\"\n" +
        "    },\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"work\"\n" +
        "    },\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"office\"\n" +
        "    }\n" +
        "]" ,
result = "{\n" +
        "    \"home\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City\": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"home\"\n" +
        "    },\n" +
        "    \"work\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"work\"\n" +
        "    },\n" +
        "    \"office\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"office\"\n" +
        "    }\n" +
        "}"

array_to_map array_to_map

Auswählen zum Anzeigen des Beispiels
code language-json 
example = "array_to_map(addresses, \"type\") where addresses is\n" +
  "\n" +
  "[\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City\": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"home\"\n" +
  "    },\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"work\"\n" +
  "    },\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"office\"\n" +
  "    }\n" +
  "]" ,
result = "{\n" +
  "    \"home\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City\": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"home\"\n" +
  "    },\n" +
  "    \"work\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"work\"\n" +
  "    },\n" +
  "    \"office\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"office\"\n" +
  "    }\n" +
  "}",
returns = "Returns a map with given field name and value pairs or null if input is null"
recommendation-more-help
461cc884-c234-4a0c-ac75-6efbaafc1394