Type Parameters:

TData - Type of the node's properties model.

All Known Subinterfaces:

IBaseActionClientHandlerNode<TData>, IBaseActionNode<TData>, IBaseConditionClientHandlerNode<TData>, IBaseDoUntilLoopClientHandlerNode<TData>, IBaseWhileLoopClientHandlerNode<TData>, IBeanValidatingNode<TData>, IBuiltinNodeType<TData>, IDefaultClientHandlerNode<TData>, IExecutingLikeActionNode<TData>, IExecutingLikeBinarySelectionNode<TData>, IExecutingLikeControlTransferNode<TData>, IExecutingLikeExceptionHandlerNode<TData>, IExecutingLikeMultiSwitchNode<TData>, IExecutingLikePostTestLoopNode<TData>, IExecutingLikePreTestLoopNode<TData>, IExecutingLikeReturningActionNode<TData>, IExecutingLikeReturnNode<TData>, IExecutingLikeSequenceNode<TData>, IExecutingLikeThrowNode<TData>, IFileProviding<TData>, IHierarchyValidatingNode<TData>, ILoopStatementMustLoopValidating<TData>, IMultipleCheckPropertiesNode<TData>, INodeHandler<TData>, IOfficialHelpPageNode<TData>, IPluginActionNodeHandler<TData>, IPluginConditionNodeHandler<TData>, IPluginDoUntilLoopNodeHandler<TData,TState>, IPluginWhileLoopNodeHandler<TData,TState>, IResultlessNode<TData>, ISemverUpdatingNode<TData>, ISingleBaseActionBuiltinNodePrototype<TData>, ISingleBaseActionNodePrototype<TData>, ISingleBaseConditionNodePrototype<TData>, ISingleBaseDoUntilLoopNodePrototype<TData>, ISingleBaseWhileLoopNodePrototype<TData>, ISingleBuiltinNodePrototype<TData>, ISingleNodePrototype<TData>

All Known Implementing Classes:

APluginActionNodeHandler, APluginConditionNodeHandler, APluginDoUntilLoopNodeHandler, APluginWhileLoopNodeHandler, FallbackExecutionAnalyzer, FcBreakHandler, FcChangeFormAvailabilityHandler, FcChangeFormValueHandler, FcChangeStateHandler, FcCompressAsZipHandler, FcContinueHandler, FcCopyFormRecordHandler, FcCounterHandler, FcCreateTextFileHandler, FcDecodeBase64Handler, FcDeleteAttachmentHandler, FcDeleteFormRecordHandler, FcDoiInitHandler, FcDoUntilLoopHandler, FcEmailHandler, FcEmptyHandler, FcEncodeBase64Handler, FcExperimentHandler, FcExportToPersistenceHandler, FcExportToXmlHandler, FcFillPdfHandler, FcFillWordHandler, FcForEachLoopHandler, FcHttpRequestHandler, FcImportFormValueFromXmlHandler, FcLdapQueryHandler, FcLogEntryHandler, FcMoveFormRecordToInboxHandler, FcMultipleConditionHandler, FcProcessHistoryPdfHandler, FcProcessLogPdfHandler, FcProvideResourceHandler, FcQueueTaskHandler, FcRedirectHandler, FcRenewProcessIdHandler, FcReturnFileHandler, FcReturnHandler, FcSaveToFileSystemHandler, FcSaveToWebDavHandler, FcSendFormRecordMessageHandler, FcSequenceHandler, FcSetSavedFlagHandler, FcShowTemplateHandler, FcSqlStatementHandler, FcSwitchCaseHandler, FcSwitchDefaultHandler, FcSwitchHandler, FcThrowExceptionHandler, FcWhileLoopHandler, FcWriteFormRecordAttrHandler
```
public interface IWorkflowNodeFlowAnalyzer<TData>
```
Analyzes how a workflow node can be executed, in a manner similar to solving data flow equations. Used to construct a flow graph for a workflow task, in order to derive statements about the runtime behavior of the program represented by the workflow task. See createFlowGraph for more details on how to construct a flow graph starting at a given root node.

