# 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](https://help.qlik.com/pt-BR/migration/Content/AnalyticsMigrationTool/Managing-Migration-Steps/Applications/Export-Applications.htm)
* [Importar aplicativos](https://help.qlik.com/pt-BR/migration/Content/AnalyticsMigrationTool/Managing-Migration-Steps/Applications/Import-Applications.htm)
* [Exportar usuários](https://help.qlik.com/pt-BR/migration/Content/AnalyticsMigrationTool/Managing-Migration-Steps/Users/Export-Users.htm)