將書籤從 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 文件遷移書籤，CloudMigrationApp，並連同 用於雲端的 QlikView 物件遷移。CloudMigrationApp 管理指令碼、檔案和命令以遷移書籤。您也可以使用命令提示遷移書籤以執行 用於雲端的 QlikView 物件遷移 檔案。

用於雲端的 QlikView 物件遷移 可從 產品下載 使用。

開始之前

下載並執行 用於雲端的 QlikView 物件遷移 之前，請確認您符合下列要求：

• 您必須已安裝 QlikView Desktop。

• 您已新增要將共用伺服器書籤新增至 Qlik Cloud 租用戶的 QlikView 文件。

• 您必須有具有 專業權限 的使用者。

• 您具有 Qlik Cloud 租用戶的 管理主控台 存取權限。

• 您必須在 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 在格式上可能稍有不同，取決於是發佈至雲端中心或直接上傳至雲端中心。

• 用於雲端的 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 使用者，請將使用者的使用者 ID 和 IdP 主旨值從 Qlik Cloud 管理主控台 新增至 QlikView 使用者輸入項目。完成後，按一下工作表中的載入。

   4. 在 4. 概述中，確認您已上傳正確的檔案。

   5. 在 5. 篩選中繼資料中，選擇使用篩選條件縮小要遷移至租用戶的共用書籤範圍。

   6. 在 6. 為雲端準備新的共用檔案中，從要遷移其中書籤的應用程式選取共用檔案。也可以選擇選取要納入的書籤 ID。若您沒有選取，將會納入所有可用書籤。

   7. 在 7. 上傳至雲端中，設定租用戶中的目的地應用程式並上傳書籤。

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 中共用，就無法再次遷移。