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.
TIPP
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
HINWEIS
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.
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.
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
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.
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.
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.
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.
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.
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.
Zeitstempel()
Zeitstempel()
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.
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.
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.
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("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.
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.
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.
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]
Logische Operatoren
HINWEIS
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.
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
HINWEIS
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
HINWEIS
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
HINWEIS
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.
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.
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.
HINWEIS
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
Objektkopie
TIPP
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
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
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
map_get_values
Auswählen zum Anzeigen des Beispiels
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
Auswählen zum Anzeigen des Beispiels
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
Auswählen zum Anzeigen des Beispiels
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"
