Update App Object Owners

The Update App Object Owners step is responsible for reassigning ownership of private app content in Qlik Cloud following the import of applications. During the Import Applications step, all content is brought in under the identity of the API key (service account), including personal sheets and stories. This step corrects ownership based on metadata gathered during earlier phases of the migration.

此步骤需要Export Applications步骤期间生成的应用程序元数据。

Export Scope必须进行适当设置，以根据需要包含私有内容和社区内容，确保导出的内容反映所需的拥有权映射，以便成功重新分配。

私有应用程序内容包括：

• 个人工作表（私有工作表）
• 个人书签（私有书签）
• 个人故事（私人故事）
• 社区工作表
• 社区书签
• 社区故事

所有权映射如何运作

所有权重新分配基于在Export Applications步骤期间生成的AppObjectAppDescriptions.json文件中存储的应用程序对象元数据。此文件包含关键详细信息，例如源应用程序对象的拥有者和目标应用程序 ID。

迁移工具使用两种方法之一来确定客户端管理环境中的用户如何映射到 Qlik Cloud 中的用户：

方法 1：使用用户映射文件

1. 在此步骤之前运行 Export Users 步骤。
2. 这将生成一个包含以下内容的 userMappings.json 文件：
   • 源 (客户端托管) UserId
   • 目标 Qlik Cloud 用户信息 (email, subject)
3. 在 Update App Object Owners 期间，该工具使用映射文件将导出的数据中的应用程序对象所有者匹配到 Qlik Cloud 中的用户。

方法 2：不使用用户映射文件

如果未运行 Export Users 步骤，该工具会尝试使用以下回退逻辑匹配用户：

1. 将源 UserDirectory\UserId 与 Qlik Cloud subject 进行比较
2. 将源 UserId 与 Qlik Cloud subject 进行比较
3. 将源 UserId 与 Qlik Cloud email 进行比较

如果使用这些方法未找到匹配项，则该特定应用程序对象的重新分配将失败，并会创建一条日志条目。

最佳实践

• 当需要重新分配所有权时，请务必在迁移工作流中包含 Export Applications 和 Export Users 步骤。
• 在运行此步骤之前，请审查AppObjectAppDescriptions.json和userMappings.json文件以确保完整性和准确度。
• 在运行此步骤之前，请验证目标用户存在于 Qlik Cloud 中，以确保正确重新分配。

相关页面

• 导出应用程序
• 导入应用程序
• 导出用户