Microsoft Office 用 Qlik アドインの展開とインストール

Microsoft Office 用 Qlik アドインを展開およびインストールすると、組織内のユーザーがレポート テンプレートを作成できるようになります。アドインで作成したレポート テンプレートを Qlik Cloud アプリにアップロードし、レポート タスクからレポート出力を生成します。

Microsoft Office 用 Qlik アドインは、Microsoft 365 の互換性のある Web およびデスクトップ版の Excel、PowerPoint、Word に展開およびインストールできます。

アドインはマニフェスト ファイルを使用してインストールされます。このマニフェスト ファイルは、Microsoft 365 管理者 (特定のインストール方法ではユーザー) が自分自身または組織内のユーザーにアドインを展開してインストールするために必要です。 マニフェスト ファイルを使用すると、単一の Qlik Cloud テナントにアドインをインストールできます。

マニフェスト ファイルまたは URL を取得した後、次の 2 つの異なる方法でアドインを展開およびインストールできます。

• 一元的な展開: 一元的な展開、インストール、アクティブ化

• サイドローディング: サイドローディングまたはネットワーク共有を使用したアドインのインストール

詳細については、「Microsoft Office 用 Qlik アドインを使用したレポート テンプレートの設計」を参照してください。

システムとソフトウェアの要件

Qlik Cloud Government に関する注意

Microsoft Office 用 Qlik アドインは、Qlik Cloud Government または Qlik Cloud Government - DoD テナント内のアプリに対してレポート テンプレートを開発するためにサポートされています。このアドインは、Office 365 Commercial でのみ利用できます。

Qlik アドインをインストールして使用するには、次の要件を満たす必要があります。

Microsoft Excel 用 Qlik アドイン

Windows へのインストールの場合:

• Windows 10 v.1903 以上

• Microsoft 365 v.16.0.11629 以上

macOS へのインストールの場合:

• macOS v.14 以上

• Microsoft 365 v.16.83 以上

Microsoft Excel 用 Qlik アドインを実行するには、ExcelAPI 1.9 以降を備えた Microsoft Excel がインストールされている必要があります。Excel のインストールが準拠しているかどうかを確認するには、Microsoft の公式ドキュメントの「Excel JavaScript API の要件セット」を参照してください。

ExcelAPI のバージョンが要件を満たしていない場合、Qlik アドインには新しいバージョンの Microsoft Excel が必要であることを示すエラーが表示されます。

エラーを確認するには、Microsoft Excel の右側の白い領域をクリックし、F5 キーを押してページを更新する必要がある場合があります。

このエラーが表示された場合は、Microsoft Excel のインストールをアップグレードしてください。

Microsoft PowerPoint 用 Qlik アドイン

Windows へのインストールの場合:

• Windows 10 v.1903 以上

• Microsoft 365 バージョン 2504 (ビルド 18730.20030) 以上

macOS へのインストールの場合:

• macOS v.14 以上

• Microsoft 365 v.16.96 以上

Microsoft Word 用 Qlik アドイン

Windows へのインストールの場合:

• Windows 10 v.1903 以上

• Microsoft 365 バージョン 2208 (ビルド 15601.20148) 以上

macOS へのインストールの場合:

• macOS v.14 以上

• Microsoft 365 v.16.64 以上

アドイン マニフェストの準備と取得

Microsoft Office 用の Qlik アドインは、マニフェスト ファイルを使用して Microsoft 環境にインストールされます。これは XML ファイルです。一元的な展開の場合、マニフェスト ファイルへの URL は Microsoft 管理者から提供される必要があります。

マニフェスト ファイルは単一の Qlik Cloud テナントに固有です。Excel、PowerPoint、Word のアドインをインストールするには、同じマニフェスト ファイルを使用します。

アドインをインストールするには、OAuth クライアントを構成する必要があります。OAuth クライアントを構成したら、管理 アクティビティ センターからマニフェスト ファイルのリンクとマニフェスト ファイルを取得します。

