レポートの配布リストの作成
レポート タスクを作成する前に、レポートの基礎となる Qlik Sense アプリの配布リストを定義する必要があります。配布リストには、アプリのレポート タスクの受信者となるすべての受信者と受信者のグループが含まれます。
配布リストを使用して、レポートの送信先となる個人を構成します。レポート タスクを構成するときは、特定のレポート タスクの出力を受信する受信者とグループを配布リストから選択します。
配布リストには次の詳細が記載されています。
-
アプリから生成されたレポートのすべての受信者。名前、メール アドレス、適用されるフィルター、所属グループが含まれます。
-
アプリから生成されたレポートを受信できるすべてのグループ (1 人以上の受信者の集まり)。
ソース ファイルを配布リストとしてアップロードすると、アプリの [レポート] セクション内の [受信者] タブと [グループ] タブに表示されます。
[受信者] タブと [グループ] タブ
![アプリの [レポート] セクションの [受信者] タブと [グループ] タブ](../../Resources/Images/ui_gen_CloudExcelReportRecGroups_rev.png "クリックしてフル サイズを表示")
アプリにはソース ファイルを 1 つのみ追加できます。ソース ファイルに変更を加える必要がある場合は、最初にアップロードしたファイル (またはデータ ソース) を編集して、再度アップロードします。代わりにデータ接続を使用して配布リストを定義する場合は、必要に応じてスクリプトを編集します。その際に、必要に応じてレポート タスクの構成とフィルターに同等の変更を加える必要があることに注意してください。
レポートを受信できるユーザー
Qlik Cloud Analytics のアプリ内レポートを使用すると、メール レポートを内部および外部の両方の受信者に送信できます。
出力とセクション アクセス
以下の表では、各受信者の種類と、受信者のレポートに表示される内容について説明されています。この表は、セクション アクセスのあるアプリとないアプリの動作の概要を示しています。アプリ内レポートとセクション アクセスの詳細については、「アプリ内レポートとセクション アクセス」を参照してください。
| 受信者の種類 | 説明 | 動作 |
|---|---|---|
| 内部 |
一致するメール アドレスによって識別される、Qlik Cloud テナント内のユーザー。(大文字と小文字は区別されません)。 Qlik Cloud テナントにユーザーを追加する方法については、次を参照してください。
|
アプリがセクション アクセスを使用しない限り、この受信者のレポートに含まれるデータは、レポート タスクの所有者がアプリに対して持つアクセス権に基づきます。 |
| 外部 | Qlik Cloud テナントに属していないユーザー。 | レポートに含まれるデータは、アプリがセクション アクセスを使用するかどうかに関係なく、常にレポート タスク所有者のアクセスに基づきます。 |
Microsoft SharePoint レポート配布
代わりに配布フォルダー (Microsoft SharePoint) 経由でレポートを配布する場合は、対応する接続で指定された場所にアクセスできるユーザーは誰でもレポートにアクセスできます。内部受信者の識別は、メール出力の場合と同じように機能します。
アプリがセクション アクセスを使用する場合、Microsoft SharePoint 配布フォルダーを介したレポート配信は使用できません。
配布フォルダー経由でレポートを送信する場合でも、レポート出力を生成するためにアプリの配布リストを定義する必要があります。配布リストは、レポート タスクの実行時に生成されるレポート出力のバージョンの数 (通常は、個々の受信者フィルターごとに 1 つのファイル) を決定するのに役立ちます。配布フォルダーへのレポートの保存の詳細については、「レポートを配布フォルダーに配信する」を参照してください。
配布リスト、受信者のフィルター、タスク出力
配布リストは、各受信者に個別に適用されるレポート フィルターを制御します。配布リストをアプリに追加すると、適用するフィルターごとに個別の受信者が作成されます。レポート タスクを構成するときは、単一のフィルターに対応するユーザー フィルターに組み合わせて各受信者が追加されます。
たとえば、フィルター A と B を User1 という名前の受信者に適用すると、フィルター A を持つ User1 とフィルター B を持つ User1 という 2 人の受信者がアプリに追加されます。
必要な出力を生成するためのレポート タスクを構成する方法の詳細については、次を参照してください。
スケジュールされたリロードのタスクの所有権に関する考慮事項
配布リストは、アプリのロード スクリプトを自動または手動で変更することで機能します。 [レポート] セクションでソース ファイルをアップロードするか、ロード スクリプトを手動で編集してアプリの配布リストを作成または変更すると、そのアプリのスケジュールされたリロード用に作成されたすべてのタスクの新しい所有者になります。
詳細については、「タスクの所有権」を参照してください。
配布リストの追加
次の 2 つの方法のいずれかを使用して、配布リストを追加します。
-
ソース ファイルをアップロードする
-
ロード スクリプトで受信者とグループを手動で定義する
それぞれの方法については、以下のセクションで説明します。
ソースファイルをアップロードして配布リストを追加する
必要な情報を含むソース ファイルをアップロードすることで、配布リストを定義できます。このファイルには、特定の形式と構造が含まれている必要があります。ソース ファイルを作成する最も簡単な方法は、サンプル ファイルをダウンロードし、受信者とグループの情報で変更することです。
ソース ファイルを配布リストとしてアップロードすると、既存のソース ファイルが置き換えられます (存在する場合)。1 つのアプリには 1 つのソース ファイルのみ適用できます。 ソース ファイルをアップロードすると、以前にアプリにアップロードされたソース ファイルがこのファイルに置き換えられます (存在する場合) 。古いファイルと新しいファイルの間に不一致がある場合、既存のレポート タスクが失敗する可能性があります。
ソース ファイルをアップロードして配布リストを追加すると、アプリのロード スクリプトに新しいセクション (Distribution List) が自動的に生成され、アプリがリロードされます。このスクリプト セクションには、アプリの受信者とグループが一覧表示されます。 配布ファイルの詳細には、アプリのデータ モデルでアクセスできるようになります。
ソース ファイルを配布リストとしてアップロードすると、そのファイルはアプリが含まれるスペースにデータ ファイルとしても追加されます。Distribution List スクリプト セクションは、このファイルをスペース内のアイテムとして参照します。
考慮事項
ソース ファイルをアップロードする前に知っておくことが重要な次の詳細について考慮してください。
-
新しい Distribution List スクリプト セクションがスクリプトの最後のセクションとして追加されます。その結果、Distribution List の前の最後のセクションでスクリプトのフォーマットに問題があると、リロードが失敗します。たとえば、ロードする最後のテーブルの末尾にセミコロンがないなどです。
-
自動生成された Distribution List スクリプト セクションの SubField 関数式を変更しないでください。これらの式は、フィルターとグループのカンマ区切り値をサポートするために必要です。
SubField([Filters],',') AS [DL_DISTRIBUTION_FILTERS], SubField([Groups],',') AS [DL_DISTRIBUTION_GROUP_NAMES] -
ソース ファイルのアップロードはアプリにデータをロードすることで機能するため、Qlik Cloud サブスクリプションで定義される購入済みのデータ ロード量にもカウントされます (容量ベースのサブスクリプションにのみ適用)。「Qlik Cloud の容量ベースのサブスクリプション」を参照してください。
サンプル ファイルのダウンロード
サンプル ソース ファイルは、アプリにアップロードする前に変更できる Excel ワークブックです。
次の手順を実行します。
-
アプリの [レポート] セクションで [受信者] または [グループ] タブを開きます。
-
[受信者とグループを追加] をクリックします。
-
[
Download example] (サンプルをダウンロード) を選択します。
サンプル配布リスト ファイルのダウンロード
![[受信者] タブのボタンをクリックして、サンプル ソース ファイルをダウンロード](../../Resources/Images/ui_gen_CloudExcelReportDistExample.png "クリックしてフル サイズを表示")
サンプル ファイルをダウンロードした後、ファイルを変更してアプリの受信者とグループを追加できます。
受信者の追加
ダウンロードしたサンプル ファイルを開き、次のワークシートが開いていることを確認します。
DL_DISTRIBUTION_SVC_USERS_QCS
次に、シート内のデータを置き換えて独自の受信者を追加できます。列ヘッダーが表示されている最初の行を変更または削除しないでください。
次の手順を実行します。
-
[名前] 列に受信者の名前を追加します。
-
[メール] 列に、受信者のメール アドレスを追加します。この列は、メール アドレスの宛先を含むハイパーリンクになるように自動的にフォーマットされています。
-
[フィルター] 列に、アプリの [レポート] セクションの [フィルター] タブで追加した内容に対応するフィルター グループを追加します。フィルターグループはカンマで区切ります。
-
[グループ] 列に、受信者が所属するグループを追加します。各グループはカンマで区切ります。
グループの追加
ソース ファイルでは、次のタイトルのシートにグループが定義されています。
DL_DISTRIBUTION_SVC_GROUPS_QCS
このワークシートを開いてデータを置き換え、配布リストにグループを作成します。列ヘッダーを表示している最初の行を変更または削除しないでください。
次の手順を実行します。
-
[名前] 列に、グループの名前を追加します。
-
[説明] 列に、グループの説明を追加します。
配布リスト ファイルのアップロード
ソース ファイルを作成したら、アプリの [レポート] セクションの [受信者] タブまたは [グループ] タブにアップロードします。 アップロードするとアプリがリロードされ、受信者とグループがそれぞれのセクションに入力されます。
次の手順を実行します。
-
[受信者] タブまたは [グループ] タブを開きます。
-
[受信者とグループを追加] をクリックします。
-
[新しいバージョン (.xlsx) をアップロード] を選択します。
ソース ファイルのアップロード
![[受信者] タブのボタンをクリックして、新しく作成したソース ファイルをアップロード](../../Resources/Images/ui_gen_CloudExcelReportUploadDist.png "クリックしてフル サイズを表示")
ロード スクリプトで配布リストを手動で定義する
ファイルのアップロードを通じて配布リストを追加して、アプリのロード スクリプトを間接的に変更します。または、ロード スクリプトを直接使用して受信者とグループを追加します。これは上級ユーザーに適したオプションであり、データ ソース接続を使用して受信者とグループの情報を提供する場合に特に役立ちます。
たとえば、受信者とグループが外部ソース ファイルで定義されている場合、またはデータベースまたは人事システム (Workday など) にある場合、このオプションを使用すると、アプリ内の受信者とグループが接続されたソースに基づいて動的に更新されます。
要件
スクリプトの項目がアプリの配布リストに属していると認識されるようにするには、配布リストの必須要素に対応する各必須項目にタグを適用する必要があります。詳細については、以下の表を参照してください。
| タグが必要な項目 | 必要なタグ | 例 |
|---|---|---|
| 受信者名 | DL_DISTRIBUTION_SVC__recipientName | tag field [GetSheetValues.Name] with 'DL_DISTRIBUTION_SVC__recipientName' |
| 受信者のメール アドレス | DL_DISTRIBUTION_SVC__recipientEmail | tag field [GetSheetValues.Email] with 'DL_DISTRIBUTION_SVC__recipientEmail' |
| 受信者のフィルター | DL_DISTRIBUTION_SVC__recipientFilters | tag field [GetSheetValues.Filters] with 'DL_DISTRIBUTION_SVC__recipientFilters' |
| グループ名 | DL_DISTRIBUTION_SVC__groupsName | tag field [GetSheetValues.Groups] with 'DL_DISTRIBUTION_SVC__groupsName' |
| グループの説明 | DL_DISTRIBUTION_SVC__groupDescription | tag field [GetSheetValues.GroupDescription] with 'DL_DISTRIBUTION_SVC__groupDescription' |
スクリプトの例
以下は、受信者とグループに接続するスクリプト セクションの例です。
配布リストの削除
必要に応じて、アプリからすべての受信者とグループを削除できます。
次の手順を実行します。
[受信者] タブまたは [グループ] タブを開きます。
受信者またはグループの横にある
をクリックし、 [
すべて削除] を選択します。
アプリ内レポートとセクション アクセス
アプリがセクション アクセスを使用する場合、レポート生成の動作は異なります。詳細については、「アプリ内レポートとセクション アクセス」を参照してください。
管理スペースの配布リスト
管理スペースにあるアプリの場合、アプリの [レポート] セクションから配布リストを編集することはできません。 管理スペースにアプリを公開する前に、模擬の配布リスト ファイルをアップロードするか、スクリプト内で必要なリモート ソースを手動で参照します。ロード スクリプトでは、スペースを認識する構文を使用することをお勧めします。つまり、データ ソースへの参照は、アプリが配置されている現在のスペースを指す必要があります。配布リストの追加方法によっては、この構文が自動的に使用される場合があります。
配布リストを提供するデータ ソースには、ソース アプリのロード スクリプトで使用される配布リスト ソースと同じパラメーター名 (接続名、ファイル名、項目名) が含まれている必要があります。
配布リストの実際のデータ ソースを管理スペースにアップロードします。
詳細については、次のガイドを参照してください。
配布リストの権限
アプリの配信リストを管理するには以下が必要です。
テナント管理者によって割り当てられた権限。管理者の方は「従量制レポート機能の権限設定」で詳細をご覧ください。
レポートのためのスペース権限の詳細については、「Qlik レポート サービス 権限」を参照してください。
スペース権限
Qlik Sense アプリ内で配布リストを管理するには、特定のスペース ロールが必要です。要件は、アプリが配置されているスペースの種類によります。
共有スペースにおけるアプリの要件
共有スペースのアプリには次の要件が適用されます。
アプリの [レポート] セクションで配布リストを表示するには、スペースで [編集可能] アクセス権が必要です。
配布リストを編集、再アップロード、削除するには、スペースで [アプリケーションでデータ編集可能] アクセス権が必要です。
詳細については、「共有スペースでの権限の管理」を参照してください。
管理スペースにおけるアプリの要件
配布リストは管理スペースでは直接構成できません。ロード スクリプトは、配布リストのロードに使用されるデータ ソースを参照します。これらのデータ ソースをスペースに追加するには、管理スペースでデータ ソースを追加および管理するために必要な権限を持っている必要があります。詳細については、管理スペースでの権限の管理 を参照してください。
管理スペースでのアプリ内レポートの詳細については、「管理スペースでのアプリ内レポート」を参照してください。
個人スペースにおけるアプリの要件
配布リストを完全に制御するには、テナントで Private Analytics Content Creator ユーザー ロールが必要です。
配布リストの制限
受信者およびグループの名前、受信者のメール アドレスを含む項目ではカンマを使用できません。この制限は、配布リストをファイルとしてアップロードする場合と、ロード スクリプトで手動で定義する場合の両方に適用されます。
アプリの配信リストには、最大 1000 人の受信者と 1000 のグループを追加できます。グループの有無にかかわらず、受信者の合計数は 1000 を超えることはできません。