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

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

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

在您运行 QlikView 书签迁移工具 时，您：

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

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

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

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

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

QlikView 书签迁移工具 可在 产品下载 中使用。

在开始之前

下载并运行 QlikView 书签迁移工具 之前，请确保满足以下要求：

• 您必须已经安装 QlikView Desktop。

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

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

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

• 您必须在自己的 Qlik Cloud 租户中生成 API 秘钥以结合 QlikView 书签迁移工具 使用。

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

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

• 您必须具有书签的目标 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 书签迁移工具 需要 Windows Active Directory 模块。如果未安装，则 QlikView 书签迁移工具 会自动安装它。

下载并设置 QlikView 书签迁移工具

执行以下操作：

1. 从 产品下载 下载 QlikView 书签迁移工具。

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

2. 导航至 %ProgramData%\QlikTech。

3. 创建一个名为 QlikViewMigrationTool 的文件夹，并将 QlikView 书签迁移工具 文件复制到该文件夹中。

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

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

执行以下操作：

1. 导航到解压缩的 QlikView 书签迁移工具 文件夹并在 QlikView Desktop 中打开 CloudMigrationApp 文档。

2. 阅读并同意 QlikView 书签迁移工具 条款和条件。

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. 为 Cloud 准备新的共享文件，从要迁移其书签的应用程序中选择共享文件。也可以选择要包括的书签的 ID。如果选择“无”，则将包括所有可用的书签。

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

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

8. 保存并关闭 CloudMigrationApp。

   CloudMigrationApp 会保留您保存应用程序时已添加到其中的输入。

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

执行以下操作：

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

2. 导航至 QlikView 书签迁移工具 文件夹：: 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 书签迁移工具 存在以下限制：

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

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

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

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

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