This page covers some options for setting up an integrated development environment (IDE) to develop and debug robotic tasks.

Eclipse

Visit the Eclipse website to download Eclipse. It is advisable to use the last stable version.

After the Eclipse installer executable has finished downloading, start the installer and follow the instructions. Once the installation is completed, you can now launch Eclipse and make some configurations.

As an example, we will create the workspace directory C:\software\eclipse.projects to store your source in a project directory.

In the following steps, we will choose a workspace directory folder where we have decompressed our robotic task code.

Configure the following settings:

1. In Eclipse, click Window then Preferences.

2. Expand the Java item and verify that in Compiler, 1.8 is selected in the Compiler compliance level menu.

   

3. Then, select Installed JREs in the menu on the left of the window.

4. Make sure a JDK is associated. You can add a new definition pointing to the Java directory you just installed and select it here.

   

5. Finally, we verify the integration of Maven in Eclipse. Within the Preferences window, click and expand Maven > Installations.
6. In this menu we will add a new entry pointing to the Maven installation we just made.

Import a project to Eclipse

After you've created your Maven project, you're ready to import it to Eclipse.

1. In Eclipse, open the File menu.
2. Click Import to open the Eclipse import wizard.
3. In the wizard, choose Maven>Existing Maven Project and click Next.
4. Click Browse to select the Maven project to be imported. In this example, we'll use robot-developmentguide-first-robot.
5. Select the folder where the pom.xml file is located. This folder depends on the path in which the Maven project was previously created.
6. Click Finish and you will have your project imported to Eclipse.

You can see the loaded project in the window Package Explorer, with all the necessary dependencies.

Among the files of our new project, there is a basic file pom.xml with everything we need to start developing our robotic task.

This file contains the necessary information to include any of the Appian RPA modules available in the platform into the robotic task.

The dependencies with these modules will appear commented and the versions will point to the latest available version of such modules.

The different modules are in continuous improvement and enhancement process, hence the Appian RPA team may release new versions of them over time. The software will be backward compatible in the vast majority of times. Nevertheless, when necessary, the Appian RPA team will also provide the guidelines to adapt the source code, if such compatibility did not exist.

If we observe in the project some errors related to Maven with a text like Project build error: Non-resolvable parent POM for…, it is likely to be solved by updating the Maven project.

To perform this update, we must go to the project root in Eclipse and press ALT + F5, which will request an Update Maven Project. When the pop-up window shows up, we can also mark the option Force Update of Snapshots/Releases to be even more sure.

IntelliJ

You can download IntelliJ IDEA from the JetBrains website. Once the file has finished downloading, launch the installer.

Configure these settings after IntelliJ is installed:

1. In IntelliJ, click Settings/Preferences.
2. Click Languages and Framework > JavaScript.
3. In the list, select JavaScript 1.8.5.

Next, associate a JDK:

1. Click File > Project Structure.
2. Under Project Settings, click Project.
3. In the Project SDK area, click New and choose JDK.
4. Select the location of your JDK and click OK.

Import a project to IntelliJ

1. In IntelliJ, open the File menu.
2. Click Open.
3. In the window, select the pom.xml file of the Maven project.
4. Click OK.
5. In the next window, click Open as Project.

IntelliJ will automatically sync the Maven project. Additional information about Maven import settings can be found at the JetBrains website.