Daten transformieren (Connectors)

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 Import-Jobs auf das Zahnradsymbol in der Spalte Transformationen neben dem Datenfeld, das Sie transformieren möchten.
   
   Qtip: Wenn Sie Datentransformationen für einen bestehenden Job aktualisieren möchten, wählen Sie Datenzuordnung im Menü Joboptionen aus.
   Achtung: Wenn neben dem Zahnrad-Symbol eine Zahl angezeigt wird, bedeutet dies, dass auf das Feld bereits eine Transformation angewendet wurde. Wenn Sie eine neue Transformation hinzufügen, wird die alte ersetzt.
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.
   • Dynamische Suche: Diese Option ist nur für Suchfelder verfügbar. Bei Auswahl dieses Felds werden die neuesten Nachschlagwerte für das Feld aus der Suchtabelle angewendet.
   • Wert aus Suchtabelle ersetzen: Definieren Sie Paare aus Quellwerten und Ersatzwerten.
   • Wert durch RegEx ersetzen: Definieren Sie reguläre Ausdrücke (Regex) für Musterübereinstimmungen und Ersetzungswerte.
   • Benutzerdefinierte Transformation: Erstellen Sie Ihre eigene Transformation mit verschiedenen Funktionen und Ausdrücken.

Dynamische Suche

Diese Option ist nur für Datenfelder verfügbar, die auf eine Suchtabelle aus der verbundenen Datenquelle verweisen. Sie können einen dynamischen Suchausdruck angeben, damit die richtigen Daten in XM Discover importiert werden.

Wert aus Suchtabelle ersetzen

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

1. Stellen Sie sicher, dass Wert aus Suchtabelle ersetzen als Ihre Transformation ausgewählt ist.
   
2. Klicken Sie auf Suche exportieren, um eine Suchdatei zu exportieren in . XLSX-Format.
   Qtip: Wir empfehlen, Lookups über eine Suchdatei hinzuzufügen. Wenn Sie Lookups manuell hinzufügen möchten, gehen Sie direkt zu Schritt 8.
3. Öffnen Sie Ihre Datei in einem Tabellen-Editor und fügen Sie Ihre Suchwerte zur Datei hinzu.
4. Fügen Sie in der Spalte Übereinstimmung die eingehenden Werte aus Ihrem Connector hinzu.
   
5. Fügen Sie in der umkodierten Spalte die entsprechenden Werte hinzu, die in XM Discover gespeichert werden sollen.
6. Speichern Sie Ihre Datei als XLS- oder XLSX-Datei.
7. Klicken Sie in XM Discover auf Suchwerte importieren und wählen Sie die auf Ihrem Computer gespeicherte Suchdatei aus.
   
8. Bei Bedarf können Sie Ihre Abfragen 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 sollten.
9. Sie können zusätzliche Suchpaarungen hinzufügen, indem Sie auf das Pluszeichen ( + ) klicken, oder Sie können Paarungen entfernen, indem Sie auf das Minuszeichen ( – ) neben der Paarung klicken.
10. Klicken Sie auf Speichern.

Wert durch RegEx ersetzen

Sie können eingehende Datenwerte mithilfe von regulären Ausdrücken oder Regex ersetzen, sodass Sie Daten bereinigen können, bevor Sie sie in Ihr XM Discover-Projekt laden.

1. Stellen Sie sicher, dass Wert durch RegEx ersetzen als Transformation ausgewählt ist.
   
2. Geben Sie das Suchmuster-Regex im Feld Regulärer Ausdruck für Musterabgleich an.
3. Geben Sie den Ersatzstring-Regex im Feld Regulärer Ausdruck für Ersatzwert an.
4. Um die Transformation zu testen, geben Sie ein Beispiel aus Ihrem Datenset in das Feld Beispiel-Quellwert ein und klicken Sie auf Testen. Das Ergebnis der Transformation wird im Feld Transformierter Beispielwert 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 Datenmanipulation, z. B. die Änderung von Datumsformaten, das Zusammenführen von Feldern, das Entfernen von führenden Nullen usw.

