管理スペースでのアプリ内レポート

厳格なデータ ガバナンスを必要とするアプリのアプリ内レポートを構成できます。管理スペースで使用するアプリ データ モデルの開発と同じ原則を使用して、アプリ内のレポート機能用にアプリを準備できます。これは、ロード スクリプトでスペースを認識する構文を使用することで実現されます。

管理スペースに公開する準備としてアプリを開発する場合は、次の点を考慮してください。

• テンプレートは、アプリの公開前または公開後に作成できます。 公開前にテンプレートを作成した場合は、公開後に接続アプリを変更します。

• 配布リストは、アプリを公開する前にアプリに追加する必要があります。 開発中は、実際のデータ ソースではなくモック データ ソースで構成できます。配布リスト内のソースはロード スクリプトで参照されるため、スクリプトは、スペースを認識する構文を使用して、公開の準備として記述する必要があります。配布リストをソース ファイルとしてアップロードする場合、この構文は既定で自動的に使用されます。

• 公開後、レポート アセット (テンプレート、フィルター、レポート タスク) は、公開されたアプリのレポート ユース ケースに基づいて、必要に応じて再作成できます。 配布リストで使用される実際のデータ ソースは、管理スペースに追加する必要があります。

既存のレポートの構成

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が含まれていることがわかります。アプリを公開するときにこの正確なスクリプトを実行させる場合は、実際の配布リスト ファイルをこの正確な名前で管理スペースに追加します。

または、開発スペースでソース ファイルの名前を変更し、ロード スクリプトを更新してから公開することもできます。最後に、名前を更新した実際の配布リスト ファイルを追加します。

スクリプトでリモート データ ソースを手動で使用した場合

代わりに、配布リストの他のデータ ソースに依存するようにロード スクリプトを手動で構成した場合は、データ ソースに相対するスペース認識参照を含むようにロード スクリプトを調整するだけで済みます (これがまだ実行されていない場合)。

詳細および具体的な例については、「管理スペースのアプリのデータ ソース」を参照してください。

ワークフロー

管理スペースでアプリ内レポートを操作するには、以下の手順に従います。

アプリの開発

アプリを開発スペース (個人スペースまたは共有スペース) で通常通り開発し、管理スペースへの公開に備えます。

テンプレートとフィルターの開発

必要に応じて、アプリを公開する前にレポート テンプレートとフィルターを作成できます。これはアプリ開発の段階では役立ちますが、ソース アプリに追加されたテンプレートとフィルターは、公開されたコピーには保持されません。

公開前にテンプレートを作成し、公開したアプリで使用する場合は、テンプレートに接続されている Qlik Sense アプリを変更します。 アドインでこのアクションを実行できます。または、テンプレートを公開されたアプリにアップロードする際に、Qlik Sense アプリでこのアクションを実行します。「接続されている Qlik Sense アプリの変更」を参照してください。

配布リストの参照を準備する

配布リストをアプリに追加すると、アプリのロード スクリプトが変更されます。アプリのロード スクリプトは、公開アプリではアクセスできません。 したがって、アプリを公開する前に、アプリに配布リストを追加する必要があります。

この段階での配布リストは、単に管理スペース内の配布リストに使用する実際のファイルまたはその他のソースのプレースホルダーである必要があります。

配布リストがソース ファイルであるか、スクリプトに手動で追加されたリモート データ ソースであるかによって、手順は若干異なります。ただし、基本的な概念は同じです。ロード スクリプトでスペースを認識する構文を使用する方法の概要を説明した完全なガイドについては、「管理スペースのアプリのデータ ソース」を参照してください。

オプション 1: ソース ファイルの直接アップロード

次の通常の手順に従って、ソース ファイルを配布リストとしてアップロードします。ソースファイルをアップロードして配布リストを追加する。

最終的な受信者の詳細を追加する代わりに、任意のプレースホルダーを挿入できます。ここで重要なのは、ファイルをアップロードすると、このファイルが自動的に開発スペースに追加され、スクリプト内で参照されることです。

ロード スクリプトの Distribution List セクションにファイルへのスペースを認識した参照が含まれており、特定のスペースを直接参照していないことを確認できます。これは、アプリの [レポート] セクションでソース ファイルを配布リストとしてアップロードすると自動的に実行され、次のようになります。

FROM "lib://:DataFiles/My_App_Distribution_List.xlsx"

この例は、アプリが配置されている現在のスペースを指すスペース認識参照です。DataFiles の前にある追加のコロンは、必要な相対参照を提供します。

後でアプリを管理スペースに公開するときに、実際の配布リスト ファイルを管理スペースにアップロードします。実際の配布リストのファイル名は、スクリプトで参照されているファイルと同じである必要があります。

オプション 2: スクリプト内のデータ ソースへの手動参照

スクリプト内でリモート配布リスト ソースに手動で接続する、次の通常の手順に従います。ロード スクリプトで配布リストを手動で定義する。

配布リストに必要なデータ ソースに接続するスクリプトを記述する場合、必要に応じてファイルと接続へのモック参照を使用できます。スクリプトでは、データ ソースは管理スペースと同じ名前にし、ソースへの参照は相対するスペース認識構文を使用する必要があります。

アプリの公開

ロード スクリプトと配布リストを準備したら、アプリを管理スペースに公開できます。アプリの公開の詳細については、「 アプリの公開」を参照してください。

接続されている Qlik Sense アプリの変更

アプリを公開する前にレポート テンプレートを作成した場合は、正しいアプリ ID を参照するようにテンプレートを更新する必要があります。アプリの公開されたコピーは、ソース アプリとは異なるアプリ ID を持ちます。

このプロセスは、テンプレートをアップロードすると Qlik Sense で完了できます。Excel レポートテンプレートの場合、これは Microsoft Excel の Qlik アドインでも実行できます。開始する前に、テンプレートの別のコピーを作成して、ソース アプリのテンプレートと区別できます。

詳細な手順については、次を参照してください。

• Qlik Sense から: 接続されている Qlik Sense アプリの変更

• Microsoft Excel 用の Qlik アドインから: 接続されている Qlik Sense アプリの変更

管理スペースでは、いつでもテンプレートを直接開発および更新できます。

実際の配布リストのソースを追加する

管理スペースで、ロード スクリプト内で参照されるように、配布リストのロードに必要なファイルと接続を作成します。このステップはいつでも完了できます。

配布リストを提供するデータ ソースには、ソース アプリのロード スクリプトで使用される配布リスト ソースと同じパラメーター名 (接続名、ファイル名、項目名) が含まれている必要があります。

接続されたソースがスペースに追加されたら、アプリをリロードできるようになります。

新しいレポート アセットを作成する

レポート アセットをアプリに追加できるようになりました。 これは、テンプレート、フィルター、レポート タスクで構成されます。

権限

管理スペース内で次のいずれかのロールを持つユーザーは、アプリのアプリ内レポートを操作できます。

• 所有者

• 管理可能

• 操作可能 (Professional 資格または Full User 資格 のみ)

詳細については、「管理スペースでの権限の管理」を参照してください。

制限事項