Excel からMicrosoft Query を使ってHCL Domino に接続する方法

この記事では、CData ODBC ドライバを使って、Microsoft Query でExcel にデータをインポートします。Microsoft Query でパラメータを使う方法も説明します。

古川えりか
コンテンツスペシャリスト

最終更新日:2023-09-07

この記事で実現できるHCL Domino 連携のシナリオ

こんにちは!ドライバー周りのヘルプドキュメントを担当している古川です。

Microsoft Query を使うことで、Excel からデータベースやファイル、外部データソースにアクセスしてデータをインポート、更新できます。CData ODBC Driver for Domino はMicrosoft Query の連携先を拡張して、270種類以上のCRM、ERP、MA、会計ツールなどのデータソースへのアクセスを実現します。 この記事では、Microsoft Query を使ってHCL Domino のデータをスプレッドシートにインポートする方法をご紹介します。

CData ODBC ドライバとは?

CData ODBC ドライバは、以下のような特徴を持った製品です。

  1. HCL Domino をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレデータソースに対応
  2. Excel やMicrosoft Query をはじめとする多様な帳票・BI ツールにHCL Domino のデータを連携
  3. ノーコードでの手軽な接続設定
  4. 標準SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてHCL Domino の接続を設定、2.Microsoft Query でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

HCL Domino への接続を設定

まずは、本記事右側のサイドバーからDomino ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

ODBC ドライバーのインストール完了時にODBC DSN 設定画面が立ち上がります。または、Microsoft ODBC データソースアドミニストレーターを使ってDSN を作成および設定できます。

Domino への接続

Domino のデータに接続するには、以下のプロパティを設定してください。

  • URL: Domino データベースをホスティングしているサーバーのホスト名、またはIP を入力します。サーバーのポート番号を含めてください。例えば、http://sampleserver:1234/
  • DatabaseScope: Domino Web UI 内のスコープ名を入力します。ドライバーは、ここで指定したスコープによって制御されるスキーマの、フォームとビューを公開します。Domino Admin UI で、サイドバーからScopes メニューを選択します。このプロパティを、既存のスコープ名に設定します。

Domino での認証

Domino は、ログインクレデンシャルまたはAzure Active Directory OAuth アプリケーションを使用した認証をサポートしています。

ログインクレデンシャル

ログインクレデンシャルで認証するには、以下のプロパティを設定してください:

  • AuthScheme: これを"OAuthPassword" に設定します
  • User: 認証するDomino ユーザーのユーザー名
  • Password: 認証するDominoユ ーザーに関連付けられたパスワード

ドライバーはログインクレデンシャルを使用して、自動的にOAuth トークン交換を実行します。

AzureAD

この認証方法は、Azure Active Directory をIdP として使用してJWTトークンを取得します。Azure Active Directory にカスタムのアプリケーションを作成し、それをIdP として設定する必要があります。そのためには、ヘルプドキュメントの指示に従ってください。その後、以下のプロパティを設定します。

  • AuthScheme: これを"AzureAD" に設定します
  • InitiateOAuth: これをGETANDREFRESH に設定します。InitiateOAuth を使用すると、OAuth 交換の繰り返しやOAuthAccessToken の手動設定を避けることができます。
  • OAuthClientId: カスタムOAuth アプリケーションのセットアップ時に取得したクライアントID
  • OAuthClientSecret: カスタムOAuth アプリケーションのセットアップ時に取得したクライアントシークレット
  • CallbackURL: アプリ登録時に定義したリダイレクトURI。例えば、https://localhost:33333
  • AzureTenant: データにアクセスするために使用されるMicrosoft Online テナント。companyname.microsoft.com 形式の値またはテナントID のいずれかを指定してください。

    テナントID は、Azure ポータルのAzure Active Directory > プロパティページに表示されているディレクトリID と同じです。

Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法の詳細は、ヘルプドキュメントの「はじめに」を参照してください。

  • Excel で[データ]タブを開き[その他のデータソースから]->[Microsoft Query から]を選びます。
  • Open Microsoft Query from the Data tab.
  • マシンにインストールされているMicrosoft Office のバージョンに合わせて、32 bit CData HCL Domino Source または64 bit CData HCL Domino Source x64 DSN を選びます。Query Wizard を使うオプションを選択し、クエリを作成/編集します。
  • The list of available ODBC DSNs in the Choose Data Source dialog.
  • Query Wizard で、スプレッドシートにインポートしたいテーブルのノードを展開します。インポートしたいカラムを選択し、矢印をクリックしてクエリに追加します。あるいはテーブル名を選択して、テーブルにあるすべてのカラムを追加します。
  • Available tables and columns in the Choose Columns step of the Query Wizard. (Salesforce is shown.)
  • [Filter Data]ページではクライテリアを指定できます。例えば、日付の範囲を設定して結果を絞れます。
  • The Filter Data step of the Query Wizard. (Salesforce is shown.)
  • クエリでパラメータを使いたい場合は、Microsoft Query でクエリを編集するオプションを選択します。
  • クエリにパラメータを設定するには、SQL を直接修正する必要があります。その場合は、[Query Editor]の[SQL]ボタンをクリックします。フィルタクライテリアを事前に設定している場合は、クエリ内にWHERE 句が存在します。
  • パラメータを使うには、WHERE 句のフィールド値にワイルドカード文字として "?" を使います。例えばByName をインポートしている場合は、"City=?" を設定できます。
  • SQL ステートメントの編集が終わったら[SQL]ダイアログを閉じます。パラメータ値を入力するように促されますが、次のステップでセルを選択して値を入れることになるので、このダイアログではボックスは空のままにしておきます。
  • The generated SQL statement. (Salesforce is shown.)
  • Microsoft Query を閉じます。[Import Data]ダイアログが表示されます。結果をインポートするセルを入力します。 The Import Data dialog.
  • [Import Data]ダイアログを閉じます。パラメータ値を入力するように促されます。パラメータボックスの隣にあるボタンをクリックしてセルを選択します。値が変更されたらスプレッドシートを自動的にリフレッシュするオプションを選択します。 データはこれでExcel にインポートされました。セルB1の値を変更すると、データは指定した検索クライテリアによってフィルタされます。 The results of the query, with the search criteria applied. (Salesforce is shown.)

    おわりに

    このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをMicrosoft Query からコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。

    日本のユーザー向けにCData ODBC ドライバは、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。

  • 関連コンテンツ

    トライアル・お問い合わせ

    30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。