RPA ツールUiPath でJSON データを連携利用

UiPath は高機能なRPA（Robotic Process Automation）製品です。UiPath Studioを使うことで、RPAプログラムをフローチャートを描くように開発することが可能です。 CData ODBC driver を使えば、コーディングなしでUiPath からJSON への連携フローを設定することができます。UiPath は、ODBC Driver に対してSQL を発行します。発行されたSQL をCData ODBC driver がJSON へのリアルタイムリクエストに変換し、レスポンスをテーブルデータとして取得します。
この記事では、UiPath Studio を使って、JSON に連携するRPA プログラムを作成します。

今回作成するUiPath RPA プロジェクト

以下のようなUiPath RPA プロジェクトを作成します。
「Connect Activity」を利用して、JSONCData ODBC driverに接続し、顧客リストを取得するSQLを実行。取得したDatatableを「Write CSV Activity」を利用してCSV出力します。

JSON ODBC Driver とUiPath Studio の連携

接続プロパティが未設定の場合は、まずODBC DSN（データソース名）で設定します。これはドライバーのインストールの最後の手順です。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。

データソースへの認証については、ヘルプドキュメントの「はじめに」を参照してください。本製品は、JSON API を双方向データベーステーブルとして、JSON ファイルを読み取り専用ビュー（ローカル ファイル、一般的なクラウドサービスに保存されているファイル、FTP サーバー）としてモデル化します。HTTP Basic、Digest、NTLM、OAuth、FTP などの主要な認証スキームがサポートされています。詳細はヘルプドキュメントの「はじめに」を参照してください。

URI を設定して認証値を入力したら、DataModel を設定してデータ表現とデータ構造をより厳密に一致させます。

DataModel プロパティは、データをどのようにテーブルに表現するかを制御するプロパティで、次の基本設定を切り替えます。

• Document（デフォルト）：JSON データのトップレベルのドキュメントビューをモデル化します。本製品 は、ネストされたオブジェクト配列を集約されたJSON オブジェクトとして返します。
• FlattenedDocuments：ネストされた配列オブジェクトと親オブジェクトを、単一テーブルに暗黙的に結合します。
• Relational：階層データから個々の関連テーブルを返します。テーブルには、親ドキュメントにリンクする主キーと外部キーが含まれています。

リレーショナル表現の設定についての詳細は、ヘルプドキュメントの「JSON データのモデリング」を参照してください。また、以下の例で使用されているサンプルデータも確認できます。データには人や所有する車、それらの車に行われたさまざまなメンテナンスサービスのエントリが含まれています。

Amazon S3 内のJSON への接続

URI をバケット内のJSON ドキュメントに設定します。さらに、次のプロパティを設定して認証します。

• AWSAccessKey：AWS アクセスキー（username）に設定。
• AWSSecretKey：AWS シークレットキーに設定。

Box 内のJSON への接続

URI をJSON ファイルへのパスに設定します。Box へ認証するには、OAuth 認証標準を使います。 認証方法については、Box への接続 を参照してください。

Dropbox 内のJSON への接続

URI をJSON ファイルへのパスに設定します。Dropbox へ認証するには、OAuth 認証標準を使います。 認証方法については、Dropbox への接続 を参照してください。ユーザーアカウントまたはサービスアカウントで認証できます。ユーザーアカウントフローでは、以下の接続文字列で示すように、ユーザー資格情報の接続プロパティを設定する必要はありません。 URI=dropbox://folder1/file.json; InitiateOAuth=GETANDREFRESH; OAuthClientId=oauthclientid1; OAuthClientSecret=oauthcliensecret1; CallbackUrl=http://localhost:12345;

SharePoint Online SOAP 内のJSON への接続

URI をJSON ファイルを含むドキュメントライブラリに設定します。認証するには、User、Password、およびStorageBaseURL を設定します。

SharePoint Online REST 内のJSON への接続

URI をJSON ファイルを含むドキュメントライブラリに設定します。StorageBaseURL は任意です。指定しない場合、ドライバーはルートドライブで動作します。 認証するには、OAuth 認証標準を使用します。

FTP 内のJSON への接続

URI をJSON ファイルへのパスが付いたサーバーのアドレスに設定します。認証するには、User およびPassword を設定します。

Google Drive 内のJSON への接続

デスクトップアプリケーションからのGoogle への認証には、InitiateOAuth をGETANDREFRESH に設定して、接続してください。詳細はドキュメントの「Google Drive への接続」を参照してください。

これで、UiPath StudioにJSON services を接続することができます。作業手順は以下です。

1. スタートページからBlank をクリックして、新しいプロジェクトを作成します。新しいデータベースでFile -> Inport Records -> Data Source をクリックし、CData JSON DSN を選択します。プロジェクト名は任意の名称を設定します。
2. JSON ODBC Driverの接続を行うためには、Database接続用のActivityが必要になります。 Activities ナビゲーションから［Manage Package］をクリックし、［UiPath.Database.Activities］を検索し、インストールします。
3. ActivitiesからFlow chartを配置して、下準備は完了です。
4. ODBC 接続に使用するConnect Activity を配置します。配置後ダブルクリックし、Connectの詳細を表示します。
   
5. Connectの詳細画面にて、Configure Connectionをクリックし、Connection Wizard を表示します。Microsoft ODBC Data Source を選択します。
6. use user or system data source name:から作成したCData JSON Source DSNをドロップダウンで選択します。OK を押して接続を確立します。
7. Connection 情報を格納するための変数を作成し、Propetries のOutput で、DatabaseConnection を指定し、紐付けを行います。
   

Execute Query Activity の作成

次に先程作成したODBC Connection 情報を使って、ODBC からデータを取り出すクエリを実行するためのExecute Query Activity を作成します。

1. Activities ナビゲーションから［Execute Query］を選択し、Flowchartに配置します。
2. Propertiesに以下のように値を入力します。
   ExistingDbConnection: 先程作成したConneciton変数を入力します。
   Sql: JSON の対象リストを取得するSELECT 文を入力します。
   DataTable: DataTable型の変数を作成し、入力します。
   

Write CSV の作成

最後のActivityとして、取得したDataTableをCSV出力するActivityを配置します。［FilePath］に出力するCSVのフォルダパスとファイル名（例："C:\UiPath\Sample.csv"）、DataTableに先程作成したDataTable変数を紐づけます。

各Activity の接続と実行

あとは各Activityを紐付ければ、JSON データを出力するRPA プロジェクトの作成は完了です。

RUN をクリックすると、自動的にJSON のデータを取得し、CSVが生成されます。

このようにCData ODBC Drivers を利用して、簡単にUiPath Studio でJSON に連携するフローを作成することができます。