Difference between revisions of "ServiceCallerTask"

From GreenVulcano Wiki
Jump to: navigation, search
(Created page with "==Description== Use this task for invoking {{GVESB}} services. =={{VULCON}} / {{GVCONSOLE}} Configuration== The following table show the element's attributes ServiceCallerTask...")
 
(→‎NextAction)
 
(7 intermediate revisions by 2 users not shown)
Line 5: Line 5:
 
=={{VULCON}} / {{GVCONSOLE}} Configuration==
 
=={{VULCON}} / {{GVCONSOLE}} Configuration==
  
−
The following table show the element's attributes ServiceCallerTask:
+
ServiceCallerTask is the Task for invoking {{GVESB}} services.
 +
 
 +
The ServiceCallerTask Element is used by: [[GVTaskConfiguration#TaskGroup||TaskGroup]].
 +
 
 +
The following table shows the ServiceCallerTask element's attributes:
 
{|class="gvtable"
 
{|class="gvtable"
 
! Attribute !! Type !! Description
 
! Attribute !! Type !! Description
Line 14: Line 18:
 
|-
 
|-
 
| name || required || Task name. The attribute's value can't be null.
 
| name || required || Task name. The attribute's value can't be null.
 +
|-
 +
| auto-start || optional || If 'true' Task is automatically registered on the timer.
 +
The attribute's admitted values are:
 +
* true
 +
* false
 +
|-
 +
| enabled || optional || Task activation status.
 +
The attribute's admitted values are:
 +
* true
 +
* false
 +
|-
 +
| id-service || required || ID_SERVICE be used for the invocation.
 +
The attribute's value cannot be null.
 +
|-
 +
| id-system || optional || ID_SYSTEM be used for the invocation.
 +
If specified, the attribute's value cannot be null.
 +
|-
 +
| operation || required || Operation name to be used for the invocation.
 +
The attribute's value cannot be null.
 +
|-
 +
| transacted || optional || Performs the invocation in transaction.
 +
The attribute's admitted values are:
 +
* false
 +
* true
 +
If specified, the attribute's value cannot be null.
 +
|-
 +
| timeout || optional || Timeout of the transaction.
 +
If specified, the attribute's value cannot be null.
 +
|-
 +
| max-calls-sequence || optional || Maximum number of calls in sequence. Default: 1
 +
If specified, the attribute's value cannot be null.
 
|}
 
|}
  
−
A ServiceCallerTask element might have the following subitems:
+
A ServiceCallerTask element might have the following sub-elements:
−
* Description
+
* [[Description]]
 
* [[Triggers]]
 
* [[Triggers]]
 
* [[JbProperties]]
 
* [[JbProperties]]
 
* [[JNDIHelper]]
 
* [[JNDIHelper]]
 
* [[ChangeGVBuffer]]
 
* [[ChangeGVBuffer]]
−
* [[OutputData]]
+
* [[ServiceCallerTask#OutputData|OutputData]]
−
* [[NextAction]]
+
* [[ServiceCallerTask#NextAction|NextAction]]
 +
 
 +
===OutputData===
 +
 
 +
This element allows to define options for saving the output data on file.
 +
 
 +
The following table shows the OutputData element's attributes:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| output-directory || required || The path of the directory containing the file(s) that will save the GVBuffer output body of the service performed.
 +
|-
 +
| output-policy || required || This attribute defines the way in which you saved the output of the service.
 +
If ''create'' the output of the service will be stored on a single file whose name is that of the task.
 +
The file will be overwritten each time the service is invoked. Es: ''Taskname.xxx''
 +
If ''append'' the output of the service will be stored on a single file whose name is that of the task: each invocation of the
 +
service, the data will be appended to the file.
 +
If ''create-new'' the  service saved output separates the files whose name is given by the task name followed by the date/time in format dd-MM-yyyy-hh-mm-ss-SSS. Es: 'Taskname'-01-01-2010-10-45-05-234.xxxx
 +
|-
 +
| output-type || required || This attribute defines the data type of output that will be saved.
 +
If ''body''  the [[GVBuffer]] body contents will be saved, as defined in the parameter ''output-policy'': the file extension is ''.dat''.
 +
If ''dump'' will be made a dump of all [[GVBuffer]], including property, as defined in the parameter ''output-policy'': the file extension is ''.dump''.
 +
If ''both'' will save the body and the [[GVBuffer]] dump.
 +
|}
 +
 
 +
===NextAction===
 +
 
 +
Action to be executed after the invocation of {{GVESB}}.
 +
 
 +
If any condition is checked does the following Action:
 +
* if output is an Exception -> ''rollback-exit''
 +
* if output is a [[GVBuffer]]  -> ''commit-continue''
 +
 
 +
The following table shows the NextAction element's attribute :
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| action || required || The action to execute if the condition is verified. The attribute's admitted values are:
 +
* commit-continue
 +
* rollback-exit
 +
* commit-exit
 +
* rollback-continue
 +
|}
 +
 
 +
Might contain the following sub-elements:
 +
* [[Description]]
 +
* A [[Conditions|Condition]] definition

Latest revision as of 10:37, 2 January 2015

Description

Use this task for invoking GreenVulcano® ESB services.

VulCon / GV Console Configuration

ServiceCallerTask is the Task for invoking GreenVulcano® ESB services.

The ServiceCallerTask Element is used by: |TaskGroup.

The following table shows the ServiceCallerTask element's attributes:

Attribute Type Description
type fixed This attribute must assume the value task.
class fixed This attribute must assume the value it.greenvulcano.gvesb.core.task.GVServiceCallerTask.
name required Task name. The attribute's value can't be null.
auto-start optional If 'true' Task is automatically registered on the timer.

The attribute's admitted values are:

  • true
  • false
enabled optional Task activation status.

The attribute's admitted values are:

  • true
  • false
id-service required ID_SERVICE be used for the invocation.

The attribute's value cannot be null.

id-system optional ID_SYSTEM be used for the invocation.

If specified, the attribute's value cannot be null.

operation required Operation name to be used for the invocation.

The attribute's value cannot be null.

transacted optional Performs the invocation in transaction.

The attribute's admitted values are:

  • false
  • true

If specified, the attribute's value cannot be null.

timeout optional Timeout of the transaction.

If specified, the attribute's value cannot be null.

max-calls-sequence optional Maximum number of calls in sequence. Default: 1

If specified, the attribute's value cannot be null.

A ServiceCallerTask element might have the following sub-elements:

OutputData

This element allows to define options for saving the output data on file.

The following table shows the OutputData element's attributes:

Attribute Type Description
output-directory required The path of the directory containing the file(s) that will save the GVBuffer output body of the service performed.
output-policy required This attribute defines the way in which you saved the output of the service.

If create the output of the service will be stored on a single file whose name is that of the task. The file will be overwritten each time the service is invoked. Es: Taskname.xxx If append the output of the service will be stored on a single file whose name is that of the task: each invocation of the service, the data will be appended to the file. If create-new the service saved output separates the files whose name is given by the task name followed by the date/time in format dd-MM-yyyy-hh-mm-ss-SSS. Es: 'Taskname'-01-01-2010-10-45-05-234.xxxx

output-type required This attribute defines the data type of output that will be saved.

If body the GVBuffer body contents will be saved, as defined in the parameter output-policy: the file extension is .dat. If dump will be made a dump of all GVBuffer, including property, as defined in the parameter output-policy: the file extension is .dump. If both will save the body and the GVBuffer dump.

NextAction

Action to be executed after the invocation of GreenVulcano® ESB.

If any condition is checked does the following Action:

  • if output is an Exception -> rollback-exit
  • if output is a GVBuffer -> commit-continue

The following table shows the NextAction element's attribute :

Attribute Type Description
action required The action to execute if the condition is verified. The attribute's admitted values are:
  • commit-continue
  • rollback-exit
  • commit-exit
  • rollback-continue

Might contain the following sub-elements:

Retrieved from "https://gvwiki.greenvulcano.com/gvwiki/index.php?title=ServiceCallerTask&oldid=4323"