Atualizar proprietários de objeto de aplicativo

A etapa Update App Object Owners é responsável por reatribuir a propriedade do conteúdo privado do aplicativo no Qlik Cloud seguindo a importação de aplicativos. Durante a etapa Import Applications, todo o conteúdo é importado sob a identidade da chave de API (conta de serviço), incluindo pastas e histórias pessoais. Esta etapa corrige a propriedade com base nos metadados coletados durante as fases anteriores da migração.

Esta etapa requer metadados do aplicativo gerados durante a etapa Export Applications.

O Export Scope deve ser configurado apropriadamente para incluir conteúdo privado e da comunidade conforme necessário, garantindo que o conteúdo exportado reflita o mapeamento de propriedade desejado para uma reatribuição bem-sucedida.

O conteúdo privado do aplicativo inclui:

• Pastas pessoais (pastas privadas)
• Favoritos pessoais (favoritos privados)
• Histórias pessoais (histórias privadas)
• Pastas da comunidade
• Marcadores da comunidade
• Histórias da comunidade

Como o mapeamento de propriedade funciona

A reatribuição de propriedade é baseada nos metadados do objeto do aplicativo armazenados no arquivo AppObjectAppDescriptions.json gerado durante a etapa Export Applications. Este arquivo inclui detalhes importantes, como o proprietário do objeto do aplicativo de origem e o ID do aplicativo de destino.

A ferramenta de migração usa uma de duas abordagens para determinar como os usuários do ambiente gerenciado pelo cliente mapeiam para os usuários no Qlik Cloud:

Abordagem 1: Com um arquivo de mapeamento de usuário

1. Execute a etapa Export Users antes desta etapa.
2. Isso gera um arquivo userMappings.json contendo:
   • Fonte (client-managed) UserId
   • Informações do usuário de destino do Qlik Cloud (email, subject)
3. Durante Update App Object Owners, a ferramenta mapeia os proprietários de objetos de aplicativo nos dados exportados para usuários no Qlik Cloud usando o arquivo de mapeamento.

Abordagem 2: Sem um arquivo de mapeamento de usuário

Se a etapa Export Users não for executada, a ferramenta tenta mapear usuários usando a seguinte lógica de fallback:

1. Compare o UserDirectory\UserId de origem com o subject do Qlik Cloud
2. Compare o UserId de origem com o subject do Qlik Cloud
3. Compare o UserId de origem com o email do Qlik Cloud

Se nenhuma correspondência for encontrada usando esses métodos, a reatribuição para esse objeto de aplicativo específico falhará e uma entrada de log será criada.

Melhores práticas

• Sempre inclua as etapas Export Applications e Export Users em seu fluxo de trabalho de migração quando a reatribuição de propriedade for necessária.
• Revise os arquivos AppObjectAppDescriptions.json e userMappings.json quanto à completude e acurácia antes de executar esta etapa.
• Valide que os usuários pretendidos existam no Qlik Cloud antes de executar esta etapa para garantir a reatribuição adequada.

Páginas relacionadas

• Exportar aplicativos
• Importar aplicativos
• Exportar usuários