A service task represents a work item in the process with a specific type.
When a service task is entered, a corresponding job is created. The process instance stops here and waits until the job is complete.
A job worker can subscribe to the job type, process the jobs, and complete them using one of the Zeebe clients. When the job is complete, the service task is completed and the process instance continues.
A service task must have a
taskDefinition is used to specify which job workers handle the service task work.
taskDefinition specifies the following properties:
type(required): Used as reference to specify which job workers request the respective service task job. For example,
retries(optional): Specifies the number of times the job is retried when a worker signals failure. The default is three.
The expressions are evaluated on activating the service task and must result in a
string for the job type and a
number for the retries.
Refer to an example in the form of the XML representation below.
A service task can define an arbitrary number of
taskHeaders; they are static metadata handed to workers along with the job. The headers can be used as configuration parameters for the worker.
By default, all job variables merge into the process instance. This behavior can be customized by defining an output mapping at the service task.
Input mappings can be used to transform the variables into a format accepted by the job worker.
For more information about this topic visit the documentation about Input/output variable mappings.
A service task with a custom header:
<bpmn:serviceTask id="collect-money" name="Collect Money">
<zeebe:taskDefinition type="payment-service" retries="5" />
<zeebe:header key="method" value="VISA" />
Learn more about the concept of job types and how to set up a job worker via our manual on job workers.