BizRobo! 10.4 DAをローカルマシンにセットアップする

2019年6月に[「BizRobo!」10.4.0.1がリリース](https://rpa-technologies.com/news/information/1765/)[^1]されました。主な新機能のひとつとして、DA (10.4よりDevice AutomationからDesktop Automationに名称変更、略称は同じ)がDS (Design Studio)と別の端末にインストールする必要がなくなり、開発環境に必要なマシンの数が少なくなりました。

以下、[ニュースリリース](https://rpa-technologies.com/news/information/1765/)より引用
> 「BizRobo!」10.4.0.1では、エンドユーザー様がより現場で使って頂けるよう、大幅にユーザビリティの向上を実現しました。本機能は、Design Studio (以下、DS)端末にDesktop Automation Service (以下、DAS）をインストールすることにより、従来はDS端末とDAS端末の2台が必要であったDesktop Automation (以下、DA)使用ロボットの開発において、1台の端末で済ませられる機能となっております。

[^1]: BizRobo! は Kofax RPA (旧Kapow)のOEM製品であり中身は同じです。また、SynchRoidは BizRobo!のOEMなので、これらの3つの製品はバージョン番号も中身も同じになっています。

BizRobo系の製品は、サーバー型RPAなのですが、DA (つまり**WindowsアプリおよびJavaアプリのUIの構造解析を行うライブラリを扱えるサービス**)はサーバー (Management Console、MC) ともクライアント (DS)とも独立した第3のモジュールとして存在し、別途インストールして設定する必要があるところが他の製品と異なる特徴です。モジュールが分かれているのはインストールも設定も面倒くさい[^2]💦

[^2]: 実はMCもDSもJavaアプリケーションであり、[Java Service Wrapper](https://wrapper.tanukisoftware.com/doc/japanese/introduction.html)という仕組みを使ってWindows とUnixの両方に対応しているようです。ただし、UI構造解析ライブラリはWindowsのみの機能なので、Windows専用の別の仕組みを作る必要があったというのが経緯なのでしょう。

# DA 10.4のインストール
MSIのインストーラを起動することで Windowsマシンに普通ににインストールできます。必要なランタイムライブラリをあらかじめインストールするように求められることがありますが、言われたとおりに入れてください。

# DAの設定
名前は変わっても10.3までと同じように設定が可能です。一番わかりやすいのはBizRobo! Tutorialのビデオなのでこの記事の最後の[参考記事](#参考記事)を参照してください。必要な設定のキーポイントは以下の通り。

* DAとMCをインストールするパソコンのコンピューター名を調べておいて、設定画面の所定の場所 (Host name/MC Path) にコンピューター名を入力
* Single Userをオンにする
* Tokenに任意の値を入力 (この値は後でDSの設定で利用)

**詳細手順**
まず、タスクバーのシステムトレイの青またはグレーのドーナツ型アイコンを右クリックして、Configureをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/52a6acab-bfd9-83e6-539b-85a8a00d9f33.png) 
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/78fb8b75-ad28-0949-301a-5c52bee64f04.png)

Host nameにDAのコンピューター名を入力、Single UserをOnにします。MC Pathには、MCのコンピューター名を足します。MCの場合はIPアドレスでもよし、DAと同じマシンにインストールする場合は"localhost"でもよいです。(例: `http://localhost:50080`)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/d95dee89-1ce6-0549-121e-c3bade354056.png)

Tokenには任意の文字列を入力 (例: TestToken)。その後、Save and Restartボタンをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/71fce302-f41d-893d-ec57-b6ca7868cd00.png)

その後、タスクトレイのアイコンが青くなり、"DAS is running" と表示されればOKです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/f42759cb-379a-ee5e-503a-a96f987e6b7e.png)

# DSの追加設定
DAを使うためにはDSでも追加の設定が必要になります。概要は以下の通りです。

* ロボットの実行モードを変更 (デザインモード実行を「**スマート再実行 (フル)**」へ)
* 新しいオートメーションデバイスマッピングを作成、「**デバイスマッピング**」を設定

**詳細手順**
DSを起動、「ファイル」-「ロボット設定...」(もしくはツールバーでも同様のアイコンあり)で、「デザインモード実行」のドロップダウンを「**スマート再実行 (フル)**」に変更、OKボタンを押します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/f4552706-2015-07aa-58bf-1f1300780d62.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/96626600-59ad-e893-297c-e4759b6dcc30.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/2950695d-e177-7cf0-6a68-002be91a6c7a.png)

ロボットが開いている場合は、いったん保存され再ロードされます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/97aca8f8-3a62-d432-53bd-a65466c381d4.png)

タイトルバーのテキストからモードが変更されたことが確認できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/1bcaaf49-8198-6965-b4f0-060fbb543840.png)

「ファイル」-「新しいオートメーションデバイスマッピング...」を開き、名前を「DA.device」等に変更、次へボタンを押します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/45af4e8f-0a79-3386-4270-7b3669ceca6c.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/2baad7b1-8c3b-82dc-0866-2c33325712ce.png)

ドロップダウンリストを「デバイスマッピング」に変更して、ホストにDAのコンピューター名、ポートに49998、トークンに先ほど入力したトークン (例: TestToken)を入力、終了ボタンを押します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/0716c81b-2955-15a2-26a6-50dd80067353.png)

これで初期設定は完了です。


# 利用時の設定: Desktop Automationステップを追加して「必要なデバイス」を追加
実際にDAを使いたいロボットの編集画面で、新しいアクションステップを追加、Desktop Automationをアクションとして指定した後、先ほど作成した「DA」を「必要なデバイス」で指定して追加します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/6ea02ded-bcdf-d2c9-98b0-b48ecc0dca74.png)

あとは、入力値、出力マッピングを指定した後、ワークフローの編集ボタンを押します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/9dfc8016-692e-b83d-8e09-379c9edc97c7.png)

すると、Desktop Automationエディターが起動します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/490819/49ba8f55-4f8a-cc58-eb3f-baff5190bac8.png)


これで、ワークフローを編集するための準備が整いました。
結構いろいろ設定しないと、ユーザーインターフェイスの操作のレコーディングをして構造解析を行うところまでいかないのが大変です💦

# 参考記事

* [ローカル Desktop Automation の使用 - Kofax RPA のヘルプ 10.4](https://docshield.kofax.com/RPA/ja_JA/10.4.0_rp4hrvtqrq/help/kap_help/designstudio/t_localda.html)
* [Desktop Automation の構成 - Kofax RPA のヘルプ 10.4](https://docshield.kofax.com/RPA/ja_JA/10.4.0_rp4hrvtqrq/help/kap_help/designstudio/c_configureautomationdevice.html)
* [【BizRobo! Tutorial】Device Automation 10.3ver インストール・セットアップ - YouTube ビデオ](https://www.youtube.com/watch?v=ts-7Nkljivk)
* [【BizRobo! Tutorial】Device Automationの基礎操作 - YouTube ビデオ](https://www.youtube.com/watch?v=UShabAHK38U)
* [Kapow Quick Start Guide (Desktop Automation Setup)](https://knowledge.kofax.com/Robotic_Process_Automation/General_Documentation/Kapow_Quick_Start_Guide_Desktop_Automation_Setup) (英語)