Setting up a scenario for trigger by API

In order to let a scenario be triggered by webservice, it must be set up with that in mind during its creation.

Among the available 'Start events', you will need to choose a 'Start' block. It is the only start event which will allow to trigger the event by API. After activating it, a scenario cannot be modified anymore. It is therefore necessary to decide whether a scenario will be triggered by API as soon as you create it.

Obtaining information about existing scenarios for a profile table.

In order to trigger a scenario by API, using the technical name of the targeted scenario is necessary.

This technical name does not match the display name that you chose at the creation of the scenario. Moreover, it is not easily found within the ACTITO interface.

To retrieve the technical name of a scenario, you can use the operation GET/entity/{e}/table{t}/scenario

This method will allow you to obtain the list the list of every scenario linked to a specific database.

You will need to enter the following parameters:

• the entity to which the profile table belongs

• the name of the profile table targeted by the scenario

• a filter on the display name, in order to focus on a specific scenario. You can use asterisks before and after the search term to carry out a partial search

• a filter allowing you to only get scenarios triggered by webservices (isStartEventTriggered=true)

• a filter allowing you to only get active scenarios (isActive=true)

Example of a request and its response: (Download this example)

The response will give you the two IDs that can be used to trigger a scenario by webservice call:

• "name": this is the technical name of the scenario. It is based on the display name followed by a string of characters

• "id": this is the auto-generated technical id

Triggering a scenario by API

When a profile fits the scenario trigger condition that you defined in your internal system, you can program a webservice call which will trigger the ACTITO scenario for this profile.

To do so, you need to use the operation POST/entity/{e}/table/{t}/scenario/{s}/profile/{p}

The parameters needed are:

• the entity to which the profile table belongs

• the name of the profile table targeted by the scenario

• the id of the scenario: you can use either the technical name of the scenario or its auto-generated technical id. Both are obtained with the GET method described above

• the id of the profile: it can be its technical id ("profileId") or a "keyAttribute=value" pair

Example of a request and its response: (Download this example)

You will obtain the business key of the interaction as response.