Microsoft Excel の Qlik アドインの使用を開始する
このトピックでは、Microsoft Excel 用 Qlik アドインのアクティブ化、開き方、Qlik Sense コンテンツへの接続など、基本的な情報について説明します。テンプレートにコンテンツを追加する方法については、「Microsoft Excel 用 Qlik アドインの使用」および関連トピックを参照してください。
アドインを使用するには、事前にインストールする必要があります。詳細については、「Microsoft Excel 用の Qlik アドインの展開とインストール」を参照してください。
アドインを使用するための要件
アドインを使用して共有スペースで Qlik Sense アプリのレポート テンプレートを生成するには、そのスペースで [閲覧可能] 権限が必要です。
アドインを使用して管理スペースで Qlik Sense アプリのレポート テンプレートを生成するには、そのスペースで [ビューが制限されています] 以上の権限が必要です。
Microsoft 365 用の Microsoft Excel の Web バージョンを使用している場合は、ブラウザの設定でポップアップを許可する必要があります。ただし、ナビゲーション履歴と Cookie は保持してください。それ以外の場合は、Excel を開くたびにアドインを再度インストールする必要があります。
アドインのアクティブ化
Microsoft 管理者が組織に Qlik アドインをインストールした後、アクセス権が付与されている場合はアクティブ化して使用できます。
Microsoft Excel のバージョンに応じて、これらのステップがわずかに異なる場合があります。詳細については、Microsoft の公式ドキュメントを参照してください。
次の手順を実行します。
-
Excel のデスクトップまたは Web バージョンを開きます。
-
[ホーム] > [アドイン] > [Get Add-ins] (アドインを取得) に移動します。
-
ダイアログの [ADMIN MANAGED] (管理者管理) タブで、Qlik アドインを選択します。
Qlik アドイン アイコンがリボン バーに追加されます。
Microsoft 365 プログラムのアドインの表示、管理、インストール
アドインを開く
アドインを開くには、 [ホーム] タブのリボン バーにある Qlik アイコンをクリックします。
テナントへの接続とログイン
アドインを開くと、アドインがインストールされている Qlik Cloud テナントに接続するように求められます。1 つのアドインをインストールすると、1 つの特定のテナントに対してアドインが構成されます。[接続] をクリックします。
アドインをインストールするには、OAuth クライアントを構成する必要があります。
初めて接続するとき、またはサーバー側で接続が切断された場合は、ログインを求められます。Excel の Web バージョンを使用するときに、ナビゲーション履歴と Cookie を保持しておかないと、後で再度ログインが必要になる場合があります。
次の手順を実行します。
-
ログインを求められたら、必要に応じてテナントの ID プロバイダー構成を使用して、Qlik アカウントのログイン手順に従います。
-
アプリ認証ダイアログで [承認] をクリックして、OAuth クライアントを使用してアプリを認証します。テナントへの初回ログイン時のみ、認証が必要になります。
テンプレート用の Qlik Sense アプリの選択
ログイン後、作成するテンプレートのソースとして使用する Qlik Sense スペースとアプリを選択する必要があります。レポート テンプレートは 1 つのアプリを使用します。 1 つの Qlik Sense アプリのオブジェクトのみを各 Excel テンプレート ファイルに追加できます。
次の手順を実行します。
-
[スペース] で、Qlik Cloud Analytics スペースを選択します。
-
[アプリ] で、スペースから Qlik Sense アプリを選択します。
-
[保存] をクリックします。
アプリがロードされ、そのメタデータがファイルに入力されたら、 をクリックして Qlik Cloud でソース アプリを開くことができます。
テンプレートがソース アプリに接続されたら、アドインの [] タブに戻ってアプリを変更できます。詳細については、「接続されている Qlik Sense アプリの変更」を参照してください。
アプリでのシートの可用性
Microsoft Excel の Qlik アドインにログインすると、ソース Qlik Sense アプリでアクセス権のあるコンテンツのみが表示されます。 たとえば、個人スペースのアプリの場合、すべてのコンテンツにアクセスできます。共有スペースにあるアプリの場合、アプリ内で公開されているコンテンツまたは個人用の非公開コンテンツのみを表示および使用できます。共有スペース アプリ内の別のユーザーのプライベート シートのコンテンツを表示または使用することはできません。
レポートのプレビュー
テンプレートを開発するときは、作成される出力が希望どおりであるかどうかを確認する必要があります。レポート タスクを構成して自分にメールで送信しなくても、レポートのプレビューで表示される内容を確認できます。
レポートをプレビューするには、アドインの右上のツール バーにある アイコンをクリックします。次のオプションがあります。
-
Excel (.xlsx) としてプレビュー
-
PDF としてプレビュー
PDF 形式でレポートのプレビューを開くと、レポートは Excel 設定から現在の言語を使用して、地域の書式設定 (日付、数値など) を適用します。
ブラウザの構成に応じて、レポートはブラウザ ウィンドウに表示されるか、コンピューターにダウンロードされます。レポートが表示されない場合は、ブラウザでポップアップを許可していることかを確認してください。
生成されたファイルを開いて結果を確認します。
PDF と印刷出力の準備
レポートを PDF 形式で生成または印刷する場合は、テンプレートの印刷設定を調整する必要がある場合があります。Microsoft Excel のネイティブ機能を使用してテンプレートを準備します。これらの設定は、 [ページ レイアウト] にある場合が多くあります。
これらのページ設定構成には、次が含まれる場合があります。
-
用紙サイズ
-
ページの向き
-
選択された印刷領域
-
ページ区切り
印刷領域とページ設定を構成するためのナビゲーション エクスペリエンスは、Excel のバージョン、オペレーティング システム、ウェブ ブラウザーに応じて異なる場合があります。これらの Excel 機能の詳細については、特定の環境の Microsoft Excel ドキュメントを参照してください。
後でレポート出力を構成するときに、レポート内の地域依存の書式設定のロケールを定義できます。これには、日付、数値、その他の情報の書式設定が含まれます。この設定を構成する場所は、ユース ケースに応じて異なります。
-
タスクベースのレポート: レポート タスクを構成するときの [地域の書式設定]。
-
オンデマンド レポートの生成: [プロファイル設定] の [優先言語] 設定。
-
PDF 形式でレポートのプレビューを開くと、レポートは Excel 設定から現在の言語を使用して、地域の書式設定 (日付、数値など) を適用します。
Qlik Sense でソース オブジェクトを開く
Qlik Sense のソース オブジェクトを表示する場合は、Excel ワークブックの項目を選択します。次に、アドインの [ソース アプリ] で、 をクリックします。
ソース オブジェクトがチャートの場合、Qlik Sense アプリに移動して、対応するシートが表示されます。アプリを開くには、Qlik Cloud に再度ログインする必要がある場合があります。
作業内容の保存
通常どおりに Excel ワークブックを保存します。いつものように .xlsx ファイルを再度開くと、テンプレートが表示されます。
アドインのバージョンと接続されているサーバー アドレスの確認
アドインのバージョンとQlik Cloud テナント (サーバー) アドレスを確認できます。
次の手順を実行します。
-
アドイン ウィンドウで、ツール バーの タブをクリックします。
-
[ソース アプリ] の横にある をクリックします。
-
[About] (情報) をクリックします。
-
テナント URL と Office アドインのバージョン、Qlik Sense アプリのスペースと名前が表示されます。
アドインと Qlik Cloud テナントの同期
接続されている Qlik Cloud テナントに変更があった場合、アドインを使用している Excel ドキュメントは自動的に更新されません。たとえば、次の更新が必要になる場合があります。
-
作業が可能なスペースのリスト。
-
作業が可能なアプリのリスト。
-
選択した Qlik Sense アプリで使用可能なエンティティのリスト。
-
テンプレートで使用したチャート画像。たとえば、ソース Qlik Sense アプリで選択を行った場合、チャート画像に画像プレースホルダーでの選択を反映させることができます。
-
テンプレートで使用した画像とテーブルのステータス (削除された、タイトルが変更されたなど)。
接続メタデータを更新するには、次のステップに従います。
次の手順を実行します。
-
アドイン ウィンドウで、ツール バーの タブをクリックします。
-
[ソース アプリ] の横にある をクリックします。
-
[全画像を更新] をクリックします。
これにより、グローバル更新が適用されます。アドインの他のタブで、個々のエンティティとオブジェクトの更新を実行することもできます。 アイコンは、これらが使用可能な場合に表示されます。
Qlik Sense アプリが編集されても、更新が適用されない限り、テンプレート内のデータ とオブジェクトは更新されません。
Excel レポート テンプレート ファイルの共有
テンプレート ファイルにはテーブル タグとプレビュー 画像のみが含まれます。別のユーザーがテンプレートの編集やプレビューを実行する場合は、次が必要です。
-
Microsoft Excel のバージョンにインストールされている Qlik アドイン。
-
Qlik Cloud テナントにアクセスします。
-
アプリが共有スペースにある場合: スペースまたはアプリに対する [閲覧可能] 以上のスペース ロール (アドインでアプリに接続し、そのデータにアクセスできるようになります)。
-
アプリが管理スペースにある場合: スペースまたはアプリに対する [ビューが制限されています] 以上のスペース ロール (アドインでアプリに接続し、そのデータにアクセスできるようになります)。
ただし、レポート テンプレートは、プレビューの作成時に使用可能なデータを含む通常の Excel ワークブックです。テンプレート ファイルは誰とでも共有できますが、ソース アプリにアクセスできるユーザーのみがアドインでテンプレート ファイルに接続し、更新を適用できます。グローバル更新の詳細については、「アドインと Qlik Cloud テナントの同期」を参照してください。
接続されている Qlik Sense アプリの変更
Excel レポート テンプレートは、単一の Qlik Sense アプリからレポートを生成できます。テンプレートにコンテンツを追加する前または後に、接続する Qlik Sense アプリを変更できます。
コンテンツがすでに追加されているテンプレートの場合、新しいアプリにテンプレートが現在接続されているアプリと同じオブジェクト ID が含まれている必要があります。このワークフローは、複製されたアプリ、スペースまたはテナント間で移動されたアプリ、または管理スペースに公開されたアプリを対象としています。
テンプレート接続を変更する前に、テンプレートのバックアップ コピーを作成することをお勧めします。
テナント内の別のアプリへの接続
次の手順を実行します。
アドイン ウィンドウで、ツール バーの タブをクリックします。
[ソース アプリ] の横にある をクリックします。
[ソース アプリの編集] をクリックします。
[スペース] と [アプリ] を選択し、 [保存]をクリックします。
テナントとアプリの変更
アドイン ウィンドウで、ツール バーの タブをクリックします。
[ソース アプリ] の横にある をクリックします。
[ソース アプリの編集] をクリックします。
現在の Qlik Cloud テナントが表示されます。[テナントを変更] をクリックします。
新しい Qlik Cloud テナントと Qlik Sense アプリ ID を入力します。
ヒント メモアプリを開いているときに、URL からアプリ ID を直接コピーして貼り付けることができます。[Save] (保存)をクリックします。
アドインを閉じるか、ページを更新します。
テナントを変更する場合、テンプレートを編集するには、新しいテナントのマニフェスト ファイルをインストールする必要があります。
Qlik Sense で接続されているアプリを変更する
または、新しい Qlik Sense アプリの [レポート] セクション内で接続されたアプリを変更することもできます。これは、元の Qlik Sense アプリの新しいコピーを作成した場合に便利です。例: アプリを管理スペースに公開する、またはアプリを複製、移行、転送する場合など。
詳細については、「レポート テンプレートのアップロード」を参照してください。
アドインでの Qlik Sense オブジェクトの検索
追加ボタンをクリックした後に右側に表示されるリストを展開してスクロールすることによって、特定の Qlik Sense オブジェクトを見つけることができます。または、検索フォームに文字列を挿入することもできます。Enter キーを押すと、挿入された Qlik Sense アプリの次の項目で文字列が検索されます。
-
オブジェクト ID
-
オブジェクト名 (シートも含む)
-
チャートの種類
正しいオブジェクトを迅速に見つけるには、Qlik Sense アプリの開発時に正しい命名規則を使用することが重要です。
エラー メッセージへのアクセス
Excel アドインにはネイティブ エラー メッセージがあります。Qlik に問い合わせる際のエラー報告に役立つように、ブラウザの開発者ツール、JavaScript コンソール、ネットワーク タブで、エラー メッセージを確認してください。
アプリ オブジェクト命名のベストプラクティス
Qlik Sense アプリのオブジェクトを命名する方法は、レポート テンプレートの有効性と使いやすさに影響します。ベスト プラクティスのリストについては、「アプリ内レポートのベスト プラクティス」を参照してください。