次の手順を実行します。

1. 必要な構成を使用して、Qlik Cloud テナントに OAuth クライアントを作成します。詳細な手順については、「Microsoft Office 用 Qlik アドインの OAuth クライアントの作成」を参照してください。

2. 管理 アクティビティ センターに移動し、マニフェスト リンクを生成します。別のユース ケース用にマニフェスト ファイルを直接ダウンロードすることもできます。「Microsoft Office 用 Qlik アドインのインストール マニフェストの管理」を参照してください。

Microsoft Office 用 Qlik アドインの OAuth クライアントの作成

Microsoft Office 用 Qlik アドインをインストールするには、OAuth クライアント構成が必要です。アドインは、レポート開発者が Qlik Cloud を使用したアプリ内レポート作成のためのレポート テンプレートを準備するために使用されます。

アドインで OAuth が機能するには、OAuth クライアントを以下に示すように正確に構成する必要があります。

次の手順を実行します。

1. Qlik Cloud の 管理 アクティビティ センターで、OAuth に移動します。

2. [新規作成] をクリックします。

3. [クライアント タイプ] ドロップダウン メニューで、 [単一ページ アプリ] を選択します。その他の項目が表示されます。

4. [名前] を入力します。[説明] はオプションです。

5. 少なくとも、user_default スコープを含めるチェックボックスをオンにします。構成に他のスコープを含めることはできますが、user_default がないとインストールは機能しません。

   使用可能な各スコープの詳細については、「使用可能な OAuth スコープ」を参照してください。

6. [リダイレクト URL の追加] 項目に、Qlik Cloud テナントの URL を入力し、その後に固定文字列 /office-add-ins/oAuthLoginSuccess.html を入力します。

   結果は https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html になります。例: http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html

7. [追加] をクリックします。

8. [許可されているオリジンの追加] 項目にテナント URL を入力し、 [追加] をクリックします。

9. [作成] をクリックします。

10. [クライアント ID をコピー] ウィンドウが表示されます。クライアント ID をクリップボードにコピーするか、 [完了] をクリックしてウィンドウを閉じます。

OAuth クライアントを作成した後、管理 アクティビティ センターから更新されたマニフェスト XML リンクを取得します。[設定] ページに移動し、 [メールとレポート] タブを選択します。[共有とレポート] セクションで、 Microsoft Office 用 Qlik アドイン を選択します。提供されたリンクを使用して、アドインを展開およびインストールします。

一元的な展開、インストール、アクティブ化

Microsoft Office 用 Qlik アドインは、一元的な展開とインストールで使用できるようにすることをお勧めします。一元的な展開には、組織内の Microsoft 365 管理者の操作が必要です。

一元的な展開では、アドイン マニフェストが組織の Microsoft 365 管理センターにロードされ、事前構成されたインストールとしてユーザーに配布されます。配布を特定のセキュリティ グループのメンバーに制限できます。

次の場合には、一元的な展開を使用してください。

• 組織のメンバーに対して、アドインを永続的にインストールする場合

• 組織メンバーへの配布を管理する場合

完全なワークフローについては、以下の手順のセクションに従ってください。

一元的な展開とインストール

一元的な展開は、Microsoft 365 システム管理者によって完了されます。

次の手順を実行します。

1. OAuth クライアントを作成した後、アドイン マニフェスト ファイルまたはマニフェスト URL を取得します。「アドイン マニフェストの準備と取得」を参照してください。

2. Microsoft の公式ドキュメント「Office アドインを展開し、発行する」に従ってアドインを配布します。一元的な展開による配布は、Microsoft 365 管理センターを使用する場合にのみ可能であることに注意してください。

上記の手順により、アクセス権を与えられたユーザーに対してアドインがインストールされます。その後、ユーザーは Excel、PowerPoint、または Word バージョンでアドインをアクティブ化します。

