【UiPath】OrchestratorのAPI経由で
ロボットを実行してみる

Last updated on 2021年12月30日

Orchestratorからロボットを実行する手順

APIからロボットを実行する手順ですがいくつか順番にAPIを叩いていく必要があります。

順番は次のとおりです。

• 事前準備
• 認証APIを叩く
• 実行するプロセスを取得するAPIを叩く
• ジョブ実行のAPIを叩く

この記事では、新しく追加された Automation Cloud の Orchestrator を利用しそれぞれ順番に見ていきます。

事前準備

APIを利用するにあたりあらかじめ Automation Cloud のポータルより次のキーを取得しておきます。

• ユーザーキー
• アカウント論理名
• テナント名
• クライアントID

取得する方法ですが、トップページの [管理] ⇛ [テナント] ⇛ [雲のマーク] をクリックすることで確認することができます。

クリックすると次のようなポップアップが開き適宜コピーすることができます。

これらは漏洩しないようにローカルにコピーしておいて下さい。

APIを叩く際に利用します。

また、今回 Python のコードも記載しますがその際これらは次の変数名で利用するので適宜読み替えてください。

プロセス名はジョブとして実行したいプロセスについている名前、フォルダ名はそのプロセスが所属しているフォルダの名称となります

これらも事前に把握しておいてください。

認証APIを叩く

ではさっそくAPIを叩いていきたいと思います。

まずは認証を取得するAPIです。

公式ドキュメントは次のリンク先にあります。適宜参考にしてください。

公式の内容を抜粋したものを次にまとめています。

これらの指定通りにPOSTメソッドを呼び出すコードを書いてあげればいいです。

コードは次のようになります。

リターンで後続のAPIを叩く際に必要となるアクセストークンを返してあげましょう。

実行するプロセスを取得するAPIを叩く

アクセストークンが取得できたのでOrchestratorの各情報にアクセスできるようになりました。

続いてこのアクセストークンを利用し実行するつもりのプロセスの情報を取得します。

公式ドキュメントは次のリンク先にあります。適宜参考にしてください。

まとめた表を次に記載します。

このAPIでは実行するプロセスのキーを取得したいので、プロセスの名前でフィルターをかけ取得する方法をとっています。

ヘッダーの “Authorization” の要素では、”Bearer” というワードのあとに半角スペースをおいて取得済みのアクセストークンを入れてあげます。

Pythonコードで書くと次のようになります。

今回はGETなのでシンプルにURLに指定しています。

リターンではプロセスキーを取得するようにします。

ジョブ実行のAPIを叩く

いよいよ最後のAPIジョブの実行です。

これを叩くことでロボットを自動で実行させることができます。（UnAttended 必須）

公式ドキュメントはつぎになります。

表にまとめると次のようになります。

引数を利用して、ロボットへわたした上で実行をすることもできますが今回は利用せずシンプルに実行してみたいと思います。

では、Pythonのコードです。

最後に

今回も最後までお読みいただきありがとうございました。

では。