Daten transformieren (Konnektoren)

Informationen zur Transformation von Daten in Discover

Sie können Ihre eingehenden Daten transformieren, bevor sie in XM Discover importiert werden. Dies ist nützlich, wenn Sie Ihre Daten bereinigen oder das Format Ihrer Daten ändern müssen.

So greifen Sie auf Datentransformationen zu:

1. Klicken Sie beim Einrichten des Importjobs auf das Zahnradsymbol in der Spalte Transformationen neben dem Datenfeld, das Sie transformieren möchten.
   
   Tipp: Wenn Sie Datentransformationen für einen vorhandenen Auftrag aktualisieren möchten, wählen Sie Datenzuordnung aus dem Optionsmenü für Jobs aus.
   Achtung: Wenn neben dem Zahnradsymbol eine Zahl angezeigt wird, bedeutet dies, dass bereits eine Transformation auf das Feld angewendet wurde. Wenn Sie eine neue Transformation hinzufügen, ersetzt diese die alte.
2. Wählen Sie Ihre Datentransformation aus. Weitere Informationen zu den einzelnen Transformationen finden Sie in den verlinkten Abschnitten.
   
   • Keine Transformation: Transformieren Sie das importierte Feld nicht.
   • Dynamischer Lookup: Diese Option ist nur für Lookup-Felder verfügbar. Wenn diese Option ausgewählt ist, wendet dieses Feld die neuesten Lookup-Werte für das Feld aus der Lookup-Tabelle an.
   • Wert aus Lookup-Tabelle ersetzen: Definieren Sie Paare von Quellwerten und Ersatzwerten.
   • Wert durch RegEx ersetzen: Definieren Sie reguläre Ausdrücke (reguläre Ausdrücke) für Musterübereinstimmungen und Ersetzungswerte.
   • Benutzerdefinierte Transformation: Erstellen Sie Ihre eigene Transformation mit verschiedenen Funktionen und Ausdrücken.

Dynamischer Lookup

Diese Option ist nur für Datenfelder verfügbar, die eine Lookup-Tabelle aus der verbundenen Datenquelle referenzieren. Sie können einen dynamischen Lookup-Ausdruck angeben, damit die korrekten Daten in XM Discover importiert werden.

Wert aus Lookup-Tabelle ersetzen

Sie können jedem Quellfeld Lookups hinzufügen, um mehr Kontrolle über die genauen Werte zu haben, die an Ihr XM-Discover-Projekt gesendet werden. Mit einer Suchtabelle können Sie Quellwerte definieren, die beim Speichern in XM Discover ersetzt werden sollen.

1. Stellen Sie sicher, dass Wert aus Lookup-Tabelle ersetzen als Transformation ausgewählt ist.
   
2. Klicken Sie auf Suche exportieren, um eine Lookup-Datei im XLSX-Format zu exportieren.
   Tipp: Wir empfehlen, Lookups über eine Lookup-Datei hinzuzufügen. Wenn Sie Lookups manuell hinzufügen möchten, fahren Sie mit Schritt 8 fort.
3. Öffnen Sie Ihre Datei in einem Tabellenkalkulationseditor, und beginnen Sie mit dem Hinzufügen Ihrer Lookup-Werte zur Datei.
4. Fügen Sie in der Übereinstimmungsspalte die eingehenden Werte aus Ihrem Datenkonnektor hinzu.
   
5. Fügen Sie in der Spalte Umgeschlüsselt die entsprechenden Werte hinzu, die Sie in XM Discover sichern möchten.
6. Sichern Sie Ihre Datei als XLS- oder XLSX-Datei.
7. Klicken Sie in XM Discover auf Lookup importieren, und wählen Sie die auf Ihrem Computer gespeicherte Lookup-Datei aus.
   
8. Bei Bedarf können Sie Ihre Lookups bearbeiten. Die Spalte Quellwert enthält den Wert aus Ihrem Datenkonnektor, während die Spalte Transformierter Wert den Wert enthält, den Sie in XM Discover speichern möchten.
9. Sie können zusätzliche Lookup-Paarungen hinzufügen, indem Sie auf das Pluszeichen (+) klicken, oder Sie können Paarungen entfernen, indem Sie auf das Minuszeichen (–) neben dem Pairing klicken.
10. Klicken Sie auf Speichern.

Wert durch RegEx ersetzen

