はじめに

この投稿は、UiPath Academyの「UiPath Integration Service」コースの内容を、日本語で説明したものです。英語が苦手なので「翻訳したもの」、というよりは、私が理解し、自分の言葉で説明したものとなります。サンプル等はより簡潔なものとしています。

前提条件

以下のコースが修了している程度のStudioの知識が必要です。

「Studioでの変数、引数、制御フロー」コース
「StudioによるUI操作の自動化」コース

実際は、OrchestratorでUnattended実行の設定ができる程度の知識も必要かなと思います。

必要なもの

AutomationCloudアカウント
StudioおよびRobotバージョン2021.10以降（最新バージョンを推奨）

Community版でOKです。

UiPath Integration Serviceの概要

複数のサービスにまたがる複雑なワークフローを簡単に統合するサービス(Integration Service)で、大きく以下の3つの機能を有します。

サービスへ安全に接続できる仕組み(コネクタ)
GoogleドライブやSalesforceなどのサービスへの認証の標準化(コネクション)
接続されたサービスのイベントに基づく自動化の開始(トリガー)

コネクタ

現在、以下のコネクタが提供されており、どんどん追加されていくことと思われます(2022/06/30時点)。

コネクション

コネクタを介して行われる、単一のユーザーと単一の外部アプリケーション間のリンクです。
以下は、UserA,BのGoogleDriveへのコネクションとUserBのTwitterへのコネクションを作成した状態です。

トリガー

トリガーは、コネクタから特定のイベントを監視できるようにする仕組みです。
以下は、下記の監視＆実行を行うトリガーを作成した状態です。

UserAのGoogleDriveへファイルが追加されるのを監視する
ファイルが追加されたら、IntegrationService確認プロセスを実行する

実践

実際に簡単な自動化プロセスを作成していきます。
UserAのGoogleDriveにファイルが追加されたら、UserBのTwitterにそのファイル名をTweetするというプロセスで実装します。

Integration Serviceの起動

Integration Serviceは、Automation Cloud上にあります。赤枠の「Integration Service」をクリックすることで起動します。
（Integration Serviceが表示されていない場合は、青枠の「管理」からIntegration Serviceをプロビジョニングしてください。）

コネクションの作成

Googleドライブのコネクションの作成

コネクタ一覧の中から、Googleドライブをクリックします。

コネクションを追加をクリックします。

Googleドライブに接続するアカウントを選択します。

「Googleドライブのすべてのファイルの表示、編集、作成、削除です。」をチェックし、続行をクリックします。

コネクションが作成されました。せっかくなので、コネクション名を変更しておきます。
(作成された直後はアカウントが丸見えなのでというのもあり…)
コネクション名の変更は、名前の横の鉛筆アイコンをクリックし、名前を入力した後、EnterでOKです。

Twitterのコネクションの作成

TwitterのコネクションもGoogleドライブとほぼ同様の手順で作成できます。
こちらもコネクション名を変更してあります。

プロセスの作成

パッケージのインストール

GoogleドライブとTwitterのIntegration Service用のパッケージをインストールします。

Google Workspace
UiPath.Twitter.IntegrationService.Activities

GoogleドライブとOutlook365以外のIntegrationServiceのパッケージは
　　UiPath.コネクション名.IntegrationService.Activities
という名前になっているようです。

引数の定義

トリガーした対象(今回の場合UserAのGoogleドライブへのファイル追加)をプロセスに伝えるための仕組みが用意されています。以下の4つの引数がそれにあたります。それぞれ、String型の入力引数として定義しておきます。

UiPathEventConnector
UiPathEvent
UiPathEventObjectType
UiPathEventObjectId

実際に実行した際の引数の値は以下のようになります。
UiPathEventConnector =[uipath-google-drive]
UiPathEvent =[CREATED]
UiPathEventObjectType =[File]
UiPathEventObjectId =[10xEdxGq398IUeNiDjmToQSwD0MUTZKvq]

Googleドライブからファイル名を取得

Googleドライブからのファイル名取得は、下図のような簡単なフローで行うことができます。

Googleドライブの処理を作成するには、まず「Googleドライブを使用」を使用します。
プロパティの「Integration Serviceを使用」をONにします。

アカウント欄にはIntegration Serviceで設定したコネクションが選択できるようになります。今回の場合は、「UserA GDrive」を選択しています。

3.「ファイル情報を取得」でファイル情報を取得します。その際のファイルIDは引数の「UiPathEventObjectId」となります。

Twitterへツイート

Twitterへツイートするのも、下図のような簡単なフローで行うことができます。

ちなみに、Configureをクリックすると、Integration Serviceで設定したコネクションを指定できる画面が表示されます。

パブリッシュ

プロセスをパブリッシュし、unattended実行できる状態にします(ここは割愛します)。

トリガーの設定

トリガーを設定するルートは2種類用意されています。
1つ目は、トリガータブを表示し、「トリガーを追加」をクリックする方法です。

2つ目は、コネクションタブより三点リーダー内のトリガーを管理をクリックした後、「トリガーを追加」をクリックする方法です。

どちらの手順でも、下図の画面にたどり着きます。
ただし、2つ目の方法の場合、「コネクタを選択」、「コネクション」が選択された状態で開きます(違いはそれだけ)。

イベント、記録

イベントは以下の種類から選択できます(コネクタによって違います)。

新しいレコードの作成時　･･･ファイルが新しくできた場合
既存のレコードの更新時　･･･ファイルが更新された場合
既存のレコードの削除時　･･･ファイルが削除された場合

記録は以下の種類から選択できます(コネクタによって違います)。

File ･･･ファイルに対するイベント
Folder　･･･フォルダに対するイベント

今回はファイルが追加された時にトリガーするので、「新しいレコードの作成時」、「File」を設定しています。

実行するプロセス

実行するプロセスには、実際にトリガーで実行するプロセスを設定します。
今回は先ほどパブリッシュした「GoogleドライブTwitter連携」を設定しています。

また、入力引数には、プロセスの引数で設定した値が自動的に表示されます。

動作確認

Googleドライブに「テスト用ファイル.txt」というファイルを格納します。

しばらく待っているとジョブが実行されます。ファイルを格納してすぐに実行しないのは、トリガーの監視が5分間隔で行われているためです。そのため、最大5分待たされる可能性があります。

Twitterにもツイートされました。

まとめ

UiPath Academyの「UiPath Integration Service」コースの内容を日本語で簡単にまとめてみました。
作成したプロセスを見ても分かる通り、Integration Serviceは、様々なサービスの処理やサービスの連携を非常に簡単に自動化できる可能性があります。今後も色々と紹介していこうと思います。

UiPath Integration Serviceを学ぶ