| アプリケーションがセクション アクセスを使用しない限り、この受信者のレポートに含まれるデータは、レポート タスクの所有者がアプリに対して持つアクセス権に基づきます。 |
| 外部 | Qlik Cloud テナントに属していないユーザー。 | レポートに含まれるデータは、アプリケーションがセクション アクセスを使用するかどうかに関係なく、常にレポート タスク所有者のアクセスに基づきます。 |
### Microsoft SharePoint レポート配布
代わりに配布フォルダー (Microsoft SharePoint) 経由でレポートを配布する場合は、対応する接続で指定された場所にアクセスできるユーザーは誰でもレポートにアクセスできます。内部受信者の識別は、メール出力の場合と同じように機能します。
アプリケーションがセクション アクセスを使用する場合、Microsoft SharePoint 配布フォルダーを介したレポート配信は使用できません。
配布フォルダー経由でレポートを送信する場合でも、レポート出力を生成するためにアプリケーションの配布リストを定義する必要があります。配布リストは、レポート タスクの実行時に生成されるレポート出力のバージョンの数 (通常は、個々の受信者フィルターごとに 1 つのファイル) を決定するのに役立ちます。配布フォルダーへのレポートの保存の詳細については、「[レポートを配布フォルダーに配信する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-output-folder.htm)」を参照してください。
## 配布リスト、受信者のフィルター、タスク出力
配布リストは、各受信者に個別に適用されるレポート フィルターを制御します。 配布リストをアプリケーションに追加すると、適用するフィルターごとに個別の受信者が作成されます。レポート タスクを構成するときは、単一のフィルターに対応するユーザー フィルターに組み合わせて各受信者が追加されます。
たとえば、フィルター A と B を User1 という名前の受信者に適用すると、フィルター A を持つ User1 とフィルター B を持つ User1 という 2 人の受信者がアプリケーションに追加されます。
必要な出力を生成するためのレポート タスクを構成する方法の詳細については、次を参照してください。
* [レポート タスクの操作](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-tasks.htm)
* [レポート フィルターの操作](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-filters.htm)
* [レポートを配布フォルダーに配信する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-output-folder.htm)
## スケジュールされたリロードのタスクの所有権に関する考慮事項
配布リストは、アプリケーションのロード スクリプトを自動または手動で変更することで機能します。 [レポート] セクションでソース ファイルをアップロードするか、ロード スクリプトを手動で編集してアプリケーションの配布リストを作成または変更すると、そのアプリケーションのスケジュールされたリロード用に作成されたすべてのタスクの新しい所有者になります。
詳細については、「[タスクの所有権](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/reloading-apps-cloud-hub.htm#Ownershi)」を参照してください。
## 配布リストの追加
次の 2 つの方法のいずれかを使用して、配布リストを追加します。
* ソース ファイルをアップロードする
* ロード スクリプトで受信者とグループを手動で定義する
それぞれの方法については、以下のセクションで説明します。
## ソースファイルをアップロードして配布リストを追加する
必要な情報を含むソース ファイルをアップロードすることで、配布リストを定義できます。このファイルには、特定の形式と構造が含まれている必要があります。ソース ファイルを作成する最も簡単な方法は、サンプル ファイルをダウンロードし、受信者とグループの情報で変更することです。
ソース ファイルを配布リストとしてアップロードすると、既存のソース ファイルが置き換えられます (存在する場合)。アプリケーションにはソース ファイルを 1 つのみ適用できます。ソース ファイルをアップロードすると、以前にアプリケーションにアップロードされたソース ファイルがこのファイルに置き換えられます (存在する場合) 。古いファイルと新しいファイルの間に不一致がある場合、既存のレポート タスクが失敗する可能性があります。
ソース ファイルをアップロードして配布リストを追加すると、アプリケーションのロード スクリプトに新しいセクション (Distribution List) が自動的に生成され、アプリケーションがリロードされます。このスクリプト セクションには、アプリケーションの受信者とグループが一覧表示されます。配布ファイル内の詳細は、アプリケーションのデータ モデルでアクセスできるようになります。
ソース ファイルを配布リストとしてアップロードすると、そのファイルはアプリケーションが含まれるスペースにデータ ファイルとしても追加されます。Distribution List スクリプト セクションは、このファイルをスペース内のアイテムとして参照します。
ヒント メモアプリケーション ユーザーがビジュアライゼーションやレポート フィルターを作成するときに、アップロードされた配布ファイル リストの項目にアクセスできないようにするには、スクリプトで HidePrefix システム変数を使用します。データ モデルに項目を保持したまま項目を非表示にするには、これを使用します。詳細については、「[HidePrefix](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/SystemVariables/HidePrefix.htm)」を参照してください。
### 考慮事項
ソース ファイルをアップロードする前に知っておくことが重要な次の詳細について考慮してください。
* 新しい Distribution List スクリプト セクションがスクリプトの最後のセクションとして追加されます。その結果、Distribution List の前の最後のセクションでスクリプトのフォーマットに問題があると、リロードが失敗します。たとえば、ロードする最後のテーブルの末尾にセミコロンがないなどです。
* 自動生成された `Distribution List` スクリプト セクションの SubField 関数式を変更しないでください。これらの式は、フィルターとグループのカンマ区切り値をサポートするために必要です。
```
SubField([Filters],',') AS [DL_DISTRIBUTION_FILTERS],
SubField([Groups],',') AS [DL_DISTRIBUTION_GROUP_NAMES]
```
* ソース ファイルのアップロードはアプリケーションにデータをロードすることで機能するため、Qlik Cloud サブスクリプションで定義される購入済みのデータ ロード量にもカウントされます (容量ベースのサブスクリプションにのみ適用)。「[Qlik Cloud の容量ベースのサブスクリプション](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/subscription-options-qlik-cloud.htm)」を参照してください。
### サンプル ファイルのダウンロード
サンプル ソース ファイルは、アプリケーションにアップロードする前に変更できる Excel ワークブックです。
次の手順を実行します。
1. アプリケーションの [レポート] セクションで [受信者] または [グループ] タブを開きます。
2. [受信者とグループを追加] をクリックします。
3. [the Download example icon ] (サンプルをダウンロード) を選択します。
サンプル配布リスト ファイルのダウンロード
サンプル配布リスト ファイルのダウンロード
サンプル配布リスト ファイルのダウンロード ![\[受信者\] タブのボタンをクリックして、サンプル ソース ファイルをダウンロード](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_CloudExcelReportDistExample.png)
サンプル ファイルをダウンロードした後、ファイルを変更してアプリケーションの受信者とグループを追加できます。
### 受信者の追加
ダウンロードしたサンプル ファイルを開き、次のワークシートが開いていることを確認します。
DL\_DISTRIBUTION\_SVC\_USERS\_QCS
次に、シート内のデータを置き換えて独自の受信者を追加できます。列ヘッダーが表示されている最初の行を変更または削除しないでください。
次の手順を実行します。
1. [名前] 列に受信者の名前を追加します。
2. [メール] 列に、受信者のメール アドレスを追加します。この列は、メール アドレスの宛先を含むハイパーリンクになるように自動的にフォーマットされています。
3. [フィルター] 列に、アプリケーションの [レポート] セクションの [フィルター] タブで追加した内容に対応するフィルター グループを追加します。フィルターグループはカンマで区切ります。
4. [グループ] 列に、受信者が所属するグループを追加します。各グループはカンマで区切ります。
### グループの追加
ソース ファイルでは、次のタイトルのシートにグループが定義されています。
DL\_DISTRIBUTION\_SVC\_GROUPS\_QCS
このワークシートを開いてデータを置き換え、配布リストにグループを作成します。列ヘッダーが表示されている最初の行を変更または削除しないでください。
次の手順を実行します。
1. [名前] 列に、グループの名前を追加します。
2. [説明] 列に、グループの説明を追加します。
### 配布リスト ファイルのアップロード
ソース ファイルを作成したら、アプリケーションの [レポート] セクションにある [受信者] タブまたは [グループ] タブにアップロードします。これを実行するとアプリケーションがリロードされ、受信者およびグループがそれぞれのセクションに表示されます。
次の手順を実行します。
1. [受信者] タブまたは [グループ] タブを開きます。
2. [受信者とグループを追加] をクリックします。
3. [新しいバージョン (.xlsx) をアップロード] を選択します。
ソース ファイルのアップロード
ソース ファイルのアップロード
ソース ファイルのアップロード ![\[受信者\] タブのボタンをクリックして、新しく作成したソース ファイルをアップロード](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/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'` |
### スクリプトの例
以下は、受信者とグループに接続するスクリプト セクションの例です。
```
LIB CONNECT TO 'My_Sample_Connection';
LOAD Name as [GetSheetValues.Name],
Email as [GetSheetValues.Email],
SubField([Filters],',')AS [GetSheetValues.Filters],
SubField([Groups],',') AS [GetSheetValues.Groups];
SELECT Name,
Email,
Filters,
Groups
FROM GetSheetValues
WITH PROPERTIES (
spreadsheetKey='abc',
range='DL_DISTRIBUTION_SVC_USERS_QCS!A1:D100',
valueRenderOption='FORMATTED_VALUE',
dateTimeRenderOption='FORMATTED_STRING',
generatedNumberedColumns='false',
skipRows=''
);
tag field [GetSheetValues.Name] with 'DL_DISTRIBUTION_SVC__recipientName';
tag field [GetSheetValues.Email] with 'DL_DISTRIBUTION_SVC__recipientEmail';
tag field [GetSheetValues.Filters] with 'DL_DISTRIBUTION_SVC__recipientFilters';
LOAD GroupName as [GetSheetValues.Groups],
GroupDescription as [GetSheetValues.GroupDescription];
SELECT GroupName,
GroupDescription
FROM GetSheetValues
WITH PROPERTIES (
spreadsheetKey='abc’,
range='DL_DISTRIBUTION_SVC_GROUPS_QCS!A1:B100',
valueRenderOption='FORMATTED_VALUE',
dateTimeRenderOption='FORMATTED_STRING',
generatedNumberedColumns='false',
skipRows=''
);
tag field [GetSheetValues.Groups] with 'DL_DISTRIBUTION_SVC__groupsName';
tag field [GetSheetValues.GroupDescription] with 'DL_DISTRIBUTION_SVC__groupDescription';
```
## 配布リストの削除
必要に応じて、アプリケーションからすべての受信者とグループを削除できます。
次の手順を実行します。
1. [受信者] タブまたは [グループ] タブを開きます。
2. 受信者またはグループの横にある the 3 つのドットのメニュー icon をクリックし、 [the すべて削除 icon ] を選択します。
情報メモ上記の手順は、ソース ファイルを配布リストとしてアップロードした場合にのみ機能します。代替スクリプト ワークフローを使用して受信者とグループを定義した場合は、項目からタグを削除して、配布リストに関連するものとして識別されないようにする必要があります。
## アプリケーション内レポートとセクション アクセス
アプリケーションがセクション アクセスを使用する場合、レポート生成の動作は異なります。詳細については、「[アプリケーション内レポートとセクション アクセス](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-section-access.htm)」を参照してください。
## 管理スペースの配布リスト
管理スペースにあるアプリケーションの場合、アプリケーションの [レポート] セクションから配布リストを編集できません。 管理スペースにアプリケーションを公開する前に、模擬の配布リスト ファイルをアップロードするか、スクリプト内で必要なリモート ソースを手動で参照します。ロード スクリプトでは、スペースを認識する構文を使用することをお勧めします。つまり、データ ソースへの参照は、アプリケーションが配置されている現在のスペースを指す必要があります。配布リストの追加方法によっては、この構文が自動的に使用される場合があります。
配布リストを提供するデータ ソースには、ソース アプリケーションのロード スクリプトで使用される配布リスト ソースと同じパラメーター名 (接続名、ファイル名、項目名) が含まれている必要があります。
配布リストの実際のデータ ソースを管理スペースにアップロードします。
詳細については、次のガイドを参照してください。
* [管理スペースでのアプリケーション内レポート](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/InAppGeneral/cloud-in-app-reports-managed-space.htm)
* [管理スペースのアプリケーションのデータ ソース](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/app-data-managed-spaces.htm)
## 配布リストの権限
アプリケーションの配信リストを管理するには以下が必要です。
* テナント管理者によって割り当てられた権限。管理者の方は「[従量制レポート機能の権限設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-permissions-reporting.htm)」で詳細をご覧ください。
* [スペース権限](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-distribution.htm#Space)
レポートのためのスペース権限の詳細については、「[Qlik レポート サービス 権限](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/reporting-permissions.htm)」を参照してください。
### スペース権限
Qlik Sense アプリケーション内で配布リストを管理するには、特定のスペース ロールが必要です。要件は、アプリケーションが配置されているスペースの種類に応じて異なります。
#### 共有スペースにおけるアプリケーションの要件
共有スペースのアプリケーションには次の要件が適用されます。
* アプリケーションの [レポート] セクションで配布リストを表示するには、スペースで [編集可能] アクセス権が必要です。
* 配布リストを編集、再アップロード、削除するには、スペースで [アプリケーションでデータ編集可能] アクセス権が必要です。
詳細については、「[共有スペースでの権限の管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/managing-shared-spaces.htm)」を参照してください。
#### 管理スペースにおけるアプリケーションの要件
配布リストは管理スペースでは直接構成できません。ロード スクリプトは、配布リストのロードに使用されるデータ ソースを参照します。これらのデータ ソースをスペースに追加するには、管理スペースでデータ ソースを追加および管理するために必要な権限を持っている必要があります。詳細については、[管理スペースでの権限の管理](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/managing-managed-spaces.htm) を参照してください。
管理スペースでのアプリケーション内レポートの詳細については、「[管理スペースでのアプリケーション内レポート](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/InAppGeneral/cloud-in-app-reports-managed-space.htm)」を参照してください。
#### 個人スペースにおけるアプリケーションの要件
配布リストを完全に制御するには、テナントで Private Analytics Content Creator ユーザー ロールが必要です。
## 配布リストの制限
* 受信者およびグループの名前、受信者のメール アドレスを含む項目ではカンマを使用できません。この制限は、配布リストをファイルとしてアップロードする場合と、ロード スクリプトで手動で定義する場合の両方に適用されます。
* アプリケーションの配布リストには、最大 1000 人の受信者と 1000 個のグループを追加できます。グループに属しているかどうかにかかわらず、総受信者数は 1000 を超えることはできません。
## 詳細を見る
* [トラブルシューティング - アプリケーション内レポート](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Troubleshooting/troubleshooting-reporting.htm)