LoginSignup
2
0

More than 3 years have passed since last update.

@RPAbot

Automation Anywhere A2019 の共通開発部品であるパッケージを作成する #1～まずはSDKサンプルをそのままビルドして使う

Last updated at Posted at 2020-06-06

Automation Anywhere A2019では、「パッケージ」という共通開発部品を作成、配布することでBot作成を効率化することができます。
先日オンラインで開催されたAutomation Anywhere社主催Developer Meetup Vol.2でも解説されていた内容を参考にしながら概要をまとめてみました。パッケージはJavaのテクノロジーを使ってビルドされていますので、開発にはJavaのビルド環境を整えます。

環境として使うのは以下のものです。

  • Automation Anywhere Enterprise A2019.12 (ビルド4111) 商用版
  • JDK 11
  • IntelliJ IDEA Community Edition (Java等の統合開発環境、Eclipseでもよい)+Gradle plug-in v.5.x.x
  • Gradle (オープンソースビルド自動化システム)

※ スクリーンショットはDeveloper Meetup Vol.2のウェビナー画面から拝借したものもあります。

「Automation Anywhere A2019 の共通開発部品であるパッケージを作成する」シリーズの記事

アクションをBot構築画面に追加するためのパッケージ開発

以下の画面のように、自分で開発したアクションをアクションパネルに追加できます。アクションのアイコンや、アクションの入出力の引数も設定が可能です。

image.png
出典:AA社主催Developer Meetup Vol.2

パッケージの開発は以下の流れで実施します。

  • SDKの入手: 最新のデモパッケージとドキュメントをAutomation Anywhere社の製品ドキュメントページ (docs.automationanywhere.com) から入手。(SDK Demo Package: April 2020, Release (2019.12.1) A2019-package-sdk.2.0.1.zip, ドキュメント: Automation Anywhere Enterprise Package Development Kit および A2019-package-annotations-javadoc.zip。製品ドキュメントは日本語版もあるが、情報が古いことがあるので英語版を参照することをお勧めします。)
  • Java IDEで開発、.jarファイルの作成: Gradleでプロジェクトの設定を行い、.jarファイルをビルドします。
  • ビルドしたパッケージをControl Roomに登録: ビルドされた.jarファイルをControl Roomの管理画面でアップロードします。

Java統合環境 IntelliJ IDEA Community Editionのインストール

次はJava IDEをセットアップします。製品ドキュメントではEclipseかIntelliJ Community Editionが指定されているので、ここではIntelliJを使うことにします。

以下のJetBrainsのページにアクセスして「コミュニティ」版の.exeをダウンロードしてインストールしてください。.exeのボタンを押すと、メールアドレスの入力を求められますが、入力しなくてもダウンロードが自動的に始まるので、入れなくても結構です。
https://www.jetbrains.com/ja-jp/idea/download/
image.png

550MBくらいの以下のような.exeがダウンロードできればOKです。(idealC-XXXX.X.X.exe、X部分の数字はバージョンが上がるごとに違う数字になっている可能性があります。)
image.png

また、IDEは基本英語ですが、日本語のベータ版もテスト中のようなので、興味がある人はダウンロードして入れてみてください。これは1.5MBくらいの.jarファイルで、IDEをインストールした後にセットアップすることでシームレスにIDEに統合してインストールできます。

参考記事: 『IDEの起動と日本語化プラグインの入手、インストール』

インストールのステップ

idealC-XXXX.X.X.exe を実行して、「アプリがデバイスに変更を加えることを許可する」に「はい」と答え進めていきます。
image.png

最初の画面で「Next」ボタンをクリックします。
image.png

「Next」ボタンをクリックします。
image.png

必要に応じてファイルの関連付けにチェックを入れます。「Next」ボタンをクリックします。
image.png

「Install」ボタンをクリックします。
image.png

インストールが進行しますのでそのまま待ちます。
image.png

「Finish」ボタンをクリックします。これでインストールは完了です。
image.png

SDK ファイルをJava IDEで開く

あらかじめSDKファイル A2019-package-sdk.2.0.1.zipをダウンロードして、パソコンの任意の場所に展開しておきます。最近のバージョンでは、UIの多言語対応機能などが追加されているようです。
image.png

Windowsのスタートメニューを開くと「最近追加されたもの」にIntelliJがあるはずですので、クリックしてIntelliJ IDEを開きます。
image.png

