Difference between revisions of "GVOperationNode"

From GreenVulcano Wiki
Jump to: navigation, search
(Created page with "==Description== A GVOPerationNode: Is a operative node indicating that {{GVESB}} must perform a communication with an external systems (invocation, sending messages, receivi...")
 
 
(40 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
==Description==
 
==Description==
  
A GVOPerationNode: Is a operative [[node]] indicating that {{GVESB}} must perform a communication with an external systems (invocation, sending messages, receiving messages). For example, if the node indicates a ''receive a message'' (see attribute [[op-type]]), you can also define a
+
A GVOperationNode is an [[Operations|operation node]] indicating that {{GVESB}} must perform a communication with an external systems (invocation, sending messages, receiving messages). For example, if the node indicates a ''receive a message'' (see attribute [[op-type]]), you can also define a
[[DequeueFilter]] that sets certain conditions that the received message must meet.
+
[[Op-type#DequeueFilter|DequeueFilter]] that sets certain conditions that the received message must meet.
  
 
=={{VULCON}} / {{GVCONSOLE}} Configuration==
 
=={{VULCON}} / {{GVCONSOLE}} Configuration==
  
The GVOperationNode is a [[Flow]] element. It has the following attributes:
+
The GVOperationNode is a [[Flow]] element that extends [[FlowNode]]. It has the following attributes:
  
* type: flow-node;
+
{|class="gvtable"
* class: it.greenvulcano.gvesb.core.flow.GVOperationNode.
+
! Attribute !! Type !! Description
* id: ID of the node. Unique within the 'Flow' and its value cannot be null.
+
|-
* [[op-type]]: The attribute admitted values are:
+
| class || fixed || This attributes must assume the value '''it.greenvulcano.gvesb.core.flow.GVOperationNode'''
** call
+
|-
** enqueue
+
| op-type || fixed || This attributes must assume the value '''call,enqueue,dequeue'''
** dequeue
+
|-
* input: Specifies the input (from the execution environment) for the operation. <br/> If the input is an exception, the operation is not performed, and the output is set equal input exception. Its value can't be null.
+
| id-system || required || Identifies the system involved in communication. Can be selected from systems declared as [[Participant]] in the [[Operation]] section. <br/> The attribute value can't be null.
* output: The operation's output ([[GVBuffer]] or Exception) is inserted into the execution environment with this exact name.<br/> Default to "input" value. The attribute value can't be null.
+
|-
* next-node-id: Indicates the next node in the workflow to execute when the operation ends.
+
| operation-name || required || Identifies the communication operation selected by the channel of the system indicated by the ''id-system'' attribute.<br/> Only the operations of the type declared in the 'op-type' attribute can be selected. Its value cannot be null.
* id-system: Identifies the system involved in communication. Can be selected from systems declared as [[Participant]] in the [[Operation]] section. <br/> The attribute value can't be null.
+
|}
* operation-name: Identifies the communication operation selected by the channel of the system indicated by the ''id-system'' attribute.<br/> Only the operations of the type declared in the 'op-type' attribute can be selected. Its value cannot be null.
 
* point-x: X position of the node in the {{L_VULCON}} workflows editor. Immutable, used by {{L_VULCON}}.
 
* point-y: Y position of the node in the {{L_VULCON}} workflows editor. Immutable, used by {{L_VULCON}}.
 
* dump-in-out: If true enable the dump of the input/output GVBuffer. Default ''false''. The attribute admitted values are:
 
** true
 
** false
 
* dump-env-in-out: If true enable the dump of the input/output Execution Environment. Default false. The attribute admitted values are:
 
** true
 
** false
 
  
 +
and the subelements:
 +
 +
* [[#InputServices|InputServices]]
 +
* [[#OutputServices|OutputServices]]
 +
* [[Op-type#DequeueFilter|DequeueFilter]]
 +
 +
===InputServices===
 +
 +
Before doing any communication you can run an ordered list of input services.
 +
 +
This section allows the definition of input services for the current communication operation. The current version of {{GVESB}} provides the following services:
 +
* Data Transformation
 +
* XML Validation
 +
* OGNL/Java Scripting
 +
 +
The InputServices Element is used by: [[GVIteratorOperationNode]] and '''GVOperationNode'''.
 +
 +
Might contain the following elements:
 +
* [[Description]]
 +
* [[#gvdte-service|gvdte-service]]
 +
* [[#xml-validation-service|xml-validation-service]]
 +
* [[#ognl-script-service|ognl-script-service]]
 +
* [[#java-script-service|java-script-service]]
 +
* [[#dh-selector-service|dh-selector-service]]
 +
 +
===OutputServices===
 +
 +
After doing any communication you can run an ordered list of output services.
 +
 +
This section allows the definition of output services for the current communication operation.  The current version of {{GVESB}} provides the following services:
 +
* Data Transformation
 +
* XML Validation
 +
* OGNL/Java Scripting
 +
 +
The OutputServices Element is used by [[ChangeGVBufferNode]], [[GVIteratorOperationNode]] and '''GVOperationNode'''.
 +
 +
Might contain the following elements:
 +
* [[Description]]
 +
* [[#gvdte-service|gvdte-service]]
 +
* [[#xml-validation-service|xml-validation-service]]
 +
* [[#ognl-script-service|ognl-script-service]]
 +
* [[#java-script-service|java-script-service]]
 +
 +
 +
===In/Out Services===
 +
====gvdte-service====
 +
 +
Invokes the Data Transformation Engine (GVDTE). Refer to the documentation GVDTE for information on features of {{GVESB}} Data Transformation Engine.
 +
 +
The following table shows the gvdte-service element's attributes:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value '''service'''.
 +
|-
 +
| internal || fixed || This attribute must assume the value '''yes'''.
 +
|-
 +
| critical || optional || Defines if the service is critical. A critical service failure mark the entire communication as failed.
 +
The attribute's default value is: yes.
 +
|-
 +
| remove-fields || optional || Indicates whether or not to remove from the buffer the fields used for communication with GVDTE.
 +
The attribute's default value is: yes.
 +
|}
 +
 +
Its sub-elements are:
 +
* [[Description]]
 +
* [[#map-name-param|map-name-param]]
 +
* [[#gvdte-context-call|gvdte-context-call]]
 +
* [[#gvdte-extra-param|gvdte-extra-param]]
 +
 +
=====map-name-param=====
 +
 +
Specifies the name of the transformation that should apply by GVDTE.
 +
 +
This name must indicate a transformation currently configured in GVDTE.
 +
 +
This parameter can be optional if the input GVBuffer has a property with the name map-name.
 +
 +
The following table shows the map-name-param element's attributes:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value '''param'''.
 +
|-
 +
| name || fixed || This attribute must assume the value '''map-name'''.
 +
|-
 +
| value || required || Specifies the name of the transformation that should apply by GVDTE.
 +
This name must indicate a transformation currently configured in GVDTE.
 +
|}
 +
 +
=====gvdte-context-call=====
 +
 +
Communication parameters to interact with GVDTE.
 +
 +
The following table shows the gvdte-context-call element's attributes:
 +
{|class="gvtable"
 +
! 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.DTEServiceContextCall'''.
 +
|-
 +
| name || required || ID used for diagnostics. Is printed on the log files.
 +
|}
  
and the subelements:
+
=====gvdte-extra-param=====
 +
 
 +
Allows you to specify additional parameters for the transformation GVDTE must apply.
 +
 
 +
The following table shows the gvdte-extra-param element's attributes:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value '''param'''.
 +
|-
 +
| name || required || Parameter name. The attribute's value can't be null.
 +
|-
 +
| value || required || Parameter value. The value of this attribute can be static or can be interpreted dynamically, as the value of a metadata expression that also employee the input GVBuffer.
 +
|}
 +
 
 +
====xml-validation-service====
 +
 
 +
Invokes the XML validation engine.
 +
 
 +
The following table shows the xml-validation-service element's attributes:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value '''service'''.
 +
|-
 +
| internal || fixed || This attribute must assume the value '''yes'''.
 +
|}
 +
 
 +
Its sub-elements are:
 +
* [[Description]]
 +
* [[#xml-validation-call|xml-validation-call]]
 +
 
 +
=====xml-validation-call=====
 +
 
 +
Communication parameters to interact with XML validation engine.
 +
 
 +
The following table shows the xml-validation-call element's attributes:
 +
{|class="gvtable"
 +
! 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.xml.XMLValidationCallOperation'''.
 +
|-
 +
| name || required || ID used for diagnostics. Is printed on the log files.
 +
The attribute's value can't be null.
 +
|-
 +
| default-xsd || optional || Default XSD. The attribute's value can't be null.
 +
|-
 +
| xsd-policy || optional || Policies for the use of default XSD.
 +
: If 'force-default' is always used the XSD specified in parameter 'default-xsd'.
 +
: If 'null xsd' is used used the XSD specified in parameter 'default-xsd' only if the schema specified in the XML is invalid.
 +
: Default 'force-default'
 +
|-
 +
| return-dom || optional || Returns the parsed and validated org.w3c.dom.Document corresponding to the input object.
 +
The same object is returned if input already is a DOM Document. Default is 'false'.
 +
|}
 +
 
 +
Its sub-elements are:
 +
* [[Description]]
 +
* [[ServiceAlias]]
 +
 
 +
====ognl-script-service====
 +
 
 +
Internal service useful to execute OGNL scripts on GVBuffer instances. '''REMOVED in v3.5'''
 +
 
 +
The following table shows the ognl-script-service element's attributes:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value '''service'''.
 +
|-
 +
| internal || fixed || This attribute must assume the value '''yes'''.
 +
|-
 +
| critical || optional || Defines if the service is critical. A critical service failure mark the entire communication as failed.
 +
The attribute's default value is: yes.
 +
|}
 +
 
 +
Its sub-elements are:
 +
* [[Description]]
 +
* [[#ognl-script-call|ognl-script-call]]
 +
 
 +
=====ognl-script-call=====
 +
 
 +
VCL Operation useful to execute OGNL scripts on GVBuffer instances. '''REMOVED in v3.5'''
 +
 
 +
The following table shows the ognl-script-call element's attributes:
 +
{|class="gvtable"
 +
! 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.OGNLCallOperation'''.
 +
|-
 +
| name || required || Operation identifier. The attribute's value can't be null.
 +
|}
 +
 
 +
Its sub-elements are:
 +
* [[Description]]
 +
* [[OGNLScript]]
 +
 
 +
<div class="version_ge3.3">
 +
 
 +
====java-script-service====
 +
 
 +
Internal service useful to execute JavaScript scripts on GVBuffer instances. '''REMOVED in v3.5'''
 +
 
 +
The following table shows the java-script-service element's attributes:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value '''service'''.
 +
|-
 +
| internal || fixed || This attribute must assume the value '''yes'''.
 +
|-
 +
| critical || optional || Defines if the service is critical. A critical service failure mark the entire communication as failed.
 +
The attribute's default value is: yes.
 +
|}
 +
 
 +
Its sub-elements are:
 +
* [[Description]]
 +
* [[#java-script-call|java-script-call]]
 +
 
 +
=====java-script-call=====
 +
 
 +
VCL Operation useful to execute JavaScript scripts on GVBuffer instances. '''REMOVED in v3.5'''
 +
 
 +
The following table shows the java-script-call element's attributes:
 +
{|class="gvtable"
 +
! 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.JSCallOperation'''.
 +
|-
 +
| name || required || Operation identifier. The attribute's value can't be null.
 +
|}
 +
 
 +
Its sub-elements are:
 +
* [[Description]]
 +
* [[Script]]
 +
</div>
 +
 
 +
<div class="version_ge3.4">
 +
====dh-selector-service====
 +
 
 +
Internal service useful to set [[DBOBuilder]] name to call at [[dh-call]] operations.
 +
Useful only as '''InputService''' of '''GVOperationNode''' that references a [[dh-call]] operation.
 +
 
 +
The following table shows the dh-selector-service element's attributes:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value '''service'''.
 +
|-
 +
| internal || fixed || This attribute must assume the value '''yes'''.
 +
|-
 +
| critical || optional || Defines if the service is critical. A critical service failure mark the entire communication as failed.
 +
The attribute's default value is: yes.
 +
|}
 +
 
 +
Its sub-elements are:
 +
* [[Description]]
 +
* [[#dh-selector-call|dh-selector-call]]
 +
 
 +
=====dh-selector-call=====
 +
 
 +
VCL Operation useful to set [[DBOBuilder]] name to call contained in a [[dh-call]] operation.
 +
 
 +
The following table shows the dh-selector-call element's attributes:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value '''call'''.
 +
|-
 +
| class || fixed || This attribute must assume the value '''it.greenvulcano.gvesb.virtual.datahandler.DBOBuilderSelectorCallOperation'''.
 +
|-
 +
| name || fixed || Operation identifier. This attribute must assume the value '''setDBService'''.
 +
|-
 +
| DH_SERVICE_NAME || required || DBOBuilder name. The attribute's value can't be null.
 +
|}
 +
 
 +
Its sub-elements are:
 +
* [[Description]]
 +
 
 +
</div>
 +
 
 +
<div class="version_ge3.5">
 +
====script-service====
 +
 
 +
Internal service useful to execute scripts on GVBuffer instances.
 +
 
 +
The following table shows the script-service element's attributes:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value '''service'''.
 +
|-
 +
| internal || fixed || This attribute must assume the value '''yes'''.
 +
|-
 +
| critical || optional || Defines if the service is critical. A critical service failure mark the entire communication as failed.
 +
The attribute's default value is: yes.
 +
|}
 +
 
 +
Its sub-elements are:
 +
* [[Description]]
 +
* [[#script-call|script-call]]
 +
 
 +
=====script-call=====
 +
 
 +
VCL Operation useful to execute scripts on GVBuffer instances.
 +
 
 +
The following table shows the script-call element's attributes:
 +
{|class="gvtable"
 +
! 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.ScriptCallOperation'''.
 +
|-
 +
| name || required || Operation identifier. The attribute's value can't be null.
 +
|}
 +
 
 +
Its sub-elements are:
 +
* [[Description]]
 +
* [[Script]]
 +
 
 +
 
 +
====json-validation-service====
 +
 
 +
Its sub-elements are:
 +
* [[Description]]
 +
* [[#json-validation-call|json-validation-call]]
 +
 
 +
=====json-validation-call=====
 +
 
 +
Its sub-elements are:
 +
* [[Description]]
  
* Description;
+
</div>
* InputServices;
 
* OutputServices;
 
* DequeueFilter.
 

Latest revision as of 10:20, 2 January 2015

Description

A GVOperationNode is an operation node indicating that GreenVulcano® ESB must perform a communication with an external systems (invocation, sending messages, receiving messages). For example, if the node indicates a receive a message (see attribute op-type), you can also define a DequeueFilter that sets certain conditions that the received message must meet.

VulCon / GV Console Configuration

The GVOperationNode is a Flow element that extends FlowNode. It has the following attributes:

Attribute Type Description
class fixed This attributes must assume the value it.greenvulcano.gvesb.core.flow.GVOperationNode
op-type fixed This attributes must assume the value call,enqueue,dequeue
id-system required Identifies the system involved in communication. Can be selected from systems declared as Participant in the Operation section.
The attribute value can't be null.
operation-name required Identifies the communication operation selected by the channel of the system indicated by the id-system attribute.
Only the operations of the type declared in the 'op-type' attribute can be selected. Its value cannot be null.

and the subelements:

InputServices

Before doing any communication you can run an ordered list of input services.

This section allows the definition of input services for the current communication operation. The current version of GreenVulcano® ESB provides the following services:

  • Data Transformation
  • XML Validation
  • OGNL/Java Scripting

The InputServices Element is used by: GVIteratorOperationNode and GVOperationNode.

Might contain the following elements:

OutputServices

After doing any communication you can run an ordered list of output services.

This section allows the definition of output services for the current communication operation. The current version of GreenVulcano® ESB provides the following services:

  • Data Transformation
  • XML Validation
  • OGNL/Java Scripting

The OutputServices Element is used by ChangeGVBufferNode, GVIteratorOperationNode and GVOperationNode.

Might contain the following elements:


In/Out Services

gvdte-service

Invokes the Data Transformation Engine (GVDTE). Refer to the documentation GVDTE for information on features of GreenVulcano® ESB Data Transformation Engine.

The following table shows the gvdte-service element's attributes:

Attribute Type Description
type fixed This attribute must assume the value service.
internal fixed This attribute must assume the value yes.
critical optional Defines if the service is critical. A critical service failure mark the entire communication as failed.

The attribute's default value is: yes.

remove-fields optional Indicates whether or not to remove from the buffer the fields used for communication with GVDTE.

The attribute's default value is: yes.

Its sub-elements are:

map-name-param

Specifies the name of the transformation that should apply by GVDTE.

This name must indicate a transformation currently configured in GVDTE.

This parameter can be optional if the input GVBuffer has a property with the name map-name.

The following table shows the map-name-param element's attributes:

Attribute Type Description
type fixed This attribute must assume the value param.
name fixed This attribute must assume the value map-name.
value required Specifies the name of the transformation that should apply by GVDTE.

This name must indicate a transformation currently configured in GVDTE.

gvdte-context-call

Communication parameters to interact with GVDTE.

The following table shows the gvdte-context-call element's 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.DTEServiceContextCall.
name required ID used for diagnostics. Is printed on the log files.
gvdte-extra-param

Allows you to specify additional parameters for the transformation GVDTE must apply.

The following table shows the gvdte-extra-param element's attributes:

Attribute Type Description
type fixed This attribute must assume the value param.
name required Parameter name. The attribute's value can't be null.
value required Parameter value. The value of this attribute can be static or can be interpreted dynamically, as the value of a metadata expression that also employee the input GVBuffer.

xml-validation-service

Invokes the XML validation engine.

The following table shows the xml-validation-service element's attributes:

Attribute Type Description
type fixed This attribute must assume the value service.
internal fixed This attribute must assume the value yes.

Its sub-elements are:

xml-validation-call

Communication parameters to interact with XML validation engine.

The following table shows the xml-validation-call element's 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.xml.XMLValidationCallOperation.
name required ID used for diagnostics. Is printed on the log files.

The attribute's value can't be null.

default-xsd optional Default XSD. The attribute's value can't be null.
xsd-policy optional Policies for the use of default XSD.
If 'force-default' is always used the XSD specified in parameter 'default-xsd'.
If 'null xsd' is used used the XSD specified in parameter 'default-xsd' only if the schema specified in the XML is invalid.
Default 'force-default'
return-dom optional Returns the parsed and validated org.w3c.dom.Document corresponding to the input object.

The same object is returned if input already is a DOM Document. Default is 'false'.

Its sub-elements are:

ognl-script-service

Internal service useful to execute OGNL scripts on GVBuffer instances. REMOVED in v3.5

The following table shows the ognl-script-service element's attributes:

Attribute Type Description
type fixed This attribute must assume the value service.
internal fixed This attribute must assume the value yes.
critical optional Defines if the service is critical. A critical service failure mark the entire communication as failed.

The attribute's default value is: yes.

Its sub-elements are:

ognl-script-call

VCL Operation useful to execute OGNL scripts on GVBuffer instances. REMOVED in v3.5

The following table shows the ognl-script-call element's 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.OGNLCallOperation.
name required Operation identifier. The attribute's value can't be null.

Its sub-elements are:

java-script-service

Internal service useful to execute JavaScript scripts on GVBuffer instances. REMOVED in v3.5

The following table shows the java-script-service element's attributes:

Attribute Type Description
type fixed This attribute must assume the value service.
internal fixed This attribute must assume the value yes.
critical optional Defines if the service is critical. A critical service failure mark the entire communication as failed.

The attribute's default value is: yes.

Its sub-elements are:

java-script-call

VCL Operation useful to execute JavaScript scripts on GVBuffer instances. REMOVED in v3.5

The following table shows the java-script-call element's 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.JSCallOperation.
name required Operation identifier. The attribute's value can't be null.

Its sub-elements are:

dh-selector-service

Internal service useful to set DBOBuilder name to call at dh-call operations. Useful only as InputService of GVOperationNode that references a dh-call operation.

The following table shows the dh-selector-service element's attributes:

Attribute Type Description
type fixed This attribute must assume the value service.
internal fixed This attribute must assume the value yes.
critical optional Defines if the service is critical. A critical service failure mark the entire communication as failed.

The attribute's default value is: yes.

Its sub-elements are:

dh-selector-call

VCL Operation useful to set DBOBuilder name to call contained in a dh-call operation.

The following table shows the dh-selector-call element's 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.datahandler.DBOBuilderSelectorCallOperation.
name fixed Operation identifier. This attribute must assume the value setDBService.
DH_SERVICE_NAME required DBOBuilder name. The attribute's value can't be null.

Its sub-elements are:

script-service

Internal service useful to execute scripts on GVBuffer instances.

The following table shows the script-service element's attributes:

Attribute Type Description
type fixed This attribute must assume the value service.
internal fixed This attribute must assume the value yes.
critical optional Defines if the service is critical. A critical service failure mark the entire communication as failed.

The attribute's default value is: yes.

Its sub-elements are:

script-call

VCL Operation useful to execute scripts on GVBuffer instances.

The following table shows the script-call element's 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.ScriptCallOperation.
name required Operation identifier. The attribute's value can't be null.

Its sub-elements are:


json-validation-service

Its sub-elements are:

json-validation-call

Its sub-elements are: