Your Java activity step can access PRPC facilities, using the classes and interfaces in the com.pega.pegarules.pub.*
packages. JavaDocs documentation for this Application Programmer Interface in the location as the Application Developer Help System.
This PublicAPI is the official, supported public interface to the rules engine. Pegasystems intends to maintain backward compatibility in new releases for the APIs accessible through these packages, although this cannot be guaranteed. In contrast, other packages and interfaces are subject to change without notice.
For example, these two PublicAPI Java methods are part of the ClipboardProperty interface to the com.pega.pegarules.pub.clipboard
package. They get and set properties on a page:
public ClipboardProperty getProperty(java.lang.String propertyreference)
public boolean ClipboardProperty setValue(ClipboardProperty avalue)
Do not confuse the Public API with the Process Engine API, a collection of activities for work items.
To access the home page of the JavaDocs pages for the Public API, select > APIs > Engine. (The Public APIs are sometimes called the Engine APIs).
The keyword tools
identifies the PublicAPI interface in Java calls.
The PublicAPI includes these classes:
com.pega.pegarules.pub.*; // Classes common to most public interfaces.
com.pega.pegarules.pub.clipboard.*; //Clipboard, Page, and Property
com.pega.pegarules.pub.context.*; // Requestor, Thread, and Node
com.pega.pegarules.pub.database.*; // Relational database access
com.pega.pegarules.pub.dictionary.*; // Dictionary validation interface
com.pega.pegarules.pub.generator.*; // Java generation
com.pega.pegarules.pub.pal.*; // Reports statistics about a Thread
com.pega.pegarules.pub.runtime.*; //Activities, Data Transforms, Whens, Streams
com.pega.pegarules.pub.util.*; // Miscellaneous utilities
Caution: Use of PRPC Java packages, classes, methods, or interfaces that are not part of the public interface is strongly discouraged and may result in code that fails or returns incorrect results with future releases or on specific platforms.