# 管理スペースでのアプリケーション内レポート 厳格なデータ ガバナンスを必要とするアプリケーションのアプリケーション内レポートを構成できます。管理スペースで使用するアプリケーション データ モデルの開発と同じ原則を使用して、アプリケーション内のレポート機能用にアプリケーションを準備できます。これは、ロード スクリプトでスペースを認識する構文を使用することで実現されます。 [Tabular Reporting in managed spaces](https://play.vidyard.com/YenL58RxsRDZtHKDebJsaL) 管理スペースに公開する準備としてアプリケーションを開発する場合は、次の点を考慮してください。 * アプリの公開前または公開後に、 [テンプレート] を開発できます。公開前にテンプレートを作成した場合は、公開後に接続先のアプリケーションを変更してください。 * アプリケーションを公開する前に、配信リストをアプリケーションに追加する必要があります。 開発中は、実際のデータ ソースではなくモック データ ソースで構成できます。配布リスト内のソースはロード スクリプトで参照されるため、スクリプトは、スペースを認識する構文を使用して、公開の準備として記述する必要があります。配布リストをソース ファイルとしてアップロードする場合、この構文は既定で自動的に使用されます。 * 公開後、レポート アセット (テンプレート、フィルター、レポート タスク) は、公開されたアプリケーションのレポート ユース ケースに基づいて、必要に応じて再作成できます。 配布リストで使用される実際のデータ ソースは、管理スペースに追加する必要があります。 ## 既存のレポートの構成 2024 年 3 月 26 日以前にレポート構成と配布リストを作成した場合は、配布リストのファイル アップロード プロセスの変更に注意する必要があります。 2024 年 3 月 26 日以前に作成されたアプリケーションの場合、 [レポート] セクションにアップロードされた配布リストのソース ファイルは自動的に名前が変更され、スペースに追加されました。名前が変更されたファイルへの参照は、ロード スクリプトに自動的に追加されました。アップロードされたソース ファイルは、スペースに追加されても名前が変更されなくなりました。 これらのアプリケーションを公開するときに既存のレポート構成を引き続き使用するには、配布リストのソースに応じて、以下で該当するセクションに従ってください。または、このページで後述するガイドを使用して、レポート構成を最初から再作成してください。 ### ソース ファイルをアップロードした場合 データ ロード エディタ を開き、配布リスト スクリプト セクションのファイル名の参照を確認します。特定のスペースではなく、現在のスペースを指すスペース認識参照を使用するように構文を調整します。たとえば、ファイル参照は次のようになります。 ``` FROM "lib://DataFiles/reporting_source_your_app_ID.xlsx" ``` これを次のように変更します。 ``` FROM "lib://:DataFiles/reporting_source_your_app_ID.xlsx" ``` ファイル名にソース アプリケーションのアプリケーション ID が含まれていることがわかります。アプリケーションを公開するときにこの正確なスクリプトを実行させる場合は、実際の配布リスト ファイルをこの正確な名前で管理スペースに追加します。 または、開発スペースでソース ファイルの名前を変更し、ロード スクリプトを更新してから公開することもできます。最後に、名前を更新した実際の配布リスト ファイルを追加します。 ### スクリプトでリモート データ ソースを手動で使用した場合 代わりに、配布リストの他のデータ ソースに依存するようにロード スクリプトを手動で構成した場合は、データ ソースに相対するスペース認識参照を含むようにロード スクリプトを調整するだけで済みます (これがまだ実行されていない場合)。 詳細および具体的な例については、「[管理スペースのアプリケーションのデータ ソース](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/app-data-managed-spaces.htm)」を参照してください。 ## ワークフロー 管理スペースでアプリケーション内レポートを操作するには、次の手順に従います。 ### アプリケーションの開発 アプリケーションを開発スペース (個人スペースまたは共有スペース) で通常通り開発し、管理スペースへの公開に備えます。 ### テンプレートとフィルターの開発 必要に応じて、アプリケーションを公開する前にレポート テンプレートとフィルターを作成できます。これはアプリケーション開発の段階として有用ですが、ソース アプリケーションに追加されたテンプレートやフィルターは、公開されたコピーには引き継がれません。 公開前にテンプレートを作成し、公開したアプリケーションで使用する場合は、テンプレートに接続されている Qlik Sense アプリケーションを変更します。Excel、PowerPoint、Word テンプレートの場合、アドインでこのアクションを実行できます。または、テンプレートを公開されたアプリケーションにアップロードする際に、Qlik Sense アプリケーションでこのアクションを実行します。「[接続されている Qlik Sense アプリケーションを変更する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/InAppGeneral/cloud-in-app-reports-managed-space.htm#Change)」を参照してください。 ### 配布リストの参照を準備する 配布リストをアプリケーションに追加すると、アプリケーションのロード スクリプトが変更されます。アプリケーションのロード スクリプトは、公開されたアプリケーションではアクセスできません。したがって、アプリケーションを公開する前に、配布リストをアプリケーションに追加する必要があります。 この段階での配布リストは、単に管理スペース内の配布リストに使用する実際のファイルまたはその他のソースのプレースホルダーである必要があります。 配布リストがソース ファイルであるか、スクリプトに手動で追加されたリモート データ ソースであるかによって、手順は若干異なります。ただし、基本的な概念は同じです。ロード スクリプトでスペースを認識する構文を使用する方法の概要を説明した完全なガイドについては、「[管理スペースのアプリケーションのデータ ソース](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/app-data-managed-spaces.htm)」を参照してください。 #### オプション 1: ソース ファイルの直接アップロード 次の通常の手順に従って、ソース ファイルを配布リストとしてアップロードします。[ソースファイルをアップロードして配布リストを追加する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-distribution.htm#Adding)。 最終的な受信者の詳細を追加する代わりに、任意のプレースホルダーを挿入できます。ここで重要なのは、ファイルをアップロードすると、このファイルが自動的に開発スペースに追加され、スクリプト内で参照されることです。 ロード スクリプトの Distribution List セクションにファイルへのスペースを認識した参照が含まれており、特定のスペースを直接参照していないことを確認できます。これは、アプリケーションの [レポート] セクションでソース ファイルを配布リストとしてアップロードすると自動的に実行されます。次のようになります。 ``` FROM "lib://:DataFiles/My_App_Distribution_List.xlsx" ``` この例は、アプリケーションが配置されている現在のスペースを指すスペース認識参照です。DataFiles の前にある追加のコロンは、必要な相対参照を提供します。 後でアプリケーションを管理スペースに公開するときに、実際の配布リスト ファイルを管理スペースにアップロードします。実際の配布リストのファイル名は、スクリプトで参照されているファイルと同じである必要があります。 #### オプション 2: スクリプト内のデータ ソースへの手動参照 スクリプト内でリモート配布リスト ソースに手動で接続する、次の通常の手順に従います。[ロード スクリプトで配布リストを手動で定義する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-distribution.htm#Defining)。 配布リストに必要なデータ ソースに接続するスクリプトを記述する場合、必要に応じてファイルと接続へのモック参照を使用できます。スクリプトでは、データ ソースは管理スペースと同じ名前にし、ソースへの参照は相対するスペース認識構文を使用する必要があります。 ### アプリケーションの公開 ロード スクリプトと配布リストを準備したら、アプリケーションを管理スペースに公開できます。アプリケーションの公開の詳細については、「[アプリケーションの公開](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/publish-app-cloud-hub.htm)」を参照してください。 ### オブジェクトレベル フィルターの作成 テンプレートで個々のレポート オブジェクトにフィルターを使用している場合 ([レポート テンプレートでのオブジェクトレベル フィルターの使用](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-filters.htm#ObjectLevel) を参照)、これらのフィルターを使用するテンプレートをアップロードする前に、公開済みアプリケーションで対応するレポート フィルターを作成する必要があります。作成するレポート フィルターは、ソース アプリケーションの名前と一致している必要があります。 ### 接続されている Qlik Sense アプリケーションを変更する アプリケーションを公開する前にレポート テンプレートを作成した場合は、正しいアプリケーション ID を参照するようにテンプレートを更新する必要があります。アプリケーションの公開されたコピーは、ソース アプリケーションとは異なるアプリケーション ID を持ちます。 このプロセスは、テンプレートをアップロードすると自動的に Qlik Sense で完了できます。Microsoft Office ベースのテンプレート形式—Excel、PowerPoint、Word—の場合、これは対応するアドインでも実行できます。開始する前に、テンプレートの別のコピーを作成して、ソース アプリケーションのテンプレートと区別できます。 詳細な手順については、次を参照してください。 * Qlik Senseから: [接続されている Qlik Sense アプリケーションを変更する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-templates.htm#ChangeApp) * Microsoft Office 用 Qlik アドインから: [接続されている Qlik Sense アプリの変更](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-get-started.htm#Changing) ヒント メモベストプラクティスは、共有スペースにあるソース アプリケーション上でテンプレートを開発することです。アプリケーションを管理スペースに公開する必要がある場合は、ソース アプリケーションからテンプレートを直接ダウンロードし、公開したアプリケーションにアップロードします。アプリケーションとそのレポートのニーズは時間の経過とともに変化するため、テンプレートの新しいバージョンをアップロードするときにこのワークフローに従うことができます。 管理スペースでは、いつでもテンプレートを直接開発および更新できます。 ### 実際の配布リストのソースを追加する 管理スペースで、ロード スクリプト内で参照されるように、配布リストのロードに必要なファイルと接続を作成します。このステップはいつでも完了できます。 配布リストを提供するデータ ソースには、ソース アプリケーションのロード スクリプトで使用される配布リスト ソースと同じパラメーター名 (接続名、ファイル名、項目名) が含まれている必要があります。 接続されたソースがスペースに追加されたら、アプリケーションをリロードできるようになります。 ### 新しいレポート アセットを作成する レポート アセットをアプリケーションに追加できるようになりました。これは、テンプレート、フィルター、レポート タスクで構成されます。 ## 権限 管理スペースのアプリケーションでアプリケーション内レポートを使用するには、次が必要です。 * テナント管理者によって割り当てられた権限。管理者の方は「[従量制レポート機能の権限設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-permissions-reporting.htm)」で詳細をご覧ください。 * 管理スペース内の次のスペース ロールのいずれか。 * 所有者 * 管理可能 * 演算可能 情報メモユーザーベースのサブスクリプションの場合、 [操作可能] ロールには、Professionalユーザー資格も必要です。 レポートのためのスペース権限の詳細については、「[Qlik レポート サービス 権限](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/reporting-permissions.htm)」を参照してください。 ## 制限事項 アプリケーション内レポートは、Client-Managed Qlik Sense (マルチクラウド展開を含む) から Qlik Cloud に公開または配布されたアプリケーションでは使用できません。これらのアプリケーションでアプリケーション内レポートを使用するには、[Qlik Analytics Migration Tool](https://help.qlik.com/ja-JP/migration/Subsystems/AnalyticsMigrationTool/Content/Qlik-Analytics-Migration-Tool-Overview.htm) を使用してアプリケーションを移行するか、アプリケーションを手動でエクスポートして Qlik Cloud に再アップロードします。 詳細については、「[エクスポートまたは移行されたアプリケーションでのアプリケーション内レポート](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-exported-migrated.htm)」を参照してください。