Sie können eingehende Datenwerte mithilfe regulärer Ausdrücke oder regex ersetzen, sodass Sie Daten vor dem Laden in Ihr XM-Discover-Projekt bereinigen können.

1. Stellen Sie sicher, dass Wert durch RegEx ersetzen als Transformation ausgewählt ist.
   
2. Geben Sie den Regex für das Suchmuster im Feld Regulären Ausdruck für Musterübereinstimmung eingeben an.
3. Geben Sie die Ersetzungszeichenfolge regex im Feld Regulären Ausdruck für Ersatzwert eingeben an.
4. Um die Transformation zu testen, geben Sie ein Beispiel aus Ihrem Datenset in das Feld Beispielquellwert ein, und klicken Sie auf Testen. Das Ergebnis der Transformation wird im Feld Beispiel transformierter Wert angezeigt.
5. Klicken Sie auf Speichern.

Benutzerdefinierte Transformation

Sie können eingehende Daten mit Ihren eigenen benutzerdefinierten Ausdrücken transformieren. Benutzerdefinierte Transformationen ermöglichen viele Arten der Datenbearbeitung, darunter das Ändern von Datumsformaten, das Verknüpfen von Feldern, das Entfernen führender Nullen usw.

1. Stellen Sie sicher, dass Benutzerdefinierte Transformation als Datentransformation ausgewählt ist.
   
2. Erstellen Sie Ihren Datentransformationsausdruck. Ihr Ausdruck hängt von Ihren eingehenden Daten und der gewünschten Ausgabe ab. Weitere Informationen zum Erstellen von Ausdrücken finden Sie auf der folgenden Supportseite: Erstellen von Ausdrücken.
3. Wenn Sie ein neues Feld anlegen, können Sie den Datentyp des Felds ändern. Wenn Sie ein vorhandenes Feld transformieren, können Sie den Datentyp nicht ändern.
4. Um Ihre Transformation zu testen, geben Sie einen Testdatenwert in das Feld Testwert ein, und klicken Sie dann auf Testen. Das Ergebnis wird neben der Schaltfläche „Testen“ angezeigt.
5. Wenn Sie mit dem Erstellen und Testen Ihres Ausdrucks fertig sind, klicken Sie auf Speichern.

Natürliche IDs automatisch generieren

Wenn Sie Daten in XM Discover hochladen, enthalten die Dokumente möglicherweise keine eindeutige ID, die Sie als natürliche ID verwenden können. Dies ist ein wichtiges Feld, da es Ihnen hilft, doppelte Dokumente zu identifizieren. Ihre hochgeladenen Daten müssen eine eindeutige ID haben, die als natürliche ID verwendet werden kann. In diesem Abschnitt wird erläutert, wie Sie eine natürliche ID festlegen, wenn Sie Daten mithilfe benutzerdefinierter Transformationen zuordnen.

1. Klicken Sie beim Zuordnen von Daten im Abschnitt Quellzuordnung auf das Pluszeichen (+), um ein neues benutzerdefiniertes Feld hinzuzufügen.
   
2. Geben Sie die folgenden Informationen für das benutzerdefinierte Feld an:
   • Feldname: Geben Sie den Namen für das Feld ein.
   • Datentyp: Wählen Sie Textattribut aus dem Dropdown-Menü aus.
   • Attributname: Lassen Sie es unverändert mit „Feldname“.
   • Attribut Anzeigename: Geben Sie bei Bedarf einen benutzerfreundlicheren Anzeigenamen für das Feld ein.
   • Meldepflichtig: Markieren Sie dieses Ankreuzfeld. Diese muss ausgewählt werden, damit Sie die natürliche ID im Reporting verwenden können.
3. Wählen Sie im Abschnitt Standardquellzuordnung das Attribut aus, das Sie in Schritt 2 für die Zuordnung der natürlichen ID angelegt haben.
   
4. Klicken Sie in der Spalte Transformationen auf das Zahnradsymbol.
5. Wählen Sie Benutzerdefinierte Transformation.
   
6. Suchen Sie nach der Funktion GENERATE_ID(), und ziehen Sie sie aus dem Abschnitt Funktionen in das Feld Ausdruck.
7. Klicken Sie auf Speichern.
   Tipp: Stellen Sie sicher, dass Sie auf Anwenden klicken, um Ihre Zuordnungen zu speichern.

Nun hat Ihr Dokument eine zufällig generierte ID, wenn es hochgeladen wird.

