Extract-data-call

From GreenVulcano Wiki
Jump to: navigation, search

Description

Use this GreenVulcano® ESB if you want to read from a message.

VulCon / GV Console Configuration

The operation extract-data-call allows you to extract data from the message body and write them into GVBuffer property.

The data can be extracted from XML messages and ASCII messages. To extract data from XML message using XPath expressions, and to extract data from-ASCII messages using regular expressions.

You can also define a portion of the buffer to be interpreted as XML or ASCII.

The extract-data-call Element is used by Channel and routed-call. It has the following attributes:

Attribute Type Description
type fixed This attribute must assume the value call.
class fixed This attribute must assume the value it.greenvulcano.gvesb.virtual.internal.ExtractMessageData.
name required Operation name. Used in the 'Flow' section to associate workflow nodes to VCL operations.
message-type required Indicates if the message is ASCII or XML. The attribute's admitted values are:
  • XML
  • ASCII
encoding optional Encoding for the interpretation of ASCII messages.
begin-index optional Initial index in data buffer. If not specified index starts at byte 0.
length optional Length of data. If not specified reaches the end of the buffer data.

Its sub-elements are:

extract-data

This element defines the parameter for the data reading.

The extract-data Element is used by: extract-data-call. It has the following attributes:

Attribute Type Description
field required Name of property that will contain the data extracted.
expression required XPath or regular expression used to extract the data to be included in the property. The expression is interpreted according to the type of message (ASCII or XML).
matching-group optional Matching group to be extracted. Valid only if the type of message is ASCII.