Show Menu
トピック×

エクスポーターの定義

イベントデータを出力するための命令は、エクスポーターから与えられます。
Transformation functionality provides three types of exporters for exporting .vsl files, log files, XML files, and ODBC data as .vsl files, text files, or delimited text files that can be used by DataWarehouse loading routines, auditing agencies, or other targets.
エクスポーターが正しく動作するためには、ログソースが、ログ処理設定ファイルの Log Sources (ログソース)セクションで説明されている適切な 要件を満たしている必要があります
エクスポーターを定義するには
  1. Open Transform.cfg in data workbench. See To edit the Insight Transform.cfg file .
  2. 右クリックし、 Exporters ​をクリックしま Add New ​す。
  3. 次のいずれかのオプションを選択します。
    • ExportTextFile
    • ExportDelimitedTextFile
    • ExportVSLFile
    For the ExportVSLFile option, all of the extended fields in the input file and all user-defined fields of the form cs( header ) are always written to the VSL output file. 既存の拡張フィールドを上書きした場合、出力ファイルに新しい値が書き込まれます。そのフィールドがブランクであったとしても同様です。
  4. 次の表を参考にして、設定ファイルの Exporters パラメーターを編集します。
    パラメーター 説明
    Data Format
    ExportTextFile の場合のみ。各出力行の形式。エスケープされたフィールド名(% fieldname % 形式)とその他必要な定型テキストから成ります。この形式には、行区切り記号を含める必要があります(通常、[CR] [LF])。
    書式設定文字列にリテラルのパーセント記号(%)を含めるには、「%%」のようにエスケープする必要があります。
    例えば、「 %x-timestring% %x-trackingid%[CR][LF] 」のように Data Format パラメーターを入力します。
    フィールド ExportDelimitedTextFile の場合のみ。出力するフィールドの名前。
    Delimiter
    (オプション) ExportDelimitedTextFile の場合のみ。出力ファイル内のフィールドの区切りに使用する文字。
    データの値に含まれている区切り文字はエスケープできません。そのため、コンマを区切り文字として使用することは、できるだけ避けてください。
    Delimiter パラメーター内で Ctrl キーを押しながら右クリックすると、 挿入 メニューが表示されます。このメニューには、区切り文字としてよく使用される特殊文字が一覧表示されます。
    Line Separator (オプション) ExportDelimitedTextFile の場合のみ。出力ファイル内の行の区切りに使用する文字。デフォルト値は [CR] [LF] です。
    名前
    (オプション)エクスポーターの識別子。「 詳細なステータス 」インターフェイスにはこの名前が表示されます。
    詳細なステータス 」インターフェイスについて詳しくは、『 Data Workbench ユーザーガイド 』を参照してください。
    Comments (オプション)エクスポーターについてのメモ。
    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 サーバーコンピューター上の適切なプロファイルに保存します。