Festlegen eines bestimmten Belegdatums

Wenn Sie Daten in XM Discover hochladen, können die Dokumente mehrere oder gar keine Datumsfelder enthalten. Ihre hochgeladenen Daten müssen über ein Datumsfeld verfügen, das als Belegdatum verwendet werden kann. In diesem Abschnitt wird erläutert, wie Sie ein Belegdatum festlegen, wenn Sie Daten mithilfe benutzerdefinierter Transformationen zuordnen.

1. Klicken Sie beim Zuordnen von Daten im Abschnitt Quellzuordnung auf das Pluszeichen (+), um ein neues benutzerdefiniertes Feld hinzuzufügen.
   
2. Geben Sie die folgenden Informationen für das benutzerdefinierte Feld an:
   • Feldname: Geben Sie den Namen für das Feld an (z.B. custom_date).
   • Datentyp: Wählen Sie Datumsattribut aus dem Dropdown-Menü aus.
   • Attributname: Belassen Sie ihn wie „Feldname“ (z.B. custom_date).
   • Anzeigename des Attributs: Fügen Sie bei Bedarf einen benutzerfreundlicheren Anzeigenamen für das Feld hinzu.
   • Meldepflichtig: Markieren Sie dieses Ankreuzfeld. Diese muss ausgewählt werden, um das Datum zu dokumentieren, das im Discover-Reporting verwendet wird.
3. Wählen Sie im Abschnitt Standardquellzuordnung das Attribut aus, das Sie in Schritt 2 für die Belegdatumszuordnung angelegt haben.
   
4. Klicken Sie in der Spalte Transformationen auf das Zahnradsymbol.
5. Wählen Sie Benutzerdefinierte Transformation.
   
6. Im Expression Builder haben Sie mehrere Möglichkeiten, ein Datum Ihren Anforderungen entsprechend festzulegen:
   • Ladezeit verwenden: Um das Datum zu verwenden, an dem die Dokumente in XM Discover hochgeladen werden, ziehen Sie die Funktion NOW() aus dem Abschnitt Funktionen in das Feld Ausdruck.
     
   • Verwenden Sie einen fest programmierten Wert: Um ein bestimmtes Datum zu verwenden, ziehen Sie die Funktion TEXTTODATE() aus dem Abschnitt Funktionen in das Feld Ausdruck, und geben Sie das Datum und das Datumsformat in der Klammer an.
     
     Tipp: In beiden Fällen verwendet das resultierende Datum das Format JJJJ-MM-TTThh:mm:ssZ.
7. Klicken Sie auf Testen, um das Ergebnis der Transformation anzuzeigen. Passen Sie bei Bedarf Ihren Ausdruck an, bis der Test das gewünschte Ergebnis liefert.
8. Klicken Sie auf Speichern, wenn Sie fertig sind.

Beispiele für benutzerdefinierte Transformationen

In diesem Abschnitt finden Sie einige Beispiele dafür, wie Sie Ihre Daten mit benutzerdefinierten Transformationen bearbeiten können.

Benutzerdefinierten Quellwert zuordnen

Ziel: Weisen Sie dem Attribut „Quelle“ einen benutzerdefinierten Textwert („April-Umfragen“) zu.

Wie: Wenden Sie die folgende Transformation auf das Feld „Quelle“ an (geben Sie den Textwert einfach in Anführungszeichen ein):

Ändern Sie “Nachname, Vorname” in “Vorname Nachname”.

Ziel: Ändern Sie das Namensformat von “Nachname, Vorname” in “Vorname Nachname”, und schreiben Sie den ersten Buchstaben jedes Wortes in Großbuchstaben.

Wie: Wenden Sie die folgende Transformation auf das Namensfeld an:

PROPERCASE(REPLACEBYREGEXP(NAME, “(.*),(.*)”, “$2 $1”))

Konvertieren eines Datums von UTC nach CST

Ziel: Konvertieren Sie ein Datumsfeld von einer UTC-Zeitzone in CST.

Wie: Wenden Sie die folgende Transformation auf das END_DATE-Feld an:

CONVERT_TO_TIMEZONE(END_DATE, “Etc/UTC”, “America/Chicago”)

Konvertieren Sie hh:mm:ss in Minuten

Ziel: Konvertieren Sie die Zeit vom Format hh:mm:ss in die Anzahl der Minuten.

Wie: Wenden Sie die folgende Transformation an:

