指定擷取選項

擷取檢查程式的選項頁籤可讓您指定建立擷取檔案的選項 (例如檔案與資料格式)。

若要指定擷取選項，請執行下列動作：

  1. 在擷取檢查程式的選項頁籤中，按一下編輯。
  2. 選擇性：定義篩選參數。
    • 節點篩選：按一下定義表示式 定義表示式 以開啟表示式產生器，然後定義用來選取要擷取之節點的表示式。表示式必須傳回布林值，且只有篩選表示式為 True 的節點會包含在擷取中。請參閱使用表示式以定義自訂商業邏輯

      註：

      對於分代式擷取來說，「節點篩選」並不適用於祖代。
    • 祖代篩選 (僅限分代式擷取)：按一下定義表示式 定義表示式 以開啟表示式產生器，然後定義用來篩選要擷取之祖代節點的表示式。系統只會將其篩選表示式為 True 的祖代節點納入擷取。這可讓您減少分代式擷取的層級數，以便在階層有太多層級時，讓分代式擷取可以在較低的深度達到平衡。請參閱使用表示式以定義自訂商業邏輯

      選擇性：按一下 X 以移除節點或祖代表示式篩選。

    • 篩選邏輯 (僅適用於增量擷取)：選取要使用的篩選邏輯為包含篩選 (亦即只將符合篩選的節點包含在擷取中) 還是排除篩選 (從擷取排除符合篩選的節點)。
    • 重新連線父項 (不適用於連結擷取)：選取是否重新連線該擷取中的父項。請參閱重新連線擷取中的父項。

      註：

      對於分代式擷取來說，重新連線父項永遠都是啟用的，且無法變更。

    • 隱含排除共用節點 (僅適用於從階層視點擷取的內容，不適用於連結擷取)：選取是否排除階層中不同位置，但同一個父項下已經處理過的節點。請參閱瞭解共用節點。

      提示：

      在擷取位置資訊 (例如使用位置邏輯的祖代、繼承值或預設派生值) 時，您可能會希望不要排除隱含共用節點。

  3. 定義檔案格式選項：

    表格 30-3 檔案格式選項

    欄位 描述 範例
    分隔符號字元 (僅限文字檔類型擷取) 分隔文字字串的字元。從下列選項中進行選取：
    • 逗號
    • 空格鍵
    • Tab 鍵
    • 已指定：在分隔符號欄位中輸入分隔符號字元。您可以輸入多個分隔符號字元 (最多 10 個)。

      註：

      支援前置和後置空白字元。例如，在逗號分隔符號後面加入空格會導致擷取顯示 "A, B, C" 而不是 "A,B,C"。
    • 無 - 固定寬度 (僅適用於完整擷取)：使用固定欄寬而非分隔符號字元來格式化擷取輸出。請參閱擷取中的固定寬度輸出。
    		 逗號
    換列字元樣式 (僅限文字檔類型擷取) 前進到下一行的字元

    CR+LF (Windows)

    僅 CR (Mac)

    僅 LF (Linux)
    引號欄 (當「分隔符號字元」設為無 - 固定寬度時不適用) 需要引號字元的欄：
    • 無
    • 所有欄
    • 取決於值：(預設) 將包含特殊字元的欄加上引號字元，例如：
      • 分隔符號字元
      • 引號字元
      • 換列字元

    註：

    引號選項不會套用至自訂頁首和頁尾。
    		 無
    引號字元 用於表示引號欄的字元 單引號
    空值關鍵字 取代檔案中空值的關鍵字 空白
    定義空字串關鍵字 取代檔案中所定義空白值的關鍵字 無資料
    最上層節點關鍵字 階層中最上層節點的父項欄特性值要使用的關鍵字。

    如果未提供此欄位，則最上層節點的父項列會輸出空白值。

    		 Root
    樞紐分析分隔符號 僅適用於字串資料類型特性，用以分隔進行樞紐分析之字串的字元。選取值，或選取已指定並輸入分隔符號字元。您可以輸入多個字元作為分隔符號，最多 10 個，而且可以使用空白字元 (例如 Tab)。 逗號
    包含欄標頭記錄 在檔案開頭包含標頭記錄的指標 已選取
    包含自訂標頭 選取以包含自訂標頭記錄

    若選取，則輸入要包含的自訂頁首。您可以在自訂頁首中插入替代參數。請參閱下方的在自訂頁首和頁尾中使用替代參數。

    如果您同時使用產生的欄標頭記錄，請指定自訂標頭應放在產生的欄標頭前面或後面。

    		 BOF (檔案開頭指標)
    包括自訂頁尾 選取以包含自訂頁尾記錄

    若選取，輸入要包含的自訂頁尾。您可以在自訂頁尾中插入替代參數。請參閱下方的在自訂頁首和頁尾中使用替代參數。

    		 EOF (檔案結尾指標)
    節點類型遺漏特性時顯示空值 選取以指定如果正在擷取之節點的節點類型未使用特性，則該特性會輸出空值，而非應用程式置換繼承或預設值的設定值。

    如果已指定空值關鍵字，則會對特性輸出該關鍵字。

    		 已選取
  4. 定義資料格式選項：

    表格 30-4 資料格式選項

    欄位 描述 範例
    負號 表示負值的字元 括弧
    千分位分隔符號 分隔數字中千分位的字元 逗號
    小數分隔符號 分隔數字中小數的字元

    註：

    您無法對這兩個分隔符號使用相同的字元。當您對一個分隔符號選取某個字元，該字元就會針對另一個分隔符號從下拉功能表中移除。

    		 點
    布林值

    指定是否擷取布林特性的實際值、顯示值或指定值。

    註：

    如果您選取指定，請輸入代表 True 與 False 的值。您可以都輸入空白值。

    指定

    • 指定的 True 值：IC_INTERCOMPANY_YES
    • 指定的 False 值：
    允許值特性

    指定是否擷取允許值特性的實際值或顯示值。

    		 顯示
    時區

    擷取的時區

    		 UTC
    日期格式

    從下拉功能表中選取日期格式，或選取指定並輸入日期格式。

    註：

    請參閱日期格式符號。
    		 MM/dd/yyyy
    時間格式

    從下拉功能表中選取時間格式，或選取指定並輸入時間格式。

    註：

    範例日期/時間欄位顯示您所選取或指定的日期與時間格式。

    		 HH:mm:ss
  5. 按一下儲存。

