Configuring Your Integrated Development Environment (IDE) to Use Custom Steps

Custom steps, using the server-side API (SSA), gives you a flexible and powerful tool to use to extend your Services Builder projects by using the Java programming language within your tasks.

To successfully use custom steps you must set up your IDE to work with Task Builder for Screens. Task Builder is project based, as are most IDEs. It is important that both Task Builder and your IDE are pointing at the same project and working together.

When you create a project in Task Builder two directories are created automatically:

Where, by default, <Install Location> is "Program Files" and <project name> is the name of your Task Builder project.

Configuring your IDE to work with custom steps
Depending on your choice of IDE, these steps may vary.
  1. Create a new project in your IDE with the same name as your Task Builder project.

  2. Configure your IDE sources to point to the <Install Location>\Attachmate\EAI\recordings\<project name>\ssa\sources directory and configure the IDE ouput (classes) to point to the <Install Location>\Attachmate\EAI\recordings\<project name>\ssa\classes directory.

  3. Configure your IDE to import server-side API (SSA) libraries from <Install Location>\Attachmate\EAI\ScreenConnectors\lib\nav.jar.

  4. Depending on your IDE, you may have to configure the compiler to use the classes directory that you configured for output.

  5. After completing the above steps you should be able to create new custom step classes in your IDE, compile them, and have them automatically display in the Convert Step to Custom Step dialog box in Task Builder. Using this configuration you can switch between a design and test mode in Task Builder and an edit, build, and debug mode in your development environment.

Viewing Custom Step Execution in the Designer Studio Java Console

Note Be sure to configure your IDE to generate debugging information in your compiled classes.

By inserting System.out.println statements in your Java code you can view custom step execution in the designer Java console.

Enabling the Java Console
  1. Open <Install Location>\Attachmate\EAI\Common\ATMStudio.lp.

  2. Edit the file by changing the default value:

    showconsole=no
    - to -
    showconsole=yes

  3. Restart the Designer Studio.
Related Topics
Bullet Using Advanced Navigation, Overview
Bullet Using Custom Steps
  Attachmate