Skip to content

Commit c88c318

Browse files
Revert "fix: temporary configuration changes for 8.9-alpha1 release"
This reverts commit f1e1c5a.
1 parent f1e1c5a commit c88c318

File tree

1 file changed

+34
-36
lines changed

1 file changed

+34
-36
lines changed

docs/components/concepts/global-user-task-listeners.md

Lines changed: 34 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -35,16 +35,16 @@ Global listeners:
3535

3636
You configure global user task listeners at the cluster level in the [Unified Configuration](/self-managed/components/orchestration-cluster/core-settings/configuration/properties.md#camunda_cluster_global_listeners).
3737

38-
Configuration path: `zeebe.broker.experimental.listeners.task`
38+
Configuration path: `camunda.cluster.global-listeners.user-task`
3939

4040
Each listener entry supports the following properties:
4141

42-
| Property | Description |
43-
| :------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
44-
| `event-types` | (Required) List of user task event types that trigger the listener. Supported values: `creating`, `assigning`, `updating`, `completing`, `canceling`. The shorthand `all` value is also available if the listener should react to all lifecycle events. |
45-
| `type` | (Required) The name of the job type. Used as a reference to specify which job workers request the respective task listener job. For example, `order-items`. |
46-
| `retries` | (Optional) Number of retries for the user task listener job (defaults to 3 if omitted). |
47-
| `after-local` | (Optional) Boolean indicating whether the listener should run after model-level listeners. Defaults to `false` (runs before model-level listeners). |
42+
| Property | Description |
43+
| :----------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
44+
| `event-types` | (Required) List of user task event types that trigger the listener. Supported values: `creating`, `assigning`, `updating`, `completing`, `canceling`. The shorthand `all` value is also available if the listener should react to all lifecycle events. |
45+
| `type` | (Required) The name of the job type. Used as a reference to specify which job workers request the respective task listener job. For example, `order-items`. |
46+
| `retries` | (Optional) Number of retries for the user task listener job (defaults to 3 if omitted). |
47+
| `after-non-global` | (Optional) Boolean indicating whether the listener should run after model-level listeners. Defaults to `false` (runs before model-level listeners). |
4848

4949
### Validation behavior
5050

@@ -61,39 +61,37 @@ In all the above cases, a suitable warning is reported in the orchestration clus
6161
### Example configuration (YAML)
6262

6363
```yaml
64-
zeebe:
65-
broker:
66-
experimental:
67-
engine:
68-
listeners:
69-
task:
70-
- type: "validate-task"
71-
event-types:
72-
- creating
73-
- type: "audit-generic"
74-
event-types: all
75-
retries: 5
76-
- type: "notify-assignee"
77-
event-types:
78-
- assigning
79-
- updating
80-
- canceling
81-
after-local: true
64+
camunda:
65+
cluster:
66+
global-listeners:
67+
user-task:
68+
- type: "validate-task"
69+
event-types:
70+
- creating
71+
- type: "audit-generic"
72+
event-types: all
73+
retries: 5
74+
- type: "notify-assignee"
75+
event-types:
76+
- assigning
77+
- updating
78+
- canceling
79+
after-non-global: true
8280
```
8381
8482
### Example configuration (environment variables)
8583
8684
```
87-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_0_TYPE=validate-task
88-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_0_EVENT_TYPES_0=creating
89-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_1_TYPE=audit-generic
90-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_1_EVENT_TYPES_0=all
91-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_1_RETRIES=5
92-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_2_TYPE=notify-assignee
93-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_2_EVENT_TYPES_0=assigning
94-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_2_EVENT_TYPES_1=updating
95-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_2_EVENT_TYPES_2=canceling
96-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_2_AFTER_LOCAL=true
85+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_0_TYPE=validate-task
86+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_0_EVENT_TYPES_0=creating
87+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_1_TYPE=audit-generic
88+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_1_EVENT_TYPES_0=all
89+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_1_RETRIES=5
90+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_TYPE=notify-assignee
91+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_EVENT_TYPES_0=assigning
92+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_EVENT_TYPES_1=updating
93+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_EVENT_TYPES_2=canceling
94+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_AFTER_NON_GLOBAL=true
9795
```
9896

9997
### Applying changes
@@ -108,7 +106,7 @@ For a given event on a task instance:
108106

109107
- Global listeners run in configuration order.
110108
- Model-level listeners run next in the order defined in the BPMN model.
111-
- Global listeners marked with `after-local: true` run after model-level listeners.
109+
- Global listeners marked with `after-non-global: true` run after model-level listeners.
112110

113111
All listeners are blocking and execute sequentially.
114112

0 commit comments

Comments
 (0)