RDB-Save method

Use this method to save the contents of a clipboard page into a row of a relational database. The system saves the properties on the specified step page to the specified table in the database.

This method operates in conjunction with a Connect SQL rule that contains SQL statements such as INSERT, UPDATE, and CREATE statements on the Save tab.

On the Save tab of the Connect SQL rule, use the special data syntax described in Connect SQL rules — Data mapping.

Use Connect SQL rules and the RDB-Save method only with an external database. Do not use Connect SQL rules or RDB methods to update the PegaRULES database. Because not all properties in the Pega Platform databases are distinct database columns, use the Obj-Open and Obj-Save methods, not the RDB- methods, with the PegaRULES database to prevent loss of data.

Parameters

This method has four parameters. Three required parameters together identify a Connect SQL rule. The final parameter controls a processing option.

Parameter Description
ClassName Enter the class of the step page. The system uses this as the Applies To key part of a Rule-Connect-SQL rule.
Note: Identify the exact class of the rule. The system does not use class inheritance to find the Rule-Connect-SQL instance.
RequestType Enter the third key part — Request Type — of the Connect SQL rule containing the save operation.
Access Enter the second key part — Package Name — of the Connect SQL rule (by convention MSSQL, Oracle, Db2, UDB, or Sybase, but not restricted to these values).
RunInParallel Select if you want processing for the connector to continue in a separate requestor session, in parallel with the current requestor session. When selected, use the Connect-Wait method later in the current or a later activity to access results from the connector.

Clear if you want processing in this requestor session to pause until the connector processing completes.

Results

This method uses rule resolution to find and open the Rule-Connect-SQL instance identified by the three parameters. It then processes the SQL text in the Save tab using current clipboard values. Finally, it sends the converted SQL to the external database, which performs the Save.

When the RunInParallel box is selected, the SQL operation occurs in a new requestor session. This temporary requestor has the same access group and clipboard as the original. At most 10 such child requestor sessions can be active at once.

Each RDB-Open, RDB-Save, and RDB-Commit method involves an SQL database commit operation. You cannot implement SQL transaction commit operations across two or more Connect SQL rules.

Checking the method status

This method updates the pxMethodStatus property. See How to test method results using a transition.

When a {SQLPage:pagename} directive appears as the first line of the SQL code on the Save tab, a top-level page named pagename is created. If errors occur, properties on that page contain additional error details. (When RunInParallel is selected, this page is not available to the original requestor unless the dynamic system setting isPropageteExceptionFromChildToParent is added to the Pega-RULES ruleset and set to true. For more information, see Using dynamic system settings.)

Methods and instructions by function