こんにちは!ドライバー周りのヘルプドキュメントを担当している古川です。
CData ODBC Driver for Domino は、ODBC 標準に準拠しており、BI ツールからIDE まで幅広いアプリケーションでHCL Domino への接続を提供します。
この記事では、CPM/BIツールのBoardからHCL Domino に接続、レポートを作成する方法を説明します。
CData ODBC ドライバとは?
CData ODBC ドライバは、以下のような特徴を持った製品です。
- HCL Domino をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレデータソースに対応
- 多様なアプリケーション、ツールにHCL Domino データを連携
- ノーコードでの手軽な接続設定
- 標準SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてHCL Domino の接続を設定、2.board 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとHCL Domino への接続設定
まずは、本記事右側のサイドバーからDomino ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
- インストール後、ODBCデータソースアドミニストレーターにて[システムDSN]タブをクリックし、CData HCL Domino Source Sys(64bit or 32bit)の接続情報を構成します。(※BoardはシステムDSNのみに対応しています。ユーザーDSNの場合接続できませんので、ご注意ください。)
-
Domino 接続プロパティの取得・設定方法
接続の前に
CData 製品を経由してDomino に接続するには、「Proton コンポーネント」のインストールが必要です。通常、
Proton はAppDev パックの一部として配布されています。Proton またはAppDev パックの入手およびインストール方法については、HCL のドキュメントを参照してください。
CData 製品は匿名アクセス、またはクライアント証明書の提供によりProton を認証できます。
これらのオプションは両方ともDomino で特定の設定が必要です。
次の2セクションでは、接続に必要な事前設定について説明します。使用したい認証方法に対応するセクションを参照してください。
クライアント証明書による認証の設定
クライアント証明書による認証では、CData 製品は専用のユーザーアカウントとして接続します。このユーザーには、接続するすべてのデータベースに対するdesigner
またはそれ以上のアクセス権が付与する必要があります。
また、CData 製品を使用するためにはユーザーがインターネット証明書を取得する必要があります。サーバーコンソールで以下のコマンドを実行することで、Proton にこの証明書を作成させることができます。
APPUSER はCData 製品でアクセス設定するユーザーアカウント名、ADMINISTRATOR は証明書を受け取るユーザー名です。
load proton --setupclient "APPUSER" --sendto "ADMINISTRATOR"
新しい証明書は、Notes のADMINISTRATOR
メールボックスから利用できます。証明書は、クライアント証明書(clientcert)およびキー(clientkey)の2ファイルに分けて送信される場合があります。
キーファイルのテキストを証明書ファイルの末尾にコピーアンドペーストして、2つのファイルを結合する必要があります。
匿名認証の設定
匿名アクセスでは、CData 製品はAnonymous という一般的なユーザーアカウントで接続します。
接続するすべてのデータベースには、次の2つの権限が設定される必要があります。
- Anonymous ユーザーには、designer またはそれ以上のデータベースへのアクセス権が付与される必要があります。
- データベースは、Maximum Internet name and password オプションがdesigner またはそれ以上のアクセスに設定される必要があります。
この設定は、データベースのAccess Control List オプションのAdvanced タブにあります。
Domino への接続
接続するには以下を設定します。
- Server:Proton サービスを使ってDomino を実行中のサーバーのIP アドレス。
- Port:Proton サービスがリッスンしているポート番号。
- Database:.nsf 拡張子を含むデータベースファイル名。
- SSLServerCert:サーバーが受け入れ可能なTLS/SSL 証明書に設定。コンピュータによって信頼されていない他の証明書はすべて拒否されます。または、"*"
を設定するとすべての証明書を受け入れます。
Domino への認証
CData 製品は、クライアント証明書を使用してProton に認証することも、匿名アクセスで認証することも可能です。
クライアント証明書による認証
クライアント証明書で認証するには以下を設定します。
- AuthScheme:SSLCertificate に設定。
- SSLClientCertType:これは、証明書ファイルの形式と一致する必要があります。
通常、.pem 証明書の場合はPEMKEY_FILE、.pfx 証明書の場合はPFXFILE のいずれかになります。
- SSLClientCert:証明書ファイルへのパス。
匿名認証
匿名認証を使用するには、AuthScheme をAnonymous に設定します。
Board DB の作成
最初にBoardの接続情報やキューブ等を格納するDBを作成します。
- Boardを立ち上げて、任意の接続先へ接続します。
- [Database]タブから[New DB]をクリックします。
- 開いたDB作成用ウィンドウにて、任意の[Database name][Language][From Year][To Year]を入力し[OK]をクリックします。
SQL FastTrackを用いたODBCデータソースからのデータロード
次にSQL FastTrackの機能を用いてODBCデータソースから HCL Domino のデータをBoard上にロードします。
- [Database]タブの[SQL FastTrack]をクリックし、Data souceの[New]ボタンをクリックします。
- 接続先を設定するためのウィンドウが表示されますので、[OLE-DB Wizard]をクリックします。
- 開いたデータリンクプロパティの[プロバイダー]タブから[Microsoft OLE DB Provider for ODBC Drivers]を選択し、[次へ]をクリックします。
- [接続タブ]の[1.データソースを指定します]から事前に設定したODBC DSNを選択し、[3.使用する初期カタログを入力します]に[CData]を入力の上、[OK]をクリックします。
- 任意の[Name]を入力し[Save & Connect]をクリックします。
- SQL FastTrackの画面に戻った後、[Connect]をクリックします。
- Connectをクリック後、Data souce画面左側に HCL Domino のテーブル一覧が表示されます。分析対象とするテーブルをダブルクリックすると、自動的にSQL クエリが記述されます。記述内容を確認の上、[Execute Query]をクリックします。
- Execute Queryをクリックすると、テーブルに格納された項目一覧が以下の図のように表示されます。分析で使用したい任意の項目を[Code][Desc][Cube]のいずれかにチェックを入れ、Cube/Entityを入力し、Track実行ボタンをクリックします。
- 確認ダイアログが表示されますので、[Yes]をクリックします。
- SQL FastTrackの機能により、ODBC データソースからデータがロードされ、自動的にEntityとCubeが生成されます。
- 以下のダイアログが表示されれば、Boardへのデータロードは完了です。
グラフの作成
ロードしたデータを元に簡単なグラフの作成方法を紹介します。
- 最初に各種Screenを格納するためのCapsuleを作成します。[Home]タブを選択し[Capsule]から[New Capsule]をクリックします。
- 任意の[Capsule Name]を入力し[OK]をクリックします。
- 続いてScreenを作成するための画面が表示されるため任意の[Screen Name]を入力し[OK]をクリックします。
- Screenが作成されると、ChartやDataViewを配置することが可能になります。[Charts]から[Chart]を選択し、Screenにドラッグ・アンド・ドロップでChartを配置します。
- 以下のようにChartを配置後、右クリックメニューで[Layout]をクリックします。
- LayoutでChart上のValueとして扱う値を指定します。[Data]タブから[Double-click here to create a block]の箇所をダブルクリックします。
- [Data Selection]から先程のSQL FastTrackにてCubeの指定をした任意の値を選択し[OK]をクリックします。
- 続いて[Axes]タブをクリックし、先程指定した値の分析軸とするBy Rowに任意の項目を選択し[OK]をクリックします。
- 設定完了後、以下のようにグラフが表示されます。
このようにDomino 内のデータをAPI を書くことなくBoard上で利用することができるようになります。