QlikView から Qlik Cloud のテナントへのブックマークの移行 | Qlik Cloud ヘルプ
メイン コンテンツをスキップする 補完的コンテンツへスキップ

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

  4. 選択した共有ファイルを Qlik Cloud テナントの QlikView アプリケーションにアップロードします。

QlikView ブックマーク移行ツール に含まれている QlikView ドキュメント CloudMigrationApp を使用してブックマークを移行できます。CloudMigrationApp は、ブックマークを移行するためのスクリプト、ファイル、コマンドを管理します。[コマンド プロンプト] を使用してブックマークを移行し、QlikView ブックマーク移行ツール ファイルを実行することもできます。

QlikView ブックマーク移行ツール製品のダウンロード から利用できるようになります。

開始する前に

QlikView ブックマーク移行ツール をダウンロードして実行する前に、次の要件を満たしていることを確認してください。

  • QlikView Desktop がインストールされている必要があります。

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

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

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

  • QlikView ブックマーク移行ツール で使用するには、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 ブックマーク移行ツール には Windows Active Directory Module が必要です。インストールされていない場合、QlikView ブックマーク移行ツール は自動的にインストールします。

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

QlikView ブックマーク移行ツール のダウンロードと設定

次の手順を実行します。

  1. 製品のダウンロード から QlikView ブックマーク移行ツール をダウンロードします。

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

  2. %ProgramData%\QlikTech に移動します。
  3. QlikViewMigrationTool という名前のフォルダを作成し、QlikView ブックマーク移行ツール ファイルをそのフォルダにコピーします。

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

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

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

次の手順を実行します。

  1. 解凍した QlikView ブックマーク移行ツール フォルダに移動し、QlikView DesktopCloudMigrationApp ドキュメントを開きます。

  2. QlikView ブックマーク移行ツール 契約条件を読んで同意してください。

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

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

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

    • スクリプト (データベースの書き込みとステートメントの実行を許可する)
  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): ファイル名と .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 ブックマーク移行ツール には次の制限事項があります。

  • QlikView ブックマーク移行ツール は、個人スペースの QlikView アプリケーションへのブックマークの移行をサポートしていません。ブックマークは共有スペースの QlikView アプリケーションに移行できますが、ユーザーは利用できません。
  • UNC パスは、入力フォルダまたは出力フォルダではサポートされていません。ローカル ドライブにマップされた共有フォルダがサポートされています。

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

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

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

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

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