UiPath Orchestratorからプロセスを実行する(Ver.21.10版)

# はじめに
この記事では、UiPath Automation CloudにてOrchestratorの設定を行い、Orchestratorからプロセスを実行するまでの手順について紹介します。UiPath Automation CloudのログインやUiPath Studioのインストール等は終わっている前提で話を進めます。

# 使用環境について
この記事で使っている環境は以下の通りです（すべてCommunityライセンス)。

+ UiPath Automation Cloud バージョン 21.10.19-release.3
+ UiPath Assistant 21.10.0
+ UiPath Studio 21.10.0
 
# Orchestratorサービスの新規作成
UiPath Automation Cloudに初めて接続すると、下記画面が表示されるので、以下の手順でサービスを作成します。

1. Orchestratorサービスの「新規作成」ボタンをクリックします。
![01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/c49f5d03-56a4-ee70-49ca-f5ceebdf1c73.png)
2. 「テナントを追加」をクリックします。
![02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/37e038f7-3702-dd9b-43b8-083077f86b99.png)
3. サービスを選択し、「保存」ボタンをクリックします。<br>
今回、テナント名は「test_tenant」としました。<br>
サービスをプロビジョニングの設定はデフォルトの状態のまま「保存」しています。<br>
厳密にやるなら、ActionsやProcessersは使わないのであれば、チェックを外しておくべきかもしれません。
![03.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/942b925a-cf4c-f523-30c1-742646c71f79.png)
4. テナントが作成されました。
画面左にOrchestratorアイコンが表示されていればOKです。
![04.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/511319e8-bce4-96a8-01df-b5960d0a926c.png)

# Orchestratorの設定(マシンの設定)
Orchestratorアイコンをクリックすると、Orchestratorの管理画面が開きます。
「テナント」→「マシン」の順にクリックすると、現在使っているPCの情報がマシンとして設定された状態で表示されます。
表示されているマシンの一番右の「・・・」から「マシンを編集」をクリックします。
![05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/d127d2af-ddd7-4497-bfe1-ad88ba489e72.png)
ランタイムライセンス(実行スロット)のProduction(Unattended)を「1」に変更します。
併せて、テンプレート名が長いので、「myPC1」に変更しました。
サポートする使用方法はデフォルトのまま、「すべて」「すべて」としてあります。
厳密にやるなら、正しい設定をするべきかもしれません。
最後に「更新」ボタンをクリックして、マシンの設定は完了です。
![06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/d2935c8f-5bf1-8661-bcb9-318dd0546b84.png)

# UiPath AssistantからOrchestratorへの接続
Assistantの「設定」→「Orchestratorの設定」を開き、サービスURLを入力し、「サインイン」ボタンをクリックします。
（サービスURLはAutomation CloudのURL + "/" + テナント名となります）
![07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/5fecb6d0-45b2-c1eb-922e-709408d66b8e.png)
サインインが正常に行われると、Assistantの画面上部に緑色の丸が表示されます。
![08.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/ed0cf44e-b5fa-78d2-c697-6dbb1b19d48b.png)
Orchestrator側で確認すると、「ロボット接続なし」となっていたインストールされたバージョンが「21.10.0」と表示され、Assistantと接続されたことが確認できます。
これで、Orchestratorへの接続は完了です。
![09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/c2dc5259-457c-b356-36f7-a5895dba8fdd.png)

# UiPath Studioからパブリッシュ
今回はテスト用にYahoo!をchromeで開き、1分後に「天気・災害」をクリックするという簡単なプロジェクトを作成しました。
プロジェクト名は「Orchestratorテスト1」としています。
![12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/09021ca9-f9ec-9f8f-f1c5-bba5b0d09415.png)
「デザイン」→「パブリッシュ」を実行します。
ここは特に変更なく、「次へ」ボタンをクリックします。
![13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/4aed446d-917d-f56e-f877-ee234d49fd68.png)
パブリッシュ先に「Orchestrator個人用ワークスペースフィード」を指定し、「パブリッシュ」ボタンをクリックします。
![14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/5d3aa2f7-42bf-a746-037c-d6fca66a4119.png)
パブリッシュが正常にできました。
![15.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/717760f3-a7ff-ae6c-92ba-8485d297dafa.png)
UiPath Assistantからパブリッシュされた「Orchestratorテスト1」が見えるようになっています。
![16.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/41e0ac7d-c810-3419-7816-a337eb6d4995.png)
インストールして実行すれば、普通にAssistantからの実行ができるようになります。
![17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/bdc65c74-6cb9-eacf-7590-633c83cfbab7.png)
![18.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/c6096440-b991-135c-58ff-00eadc9be7b6.png)

