Mettre à jour les propriétaires d'objets d'application
L'étape Update App Object Owners est chargée de la réaffectation de la titularité du contenu d'application privé dans Qlik Cloud suite à l'importation d'applications. Au cours de l'étape Import Applications, l'ensemble du contenu est importé sous l'identité de la clé API (compte de service), y compris les feuilles et les récits personnels. Cette étape corrige la titularité en fonction des métadonnées recueillies lors des phases précédentes de la migration.
Cette étape nécessite les métadonnées d'application générées lors de l'étape Export Applications.
L'étape Export Scope doit être configurée de manière appropriée pour inclure le contenu privé et communautaire, selon les besoins, en veillant à ce que le contenu exporté reflète le mappage de titularité souhaité pour une réaffectation réussie.
Le contenu d'application privé comprend les éléments suivants :
- Feuilles personnelles (feuilles privées)
- Favoris personnels (favoris privés)
- Récits personnels (récits privés)
- Feuilles communautaires
- Favoris de la communauté
- Récits communautaires
Fonctionnement du mappage de la titularité
La réaffectation de la titularité est basée sur les métadonnées d'objets d'application stockées dans le fichier AppObjectAppDescriptions.json généré lors de l'étape Export Applications. Ce fichier inclut des détails clés tels que le propriétaire de l'objet d'application source et l'ID d'application cible.
L'outil de migration utilise l'une des deux approches pour déterminer le mode de mappage des utilisateurs de l'environnement client-managed vers les utilisateurs de Qlik Cloud :
Approche 1 : avec un fichier de mappage des utilisateurs
- Exécutez l'étape Export Users avant cette étape.
- Ceci génère un fichier
userMappings.jsoncontenant les éléments suivants :- Source (client-managed)
UserId - Informations utilisateur Qlik Cloud cibles (
email,subject)
- Source (client-managed)
- Lors de l'opération Update App Object Owners, l'outil met en correspondance les propriétaires d'objets d'application dans les données exportées avec les utilisateurs de Qlik Cloud à l'aide du fichier de mappage.
Approche 2 : sans fichier de mappage des utilisateurs
Si l'étape Export Users n'est pas exécutée, l'outil tente de mettre en correspondance les utilisateurs en utilisant la logique de secours suivante :
- Comparaison de la valeur
UserDirectory\UserIdsource àsubjectQlik Cloud - Comparaison de la valeur
UserIdsource àsubjectQlik Cloud - Comparaison de la valeur
UserIdsource àemailQlik Cloud
Si aucune correspondance n'est trouvée à l'aide de ces méthodes, la réaffectation de l'objet d'application en question échouera et une entrée de journal sera créée.
Bonnes pratiques
- Incluez toujours les étapes Export Applications et Export Users dans votre flux de travail de migration lorsque la réaffectation de la titularité est nécessaire.
- Vérifiez l'exhaustivité et l'exactitude des fichiers
AppObjectAppDescriptions.jsonetuserMappings.jsonavant d'exécuter cette étape. - Vérifiez que les utilisateurs prévus existent dans Qlik Cloud avant d'exécuter cette étape afin d'assurer une réaffectation correcte.