Skip to content

Commit fba03b7

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

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
On startup, the configuration is validated against the following rules, trying to correct issues where possible instead of failing startup:
@@ -59,38 +59,36 @@ In all the above cases, a suitable warning is reported in the orchestration clus
5959

6060
### Example configuration (YAML)
6161
```yaml
62-
zeebe:
63-
broker:
64-
experimental:
65-
engine:
66-
listeners:
67-
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-local: true
62+
camunda:
63+
cluster:
64+
global-listeners:
65+
user-task:
66+
- type: "validate-task"
67+
event-types:
68+
- creating
69+
- type: "audit-generic"
70+
event-types: all
71+
retries: 5
72+
- type: "notify-assignee"
73+
event-types:
74+
- assigning
75+
- updating
76+
- canceling
77+
after-non-global: true
8078
```
8179
8280
### Example configuration (environment variables)
8381
```
84-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_0_TYPE=validate-task
85-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_0_EVENT_TYPES_0=creating
86-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_1_TYPE=audit-generic
87-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_1_EVENT_TYPES_0=all
88-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_1_RETRIES=5
89-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_2_TYPE=notify-assignee
90-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_2_EVENT_TYPES_0=assigning
91-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_2_EVENT_TYPES_1=updating
92-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_2_EVENT_TYPES_2=canceling
93-
ZEEBE_BROKER_EXPERIMENTAL_ENGINE_LISTENERS_TASK_2_AFTER_LOCAL=true
82+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_0_TYPE=validate-task
83+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_0_EVENT_TYPES_0=creating
84+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_1_TYPE=audit-generic
85+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_1_EVENT_TYPES_0=all
86+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_1_RETRIES=5
87+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_TYPE=notify-assignee
88+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_EVENT_TYPES_0=assigning
89+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_EVENT_TYPES_1=updating
90+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_EVENT_TYPES_2=canceling
91+
CAMUNDA_CLUSTER_GLOBAL_LISTENERS_USER_TASK_2_AFTER_NON_GLOBAL=true
9492
```
9593

9694
### Applying changes
@@ -104,7 +102,7 @@ For a given event on a task instance:
104102

105103
- Global listeners run in configuration order.
106104
- Model-level listeners run next in the order defined in the BPMN model.
107-
- Global listeners marked with `after-local: true` run after model-level listeners.
105+
- Global listeners marked with `after-non-global: true` run after model-level listeners.
108106

109107
All listeners are blocking and execute sequentially.
110108

0 commit comments

Comments
 (0)