1. Stellen Sie sicher, dass Benutzerdefinierte Transformation als Ihre Datentransformation ausgewählt ist.
   
2. Erstellen Sie Ihren Datentransformationsausdruck. Ihr Ausdruck variiert abhängig von Ihren eingehenden Daten und der gewünschten Ausgabe. Weitere Informationen zum Erstellen von Ausdrücken finden Sie auf der Supportseite zum Erstellen von Ausdrücken.
3. Wenn Sie ein neues Feld erstellen, 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 „Test“ angezeigt.
5. Wenn Sie mit der Erstellung und dem Testen Ihres Ausdrucks fertig sind, klicken Sie auf Speichern.

Automatisch natürliche IDs 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 können, wenn Sie Daten mithilfe von benutzerdefinierten Transformationen zuordnen.

1. Klicken Sie während der Zuordnung 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.
   • Datentyp: Wählen Sie Textattribut aus dem Drop-down-Menü.
   • Attributname: Behalten Sie den gleichen Wert wie „Feldname“.
   • Anzeigename des Attributs: Geben Sie bei Bedarf einen benutzerfreundlicheren Anzeigenamen für das Feld ein.
   • Berichtsfähig: Aktivieren Sie dieses Kontrollkästchen. Diese Option muss ausgewählt sein, damit Sie die natürliche ID in der Berichterstellung verwenden können.
3. Wählen Sie im Abschnitt Standardquellenzuordnung das Attribut aus, das Sie in Schritt 2 für die Natürliche ID-Zuordnung erstellt haben.
   
4. Klicken Sie in der Spalte Transformationen auf das Zahnradsymbol.
5. Klicken Sie auf 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.
   Qtip: Stellen Sie sicher, dass Sie auf Übernehmen klicken, um Ihre Zuordnungen zu speichern.

Ihr Dokument hat jetzt beim Hochladen eine zufällig generierte ID.

Festlegen eines bestimmten Dokumentendatums

Wenn Sie Daten nach XM Discover hochladen, enthalten die Dokumente möglicherweise mehrere Datumsfelder oder gar keine. Ihre hochgeladenen Daten müssen ein Datumsfeld haben, das als Dokumentendatum verwendet werden kann. In diesem Abschnitt wird erläutert, wie Sie ein Dokumentendatum festlegen können, wenn Daten mithilfe von benutzerdefinierten Transformationen zugeordnet werden.

1. Klicken Sie während der Zuordnung 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 Drop-down-Menü.
   • Attributname: Behalten Sie den gleichen Wert wie „Feldname“ (z. B. custom_date).
   • Attribut-Anzeigename: Fügen Sie bei Bedarf einen benutzerfreundlicheren Anzeigenamen für das Feld hinzu.
   • Berichtsfähig: Aktivieren Sie dieses Kontrollkästchen. Diese Option muss ausgewählt sein, damit das Dokumentendatum in der Discover-Berichterstattung verwendet wird.
3. Wählen Sie im Abschnitt Standardquellenzuordnung das Attribut aus, das Sie in Schritt 2 für die Zuordnung zum Dokumentendatum erstellt haben.
   
4. Klicken Sie in der Spalte Transformationen auf das Zahnradsymbol.
5. Klicken Sie auf Benutzerdefinierte Transformation.
   
6. Im Ausdruck-Builder haben Sie verschiedene Möglichkeiten, ein Datum basierend auf Ihren Anforderungen festzulegen:
   • Ladezeit verwenden: Um das Datum zu verwenden, an dem die Dokumente in XM Discover hochgeladen wurden, ziehen Sie die Funktion NOW() aus dem Funktionen-Abschnitt in das Ausdruck-Feld.
     
   • Festkodierten Wert verwenden: Um ein bestimmtes Datum zu verwenden, ziehen Sie die Funktion TEXTTODATE() aus dem Abschnitt „Funktionen“ in das Ausdruck-Feld und geben Sie das Datum und das Datumsformat in der Klammer an.
     
     Qtip: In beiden Fällen verwendet das Ergebnisdatum das Format YYYY-MM-DDThh:mm:ssZ.