註：

時區、日期格式及時間格式儲存在擷取層級。這表示不論執行擷取的使用者的地區設定為何，擷取中的時區與格式一律都相同。

擷取中的固定寬度輸出

在「分隔符號字元」欄位中選取無 - 固定寬度，以指定擷取應使用固定的欄寬而非分隔符號字元來決定擷取檔案中的欄 (僅適用於完整擷取)。

每個欄的寬度決定方式如下：

表格 30-5 依欄類型區分的欄寬

欄類型 寬度 (字元)
專用欄
常數 常數長度
擷取執行 ID 36
擷取時間戳記 根據擷取選項中的日期與時間格式
反轉的層級 4
記錄編號 8
使用者名稱 32
特性欄
布林值 根據特性資料類型顯示：
  • Y/N、T/F、1/0: 1
  • 是/否：3
  • True/False：5
日期 擷取選項中日期格式的長度上限
浮點 最大值的長度 (包含千分位分隔符號與小數位數 +1)。

如果沒有最大值，則長度會設為 16。
整數 最大值的長度 (包含千分位分隔符號)。

如果沒有最大值，則長度會設為 16。
清單 255
備忘錄 最大值的長度。

如果沒有最大值，則長度會設為 1024。
節點清單 255
節點 目標節點類型的 Core.Name 特性長度上限。

如果沒有最大值，則長度會設為 250。
數值字串 最大值的長度。

如果沒有最大值，則長度會設為 32。
序列 填補值的長度。

如果沒有填補值，則長度會設為 40。
字串 字串值的長度上限。

如果沒有長度上限，則長度會設為 1024。
時間戳記 「擷取選項」中日期與時間格式的長度上限，包含日期與時間之間的空格。

註：

長度短於固定欄寬的值會以空格字元填補。長度超過固定欄寬的值會被截斷。

在自訂頁首和頁尾中使用替代參數

您可以在自訂頁首和頁尾中輸入替代參數。當您執行擷取時，參數的值會插入擷取中。例如，如果您在自訂頁尾輸入 <%Date%>，則在執行擷取時，擷取執行日期會插入頁尾中。

提示：

替代參數不區分大小寫。

系統提供以下替代參數：

  • <%Date%>：根據擷取的時區和格式設定值傳回擷取執行日期。如果未設定時區，則使用 UTC。
  • <%ExtractName%>：傳回擷取的名稱。
  • <%FileName%>：傳回擷取檔案名稱。
  • <%Time%>：根據擷取的時區和格式設定值傳回擷取執行時間。如果未設定時區，則使用 UTC。
  • <%Timestamp%>：根據擷取的時區和格式設定值傳回擷取執行的日期和時間組合。
  • <%TimeLabelName%>：傳回與視點相關聯的時間標籤名稱。

    註：

    此參數僅適用於使用具有歷史時間標籤之時間標籤視點的擷取。若有可用的私人時間標籤，會將該時間標籤名稱插入擷取中。否則，會插入公用時間標籤名稱。
  • <%TimeLabelTimestamp%>：根據時區和格式的擷取設定值，傳回與視點相關聯之時間標籤的時間戳記。

    註：

    此參數僅適用於使用具有歷史時間標籤之時間標籤視點的擷取。若有可用的私人時間標籤，會將該時間標籤時間戳記插入擷取中。否則，會插入公用時間標籤時間戳記。
  • <%Username%>：傳回擷取執行者的使用者名稱。
  • <%UserFirstName%>：傳回擷取執行者的名字。
  • <%UserLastName%>：傳回擷取執行者的姓氏。
  • <%UserEmail%>：傳回擷取執行者的電子郵件地址。
  • <%RecordCount%>：傳回擷取的記錄數。此數目不包括記錄數中的頁首和頁尾列，但包括經過樞紐分析的列，以便它能與使用的最後一筆記錄數相符。

    註：

    此參數只適用於自訂頁尾列。您無法在自訂頁首中插入記錄數。
  • <%AppVersion%>：傳回 Oracle Fusion Cloud Enterprise Data Management 版次號碼 (例如，"Oracle EDM Cloud Release 25.09")。