使用移轉定義

建立移轉定義

要移轉的人工因素必須在移轉定義中定義。請注意以下關於移轉定義：

  • 當您執行匯出或匯入作業時，就會有移轉定義在 Oracle Hyperion Shared Services Console 中建立。

  • 當您匯出人工因素時，Oracle Hyperion Enterprise Performance Management System 生命週期管理會建立兩個 XML 檔案，一個用於匯出，一個用於匯入。這些 XML 檔案可用於「生命週期管理公用程式」中的移轉定義檔案。

  • 當您執行匯出作業時，用於該匯出和對應匯入的 MDF 檔會自動於根資料夾下的「檔案系統」資料夾中建立。

移轉定義檔案的 XML 架構

以下圖例描述移轉定義的 XML 架構大綱。

圖 7-2 移轉定義檔的 XML 架構大綱


此影像是移轉定義檔的 XML 架構大綱。

移轉定義檔案元素

本節說明移轉定義檔案之 XML 架構中使用的元素與屬性：

地區設定

在建立移轉定義檔案時定義伺服器語言環境。所有錯誤訊息和主控台訊息均包含在此語言環境中。

使用者和密碼

針對將執行移轉定義檔案的使用者定義使用者名稱和加密密碼。

工作

定義移轉期間需完成的工作。移轉定義檔案中所定義的工作取決於來源、目標及要移轉的人工因素。每個工作都至少會包含來源、目標及人工因素標籤。

如有多個來源及目標，則至少須針對每個來源與目標組合必須定義一項工作。例如可將人工因素解壓縮至檔案系統定義為工作 1；將人工因素從檔案系統載入應用程式定義為工作 2。

註：

根據預設，工作執行失敗之後，該公用程式會繼續執行下一個工作。工作的來源和目標連線等驗證僅會在工作執行時執行，不會在工作執行前執行。

工作包含以下元素：

來源

定義移轉的來源。每項工作皆必須定義一個來源及一個目標。

表格 7-1 來源屬性

屬性 說明
application 應用程式的註冊名稱。此名稱會顯示在 Shared Services Console 中。

範例：HPAPP1
filePath 人工因素在檔案系統中的儲存目錄。

範例：filePath="/Essbase.Sample.Basic"

注意：當從 UI 中產生 MDF 檔案時，路徑會是工作資料夾的相對路徑。如果 MDF 檔案不在作用中的資料夾，請使用 -b 命令行引數以使用相對於所設定之檔案系統路徑的基礎路徑。
product 向 Shared Services 註冊之應用程式的產品代碼。

範例：

  • HUB (Oracle Hyperion Shared Services)

  • CALC (Oracle Hyperion Calculation Manager)

  • ESBAPP (Oracle Essbase)

  • BPM (Oracle Essbase Studio)

  • AIF (Oracle Hyperion Financial Data Quality Management, Enterprise Edition)

  • HFM (Oracle Hyperion Financial Management)

  • FCC (Oracle Hyperion Financial Close Management)

  • HP (Oracle Hyperion Planning)

  • HPM (Oracle Hyperion Profitability and Cost Management)
project 應用程式隸屬之 Shared Services 應用程式群組的名稱。此名稱會顯示在 Shared Services Console 中。

範例：DevPlan_Proj
type 連線類型：

  • 適用於檔案系統連線的 FileSystem

  • 適用於已在 Shared Services 上註冊之應用程式連線的 Application

目標

定義移轉的目標。每項工作皆須定義一個目標。

表格 7-2 目標屬性

屬性 說明
application 應用程式的註冊名稱。此名稱會顯示在 Shared Services Console 中。

範例：HPAPP1
filePath 人工因素在檔案系統中的儲存目錄。

範例：filePath="/Essbase.Sample.Basic"

注意：當從 UI 中產生 MDF 檔案時，路徑會是工作資料夾的相對路徑。如果 .MDF 檔案不在作用中的資料夾，請使用 -b 命令行引數以使用相對於所設定之檔案系統路徑的基礎路徑。
product 向 Shared Services 註冊之應用程式的產品代碼。

範例：

  • HUB (Shared Services)

  • ESBAPP (Essbase)

  • HFM (Financial Management)

  • HP (Planning)

  • CALC (Calculation Manager)

  • HPM (Profitability and Cost Management)
project 應用程式隸屬之 Shared Services 應用程式群組的名稱。此名稱會顯示在 Shared Services Console 中。

範例：DevHP_Proj

人工因素

用於目前移轉作業中的篩選條件。

表格 7-3 人工因素屬性

屬性 說明
parentPath 儲存移轉作業之人工因素或資料的最上層目錄。若要取得產生目錄結構的相關資訊，請參閱本指南最後之附錄。

範例： /Data Analysis & Report Creation

警告：如果父項路徑目錄中有 & 字元，請在移轉定義檔中將該字元替換成"&"(請參閱下方的範例)。

注意：

如果 recursive="true"，即會匯入此目錄之子目錄內所含的所有人工因素。

所有產品皆須具備 pattern 屬性。
pattern 選取人工因素的準則。

指定要匯入的人工因素名稱，或使用 * (星號) 來匯入所有符合篩選條件的人工因素。

範例：*

注意：所有產品都需要使用 pattern 屬性。
recursive 是否應對儲存在子目錄的人工因素執行移轉作業。

範例：true

注意：recursive 屬性是可省略的。

選項

選項是因產品而異的。請參閱本指南末頁的附錄，瞭解您所能設定的匯入與匯出選項。來源或目標會轉譯選項，進而得知所要移轉的人工因素。

如果您沒有設定選項，系統會使用在 Oracle Hyperion Shared Services Registry 中設定的預設選項。

表格 7-4 選項屬性

屬性 說明
option 用來覆寫在 Shared Services Registry 中定義之選項名稱的名稱。

範例： ExportJobOutput
value 用來覆寫在 Shared Services Registry 中定義之選項值的值。

範例：true

移轉定義檔案的範例

以下為移轉定義檔案的範例。任何結構或語法上的變更會造成在移轉期間發生錯誤。

<?xml version="1.0" encoding="UTF-8"?>
<Package>
<LOCALE>en_US</LOCALE>
<User name="admin" password=""/>
   <Task>
      <Source type="Application" product="HUB" project="Foundation" application="Shared Services"/>
      <Target type="FileSystem" filePath="/folder/HUB.Shared Services" />
      <Options option="GroupFilter" Value= "*" />
      <Artifact recursive="true" parentPath="/Native Directory" pattern="*"/>
      <Artifact recursive="true" parentPath="/Taskflows" pattern="*"/>
   </Task>
   <Task>
      <Source type="FileSystem" filePath="/folder/HUB.Shared Services" />
      <Target type="Application" product="HUB" project="Foundation" application="Shared Services" />
      <Artifact recursive="true" parentPath="/Native Directory" pattern="*"/>
      <Artifact recursive="true" parentPath="/Taskflows" pattern="*"/>
           </Task>
</Package>