Definieren von Exportern

Exporter geben die Anweisungen zur Ausgabe der Ereignisdaten.

Die Umwandlungsfunktion bietet drei Exporttypen für den Export von .vsl-Dateien, Protokolldateien, XML-Dateien und ODBC-Daten als .vsl-Dateien, Textdateien oder Textdateien mit Trennzeichen, die von DataWarehouse-Laderoutinen, Prüfagenturen oder anderen Zielen verwendet werden können.

HINWEIS

Damit ein Exporter ordnungsgemäß funktioniert, muss die Protokollquelle die entsprechenden Anforderungen erfüllen, die im Abschnitt Protokollquellen von Konfigurationsdatei für die Protokollverarbeitung beschrieben werden.

So definieren Sie einen Ausführer

  1. Öffnen Sie Transform.cfg in Data Workbench. Siehe So bearbeiten Sie die Datei Insight Transform.cfg.

  2. Klicken Sie mit der rechten Maustaste auf Exporters und klicken Sie dann auf Add New.

  3. Wählen Sie eine der folgenden Optionen aus:

    • ExportTextFile
    • ExportDelimitedTextFile
    • ExportVSLFile
    HINWEIS

    Für die Option ExportVSLFile werden alle erweiterten Felder in der Eingabedatei und alle benutzerdefinierten Felder des Formulars cs(header) immer in die VSL Ausgabedatei geschrieben. Wenn Sie ein vorhandenes erweitertes Feld überschreiben, wird der neue Wert in die Ausgabedatei geschrieben, auch wenn das Feld leer ist.

  4. Bearbeiten Sie die Exporter-Parameter in der Konfigurationsdatei mithilfe der folgenden Tabelle als Anleitung:

    Parameter Beschreibung
    Datenformat

    Nur für ExportTextFile. Das Format jeder Ausgabelinie, bestehend aus Feldnamen Escapes (ausgedrückt als %Feldname%) und jedem anderen gewünschten festen Text. Das Format sollte ein Zeilentrennzeichen enthalten, in der Regel [CR] [LF].

    Ein literales Prozentzeichen (%) kann in die Formatzeichenfolge eingebettet werden, indem das Zeichen wie im folgenden Beispiel maskiert wird: %%

    Ein Beispiel für einen Eintrag für den Parameter Datenformat ist %x-timestring% %x-trackingid%[CR][LF].

    Felder Nur für ExportDelimitedTextFile. Namen der auszugebenden Felder.
    Trennzeichen

    Optional. Nur für ExportDelimitedTextFile. Zeichen, das zum Trennen der Felder in der Ausgabedatei verwendet wird.

    Die Software kann Trennzeichen, die in den Datenwerten enthalten sind, nicht maskieren. Daher wird von Adobe die Verwendung von Kommas als Trennzeichen nicht empfohlen.

    Wenn Sie die Strg-Taste gedrückt halten und mit der rechten Maustaste im Trennzeichen-Parameter klicken, wird das Menü Einfügen angezeigt. Dieses Menü enthält eine Liste von Sonderzeichen, die häufig als Trennzeichen verwendet werden.

    Trennlinie Optional. Nur für ExportDelimitedTextFile. Die Zeichen, die zur Trennung von Zeilen in den Ausgabedateien verwendet werden. Der Standardwert ist [CR] [LF].
    Name

    Optional. Kennung für den Ausführer. Dieser Name wird in der -Benutzeroberfläche mit detailliertem Status angezeigt.

    Weitere Informationen zur -Oberfläche mit detailliertem Status finden Sie im Data Workbench-Benutzerhandbuch.

    Kommentare Optional. Hinweise zum Ausführer.
    Ausgabepfad

    Pfad, in dem Ausgabedateien gespeichert werden sollen. Der Pfad ist relativ zum Installationsordner des Data Workbench-Servers.

    Hinweis: Der Data Workbench-Server, der Ausgabedaten speichert, ist der Verarbeitungsserver #0 in der Datei profile.cfg.

    Dateirotierungsperiode

    Optional. Die Häufigkeit, mit der Daten in die Ausgabedatei exportiert werden. Jede Ausgabedatei enthält Daten zu einem bestimmten Zeitraum, der als Rotationszeitraum bezeichnet wird. Alle Zeitberechnungen sind in GMT: Ein Tag beginnt um Mitternacht GMT und endet am folgenden Tag um Mitternacht GMT, selbst wenn die in die Datei geschriebenen Daten ein Feld enthalten, das in Ortszeit umgewandelt wurde.

    Folgende Werte sind verfügbar:

    • JAHR. Jede Datei enthält Daten für ein Kalenderjahr.
    • MONAT. Jede Datei enthält Daten für einen Kalendermonat. Die Monate sind 1 (Januar) bis 12 (Dezember).
    • WOCHE. Jede Datei enthält Daten für eine Woche. Eine Woche beginnt am Montag. Die Woche, die an einem der ersten sieben Tage des Jahres beginnt, ist Woche 1 und die vorherige (teilweise) Woche, falls vorhanden, Woche 0.
    • TAG. Jede Datei enthält Daten für einen Kalendertag.
    • STUNDE. Jede Datei enthält Daten für eine Stunde.
    • KEINE. Es wird keine Drehung durchgeführt. Alle Daten werden in dieselbe Datei geschrieben (oder in einen Dateisatz, der durch andere Parametereinstellungen bestimmt wird). Siehe den Parameter File Name Format in dieser Tabelle.

    Der standardmäßige Zeitraum für die Dateirotation ist DAY.

    • Setzen Sie die Dateirotation nur dann auf "NONE", wenn Sie im Offline-Modus arbeiten. Siehe Parameterbeschreibung für Offline-Modus .
    Dateinamenformat

    Optional. Das Format des Namens der Ausgabedatei.

    Jeder Protokolleintrag kann in einer Datei gespeichert werden, deren Name von der Startzeit des Drehzeitraums und optional von den Werten der Felder in den darin enthaltenen Zeilen abgeleitet wird. Die im Dateinamen zu verwendenden Felder sind als Escape-Zeichen für Feldnamen eingebettet (ausgedrückt als %Feldname%).

    Die Dateinamenkomponenten, die sich auf den Rotationszeitraum beziehen, werden mithilfe der folgenden Escape-Sequenzen in die Formatzeichenfolge eingebettet:

    • %yyy% (vierstellige Jahreszahl)
    • %yy% (zweistellige Jahreszahl)
    • %mm% (zweistelliger Monat, 01 - 12)
    • %w% (zweistellige Woche, 01 - 52)
    • %dd% (zweistelliger Tag, 01 - 31)
    • %HH% (zweistellige Stunde, 00 - 23)

    Das standardmäßige Dateinamenformat ist %yyy%%mm%%dd%-%x-mask%.txt

    • Bei Escape-Sequenzen wird zwischen Groß- und Kleinschreibung unterschieden.
    • Wenn der Dateirotationszeitraum auf "KEINE"festgelegt ist, wird eine leere Zeichenfolge für jede der Escape-Sequenzen ersetzt, sofern vorhanden.
    • Es wird ein Fehler erzeugt, wenn File Name Format nicht zu einem eindeutigen Dateinamen für jeden Rotationszeitraum führt (siehe Parameter "File Rotation Period"in dieser Tabelle). Bei Verwendung des Drehungszeitraums Tag müssen beispielsweise die Escape-Sequenzen %dd%, %mm% und %yy% oder %yyy% im Muster vorhanden sein, um Datenverlust zu vermeiden.
    • Wenn Sie Escape-Sequenzen für Feldnamen innerhalb des Musters verwenden und das angegebene Feld viele unterschiedliche Werte aufweist, werden viele Ausgabedateien für jeden Rotationszeitraum geschrieben. Beachten Sie, dass dieses Szenario zu einer schlechten Leistung führen kann. Daher sollten Sie diese Funktion mit Vorsicht verwenden.
    • Alle Berechnungen liegen in GMT vor.
    Ausführen bei Rollover

    Optional. Nach Abschluss jeder Datei kann ein externer Befehl (Windows) ausgeführt werden. Die Befehlszeile wird aus dem endgültigen Dateinamen abgeleitet, indem die folgenden Escape-Sequenzen in diesen Parameter ersetzt werden:

    • %dir%. Der Ordnerteil des endgültigen Dateinamens, einschließlich des nachfolgenden umgekehrten Schrägstrichs.
    • %file%. Der Dateiname der endgültigen Datei (ohne Verzeichnis und Erweiterung).
    • %ext%. Die Erweiterung (einschließlich des führenden ".") des endgültigen Dateinamens.
    • %path%. Der vollständige Pfadname der Datei, entsprechend %dir%%file%%ext%.

    Standardmäßig ist dieser Parameter leer (es wird kein Befehl ausgeführt).

    Speicherbegrenzung

    Optional. Die Menge an Speicher in Byte, die zum Puffern der Exportergebnisse verwendet wird. Der Standardwert ist 10.000.000 Bytes.

    Hinweis: Wenn Sie viele Ausgabedateien haben, die gleichzeitig geöffnet sind, können Sie diesen Wert erhöhen, Sie können jedoch die Speicherkapazität verringern, die für andere Komponenten des Systems zur Verfügung steht. Eine Verringerung dieses Werts kann jedoch den Exportvorgang verlangsamen. Wenden Sie sich für Unterstützung an die Adobe.

    Open Files Limit

    Optional. Die maximale Anzahl von Dateien, die gleichzeitig für die Ausgabe vom Exporter geöffnet sein können. Wenn diese Zahl überschritten wird, wird ein Fehler im Ereignisprotokoll aufgezeichnet und der Data Workbench-Server wird nicht mehr ausgeführt. Der Standardwert lautet 1000.

  5. Nachdem Sie Ihren Exporter (und Änderungen an anderen Parametern) in der Datei Transform.cfg definiert haben, speichern Sie die Datei lokal und speichern Sie sie im entsprechenden Profil auf dem Data Workbench-Server-Computer.

Auf dieser Seite