About Connect JCA rules

Use a Connect JCA rule to define a connection to an external Enterprise Information System (EIS) through a resource adapter that implements the Common Client Interface (CCI) of the Java EE Connector Architecture (JCA) specification.

Note: Connect JCA rules are no longer being actively developed, and are being considered for deprecation in upcoming releases. Using Connect JCA rules does not follow Pega development best practices. Consider other implementation options instead.

The following tabs are available on this form:

Access

To list the Connect JCA rules in your application, use the Application Explorer or click Configure > Integration > Connector Definitions & Simulations.

To list all Connect JCA rules that are available to you, use the Records Explorer.

Development

Before you begin, create an instance of the Data-Admin-Connect-JCAAdapter class that defines the resource adapter you want the connector to communicate with. See More about Connect JCA rules.

A JCA connector rule gathers the data for an input record and then invokes the resource adapter Execute() method for a specific function. The resource adapter data instance specifies which Execute() method to use. The connector rule determines which of the resource adapter InteractionSpec methods to use and provides the input record object. If required by the resource adapter, the connector rule also instantiates the output record object and provides a reference to that object in the request.

To debug your application, you can simulate a JCA connector when the external class is unavailable or lacks a test environment. See Creating Connector Simulations.

Where referenced

Connect JCA rules can be referenced in an Integrator shape of a flow rule, or on the Definition tab of a Data Page rule, as the source of data for the contents of the data page.

Category

A Connect JCA rule is an instance of the Rule-Connect-JCA rule type. Connect JCA rules belong to the Integration-Connectors category.

Integration-Connectors category