将书签从 QlikView 迁移至 Qlik Cloud 租户

QlikView Object Migration for Cloud 是一种将服务器书签迁移到 Qlik Cloud 租户内托管空间中的 QlikView 应用程序的工具。

将 QlikView 文档添加到 Qlik Cloud 租户时不会纳入服务器书签。QlikView 可在 QlikView Server 上的 Active Directory 用户和 Qlik Cloud 租户中的用户之间分配书签的所有权。QlikView Object Migration for Cloud 映射这些用户，以便您可以为他们分配服务器书签的所有权。在迁移过程中，QlikView Object Migration for Cloud 与 Active Directory 服务联系，获取用户的 ID 和电子邮件地址信息，并通过电子邮件地址将他们链接到 Qlik Cloud 租户上的用户。您还可以手动映射用户，以便书签可以由其他用户拥有。书签存储在 QMT 文件中，然后迁移到 Qlik Cloud 租户中的应用程序中。

在您运行 QlikView Object Migration for Cloud 时，您：

1. 将带有书签的共享文件（.TShared 或 .Shared）复制到工作文件夹中。

2. 将文件名和元数据加载到工作文件夹中。

3. 选择一个共享文件，然后选择文件中的全部或部分书签。这些书签将导出到新的共享文件中。

4. 将所选共享文件上载到 Qlik Cloud 租户中的 QlikView 应用程序。

您可以使用 QlikView Object Migration for Cloud 随附的 QlikView 文档 CloudMigrationApp 迁移书签。CloudMigrationApp 管理用于迁移书签的脚本、文件和命令。您还可以使用命令提示符迁移书签以运行 QlikView Object Migration for Cloud 文件。

QlikView Object Migration for Cloud 可在 产品下载 中使用。

在开始之前

下载并运行 QlikView Object Migration for Cloud 之前，请确保满足以下要求：

• 您必须已经安装 QlikView Desktop。

• 您已向 Qlik Cloud 租户添加了要向其中添加共享服务器书签的 QlikView 文档。

• 您必须具有 专业授权 的用户。

• 您可以访问 Qlik Cloud 租户的 Administration 活动中心。

• 您必须在自己的 Qlik Cloud 租户中生成 API 秘钥以结合 QlikView Object Migration for Cloud 使用。

• 您必须在目标托管空间中具有以下权限之一：

  • 是所有者
  • 可查看
  • 可以贡献
  • 可管理

• 您必须具有书签目标 QlikView 应用程序的应用程序 ID。可以从应用程序 URL 中 document= 后面的字符串中获取应用程序 ID。

  例如在 QlikView 应用程序 URL https://example.qlik.com/opendoc.htm?document=e74ebae5-5659-4211-a4de-add8e49768f6 中，e74ebae5-5659-4211-a4de-add8e49768f6 是应用程序 ID。应用程序 ID 的格式可能略有不同，具体取决于它们是发布还是直接上传到 Qlik Cloud。

• QlikView Object Migration for Cloud 需要 Windows Active Directory 模块。如果未安装，则 QlikView Object Migration for Cloud 会自动安装它。

下载并设置 QlikView Object Migration for Cloud

执行以下操作：

1. 从 产品下载 下载 QlikView Object Migration for Cloud。

   有关更多信息，请参阅下载安装文件 （仅提供英文版本）。

2. 导航至 %ProgramData%\QlikTech。

3. 创建一个名为 QlikViewMigrationTool 的文件夹，并将 QlikView Object Migration for Cloud 文件复制到该文件夹中。

4. 可选择创建文件夹并添加包含要迁移到租户的书签的共享文件。

将书签迁移至带有 CloudMigrationApp 的 QlikView 应用程序

执行以下操作：

1. 导航到解压缩的 QlikView Object Migration for Cloud 文件夹并在 QlikView Desktop 中打开 CloudMigrationApp 文档。

2. 阅读并同意 QlikView Object Migration for Cloud 条款和条件。

3. 单击设置 > 用户首选项。

4. 在保存标签中，选择重新加载前保存。这将阻碍在重新加载后 QlikView 清除输入数据。

5. 在安全标签中，选择以下设置并单击确定：

   • 脚本（允许数据库写入和执行语句）

6. 按照 QlikView 文档中针对每个工作表的说明进行操作：

   1. 在 中 1. 初始化 ，选择存储共享文件的文件夹以及要输出上载到租户的副本的文件夹。

   2. 在 中 2. 获取用户数据，设置将共享书签的所有者与 Qlik Cloud 租户中的用户匹配所需的参数。

   3. 在 中 3. 查看用户映射文件，审核映射。

      可以选择编辑文件 OnPremToCloudMap.csv 中的映射。要将 QlikView 用户映射至 Qlik Cloud 用户，从 Qlik Cloud Administration 活动中心到 QlikView 用户条目为用户添加用户 ID 和 IdP 主题值。完成后，单击工作表中的重新加载。

   4. 在 中 4. 概述，验证是否已加载正确的文件。

   5. 在 中 5. 筛选元数据，可以选择使用筛选器缩小要迁移到租户的共享书签的范围。

   6. 在 中 6. 为云准备新的云的共享文件，从要迁移其书签的应用程序中选择共享文件。也可以选择要包括的书签的 ID。如果选择“无”，则将包括所有可用的书签。

   7. 在 中 7. 上传到云，在租户中设置目标应用程序并上传书签。

