Zapier で HCL Domino 連携の自動ワークフローを構築

Jerod Johnson
Director, Technology Evangelism

CData Connect AI を使用してリアルタイムのHCL Domino のデータに接続し、Zapier で自動ワークフローを構築する方法を解説します。

Zapier は、アプリとサービスを連携させるオンライン自動化ツールです。CData Connect AI と組み合わせることで、ワークフローでリアルタイムのHCL Domino のデータにアクセスできます。この記事では、HCL Domino に接続し、Zapier でリアルタイムのHCL Domino のデータを使ったワークフローを構築する方法をご紹介します。

Zapier から HCL Domino に接続

Zapier で HCL Domino を使用するには、Connect AI から HCL Domino に接続し、接続へのユーザーアクセスを提供し、HCL Domino のデータ用のワークスペースを作成する必要があります。

Connect AI から HCL Domino に接続

CData Connect AI は、シンプルなポイント＆クリックのインターフェースでデータソースに接続できます。

Connect AI にログインして「Sources」をクリック、次に「 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」をクリック
HCL Domino 接続の追加ページで「Permissions」タブに移動し、ユーザーベースの権限を更新します。

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

REST API、OData API、または仮想 SQL Server を通じて Connect AI に接続する場合は、パーソナルアクセストークン（PAT）を使用して認証を行います。アクセス管理を細かく制御するため、サービスごとに個別の PAT を作成することをお勧めします。

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

Zapier 向けに HCL Domino エンドポイントを設定

HCL Domino への接続が完了したら、使用したいテーブル用のワークスペースを作成します。

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

接続、PAT、ワークスペースの設定が完了したら、Zapier からHCL Domino のデータに接続する準備は完了です。

Zapier ワークフローで HCL Domino に接続

Zapier から CData Connect AI への OData プロトコル経由での接続を確立するには、以下の手順に従います。

Zapier にログインします。
Create Zap をクリックします。
表示されるダイアログで「Webhooks by Zapier」を検索し、下に表示されるオプションをクリックします。
Event で Retrieve Poll を選択します。
接続の詳細を入力します。
- URL: OData URL を入力（例: https://cloud.cdata.com/api/odata/{workspace_name}）
- Key: 「value.name」と入力
- Authentication details: Basic Auth または Headers を入力します。Basic オプションでは、ユーザー（Connect AI のユーザー名、例: [email protected]）とパスワード（先ほど作成した PAT）をパイプ記号 | で区切って指定します。Headers オプションでは、エンコードされた認証情報を含むリクエストタイプヘッダーを指定します。
Test をクリックします。接続が正しく設定されていれば、サンプルレコードが表示されます。