# Orchestratorからの実行(失敗)
Orchestratorの「My Workspace」→「オートメーション」→「プロセス」を開くと、「Orchestratorテスト1」が表示されます。
まずは、そのまま「ジョブを開始」してみます。
![20.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/bc04717e-e8ae-834e-0d86-ccadf5f98a6e.png)
そのまま、「開始」ボタンをクリックします。
![21.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/4456f9fc-3748-ed02-dd6c-931760439727.png)
すると、下記のようなエラーが表示され、実行できません。
![22.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/eafcf41e-d1f0-d4dc-ce64-610d694b6df1.png)
Orchestratorの「テナント」→「ロボット」を開くと、設定済みのロボットが1つ表示され、そのロボットの種類が「Attended」となっています。Orchestratorからプロセスを実行するには、ロボットの種類が「Unattended」でないと実行できないため、上記エラーとなっています。
![32.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/d802fefd-37c7-15f4-96a0-6107b5886ff3.png)

# Unattendedロボットの設定
Orchestratorの「テナント」→「アクセス権を管理」を開き、自身のユーザーの行(下図の場合、一番下の行)の「編集」をクリックします。
![23.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/61333369-6dc8-189c-8db5-35afe10e0959.png)
ユーザとロールの情報が表示されるので、ここはそのまま「次へ」ボタンをクリックします。
![24.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/e4248f55-e7fc-b010-9d65-8f3d2bee92df.png)
Unattendedロボットが有効になっていないので、有効に切り替えます。
今回のプロセスはブラウザを起動するため、フォアグランドオートメーションを実行(資格情報が必要)をチェックし、
ドメイン\ユーザー名とパスワードを入力します（ドメイン\ユーザー名の取得方法はこの後で説明します）。
ちなみに、パスワードはWindowsにログインするときのパスワードとなります。
最後に、「更新」ボタンをクリックします。
![25.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/99d014fa-c782-d089-28e8-6203534128d7.png)
Orchestratorの「テナント」→「ロボット」を開くと、Unattendedロボットが追加されているのが確認できます。
これで、Unattendedロボットの設定は完了です。
![27.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/c2dc1ccd-f99e-d413-b33b-431ab153ff91.png)

### ドメイン\ユーザー名の取得方法
コマンドプロンプトを起動し、「whoami」コマンドを実行し、表示された文字列をそのままコピーして、
ドメイン\ユーザー名に貼り付けてください。
![26.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/14025925-5578-6570-7f2f-8c45eec40613.png)

# Orchestratorからの実行
Orchestratorの「My Workspace」→「オートメーション」→「プロセス」からジョブを開始します。
![28.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/680880d3-1a9b-6db7-8273-fc028ec8d39f.png)
ここは、そのまま「開始」ボタンをクリックします。
![29.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/12cc0353-dbd5-86ec-d8c3-459571a82a09.png)
今度はちゃんと実行されました。
![30.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/f8ca4e97-791c-8b9c-750a-4abba0621994.png)
Orchestratorの「My Workspace」→「オートメーション」→「ジョブ」で実行結果を確認できます。
見事「成功」となっています。
![31.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2218396/6f36ec60-ff89-ad4c-d5c4-ce9b374b5667.png)

# まとめ
Orchestratorからプロセスを実行する手順を説明しました。
今回の設定は実行できればよい。それ以外はとりあえずデフォルトのまま設定する。というものです。
実際にOrchestratorを活用する際は、必要に応じて、様々な設定が必要となると思われますので、ご了承ください。

##### 特に忘れやすそうなのは以下の2点です
+ マシンの編集でProduction(Unattended)を1にするのを忘れないこと
+ Orchestratorからプロセスを実行するには、Unattendedロボットの設定が必要

# 後記
自分自身の備忘録にと思ってスクリーンショットを撮っていたものでしたが、せっかくなので、Qiitaに投稿してみました。
初投稿で、Markdown記法に四苦八苦しながらの拙いもので、読みづらかったりしたら申し訳ありません。
参考になった！と思って頂ける人がいたら嬉しいです。