Difference between revisions of "Extract-data-call"

From GreenVulcano Wiki
Jump to: navigation, search
(Created page with "==Description== Use this {{GVESB}} if you want to read from a message. =={{VULCON}} / {{GVCONSOLE}} Configuration== The operation extract-data-call allows you to extract data ...")
 
({{VULCON}} / {{GVCONSOLE}} Configuration)
 
(3 intermediate revisions by the same user not shown)
Line 12: Line 12:
  
 
The extract-data-call Element is used by [[Channel]] and [[routed-call]]. It has the following attributes:
 
The extract-data-call Element is used by [[Channel]] and [[routed-call]]. It has the following attributes:
* ''type'': call.
+
{|class="gvtable"
* ''class'': it.greenvulcano.gvesb.virtual.internal.ExtractMessageData.
+
! Attribute !! Type !! Description
* ''name'': Operation name. Used in the 'Flow' section to associate workflow nodes to VCL operations.
+
|-
* ''message-type'': Indicates if the message is ASCII or XML. The attribute's admitted values are:
+
| type || fixed || This attribute must assume the value '''call'''.
** XML
+
|-
** ASCII
+
| class || fixed || This attribute must assume the value '''it.greenvulcano.gvesb.virtual.internal.ExtractMessageData'''.
* ''encoding'': Encoding for the interpretation of ASCII messages.
+
|-
* ''begin-index'': Initial index in data buffer. If not specified index starts at byte 0.
+
| name || required || Operation name. Used in the 'Flow' section to associate workflow nodes to VCL operations.
* ''length'': Length of data. If not specified reaches the end of the buffer data.
+
|-
 +
| 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 subelements are:
+
Its sub-elements are:
* Description
+
* [[Description]]
* extract-data
+
* [[#extract-data|extract-data]]
 
* [[ServiceAlias]]
 
* [[ServiceAlias]]
  
Line 32: Line 42:
  
 
The extract-data Element is used by: extract-data-call. It has the following attributes:
 
The extract-data Element is used by: extract-data-call. It has the following attributes:
* ''field'': Name of property that will contain the data extracted.
+
{|class="gvtable"
* ''expression'': 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).
+
! Attribute !! Type !! Description
* ''matching-group'': Matching group to be extracted. Valid only if the type of message is ASCII.
+
|-
 +
| 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.
 +
|}

Latest revision as of 16:21, 10 April 2012

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.