エクスポーターの定義

イベントデータを出力するための命令は、エクスポーターから与えられます。

変換機能には、.vslファイル、ログファイル、XMLファイル、ODBCデータを.vslファイル、テキストファイル、区切り文字付きテキストファイルとしてエクスポートする、3種類のエクスポーターが用意されています。

メモ

エクスポーターが正しく動作するには、ログソースがログ処理設定ファイルログソースで説明されている適切な要件を満たしている必要があります。

エクスポーターを定義するには

  1. data workbenchでTransform.cfgを開きます。 Insight Transform.cfgファイルを編集するにはを参照してください。

  2. Exporters​を右クリックし、Add New​をクリックします。

  3. 次のいずれかのオプションを選択します。

    • ExportTextFile
    • ExportDelimitedTextFile
    • ExportVSLFile
    メモ

    ExportVSLFileオプションの場合、入力ファイル内のすべての拡張フィールドと、cs(header)形式のすべてのユーザー定義フィールドが常にVSL出力ファイルに書き込まれます。 既存の拡張フィールドを上書きした場合、出力ファイルに新しい値が書き込まれます。そのフィールドがブランクであったとしても同様です。

  4. 次の表を参考にして、設定ファイルの Exporters パラメーターを編集します。

    パラメーター 説明
    Data Format

    ExportTextFile の場合のみ。各出力行の形式。エスケープされたフィールド名(%fieldname% 形式)とその他必要な定型テキストから成ります。この形式には、行区切り記号を含める必要があります(通常、[CR] [LF])。

    書式設定文字列にリテラルのパーセント記号(%)を含めるには、「%%」のようにエスケープする必要があります。

    例えば、「%x-timestring% %x-trackingid%[CR][LF]」のように Data Format パラメーターを入力します。

    フィールド ExportDelimitedTextFile の場合のみ。出力するフィールドの名前。
    区切り

    (オプション)ExportDelimitedTextFile の場合のみ。出力ファイル内のフィールドの区切りに使用する文字。

    データの値に含まれている区切り文字はエスケープできません。そのため、コンマを区切り文字として使用することは、できるだけ避けてください。

    Delimiter パラメーター内で Ctrl キーを押しながら右クリックすると、挿入メニューが表示されます。このメニューには、区切り文字としてよく使用される特殊文字が一覧表示されます。

    Line Separator (オプション)ExportDelimitedTextFile の場合のみ。出力ファイル内の行の区切りに使用する文字。デフォルト値は [CR] [LF] です。
    名前

    (オプション)エクスポーターの識別子。「詳細なステータス」インターフェイスにはこの名前が表示されます。

    詳細なステータス」インターフェイスについて詳しくは、『Data Workbench ユーザーガイド』を参照してください。

    コメント (オプション)エクスポーターについてのメモ。
    Output Path

    出力ファイルの保存先となるパス。Data Workbench サーバーのインストールフォルダーを基準とする相対パスで指定します。

    注意:出力データを格納する Data Workbench サーバーは、profile.cfg ファイルにおける処理サーバー #0 です。

    File Rotation Period

    (オプション)出力ファイルにデータをエクスポートする頻度。それぞれの出力ファイルには、特定の期間(ローテーション期間)に関連したデータが含まれます。すべての時刻計算は GMT で行われます。つまり、1 日は午前 0 時 GMT に始まり、翌日の午前 0 時 GMT に終わります。ファイルに書き込まれたデータが、現地時刻に変換済みのフィールドを含んでいたとしても同様です。

    選択できる値は次のとおりです。

    • YEAR:1 年分のデータが各ファイルに保存されます。
    • MONTH:1 か月分のデータが各ファイルに保存されます。それぞれの月には、1(1 月)~ 12(12 月)の番号が付けられています。
    • WEEK:1 週間分のデータが各ファイルに保存されます。週の始まりは月曜日です。1 年の最初の 7 日間のうちいずれかの日を始まりとする週を第 1 週とし、その前の(不完全な)週がもしあれば第 0 週となります。
    • DAY:1 日分のデータが各ファイルに保存されます。
    • HOUR:1 時間分のデータが各ファイルに保存されます。
    • NONE:ファイルの回転は実施されません。すべてのデータが同じファイル(または他のパラメーターの設定で指定された一連のファイル)に書き込まれます。詳しくは、この表の「File Name Format」パラメーターを参照してください。

    ファイルのローテーション期間のデフォルトは DAY です。

    • ファイルの回転を NONE に設定するのは、オフラインモードで作業するときだけにしてください。 Offline Modeパラメーターの説明を参照してください。
    File Name Format

    (オプション)出力ファイル名の形式。

    各ログエントリの保存先となるファイルには、ローテーション期間の開始時刻に由来した名前を付けることができます。さらに、ログエントリに含まれている行のフィールド値をファイル名の中で使用することもできます。フィールド名は、エスケープして(%fieldname% 形式で)ファイル名に埋め込みます。

    ローテーション期間に関連した構成要素は、次のエスケープシーケンスを使用した書式設定文字列でファイル名に埋め込みます。

    • %yyyy%(4 桁の年)
    • %yy%(2 桁の年)
    • %mm%(2 桁の月、01 ~ 12)
    • %ww%(2 桁の週、01 ~ 52)
    • %dd%(2 桁の日、01 ~ 31)
    • %HH%(2 桁の時、00 ~ 23)

    ファイル名のデフォルトの形式は %yyyy%%mm%%dd%-%x-mask%.txt です。

    • エスケープシーケンスでは、大文字と小文字が区別されます。
    • File Rotation Period を NONE に設定した場合、エスケープシーケンス(存在する場合)は空の文字列に置き換えられます。
    • File Name Format で得られたファイル名がローテーション期間ごとに一意になっていない場合、エラーが発生します(この表の「File Rotation Period」パラメーターを参照)。例えば、ローテーション期間を DAY とした場合、データの喪失を防ぐために、%dd% と %mm% に加え、%yy% または %yyyy% のエスケープシーケンスをパターンに含める必要があります。
    • フィールド名のエスケープシーケンスをパターン内で使用する場合、指定したフィールドの値が多様だと、それだけ多くの出力ファイルがローテーション期間ごとに書き込まれます。その場合、パフォーマンスが低下する可能性があるので、この機能は注意して使用してください。
    • すべての時刻計算は GMT で行われます。
    Execute at Rollover

    (オプション)それぞれのファイルの最終処理時に外部(Windows)コマンドを実行できます。コマンドラインは、最終的なファイル名から得られます。その際、次のエスケープシーケンスがこのパラメーターに代入されます。

    • %dir%:最終的なファイル名のディレクトリ部分(末尾のバックスラッシュを含む)。
    • %file%:最終的なファイルの名前(ディレクトリと拡張子を除く)。
    • %ext%:最終的なファイル名の拡張子(先頭の「.」を含む)。
    • %path%:ファイルのフルパス名(%dir%%file%%ext% に相当)。

    デフォルトでは、このパラメーターは空です(コマンドは実行されません)。

    Memory Limit

    (オプション)エクスポーターの出力をバッファリングする際に使用されるメモリ量(バイト)。デフォルト値は 10,000,000 バイトです。

    注意:多数の出力ファイルを同時に開く場合は、この値を増やしてください。ただし、他のシステムコンポーネントに必要な空きメモリ量が減る可能性があります。一方、この値を小さくすると、エクスポート処理のパフォーマンスは低下する可能性があります。不明な点はアドビにお問い合わせください。

    Open Files Limit

    (オプション)エクスポーターからの出力時に同時に開くことができるファイルの最大数。この数を超えると、イベントログにエラーが記録され、Data Workbench サーバーの実行が停止されます。デフォルト値は 1000 です。

  5. Transform.cfg ファイルでエクスポーターを定義し、他のパラメーターに必要な変更を加えたら、そのファイルをローカルに保存してから、Data Workbench サーバーコンピューター上の適切なプロファイルに保存します。

このページ