メイン コンテンツをスキップする 補完的コンテンツへスキップ
Qlik リソース

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. 共有ファイルを 1 つ選択し、ファイル内のブックマークのすべてまたはサブセットを選択します。これらは新しい共有ファイルにエクスポートされます。

  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 がインストールされている必要があります。

  • 共有サーバーのブックマークを追加する QlikView ドキュメントを Qlik Cloud テナントに追加しました。

  • Professional 資格 のあるユーザーが必要です。

  • Qlik Cloud テナントで Administration アクティビティ センターにアクセスできます。

  • QlikView Object Migration for Cloud で使用するには、Qlik Cloud テナントで API キーを生成する必要があります。

  • 宛先の管理されているスペースには、以下のいずれかの権限が必要です。

    • 所有者
    • 閲覧可能
    • 寄与可能
    • 管理可能

  • ブックマークの宛先 QlikView アプリのアプリ ID が必要です。アプリ ID は、アプリ URL の document= に続く文字列から取得できます。

    例えば、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 Module が必要です。インストールされていない場合、QlikView Object Migration for Cloud は自動的にインストールします。

情報メモ共有ファイルが破損していると思われる場合は、ブックマークを移行する前に SharedFile クリーニング ツールを実行してください。

QlikView Object Migration for Cloud のダウンロードと設定

次の手順を実行します。

  1. 製品のダウンロード から QlikView Object Migration for Cloud をダウンロードします。

    詳しくは、インストール ファイルのダウンロード を参照してください。

  2. %ProgramData%\QlikTech に移動します。

  3. QlikViewMigrationTool という名前のフォルダを作成し、QlikView Object Migration for Cloud ファイルをそのフォルダにコピーします。

  4. 必要に応じて、フォルダを作成し、テナントに移行するブックマークを含む共有ファイルを追加します。

CloudMigrationApp を使用したブックマークの QlikView アプリへの移行

警告メモCloudMigrationApp のロード スクリプトを変更しないでください。

次の手順を実行します。

  1. 解凍した QlikView Object Migration for Cloud フォルダに移動し、QlikView Desktop で CloudMigrationApp ドキュメントを開きます。

  2. QlikView Object Migration for Cloud 契約条件を読んで同意してください。

  3. [設定] > [ユーザー設定] をクリックします。

  4. [保存] タブで、[リロード前に保存] を選択します。これにより、QlikView がリロード後に入力データをクリアするのを防ぎます。

  5. [セキュリティ] タブで、次の設定を選択し、[OK] をクリックします。

    • スクリプト (データベースの書き込みとステートメントの実行を許可する)

  6. 各シートの QlikView ドキュメントの指示に従ってください。

    1. 1 内。初期化、共有ファイルを保存するフォルダ、およびテナントにアップロードされたコピーを出力するフォルダを選択します。

    2. 2 内。ユーザー データの取得、共有ブックマークの所有者を Qlik Cloud テナント内のユーザーと照合するために必要なパラメータを設定します。

    3. 3 内。ユーザー マッピング ファイルの表示、マッピングを確認します。

      必要に応じて、ファイル OnPremToCloudMap.csv のマッピングを編集します。QlikView ユーザーを Qlik Cloud ユーザーにマップするには、ユーザーの [ユーザー ID] と [IdP サブジェクト] 値を Qlik Cloud Administration アクティビティ センターから QlikView ユーザー エントリに追加します。 完了したら、シートの [リロード] をクリックします。

    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): ファイル名と .csv を含む、QlikView Server ユーザーのリストを保存するためのフォルダへのファイル パス。

  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 (ステップ 3 の出力フォルダにある) の Owner 列の値を、ステップ 5 で作成した .csv の対応する件名と ID の値とともに追加します。

  8. 新しい CSV ファイルを作成し、Qlik Cloud テナントに移行する共有ファイルからブックマーク ID の単一列リストを追加します。ブックマーク ID は、ステップ 3 の出力フォルダにあるファイル <app>.qvw.tshared.xlsx にあります。

  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 パスは、入力フォルダまたは出力フォルダではサポートされていません。ローカル ドライブにマップされた共有フォルダがサポートされています。

  • シート 4 の XLSX ファイルの数。概要は、フォルダ内の実際のファイルの数とは異なる場合があります。これは、空のメタデータ ファイルがアプリに表示されないためです。

  • 共有ファイルからブックマークを既に移行している場合は、その共有ファイルからファイルをコピーする前に、以前に生成されたファイルを処理済みディレクトリから削除する必要があります。

  • ブックマークからすでにブックマークを移行した場合、Qlik Cloud で共有されているなら、これらをもう一度移行することはできません。

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。

こちらにフィードバックをお寄せください