Package com.flowable.platform.service.bot

Class BpmnStartProcessInstanceBot

java.lang.Object

com.flowable.platform.service.bot.AbstractStartWorkInstanceBot

com.flowable.platform.service.bot.BpmnStartProcessInstanceBot

All Implemented Interfaces:

BotService, ContextAwareBotService

public class BpmnStartProcessInstanceBot
extends AbstractStartWorkInstanceBot

An action bot starting a new process instance and passing in the provided payload. The model key is taken from the signal name of the action definition. The action instance and action definition is set as a transient variable on the process instance as well, if the process needs information like the scope of the action or anything from the action definition.

Author:

Filip Hrisafov, Micha Kiener

Field Summary

Fields

Modifier and Type	Field	Description
protected RuntimeService	runtimeService

Fields inherited from class com.flowable.platform.service.bot.AbstractStartWorkInstanceBot

ACTION_CONFIG_MODEL_CONFIG_INCLUDE_VARIABLES_IN_RESPONSE, ACTION_DEFINITION_ID_VAR_NAME, ACTION_INSTANCE_ID_VAR_NAME, ACTION_SCOPE_ID_VAR_NAME, ACTION_SCOPE_TYPE_VAR_NAME, contentItemService, contentService, objectMapper, variableTransformer

Constructor Summary

Constructors

Constructor	Description
BpmnStartProcessInstanceBot(RuntimeService runtimeService, com.fasterxml.jackson.databind.ObjectMapper objectMapper, ObjectProvider<PlatformContentItemService> contentItemServiceProvider, PlatformRestVariableTransformer variableTransformer, ObjectProvider<CoreContentService> coreContentServiceProvider)

Method Summary

Modifier and Type	Method	Description
String	getDescription()	Returns the optional description of this bot, describing its capabilities or prerequisites.
String	getKey()	Returns the key of this bot which is used to link ActionDefinitions to this bot.
String	getName()	Returns the name of this bot, typically used as the label for it.
BotActionResult	invokeBot(BotInvocationContext context)	Whenever an action definition is triggered, an action instance is created and this method is invoked in order to execute the action.

Methods inherited from class com.flowable.platform.service.bot.AbstractStartWorkInstanceBot

createActionResult, createActionResult, createTransientVariables, getAndRemoveOutcomeFromPayload, getWorkDefinitionKey, transformVariables

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.flowable.action.api.bot.ContextAwareBotService

invokeBot

Field Details

runtimeService

protected RuntimeService runtimeService

Constructor Details

BpmnStartProcessInstanceBot

public BpmnStartProcessInstanceBot(RuntimeService runtimeService,
 com.fasterxml.jackson.databind.ObjectMapper objectMapper,
 ObjectProvider<PlatformContentItemService> contentItemServiceProvider,
 PlatformRestVariableTransformer variableTransformer,
 ObjectProvider<CoreContentService> coreContentServiceProvider)

Method Details

getKey

public String getKey()

Description copied from interface: BotService

Returns the key of this bot which is used to link ActionDefinitions to this bot.

Returns:

the key of this bot, which needs to be unique amongst other bots

getName

public String getName()

Description copied from interface: BotService

Returns the name of this bot, typically used as the label for it.

Returns:

the name of this bot

getDescription

public String getDescription()

Description copied from interface: BotService

Returns the optional description of this bot, describing its capabilities or prerequisites.

Returns:

the optional description of this bot

invokeBot

public BotActionResult invokeBot(BotInvocationContext context)

Description copied from interface: BotService

Whenever an action definition is triggered, an action instance is created and this method is invoked in order to execute the action. You need to provide an action result according the execution and follow up needed.

Parameters:

context - context objects related to the invocation

Returns:

the result of invoking the action