Definindo um Plano de Migração

Para visualizar ou definir um plano de migração, navegue usando Admin >; Ferramentas de Implementação > Plano de Migração.

Use o portal Consulta de Plano de Migração para pesquisar um plano de migração existente. Assim que um plano de migração for selecionado, você será levado ao portal de manutenção para exibir e atualizar o registro selecionado.

Os pontos a seguir contêm informações sobre como definir as Instruções para um plano de migração.

A Sequência da Instrução identifica exclusivamente cada instrução. A recomendação é usar incrementos de 10 para permitir a inserção de outras instruções no futuro.

Selecione Principal para o primeiro Tipo de Instrução. Todos os planos de migração devem conter somente uma instrução primária. Todas as instruções subsequentes exigem um tipo de instrução Subordinada. Nesse caso, deve ser inserida a Sequência de Instrução-Pai. Esse número, usado para atualizar as relações definidas nos dados exportados, deve corresponder a um número de sequência de instrução em um nível mais alto na hierarquia.

A instrução Descrição fornece uma descrição comercial da instrução.

Selecione um Objeto de Negócios (ON) para definir o tipo de objeto do qual os dados serão obtidos.

Critérios Transversais são usados para definir o relacionamento entre cada um dos objetos em um plano de migração. O sistema fornece três opções para definir como o objeto-filho é conectado ao objeto-pai, de modo que o sistema saiba como passar de um objeto para outro. As opções de Tipo de Critério Transversal são Restrição, SQL e XPath. Os seguintes pontos explicam cada opção:

• Restrição permite a seleção de uma restrição de tabela que representa determinado relacionamento de registro com outro registro no sistema por meio de uma referência de chave externa definida nos metadados. Se a Restrição for selecionada, os seguintes campos adicionais serão ativados:

  • ID da Restrição é um identificador exclusivo da restrição. A pesquisa exibirá as restrições de tabela válidas para o objeto de manutenção do objeto de negócios da instrução e o objeto de manutenção do objeto de negócios da instrução-pai.

  • Proprietário da Restrição é usado para definir o proprietário da restrição. É preenchido automaticamente ao selecionar uma restrição de pesquisa.

• SQL permite que você especifique os critérios associados do SQL entre o objeto da instrução-pai e o objeto-filho nos Critérios Transversais de SQL. A sintaxe dos critérios transversais é uma cláusula WHERE (sem incluir a palavra WHERE). Ao referenciar um campo do objeto da instrução-pai, use a sintaxe #PARENT.TABLE_​NAME.FIELD_​NAME. Ao referenciar um campo do objeto da instrução atual, use a sintaxe #THIS.TABLE_​NAME.FIELD_​NAME. Por exemplo, a instrução a seguir é usada em um plano de migração para o Objeto de Negócios no qual a instrução-pai é o objeto de negócios e a instrução subordinada é usada para referenciar o Mapa da Interface do Usuário, referido como opção de objeto de negócios com o tipo de opção "F1DU":#PARENT.F1_​BUS_​OBJ_​OPT.BUS_​OBJ_​OPT_​FLG = 'F1DU' AND @trim(#THIS.F1_​MAP.MAP_​CD) = @trim(#PARENT.F1_​BUS_​OBJ_​OPT.BUS_​OBJ_​OPT_​VAL).

• A opção XPath permite que você aplique a sintaxe em uma expressão XPath referenciando elementos nos objetos de negócios referenciados das instruções. Ele é inserido nos Critérios Transversais do XPath. Por exemplo, a instrução de conjunto de mapas de exibição no exemplo de SQL mencionado acima seria escrita da seguinte forma em XPath: #this/mapCd = #parent/businessObjectOption/businessObjectOptionValue AND #parent/businessObjectOption/businessObjectOptionType = 'F1DU'. Essa técnica permite referências da chave externa que são mapeadas em uma coluna XML para servirem como referência.

  Observação: As expressões #parent podem acessar elementos armazenados em uma coluna XML e descritos usando mapXML e mdField. Contudo, as expressões #this devem referenciar campos disponíveis no objeto de negócios usando a referência mapField.

Definir o Próximo Plano de Migração possibilita indicar isso. Além de copiar o objeto definido na instrução, as instruções adicionais incluídas no plano de migração referenciado também serão incluídas em uma exportação.

A grade de Algoritmos contém algoritmos associados a cada instrução. Você deve definir o seguinte para cada algoritmo:

• Especifique o Evento do Sistema ao qual o algoritmo está associado (consulte a tabela a seguir para obter uma descrição de todos os possíveis eventos).
• Especifique a Sequência e o Algoritmo para cada evento do sistema. É possível definir a Sequência como 10, exceto se tiver um Evento do Sistema que tenha vários Algoritmos. Nesse caso, é necessário informar ao sistema a Seqüência na qual eles devem ser executados.