200520 A2019 共通部品開発方法パッケージとDLLとMetaBotの開発 Ivo Bartecek

200520 A2019 共通部品開発方法パッケージとDLLとMetaBotの開発 Ivo Bartecek

Transcript

1. A2019 共通部品開発方法 パッケージとDLLとMetaBotの開発 プロフェッショナルサービス Ivo Bartecek オートメーション・エニウェア・ジャパン株式会社
2. A2019 パッケージとDLLとMetaBot 1. 自己紹介 2. Package、DLL、MetaBotの開発概要 1. HelloWorld.dll 2. DLL コマンド 3. Package開発 3. 参考 1. よくある課題 2. 質問と答え Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 2 目次
3. A2019 パッケージとDLLとMetaBot Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 3 Who am I ? イヴォ・バルテチェク IVO BARTECEK • 東京で７年間BPM、ルールエンジン、RPA、人工知 能のアーキテクトコンサルタントです。 • AAでシニア・ソリューション・アーキテクト • PackageとDLLとMetaBot開発集中 • （７つのMetaBot作成） Facebook : bartecek LinkedIn : ivo-bartecek
4. A2019 パッケージとDLLとMetaBot ① Google Sheets MetaBot ② Excel MetaBot ③ Excel NPOI MetaBot POC ④ LibreOffice Calc MetaBot POC ⑤ OpenOffice Calc MetaBot POC ⑥ Rest and Proxy MetaBot POC ⑦ HelloWorld MetaBot ⑧ AA CUSTOMER MetaBot Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 4 Who am I ? - MetaBots by Ivo Bartecek
5. Package、DLL、MetaBotの開発概要 開発概要
6. A2019 パッケージとDLLとMetaBot 開発Lifecycle のおすすめ Package、DLL、MetaBotの開発 ライフサイクルは、 標準の ソフトウェア開発 ライフサイクルに 従います スーパーアジャイル開発 の場合、これらのフェーズは 一緒に行うことができます Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 6 1 企画 3 設計 4 実装 5 テスト 6 メンテナンス 2 分析 マージ リリース
7. A2019 パッケージとDLLとMetaBot A2019とパッケージ、DLL、MetaBot • V11のMetaBotはA2019では利用できませんが、 • MetaBotに含まれるDLLを呼び出して利用することはできます。 • MetaBotの移行も将来可能になる予定です。 • 最新情報： • Bot Storeではパッケージの販売も可能になる予定です。 • Bot Storeの日本語翻訳も予定があります。 Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 7 V11 A2019 メモ - Package Package（ Javaのjarのパッケージ）はコアの機能です。 MetaBot（DLL ） DLLコマンド DLLコマンド（ MetaBotのDLLの利用のため）もあります 。 MetaBot 移行機能 移行したMetaBotも使えるようになる予定
8. HelloWorld.dll 紹介 サンプルコードのクイックスタート
9. A2019 パッケージとDLLとMetaBot Hello World ソースコード • HelloWorldWrapper • HelloWorld.cs – 機能 • Resources.ja-JP.resx – 翻訳 • Resources.resx – 翻訳 • HelloWorldWrapper.Tests • HelloWorldWrapper_Tests.cs – ユニットテスト HelloWorldのコードは後程Meetup参加ゲストに差し上げます！ Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 9
10. A2019 パッケージとDLLとMetaBot Hello World ソースコード – 機能 Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 10
11. A2019 パッケージとDLLとMetaBot Hello World ソースコード – ユニットテスト Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 11
12. A2019 パッケージとDLLとMetaBot Hello World ソースコード – 翻訳サンプル Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 12
13. DLL コマンド クイックスタート
14. A2019 パッケージとDLLとMetaBot 準備 - Dictionary変数作成 • Dictionary 型変数を作成する • 名前：“message” • チェック： “Use as input” • キー： “message” Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 14
15. A2019 パッケージとDLLとMetaBot 準備 – 結果変数作成 • 結果変数を作成 • 名前： “result“ • チェック： “Use as output” Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 15
16. A2019 パッケージとDLLとMetaBot ワークフロー概要 ①テストメッセージ表示 ②DLL Open ③Dic型変数取り出し （テスト用） ④③で取り出した メッセージ表示 Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 16 ⑤DLL 機能起動 ⑥結果表示 ⑦DLL 閉じる ① ② ③ ④ ⑤ ⑥ ⑦
17. A2019 パッケージとDLLとMetaBot DLL: Open • DLL: Open • HelloWorld.dll Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 17
18. A2019 パッケージとDLLとMetaBot テスト Dictionary Get • Dictionary: Get • Dictionary “message” Key “message” • Output “result” Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 18
19. A2019 パッケージとDLLとMetaBot DLL: 機能実行 • DLL: 機能実行 • MyNamespace • MyClass • HelloWorld • Input “message” • Output “result” Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 19
20. A2019 パッケージとDLLとMetaBot DLL: 閉じる • DLL: Close Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 20
21. A2019 パッケージとDLLとMetaBot 最終結果 • 最終結果 • 注：最新のパッケージにアップグレードしてから実行する ようにしてください。 Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 21
22. Package開発 開発のクイックスタート方法
23. 1. アクションのアーキテクチャ 2. SDKで使うJavaに関して 3. SDKの基本構造 4. サンプルコード作成 5. 追加方法 アジェンダ 23 Copyright © 2020 Automation Anywhere Japan, Co., Ltd.
24. A2019 パッケージとDLLとMetaBot オリジナルの パッケージを追加 アイコン指定可能 詳細設定画面を設計可能 表示項目を指定可能 アクションを開発画面に追加可能 24
25. A2019 パッケージとDLLとMetaBot 史上初のマルチプラットフォーム・ マルチ OS 対応の RPA 企業全体で総保有コストを削減 セキュリティ パッチ適用済みの Java プラットフォーム 軽量、迅速、最小限のアップデート コマンド用のプラットフォームツール Bot を書き直す必要なし コマンド コマンド コマンド 共通コマンド ツール SDK Bot Runner 基盤 軽量、安全、マルチプラットフォームの環境 Linux および Windows に対応 25 Copyright © 2020 Automation Anywhere Japan, Co., Ltd.
26. A2019 パッケージとDLLとMetaBot SDKの入手 • docs.automationanywhere.comから入手 • SDK Demo Package: A2019-package-sdk-2.0.1.zip • Documentation: A2019-package-annotations-javadoc.zip IDEを利用して開発（Java） • プロジェクト設定(Gradle) • ビルド ビルドしたパッケージをControl Roomへ登録 • jarファイルをWebブラウザからアップロード SDKによるアクション開発の流れ 26 Copyright © 2020 Automation Anywhere Japan, Co., Ltd.
27. A2019 パッケージとDLLとMetaBot • https://docs.automationanywhere.com/にて 「sdk」を検索 SDKをダウンロードします 27 Copyright © 2020 Automation Anywhere Japan, Co., Ltd.
28. A2019 パッケージとDLLとMetaBot • 多言語対応など機能が追加されています SDKの変遷 28 Copyright © 2020 Automation Anywhere Japan, Co., Ltd.
29. A2019 パッケージとDLLとMetaBot • SDK Demo Packageのzipをダウンロード SDKをダウンロードします 29 Copyright © 2020 Automation Anywhere Japan, Co., Ltd.
30. A2019 パッケージとDLLとMetaBot • 任意の場所に解凍します • IntelliJで解凍したフォルダを開きます SDKをIntelliJで開きます 30
31. A2019 パッケージとDLLとMetaBot こんな画面が開きます 31
32. A2019 パッケージとDLLとMetaBot • メインのコードと 表示用ファイルに分かれる フォルダの構成 アクション用Java エラーメッセージ アイコンファイル 言語ファイル パッケージ設定
33. A2019 パッケージとDLLとMetaBot パッケージの設定 パッケージ設定
34. A2019 パッケージとDLLとMetaBot メッセージ エラーメッセージ 言語ファイル
35. A2019 パッケージとDLLとMetaBot サンプルコード docs.automationanywhere.com ※日本語化進行中
36. A2019 パッケージとDLLとMetaBot @BotCommand コマンドタイプ：BotCommand, Condition, Iteratorのいずれかを指定 @CommandPkg コマンド詳細：表記名や内容を指定 @Execute BotCommandの場合にメソッドに記載 @Idx , @NotEmpty ,@MatchRegex ,@LocalFileなど アノテーション例 @CommandPkg(label = “画面表示コマンド名”, name = “commandName”, description = “コマンドの動作説明”, node_label = “{{変数名(str1)}}", icon = "file.svg") @Execute public void create( @Idx(index = "1", type = FILE) @LocalFile @Pkg(label = "File“ , description = "e.g. C:\\MyDoc\\MyFile.doc") @NotEmpty String filePath, @Idx(index = "2", type = CHECKBOX) @Pkg(label = "Overwrite an existing file") @NotEmpty Boolean isOverwrite) { createFile(filePath, isOverwrite); }
37. A2019 パッケージとDLLとMetaBot サンプルコード アクションの • 表示名 • アイコン • 表示する項目 • メッセージの読み込み
38. A2019 パッケージとDLLとMetaBot サンプルコード アクションの処理 • 引数（使用する変数） • 変数の型 • 空かどうかなどのチェック （バリデーション） • Javaコードの処理
39. A2019 パッケージとDLLとMetaBot • アイコン • SVG形式で作成しresourceへ配置＋アノテーションで指定 • 依存関係（外部パッケージ） • 利用する外部パッケージはbuild.gradleへすべて記載 • エラーメッセージ • BotCommandExceptionを利用し多言語対応させること • バリデーション • アノテーションを利用してチェックすること • ループ • CPU負荷を上げやすく、ボットが応答しない原因となるため、 ループを避けること • ロギング • log4Jを利用し、オリジナルロガーを追加しないこと SDKによるアクション（ボットコマンド）開発のコツ 39
40. A2019 パッケージとDLLとMetaBot • ターミナルで下記を実行します • gradlew.bat clean build shadowJar ビルド • jarファイルが作成されます
41. A2019 パッケージとDLLとMetaBot パッケージをアップロード • CRのパッケージメニューから作成したファイルを指定してアップロードします。 • Manual: https://docs.automationanywhere.com/bundle/enterprise-v2019/page/enterprise-cloud/topics/developer/cloud-manage-package-in-bot.html 41 Copyright © 2020 Automation Anywhere Japan, Co., Ltd.
42. A2019 パッケージとDLLとMetaBot コマンドからビルド • Manual: https://docs.automationanywhere.com/bundle/enterprise-v2019/page/enterprise-cloud/topics/developer/cloud-create-package- overview.html • Download • April 2020, Release (2019.12.1) • April 2019-package-sdk-2.0.1.zip • Javaインストール • Javaインストールする。 • java は PATH に追加する。 • java –versionで確認する。 • Gradleインストール • gradleインストールする。 • gradle は PATH に追加する。 • gradle -vで確認する。 Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 42
43. A2019 パッケージとDLLとMetaBot コマンドからビルド • Manual: https://docs.automationanywhere.com/bundle/enterprise-v2019/page/enterprise-cloud/topics/developer/cloud-compile-demo-jar.html • cd …\A2019DemoPackage • gradlew.bat • Result: • build\libs\A2019DemoPackage-1.0.0.jar Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 43
44. 参考
45. A2019 パッケージとDLLとMetaBot よくある課題 • A2019は現在機能をアップグレードしています。V11の機能は2020年夏にすべ て搭載する予定です。 • 迅速に不具合の修正をしていますので、不具合がありましたら教えてください。 • 現在のCEバージョンでパッケージテストすることができません。A2019の Enterpriseが必要があります。 • AAEのTrialでもパッケージアップロードは可能です。 • DLLコマンドで “bot error” • おそらくパッケージのバージョンの原因の課題です。 Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 45
46. A2019 パッケージとDLLとMetaBot 質問と答え ご清聴ありがとうございました。 Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 46 ご質問は?
47. Enterprise A2019