RPA AutoMate でHCL Domino のデータを連携利用
AutoMate はHelpSystems 社が提供するRPA ツールです。700項目の自動化機能と15種類の自動実行トリガーが選択可能であるためあらゆるシーンを自動化することが可能です。
また、データベースにODBC経由で接続できるアクションが含まれており、CData ODBC Driverと組み合わせることでCData が対応しているさまざまなデータソースとノーコードで連携ができるようになります。
この記事では、AutoMate と CData ODBC ドライバを使って、HCL Domino に連携するタスクを作成します。
CData ODBC ドライバとは?
CData ODBC ドライバは、以下のような特徴を持った製品です。
- HCL Domino をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレデータソースに対応
- 多様なアプリケーション、ツールにHCL Domino のデータを連携
- ノーコードでの手軽な接続設定
- 標準SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてHCL Domino の接続を設定、2.Automate 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとHCL Domino への接続設定
まずは、本記事右側のサイドバーからDomino ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
- まずODBC DSN に必要な接続プロパティの値を入力します。 組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を構成できます。 これは、ドライバのインストール時の最後のステップでも可能です。 Microsoft ODBC データソースアドミニストレータを使用してDSN を作成および設定する方法については、ヘルプドキュメントの「はじめに」の章を参照してください。
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 と同じです。
- 入力後、接続テストが成功すれば設定は完了です。
AutoMate でタスクを作成する
それでは AutoMate でタスクを作成していきましょう。
- タスク アドミニストレーターを起動し新規タスクを作成します。
- 任意のタスク名を入力して、次へ進みます。
- トリガーを追加し、タスクビルダーを起動します。「タスクビルダーを開始する」をクリックします。
AutoMate でHCL Domino へのDB 接続を構成
続いて AutoMate でODBC への接続構成を行います。
- ODBC 接続は「データベース」のアクションを使って構成していきます。
- まずは接続を確立します。「SQL 接続を開く」アクションをドラッグアンドドロップで配置しましょう。
- プロパティの「接続」で接続設定をします。「接続の構築」をクリックします。
- 接続するプロバイダーを選択します。「Microsoft OLE DB Provider for ODBC Drivers」を選択します。
- データソースを指定します。接続設定は完了です。
HCL Domino のデータをAutoMate で扱う
接続セッションの構成が完了したら、実際にデータを読み取るアクションを設定しましょう。
- SQL クエリでデータを取得するため「SQL クエリ」アクションを配置します。
- 「SQL クエリ」アクション では「SQL ステートメント」に対してSQL を入力して、データを取得することができます。
- 取得したデータを後続ステップで利用するため、データセットを作成します。
- CSV に出力して取得データを確認します。
作成したタスクの動作を確認する
それでは作成したタスクを実際に動かしてみましょう。
- タスクは画面上にある「実行」で手動実行が可能です。
- 処理の完了は画面下の出力から確認できます。
- 指定したCSV ファイルを開きます。正常にHCL Domino のデータを元にしたCSV ファイルが生成されていました。