To trigger a start event in a process app, please do the following:
- Change the type of the start event to a message start event and open the Configure message dialog.
You can change the message name to something that suits your need and also use multiple start events.
NOTE: It is only possible to use the symbols a-z, 0-9, _ and - to name the message.
- Invoke the start event via the API by:
POST https://live.barium.se/api/v1.0/apps/{process application id}?message={Message name} Where the message name is the one set in the previous step.
Content-Type: application/x-www-form-urlencoded
template={TEMPLATE}&message={START EVENT MESSAGE REF NAME}&field1=201-1101&field2=Barium+AB
Note: If form data is sent when starting an instance the parameter "template" (the template associated to the start event in the process model) cannot be empty, it can be set as anything. Most commonly, the data form object ID is used.
Send parameters
You can also send parameters together with the POST that will be passed into the process instance.
- Create a form in the process app that should contain your data and connect it to your message start event.
- Add fields to the form. To make it easier for you to control the parameter post make sure that you set your own names on each form field that should receive data.
- Now you need to connect the form fields to the configured message. Open up the message configuration panel and specify wish names the message parameters have and connect them to the form field names.
- Start a new instance by doing the same call as above, but set the content-type of the HTTP call to application/x-www-form-urlencoded and add all parameters to the request body on the following format (URL-encoded): parameter1=value1, parameter2=value2 etc...
- All parameters will be accessible in the process instance, both via the API and via the user interface.