7. 重复步骤 5. 筛选元数据，6. 为云 和 准备新的共享文件7. 为您要将书签迁移到的每个附加应用程序上载到云。

8. 保存并关闭 CloudMigrationApp。

   CloudMigrationApp 保存已添加到应用程序的输入（在您保存它时）。

从命令提示符将书签迁移到 QlikView 应用程序

执行以下操作：

1. 以管理员身份打开命令提示符。

2. 导航至 QlikView Object Migration for Cloud 文件夹：: C:\ProgramData\QlikTech\QlikViewMigrationTool。

3. 输入以下命令将共享文件和元数据复制到输出文件夹：QMTMetaInfo.exe -InputFolder $(vInputFolder) -OutputFolder $(vOutputFolder)

   替换变量：

   • $(vInputFolder)：– 存储共享文件的文件夹的路径。

   • $(vOutputFolder)：要存储迁移文件的文件夹的路径。

4. 输入以下命令以从 Active Directory 获取用户数据：QMTGetADUser.exe -DCServer "$(vDCServer)" -ADUsersFile "$(vADOutputfile)"。

   替换以下变量：

   • $(vDCServer)：域控制器服务器 URL。

   • $(vADOutputfile)：用于存储 QlikView Server 用户列表的文件夹的文件路径，包括文件名和 .csv。

5. 输入以下命令以从 Qlik Cloud 租户获取用户数据：QMTGetUserInfo.exe -EndpointUri "$(vCloudURL)/api/v1/users" -ApiKey "$(vApiKey)" -CloudUsersFile "$(vUserIdMapLocation)"。

   替换以下变量：

   • $(vCloudURL)：您的 Qlik Cloud 租户的 URL。

   • $(vApiKey)。来自您的 Qlik Cloud 租户的 API 秘钥。

   • $(vUserIdMapLocation)：用于存储租户用户列表的文件夹的文件路径，包括文件名和 .csv。

6. 新建名为 OnPremToCloudMap.csv的 CSV 文件，该文件具有以下列：

   • Owner
   • subject
   • id

7. 在 OnPremToCloudMap.csv 中，从文件 <app>.qvw.tshared.xlsx 中的 Owner 列中添加值，该列出现在步骤 3 中的输出文件夹中，具有步骤 5 中创建的 .csv 中的相应主题和 id 值。

8. 创建一个新 CSV 文件，并从要迁移到 Qlik Cloud 租户的共享文件中添加书签 ID 的单列列表。您可以在文件 <app>.qvw.tshared.xlsx 中找到书签ID，出现在步骤 3 中的输出文件夹中。

9. 在命令提示符下，输入以下命令，创建包含书签的 QMT 文件，这些书签将上载到租户：QMTFilter.exe -SharedFile "$(OriginalSharedFile)" -IdFilterFile "$(csvFile)" -UserIdMappingFile "$(OnPremToCloudMap.csv)" -UpdatedFolder "$(Updated)" -ApiKey "$(vApiKey)"。

   替换以下变量：

   • $(OriginalSharedFile)：共享文件所在位置的完整路径，包括文件名。
   • $(csvFile)：包含书签 ID 的 CSV 文件的完整路径，包括文件名。
   • $(OnPremToCloudMap.csv)：OnPremToCloudMap.csv 的完整路径，包括文件名。
   • $(Updated)：存储 QMT 文件的文件夹的路径。
   • $(vApiKey)：来自您的 Qlik Cloud 租户的 API 秘钥。

10. 运行以下命令，替换变量：qlik_qv_export.exe -Mode migrate -CloudUrl "$(vCloudURL)" -AppId "$(vAppId)" -ApiKey "$(vApiKey)" -UploadPath "$(vSharedFileToUpload)" -HandledDirectory "$(vHandledDirectory)"。

    替换以下变量：

    • $(vCloudURL)：您的 Qlik Cloud 租户的 URL。

    • $(vAppId)：要将书签迁移到的应用程序的应用程序 ID。

    • $(vApiKey)：来自您的 Qlik Cloud 租户的 API 秘钥。

    • $(vSharedFileToUpload)：包含书签的 QMT 文件的完整路径，包括文件名。

    • $(vHandledDirectory)：QMT 文件迁移到云中后将存储该文件的文件夹的完整路径。

    信息注释显示一条消息：“写入 C:\ProgramData\QlikTech\QlikViewMigrationTool\qlik_qv_export_log.txt 的参数日志”。检查日志以确保迁移成功。

限制

QlikView Object Migration for Cloud 存在以下限制：

• QlikView Object Migration for Cloud 不支持将书签迁移到个人空间中的 QlikView 应用程序。您可以将书签迁移到共享空间中的 QlikView 应用程序，但用户无法使用它们。

• 输入或输出文件夹不支持 UNC 路径。支持映射到本地驱动器的共享文件夹。

• 工作表 上 XLSX 文件的数目 4. 与文件夹中的实际文件数相比，概述可能有所不同。这是因为空元数据文件在应用程序中不可见。

• 如果已从共享文件迁移书签，则必须先从处理过的目录中删除以前生成的文件，然后才能再次从该共享文件复制文件。

• 如果已从共享文件中迁移书签，则无法再次迁移书签（如果它们已在 Qlik Cloud 中共享）。