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

by RPACommunity

Slide 1

Slide 1 text

A2019 共通部品開発方法パッケージとDLLとMetaBotの開発プロフェッショナルサービス Ivo Bartecek オートメーション・エニウェア・ジャパン株式会社

Slide 2

Slide 2 text

Slide 3

Slide 3 text

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

Slide 4

Slide 4 text

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

Slide 5

Slide 5 text

Package、DLL、MetaBotの開発概要開発概要

Slide 6

Slide 6 text

A2019 パッケージとDLLとMetaBot 開発Lifecycle のおすすめ Package、DLL、MetaBotの開発ライフサイクルは、標準のソフトウェア開発ライフサイクルに従いますスーパーアジャイル開発の場合、これらのフェーズは一緒に行うことができます Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 6 1 企画 3 設計 4 実装 5 テスト 6 メンテナンス 2 分析マージリリース

Slide 7

Slide 7 text

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も使えるようになる予定

Slide 8

Slide 8 text

HelloWorld.dll 紹介サンプルコードのクイックスタート

Slide 9

Slide 9 text

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

Slide 10

Slide 10 text

Slide 11

Slide 11 text

Slide 12

Slide 12 text

Slide 13

Slide 13 text

DLL コマンドクイックスタート

Slide 14

Slide 14 text

Slide 15

Slide 15 text

Slide 16

Slide 16 text

Slide 17

Slide 17 text

Slide 18

Slide 18 text

Slide 19

Slide 19 text

Slide 20

Slide 20 text

Slide 21

Slide 21 text

Slide 22

Slide 22 text

Package開発開発のクイックスタート方法

Slide 23

Slide 23 text

Slide 24

Slide 24 text

A2019 パッケージとDLLとMetaBot オリジナルのパッケージを追加アイコン指定可能詳細設定画面を設計可能表示項目を指定可能アクションを開発画面に追加可能 24

Slide 25

Slide 25 text

A2019 パッケージとDLLとMetaBot 史上初のマルチプラットフォーム・マルチ OS 対応の RPA 企業全体で総保有コストを削減セキュリティパッチ適用済みの Java プラットフォーム軽量、迅速、最小限のアップデートコマンド用のプラットフォームツール Bot を書き直す必要なしコマンドコマンドコマンド共通コマンドツール SDK Bot Runner 基盤軽量、安全、マルチプラットフォームの環境 Linux および Windows に対応 25 Copyright © 2020 Automation Anywhere Japan, Co., Ltd.

Slide 26

Slide 26 text

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.

Slide 27

Slide 27 text

Slide 28

Slide 28 text

Slide 29

Slide 29 text

Slide 30

Slide 30 text

A2019 パッケージとDLLとMetaBot • 任意の場所に解凍します • IntelliJで解凍したフォルダを開きます SDKをIntelliJで開きます 30

Slide 31

Slide 31 text

A2019 パッケージとDLLとMetaBot こんな画面が開きます 31

Slide 32

Slide 32 text

A2019 パッケージとDLLとMetaBot • メインのコードと表示用ファイルに分かれるフォルダの構成アクション用Java エラーメッセージアイコンファイル言語ファイルパッケージ設定

Slide 33

Slide 33 text

A2019 パッケージとDLLとMetaBot パッケージの設定パッケージ設定

Slide 34

Slide 34 text

A2019 パッケージとDLLとMetaBot メッセージエラーメッセージ言語ファイル

Slide 35

Slide 35 text

A2019 パッケージとDLLとMetaBot サンプルコード docs.automationanywhere.com ※日本語化進行中

Slide 36

Slide 36 text

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); }

Slide 37

Slide 37 text

A2019 パッケージとDLLとMetaBot サンプルコードアクションの • 表示名 • アイコン • 表示する項目 • メッセージの読み込み

Slide 38

Slide 38 text

A2019 パッケージとDLLとMetaBot サンプルコードアクションの処理 • 引数（使用する変数） • 変数の型 • 空かどうかなどのチェック（バリデーション） • Javaコードの処理

Slide 39

Slide 39 text

A2019 パッケージとDLLとMetaBot • アイコン • SVG形式で作成しresourceへ配置＋アノテーションで指定 • 依存関係（外部パッケージ） • 利用する外部パッケージはbuild.gradleへすべて記載 • エラーメッセージ • BotCommandExceptionを利用し多言語対応させること • バリデーション • アノテーションを利用してチェックすること • ループ • CPU負荷を上げやすく、ボットが応答しない原因となるため、ループを避けること • ロギング • log4Jを利用し、オリジナルロガーを追加しないこと SDKによるアクション（ボットコマンド）開発のコツ 39

Slide 40

Slide 40 text

A2019 パッケージとDLLとMetaBot • ターミナルで下記を実行します • gradlew.bat clean build shadowJar ビルド • jarファイルが作成されます

Slide 41

Slide 41 text

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.

Slide 42

Slide 42 text

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

Slide 43

Slide 43 text

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

Slide 44

Slide 44 text

参考

Slide 45

Slide 45 text

A2019 パッケージとDLLとMetaBot よくある課題 • A2019は現在機能をアップグレードしています。V11の機能は2020年夏にすべて搭載する予定です。 • 迅速に不具合の修正をしていますので、不具合がありましたら教えてください。 • 現在のCEバージョンでパッケージテストすることができません。A2019の Enterpriseが必要があります。 • AAEのTrialでもパッケージアップロードは可能です。 • DLLコマンドで “bot error” • おそらくパッケージのバージョンの原因の課題です。 Copyright © 2020 Automation Anywhere Japan, Co., Ltd. 45