More about Parse Delimited rules

Evaluating a Parse Delimited rule

Service and connector forms may reference Parse Delimited rules in data mapping. When evaluating the service or connector, the system evaluates the Parse Delimited rule.

• To execute a Parse Delimited rule in an activity, use the Apply-Parse-Delimited method.
• To execute a Parse Delimited rule in an activity Java step, use the PublicAPI Java method getParseUtils().

Debugging

To debug a Parse Structured rule, include a Java step containing the PublicAPI call:

myStepPage.putString("debug3", Long.toString(parseState.getStreamOffset()) );

where debug3 is a Single Value property. This function places the byte offset position of the parseState Java object into a clipboard value that you can review with the Tracer or Clipboard tool.

Using the Tracer

To trace the start and end of Parse Delimited rule execution, select the Parse Rules check box in the Rule Types to Trace area of the Trace Options panel. See Tracer — Setting Options.

Monitoring performance

Through changes to the prconfig.xml file, you can be alerted to unusually long Parse Delimited executions as PEGA0011 alerts. See How to detect lengthy service operations.

Example

The CSV (Comma Separated Values) file format is supported by Microsoft Excel and many other programs for simple interchange of flat-file data. If your application needs to import data from CSV files, a Service File rules can use a Parse Delimited rule. For an example, see Pega Developer Network article PRKB-25573 How to parse a Comma-Separated-Values (CSV) file using a file service.

	About Service File rules Apply-Parse-Delimited method
	Atlas — Standard Parse Delimited rules

About Parse Delimited rules