使用迁移定义

创建迁移定义

必须在迁移定义中定义要迁移的对象。请注意以下有关迁移定义的事项：

  • 在执行导出或导入操作时，会在 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"

注：如果 MDF 文件是从 UI 生成的，则此路径是相对于工作文件夹的相对路径。如果 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"

注：如果 MDF 文件是从 UI 生成的，则此路径是相对于工作文件夹的相对路径。如果 .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>