Basistransformationsaufgabe
Informationen zur Basistransformationsaufgabe
Mit der Aufgabe Basistransformation können Sie Ihre Rohdaten in einem kompatiblen, vereinfachten Dokument bearbeiten und validieren. Die Datentransformation kann dabei helfen, Ihre Datensätze automatisch zu vereinheitlichen, um sie in das Format zu exportieren, das Sie an Ihre Partner und Teams senden möchten.
Einrichten einer Basistransformationsaufgabe
- Klicken Sie oben links auf das Navigationsmenü.
- Wählen Sie Workflows.
- Klicken Sie auf Workflow erstellen.
- Klicken Sie auf ETL-Daten extrahieren, transformieren und laden.
- Bei Bedarf können Sie Ihren Workflow umbenennen, indem Sie oben auf den Workflow-Namen klicken.
- Richten Sie Ihre Extraktoraufgabe ein. Diese Aufgabe stellt die Daten bereit, die in diesem Workflow transformiert werden. Anweisungen zum Einrichten von Extraktoraufgaben finden Sie unter ETL-Workflows erstellen.
- Klicken Sie auf Datentransformation.
- Wählen Sie im Menü die Option Basistransformation.
- Wählen Sie die Datenquelle aus der Dropdown-Liste aus.
- Klicken Sie auf Weiter.
- Bearbeiten Sie die Felder aus Ihrer Extraktoraufgabe. Für jedes Feld gibt es vier Hauptelemente:
- Erforderlich: Markieren Sie das Ankreuzfeld neben dem Feld, wenn Daten erforderlich sind. Wenn das Feld markiert ist und keine Daten in diesem Feld vorhanden sind, wird es übersprungen.
- Quellfeld: Alle Felder aus der Datei in der Extraktoraufgabe. Wenn Sie ein neues Feld hinzufügen, wählen Sie über die Dropdown-Liste aus, aus welcher Spalte die Daten abgerufen werden sollen.
- Zielfeldname: Wie die Feldnamen im transformierten Datenset aussehen. Wenn Sie Felder aus der Quelldatei umbenennen möchten, bearbeiten Sie den Namen in dieser Spalte.
- Feldtyp: Wie die extrahierten Daten im transformierten Datenset interpretiert werden. Der Feldtyp bestimmt, welche Transformationsoperationen verfügbar sind.
- Klicken Sie auf das Menü mit den drei Punkten auf der rechten Seite, um Ihre Daten zu transformieren, Validierungsregeln hinzuzufügen, Bedingungsfelder hinzuzufügen oder dieses Feld aus dem Datenset zu löschen. Weitere Informationen zu diesen Optionen finden Sie in den nachfolgenden Abschnitten.
- Wenn Sie dem Datenset ein zusätzliches Feld hinzufügen möchten, klicken Sie auf Feld hinzufügen.
- Überprüfen Sie alle Ihre Transformationen auf der Registerkarte Angewendete Transformationen. Um weitere Informationen zu jeder Transformation zu erhalten, klicken Sie auf eine Transformation. Klicken Sie auf das Drei-Punkt-Menü, um es zu bearbeiten oder zu löschen.
Tipp: Die Vorgänge werden in der Reihenfolge ausgeführt, in der sie auf der Registerkarte Angewendete Transformationen angezeigt werden. Dabei handelt es sich um die Reihenfolge, in der sie konfiguriert sind. Wenn mehrere Vorgänge für dasselbe Feld eingerichtet sind, werden nachfolgende Vorgänge anhand der Ergebnisse vorheriger Vorgänge berechnet. - Überprüfen Sie alle Ihre Validierungsregeln auf dem Tab Validierungsregeln. Um weitere Informationen zu jeder Validierungsregel zu erhalten, klicken Sie auf eine Validierungsregel. Klicken Sie auf das Drei-Punkt-Menü, um es zu bearbeiten oder zu löschen.
- Klicken Sie auf Weiter.
- Überprüfen Sie die Zusammenfassung Ihrer Transformationen und Validierungen. Klicken Sie auf Speichern, wenn Sie fertig sind.
Datentransformation
Die für Ihr Feld verfügbaren Transformationsvorgänge hängen vom Zielfeldtyp ab.
Die folgenden Transformationen sind für Textwert-, Textset- und Freitextfelder verfügbar:
- Verketten: Kombinieren Sie Werte aus mehreren Feldern.
- Split: Teilen Sie das ursprüngliche Feld in mehrere Felder auf, die durch ein Trennzeichen getrennt sind.
- Präfix hinzufügen: Fügen Sie vor jedem Wert Text hinzu.
- Fügen Sie das Suffix hinzu. Fügen Sie Text am Ende jedes Werts hinzu.
- Formatfall: Wenden Sie ein Fallformat an (z. GROSSBUCHSTABEN) auf alle Werte im Feld.
- Wert ersetzen: Suchen und ersetzen Sie Werte im Feld.
- Wert kürzen: Löschen Sie Leerzeichen am Ende des Textes im Feld.
- Nach Anzahl der Zeichen aufteilen: Teilen Sie den Text in zwei Felder auf, indem Sie die Anzahl der Zeichen vom Anfang oder Ende angeben.
Die folgenden Transformationen sind für Zahlenwert- und Nummernsetfelder verfügbar:
- Additionstransformation: Fügen Sie jeder Zahl im Feld einen Wert hinzu oder fügen Sie zwei Felder zusammen hinzu.
- Subtraktionstransformation: Subtrahieren Sie einen Wert von jeder Zahl im Feld oder ziehen Sie ein Feld von einem anderen ab.
- Multiplikationstransformation: Multiplizieren Sie einen Wert auf jede Zahl im Feld oder multiplizieren Sie zwei Felder zusammen.
- Divisionstransformation: Teilen Sie jede Zahl im Feld durch einen Wert oder teilen Sie ein Feld von einem anderen.
- Transformation der ganzzahligen Division: Dividieren Sie jede Zahl im Feld durch einen Wert oder teilen Sie ein Feld von einem anderen. Gibt nur die ganze Zahl (Ganzzahl) zurück.
- Absoluter Wert: Rufen Sie den absoluten Wert jedes Werts im Feld ab.
- Wert runden: Alle Werte im Feld auf- oder abrunden.
- Durchschnitt der Werte: Verwenden Sie den Durchschnitt der Werte in ausgewählten Feldern für jede Antwort.
- Median der Werte: Verwenden Sie den Median der Werte in ausgewählten Feldern für jede Antwort.
- Summe der Werte: Verwenden Sie die Summe der Werte in den ausgewählten Feldern für jede Antwort.
- Minimum der Werte: Verwenden Sie das Minimum der Werte in ausgewählten Feldern für jede Antwort.
- Maximum von Werten: Verwenden Sie den Höchstwert der Werte in ausgewählten Feldern für jede Antwort.
Für Datumsfelder stehen folgende Transformationen zur Verfügung:
- Datumsberechnung: Gibt an, wie viel Zeit zwischen dem aktuellen Quelldatum und einem anderen Datum vergangen ist.
- Datums-/Zeitversatz: Offset-Datum/-zeit mit einem angegebenen Zeitwert. Sie könnten beispielsweise das Datum für 5 Tage nach einer Interaktion angeben.
Wenn Sie ein benutzerdefiniertes Datums-/Zeitformat eingeben, sind dies Ihre Formatierungsoptionen:
- Jahr: jj, jjjj
- Monat: M, MM, MMM, MMMM
- Tag: d, dd
- Tag des Jahres: EDE
- Stunde des halben Tages: K, KK
- Stunde des Tages: HH
- Minute: m, mm
- Zweitens: s, ss
- Sekundenbruchteil: S, SS, SSS
- Zeitzonen-Offset: ZZZZ, ZZ:ZZ (kann +/- enthalten)
- Halber Tag des Tages: a
- Wochentag: E, EE
- Zeitzonenformat: z
Datenvalidierung
Durch das Hinzufügen von Validierungsregeln können Sie Kriterien und Bedingungen anlegen, die sicherstellen, dass die Daten in Ihren Feldern dasselbe Format haben. Sie können beispielsweise Datensätze mit einer ungültigen E-Mail-Adresse entfernen.
- Klicken Sie auf das Menü mit den drei Punkten und dann auf Prüfregel hinzufügen.
- Wählen Sie Nur Datensätze einschließen, die nicht leer sind, wenn Sie die Antwort auslassen möchten, wenn dieses Feld leer ist. Diese Voreinstellung entspricht der Spalte Erforderlich in der Transformationstabelle.
- Wählen Sie Datensatzdatentyp erzwingen aus, einschließlich Datensätze, die auf den angegebenen Typ gecastet werden können, um sie basierend auf dem Format der Daten zu validieren. Für einen Textwert können Sie beispielsweise auswählen, ob diese Daten ein Zahlen- oder Textformat sein sollen.
- Sollte bei Fehler warnen anstatt zu überspringen: Wenn Sie diese Option aktivieren, werden Datensätze berücksichtigt, die die Validierungskriterien im Datenset nicht erfüllen. Im Zeilenbericht wird eine Warnung angezeigt, die darauf hinweist, dass die Antwort diese Regel nicht erfüllt hat. Wenn Sie dieses Kennzeichen nicht setzen, wird der Datensatz übersprungen, sodass er nicht in den neuen Datensatz aufgenommen wird.
- Fügen Sie Validierungsregeln hinzu, wenn Sie möchten. Weitere Informationen finden Sie im folgenden Abschnitt.
- Klicken Sie auf Anwenden.
VALIDIERUNGSREGELN
Sie können Validierungsregeln hinzufügen, um die Daten in Ihrem Feld bedingt zu validieren. Weitere Informationen über Gebäudebedingungen finden Sie unter Grundlagen der Gebäudebedingungen.
- Wählen Sie aus, was mit dem Datensatz bei einem Bedingungsfehler geschehen soll. Sie können den Datensatz entweder überspringen, sodass er nicht im Datensatz enthalten ist, oder ihn mit einer Warnung einschließen.
- Geben Sie an, ob alle oder eine der Regeln wahr sein müssen, um die Bedingung zu validieren.
- Legen Sie Ihre Bedingung mit der Operator-Dropdown-Box und dem Textfeld an. Dadurch wird festgelegt, was der Datensatz in diesem Feld erfüllen muss, damit die Bedingung erfüllt wird.
Tipp: Um eine weitere Bedingung zu erstellen oder eine vorhandene Bedingung zu löschen, klicken Sie auf das Drei-Punkt-Menü auf der rechten Seite. - Fügen Sie bei Bedarf eine weitere Validierungsregel hinzu.
Tipp: Klicken Sie auf den Papierkorb, um eine Validierungsregel zu löschen.
- Klicken Sie auf Anwenden.
Bedingte Felder
Bedingungsfelder werden angelegt, indem Logikbedingungen eingerichtet werden, die andere Felder verwenden, um festzulegen, wie das Feld angelegt wird. Fügen Sie rechts neben den Quellfeldern ein Bedingungsfeld aus dem Menü mit drei Punkten hinzu. Weitere Informationen zu Gebäudebedingungen finden Sie unter Grundlagen der Gebäudebedingungen.
BEDINGUNGSFELD
Ein Bedingungsfeld legt ein neues Feld basierend auf einer einzelnen Logikbedingung an.
- Geben Sie den neuen Feldnamen ein.
- Wählen Sie einen Operator für Ihre Bedingung aus.
- Geben Sie den Wert ein, um festzulegen, wie die Bedingung erfüllt wird.
- Geben Sie ein, was zurückgegeben wird, wenn die in den Schritten 2 und 3 angelegte Regel wahr ist.
- Geben Sie ein, was zurückgegeben wird, wenn die in den Schritten 2 und 3 angelegte Regel falsch ist.
- Wenn Sie fertig sind, klicken Sie auf Anwenden.
ERWEITERTES BEDINGUNGSFELD
Ein erweitertes Bedingungsfeld erstellt ein neues Feld basierend auf mehreren logischen Bedingungen oder Bedingungssätzen.
- Geben Sie den neuen Feldnamen ein.
- Geben Sie an, ob eine oder alle Regeln wahr sein müssen, um die Bedingung zu validieren.
- Legen Sie eine Bedingung an. Weitere Informationen finden Sie oben im Abschnitt Bedingungsfeld.
- Um einen neuen Bedingungssatz anzulegen, klicken Sie auf Verzweigung hinzufügen.
Tipp: Es gibt eine Begrenzung auf 4 Verzweigungen.
- Klicken Sie auf Anwenden, wenn Sie fertig sind.
Transformierte Dateien und Berichte
Die Aufgabe Basistransformation generiert die transformierte Datei zusammen mit zwei Berichten, um Ihnen das Verständnis Ihres transformierten Datensets zu erleichtern. Klicken Sie auf der Registerkarte Ausführungsverlauf Ihres Workflow-Editors auf die Aufgabe Basistransformation innerhalb des Workflow-Laufs, um die Dateien auf der rechten Seite anzuzeigen. Diese Dateien können exportiert werden, indem Sie auf das Download-Symbol auf der rechten Seite klicken.
- Transformationsbericht: Alle Transformationen, die für Datensätze in der Quelldatei ausgeführt wurden, sowie weitere Details wie Name, Zeilennummer, Status, Fehlergrund usw.
- Transformierte Datei: Das Ergebnis der Datentransformation, die das neue Datenset mit allen angewendeten Transformationen und Validierungen enthält.
- Validierungsbericht: Bericht über alle durchgeführten Validierungen, einschließlich des Ausschlusses des Datensatzes und der Validierung, dass er fehlgeschlagen ist.
Fehlerbehebung
- Wenn die von der Basistransformationsaufgabe erzeugte Datei größer als 1 GB ist, schlägt der Workflow fehl.
- Je nachdem, wie Sie Ihre Daten transformieren, kann die Basistransformationsaufgabe Ihrer Datei weitere Daten hinzufügen. Wenn die Datei, die Sie extrahieren, bereits nahe an der Grenze von 1 GB liegt, beachten Sie, dass Ihre Transformationen Ihre Datei zu groß für die Verarbeitung machen können.