Since:

7.0.0

Author:

XIMA MEDIA GmbH

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`<TElement extends IWorkflowNodeTypeProviding & IActiveFlagProviding> IFlowGraphEndPoints`	`createFlowGraph(ICreateFlowGraphParams<TData,TElement> params)`	This method is used to create the flow graph that represents the control flow of a workflow task, and to determine the end points of the node when executed.

- Method Detail
  - createFlowGraph
```
<TElement extends IWorkflowNodeTypeProviding & IActiveFlagProviding> IFlowGraphEndPoints createFlowGraph(ICreateFlowGraphParams<TData,TElement> params)
                                                                                                  throws WorkflowAnalysisException
```
    This method is used to create the flow graph that represents the control flow of a workflow task, and to determine the end points of the node when executed. A flow graph constructed by the workflow engine and used for the purpose of deriving statements about the runtime behavior of the program represented by a workflow task with a root node.
    See below for details on how to construct a flow graph. However, note that unless you are creating a new custom flow control node, you should use on of the existing mixins that matches the type of node you are creating:
    
    IExecutingLikeActionNode for normal business actions that execute some logic and have no children.
    IExecutingLikeBinarySelectionNode for custom conditions that behave like an if-else statement.
    IExecutingLikeControlTransferNode for custom control transfer actions such as break or continue statements (you will rarely need this).
    IExecutingLikeExceptionHandlerNode for custom error handlers that behave like a try-catch-finally statement.
    IExecutingLikeMultiSwitchNode for custom conditions that behave like switch-case-default statement.
    IExecutingLikePostTestLoopNode for custom loops that behave like a do-while-loop.
    IExecutingLikePreTestLoopNode for custom loops that behave like a while-loop.
    IExecutingLikeReturningActionNode for custom end points that can both throw an exception and end a processing chain by returning.
    IExecutingLikeReturnNode for custom end points that always return and never throw an exception.
    IExecutingLikeSequenceNode for custom block statements that never throw and execute their children in order (you will rarely need this).
    IExecutingLikeThrowNode for custom throw statements that can never complete normally and always throw an error.
    
    The flow graph is a directed graph. Each node in the control flow graph is either
    
    a real node that corresponds to a WorkflowNode; or
    a virtual node owned and created by a real node
    The graph has an edge from node1 to node2 if it is possible that node1 transfers control directly to node2; i.e any code path exists where node2 is executed directly after node1. Each edge also has a type, see FlowGraphConnectionType. Virtual nodes are often used to model complex control transfers involving conversion between completion types, such as try-finally blocks.
    Regarding end points, see the documentation of Normal, Throwing, and ControlTransfer for more details.
    This method is not pure and must have side-effects. It is responsible for
    
    calling createFlowGraph (or one of its variants) on all of its children (if applicable);
    calling connect (or one of its variants); and
    returning the set of normal and throwing end points of the node.
    
    This method must return the set of all nodes (including the children, grand-children etc. of this node) that represent the normal and throwing end points when the node is executed. These throwing end points are used for connecting this node to other siblings and parents. See the documentation of the sub classes of FlowGraphEndPoint for more details.
    Type Parameters:
    
    TElement - The type of the node elements on which the analysis is performed. This type may be different depending on whether the analysis is performed on the backend data model WorkflowNode or the frontend view model.
    
    Parameters:
    
    params - The node to analyze and the current analysis context.
    
    Returns:
    
    The set of all end points of the given node. Use ICreateFlowGraphContext#endPoints and its variants to create this return value. See the documentation of getNormalEndPoints and getThrowingEndPoints for more details.
    
    Throws:
    
    WorkflowAnalysisException - May be thrown when an unhandled exception occurred during the analysis. If this exception is thrown, the entire analysis is cancelled and the exception is propagated up. You should only throw this exception yourself if encountering an illegal state that would render the analysis invalid.

Interface IWorkflowNodeFlowAnalyzer<TData>

Method Summary

Method Detail

createFlowGraph