Interface IFcForEachLoopDescriptors

All Superinterfaces:

IExecutionResultDescriptor, IRefinedExecutionResultDescriptor<FcForEachLoopProps>

All Known Implementing Classes:

FcForEachLoopHandler

public interface IFcForEachLoopDescriptors
extends IExecutionResultDescriptor, IRefinedExecutionResultDescriptor<FcForEachLoopProps>

The result descriptors for the data returned by the EWorkflowNodeType.FC_FOR_EACH_LOOP action.

Since:

8.2.0

Author:

XIMA MEDIA GmbH

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CURRENT_ATTR_INDEX	Name of the corresponding property of the getCurrentValueDescriptor(IValueDescriptorFactory).
static final String	CURRENT_ATTR_ITEM	Name of the corresponding property of the getCurrentValueDescriptor(IValueDescriptorFactory).
static final String	CURRENT_ATTR_KEY	Name of the corresponding property of the getCurrentValueDescriptor(IValueDescriptorFactory)
static final String	SUCCESS_ATTR_COUNT	Name of the corresponding property of the getSuccessValueDescriptor(IValueDescriptorFactory).

Method Summary

Modifier and Type	Method	Description
default IAttachmentValueDescriptor	getCurrentAttachmentValueDescriptor()	Creates the descriptor for the attachment or attachments that are created and made available to other actions while the node is being executed.
default IAttachmentValueDescriptor	getCurrentAttachmentValueDescriptor(IRefinedExecutionResultDescriptorParams<FcForEachLoopProps> params)	Same as getCurrentAttachmentValueDescriptor without data, but refined depending on the current node's configuration.
default IFileValueDescriptor	getCurrentFileValueDescriptor()	Creates the descriptor for the file or files that are created and made available to other actions while the node is being executed.
default IFileValueDescriptor	getCurrentFileValueDescriptor(IRefinedExecutionResultDescriptorParams<FcForEachLoopProps> params)	Same as getCurrentFileValueDescriptor without data, but refined depending on the current node's configuration.
default IValueDescriptor<?, ? extends IValueBuilder<?>>	getCurrentValueDescriptor(IValueDescriptorFactory f)	Creates the value descriptor for the data that is made available to the workflow while the node is being executed.
default IValueDescriptor<?, ? extends IValueBuilder<?>>	getCurrentValueDescriptor(IValueDescriptorFactory factory, IRefinedExecutionResultDescriptorParams<FcForEachLoopProps> params)	Same as getCurrentValueDescriptor without data, but refined depending on the current node's configuration.
default Map<String, IValueDescriptor<?,?>>	getErrorValueDescriptors(IValueDescriptorFactory f)	The descriptors for the different error types that may occur when the node is executed.
default Map<String, IValueDescriptor<?,?>>	getErrorValueDescriptors(IValueDescriptorFactory f, IRefinedExecutionResultDescriptorParams<FcForEachLoopProps> params)	Same as getErrorValueDescriptors without data, but refined depending on the current node's configuration.
default Map<String, IValueDescriptor<?,?>>	getSoftErrorValueDescriptors(IValueDescriptorFactory f)	The descriptors for the different soft error types that may occur when the node is executed.
default Map<String, IValueDescriptor<?,?>>	getSoftErrorValueDescriptors(IValueDescriptorFactory f, IRefinedExecutionResultDescriptorParams<FcForEachLoopProps> params)	Same as getSoftErrorValueDescriptors without data, but refined depending on the current node's configuration.
default IValueDescriptor<?, ? extends IValueBuilder<?>>	getSuccessValueDescriptor(IValueDescriptorFactory f)	Creates the value descriptor for the data that is made available to the workflow when the node was executed successfully.

Methods inherited from interface IExecutionResultDescriptor

getAlwaysValueDescriptor, getAttachmentValueDescriptor, getErrorValueDescriptor, getFileValueDescriptor, getSoftErrorValueDescriptor

Methods inherited from interface IRefinedExecutionResultDescriptor

getAlwaysValueDescriptor, getAlwaysValueDescriptor, getAttachmentValueDescriptor, getAttachmentValueDescriptor, getCurrentAttachmentValueDescriptor, getCurrentFileValueDescriptor, getCurrentValueDescriptor, getErrorValueDescriptor, getFileValueDescriptor, getFileValueDescriptor, getSoftErrorValueDescriptor, getSuccessValueDescriptor, getSuccessValueDescriptor

Field Details

CURRENT_ATTR_INDEX

static final String CURRENT_ATTR_INDEX

Name of the corresponding property of the getCurrentValueDescriptor(IValueDescriptorFactory). The index of the current iteration, 0-based (0, 1, 2, ...)

