Skip to content

Commit 40c5cd4

Browse files
fix: temporary configuration changes for 8.9.0-alpha1 release, removing references to Unified Configuration
1 parent c57e31d commit 40c5cd4

File tree

1 file changed

+36
-36
lines changed

1 file changed

+36
-36
lines changed

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

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

3636
## Configuration
3737

38-
You configure global user task listeners at the cluster level in the [Unified Configuration](/self-managed/components/orchestration-cluster/core-settings/configuration/properties.md#camundaclusterglobal-listeners).
39-
40-
Configuration path: `camunda.cluster.global-listeners.user-task`
38+
You configure global user task listeners at the cluster level in the broker configuration at configuration path: `zeebe.broker.experimental.listeners.task`.
4139

4240
Each listener entry supports the following properties:
4341

44-
| Property | Description |
45-
| :----------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
46-
| `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. |
47-
| `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`. |
48-
| `retries` | (Optional) Number of retries for the user task listener job (defaults to 3 if omitted). |
49-
| `after-non-global` | (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-local` | (Optional) Boolean indicating whether the listener should run after model-level listeners. Defaults to `false` (runs before model-level listeners). |
5048

5149
### Validation behavior
5250

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

6563
```yaml
66-
camunda:
67-
cluster:
68-
global-listeners:
69-
user-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-non-global: true
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
8282
```
8383
8484
### Example configuration (environment variables)
8585
8686
```
87-
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_0_TYPE=validate-task
88-
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_0_EVENT_TYPES_0=creating
89-
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_1_TYPE=audit-generic
90-
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_1_EVENT_TYPES_0=all
91-
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_1_RETRIES=5
92-
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_TYPE=notify-assignee
93-
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_EVENT_TYPES_0=assigning
94-
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_EVENT_TYPES_1=updating
95-
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_EVENT_TYPES_2=canceling
96-
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_AFTER_NON_GLOBAL=true
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
9797
```
9898

9999
### Applying changes
@@ -108,7 +108,7 @@ For a given event on a task instance:
108108

109109
- Global listeners run in configuration order.
110110
- Model-level listeners run next in the order defined in the BPMN model.
111-
- Global listeners marked with `after-non-global: true` run after model-level listeners.
111+
- Global listeners marked with `after-local: true` run after model-level listeners.
112112

113113
All listeners are blocking and execute sequentially.
114114

0 commit comments

Comments
 (0)