アプリ オブジェクト所有者の更新
Update App Object Owners ステップは、アプリケーションのインポート後に、Qlik Cloud 内のプライベート アプリケーション コンテンツの所有権を再割り当てする役割を担います。Import Applications ステップでは、個人用シートやストーリーを含め、すべてのコンテンツが API キー (サービスアカウント) の ID で取り込まれます。このステップは、移行の初期段階で収集されたメタデータに基づいて所有権を修正します。
このステップには、Export Applications ステップ中に生成されたアプリのメタデータが必要です。
Export Scope は、必要に応じてプライベート コンテンツとコミュニティ コンテンツを含めるように適切に設定されている必要があります。これにより、エクスポートされたコンテンツが、再割り当てを正常に行うために必要な所有権マッピングを反映するようになります。
プライベート アプリ コンテンツには次が含まれます。
- 個人用シート (プライベート シート)
- 個人用ブックマーク (プライベート ブックマーク)
- 個人用ストーリー (プライベート ストーリー)
- コミュニティ シート
- コミュニティ ブックマーク
- コミュニティ ストーリー
所有権マッピングの仕組み
所有権の再割り当ては、Export Applications ステップで生成される AppObjectAppDescriptions.json ファイルに保存されているアプリ オブジェクトのメタデータに基づいています。このファイルには、ソース アプリ オブジェクトの所有者やターゲット アプリ ID などの重要な詳細が含まれています。
移行ツールは、クライアント管理環境のユーザーを Qlik Cloud のユーザーにマッピングするために、次の 2 つの方法のいずれかを使用します。
アプローチ 1: ユーザー マッピング ファイルを使用する場合
- このステップの前に Export Users ステップを実行します。
- これにより、次の内容を含む
userMappings.jsonファイルが生成されます。- ソース (Client-Managed)
UserId - ターゲット Qlik Cloud ユーザー情報 (
email、subject)
- ソース (Client-Managed)
- Update App Object Owners の実行中、ツールはエクスポートされたデータ内のアプリケーション オブジェクトの所有者を、マッピング ファイルを使用して Qlik Cloud のユーザーと照合します。
アプローチ 2：ユーザー マッピング ファイルを使用しない場合
Export Users ステップが実行されない場合、ツールは次のフォールバック ロジックを使用してユーザーを照合しようとします。
- ソースの
UserDirectory\UserIdを Qlik Cloud のsubjectと比較します - ソースの
UserIdを Qlik Cloud のsubjectと比較します - ソースの
UserIdを Qlik Cloud のemailと比較します
これらの方法を使用しても一致が見つからない場合、その特定のアプリ オブジェクトの再割り当ては失敗し、ログ エントリが作成されます。
ベスト プラクティス
- 所有権の再割り当てが必要な場合は、移行ワークフローに Export Applications と Export Users のステップを必ず含めてください。
- このステップを実行する前に、
AppObjectAppDescriptions.jsonおよびuserMappings.jsonファイルの完全性と正確性を確認してください。 - 適切な再割り当てを確実にするために、このステップを実行する前に、意図するユーザーが Qlik Cloud に存在するかどうかを確認してください。