Back Forward External class

An external class is a concrete class (instance of the Rule-Obj-Class rule type) that corresponds to a table in an external relational database, rather than to a table or view in the PegaRULES database. C-1854 You can create an external classes and associated properties using:

No inheritance or rule resolution applies to external classes, even if the class name contains a dash character. Each external class has an associated database table instance (Data-Admin-DB-Table class) and so cannot be part of a class group.

These methods can operate on an instance of an external class:

  • Obj-Browse Suprakash 7/15/08
  • Obj-Open
  • Obj-Open-by-Handle CLINB 5/17/06
  • Obj-Delete
  • Obj-Refresh-and-Lock
  • Obj-Save
  • Obj-Save-Cancel
  • Commit
  • Rollback

You can't create Declare Index rules which have an external class as the Applies To key part. However, Declare Expression rules (Rule-Declare-Expressions rule type), validate rules (Rule-Obj-Validate rule type), and trigger rules (Rule-Declare-Trigger rule type) do operate on clipboard property values for external classes.

External classes do not contain the two properties @baseclass.pzInsKey and @baseclass.pxObjClass, which are present in every internal class. In some cases, no single property in the external class can serve as a unique handle. To support the Obj-Open-by-Handle method with external classes, PRPC assembles a substitute string from the key columns of the table.

In certain cases, the performance of database insert, delete, and update operations for external classes can be improved through the optional batchUpdates setting in the prconfig.xml file or Dynamic System Setting. See Commit method.

NoteSystem messages sometimes refer to external classes as "Obj-External". (However, PRPC has no Obj-External method.)

NoteDon't confuse these external PRPC classes with external Java classes. For the latter, see the PDN article About the Process Commander class paths.

Definitions class, internal class, Java Transaction API, two-phase commit
Related topics About the Connector and Metadata wizard
Data Model category — Database Class Mapping page

Up Definitions