一元的な展開を行わずに Excel、PowerPoint、Word のデスクトップ バージョンにアドインをインストールするには、ネットワーク共有を設定し、そこにマニフェストをロードします。これは、Windows オペレーティング システムでのみ実行できます。

一元的な展開後のアドインのアクティブ化

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

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

次の手順を実行します。

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

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

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

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

Excel、PowerPoint、Word 用のアドインを表示、管理、インストールする

アドインの削除

インストールで一元的な展開が使用されている場合、アドインをアンインストールできない可能性があります。これは、Microsoft 365 管理者が使用するポリシーに応じて異なります。

サイドローディングまたはネットワーク共有を使用したアドインのインストール

サイドローディングとネットワーク共有インストールは、テストまたは試用目的でアドインへのアクセスを迅速に取得するのに適した方法です。これらの方法は、運用環境やエンタープライズ規模のユース ケースにアドインを展開するには適していません。

Excel、PowerPoint、Word のバージョンやその他の要因によっては、これらのメソッドで読み込まれたアドインが最終的にリボン バーから削除される可能性があります。この問題が発生した場合は、マニフェストを Microsoft Office アプリケーションに再アップロードします。

オプション 2: Windows ネットワーク共有を使用して、デスクトップ の Microsoft Office アプリケーションにアドインをインストールする

一元的な展開を行わずに Excel、PowerPoint、Word のデスクトップ バージョンにアドインをインストールするには、ネットワーク共有を設定し、そこにマニフェストをロードします。これは、Windows オペレーティング システムでのみ実行できます。

ネットワーク共有経由でアドインをサイドロードするには、以下のガイドラインに従います。この手順は、Microsoft の公式ドキュメントから抜粋したものです。詳細については、「ネットワーク共有からテストするための Office アドインをサイドロードする」またはその他の Microsoft リソースを参照してください。

ステップ 1: フォルダーの作成と共有

次の手順を実行します。

1. Qlik アドインをホストするフォルダーを作成します。例: C:\Qlik Office add-ins

2. Windows ファイル エクスプローラーで、共有フォルダー カタログとして使用するフォルダーの親フォルダーまたはドライブ文字に移動します。例: C:\

3. フォルダーを右クリックして、 [プロパティ] を選択します。

4. [共有] タブを開き、 [共有...] ボタンをクリックします。

   

5. ダイアログ ウィンドウで、自分自身と、アドインを共有する他のユーザーやグループを追加します。フォルダーに対する、読み取り/書き込み以上の権限が必要です。共有する相手の選択が完了したら、 [共有] をクリックします。

6. フォルダーが共有されたことを確認したら、フォルダー名の直後に表示される完全なネットワーク パスを書き留めます。[完了] をクリックしてダイアログ ウィンドウを閉じます。

   

7. [閉じる] をクリックして、 [プロパティ] ダイアログ ウィンドウを閉じます。

ステップ 2: 共有フォルダーを信頼できるカタログとして手動で構成する

次の手順を実行します。

1. Excel、PowerPoint、または Word のデスクトップ バージョンで新しい空のワークブックを開きます。

2. [ファイル] タブをクリックして、左下隅の [オプション] をクリックします。

3. [トラスト センター] をクリックして、 [トラスト センターの設定...] ボタンをクリックします。

   

4. [信頼されているアドイン カタログ] をクリックします。

   

5. [カタログ URL] ボックスに、以前に共有したフォルダーへの完全なネットワーク パスを入力します。

6. [カタログの追加] をクリックします。

7. 新しく追加した項目の [メニューに表示] チェックボックスをオンにし、 [OK] をクリックして [トラスト センター] ダイアログ ウィンドウを閉じます。

   

8. [OK] をクリックしてダイアログ ウィンドウを閉じます。

9. アプリケーションを閉じてから再度開くと、変更が反映されます。

ステップ 3: アドインのサイドロード

次の手順を実行します。

1. アドイン マニフェスト XML ファイルを共有フォルダーに追加します。

