Datei „Transform.cfg“

Die Datei "data workbenchTransform.cfg"enthält die Parameter, die die Protokollquellen, Datentransformationen und Exporteure definieren.

Die Transformationen, die Sie definieren, manipulieren Rohdaten, die von Sensoren ( .vsl-Dateien) oder in Textdateien, XML-Dateien oder ODBC-kompatiblen Datenbanken erfasst werden, und geben sie entweder in vorhandene Felder aus, überschreiben die aktuellen Daten oder in neu definierte Felder.

Um die Transformationsfunktion zu konfigurieren, bearbeiten Sie die Datei "data workbench Transform.cfg"im Ordner "DataSet"für das Profil, für das Sie Ereignis-Daten exportieren möchten. In der Regel ist dieses Profil der Transformationsfunktion gewidmet (d. h. Sie führen keine andere Datenverarbeitung durch als die in der Datenbasis definierte Datei Transform.cfg). Beachten Sie, dass alle Verarbeitungsanweisungen, die in den Log Processing Dataset Include-Dateien für alle geerbten Profil angegeben sind, zusätzlich zu den in der Datenbasis Transform.cfg-Datei angegebenen angewendet werden.

Weitere Informationen zu Datenaset-Include-Dateien finden Sie unter DataSet Include Files.

Wenn die Daten, die Sie exportieren möchten, von einem Data Workbench-Servercluster verarbeitet werden, verarbeitet jeder der Verarbeitungsserver (DPUs) im Cluster die Daten, aber nur die erste DPU (Verarbeitungsserver #0 in der profile.cfg-Datei) schreibt die Ausgabedaten in sein lokales Dateisystem.

So bearbeiten Sie die Datei "Data Workbench Transform.cfg"

  1. Wenn Sie in dem Profil arbeiten, für das Sie Daten exportieren möchten, öffnen Sie das Profile Manager und klicken Sie auf Dataset, um den Ordnerinhalt anzuzeigen.
  2. Klicken Sie mit der rechten Maustaste auf das Häkchen neben Data Workbench Transform.cfg und klicken Sie dann auf Make Local. In der Spalte User wird ein Häkchen für diese Datei angezeigt.
  3. Klicken Sie mit der rechten Maustaste auf das neu erstellte Häkchen und klicken Sie auf Open > from the workbench. Das Fenster Data Workbench Transform.cfg wird angezeigt.
  4. Bearbeiten Sie die Parameter in der Konfigurationsdatei mithilfe der folgenden Tabelle als Anleitung:
Parameter Beschreibung
Endzeit

Optional. Filtern Sie Daten, um bis zu diesem Zeitpunkt Protokolleinträge mit Zeitstempeln einzuschließen, die jedoch nicht eingeschlossen sind. Adobe empfiehlt die Verwendung eines der folgenden Zeitformate:

  • 1. Januar 2013 HH:MM:SS EDT
  • 1. Januar 2013 HH:MM:SS GMT

Wenn Sie beispielsweise den 29. Juli 2013 um 00:00:00 EDT als Endzeit festlegen, werden Daten bis zum 28. Juli 2013 um 23:59:59 PM EDT erfasst.

Sie müssen eine Zeitzone angeben. Die Zeitzone wird nicht standardmäßig auf GMT gesetzt, wenn sie nicht angegeben ist. Eine Liste der vom Data Workbench-Server unterstützten Zeitzonenabkürzungen finden Sie unter Zeitzonencodes .

Der Parameter Use Beginn/End Times für Sensor- und Protokolldateiquellen bezieht sich auf diesen Parameter.

Ausführer

Die Unterfelder eines Exporteurs geben an, wie die Ausgabedaten verarbeitet und/oder formatiert werden. Sie können mehrere Exporteure für eine Reihe von Protokollquellen definieren. Jeder Exporttyp erstellt die Ausgabe unabhängig voneinander.

Es gibt drei Arten von Ausführern:

  • ExportTextFile
  • ExportDelimitedTextFile
  • ExportVSLFile

Weitere Informationen zu Exporttypen finden Sie unter Definieren von Exportern .

Hashschwellenwert Optional. Ein Stichprobenfaktor für eine zufällige Unterstichprobe von Zeilen. Wenn der Wert auf "n"festgelegt ist, wird nur eine von n Tracking-IDs für den Export ausgewählt, wodurch die Gesamtzahl der exportierten Zeilen um den Faktor n verringert wird. Um alle Zeilen zu exportieren, legen Sie den Hash-Schwellenwert auf 1 fest.
Protokolleintragsbedingung Optional. Definiert die Regeln, nach denen Protokolleinträge für den Export berücksichtigt werden. Weitere Informationen zur Protokolleingabebedingung finden Sie unter Konfigurationsdatei für die Protokollverarbeitung .
Quellen für die Protokollierung

Die Datenquellen. Protokollquellen können .vsl- Dateien, Protokolldateien, XML-Dateien oder Daten aus ODBC-kompatiblen Datenbanken sein. Weitere Informationen zu Protokollquellen finden Sie unter Protokollverarbeitungskonfigurationsdatei .

Transform erwartet, dass alle Quelldaten in chronologischer Reihenfolge innerhalb der lexikografisch geordneten Eingabedateien vorliegen. Wenn diese Anforderung nicht erfüllt ist, sind die As Of-Berechnungen nicht korrekt, und nach dem Schließen der Ausgabedateien können zusätzliche Eingabedaten verarbeitet werden.

Offlinemodus

Optional. Wahr oder falsch. Bei "true"geht Transform davon aus, dass alle Eingabedateien vorhanden sind, wenn der Beginn die Daten verarbeitet. Wenn alle Eingabedaten gelesen wurden, schließt Transform alle Ausgabedateien, ohne darauf zu warten, dass zusätzliche Daten empfangen werden. Der Standardwert ist „false“.

Hinweis: Wenn Offlinemodus auf "true"eingestellt ist, erwartet Transform , dass alle Quelldaten vor der Verarbeitung von Beginn vorhanden sind. In der Datei VisualServer.log wird eine Warnmeldung generiert, wenn nach dem Schließen der Ausgabedateien weitere Daten empfangen werden.

Neu verarbeiten

Optional. Alle Zeichen oder Kombinationen von Zeichen können hier eingegeben werden. Durch Ändern dieses Parameters und Speichern der Datei auf dem Computer Transform wird die Datenverarbeitung initiiert.

Weitere Informationen zur erneuten Verarbeitung Ihrer Daten finden Sie unter Wiederaufbereitung und Verarbeitung .

Phasen

Optional. Die Namen der Verarbeitungsstufen, die in Protokollverarbeitungsdataset verwendet werden können, umfassen -Dateien, die zusätzlich zur Datei Transform.cfg ausgeführt werden. Verarbeitungsschritte bieten eine Möglichkeit, die in Protokollverarbeitungsdataset definierten Transformationen anzuordnen. Schließen Sie -Dateien ein. Dieser Parameter ist sehr hilfreich, wenn Sie eine oder mehrere Konvertierungen innerhalb mehrerer -Protokollverarbeitungsdaten einschließen -Dateien definiert haben und Sie möchten, dass bestimmte Konvertierungen an bestimmten Punkten während des Exportvorgangs durchgeführt werden.

Die Reihenfolge, in der die Schritte hier Liste werden, bestimmt die Reihenfolge, in der die Transformationen in den Protokollverarbeitungsdatenasets -Dateien einschließlich während des Datenexports ausgeführt werden. Vorverarbeitung und Nachverarbeitung sind integrierte Phasen; Die Vorverarbeitung ist immer der erste Schritt und die Nachbearbeitung ist immer der letzte Schritt. Standardmäßig gibt es eine benannte Phase mit dem Namen Default .

So fügen Sie eine neue Verarbeitungsphase hinzu

  • Klicken Sie im Fenster Data Workbench Transform.cfg mit der rechten Maustaste auf Stages und dann auf Hinzufügen New > Stage .
  • Geben Sie einen Namen für die neue Phase ein.

So löschen Sie eine vorhandene Verarbeitungsphase

  • Klicken Sie mit der rechten Maustaste auf die Zahl, die der zu löschenden Phase entspricht, und klicken Sie auf < #stage_number .

Hinweis: Wenn Sie eine Phase in einer -Protokollverarbeitungsdataset Einschließen -Datei angeben, muss der Name der Bühne exakt mit dem Namen übereinstimmen, den Sie hier eingeben. Weitere Informationen zu Datenaset-Include-Dateien finden Sie unter DataSet Include-Dateien .

Startzeit

Optional. Filtern Sie die Daten, um Protokolleinträge mit Zeitstempeln zu dieser Zeit oder danach einzuschließen. Adobe empfiehlt die Verwendung eines der folgenden Zeitformate:

  • 1. Januar 2013 HH:MM:SS EDT
  • 1. Januar 2013 HH:MM:SS GMT

Wenn Sie beispielsweise den 29. Juli 2013 um 00:00:00 Uhr EDT als "Beginn Time"festlegen, werden Daten ab dem 29. Juli 2013 um 12:00:00 Uhr EDT eingeschlossen.

Sie müssen eine Zeitzone angeben. Die Zeitzone wird nicht standardmäßig auf GMT gesetzt, wenn sie nicht angegeben ist. Eine Liste der vom Data Workbench-Server unterstützten Zeitzonenabkürzungen finden Sie unter Zeitzonencodes .

Hinweis: Der Parameter Use Beginn/End Times für Sensor- und Protokolldateiquellen bezieht sich auf diesen Parameter.

Transformationen

Optional. Definiert die Transformationen, die auf die Daten angewendet werden sollen. Informationen zu den verfügbaren Transformationstypen finden Sie unter Datentransformationen .

Hinweis: Die folgenden Transformationstypen funktionieren nicht, wenn sie in der Datei data workbench Transform.cfg definiert werden:

  • AppendURI
  • CrossRows
  • ODBCLookup
  • Sessionize
HINWEIS

Wenn nach dem Schließen der Ausgabedateien weitere Daten empfangen werden (siehe Log Sources und Offline Mode in der obigen Tabelle), erstellt Transform neue Ausgabedateien mit den zusätzlichen Daten. Die Namen der neuen Ausgabedateien werden aus dem Namen der ursprünglichen Ausgabedatei mit einer in Klammern gesetzten Versionsnummer direkt vor der Erweiterung generiert. Wenn die ursprüngliche Ausgabedatei beispielsweise 20070701-ABC.vsl lautet, werden nachfolgende Versionen dieser Datei 20070701-ABC(1).vsl, 20070701-ABC(2).vsl usw. benannt. Beachten Sie, dass die Verwendung der versionierten Dateien als Eingabe für den Data Workbench-Server zu Verarbeitungsfehlern führen kann.

Adobe empfiehlt, die Erstellung versionierter Ausgabedateien zu vermeiden, indem sichergestellt wird, dass alle Quelldaten in chronologischer Reihenfolge innerhalb von lexikografisch geordneten Eingabedateien vorliegen und, wenn Offline Mode auf true gesetzt ist, alle Quelldaten vor der Verarbeitung von Beginn vorhanden sind. Weitere Informationen finden Sie in den Einträgen Log Sources und Offline Mode in der obigen Tabelle.

  1. hinzufügen Sie die Transformationen, indem Sie mit der rechten Maustaste auf Transformations klicken und Add new > Transformation type klicken. Füllen Sie die Transformationsfelder aus.

    Beschreibungen und Beispiele der Transformationen, die Sie mit der Transformationsfunktion verwenden können, finden Sie unter Datentransformationen.

  2. Klicken Sie mit der rechten Maustaste auf (modified) oben im Fenster und dann auf Save.

  3. Um die lokal vorgenommenen Änderungen in Kraft zu setzen, klicken Sie in der Spalte Profile Manager mit der rechten Maustaste auf das Häkchen für Data Workbench Transform.cfg und klicken Sie dann auf User und dann auf Save to > profile name. Dabei ist der Profil der Name des Profils, für das Sie Daten exportieren. Die erneute Verarbeitung der Daten beginnt nach der Synchronisierung des Profils.

    HINWEIS

    Weitere Informationen zur erneuten Verarbeitung Ihrer Daten für den Export finden Sie unter Wiederaufbereitung und Verarbeitung.

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now