IQ Bot Advanced ： IQ BotをRPAから便利に呼び出すBot Storeのパッケージ

[IQ Bot](https://qiita.com/IQBotter/items/fab5f59230ff38a98bbd)を呼び出す基本的なRPA（A2019）の作り方を、先日[こちら](https://qiita.com/IQ_Bocchi/items/5b0cc3bb7e4ddcbc43bd)の記事で紹介しました。

IQ Botをシンプルに動かすだけであれば上記で十分ですが、IQ Botのステータスなどをもっと詳細にモニタリングして細かい制御を作り込みたい！　という場合に便利なのが、今日ご紹介するIQ Bot Advancedのパッケージです。

#IQ Bot Advanced

IQ Bot Advancedのパッケージは、Bot Storeから入手可能です。

パッケージの入手方法は、以下の記事をご参照ください。

https://qiita.com/IQ_Bocchi/items/0a4b62172ca71d3c6dc2

##機能一覧

IQ Bot Advancedのアクションは以下のとおりです。
「Processing」「Admin」「Instance」とカテゴリーが分かれていて、その配下にアクションが配置されていますが、カテゴリーは単純に探しやすさのために分類されているだけで、各カテゴリーのアクションを混ぜて使うことも可能です。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/294356f2-7177-82f6-7bae-d4508c87ff0a.png)

以下、順不同（筆者個人的によく使うもの順）で各アクションを説明します。

###Start Session（Adminカテゴリ配下）

IQ Bot Utilsを使うときは、必ず最初にStart Sessionアクションを入れます。
ここで、以後のアクションで必要になるセッション名を指定します。
![StartSession.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/14b00d8a-21e6-8528-5c75-5dfefca0366a.jpeg)

###End Session（Adminカテゴリ配下）

IQ Bot Utilsの処理が終わったら、必ず最後にEnd Sessionアクションを入れてセッションを閉じます。
![EndSession.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/5bf06a02-cf41-5e4c-964c-f5ac05323f63.jpeg)

###ID of a Learning Instance（Instanceカテゴリ配下）

アクション名のとおりですが、ラーニングインスタンスの名前をキーにラーニングインスタンスのIDを取得するアクションです。
![ID.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/7bd3bf74-7b1e-a58e-6bf1-6cf84d565bde.jpeg)
なお、ラーニングインスタンスのIDとは何か＆手動で確認する方法は[こちら](https://qiita.com/IQ_Bocchi/items/6cace9cb462ee2399f51)。

###All Learning Instances（Adminカテゴリ配下）
該当するBotのユーザーがアクセス可能なすべてのラーニングインスタンスの名前とIDをディクショナリ型の変数に格納するアクションです。
![AllLI.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/b6fe9e7b-77ab-6300-0fdf-b0f8abc6b1b4.jpeg)
実行すると、ラーニングインスタンスの名前をキー、IDを値とするディクショナリができます。

###No of Files（Instanceカテゴリ配下）
ひとつのラーニングインスタンスについて、ドキュメントの状態ごとに、該当するファイルが何個あるかを返してくれるアクションです。
![NoofFiles.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/b1ba0047-a550-2121-c8a0-845b196d10df.jpeg)

ドキュメントの状態というのは、[こちら](https://qiita.com/IQ_Bocchi/items/f90188352947ae054ab8)の図にある出力フォルダの名称とイコールです。Successであれば、Successフォルダに何個CSVが吐かれているかを返します。

Doc Typeの選択肢では「Untrained」というのがありますが、こちらは上記の図のフォルダの「Not Processed」に該当します。
![DocType.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/29e0bf4d-8424-c3dd-37d4-18d8df0bc4c7.jpeg)

###Validation for a Learning Instance（Processingカテゴリ配下）
ラーニングインスタンスの中で[検証（Validation）](https://qiita.com/IQ_Bocchi/items/4e220a9bd6e337de4508)に回っているドキュメントが何個あるかを返してくれるアクションです。
![Val.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/c5d43b26-2587-bce6-fcef-374332dae54e.jpeg)

このアクションは使いたいという人が多かったので、以下の記事で具体的な使い方を解説しています。

https://qiita.com/IQ_Bocchi/items/0a4b62172ca71d3c6dc2

<details><summary>以下は旧バージョン（IQ Bot Utils時代）の名残</summary><div>

IQ Bot AdvancedがまだBot Storeの公式パッケージでなかった頃は、以下のアクションがありました。

###Details of Learning Instance

上記以外の詳細情報をディクショナリ型の変数に格納するアクションです。
![Details.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/680316fa-8a98-b923-e0f0-a55f3b93cdc3.jpeg)

取得できるキーの一覧は以下のとおりです。
![DetailDict.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/4a54ac7a-0427-bcd3-ee2d-126fd23c0606.jpeg)


</div></details>