2. Excel、PowerPoint、または Word で、リボンの [ホーム] タブの [アドイン] をクリックします。

3. [その他のアドイン] をクリックします。

4. [Office アドイン] ダイアログ ボックスの上部にある [共有フォルダー] をクリックします。

5. [Qlik] を選択してアドインを挿入します。

6. 「Qlik が新しいウィンドウを表示しようとしています」のようなダイアログ ウィンドウが表示される場合があります。[許可] をクリックします。

ネットワーク共有を介してインストールされたアドインの削除

次の手順を実行します。

1. Excel、PowerPoint、または Word が開いている場合は閉じてください。

2. %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\ のフォルダーの内容を削除します。

オプション 3: デスクトップ macOS アプリケーションにアドインをサイドロードする

macOS の場合、アドインは Excel、PowerPoint、Word の Microsoft 365 のデスクトップ バージョンにインストールできます。システムとソフトウェアの要件に関しては、「システムとソフトウェアの要件」を参照してください。

以下のガイドラインに従ってください。この手順は、Microsoft の公式ドキュメントから抜粋したものです。詳しい手順については、Microsoft の公式ドキュメントを参照してください: Mac の Office にアドインをサイドロード

次の手順を実行します。

1. コンピュータで検出アプリケーションを開きます。

2. 次のキーボードの組み合わせを入力してください: Command+Shift+G

   フォルダーに移動メニューが開きます。

3. Microsoft Office アプリケーションに応じて、次のいずれかのパスを入力します。

   • Excel: /Users/<username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef

   • PowerPoint: /Users/<username>/Library/Containers/com.microsoft.Powerpoint/Data/Documents/wef

   • Word: /Users/<username>/Library/Containers/com.microsoft.Word/Data/Documents/wef

   wef フォルダーがコンピューターにまだ存在していない可能性があります。その場合は、この場所に作成します。

4. wef フォルダーに XML マニフェスト ファイルのコピーを追加します。

5. Excel、PowerPoint、または Word を開きます。すでに開いている場合は、再起動する必要があります。

6. リボン バーで、[ホーム] > [アドイン] に移動します。

7. Qlik アドインを選択します。

これで、Qlik アドインがリボン バーで使用できるようになります。

デスクトップの macOS アプリケーションからサイドロードされたアドインを削除する

Qlik アドインを削除するには、コンピューター上の Office キャッシュをクリアする必要があります。詳細は以下をご覧ください。

• サイドロードされたアドインを削除する

• Office キャッシュをクリアする

トラブルシューティング

このセクションでは、展開およびインストールに関する一般的な問題を解決するためのヒントを提供します。

その他のトラブルシューティングのヒントについては、「トラブルシューティング - アプリ内レポート」を参照してください。

Microsoft Office 用の Qlik アドインのデプロイ後、認証中に空白のダイアログが表示される

ユーザーが Microsoft Excel、Microsoft PowerPoint、または Microsoft Word のレポート作成アドインに認証しようとすると、認証用のポップアップ ダイアログが空白になる場合があります。あるいは、ダイアログにエラー (特に 12006) が表示されることもあります。

ユーザーが Microsoft Office 用 Qlik アドインを使用するには、認証フローでテナントと、別のドメインでホストされている ID プロバイダーの間のリダイレクトが必要です。ID プロバイダーが Cross-Origin-Opener-Policy に制限のある設定を設定しています。その結果、認証フローのクロスドメイン通信部分がブロックされ、ログイン情報がアドインに正しく返されなくなります。

提案されたアクション  

次の解決策は、アイデンティティ プロバイダーの設定を担当するネットワーク管理者が実行する必要があります。

次の手順を実行します。

• IDP からダイアログへの応答ヘッダーを次のように設定します。

  Cross-Origin-Opener-Policy: unsafe-none

詳細については、Microsoft の公式ドキュメント「Office Dialog API のベスト プラクティスとルール」を参照してください。