RPA AutoMate でHCL Domino のデータを連携利用

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

AutoMate はHelpSystems 社が提供するRPA ツールです。700項目の自動化機能と15種類の自動実行トリガーが選択可能であるためあらゆるシーンを自動化することが可能です。

また、データベースにODBC経由で接続できるアクションが含まれており、CData ODBC Driverと組み合わせることでCData が対応しているさまざまなデータソースとノーコードで連携ができるようになります。

この記事では、AutoMate と CData ODBC ドライバを使って、HCL Domino に連携するタスクを作成します。

CData ODBC ドライバとは？

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

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

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

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

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

1. まずODBC 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. 入力後、接続テストが成功すれば設定は完了です。

AutoMate でタスクを作成する

それでは AutoMate でタスクを作成していきましょう。

1. タスク アドミニストレーターを起動し新規タスクを作成します。
2. 任意のタスク名を入力して、次へ進みます。
3. トリガーを追加し、タスクビルダーを起動します。「タスクビルダーを開始する」をクリックします。

AutoMate でHCL Domino へのDB 接続を構成

続いて AutoMate でODBC への接続構成を行います。

1. ODBC 接続は「データベース」のアクションを使って構成していきます。
2. まずは接続を確立します。「SQL 接続を開く」アクションをドラッグアンドドロップで配置しましょう。
3. プロパティの「接続」で接続設定をします。「接続の構築」をクリックします。
4. 接続するプロバイダーを選択します。「Microsoft OLE DB Provider for ODBC Drivers」を選択します。
5. データソースを指定します。接続設定は完了です。

HCL Domino のデータをAutoMate で扱う

接続セッションの構成が完了したら、実際にデータを読み取るアクションを設定しましょう。

1. SQL クエリでデータを取得するため「SQL クエリ」アクションを配置します。
2. 「SQL クエリ」アクション では「SQL ステートメント」に対してSQL を入力して、データを取得することができます。
3. 取得したデータを後続ステップで利用するため、データセットを作成します。
4. CSV に出力して取得データを確認します。

作成したタスクの動作を確認する

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

1. タスクは画面上にある「実行」で手動実行が可能です。
2. 処理の完了は画面下の出力から確認できます。
3. 指定したCSV ファイルを開きます。正常にHCL Domino のデータを元にしたCSV ファイルが生成されていました。