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
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: |
filePath |
Directorio donde están almacenados los artefactos en el sistema de archivos.
Ejemplo: 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 |
product |
Código de producto de la aplicación registrada con Shared Services.
Ejemplos:
|
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: |
type |
Tipos de conexiones:
|
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: |
filePath |
Directorio donde están almacenados los artefactos en el sistema de archivos.
Ejemplo: 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 |
product |
Código de producto de la aplicación registrada con Shared Services.
Ejemplos:
|
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: |
Artefacto
Filtro utilizado para la migración actual.
Tabla 7-3 Atributos de artefacto
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: Precaución: Si el directorio padre contiene un carácter de ampersand (&), reemplácelo por Notas: Si El atributo |
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 |
recursive |
Si la migración se debe realizar en los artefactos almacenados en los subdirectorios.
Ejemplo: Nota: El atributo |
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: |
value |
Valor utilizado para reemplazar el valor de opción definido en Shared Services Registry.
Ejemplo: |
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>