以下のダイアログボックスが表示される場合は、そのまま「OK」ボタンをクリックします。
image.png

初回はカスタマイズするかを聞かれるので「Skip...」をクリックします。
image.png

「Open or Import」をクリックします。
image.png

zipファイルの中身を展開したフォルダーを選択します。「OK」ボタンをクリックします。
image.png

するとこんな画面が開きます。
image.png

JDKのダウンロード

さて、画面下部のビルドログのパネルで、「Invalid Gradle SDK configuration found」というエラーが表示されています。これは、まだ適切なJDKをインストールしていないために表示されます。「Open Gradle Settings」をクリックします。
image.png

すると「File」-「Settings...」を指定したときと同じ画面が開きます。Gradle JVMが「」となっているので、ドロップダウンの「Download JDK...」をクリックします。
image.png

JDKはバージョン11が必要とのことなので、Automation Anywhereでも使っているAzul Zulu Communityの11を指定しておきます。「Download」ボタンを指定すると、所定の場所にダウンロードが開始されます。
image.png

ちなみに、IntelliJの場合は、ビルドはIDEの「Build」コマンドから行うのではなく、Terminalからコマンドラインでgradelew.batを呼ぶことで行われます。(EclipseはIDEからコンパイルできるようです。) IntelliJの場合は、Gradleを使ったビルドに完全には対応していないためのようです。

そのため、JDKをインストールしたら、環境変数JAVA_HOMEにJDKのルートフォルダを指定しておく必要があります。
今回の例だと

set JAVA_HOME=C:\Users\(User名)\.jdks\azul-11.0.7

と設定しておきます。

パッケージのビルド (コマンドライン)

IDEの中のTerminalから、環境変数JAVA_HOMEの設定を行った後、ビルドコマンド gradlew.bat clean build shadowJarを実行します。すると、ビルドが始まります。
image.png

途中、警告や注意が出る可能性がありますが、以下のようにしてビルドが完了します。

D:\AASDK\A2019-package-sdk-2.0.1>gradlew.bat clean build shadowJar
Downloading https://services.gradle.org/distributions/gradle-5.4.1-bin.zip
...................................................................................

Welcome to Gradle 5.4.1!

Here are the highlights of this release:
 - Run builds with JDK12
 - New API for Incremental Tasks
 - Updates to native projects, including Swift 5 support

For more details see https://docs.gradle.org/5.4.1/release-notes.html

Starting a Gradle Daemon (subsequent builds will be faster)

> Task :compileJava
...

> Task :commandCodeGen
mergeJsonFiles: updatePackage: group com.automationanywhere , artifactName A2019DemoPackage , packageVersion 2.0.1-20200607-015603

BUILD SUCCESSFUL in 51s
6 actionable tasks: 5 executed, 1 up-to-date
D:\AASDK\A2019-package-sdk-2.0.1>

ビルドが完了したら、(プロジェクトフォルダ)\build\libsにコンパイルされたファイル (.jarファイル)が出力されています。
image.png

パッケージのControl Roomへのアップロード

Control Roomにパッケージを追加する権限を持っているユーザーであれば、「Bot」-「パッケージ」で、「Packageを追加...」メニューを使うことができます。
image.png

先ほどビルドした.jarファイルを「アップロードするパッケージ」に指定してください。そして、「パッケージをアップロード」ボタンをクリックします。
image.png

このパッケージの中には28個のアクションが含まれていることがわかります。内容のプレビューが可能です。このまま有効化するには、「承認、有効、デフォルトとして設定」ボタンをクリックします。
image.png

これでBot構築画面からパッケージとして使えるようになります。

Bot構築画面からパッケージを使ってみる

Bot構築画面では、アクションパレットの中に「A2019DemoPackage」が追加され、その下に28個のアクションが追加されています。アクションをフローに取り込んでみると、それぞれアクションの詳細にも引数などが指定されていることがわかります。
image.png

おわりに

いかがでしたでしょう！？ここまででひとまずビルド環境の構築をして、SDKサンプルのファイルをそのままビルドしてControl Roomにアップロード、利用するところまで手順を確認できたと思います。

続編では、いよいよSDKサンプルの中身の解説と、編集してオリジナルのパッケージを作成する方法を見ていきたいと思います！

この記事のシリーズ

参考資料

2
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
2
0