com.smartgwt.client.util.workflow
Class ServiceTask

java.lang.Object
  com.smartgwt.client.core.BaseClass
      com.smartgwt.client.util.workflow.ProcessElement
          com.smartgwt.client.util.workflow.Task
              com.smartgwt.client.util.workflow.ServiceTask

public class ServiceTask
extends Task

A ServiceTask is an element of a Process which calls a DataSource operation, optionally using part of the process state as inputs or storing outputs in the process state.

By default a ServiceTask takes the data indicated by inputField and uses it as data. This means the input data becomes Critera for a "fetch" operation, new record values for an "add" operation, etc.

Alternatively, you can set criteria for a "fetch" operation, or values for other operationTypes. In both cases, you have the ability to use simple expressions like $input.fieldName to take portions of the input data and use it as part of the criteria or values.

As a special case, if the inputField is an atomic value (just a String or Number rather than a Record) and operationType is "fetch", it will be assumed to be value for the primary key field of the target DataSource if criteria is not explicitly specified

Field Summary

Fields inherited from class com.smartgwt.client.core.BaseClass

config, id, scClassName

Constructor Summary

ServiceTask()

ServiceTask(JavaScriptObject jsObj)

ServiceTask(String ID)

Method Summary

JavaScriptObject	create()
Criteria	getCriteria() Criteria (including AdvancedCriteria) to use for a "fetch" operation.
DataSource	getDataSource() DataSource ID or DataSource instance to be used.
Criteria	getFixedCriteria() Criteria to be submitted as part of the DSRequest, regardless of inputs to the task.
Record	getFixedValues() Values to be submitted as part of the DSRequest, regardless of inputs to the task.
DSOperationType	getOperationType() Type of operation to invoke
static ServiceTask	getOrCreateRef(JavaScriptObject jsObj)
Record	getValues() Values to be submitted for "update", "add" and "remove" operations.
void	setCriteria(Criteria criteria) Criteria (including AdvancedCriteria) to use for a "fetch" operation.
void	setDataSource(DataSource dataSource) DataSource ID or DataSource instance to be used.
void	setDataSource(String dataSource) DataSource ID or DataSource instance to be used.
void	setFixedCriteria(Criteria fixedCriteria) Criteria to be submitted as part of the DSRequest, regardless of inputs to the task.
void	setFixedValues(Record fixedValues) Values to be submitted as part of the DSRequest, regardless of inputs to the task.
void	setOperationType(DSOperationType operationType) Type of operation to invoke
void	setValues(Record values) Values to be submitted for "update", "add" and "remove" operations.

Methods inherited from class com.smartgwt.client.util.workflow.Task

getInputField, getInputFields, getOutputField, getOutputFields, setInputField, setInputFields, setOutputField, setOutputFields

Methods inherited from class com.smartgwt.client.util.workflow.ProcessElement

convertToJavaScriptArray, getID, getJsObj, getNextElement, getOrCreateJsObj, getProcessElements, isCreated, setAttribute, setID, setNextElement

Methods inherited from class com.smartgwt.client.core.BaseClass

destroy, doAddHandler, error, error, errorIfNotCreated, fireEvent, getAttribute, getAttributeAsBoolean, getAttributeAsDate, getAttributeAsDouble, getAttributeAsElement, getAttributeAsFloat, getAttributeAsInt, getAttributeAsJavaScriptObject, getAttributeAsMap, getAttributeAsString, getConfig, getHandlerCount, getRef, getScClassName, onInit, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setProperty, setProperty, setProperty, setProperty, setScClassName

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServiceTask

public ServiceTask()

ServiceTask

public ServiceTask(JavaScriptObject jsObj)

ServiceTask

public ServiceTask(String ID)

Method Detail

getOrCreateRef

public static ServiceTask getOrCreateRef(JavaScriptObject jsObj)

create

public JavaScriptObject create()

Overrides:

create in class Task

setCriteria

public void setCriteria(Criteria criteria)
                 throws IllegalStateException

Criteria (including AdvancedCriteria) to use for a "fetch" operation.

