各製品の資料を入手。
詳細はこちら →Connect Cloud 経由でRunMyProcess のHCL Domino のデータに接続
CData Connect Cloud を使用してHCL Domino のデータのOData API を作成し、Akorbi Digital RunMyProcess からデータに接続します。
最終更新日:2022-03-07
この記事で実現できるHCL Domino 連携のシナリオ
こんにちは!テクニカルディレクターの桑島です。
Akorbi Digital RunMyProcess は、予算申請や契約管理などの複雑な業務アプリケーションを簡単に作成することができます。CData Connect Cloud は、HCL Domino へのリアルタイム接続を作成し、HCL Domino のOData API(RunMyProcess でネイティブにサポート)を生成するために使用できます。RunMyProcess をCData Connect Cloud と組み合わせすることで、すべてのSaaS およびクラウドベースのビッグデータとNoSQL データソースへ、データを移行したり統合したりする必要なくクラウドベースの接続が可能になります。ほかのREST サービスと同様に、RunMyProcess からConnect Cloud に接続するだけで、HCL Domino のデータに瞬時にリアルタイムでアクセスできます。
この記事では、CData Connect Cloud からHCL Domino に接続し、RunMyProcess でOData フィードを通じてHCL Domino にアクセスする手順を説明します。
Connect Cloud アカウントの取得
以下のステップを実行するには、CData Connect Cloud のアカウントが必要になります。こちらから製品の詳しい情報とアカウント作成、30日間無償トライアルのご利用を開始できますので、ぜひご利用ください。
Connect Cloud を構成する
RunMyProcess でHCL Domino のデータをリアルタイムで操作するには、Connect Cloud からHCL Domino に接続し、コネクションにユーザーアクセスを提供してHCL Domino のデータのOData エンドポイントを作成する必要があります。
(オプション)新しいConnect Cloud ユーザーの追加
必要に応じて、Connect Cloud 経由でHCL Domino に接続するユーザーを作成します。
- ユーザーページに移動し、 Invite Users をクリックします。
- 新しいユーザーのE メールアドレスを入力して、 Send to invite the user をクリックします。
- ユーザーページからユーザーを確認および編集できます。
パーソナルアクセストークンの追加
OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン(PAT)を作成できます。きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。
- Connect Cloud アプリの右上にあるユーザー名をクリックし、User Profile をクリックします。
- User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
- PAT の名前を入力して Create をクリックします。
- パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。
Connect Cloud からHCL Domino に接続
CData Connect Cloud では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。
- Connect Cloud にログインし、 Add Connection をクリックします。
- Add Connection パネルから「HCL Domino」を選択します。
-
必要な認証プロパティを入力し、HCL Domino に接続します。
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 と同じです。
- Create & Test をクリックします。
- Edit HCL Domino Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。
Connect Cloud にHCL Domino OData エンドポイントを追加する
HCL Domino に接続したら、目的のテーブルのOData エンドポイントを作成します。
- OData ページに移動し、 Add to create new OData endpoints をクリックします。
- HCL Domino コネクション(例:Domino1)を選択し、Next をクリックします。
- 使用するテーブルを選択し、Confirm をクリックします。
OData フィードのサンプルURL
HCL Domino への接続を構成してユーザーを作成し、Connect Cloud でOData エンドポイントを作成すると、HCL Domino のデータのOData フィードにアクセスできるようになります。 以下は、テーブルにアクセスするためのURL とテーブルのリストです。テーブルへのアクセスについては、Connect Cloud のOData ページを参照してください。URL については、Connect Cloud のURL が必要になります。(例: https://cloud.cdata.com/api/odata/service)
テーブル | URL | |
---|---|---|
エンティティ(テーブル)一覧 | https://cloud.cdata.com/api/odata/service/ | |
メタデータ | https://cloud.cdata.com/api/odata/service/$metadata | |
ByName | https://cloud.cdata.com/api/odata/service/ByName |
通常のOData フィードについては、返されるフィールドを制限したい場合は、クエリに$select パラメータと$filter、$orderby、$skip、$top といった他の一般的なOData URL パラメータを組み合わせて追加できます。 サポートされているOData クエリの詳細についてはヘルプドキュメントを参照してください。
コネクションとOData エンドポイントを設定したら、RunMyProcess からHCL Domino のデータに接続できます。
RunMyProcess DigitalSuite Studio からHCL Domino のデータを取得する
HCL Domino への接続と構成されたOData エンドポイントがあれば、RunMyProcess にHCL Domino のデータを追加して取得することができます。
Provider を作成する
- RunMyProcess にログインしDigitalSuite Studio を開きます。
- 「Resources」をクリックしてResources ページを立ち上げ、「CONNECTORS」タブを選択します。
- 新規プロバイダーを作成する場合は、「+(New Provider)」ボタンをクリックし、使用するアカウントを選択し、「Confirm」をクリックします。
- 設定ページで次のプロパティを設定します。
- URL:Connect Cloud OData ページのOData エンドポイントを設定します。https://cloud.cdata.com/api/odata/service
- Authentication Schema:ログイン / パスワードを選択します。
- Login:Connect Cloud のユーザー名を指定します。(例:[email protected])
- Password:Connect Cloud ユーザーのPAT を指定します。
- 「ACCEPTANCE」、「TEST」タブにも同じ情報を入力します。Note:その際、「Copy this configuration button」ボタンをクリックすることで設定をコピーでき、コピー先のタブで「Paste previously copied configuration」をクリックして内容をペーストできます。
- 「Save」をクリックしてプロパティを保存します。
コネクタを作成してHCL Domino のデータを取得する
- 「CONNECTOR」タブで三点リーダーをクリックし、プロバイダーを作成します。メニューからAdd を選択します。
- 次に示すページでは、Connect Cloud で設定されたOData エンドポイントにConnector URL を設定する方法を説明します。(例: https://cloud.cdata.com/api/odata/service)
- 「Save」、「Launch」の順でクリックし接続の実行をテストします。「Launch test」をクリックして実行します。設定したテーブル情報のJSON レスポンスが得られれば、処理は成功です。
詳細と無料トライアル
これで、HCL Domino のデータを取得するためのプロバイダーとコネクタが作成されました。HCL Domino(および100を超えるほかのデータソース)からのOData フィードの作成方法の詳細については、Connect Cloud ページにアクセスしてください。無償トライアルにサインアップして、RunMyProcess でリアルタイムHCL Domino のデータの操作をはじめましょう。