7. Klicken Sie auf Test, 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 werden einige Beispiele dafür behandelt, wie Sie Ihre Daten mit benutzerdefinierten Transformationen bearbeiten können.

Einen benutzerdefinierten Quellwert zuweisen

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

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

„Nachname,Vorname“ auf „Vorname Nachname“ ändern

Ziel: Ändern Sie das Namensformat von „Nachname,Vorname“ auf „Vorname Nachname“ und schreiben Sie den ersten Buchstaben jedes Worts groß.

Wenden Sie die folgende Transformation auf das Namensfeld an:

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

Ein Datum von UTC nach CST umwandeln

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”)

hh:mm:ss in Minuten umwandeln

Ziel: Konvertieren Sie die Zeit im 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-Epochzeit in Sekunden nach ISO 8601 umrechnen

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

Wie: Die folgende Transformation führt zwei Schritte aus: Sie wandelt Sekunden in Millisekunden und dann die Millisekunden in ein ISO-8601-Datum um:

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

Wert basierend darauf ableiten, ob sich etwas in einem Array befindet

Ziel: Überprüfen Sie den Namen des Staats und weisen Sie einen Wert für „DMV-Bereich“ zu, wenn er mit einem der aufgeführten Staaten übereinstimmt. Andernfalls legen Sie „Andere Staaten“ fest.

Wie: Fügen Sie ein benutzerdefiniertes Feld namens AREA hinzu und wenden Sie die folgende Transformation an:

IF(LOWER(STATE) in [“md”, “dc”, “va”], „DMV-Bereich“, „Andere Staaten“)

Artikelnamen aus einem Seitentitel extrahieren

Ziel: Extrahieren Sie den Namen des Artikels nach dem letzten Trennzeichen „|“ 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 einzigen Feld zusammenfügen

Ziel: Kombinieren Sie die Felder FIRST_NAME und LAST_NAME in einem neuen FULL_NAME-Feld und schreiben Sie den ersten Buchstaben jedes Worts groß.

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

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

Verbinden Sie zwei Zitate und laden Sie nur das kombinierte Zitat.

Ziel: Fügen Sie zwei Zitatfelder VERBATIM1 und VERBATIM2 in ein neues VERBATIM3-Feld zusammen und laden Sie nur den kombinierten Zitat in XM Discover.

Wie: Führen Sie diese Schritte aus:

1. Erstellen Sie ein Zitat-Feld namens VERBATIM3 und wenden Sie die folgende Transformation auf das Feld an:CONCAT(VERBATIM1, ” “, VERBATIM2)
2. Legen Sie für die Felder VERBATIM1 und VERBATIM2 den Datentyp auf Nicht zuordnen fest.

Multivariables Rollup

Ziel: Erstellen Sie ein multivariables Rollup für Antworten auf eine einzelne Frage, die auf mehrere Attribute aufgeteilt sind. Angenommen, der Datensatz enthält mehrere Ja-oder-Nein-Attribute, die verschiedene Mitgliedschaftsstufen eines Kunden angeben:

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

Sie können alle „Ja“-Antworten in ein einziges neues Attribut umsetzen, um die Mitgliedschaftsstufe des Kunden anzugeben.

Wenden Sie die folgende Transformation an:

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

Anfü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: Entfernen Sie die führenden Nullen in einer Zahl.

Geeignete Vorgehensweise: Für einen Textwert wenden Sie die folgende Transformation an:

CONCAT(TEXTTONUMBER(MY_NUMBER), “”)

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

TEXTTONUMBER(MY_NUMBER)