Como Trabalhar com Modelos

Melhor Prática

Se você estiver criando um aplicativo em um ambiente de teste e planejar transferi-lo para um ambiente de produção existente, o ideal é primeiro atualizar o ambiente de teste com um instantâneo atual do ambiente de produção e depois criar o aplicativo a ser transferido. Isso garantirá que os objetos globais, como propriedades e exibições, tenham os mesmos IDs nos dois ambientes.

Considerações

• Você deve ser um Administrador de Serviço ou ter a função granular Migrações - Administrar (consulte Noções Básicas sobre Permissões e Funções Granulares) a fim de importar e exportar aplicativos e dimensões para modelos.
• As exportações de aplicativos incluem aplicativos ou dimensões completos e todos os artefatos dependentes (como conexões globais). As exportações granulares incluem apenas os objetos de metadados selecionados e não incluem automaticamente todas as dependências. Ao usar exportações granulares, verifique se existem objetos dependentes obrigatórios no ambiente de destino ou se eles estão incluídos no modelo para evitar erros de importação.
• Quando um aplicativo é transferido para o ambiente de destino:
  • Se o proprietário do aplicativo existir nos ambientes de origem e de destino, ele será preservado como proprietário do aplicativo no ambiente de destino.
  • Se o proprietário do aplicativo no ambiente de origem não existir no ambiente de destino, um Administrador de Serviço deverá atribuir um proprietário ao aplicativo no ambiente de destino.
• Você pode transferir aplicativos, dimensões ou objetos de metadados suportados novos ou existentes. O processo de importação de modelo atualiza aplicativos, dimensões ou objetos de metadados existentes no ambiente de destino, criando objetos que ainda não existem e modificando objetos existentes. Consulte Atualização um Artefato Existente usando um Modelo.
• Só é possível transferir aplicativos ativos.
• Você poderá excluir objetos arquivados da cadeia de dados em importações de modelo se os objetos arquivados no ambiente de origem não existirem no ambiente de destino.

  Note:

  Os objetos dependentes em um objeto arquivado também serão excluídos da importação de modelo se eles não existirem no ambiente de destino. Se um objeto dependente for parcialmente excluído, ele aparecerá na importação ou na visualização do modelo com uma mensagem de aviso indicando que não foi possível importá-lo.

  Por exemplo, se você excluir uma dimensão arquivada, que não existe no ambiente de destino, durante a importação, os objetos (como associações de dimensão, tipos de nó, políticas e extrações) também serão excluídos da importação do modelo caso não existam no ambiente de destino.

• Você pode transferir aplicativos e dimensões em um único arquivo de modelo. Por exemplo, você pode selecionar um aplicativo GL e duas dimensões de um aplicativo do Planning. Observe, no entanto, que a seleção de um aplicativo incluirá automaticamente todas as dimensões desse aplicativo. Não é possível selecionar um aplicativo e, em seguida, selecionar apenas um subconjunto de dimensões desse aplicativo. Portanto, se o aplicativo GL tiver três dimensões, você poderá selecionar apenas duas dimensões. No entanto, se você selecionar o aplicativo inteiro, todas as três dimensões serão incluídas automaticamente.

  Tip:

  Se você tiver conversores de tipo de nó ou assinaturas em vários aplicativos, talvez seja útil transferir esses aplicativos e dimensões em um único arquivo de modelo. Por exemplo, se tiver uma assinatura entre um ponto de vista Conta em um aplicativo GL e um ponto de vista Conta em um aplicativo Planning, você poderá transferir, em um único arquivo de modelo, o aplicativo GL e a dimensão Conta no aplicativo Planning que contém o ponto de vista de assinatura.
• Quando você transfere dimensões, o aplicativo que contém a dimensão deve existir no ambiente de destino.
• Para transferir um aplicativo ou uma dimensão entre ambientes, os dois ambientes devem ser da mesma versão.
• Durante a importação de um modelo, se um usuário ou grupo existir nos ambientes de origem e de destino, as seguintes referências do usuário ou do grupo dos objetos associados serão importadas:
  • Permissões
  • Usuários e grupos da política
  • Destinatários da Inscrição
  • Exibir filtros para usuários e grupos

  Se um usuário ou grupo no ambiente de origem não existir no ambiente de destino, a referência do usuário ou grupo associada não será transferida. É exibida uma mensagem indicando os usuários ou grupos ausentes no ambiente de destino e os objetos associados que não foram importados.

• Tanto o aplicativo ou a dimensão de origem quanto o aplicativo ou a dimensão de destino devem existir no ambiente de destino para que seja possível importar assinaturas e conversores de tipo de nó. Transfira os aplicativos de origem e destino no mesmo arquivo de modelo, ou então assegure-se de importar o aplicativo ou a dimensão de origem para conversores e assinaturas primeiro, de modo que ao importar o aplicativo ou a dimensão de destino, os conversores e assinaturas sejam criados.
• Se estiver transferindo uma dimensão com propriedades que usam um tipo de dados de nó para referência a outras dimensões, essas dimensões de origem já deverão existir no sistema de destino. Se não existirem, transfira essas dimensões de origem primeiro ou use um modelo de aplicativo para transferir todas as dimensões no mesmo arquivo de modelo.
• Quando você importar os objetos globais a seguir, se o objeto já existir no ambiente de destino com o mesmo nome, mas com outro ID, o objeto de destino será renomeado no ambiente de destino para torná-lo exclusivo:
  • Propriedades
  • Exibições
  • Conjuntos de Pesquisas
  • Conexões Globais
• Depois de exportar um aplicativo ou uma dimensão para um modelo, você poderá revisar o conteúdo do arquivo do modelo em um visualizador de arquivos .json.

  Caution:

  Não é permitido editar manualmente o arquivo do modelo.