Jitterbit でライブ HCL Domino のデータと連携

Mohsin Turki
Technical Marketing Engineer

CData Connect AI を使用して、Jitterbit でライブ HCL Domino のデータに接続・連携します。

Jitterbit は、データワークフローを効率化できるエンタープライズ iPaaS（Integration Platform as a Service）です。CData Connect AI と組み合わせることで、Jitterbit からライブ HCL Domino のデータにアクセスできます。この記事では、Connect AI を使用して HCL Domino に接続し、Jitterbit でライブ HCL Domino のデータと連携する方法を説明します。

CData Connect AI は HCL Domino 用の純粋な OData インターフェースを提供し、ネイティブにサポートされているデータベースにデータをレプリケーションすることなく、HCL Domino からデータをクエリできます。CData Connect AI は最適化されたデータ処理機能を標準で備えており、サポートされているすべての SQL 操作（フィルタ、JOIN など）を HCL Domino に直接プッシュし、サーバーサイド処理を活用して、リクエストされた HCL Domino のデータを迅速に返します。

Jitterbit 向けに HCL Domino 接続を構成

Jitterbit から HCL Domino のデータを操作するには、Connect AI から HCL Domino に接続し、ユーザーにアクセス権を付与し、HCL Domino のデータ用のワークスペースを作成する必要があります。

Connect AI から HCL Domino に接続

CData Connect AI は、シンプルなポイント＆クリックインターフェースを使用してデータソースに接続します。

Connect AI にログインし、Sources をクリックして、 Add Connection をクリックします。

Add Connection パネルから「HCL Domino」を選択します。

HCL Domino に接続するために必要な認証プロパティを入力します。
Domino への接続

それでは、Domino のデータに接続していきましょう。接続するには、以下のプロパティを設定してください。
- URL：Domino データベースをホスティングしているサーバーのホスト名またはIP アドレス。Domino データベースをホスティングしているサーバーのポートを含めます。例：http://sampleserver:1234/
- DatabaseScope：Domino Web UI でのスコープ名。CData 製品は、指定されたスコープに適合するスキーマのフォームとビューを公開します。Domino Admin UI で、サイドバーのScopes メニューを選択してください。このプロパティを既存のスコープ名に設定します
Domino での認証

続いて、認証方法を設定しましょう。Domino では、ログインクレデンシャル（OAuthPassword）またはMicrosoft Entra ID（AzureAD）のいずれかによる認証をサポートしています。

ログインクレデンシャル

ログインクレデンシャルで認証するには、以下のプロパティを設定してください：
- AuthScheme：OAuthPassword
- User：認証するDomino ユーザーのユーザー名
- Password：認証するDomino ユーザーに関連付けられたパスワード
ドライバーがログインクレデンシャルを使用して、自動的にOAuth トークン交換を実行します。

Microsoft Entra ID（Azure AD）

この認証方法は、Azure Active Directory をIdP として使用してJWT トークンを取得します。Azure Active Directory にカスタムのアプリケーションを作成し、それをIdP として設定する必要があります。詳しい手順については、ヘルプドキュメントの指示に従ってください。その後、以下のプロパティを設定します。
- AuthScheme：AzureAD
- InitiateOAuth：これをGETANDREFRESH に設定します。InitiateOAuth を使用すると、OAuth 交換の繰り返しやOAuthAccessToken の手動設定を避けることができます
- OAuthClientId：カスタムAzure AD アプリケーションの作成時に取得したクライアントID
- OAuthClientSecret：カスタムAzure AD アプリケーションの作成時に取得したクライアントシークレット
- CallbackURL：カスタムAzure AD アプリケーションの登録時に指定されたリダイレクトURI。例えば、https://localhost:33333
- AzureTenant：データにアクセスするために使用されるMicrosoft Online テナント。companyname.microsoft.com 形式の値またはテナントID のいずれかを指定してください
テナントID は、Azure ポータルのAzure Active Directory > プロパティページに表示されているディレクトリID と同じです。
Save & Test をクリックします。
Add HCL Domino Connection ページの Permissions タブに移動し、User-based permissions を更新します。

パーソナルアクセストークンの追加

REST API、OData API、または仮想 SQL Server を介して Connect AI に接続する場合、パーソナルアクセストークン（PAT）を使用して Connect AI への接続を認証します。アクセスの粒度を維持するために、サービスごとに別々の PAT を作成することをお勧めします。

Connect AI アプリの右上にある歯車アイコン（）をクリックして、設定ページを開きます。
Settings ページで Access Tokens セクションに移動し、 Create PAT をクリックします。
PAT に名前を付け、Create をクリックします。
パーソナルアクセストークンは作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。

Jitterbit 向けに HCL Domino エンドポイントを構成

HCL Domino に接続した後、目的のテーブル用のワークスペースを作成します。

Workspaces ページに移動し、 Add をクリックして新しいワークスペースを作成します（または既存のワークスペースを選択します）。
Add をクリックして、ワークスペースに新しいアセットを追加します。
HCL Domino 接続（例：Domino1）を選択し、Next をクリックします。
操作するテーブルを選択し、Confirm をクリックします。
ワークスペースの OData Service URL（例：https://cloud.cdata.com/api/odata/{workspace_name}）をメモしておきます。

接続、PAT、およびワークスペースの構成が完了すると、Jitterbit から HCL Domino のデータに接続する準備が整います。

Connect AI を使用して Jitterbit から HCL Domino に接続

OData プロトコルを使用して Jitterbit から CData Connect AI への接続を確立するには、以下の手順に従います。

Jitterbit にログインします。
Cloud Studio でプロジェクトを作成し、ワークスペース環境を設定します。
Sources をクリックし、検索バーに OData と入力します。
OData コネクタを選択します。
OData 接続プロパティを入力します。

Connection Name：接続名を入力します。
OData Metadata URL：https://cloud.cdata.com/api/odata/{workspace_name} と入力します。
Authentication：Basic Auth を選択します。
User Name：CData Connect AI のユーザー名を入力します。これは CData Connect AI インターフェースの右上に表示されます（例：[email protected]）。
Password：Settings ページで生成した PAT を入力します。