すべて展開 / 折りたたむ Microsoft Office 用 Qlik アドインの展開とインストールこのページ上
Microsoft Office 用 Qlik アドインを展開およびインストールすると、組織内のユーザーがレポート テンプレート を作成できるようになります。アドインで作成したレポート テンプレートを Qlik Cloud アプリケーションにアップロードし、レポート タスク からレポート出力を生成します。
Microsoft Office 用 Qlik アドインは、Microsoft 365 の互換性のある Web およびデスクトップ版の Excel 、PowerPoint 、Word に展開およびインストールできます。
アドインはマニフェスト ファイルを使用してインストールされます。このマニフェスト ファイルは、Microsoft 365 管理者 (特定のインストール方法ではユーザー) が自分自身または組織内のユーザーにアドインを展開してインストールするために必要です。 マニフェスト ファイルを使用すると、単一の Qlik Cloud テナント にアドインをインストールできます。
Microsoft Office 用 Qlik アドインとは何ですか?
Microsoft Office 用 Qlik アドインには次があります。
Microsoft Excel 用の Qlik アドイン
Microsoft PowerPoint 用 Qlik アドイン
Microsoft Word 用 Qlik アドイン
アドイン間の機能はほぼ同じです。アドイン ウィンドウでは、テーブル、画像、変数、式などの形式でアプリケーション コンテンツを追加できます。アドインを使用してコンテンツを追加した後、既定の Microsoft Office 機能を使用して、コンテンツの書式設定とスタイル設定を行うためのいくつかのオプションがあります。
インストール ワークフローを選択する
マニフェスト ファイルまたは URL を取得した後、アドインを展開する方法に一致するワークフローを選択します。
ワークフロー 1 は、本番展開に推奨されるオプションです。ワークフロー 2 から 4 は、テスト、試用、または分離されたユーザー セットアップに最適です。
Qlik Web バージョンで表示されるアドイン ボタン Microsoft Excel
詳細については、「Microsoft Office 用 Qlik アドインを使用したレポート テンプレートの設計 」を参照してください。
開始前の準備
これらの手順は、すべてのインストール ワークフローに適用されます。
要件 1: システムとソフトウェアの要件を満たす
システムとソフトウェアの要件
Qlik Cloud Government に関する注意
Microsoft Office 用 Qlik アドインは、Qlik Cloud Government または Qlik Cloud Government - DoD テナント内のアプリケーションに対してレポート テンプレートを開発するためにサポートされています。
Qlik アドインをインストールして使用するには、ユーザーが次の要件を満たしている必要があります。
Microsoft Excel 用 Qlik アドイン
Windows へのインストールの場合:
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 へのインストールの場合:
macOS へのインストールの場合:
macOS v.14 以上
Microsoft 365 v.16.96 以上
Microsoft Word 用 Qlik アドイン
Windows へのインストールの場合:
macOS へのインストールの場合:
macOS v.14 以上
Microsoft 365 v.16.64 以上
要件 2: OAuth クライアントを作成する
OAuth クライアントを作成する
Microsoft Office 用 Qlik アドインをインストールするには、OAuth クライアント構成が必要です。アドインは、レポート開発者が Qlik Cloud を使用したアプリケーション内レポート作成のためのレポート テンプレート を準備するために使用されます。
アドインで OAuth が機能するには、OAuth クライアントを以下に示すように正確に構成する必要があります。
次の手順を実行します。
Qlik Cloud で、画面左上の をクリックします。
管理 を選択します。
OAuth に移動します。
[新規作成 ] をクリックします。
[クライアント タイプ ] ドロップダウン メニューで、 [単一ページ アプリ ] を選択します。その他の項目が表示されます。
[名前 ] を入力します。[説明 ] はオプションです。
少なくとも、user_default スコープを含めるチェックボックスをオンにします。構成に他のスコープを含めることはできますが、user_default がないとインストールは機能しません。
使用可能な各スコープの詳細については、「使用可能な OAuth スコープ 」を参照してください。
[リダイレクト 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
[追加 ] をクリックします。
[許可されているオリジンの追加 ] 項目にテナント URL を入力し、 [追加 ] をクリックします。
[作成 ] をクリックします。
[クライアント ID をコピー ] ウィンドウが表示されます。クライアント ID をクリップボードにコピーするか、 [完了 ] をクリックしてウィンドウを閉じます。
OAuth クライアントを作成した後、管理 アクティビティ センターから更新されたマニフェスト XML リンクを取得します。[設定 ] ページに移動し、 [メールとレポート ] タブを選択します。[共有とレポート ] セクションで、 Microsoft Office 用 Qlik アドイン を選択します。提供されたリンクを使用して、アドインを展開およびインストールします。
要件 3: アドイン マニフェストの準備と取得を行う
アドイン マニフェストの準備と取得を行う
マニフェスト XML ファイルまたはリンクを使用して、Microsoft 環境で Microsoft Office 用の Qlik アドインをインストールします。
マニフェスト ファイルは単一のQlik Cloud テナント に固有です。Excel 、PowerPoint 、Word のアドインをインストールするには、同じマニフェスト ファイルを使用します。
アドインをインストールするには、OAuth クライアントを構成する必要があります。OAuth クライアントを構成したら、管理 アクティビティ センターからマニフェスト ファイルのリンクとマニフェスト ファイルを取得します。
次の手順を実行します。
必要な構成を使用して、Qlik Cloud テナントに OAuth クライアントを作成します。詳細な手順については、「OAuth クライアントを作成する 」を参照してください。
Qlik Cloud で、画面左上の をクリックします。
管理 を選択します。
設定 に移動します。
[共有とレポート ] セクションで、Microsoft Office 用 Qlik アドイン を選択します。
ドロップダウン メニューで、アドインで OAuth をアクティブ化するために設定した OAuth クライアント構成を選択します。
ダウンロード をクリックしてマニフェストをダウンロードするか、コピー をクリックしてそのリンクをコピーします。
ワークフロー 1: 一元的な展開
Microsoft Office 用 Qlik アドインは、一元的な展開とインストールで使用できるようにすることをお勧めします。一元的な展開には、組織内の Microsoft 365 管理者の操作が必要です。
一元的な展開では、アドイン マニフェストが組織の Microsoft 365 管理センターにロードされ、事前構成されたインストールとしてユーザーに配布されます。配布を特定のセキュリティ グループのメンバーに制限できます。
情報メモ 一元的な展開では、アドインが Excel 、PowerPoint 、および Word 用にインストールされます。アドインを個別にインストールするオプションはありません。
以下の場合にこのワークフローを使用してください。
警告メモ Microsoft Office 用 Qlik アドインの展開は、Qlik Cloud テナントへのアクセスには関連付けられていません。Qlik Cloud へのアクセス権を持たないユーザーにアドインを配布すると、そのユーザーはアドインを表示および起動できるようになります。ただし、アドインはユーザーに Qlik Cloud へのログインを要求します。ログインに成功しないと、機能はブロックされます。
以下のセクションを順番に完了します。
Microsoft 365 管理センターを使用した展開とインストール
一元的な展開は、Microsoft 365 システム管理者によって完了されます。
次の手順を実行します。
OAuth クライアントを作成した後、アドイン マニフェスト ファイルまたはマニフェスト URL を取得します。「アドイン マニフェストの準備と取得を行う 」を参照してください。
Microsoft の公式ドキュメント「Office アドインを展開し、発行する 」に従ってアドインを配布します。一元的な展開による配布は、Microsoft 365 管理センターを使用する場合にのみ可能であることに注意してください。
上記の手順により、アクセス権を与えられたユーザーに対してアドインがインストールされます。その後、ユーザーは Excel 、PowerPoint 、または Word バージョンでアドインをアクティブ化します。
一元的な展開後のアドインのアクティブ化
Microsoft 管理者が組織に Qlik アドインをインストールした後、アクセス権が付与されている場合はアクティブ化して使用できます。
Microsoft Office アプリケーションのバージョンに応じて、これらのステップがわずかに異なる場合があります。詳細については、Microsoft の公式ドキュメントを参照してください。
次の手順を実行します。
Excel 、PowerPoint 、または Word のデスクトップまたは Web バージョンを開きます。
[ホーム ] > [アドイン ] > [Get Add-ins ] (アドインを取得) に移動します。
ダイアログの [ADMIN MANAGED ] (管理者管理) タブで、Qlik アドインを選択します。
Qlik アドイン アイコンがリボン バーに追加されます。
Excel、PowerPoint、Word 用のアドインを表示、管理、インストールする
アドインの削除
インストールで一元的な展開が使用されている場合、アドインをアンインストールできない可能性があります。これは、Microsoft 365 管理者が使用するポリシーに応じて異なります。
ワークフロー 2-4: セルフマネージド インストール オプション
サイドローディングとネットワーク共有インストールは、テストまたは試用目的でアドインへのアクセスを迅速に取得するのに適した方法です。これらの方法は、運用環境やエンタープライズ規模のユース ケースにアドインを展開するには適していません。
警告メモ サイドローディングまたはネットワーク共有を使用してアドインをセルフインストールするには、組織およびローカル マシンでの権限が必要になる場合があります。これらの権限は、組織または
Microsoft 365 管理者によって管理されている場合があります。アドインをセルフインストールできない場合は、
Office アドインに関する Microsoft の公式ドキュメント を参照するか、システム管理者に連絡してください。
警告メモ マニフェストのダウンロードとアドインのサイドローディングに制限はありません。Qlik Cloud にアクセスできない場合でも、マニフェストをインストールできます。ただし、インストール後すぐに Qlik Cloud へのログインを求められます。ログインしていない場合、アドインは機能しません。
Qlik Cloud Government に関する注意
Office 365 Government Community Cloud High (GCCH) では、Microsoft Office 用 Qlik アドインは一元的な展開 によってのみインストールできます。サイドローディングまたはネットワーク共有によるインストールはサポートされていません。
Excel 、PowerPoint 、Word のバージョンやその他の要因によっては、これらのメソッドで読み込まれたアドインが最終的にリボン バーから削除される可能性があります。この問題が発生した場合は、マニフェストを Microsoft Office アプリケーションに再アップロードします。
ワークフロー 2: Web 上でアドインをサイドロードする
ワークフロー 2: Web 上でアドインをサイドロードする
Web 上で Excel 、PowerPoint 、または Word を使用してアドインをサイドロードするには、ユーザーがマニフェスト ファイルをブラウザにアップロードします。
サイドローディングは、Excel 、PowerPoint 、Word の Microsoft 365 Web バージョンでサポートされています。
以下の場合にこのワークフローを使用してください。
次の手順を実行します。
マニフェスト ファイルを準備してダウンロードします。「アドイン マニフェストの準備と取得を行う 」を参照してください。
https://office.live.com/ の Web サイトから Microsoft Office を開きます。
新しい Excel 、PowerPoint 、または Word ドキュメントを開きます。
[ホーム ] タブで、 [アドイン ] をクリックします。
[詳細設定... ] または [Office アドイン ] をクリックします。
[Office アドイン ] ダイアログで、 [Upload My Add-in ] (自分のアドインをアップロード) をクリックします。
アドイン マニフェスト ファイルを参照 して、 [アップロード ] を選択します。
必要に応じて、Qlik Cloud アカウントにサイン インします。
サイドロードされたアドインの削除
サイドロードされたアドインを削除するには、アドインを使用している Web ブラウザーのキャッシュをクリアします。
ワークフロー 3: Windows ネットワーク共有を使用して、デスクトップの Microsoft Office アプリケーションにアドインをインストールする
ワークフロー 3: Windows ネットワーク共有を使用して、デスクトップの Microsoft Office アプリケーションにアドインをインストールする
一元的な展開を行わずに Excel 、PowerPoint 、Word のデスクトップ バージョンにアドインをインストールするには、ネットワーク共有を設定し、そこにマニフェストをロードします。これは、Windows オペレーティング システムでのみ実行できます。
ネットワーク共有経由でアドインをサイドロードするには、以下のガイドラインに従います。この手順は、Microsoft の公式ドキュメントから抜粋したものです。詳細については、「ネットワーク共有からテストするための Office アドインをサイドロードする 」またはその他の Microsoft リソースを参照してください。
ステップ 1: フォルダーの作成と共有
次の手順を実行します。
Qlik アドインをホストするフォルダーを作成します。例: C:\Qlik Office add-ins
Windows ファイル エクスプローラーで、共有フォルダー カタログとして使用するフォルダーの親フォルダーまたはドライブ文字に移動します。例: C:\
フォルダーを右クリックして、 [プロパティ ] を選択します。
[共有] タブを開き、 [共有... ] ボタンをクリックします。
[共有... ] ボタン
ダイアログ ウィンドウで、自分自身と、アドインを共有する他のユーザーやグループを追加します。フォルダーに対する、読み取り/書き込み以上の権限が必要です。共有する相手の選択が完了したら、 [共有 ] をクリックします。
フォルダーが共有されたことを確認したら、フォルダー名の直後に表示される完全なネットワーク パスを書き留めます。[完了 ] をクリックしてダイアログ ウィンドウを閉じます。
フォルダーが正常に共有されたことの確認と完全なネットワーク パス
[閉じる ] をクリックして、 [プロパティ ] ダイアログ ウィンドウを閉じます。
ステップ 2: 共有フォルダーを信頼できるカタログとして手動で構成する
次の手順を実行します。
Excel 、PowerPoint 、または Word のデスクトップ バージョンで新しい空のワークブックを開きます。
[ファイル ] タブをクリックして、左下隅の [オプション ] をクリックします。
[トラスト センター ] をクリックして、 [トラスト センターの設定... ] ボタンをクリックします。
[トラスト センターの設定... ] ボタン
[信頼されているアドイン カタログ ] をクリックします。
[信頼されているアドイン カタログ ] タブ
[カタログ URL ] ボックスに、以前に共有したフォルダーへの完全なネットワーク パスを入力します。
[カタログの追加 ] をクリックします。
新しく追加した項目の [メニューに表示 ] チェックボックスをオンにし、 [OK ] をクリックして [トラスト センター] ダイアログ ウィンドウを閉じます。
新しく追加されたカタログ パスを含む、 [トラスト センター] ダイアログの [信頼されているアドイン カタログ ] タブ
[OK ] をクリックしてダイアログ ウィンドウを閉じます。
アプリケーションを閉じてから再度開くと、変更が反映されます。
ステップ 3: アドインのサイドロード
次の手順を実行します。
アドイン マニフェスト XML ファイルを共有フォルダーに追加します。
Excel 、PowerPoint 、または Word で、リボンの [ホーム ] タブの [アドイン ] をクリックします。
[その他のアドイン ] をクリックします。
[Office アドイン ] ダイアログ ボックスの上部にある [共有フォルダー ] をクリックします。
[Qlik ] を選択してアドインを挿入します。
「Qlik が新しいウィンドウを表示しようとしています 」のようなダイアログ ウィンドウが表示される場合があります。[許可 ] をクリックします。
ネットワーク共有を介してインストールされたアドインの削除
次の手順を実行します。
Excel 、PowerPoint 、または Word が開いている場合は閉じてください。
%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\ のフォルダーの内容を削除します。
ワークフロー 4: デスクトップ macOS アプリケーションにアドインをサイドロードする
ワークフロー 4: デスクトップ macOS アプリケーションにアドインをサイドロードする
macOS の場合、アドインは Excel 、PowerPoint 、Word の Microsoft 365 のデスクトップ バージョンにインストールできます。システムとソフトウェアの要件に関しては、「システムとソフトウェアの要件 」を参照してください。
以下のガイドラインに従ってください。この手順は、Microsoft の公式ドキュメントから抜粋したものです。詳しい手順については、Microsoft の公式ドキュメントを参照してください: Mac の Office にアドインをサイドロード
次の手順を実行します。
コンピュータで検出 アプリケーションを開きます。
次のキーボードの組み合わせを入力してください: Command+Shift+G
フォルダーに移動 メニューが開きます。
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 フォルダーがコンピューターにまだ存在していない可能性があります。その場合は、この場所に作成します。
wef フォルダーに XML マニフェスト ファイルのコピーを追加します。
Excel 、PowerPoint 、または Word を開きます。すでに開いている場合は、再起動する必要があります。
リボン バーで、[ホーム ] > [アドイン ] に移動します。
Qlik アドインを選択します。
これで、Qlik アドインがリボン バーで使用できるようになります。
デスクトップの macOS アプリケーションからサイドロードされたアドインを削除する
Qlik アドインを削除するには、コンピューター上の Office キャッシュをクリアする必要があります。詳細は以下をご覧ください。
複数の Qlik アドインを Excel 、PowerPoint または Word に追加する
追加された各 Qlik アドインにより、単一の Qlik Cloud テナント に対してアドインが使用できます。
動作と制限事項は以下のとおりです。
Excel 、PowerPoint 、または Word アプリケーションでは、一度に使用できるアドイン (単一の Qlik Cloud テナントに接続) は 1 つのみです。
複数の Qlik Cloud テナントのアドインを操作する必要がある場合は、使用を開始する直前に使用したいアドインを展開またはインストールして、テナントを切り替える必要があります。アドインが以前に選択したテナントにまだ接続している場合は、Office アプリケーションを再起動するか、ブラウザのページを再読み込みしてください。
1 つの Qlik Cloud テナントに対して Qlik アドインを一元的に展開 していると、別のテナントに対してアドインをサイドロードできなくなる可能性があります。
Microsoft Excel 、PowerPoint 、または Word のバージョンと使用しているブラウザによっては、複数のアドインがロードされた場合、リボン バーに各アドインのアイコンが表示されるか、最新の展開済みインスタンスを保持するアイコンが 1 つだけ表示されます。前者は、例えば Microsoft Excel 、PowerPoint 、または Word の古いバージョンを使用している場合などに発生することがあります。
Office 365 Government Community Cloud High (GCCH) では、Microsoft Office 用 Qlik アドインは一元的な展開 によってのみインストールできます。サイドローディングまたはネットワーク共有によるインストールはサポートされていません。 Office 365 GCC および GCCH は、一度に 1 つの Qlik Cloud Government または Qlik Cloud Government - DoD テナントでの作業をサポートしています。
トラブルシューティング
このセクションでは、展開およびインストールに関する一般的な問題を解決するためのヒントを提供します。
その他のトラブルシューティングのヒントについては、「トラブルシューティング - アプリケーション内レポート 」を参照してください。
Microsoft Office 用の Qlik アドインのデプロイ後、認証中に空白のダイアログが表示される
ユーザーが Microsoft Excel 、Microsoft PowerPoint 、または Microsoft Word のレポート作成アドインに認証しようとすると、認証用のポップアップ ダイアログが空白になる場合があります。あるいは、ダイアログにエラー (特に 12006) が表示されることもあります。
ユーザーが Microsoft Office 用 Qlik アドインを使用するには、認証フローでテナント と、別のドメインでホストされている ID プロバイダーの間のリダイレクトが必要です。ID プロバイダーが Cross-Origin-Opener-Policy に制限のある設定を設定しています。その結果、認証フローのクロスドメイン通信部分がブロックされ、ログイン情報がアドインに正しく返されなくなります。
提案されたアクション
次の解決策は、アイデンティティ プロバイダーの設定を担当するネットワーク管理者が実行する必要があります。
次の手順を実行します。
詳細については、Microsoft の公式ドキュメント「Office Dialog API のベスト プラクティスとルール 」を参照してください。
Microsoft Office 用 Qlik アドインを初めて開くときにポップアップが許可されていない
Microsoft Office 用 Qlik アドインをアクティブ化した後、初めて開くときに、次のエラーメッセージが表示される場合があります。
ブラウザーのセキュリティ設定により、ダイアログ ボックスを作成できません。
考えられる原因
Web ブラウザーにより、アドイン認証ダイアログがポップアップとして開くことがブロックされています。
提案されたアクション
Microsoft Office アプリケーションの Web バージョンを使用している場合、ブラウザーでポップアップが開かれることを許可する必要があります。ブラウザーやバージョンに応じて異なりますが、考えられる解決策は次のとおりです。