ServiceCallerTask

From GreenVulcano Wiki
Jump to: navigation, search

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: