リアルタイムHCL Domino のデータをビルトインPower Apps のカスタムビジネスアプリに統合

加藤龍彦
デジタルマーケティング

CData Connect AI を使用してHCL Domino のデータに接続し、リアルタイムでデータをMicrosoft Power Apps で構築されたアプリに統合します。

Power Apps は、ソフトウェア開発の時間を短縮しつつ、データに接続してWeb とモバイル両方で機能するカスタムビジネスアプリを構築および使用するためのサービスです。CData Connect AI と組み合わせると、Power Apps を使用して構築したアプリからHCL Domino のデータにクラウドベースでアクセスできます。この記事では、Power Apps からConnect AI に接続し、リアルタイムHCL Domino のデータを使用してアプリを構築する方法を説明します。

Connect AI からHCL Domino に接続する

CData Connect AI では、直感的なクリック操作ベースのインターフェースを使ってデータソースに接続できます。

Connect AI にログインし、 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 と同じです。
Create & Test をクリックします。
Edit HCL Domino Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

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

OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン（PAT）を作成できます。きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

Connect AI アプリの右上にあるユーザー名をクリックし、User Profile をクリックします。
User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
PAT の名前を入力して Create をクリックします。
パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

コネクションが構成されたら、Power Apps からHCL Domino に接続できるようになります。

CData Connect AI に接続する

Connect AI を使用してHCL Domino のデータをPower Apps に統合するには、新しいSQL Server 接続が必要です。

Power Apps にログインします。
Dataverse -> Connections -> New connection とクリックします。
SQL Server を選択します。
接続ウィザードにて：
- 「直接接続」を選択します。
- SQL server name をtds.cdata.com,14333 に設定します。
- SQL database name をHCL Domino 接続の名前（Domino1 など）に設定します。
- Username をConnect AI のユーザーに設定します。（user@mydomain.com）
- Password を上記のユーザーのPAT に設定します。
- 作成をクリックします。

HCL Domino のデータを活用するアプリを構築する

Connect AI への接続が構成されたら、リアルタイムでHCL Domino のデータをPower Apps で構築したアプリに統合することができます。

Power Apps にログインします。
「Create」をクリックし、「SQL」を選択します。
作成したSQL Server 接続を選択します。
使用するテーブルを検索または選択します。
Connect をクリックします。
新しく作成したアプリのレイアウトや、BrowseScreen、DetailScreen、EditScreen で表示されるフィールドの設定などを、ほかのアプリと同じようにカスタマイズします。