See Also:

• Constant Field Values

CURRENT_ATTR_ITEM

static final String CURRENT_ATTR_ITEM

Name of the corresponding property of the getCurrentValueDescriptor(IValueDescriptorFactory). The current item of the current iteration.

See Also:

• Constant Field Values

CURRENT_ATTR_KEY

static final String CURRENT_ATTR_KEY

Name of the corresponding property of the getCurrentValueDescriptor(IValueDescriptorFactory)

See Also:

• Constant Field Values

SUCCESS_ATTR_COUNT

static final String SUCCESS_ATTR_COUNT

Name of the corresponding property of the getSuccessValueDescriptor(IValueDescriptorFactory). The total number of items that were iterated.

See Also:

• Constant Field Values

Method Details

getCurrentAttachmentValueDescriptor

default IAttachmentValueDescriptor getCurrentAttachmentValueDescriptor()

Description copied from interface: IExecutionResultDescriptor

Creates the descriptor for the attachment or attachments that are created and made available to other actions while the node is being executed. Should return null when the node provides no attachments.

Specified by:

getCurrentAttachmentValueDescriptor in interface IExecutionResultDescriptor

Returns:

The descriptor for the attachment or attachment made available while the node is being executed.

getCurrentAttachmentValueDescriptor

default IAttachmentValueDescriptor getCurrentAttachmentValueDescriptor(IRefinedExecutionResultDescriptorParams<FcForEachLoopProps> params)

Description copied from interface: IRefinedExecutionResultDescriptor

Same as getCurrentAttachmentValueDescriptor without data, but refined depending on the current node's configuration.

Specified by:

getCurrentAttachmentValueDescriptor in interface IRefinedExecutionResultDescriptor<FcForEachLoopProps>

Parameters:

params - Parameters with the current properties model of the node.

Returns:

The descriptor for the attachment or attachments made available while the node is being executed. If null, the non-refined descriptor is used.

getCurrentFileValueDescriptor

default IFileValueDescriptor getCurrentFileValueDescriptor()

Description copied from interface: IExecutionResultDescriptor

Creates the descriptor for the file or files that are created and made available to other actions while the node is being executed. Should return null when the node provides no files.

Specified by:

getCurrentFileValueDescriptor in interface IExecutionResultDescriptor

Returns:

The descriptor for the file or files made available while the node is being executed.

getCurrentFileValueDescriptor

default IFileValueDescriptor getCurrentFileValueDescriptor(IRefinedExecutionResultDescriptorParams<FcForEachLoopProps> params)

Description copied from interface: IRefinedExecutionResultDescriptor

Same as getCurrentFileValueDescriptor without data, but refined depending on the current node's configuration.

Specified by:

getCurrentFileValueDescriptor in interface IRefinedExecutionResultDescriptor<FcForEachLoopProps>

Parameters:

params - Parameters with the current properties model of the node.

Returns:

The descriptor for the file or files made available while the node is being executed. If null , the non-refined descriptor is used.

getCurrentValueDescriptor

default IValueDescriptor<?, ? extends IValueBuilder<?>> getCurrentValueDescriptor(IValueDescriptorFactory f)

Description copied from interface: IExecutionResultDescriptor

Creates the value descriptor for the data that is made available to the workflow while the node is being executed.

Specified by:

getCurrentValueDescriptor in interface IExecutionResultDescriptor

Parameters:

f - Factory that may be used for creating the descriptor. Instead of the factory passed in to this method, you may also use ValueDescriptorFactory.getInstance() if you wish to cache the descriptor in a static or instance field.

Returns:

The descriptor for data published by the node while it is being executed.

getCurrentValueDescriptor

default IValueDescriptor<?, ? extends IValueBuilder<?>> getCurrentValueDescriptor(IValueDescriptorFactory factory,
 IRefinedExecutionResultDescriptorParams<FcForEachLoopProps> params)

Description copied from interface: IRefinedExecutionResultDescriptor

Same as getCurrentValueDescriptor without data, but refined depending on the current node's configuration.

Specified by:

getCurrentValueDescriptor in interface IRefinedExecutionResultDescriptor<FcForEachLoopProps>

Parameters:

factory - Factory that may be used for creating the descriptor. Instead of the factory passed in to this method, you may also use ValueDescriptorFactory.getInstance() if you wish to cache the descriptor in a static or instance field.

params - Parameters with the current properties model of the node.

Returns:

The descriptor for data published by the node while it is being executed. If null, the non-refined descriptor is used.

getErrorValueDescriptors

default Map<String, IValueDescriptor<?,?>> getErrorValueDescriptors(IValueDescriptorFactory f)