GETMINUTESBETWEEN(TEXTTODATE(“1970-01-01”, “YYYY-MM-DD”), CONCAT(“1970-01-01T”, MY_TIME))

Unix-Epochenzeit in Sekunden nach ISO 8601 konvertieren

Ziel: Konvertieren Sie einen Unix-Epochenzeitstempel in Sekunden in das Datumsformat ISO 8601.

Wie: Die folgende Transformation macht zwei Dinge: Sie wandelt Sekunden in Millisekunden um und wandelt dann die Millisekunden in ein ISO-8601-Datum um:

NUMBERTODATE(TEXTTONUMBER(CONCAT(MY_DATE, “000”)))

Wert ableiten basierend darauf, ob etwas in einem Array enthalten ist

Ziel: Prüfen Sie den Namen des Bundesstaats, und weisen Sie einen “DMV-Bereich”-Wert zu, wenn er mit einem der aufgelisteten Zustände übereinstimmt. Andernfalls setzen Sie den Parameter auf “Sonstige Status”.

How: Fügen Sie ein benutzerdefiniertes Textfeld namens AREA hinzu, und wenden Sie die folgende Transformation an:

IF(LOWER(STATE) in [“md”, “dc”, “va”], “DMV Area”, “Other States”)

Artikelname aus einem Seitentitel extrahieren

Ziel: Extrahieren Sie den Namen des Artikels nach dem letzten Teiler “|” in einem Seitentitel.

Wie: Wenden Sie die folgende Transformation auf das Seitentitelfeld an:

TRIMRIGHT(MID(PAGE_TITLE,FINDLAST(PAGE_TITLE,”|”)+1,1000))

Vor- und Nachname in einem einzelnen Feld verknüpfen

Ziel: Kombinieren Sie die Felder FIRST_NAME und LAST_NAME in einem neuen Feld FULL_NAME, und schreiben Sie den ersten Buchstaben jedes Wortes in Großbuchstaben.

How: Fügen Sie ein benutzerdefiniertes Textfeld namens FULL_NAME hinzu, und wenden Sie die folgende Transformation an:

PROPERCASE(CONCAT(FIRST_NAME, ” “, LAST_NAME))

Schließen Sie sich zwei Verbaktoren an und laden Sie nur das kombinierte Verbatim

Ziel: Verbinden Sie zwei verbale Felder VERBATIM1 und VERBATIM2 in ein neues VERBATIM3-Feld und laden Sie nur das kombinierte Wort in XM Discover.

Vorgehensweise: Führen Sie diese Schritte aus:

1. Legen Sie ein ausführliches Feld mit dem Namen VERBATIM3 an, und wenden Sie die folgende Transformation darauf an: CONCAT(VERBATIM1, ” “, VERBATIM2)
2. Setzen Sie für die Felder VERBATIM1 und VERBATIM2 den Datentyp auf Nicht zuordnen.

Mehrvariabler Rollup

Ziel: Erstellen Sie einen Rollup mit mehreren Variablen für Antworten auf eine einzelne Frage, die auf mehrere Attribute aufgeteilt sind. Angenommen, das Datenset enthält mehrere “Ja”- oder “Nein”-Attribute, um verschiedene Mitgliedschaftsebenen anzugeben, die ein Kunde haben kann:

• QID2_1 für Silber
• QID2_2 für Gold
• QID2_3 für Platin

Sie können alle “Ja”-Antworten in ein einzelnes neues Attribut übertragen, um die Mitgliedsstufe des Kunden anzugeben.

Wie: Wenden Sie die folgende Transformation an:

TRIMRIGHT(CONCAT(IF(QID2_1==”Yes”, “Silver”, “”), IF(QID2_2==”Yes”, “Gold”, “”), IF(QID2_3==”Yes”, “Platinum”, “”)))

Führendes Zeichen entfernen

Ziel: Entfernen Sie das erste Zeichen in einer Zeichenfolge.

Wie: Wenden Sie die folgende Transformation an:

REPLACEBYINDEX(MY_NUMBER, 1, 1, “”)

Führende Nullen entfernen

Ziel: Führende Nullen in einer Zahl entfernen.

Wie: Wenden Sie für einen Textwert die folgende Transformation an:

CONCAT(TEXTTONUMBER(MY_NUMBER), “”)

Für einen numerischen Wert wenden Sie die folgende Transformation an:

TEXTTONUMBER(MY_NUMBER)