Show Menu
THEMEN×

Die 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) erfasst werden oder in Textdateien, XML-Dateien oder ODBC-kompatiblen Datenbanken enthalten sind, 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 Data Workbench- Transform.cfg Datei im Ordner "DataSet"für das Profil, für das Sie Ereignisdaten exportieren möchten. Normalerweise ist dieses Profil der Transformationsfunktion gewidmet (d. h. Sie führen keine andere Datenverarbeitung durch als die in der Data Workbench- Transform.cfg Datei definierten Daten). Es ist wichtig zu beachten, dass alle Verarbeitungsanweisungen, die in den Log Processing Dataset Include Dateien für geerbte Profile angegeben sind, zusätzlich zu den in der Data Workbench- Transform.cfg Datei angegebenen angewendet werden.
Weitere Informationen zu Datenaset-Include-Dateien finden Sie unter DataSet Include-Dateien .
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. Öffnen Sie bei der Arbeit mit dem Profil, für das Sie Daten exportieren möchten, die Datei Profile Manager und klicken Sie auf Dataset , um den Inhalt des Ordners anzuzeigen.
  2. Klicken Sie mit der rechten Maustaste auf das Häkchen neben Data Workbench Transform.cfgund klicken Sie dann auf Make Local . Ein Häkchen für diese Datei wird in der User Spalte angezeigt.
  3. Klicken Sie mit der rechten Maustaste auf das neu erstellte Häkchen und klicken Sie auf Open > from the workbench . Das Data Workbench- Transform.cfg Fenster 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 Formate:
  • 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 Endzeit festlegen, werden Daten bis zum 28. Juli 2013 um 23:59:59 PM 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 .
Der Parameter "Start-/Endzeit verwenden"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.
Protokolleinstiegsbedingung 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 .
Protokollquellen
Die Datenquellen. Protokollquellen können .vsl- Dateien, Protokolldateien oder XML-Dateien oder Daten aus ODBC-kompatiblen Datenbanken sein. Weitere Informationen zu Protokollquellen finden Sie unter Konfigurationsdatei für die Protokollverarbeitung .
Transform erwartet, dass alle Quelldaten in chronologischer Reihenfolge innerhalb von 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. True oder false. Wenn "true", geht Transform davon aus, dass alle Eingabedateien vorhanden sind, wenn die Verarbeitung der Daten beginnt. Wenn alle Eingabedaten gelesen wurden, schließt Transform alle Ausgabedateien, ohne darauf zu warten, dass weitere Daten empfangen werden. Der Standardwert ist „false“.
Hinweis: Wenn der Offline-Modus auf "true"festgelegt ist, erwartet Transform, dass alle Quelldaten vorhanden sind, bevor die Verarbeitung beginnt. Eine Warnmeldung wird in der Datei VisualServer.log 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. Wenn Sie diesen Parameter ändern und die Datei auf dem Transform- Computer speichern, wird die Datenverarbeitung initiiert.
Weitere Informationen zur erneuten Verarbeitung Ihrer Daten finden Sie unter Verarbeitung und Verarbeitung .
Phasen
Optional. Die Namen der Verarbeitungsstufen, die in Protokollverarbeitungsdatensätzen verwendet werden können, umfassen Dateien, die zusätzlich zur Datenbasis- Transform.cfg- Datei ausgeführt werden. Verarbeitungsschritte bieten eine Möglichkeit, die Konvertierungen anzuordnen, die in "Log Processing DataSet Include"- Dateien definiert sind. Dieser Parameter ist sehr hilfreich, wenn Sie eine oder mehrere Konvertierungen in mehreren Protokollverarbeitungsdatendateien einschließlich -Dateien definiert haben und Sie möchten, dass bestimmte Transformationen an bestimmten Punkten während des Exportvorgangs durchgeführt werden.
Die Reihenfolge, in der Sie die Schritte hier auflisten, bestimmt die Reihenfolge, in der die Konvertierungen im Datensatz "Log Processing DataSet Include"- Dateien 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 namens " Standard" .
So fügen Sie eine neue Verarbeitungsphase hinzu
  • Klicken Sie im Data Workbench Transform.cfg- Fenster mit der rechten Maustaste auf Stufen und klicken Sie dann auf Neu hinzufügen > Phase .
  • 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 Nummer, die der zu löschenden Phase entspricht, und klicken Sie auf < #stage_number > .
Hinweis: Wenn Sie eine Phase in einer Protokollverarbeitungsdatenaset-Include- -Datei angeben, muss der Name der Phase genau 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 Formate:
  • 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 Startzeit festlegen, sind Daten ab dem 29. Juli 2013 um 12:00:00 Uhr EDT enthalten.
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 "Start-/Endzeit verwenden"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 sind:
  • AppendURI
  • CrossRows
  • ODBCLookup
  • Sessionieren
Werden nach dem Schließen der Ausgabedateien weitere Daten empfangen (siehe Log Sources und Offline Mode in der obigen Tabelle), werden neue Ausgabedateien mit den zusätzlichen Daten Transform erstellt. 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.vsllautet, werden nachfolgende Versionen dieser Datei benannt 20070701-ABC(1).vsl, 20070701-ABC(2).vslusw. 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 der lexikografisch geordneten Eingabedateien vorliegen und, falls "true"festgelegt Offline Mode ist, dass alle Quelldaten vor dem Beginn der Verarbeitung vorhanden sind. Weitere Informationen finden Sie in den Log Sources und in den Offline Mode Einträgen in der obigen Tabelle.
  1. Fügen Sie Transformationen hinzu, indem Sie mit der rechten Maustaste klicken Transformations und auf Add new > Transformation type . 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 (modified) am oberen Rand des Fensters und klicken Sie dann auf Save .
  3. Damit die lokal vorgenommenen Änderungen wirksam werden, klicken Sie im Profile ManagerKontextmenü mit der rechten Maustaste auf das Häkchen für die Datenbasis Transform.cfg in der User Spalte und klicken Sie dann auf Save to > profile name . Dabei ist Profilname der Name des Profils, für das Sie Daten exportieren. Die erneute Verarbeitung der Daten beginnt nach der Synchronisierung des Profils.
    Informationen zur erneuten Verarbeitung Ihrer Daten für den Export finden Sie unter Wiederaufbereitung und Konvertierung .