Uso de definiciones de migración

Creación de definiciones de migración

Los artefactos que se van a migrar deben definirse en una definición de migración. Tenga en cuenta lo siguiente acerca de las definiciones de migración:

Se crea una definición de migración en Consola de Servicios compartidos de Oracle Hyperion cuando se realiza una operación de exportación o de importación.
Al exportar artefactos, Oracle Hyperion Enterprise Performance Management System Lifecycle Management crea dos archivos XML, uno para la exportación y otro para la importación. Estos archivos XML se pueden utilizar para el archivo de definición de migración en Lifecycle Management Utility.
Cuando realiza una operación de exportación, el archivo MDF para la exportación y la importación correspondiente se crea automáticamente en la carpeta del sistema de archivos, debajo de la carpeta raíz.

Esquema XML para el archivo de definición de migración

En la siguiente ilustración se muestra la estructura de un esquema XML de la definición de la migración.

Figura 7-2 Esquema XML del archivo de definición de migración

Esta imagen es un esquema del esquema XML del archivo de definición de la migración.

Elementos del archivo de definición de la migración

En esta sección se describen los elementos y atributos empleados en el esquema XML para los archivos de definición de la migración.

Configuración regional

Define la configuración regional del servidor en el momento en que se crea el archivo de definición de migración. Todos los mensajes de error y de la consola se incluyen en esta configuración regional.

Usuario y contraseña

Define el nombre de usuario y la contraseña cifrada del usuario que ejecutará el archivo de definición de migración.

Tarea

Define las tareas que se deben llevar a cabo durante la migración. Una tarea definida en el archivo de definición de migración depende del origen, el destino y los artefactos que migrar. Como mínimo, cada tarea contiene el origen, el destino y las etiquetas de artefactos.

Cuando existen varios orígenes y destinos, se debe definir al menos una tarea para cada combinación de origen y destino. Por ejemplo, la extracción de artefactos al sistema de archivos se definiría como la tarea 1. La carga de los artefactos del sistema de archivos a una aplicación se definiría como la tarea 2.

Nota:

De forma predeterminada, después del error de una tarea, la utilidad continuará con la siguiente tarea. La validación de las conexiones de origen y objetivo de una tarea se realiza solo cuando se ejecuta la tarea y no antes de iniciar su ejecución.

La tarea contiene los siguientes elementos:

Origen

Define el origen para la migración. Es necesario definir un origen y un destino por cada tarea.

Tabla 7-1 Atributos de origen

Atributo	Descripción
`application`	Nombre con el que está registrada la aplicación. El nombre de la aplicación resulta visible en Shared Services Console. Ejemplo: `HPAPP1`
`filePath`	Directorio donde están almacenados los artefactos en el sistema de archivos. Ejemplo: `filePath="/Essbase.Sample.Basic"` Nota: cuando se genera un archivo MDF desde la interfaz de usuario, la ruta es relativa a la carpeta de trabajo. Si el archivo MDF no está en la carpeta de trabajo, utilice el argumento de la línea de comandos `-b` para utilizar la ruta base relativa a la ubicación en la que se ha establecido la ruta del sistema de archivos.
`product`	Código de producto de la aplicación registrada con Shared Services. Ejemplos: `HUB` (Servicios compartidos de Oracle Hyperion) `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`	Nombre del grupo de aplicaciones de Shared Services al que pertenece la aplicación. El nombre del proyecto resulta visible en Shared Services Console. Ejemplo: `DevPlan_Proj`
`type`	Tipos de conexiones: `FileSystem` para la conexión del sistema de archivos `Application` para la conexión de la aplicación registrada con Shared Services

Objetivo

Define el destino para la migración. Se debe definir un destino por cada tarea.

Tabla 7-2 Atributos de destino

