# Microsoft Office 用 Qlik アドインの使用を開始する

Microsoft Office 用 Qlik アドインの使用を開始するには、アドインをアクティブ化して開き、アドインを使用して分析アプリからコンテンツに接続します。

テンプレートにコンテンツを追加する方法については、「[Microsoft Office 用 Qlik アドインを使用してレポート テンプレートにコンテンツを追加する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-content.htm)」および関連トピックを参照してください。

情報メモアドインを使用するには、事前にインストールする必要があります。詳細については、「[Microsoft Office 用 Qlik アドインの展開とインストール](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm)」を参照してください。

## 適用対象

このコンテンツは、次の種類の Qlik Cloud レポート テンプレートに適用されます。

* Excel

  [Microsoft Excel 用 Qlik アドイン](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/reporting-add-ins.htm#Excel)

* PowerPoint

  [Microsoft PowerPoint 用 Qlik アドイン](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/reporting-add-ins.htm#PowerPoint)

* Word

  [Microsoft Word 用 Qlik アドイン](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/reporting-add-ins.htm#Word)

## アドインを使用するための要件

Microsoft Office 用 Qlik アドインを使用するには、次が必要です。

* テナント管理者によって割り当てられた権限。管理者の方は「[従量制レポート機能の権限設定](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/Design/OfficeCommon/add-in-get-started.htm#Space)

  レポートのためのスペース権限の詳細については、「[Qlik レポート サービス 権限](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/reporting-permissions.htm)」を参照してください。

### スペース権限

アドインでアプリに接続するには、特定のスペース ロールが必要です。要件は、アプリが配置されているスペースの種類に応じて異なります。

アドインを使用して共有スペースで Qlik Sense アプリのレポート テンプレートを生成するには、そのスペースで最低限 [編集可能] 権限が必要です。

アドインを使用して共有スペースで Qlik Sense アプリのレポート テンプレートを生成するには、そのスペースで最低限 [寄与可能] または [操作可能] 権限が必要です。

警告メモアドインでアプリに接続するには、アプリのスペースへの [寄与可能] または [操作可能] アクセス権限のみが必要ですが、作成したテンプレートを使用するレポート タスクは、レポート タスク所有者のアクセス権に基づいて実行されます。したがって、テンプレート作成者は、将来的に他のスペース メンバーに公開する予定のないアプリ シート (つまり、プライベート シート) にあるコンテンツを使用して、テンプレートを作成しないでください。詳細については、「[レポート タスクが正常に実行されるための要件](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-tasks.htm#Requirem2)」 を参照してください。

詳細については、「[Qlik レポート サービス 権限](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/reporting-permissions.htm)」を参照してください。

### その他の要件

Microsoft 365 の Web バージョンの Excel、Microsoft PowerPoint、または Word を使用している場合は、ブラウザーの設定でポップアップを許可する必要があります。ただし、ナビゲーション履歴と Cookie は保持してください。保持しないと、該当する Microsoft Office アプリケーションを開くたびにアドインを再インストールする必要が生じます。

## アドインのアクティブ化

Microsoft 管理者が組織に Qlik アドインをインストールした後、アクセス権が付与されている場合はアクティブ化して使用できます。

Microsoft Office アプリケーションのバージョンに応じて、これらのステップがわずかに異なる場合があります。詳細については、Microsoft の公式ドキュメントを参照してください。

次の手順を実行します。

1. Excel、PowerPoint、または Word のデスクトップまたは Web バージョンを開きます。

2. [ホーム] > [アドイン] > [Get Add-ins] (アドインを取得) に移動します。

3. ダイアログの [ADMIN MANAGED] (管理者管理) タブで、Qlik アドインを選択します。

Qlik アドイン アイコンがリボン バーに追加されます。

[Excel、PowerPoint、Word 用のアドインを表示、管理、インストールする](https://support.microsoft.com/en-gb/office/view-manage-and-install-add-ins-for-excel-powerpoint-and-word-16278816-1948-4028-91e5-76dca5380f8d)

情報メモ代わりにサイドローディングまたはネットワーク共有を使用してアドインをインストールした場合、別の手順でアドインをアクティブ化する必要があります。「[ワークフロー 2-4: セルフマネージド インストール オプション](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm#Sideload)」を参照してください。

## アドインを開く

アドインを開くには、 [ホーム] タブのリボン バーにある Qlik アイコンをクリックします。

リボン バーの Qlik アイコンをクリックして Qlik アドインを開きます

リボン バーの Qlik アイコンをクリックして Qlik アドインを開きます

リボン バーの QlikQlik アイコンをクリックして QlikQlik アドインを開きます ![Qlik アドイン アイコンを表示する Microsoft Excel のリボン バー](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_gen_ExcelAddIn_QlikIconInRibbon.png)

## テナントへの接続とログイン

アドインを開くと、アドインがインストールされている Qlik Cloud テナントに接続するように求められます。1 つのアドインをインストールすると、1 つの特定のテナントに対してアドインが構成されます。[接続] をクリックします。

アドインをインストールするには、OAuth クライアントを構成する必要があります。

初めて接続するとき、またはサーバー側で接続が切断された場合は、ログインを求められます。Excel の Web バージョンを使用するときに、ナビゲーション履歴と Cookie を保持しておかないと、後で再度ログインが必要になる場合があります。

次の手順を実行します。

1. ログインを求められたら、必要に応じてテナントの ID プロバイダー構成を使用して、Qlik アカウントのログイン手順に従います。

2. アプリ認証ダイアログで [承認] をクリックして、OAuth クライアントを使用してアプリを認証します。テナントへの初回ログイン時のみ、認証が必要になります。

## テンプレート用の Qlik Sense アプリの選択

ログイン後、作成するテンプレートのソースとして使用する Qlik Sense スペースとアプリを選択する必要があります。レポート テンプレートは 1 つのアプリを使用します。 1 つの Qlik Sense アプリのオブジェクトのみを各テンプレート ファイルに追加できます。

次の手順を実行します。

1. [スペース] で、Qlik Cloud Analytics スペースを選択します。

2. [アプリ] で、スペースから Qlik Sense アプリを選択します。

3. [保存] をクリックします。

アプリがロードされ、そのメタデータがファイルに入力されたら、the 外部ファイルまたはアプリケーションを開く icon をクリックして Qlik Cloud でソース アプリを開くことができます。

テンプレートがソース アプリに接続されたら、アドインの [the ホーム icon] タブに戻ってアプリを変更できます。詳細については、「[接続されている Qlik Sense アプリの変更](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-get-started.htm#Changing)」を参照してください。

## アプリでのシートの可用性

Microsoft Office の Qlik アドインにログインすると、ソース Qlik Sense アプリでアクセス権のあるコンテンツのみが表示されます。 たとえば、個人スペースのアプリの場合、すべてのコンテンツにアクセスできます。共有スペースにあるアプリの場合、アプリ内で公開されているコンテンツまたは個人用の非公開コンテンツのみを表示および使用できます。共有スペース アプリ内の別のユーザーのプライベート シートのコンテンツを表示または使用することはできません。

## レポートのプレビュー

テンプレートを開発するときは、作成される出力が希望どおりであるかどうかを確認する必要があります。レポート タスクを構成して自分にメールで送信しなくても、レポートのプレビューで表示される内容を確認できます。

レポートをプレビューするには、アドインの右上のツール バーにある the [Download] (ダウンロード) icon アイコンをクリックします。使用している Microsoft Office アプリケーションに応じて、次のオプションがあります。

* Excel (.xlsx) としてプレビュー

* PowerPoint (.pptx) としてプレビュー

* Word (.docx) としてプレビュー

* PDF としてプレビュー

PDF 形式でレポートのプレビューを開くと、レポートは Excel 設定から現在の言語を使用して、地域の書式設定 (日付、数値など) を適用します。

ブラウザの構成に応じて、レポートはブラウザ ウィンドウに表示されるか、コンピューターにダウンロードされます。レポートが表示されない場合は、ブラウザでポップアップを許可していることかを確認してください。

生成されたファイルを開いて結果を確認します。

## PDF と印刷出力の準備

レポートを PDF 形式で生成または印刷する場合は、テンプレートの印刷設定を調整する必要がある場合があります。Microsoft Office アプリケーションのネイティブ機能を使用してテンプレートを準備します。

これらのページ設定構成には、次が含まれる場合があります。

* 用紙サイズ

* ページの向き

* 選択された印刷領域

* ページ区切り

印刷範囲とページ設定を構成するための操作方法は、次の要因に応じて異なる場合があります。

* 使用しているアプリケーション (Excel、PowerPoint、Word)

* オペレーティング システム

* Web ブラウザー

後でレポート出力を構成するときに、レポート内の地域依存の書式設定のロケールを定義できます。これには、日付、数値、その他の情報の書式設定が含まれます。この設定を構成する場所は、ユース ケースに応じて異なります。

* タスクベースのレポート: レポート タスクを構成するときの [地域の書式設定]。

  [パート 3: 出力の構成](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Generate/cloud-in-app-reports-tasks.htm#ConfigureOutput)

* オンデマンド レポートの生成: 個人用設定での [優先言語] 設定 (これらの設定を構成するには、ユーザー プロファイル アイコンをクリックし、 [設定] を選択します)。

  [地域依存の書式設定](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/OnDemand/reports-on-demand-create.htm#Localiza)

* PDF 形式でレポートのプレビューを開くと、レポートは Excel 設定から現在の言語を使用して、地域の書式設定 (日付、数値など) を適用します。

## Qlik Sense でソース オブジェクトを開く

レポート コンテンツのソース オブジェクトを確認するには、Qlik Sense アプリで開きます。

次の手順を実行します。

1. アドイン ウィンドウで、ツール バーの the ホーム icon タブをクリックします。

2. [ソース アプリ] の下部にある the 外部ファイルまたはアプリケーションを開く icon をクリックします。

ソース オブジェクトがチャートの場合、Qlik Sense アプリに移動して、対応するシートが表示されます。アプリを開くには、Qlik Cloud に再度ログインする必要がある場合があります。

## 作業内容の保存

Excel、PowerPoint、または Word ファイルを通常どおりに保存します。ファイルを通常通りに再度開くと、テンプレートが表示されます。

## アドインのバージョンと接続されているサーバー アドレスの確認

アドインのバージョンと Qlik Cloud テナント (サーバー) アドレスを確認できます。

次の手順を実行します。

1. アドイン ウィンドウで、ツール バーの the ホーム icon タブをクリックします。

2. [ソース アプリ] の横にある the 詳細 icon をクリックします。

3. [About] (情報) をクリックします。

4. テナント URL と Office アドインのバージョン、Qlik Sense アプリのスペースと名前が表示されます。

## アドインと Qlik Cloud テナントの同期

接続されている Qlik Cloud テナントに変更があった場合、アドインを使用している Excel、PowerPoint、または Word ファイルは自動的に更新されません。たとえば、次の更新が必要になる場合があります。

* 作業が可能なスペースのリスト。

* 作業が可能なアプリのリスト。

* 選択した Qlik Sense アプリで使用可能なエンティティのリスト。

* テンプレートで使用したチャート画像。たとえば、ソース Qlik Sense アプリで選択を行った場合、チャート画像に画像プレースホルダーでの選択を反映させることができます。

* テンプレートで使用した画像とテーブルのステータス (削除された、タイトルが変更されたなど)。

接続メタデータを更新するには、次のステップに従います。

次の手順を実行します。

1. アドイン ウィンドウで、ツール バーの the ホーム icon タブをクリックします。

2. [ソース アプリ] の横にある the 詳細 icon をクリックします。

3. [全画像を更新] をクリックします。

これにより、グローバル更新が適用されます。アドインの他のタブで、個々のエンティティとオブジェクトの更新を実行することもできます。the リロード icon アイコンは、これらが使用可能な場合に表示されます。

Qlik Sense アプリが編集されても、更新が適用されない限り、テンプレート内のデータ とオブジェクトは更新されません。

## レポート テンプレート ファイルの共有

Microsoft Office 用 Qlik アドインで作成されたテンプレート ファイルには、タグとプレビュー画像のみが含まれています。別のユーザーがテンプレートの編集やプレビューを実行する場合は、次が必要です。

* Excel、PowerPoint、または Word のバージョンにインストールされている Qlik アドイン。

* Qlik Cloud テナントにアクセスします。

* アプリが共有スペースにある場合: スペースまたはアプリに対する [閲覧可能] 以上のスペース ロール (アドインでアプリに接続し、そのデータにアクセスできるようになります)。

* アプリが管理スペースにある場合: スペースまたはアプリに対する [表示が制限されています] 以上のスペース ロール (アドインでアプリに接続し、そのデータにアクセスできるようになります)。

ただし、レポート テンプレートは、プレビューの作成時に使用可能なデータを含む通常の Excel、PowerPoint、または Word ファイルです。テンプレート ファイルは誰とでも共有できますが、ソース アプリにアクセスできるユーザーのみがアドインでテンプレート ファイルに接続し、更新を適用できます。グローバル更新の詳細については、「[アドインと Qlik Cloud テナントの同期](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Design/OfficeCommon/add-in-get-started.htm#Synchron)」を参照してください。

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

レポート テンプレートは、単一の Qlik Sense アプリからレポートを生成できます。テンプレートにコンテンツを追加する前または後に、接続する Qlik Sense アプリを変更できます。

コンテンツがすでに追加されているテンプレートの場合、新しいアプリにテンプレートが現在接続されているアプリと同じオブジェクト ID が含まれている必要があります。このワークフローは、複製されたアプリ、スペースまたはテナント間で移動されたアプリ、または管理スペースに公開されたアプリを対象としています。

テンプレート接続を変更する前に、テンプレートのバックアップ コピーを作成することをお勧めします。

### テナント内の別のアプリへの接続

次の手順を実行します。

1. アドイン ウィンドウで、ツール バーの the ホーム icon タブをクリックします。

2. [ソース アプリ] の横にある the 詳細 icon をクリックします。

3. [ソース アプリの編集] をクリックします。

4. [スペース] と [アプリ] を選択し、 [保存]をクリックします。

### テナントとアプリの変更

1. アドイン ウィンドウで、ツール バーの the ホーム icon タブをクリックします。

2. [ソース アプリ] の横にある the 詳細 icon をクリックします。

3. [ソース アプリの編集] をクリックします。

4. 現在の Qlik Cloud テナントが表示されます。[テナントを変更] をクリックします。

5. 新しい Qlik Cloud テナントと Qlik Sense アプリ ID を入力します。

   ヒント メモアプリを開いているときに、URL からアプリ ID を直接コピーして貼り付けることができます。

6. [保存] をクリックします。

7. アドインを閉じるか、ページを更新します。

テナントを変更する場合、テンプレートを編集するには、新しいテナントのマニフェスト ファイルをインストールする必要があります。

### Qlik Sense で接続されているアプリを変更する

または、新しい 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#UploadTemplate)」を参照してください。

## アドインでの Qlik Sense オブジェクトの検索

追加ボタンをクリックした後に右側に表示されるリストを展開してスクロールすることによって、特定の Qlik Sense オブジェクトを見つけることができます。または、検索フォームに文字列を挿入することもできます。Enter キーを押すと、挿入された Qlik Sense アプリの次の項目で文字列が検索されます。

* オブジェクト ID

* オブジェクト名 (シートも含む)

* チャートの種類

正しいオブジェクトを迅速に見つけるには、Qlik Sense アプリの開発時に正しい命名規則を使用することが重要です。

## エラー メッセージへのアクセス

Microsoft Office 用 Qlik アドインにはネイティブ エラー メッセージがあります。Qlik に問い合わせる際のエラー報告に役立つように、ブラウザの開発者ツール、JavaScript コンソール、ネットワーク タブで、エラー メッセージを確認してください。

## アプリ オブジェクト命名のベストプラクティス

Qlik Sense アプリのオブジェクトを命名する方法は、レポート テンプレートの有効性と使いやすさに影響します。ベスト プラクティスのリストについては、「[アプリケーション内レポートのベスト プラクティス](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/InAppGeneral/reporting-best-practices.htm)」を参照してください。