Develop a sample package

Develop your own package and upload it to an Control Room to provide custom actions for bots.

Prerequisites

Download and extract the contents from the latest Automation 360 Package SDK release. The newest package contains the necessary sample source code to build your package.

You need to have a project created in a Java IDE. For details about setting up a project, read Set up the Java project.

The following high-level tasks provide the basic workflow for creating a package.

Procedure

  1. Create a java class.
    This class is the action you plan to publish in your package.
    Important: It is required that the class supports the default constructor.
  2. Add required business logic to the class.
    The following are the supported return types:
    • Void: Use this return type if your action does not return any value.
    • Value: Use this return type if your action returns any type of value.
  3. Annotate the class with BotCommand and CommandPkg Annotations to make the class eligible to be converted to an action.
  4. Annotate the variable that accepts values with Idx and Pkg .
  5. Annotate the entry method with the Execute annotation.
  6. From the action prompt, run gradlew.bat clean build shadowJar.
    The JAR file created from the build is located in build/lib .

Next steps

From the Control Room on the Manage > Package page, click the Add package icon to upload the JAR file.

Tip: To upload a package to a Control Room, you need Upload package permission. Review how to add a package to a Control Room: Add packages to the Control Room.