Como Trabalhar com Definições de Migração

Criação de Definições de Migração

Os artefatos a serem migrados devem ser configurados em uma definição de migração. Observe o seguinte sobre definições de migração:

Uma definição de migração será criada no Oracle Hyperion Shared Services Console quando você executar uma operação de exportação ou importação.
Quando você exporta artefatos, o Oracle Hyperion Enterprise Performance Management System Lifecycle Management cria dois arquivos XML, um para exportação e outro para importação. Esses arquivos XML podem ser usados para o arquivo de definição de migração no Utilitário Lifecycle Management.
Quando você executar uma operação de exportação, o arquivo MDF para essa exportação e para a importação correspondente será criado automaticamente na pasta do Sistema de Arquivos abaixo da raiz.

Esquema XML do Arquivo de Definição de Migração

A ilustração a seguir mostra um outline do esquema XML da definição de migração.

Figura 7-2 Outline de Esquema XML do Arquivo de Definição de Migração

Essa imagem é um outline de esquema XML do arquivo de definição de migração.

Elementos do Arquivo de Definição de Migração

Esta seção descreve os elementos e atributos usados no esquema XML dos arquivos de definição de migração.

Localidade

Define a configuração regional do servidor no momento da criação do arquivo de definição de migração. Todas as mensagens de erro e mensagens de console são incluídas nessa configuração regional.

Usuário e Senha

Define o nome de usuário e a senha criptografada do usuário que executará o arquivo de definição de migração.

Tarefa

Define as tarefas a serem concluídas durante a migração. Uma tarefa definida no arquivo de definição de migração depende da origem, do destino e dos artefatos para migrar. No mínimo, cada tarefa contém tags de origem, destino e artefato.

Para várias origens e destinos, é necessário definir pelo menos uma tarefa para cada combinação de origem-destino. Por exemplo, a·extração de artefatos para o sistema de arquivos poderia ser definida como tarefa 1. O carregamento de artefatos do sistema de arquivos para um aplicativo poderia ser definido como tarefa 2.

Nota:

Por padrão, após uma tarefa com falha, o utilitário continua na próxima tarefa. A validação das conexões de origem e destino de uma tarefa são realizadas apenas quando a tarefa é executada e não antes do início da execução da tarefa.

A tarefa contém estes elementos:

Origem

Define a origem da migração. É necessário definir uma origem e um destino por tarefa.

Tabela 7-1 Atributos de Origem

Atributo	Descrição
`application`	Nome com o qual o aplicativo é registrado. O nome do aplicativo·é visível no Shared Services Console. Exemplo: `HPAPP1`
`filePath`	Diretório em que os artefatos são armazenados no sistema de arquivos. Exemplo: `filePath="/Essbase.Sample.Basic"` Observação: Quando um arquivo MDF é gerado a partir da Interface do Usuário, o caminho é um caminho relativo para a pasta de trabalho. Se o arquivo MDF não estiver na pasta de trabalho, use o argumento de linha de comando `-b` para usar o caminho base relativo ao local para onde o caminho do sistema de arquivos está definido.
`product`	Código do produto para o aplicativo registrado com Shared Services. Exemplos: `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`	Nome do Grupo de Aplicativos do Shared Services ao qual o aplicativo pertence. O nome do projeto é visível no Shared Services Console. Exemplo: `DevPlan_Proj`
`type`	Tipos de conexão: `FileSystem` para conexão do sistema de arquivos `Application` para conexão do aplicativo registrado com o·Shared Services

Destino

Define o destino da migração. É necessário definir um destino por tarefa.

Tabela 7-2 Atributos de Destino

Atributo	Descrição
`application`	Nome com o qual o aplicativo é registrado. O nome do aplicativo·é visível no Shared Services Console. Exemplo: `HPAPP1`
`filePath`	Diretório em que os artefatos são armazenados no sistema de arquivos. Exemplo: `filePath="/Essbase.Sample.Basic"` Observação: Quando um arquivo MDF é gerado a partir da Interface do Usuário, o caminho é um caminho relativo para a pasta de trabalho. Se o arquivo .MDF não estiver na pasta de trabalho, use o argumento de linha de comando `-b` para usar o caminho base relativo ao local para onde o caminho do sistema de arquivos está definido.
`product`	Código do produto para o aplicativo registrado com Shared Services. Exemplos: `HUB` (Shared Services) `ESBAPP` (Essbase) `HFM` (Financial Management) `HP` (Planning) `CALC` (Calculation Manager) `HPM` (Profitability and Cost Management)
`project`	Nome do Grupo de Aplicativos do Shared Services ao qual o aplicativo pertence. O nome do projeto é visível no Shared Services Console. Exemplo: `DevHP_Proj`

Artefato

Filtro usado para a migração atual.

Tabela 7-3 Atributos de Artefato

Atributo Descrição

Atributo	Descrição
`parentPath`	O diretório de nível superior onde o artefato ou os dados da migração são armazenados. Consulte os apêndices no final deste guia para obter informações sobre a estrutura de diretórios usada do produto. Exemplo: `/Data Analysis & Report Creation` Cuidado: Se o diretório do caminho pai contiver um caractere &, substitua-o por `"&"` no arquivo de definição de migração (veja o exemplo abaixo). Observações: Se·`recursive="true"`, todos os artefatos contidos nos subdiretórios nesse diretório serão importados. O atributo `pattern` é obrigatório para todos os produtos.
`pattern`	Critérios de seleção do artefato. Especifique o nome de um artefato para importar ou use um * (asterisco) para importar todos os artefatos que correspondem às condições do filtro. Exemplo: * Observação: O atributo `pattern` é necessário para todos os produtos.
`recursive`	Se a migração deve ser executada em artefatos armazenados em subdiretórios. Exemplo: `true` Observação: O atributo `recursive` é opcional.

parentPath

O diretório de nível superior onde o artefato ou os dados da migração são armazenados. Consulte os apêndices no final deste guia para obter informações sobre a estrutura de diretórios usada do produto.

Exemplo: /Data Analysis & Report Creation

Cuidado: Se o diretório do caminho pai contiver um caractere &, substitua-o por "&" no arquivo de definição de migração (veja o exemplo abaixo).

Observações:

Se·recursive="true", todos os artefatos contidos nos subdiretórios nesse diretório serão importados.

O atributo pattern é obrigatório para todos os produtos.

pattern

Critérios de seleção do artefato.

Especifique o nome de um artefato para importar ou use um * (asterisco) para importar todos os artefatos que correspondem às condições do filtro.

Exemplo: *

Observação: O atributo pattern é necessário para todos os produtos.

recursive

Se a migração deve ser executada em artefatos armazenados em subdiretórios.

Exemplo: true

Observação: O atributo recursive é opcional.

Opções

As opções são específicas ao produto. Consulte os apêndices no final deste guia para obter as opções de importação e exportação que podem ser definidas. A origem ou o destino interpreta as opções para compreender os artefatos sendo migrados.

Se as opções não forem definidas, as opções padrão definidas no Oracle Hyperion Shared Services Registry serão usadas.

Tabela 7-4 Atributos de Opções

Atributo	Descrição
`option`	Nomes usados para substituir o nome da opção definido no Shared Services Registry. Exemplo: `ExportJobOutput`
`value`	Valor usado para substituir o nome da opção definido no Shared Services Registry. Exemplo: `true`

Exemplo de Arquivo de Definição de Migração

A seguir, um exemplo de arquivo de definição de migração. Qualquer alteração na estrutura ou sintaxe resultará em erros durante a migração.

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