クラウドネイティブRPA Automation 360™ でHCL Domino のデータを連携利用

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

Automation 360™ は Automation Anywhere 社が提供するクラウドネイティブなRPA プラットフォームです。従来のRPA と同様にエージェントはデスクトップにインストールされて動くのですが、ワークフローの作成、エージェントの管理や配布、オーケストレーションをクラウドサービス上で実施できるようになっています。

また、RPA としての基本的な機能のほかに、さまざまなアプリケーションやローカルファイル・サービスなどに接続することが可能なAction が一つの特徴となっています。その中に、データベースにODBC 経由で接続できるAction が含まれており、CData ODBC ドライバと組み合わせることで、CData が対応しているさまざまなデータソースとノーコードで連携ができるようになります。

この記事では、Automation 360™ と CData ODBC ドライバを使って、HCL Domino に連携するBot を作成します。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持った製品です。

1. HCL Domino をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレデータソースに対応
2. 多様なアプリケーション、ツールにHCL Domino のデータを連携
3. ノーコードでの手軽な接続設定
4. 標準SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてHCL Domino の接続を設定、2.Automation 360™ 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData ODBC ドライバのインストールとHCL Domino への接続設定

まずは、本記事右側のサイドバーからDomino ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

1. まずODBN DSN に必要な接続プロパティの値を入力します。 組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を構成できます。 これは、ドライバーのインストール時の最後のステップでも可能です。 Microsoft ODBC データソースアドミニストレーターを使用してDSN を作成および設定する方法については、ヘルプドキュメントの「はじめに」の章を参照してください。
   
   

   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 と同じです。


2. 入力後、接続テストが成功すれば設定は完了です。

Automation 360™ で Bot を作成する

それでは Automation 360™ で Bot を作成していきましょう。

1. Home 画面にログインし「Create a bot」をクリックします。

2. 任意のBot 名を入力して、「Create & edit」をクリックします。

Automation 360™ でHCL Domino へのDB 接続を構成する

続いて Automation 360™ でODBC への接続構成を行います。

1. ODBC 接続は主に「Database」のAction を使って構成していきます。

2. Database 接続では最初に「Connect」Action を使って接続を確立する必要があります。「Connect」Actionをドラッグアンドドロップで配置しましょう。

3. 「Connect」Action では「Connection mode」を「Default」に変更し、「Connection string」でODBC の接続情報を指定します。これでConnection の構成は完了です。

HCL Domino のデータをAutomation 360™ で扱う

Connection の構成が完了したら、実際にデータを読み取るAction を設定しましょう。

1. ODBC 経由でデータを読み取るために「Read from」Actionを配置します。

2. 「Read from」Action では「Enter SELECT Statement」に対してSQL を入力して、データを取得することができます。

3. また、今回は最終的にCSV ファイルとしてデータを吐き出すので「Export data to CSV」のチェックボックスにチェックを入れて、ローカルファイルとして出力されるように構成しました。
4. 最後に作成した接続情報を破棄するために「Disconnect」を配置しましょう。

作成したBot の動作を確認する

それでは作成したBot を実際に動かしてみましょう。

1. Bot は画面上にある「Run」で手動実行が可能です。

2. 開始すると以下のようにDesktop のBot Agent にシナリオが共有され、処理が行われます。

3. 正常に処理が完了すると、次のようにメッセージが表示されます。

4. 指定したCSV ファイルを参照してみたところ、正常にHCL Domino のデータを元にしたCSV ファイルが生成されていました。