Back Forward PublicAPI interface

Your Java activity step can access Process Commander 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 Interface 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:

NoteDon't confuse the Public API with the Desktop API, a collection of JavaScript functions, or the Process Engine API, a collection of activities for work objects.

Structure

To access the home page of the JavaDocs pages for the Public API, select Help > 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, Models, Whens, Streams
com.pega.pegarules.pub.util.*; // Miscellaneous utilities

Private methods

CautionUse of Process Commander 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.

Definitions Desktop API, JavaDocs, Process Engine API
Related topics Concepts and terms — Process Commander for Java developers
Examples — Using inline Java and PublicAPI facilities

zzz Definitions — P