com.flowable.action.api.bot

Interface BotService

All Known Implementing Classes:

BpmnCancelProcessBot, BpmnCompletedUserTaskBot, BpmnInjectDynamicSubProcessBot, BpmnStartProcessInstanceBot, BpmnTestActionBot, CmmnCancelCaseBot, CmmnCompletedHumanTaskBot, CmmnReactivateCaseInstanceBot, CmmnStartCaseInstanceBot, CmmnStartPlanItemInstanceBot, CmmnUserEventListenerBot, PlatformSignalProcessBot, UserManagementBot

public interface BotService

Implement this bot service interface to provide an execution for action definitions based on this bot. Use the ActionRepositoryService to deploy your action definitions based on this bot to make them available at runtime. Whenever such an action is executed, an ActionInstance is created ant this bot is invoked accordingly.

Author:

Juan Ramos, Tijs Rademakers, Micha Kiener

Method Summary

Modifier and Type	Method and 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(HistoricActionInstance actionInstance, ActionDefinition actionDefinition, Map<String,Object> payload) Whenever an action definition is triggered, an action instance is created and this method is invoked in order to execute the action.

Method Detail

getKey

String getKey()

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

String getName()

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

Returns:

the name of this bot

getDescription

String getDescription()

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

Returns:

the optional description of this bot

invokeBot

BotActionResult invokeBot(HistoricActionInstance actionInstance,
                          ActionDefinition actionDefinition,
                          Map<String,Object> payload)

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:

actionInstance - the action instance to run

actionDefinition - the action definition where the action instance is based on

payload - the optional payload containing the necessary information to run the action

Returns:

the result of invoking the action