SnapLogic でHCL Domino を外部サービスに連携

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

SnapLogic はintegration Platform-as-a-Service（iPaaS）であり、ユーザーはノーコードでデータ連携フローを作成できます。CData JDBC ドライバと組み合わせることで、ユーザーはSnapLogic ワークフローからHCL Domino を含む250を超えるSaaS、ビッグデータ、NoSQL データソースのリアルタイムデータに接続できます。

組み込みの最適化されたデータ処理によって、CData JDBC Driver はリアルタイムHCL Domino のデータを高速に扱えます。プラットフォームがHCL Domino に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をHCL Domino に直接プッシュし、サポートされていない操作（主にSQL 関数とJOIN 操作）は組み込みSQL エンジンを利用してクライアント側で処理します。組み込みの動的メタデータクエリを使用すると、ネイティブデータソース型を使用してHCL Domino のデータを操作することができます。

SnapLogic からHCL Domino に接続する

SnapLogic からHCL Domino のデータに接続するには、CData HCL Domino JDBC Driver をダウンロードしてインストールします。インストール画面に従ってください。インストールが完了すると、インストール先のディレクトリ（デフォルトでは、C:/Program Files/CData/CData JDBC Driver for Domino/lib）にJAR ファイルが作成されます。

HCL Domino JDBC Driver をアップロードする

インストール後、JDBC JAR ファイルをSnapLogic 内のディレクトリ（例えば、projects/Jerod Johnson）にManager タブからアップロードします。

接続を設定する

JDBC Driver がアップロードされると、HCL Domino への接続を作成できます。

1. Designer タブに移動します。
2. Snaps から「JDBC」を展開して、「Generic JDBC - Select」snap をdesigner にドラッグします。
3. Add Account をクリック（または既存のものを選択）して、「Continue」をクリックします。
4. 次のフォームでは、JDBC 接続プロパティを設定します。
   • JDBC JARs 以下にアップロードしたJAR ファイルを追加します。
   • JDBC Driver Class をcdata.jdbc.domino.DominoDriver に設定します。

   • JDBC URL をHCL Domino JDBC Driver 用のJDBC 接続文字列に設定します。例えば、

     jdbc:domino:Server=https://domino.corp.com;Database=names.nsf;Port=3002;SSLClientCertType=PEMKEY_FILE;SSLClientCert=full_path_of_certificate.pem;SSLServerCert=*RTK=XXXXXX;

     です。

     NOTE： RTK は評価版もしくは製品版のキーです。詳しくは、CData のサポートチームにご連絡ください。

     組み込みの接続文字列デザイナー

     JDBC URL の作成の補助として、HCL Domino JDBC Driver に組み込まれている接続文字列デザイナーが使用できます。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

     java -jar cdata.jdbc.domino.jar

     接続プロパティを入力し、接続文字列をクリップボードにコピーします。

     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 と同じです。

5. 接続プロパティの入力後、「Validate」、そして「Apply」をクリックします。

HCL Domino のデータを読み込む

接続を検証、適用後に開くフォームで、クエリを設定します。

• Schema name を"Domino" に設定します。
• Table name を、スキーマ名を使用したHCL Domino 用のテーブルに設定します。例えば、"Domino"."ByName" です（ドロップダウンを使用して利用可能なテーブルの全リストを確認できます）。
• テーブルから、使用したい項目ごとにOutput fields を追加します。

Generic JDBC - Select snap を保存します。

接続とクエリを設定したら、snap の終端部分（以下のハイライト部分）をクリックしてデータをプレビューします。

結果が期待どおりのものであることを確認したら、他のsnap を追加してHCL Domino のデータを別のエンドポイントに渡すこともできます。

HCL Domino のデータを外部サービスにパイプ

本記事では、データをGoogle Spreadsheet にロードします。他のあらゆるサポートされているsnap が使用でき、Generic JDBC snap を他のCData JDBC ドライバと利用してデータを外部サービスに移すこともできます。

1. まず、「Worksheet Writer」snap を"Generic JDBC - Select" snap の終端部分にドロップします。
2. Google Sheets に接続するアカウントを追加します。
3. Worksheet Writer snap を、HCL Domino のデータをGoogle Spreadsheet に書き込むよう設定します。

これで、接続済みのパイプラインを実行してHCL Domino からデータを抽出し、Google Spreadsheet にプッシュできます。

詳細情報と無償評価版

CData JDBC Driver for Domino を使えば、HCL Domino のデータを外部サービスに連携するためのパイプラインをSnapLogic で作成できます。HCL Domino への接続に関する詳細については、CData のHCL Domino 連携ページを参照してください。30日の無償評価版をダウンロードして今すぐ使い始めましょう。