定義匯出工具

導出器提供用於輸出事件資料的指令。

轉換功能提供三種類型的導出器,用於將.vsl檔案、日誌檔案、XML檔案和ODBC資料導出為.vsl檔案、文本檔案或分隔文本檔案,這些檔案可用於DataWarehouse載入常式、審計機構或其他目標。

注意

要使導出器正常工作,日誌源必須滿足日誌處理配置檔案日誌源部分中討論的適當要求。

要定義導出器,請執行以下操作

  1. 在Data Workbench中開啟Transform.cfg。 請參閱若要編輯Insight Transform.cfg檔案

  2. 按一下右鍵​Exporters,然後按一下​Add New

  3. 選取下列其中一個選項:

    • ExportTextFile
    • ExportDelimitedTextFile
    • ExportVSLFile
    注意

    對於ExportVSLFile選項,輸入檔案中的所有擴展欄位和窗體cs(header)的所有用戶定義欄位始終寫入VSL輸出檔案。 如果覆蓋現有的擴展欄位,則新值將寫入輸出檔案,即使該欄位為空。

  4. 使用下表作為指南,編輯配置檔案中的導出器參數:

    參數 說明
    資料格式

    僅適用於 ExportTextFile。 每個輸出行的格式,由欄位名稱逸出(以%fieldname%表示)和任何其他需要的固定文本組成。 格式應包含行分隔符,通常為[CR] [LF]。

    文字百分比符號(%)可借由逸出字元嵌入格式字串,如下所示:%

    資料格式參數的條目示例為 %x-timestring% %x-trackingid%[CR][LF]

    欄位 僅適用於 ExportDelimetedTextFile。 要輸出的欄位名稱。
    分隔字元

    選填。僅適用於 ExportDelimetedTextFile。 用於分隔輸出檔案中欄位的字元。

    軟體無法逸出資料值中包含的分隔字元。 因此,Adobe不建議將逗號當作分隔字元。

    如果按住Ctrl鍵並在「分隔字元」參數內按一下右鍵,則會出現「插入 」菜單。 此菜單包含通常用作分隔符的特殊字元的清單。

    行分隔符 選填。僅適用於 ExportDelimetedTextFile。 用於在輸出檔案中分隔行的字元。 預設值為[CR] [LF]。
    名稱

    選填。導出器的標識符。 此名稱顯示在詳細狀態介面中。

    有關詳細狀態介面的資訊,請參閱Data Workbench使用手冊

    註解 選填。關於出口商的筆記。
    輸出路徑

    儲存輸出檔案的路徑。 路徑相對於Data Workbench伺服器安裝資料夾。

    注意:儲存輸出資料的Data Workbench伺服器是處理 profile.cfg檔案中的#0的伺服器。

    檔案旋轉期間

    選填。將資料導出到輸出檔案的頻率。 每個輸出檔案都包含與稱為旋轉週期的特定時段相關的資料。 所有時間的計算都以GMT為單位:某一天從格林尼治時間的午夜開始,第二天從格林尼治時間的午夜結束,即使寫入檔案的資料包含已轉換為當地時間的欄位亦然。

    可用值如下:

    • 年。 每個檔案包含一個日曆年的資料。
    • 月。 每個檔案包含一個日曆月的資料。 月份編號為1(1月)至12(12月)。
    • 周。 每個檔案包含一週的資料。 星期一開始。 從一年中前七天之一開始的周是第1週,而前(部分)周(如果有的話)是第0週。
    • 日。 每個檔案包含一個日曆日的資料。
    • 小時。 每個檔案包含1小時的資料。
    • NONE. 不執行旋轉。 所有資料都會寫入相同的檔案(或由其他參數設定所決定的一組檔案)。 請參閱此表中的檔案名格式參數。

    預設檔案旋轉週期為DAY。

    • 僅當在離線模式中工作時,才將檔案旋轉設定為「無」。 請參閱離線模式參數說明。
    檔案名格式

    選填。輸出檔案名的格式。

    每個日誌條目都可以儲存在一個檔案中,該檔案的名稱是從旋轉週期的開始時間派生的,也可以從包含的行中的欄位值派生的。 檔案名中要使用的欄位被嵌入為欄位名稱逸出(以%fieldname%表示)。

    與旋轉週期相關的檔案名元件使用以下轉義序列嵌入到格式字串中:

    • %yyyy%(四位數年)
    • %yy%(兩位數年份)
    • %mm%(兩位數月,01 - 12)
    • %ww%(兩位數的周,01 - 52)
    • %dd%(兩位數,01 - 31)
    • %HH%(兩位數小時,00 - 23)

    預設檔案名格式為 %yyyy%%mm%dd%-%x-mask%。txt

    • 逸出序列區分大小寫。
    • 當「檔案旋轉週期」設定為「無」時,每個轉義序列都會替換空字串(如果存在)。
    • 如果檔案名格式未導致每個旋轉週期的檔案名唯一,則會生成錯誤(請參見此表中的檔案旋轉週期參數)。 例如,使用DAY旋轉期間時,%dd%、%mm%和%yy%或%yyyy%轉義序列必須以模式存在,以避免資料丟失。
    • 如果您在模式內使用欄位名稱逸出序列,且指定的欄位有許多不同的值,則會為每個旋轉期間寫入許多輸出檔案。 請注意,此情境可能會導致效能不佳,因此您應謹慎使用此功能。
    • 所有時間的計算都以GMT為單位。
    在變換時執行

    選填。每個檔案完成後,可執行外部(Windows)命令。 命令行從最終檔案名派生,方法是將以下轉義序列替換為此參數:

    • %dir%。 最終檔案名的目錄部分,包括尾端反斜線。
    • %file%。 最終檔案的檔案名(不包括目錄和副檔名)。
    • %ext%。 擴充功能(包括前導「。」) 檔案名的。
    • %路徑%. 檔案的完整路徑名,等同於%dir%file%%ext%。

    預設情況下,此參數為空(不執行任何命令)。

    記憶體限制

    選填。用於緩衝導出器輸出的記憶體量(以位元組為單位)。 預設值為10,000,000位元組。

    注意: 如果您有多個同時開啟的輸出檔案,則可能希望增加此值,但您可能會減少系統其他元件可用的記憶體量。 但是,降低此值可能會減緩匯出程式。 如需協助,請聯絡Adobe。

    開啟檔案限制

    選填。可同時開啟以從導出器輸出的最大檔案數。 如果超過此數目,事件記錄中會記錄錯誤,且Data Workbench伺服器會停止執行。 預設值為 1000。

  5. 在Transform.cfg檔案中定義匯出工具(並對其他參數進行變更)後,請將檔案儲存在本機,然後儲存至Data Workbench伺服器電腦上的適當設定檔。

本頁內容