Atributo	Descripción
`application`	Nombre con el que está registrada la aplicación. El nombre de la aplicación resulta visible en Shared Services Console. Ejemplo: `HPAPP1`
`filePath`	Directorio donde están almacenados los artefactos en el sistema de archivos. Ejemplo: `filePath="/Essbase.Sample.Basic"` Nota: cuando se genera un archivo MDF desde la interfaz de usuario, la ruta es relativa a la carpeta de trabajo. Si el archivo .MDF no está en la carpeta de trabajo, utilice el argumento de la línea de comandos `-b` para utilizar la ruta base relativa a la ubicación en la que se ha establecido la ruta del sistema de archivos.
`product`	Código de producto de la aplicación registrada con Shared Services. Ejemplos: `HUB` (Servicios compartidos) `ESBAPP` (Essbase) `HFM` (Financial Management) `HP` (Planning) `CALC` (Calculation Manager) `HPM` (Profitability and Cost Management)
`project`	Nombre del grupo de aplicaciones de Shared Services al que pertenece la aplicación. El nombre del proyecto resulta visible en Shared Services Console. Ejemplo: `DevHP_Proj`

Artefacto

Filtro utilizado para la migración actual.

Tabla 7-3 Atributos de artefacto

Atributo Descripción

Atributo	Descripción
`parentPath`	Directorio de nivel superior donde se almacenan el artefacto o los datos para la migración. Consulte los apéndices al final de esta guía para obtener información sobre las estructuras de los directorios de productos. Ejemplo: `/Data Analysis & Report Creation` Precaución: Si el directorio padre contiene un carácter de ampersand (&), reemplácelo por `"&"` en el archivo de definición de migración (consulte el ejemplo siguiente). Notas: Si `recursive="true"`, se importarán todos los artefactos contenidos en los subdirectorios que contenga este directorio. El atributo `pattern` es necesario para todos los productos.
`pattern`	Criterios de selección de artefactos. Especifique el nombre de un artefacto para su importación o utilice * (asterisco) para importar todos los artefactos que cumplan las condiciones de filtrado. Ejemplo: * Nota: El atributo `pattern` es necesario para todos los productos.
`recursive`	Si la migración se debe realizar en los artefactos almacenados en los subdirectorios. Ejemplo: `true` Nota: El atributo `recursive` es opcional.

parentPath

Directorio de nivel superior donde se almacenan el artefacto o los datos para la migración. Consulte los apéndices al final de esta guía para obtener información sobre las estructuras de los directorios de productos.

Ejemplo: /Data Analysis & Report Creation

Precaución: Si el directorio padre contiene un carácter de ampersand (&), reemplácelo por "&" en el archivo de definición de migración (consulte el ejemplo siguiente).

Notas:

Si recursive="true", se importarán todos los artefactos contenidos en los subdirectorios que contenga este directorio.

El atributo pattern es necesario para todos los productos.

pattern

Criterios de selección de artefactos.

Especifique el nombre de un artefacto para su importación o utilice * (asterisco) para importar todos los artefactos que cumplan las condiciones de filtrado.

Ejemplo: *

Nota: El atributo pattern es necesario para todos los productos.

recursive

Si la migración se debe realizar en los artefactos almacenados en los subdirectorios.

Ejemplo: true

Nota: El atributo recursive es opcional.

Opciones

Las opciones son específicas de los productos. Consulte los apéndices situados al final de esta guía para ver las opciones de importación y exportación que se pueden establecer. El origen o el destino interpretan las opciones para identificar los artefactos que se migrarán.

Si no se establecen opciones, se utilizan las predeterminadas establecidas en Servicios compartidos de Oracle Hyperion Registry.

Tabla 7-4 Atributos de opciones

Atributo	Descripción
`option`	Nombre utilizado para reemplazar el nombre de opción definido en Shared Services Registry. Ejemplo: `ExportJobOutput`
`value`	Valor utilizado para reemplazar el valor de opción definido en Shared Services Registry. Ejemplo: `true`

Archivo de definición de migración de ejemplo

El siguiente es un ejemplo de un archivo de definición de migración. Cualquier cambio en la estructura o sintaxis produce errores durante la migración.

<?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>