Data values in this criteria prefixed with "$" will be treated as dynamic expressions which can access the inputs to this task as $input - see com.smartgwt.client.docs.TaskInputExpression. Specifically, this means that for simple criteria, any property value that is a String and is prefixed with "$" will be assumed to be an expression, and for AdvancedCriteria, the same treatment will be applied to value.

If any data value should not be treated as dynamic (for example, a "$" should be taken as literal), you can place it in fixedCriteria instead.

Ignored for any operationType other than "fetch". Update or delete operations should place the primary key to update in values.

Parameters:

criteria - criteria Default value is null

Throws:

IllegalStateException - this property cannot be changed after the underlying component has been created

See Also:

TaskIO overview and related methods

getCriteria

public Criteria getCriteria()

Criteria (including AdvancedCriteria) to use for a "fetch" operation.

Data values in this criteria prefixed with "$" will be treated as dynamic expressions which can access the inputs to this task as $input - see com.smartgwt.client.docs.TaskInputExpression. Specifically, this means that for simple criteria, any property value that is a String and is prefixed with "$" will be assumed to be an expression, and for AdvancedCriteria, the same treatment will be applied to value.

If any data value should not be treated as dynamic (for example, a "$" should be taken as literal), you can place it in fixedCriteria instead.

Ignored for any operationType other than "fetch". Update or delete operations should place the primary key to update in values.

Returns:

Criteria

See Also:

TaskIO overview and related methods

setFixedCriteria

public void setFixedCriteria(Criteria fixedCriteria)
                      throws IllegalStateException

Criteria to be submitted as part of the DSRequest, regardless of inputs to the task. Will be combined with the data from the inputField or with criteria if specified, via DataSource.combineCriteria.

Parameters:

fixedCriteria - fixedCriteria Default value is null

Throws:

IllegalStateException - this property cannot be changed after the underlying component has been created

getFixedCriteria

public Criteria getFixedCriteria()

Criteria to be submitted as part of the DSRequest, regardless of inputs to the task. Will be combined with the data from the inputField or with criteria if specified, via DataSource.combineCriteria.

Returns:

Criteria

setFixedValues

public void setFixedValues(Record fixedValues)
                    throws IllegalStateException

Values to be submitted as part of the DSRequest, regardless of inputs to the task. Will be combined with the data from the inputField or with values if specified, via simple copying of fields, with fixedValues overwriting values provided by the inputField, but explicitly specified values overriding fixedValues.

Parameters:

fixedValues - fixedValues Default value is null

Throws:

IllegalStateException - this property cannot be changed after the underlying component has been created

getFixedValues

public Record getFixedValues()

Values to be submitted as part of the DSRequest, regardless of inputs to the task. Will be combined with the data from the inputField or with values if specified, via simple copying of fields, with fixedValues overwriting values provided by the inputField, but explicitly specified values overriding fixedValues.

Returns:

Record

setOperationType

public void setOperationType(DSOperationType operationType)
                      throws IllegalStateException

Type of operation to invoke

Parameters:

operationType - operationType Default value is "fetch"

Throws:

IllegalStateException - this property cannot be changed after the underlying component has been created

getOperationType

public DSOperationType getOperationType()

Type of operation to invoke

Returns:

DSOperationType

setValues

public void setValues(Record values)
               throws IllegalStateException

Values to be submitted for "update", "add" and "remove" operations.

Similar to Criteria, data values prefixed with "$" will be treated as a com.smartgwt.client.docs.TaskInputExpression. Use fixedValues for any values that start with "$" but should be treated as a literal.

Parameters:

values - values Default value is null

Throws:

IllegalStateException - this property cannot be changed after the underlying component has been created

getValues

public Record getValues()

Values to be submitted for "update", "add" and "remove" operations.

Similar to Criteria, data values prefixed with "$" will be treated as a com.smartgwt.client.docs.TaskInputExpression. Use fixedValues for any values that start with "$" but should be treated as a literal.

Returns:

Record

getDataSource

public DataSource getDataSource()

DataSource ID or DataSource instance to be used.

Returns:

DataSource

setDataSource

public void setDataSource(String dataSource)

DataSource ID or DataSource instance to be used.

Parameters:

dataSource - dataSource Default value is null

setDataSource

public void setDataSource(DataSource dataSource)

DataSource ID or DataSource instance to be used.

Parameters:

dataSource - dataSource Default value is null