Running the RAS API examples

The RAS API examples are provided as pluglets. These small Java™ applications can be run from the Package Explorer view.

For more information about pluglets, see the topic "Extending your Java environment with pluglets".

To successfully run this pluglet you must install a workgroup repository. For details about how to install a workgroup repository, go to the IBM alphaWorks Web site and search for RAS. After setting up and configuring your workgroup repository, change the connection URL in the pluglet code to connect to it.

To run the RAS API examples:

  1. Click Window > Open Perspective > Other > Java to open the Java perspective.
  2. Click Project and verify that Build Automatically is enabled.
  3. If you need to enable automatic builds, click Project > Build All .
  4. Verify that no compilation errors are listed in the Problems view.
  5. Click Window > Show View > Package Explorer to open the Package Explorer view.
  6. Expand one of the project folders that is annotated with a running person icon to indicate that it includes executable code.
  7. Expand any of the com.ibm.ras.example. packages in the project.
  8. Right-click one of the .java files that is annotated with a running person icon to indicate that it can be run and click Run > Pluglet.
The pluglet runs with results as outlined by the success criteria for each example. For example, the ExportCreateAsset pluglet will create a newly packaged asset named ExportCreateAsset.ras in the \Export\Examples\ExportedAssets folder in the workspace when run successfully. For success criteria and results for the RAS API examples, see the “Types of RAS extensions” topic.

The code for the pluglets can be viewed like any Java class. Double-click the pluglet in the Package Explorer view and it opens in an editor. The code for the example can be read, modified, and rerun.

Related tasks
Importing and exploring the examples
Running the RAS Ant examples
Related reference
RAS export API example
RAS import API example
RAS profile artifact API example
RAS profile service API example
RAS repository API example
RAS Web service API example

Related information

Extending your Java environment with pluglets

IBM alphaWorks Web site

Sample for extending the RAS environment

Terms of use | Feedback
(C) Copyright IBM Corporation 2004, 2005. All Rights Reserved.