管理スペースの表形式レポート
厳格なデータ ガバナンスを必要とするアプリ向けの表形式レポートを生成できます。管理スペースで使用するアプリ データ モデルの開発と同じ原則を使用して、アプリ内のレポート機能用にアプリを準備できます。これは、ロード スクリプトでスペースを認識する構文を使用することで実現されます。
管理スペースに公開する準備としてアプリを開発する場合は、次の点を考慮してください。
-
テンプレートは、アプリの公開前または公開後に作成できます。 公開前にテンプレートを作成した場合は、公開後にアドインを使用して接続アプリのアプリ ID を変更します。
-
配布リストは、アプリを公開する前にアプリに追加する必要があります。 開発中は、実際のデータ ソースではなくモック データ ソースで構成できます。配布リスト内のソースはロード スクリプトで参照されるため、スクリプトは、スペースを認識する構文を使用して、公開の準備として記述する必要があります。配布リストをソース ファイルとしてアップロードする場合、この構文は既定で自動的に使用されます。
-
公開後、レポート アセット (テンプレート、フィルター、レポート タスク) は、公開されたアプリのレポート ユース ケースに基づいて、必要に応じて再作成できます。 配布リストで使用される実際のデータ ソースは、管理スペースに追加する必要があります。
既存の表形式レポートの構成
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が含まれていることがわかります。アプリを公開するときにこの正確なスクリプトを実行させる場合は、実際の配布リスト ファイルをこの正確な名前で管理スペースに追加します。
または、開発スペースでソース ファイルの名前を変更し、ロード スクリプトを更新してから公開することもできます。最後に、名前を更新した実際の配布リスト ファイルを追加します。
スクリプトでリモート データ ソースを手動で使用した場合
代わりに、配布リストの他のデータ ソースに依存するようにロード スクリプトを手動で構成した場合は、データ ソースに相対するスペース認識参照を含むようにロード スクリプトを調整するだけで済みます (これがまだ実行されていない場合)。
詳細および具体的な例については、「管理スペースのアプリのデータ ソース」を参照してください。
ワークフロー
管理スペースで表形式レポートを操作するには、次の手順に従います。
アプリの開発
アプリを開発スペース (個人スペースまたは共有スペース) で通常通り開発し、管理スペースへの公開に備えます。
テンプレートとフィルターの開発
必要に応じて、アプリを公開する前にレポート テンプレートとフィルターを作成できます。これはアプリ開発の段階では役立ちますが、ソース アプリに追加されたテンプレートとフィルターは、公開されたコピーには保持されません。
公開前にテンプレートを作成し、そのテンプレートを公開アプリに使用する場合は、アドインの [テンプレート接続を変更] 機能を使用して、接続アプリのアプリ ID を変更します。テンプレート接続の変更 を参照してください。
配布リストの参照を準備する
配布リストをアプリに追加すると、アプリのロード スクリプトが変更されます。アプリのロード スクリプトは、公開アプリではアクセスできません。 したがって、アプリを公開する前に、アプリに配布リストを追加する必要があります。
この段階での配布リストは、単に管理スペース内の配布リストに使用する実際のファイルまたはその他のソースのプレースホルダーである必要があります。
配布リストがソース ファイルであるか、スクリプトに手動で追加されたリモート データ ソースであるかによって、手順は若干異なります。ただし、基本的な概念は同じです。ロード スクリプトでスペースを認識する構文を使用する方法の概要を説明した完全なガイドについては、「管理スペースのアプリのデータ ソース」を参照してください。
オプション 1: ソース ファイルの直接アップロード
次の通常の手順に従って、ソース ファイルを配布リストとしてアップロードします。ソースファイルをアップロードして配布リストを追加する。
最終的な受信者の詳細を追加する代わりに、任意のプレースホルダーを挿入できます。ここで重要なのは、ファイルをアップロードすると、このファイルが自動的に開発スペースに追加され、スクリプト内で参照されることです。
ロード スクリプトの Distribution List セクションにファイルへのスペースを認識した参照が含まれており、特定のスペースを直接参照していないことを確認できます。これは、アプリの [レポート] セクションでソース ファイルを配布リストとしてアップロードすると自動的に実行され、次のようになります。
FROM "lib://:DataFiles/My_App_Distribution_List.xlsx"
この例は、アプリが配置されている現在のスペースを指すスペース認識参照です。DataFiles の前にある追加のコロンは、必要な相対参照を提供します。
後でアプリを管理スペースに公開するときに、実際の配布リスト ファイルを管理スペースにアップロードします。実際の配布リストのファイル名は、スクリプトで参照されているファイルと同じである必要があります。
オプション 2: スクリプト内のデータ ソースへの手動参照
スクリプト内でリモート配布リスト ソースに手動で接続する、次の通常の手順に従います。ロード スクリプトで配布リストを手動で定義する。
配布リストに必要なデータ ソースに接続するスクリプトを記述する場合、必要に応じてファイルと接続へのモック参照を使用できます。スクリプトでは、データ ソースは管理スペースと同じ名前にし、ソースへの参照は相対するスペース認識構文を使用する必要があります。
アプリの公開
ロード スクリプトと配布リストを準備したら、アプリを管理スペースに公開できます。アプリの公開の詳細については、「 アプリの公開」を参照してください。
テンプレート接続の変更
アプリを公開する前にレポート テンプレートを作成した場合は、正しいアプリ ID を参照するようにテンプレートを更新する必要があります。アプリの公開されたコピーは、ソース アプリとは異なるアプリ ID を持ちます。
このプロセスは、Microsoft Excel 用の Qlik アドインで完了します。開始する前に、テンプレートの別のコピーを作成して、ソース アプリのテンプレートと区別できます。
詳細な手順については、「接続されている Qlik Sense アプリの変更」を参照してください。
テンプレートを作成する前にアプリを公開した場合は、新しいテンプレートを作成して管理スペース アプリと接続できるようになります。
実際の配布リストのソースを追加する
管理スペースで、ロード スクリプト内で参照されるように、配布リストのロードに必要なファイルと接続を作成します。このステップはいつでも完了できます。
配布リストを提供するデータ ソースには、ソース アプリのロード スクリプトで使用される配布リスト ソースと同じパラメーター名 (接続名、ファイル名、項目名) が含まれている必要があります。
接続されたソースがスペースに追加されたら、アプリをリロードできるようになります。
新しいレポート アセットを作成する
レポート アセットをアプリに追加できるようになりました。 これは、テンプレート、フィルター、レポート タスクで構成されます。
権限
管理スペース内で次のいずれかのロールを持つユーザーは、アプリの表形式レポートを操作できます。
-
所有者
-
管理可能
-
操作可能 (Professional またはフル ユーザー資格 のみ)
詳細については、「管理スペースでの権限の管理」を参照してください。
制限事項
表形式レポートは、Client-Managed Qlik Sense (マルチクラウド展開を含む) から Qlik Cloud に公開または配布されたアプリでは使用できません。これらのアプリで表形式レポートを使用するには、移行ツールを使用してアプリを Qlik Cloud に移行する(「Qlik Cloud 移行ツールの設定」を参照) か、アプリを手動でエクスポートして Qlik Cloud に再アップロードします。
詳細については、「エクスポートまたは移行されたアプリでの表形式レポート」を参照してください。