Connect Java form – Completing the Service tab

Complete the Service tab first.

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

Java class

Field Description
Java class Enter a fully qualified name of the Java class.

Java class constructor

Field Description
Java class constructor If the value in the Initialize object field is set to either Create a new object every time or If possible, use a valid object handle, identify the name of the constructor to be used. If this constructor requires parameters, complete the Constructor tab.

Java class method

Field Description
Initialize object Indicate whether a new Java object is to be used for each call. Select one:
  • Create a new object every time
  • If possible, use a valid object handle
  • Require use of a valid object handle
Method Enter the signature of the method to be called, identifying the position and types of each parameter. For example: 
getPhone(String) getSize()
Finalize object Specify behavior of the object after the call completes. Select one:
  • Remove object after method call
  • Keep alive and store object handle
Object handle property Optional. To save an object handle across multiple calls, identify a property of mode Java Object to contain the handle.

Error handling

Field Description
Status value property Optional. Identify a Single Value property that can hold a status value returned by the connector. The literal value Good identifies success. You can use the standard property @baseclass.pyStatusValue.
Status message property Optional. Identify a Single Value property that can receive a text error message returned by the connector. You can use the standard property @baseclass.pyStatusMessage.
Error handler flow Optional. Identify a flow rule that is to be started when this connector rule is started by a flow rule but fails. The default flow rule Work-.ConnectionProblem provides one approach for handling such problems. See Handling connector exceptions.
Invocation exception property Optional. Select a property of mode Java Object to contain a Java exception, if any are thrown during this connection execution.

Test connectivity

Field Description
Test connectivity Click this button at any time after you have completed and saved the form to confirm that Pega Platform can connect to the Java class identified.

The system presents test results in a separate window, identifying the parameters used in the test, the steps attempted, and the outcome of each step.

Simulations

Field Description
Simulations Click to create a simulator for this connect rule. See Creating Connect Simulators.

You can use Tracer to trace and analyze connector and service events.