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 の公式ドキュメントを参照してください。

次の手順を実行します。

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

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

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

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

Microsoft 365 プログラムのアドインの表示、管理、インストール

アドインを開く

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

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

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

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

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

次の手順を実行します。

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

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

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

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

次の手順を実行します。

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

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

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

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

テンプレートがソース アプリに接続されたら、アドインの [] タブに戻ってアプリを変更できます。詳細については、「接続されている Qlik Sense アプリの変更」を参照してください。

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

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

レポートのプレビュー

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

レポートをプレビューするには、アドインの右上のツール バーにある アイコンをクリックします。次のオプションがあります。

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

• PDF としてプレビュー

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

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

PDF と印刷出力の準備

レポートを PDF 形式で生成または印刷する場合は、テンプレートの印刷設定を調整する必要がある場合があります。Microsoft Excel のネイティブ機能を使用してテンプレートを準備します。これらの設定は、 [ページ レイアウト] にある場合が多くあります。

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

• 用紙サイズ

• ページの向き

• 選択された印刷領域

• ページ区切り

印刷領域とページ設定を構成するためのナビゲーション エクスペリエンスは、Excel のバージョン、オペレーティング システム、ウェブ ブラウザーに応じて異なる場合があります。これらの Excel 機能の詳細については、特定の環境の Microsoft Excel ドキュメントを参照してください。

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

Qlik Sense のソース オブジェクトを表示する場合は、Excel ワークブックの項目を選択します。次に、アドインの [ソース アプリ] で、 をクリックします。

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

作業内容の保存

通常どおりに Excel ワークブックを保存します。いつものように .xlsx ファイルを再度開くと、テンプレートが表示されます。

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

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

次の手順を実行します。

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

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

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

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

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

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

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

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

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

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

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

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

次の手順を実行します。

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

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

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

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

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

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

テンプレート ファイルにはテーブル タグとプレビュー 画像のみが含まれます。別のユーザーがテンプレートの編集やプレビューを実行する場合は、次が必要です。

• Microsoft Excel のバージョンにインストールされている Qlik アドイン。

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

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

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

ただし、レポート テンプレートは、プレビューの作成時に使用可能なデータを含む通常の Excel ワークブックです。テンプレート ファイルは誰とでも共有できますが、ソース アプリにアクセスできるユーザーのみがアドインでテンプレート ファイルに接続し、更新を適用できます。グローバル更新の詳細については、「アドインと Qlik Cloud テナントの同期」を参照してください。

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

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

• オブジェクト ID

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

• チャートの種類

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

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

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

Qlik Sense アプリ開発における効果的なオブジェクト命名のベスト プラクティス

Qlik Sense アプリのオブジェクト命名に関しては、明確性、一貫性、保守性を確保するために、特定のベスト プラクティスに従うことが重要です。オブジェクト名は、レポート テンプレートに表示されるチャートとテーブルのタグです。Qlik Sense のテーブル、チャート、その他の要素などのオブジェクト命名に関する推奨事項を以下に示します。

• 各オブジェクトには一意の名前を使用します。混乱を招き、誤ったオブジェクトを追加する原因となる重複を避けます。

• 明確でわかりやすい名前を使用します。オブジェクトの目的と内容を正確に反映した名前を選択します。ユーザーを混乱させる可能性がある、あいまいな名前や一般的な名前は避けます。

• 簡潔で情報を提供できる名前にします。オブジェクトの機能やデータを伝えるのに十分な情報を提供しながら、簡潔な名前にします。長く複雑な名前は扱いにくい可能性があります。

• 一貫した命名規則を使用します。アプリ内のすべてのオブジェクトで一貫した命名規則を確立し、その規則に従います。 これにより、論理構造が維持され、オブジェクトの検索、識別、管理が容易になります。

• 特殊文字の使用は避けます。オブジェクト名には英数字とアンダースコアを使用します。特殊文字は、スクリプトまたは数式で問題の原因となる可能性があります。

• スペースの代わりに、キャメル ケースまたはアンダースコアを使用: オブジェクト名の単語を区切るには、キャメル ケース (myTable) またはアンダースコア (my_table) のいずれかを選択します。そうすることで読みやすくなり、名前を理解しやすくなります。

• 予約キーワードの使用は避けます。Qlik Sense には、オブジェクト名として使用すべきではない予約キーワードがあります。これらのキーワードは、数式、スクリプト、または Qlik Sense 環境で使用されます。たとえば、「if」、「and」、「or」、「load」などです。

• 軸とメジャーには、意味がある直感的な名前を使用します。チャート内で軸とメジャーを作成するときは、それらが表す基礎となるデータまたは計算を明確に説明する名前を使用します。これにより、開発者とエンドユーザー間の理解とコラボレーションが強化されます。

• ドキュメントの命名規則。Qlik Sense アプリで使用される命名規則の概要を説明するドキュメントを維持します。そうすることで、新しい開発者が命名規則を理解でき、複数の開発者が同じアプリで作業する場合に一貫性が確保されます。

• オブジェクト名を定期的に見直して更新します。アプリの進化や、要件の変化があった場合は、オブジェクト名を定期的に見直して更新し、アプリの現在の構造や機能と一致していることを確認します。