Description copied from interface: IExecutionResultDescriptor

The descriptors for the different error types that may occur when the node is executed. Each discriminator of the union represents an error or exception type.

var connectTimeoutError = factory.recordBuilder().requiredProperty("connectTimeoutMs", factory.integer());
var readTimeoutError = factory.recordBuilder().requiredProperty("readTimeoutMs", factory.integer());
return Map.of("CONNECT_TIMEOUT", connectTimeoutError, "READ_TIMEOUT", readTimeoutError);

The example above uses a different set of data each type of error.

Note that you do not have to include a general error code. When the execute method of a node handler throws an unhandled (runtime) exception, the error code CmnConst.Workflow.ERROR_CODE_GENERAL is set automatically.

Specified by:

getErrorValueDescriptors in interface IExecutionResultDescriptor

Parameters:

f - Factory that may be used for creating the descriptor. You may also use ValueDescriptorFactory.getInstance() if you wish to cache the descriptor in a static or instance field.

Returns:

The value descriptor for the data that is made available to the workflow when the execution of the node failed (such as by throwing an exception).

getErrorValueDescriptors

default Map<String, IValueDescriptor<?,?>> getErrorValueDescriptors(IValueDescriptorFactory f,
 IRefinedExecutionResultDescriptorParams<FcForEachLoopProps> params)

Description copied from interface: IRefinedExecutionResultDescriptor

Same as getErrorValueDescriptors without data, but refined depending on the current node's configuration.

Specified by:

getErrorValueDescriptors in interface IRefinedExecutionResultDescriptor<FcForEachLoopProps>

Parameters:

f - Factory that may be used for creating the descriptor. You may also use ValueDescriptorFactory.getInstance() if you wish to cache the descriptor in a static or instance field.

params - Parameters with the current properties model of the node.

Returns:

The value descriptor for the data that is made available to the workflow when the execution of the node failed (such as by throwing an exception). If null, the non-refined descriptor is used.

getSoftErrorValueDescriptors

default Map<String, IValueDescriptor<?,?>> getSoftErrorValueDescriptors(IValueDescriptorFactory f)

Description copied from interface: IExecutionResultDescriptor

The descriptors for the different soft error types that may occur when the node is executed. Each discriminator of the union represents an error or exception type.

var missingUploadError = factory.recordBuilder().requiredProperty("elementName", factory.string());
var clientError = factory.recordBuilder().requiredProperty("statusCode", factory.integer());
return Map.of("MISSING_UPLOAD", missingUploadError, "CLIENT_ERROR", clientError);

The example above uses a different data type for each type of error.

@implNote This interface provides a default implementation for backwards compatibility so as not to break existing implementations. However, all existing implementations are strongly advised to override and implement this method. The default implementation may be removed at some point.

Specified by:

getSoftErrorValueDescriptors in interface IExecutionResultDescriptor

Parameters:

f - Factory that may be used for creating the descriptor. You may also use ValueDescriptorFactory.getInstance() if you wish to cache the descriptor in a static or instance field.

Returns:

The value descriptor for the data that is made available to the workflow when the execution of the node was successful, but contains one or more soft errors.

getSoftErrorValueDescriptors

default Map<String, IValueDescriptor<?,?>> getSoftErrorValueDescriptors(IValueDescriptorFactory f,
 IRefinedExecutionResultDescriptorParams<FcForEachLoopProps> params)

Description copied from interface: IRefinedExecutionResultDescriptor

Same as getSoftErrorValueDescriptors without data, but refined depending on the current node's configuration.

Specified by:

getSoftErrorValueDescriptors in interface IRefinedExecutionResultDescriptor<FcForEachLoopProps>

Parameters:

f - Factory that may be used for creating the descriptor. You may also use ValueDescriptorFactory.getInstance() if you wish to cache the descriptor in a static or instance field.

params - Parameters with the current properties model of the node.

Returns:

The value descriptor for the data that is made available to the workflow when the execution of the node was successful, but contains one or more soft errors. If null, the non-refined descriptor is used.

getSuccessValueDescriptor

default IValueDescriptor<?, ? extends IValueBuilder<?>> getSuccessValueDescriptor(IValueDescriptorFactory f)

Description copied from interface: IExecutionResultDescriptor

Creates the value descriptor for the data that is made available to the workflow when the node was executed successfully.

Specified by:

getSuccessValueDescriptor in interface IExecutionResultDescriptor

Parameters:

f - Factory that may be used for creating the descriptor. Instead of the factory passed in to this method, you may also use ValueDescriptorFactory.getInstance() if you wish to cache the descriptor in a static or instance field.

Returns:

The data provided by the node after having been executed successfully.