Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

About Connect JCA rules

Updated on August 16, 2022

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: Beginning in Pega Platform 8.6, EAR deployments of Pega Platform are deprecated. In the upcoming 8.7 release, EAR deployments will not be supported. As a result, in Pega Platform 8.7, Connect JCA rules will also no longer be supported. For more information on the alternatives for EAR-related rules, see Deprecation of EAR deployments in Pega Platform 8.6.

The following tabs are available on this form:

  • Service
  • Input
  • Output


To list the Connect JCA rules in your application, use the Application Explorer or click ConfigureIntegrationConnector Definitions & Simulations.

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


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.

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.

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.


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

  • Previous topic Connect Java rules - Completing the Create, Save As, or Specialization form
  • Next topic Connect JCA rules - Completing the Create, Save As, or Specialization form

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us