From 59e1d7b127a30d45dba0c85528cd1c57277086fe Mon Sep 17 00:00:00 2001 From: Philipp Ossler Date: Fri, 6 Dec 2024 15:12:24 +0100 Subject: [PATCH] feat(bpmn): Create page for the ad-hoc marker Add a new page for the BPMN ad-hoc marker and describe its usage. --- docs/components/modeler/bpmn/ad-hoc/ad-hoc.md | 75 ++++++++++++++++++ .../assets/ad-hoc-subprocess-activation.png | Bin 0 -> 27193 bytes .../bpmn/ad-hoc/assets/ad-hoc-subprocess.png | Bin 0 -> 22773 bytes docs/components/modeler/bpmn/markers.md | 1 + sidebars.js | 1 + 5 files changed, 77 insertions(+) create mode 100644 docs/components/modeler/bpmn/ad-hoc/ad-hoc.md create mode 100644 docs/components/modeler/bpmn/ad-hoc/assets/ad-hoc-subprocess-activation.png create mode 100644 docs/components/modeler/bpmn/ad-hoc/assets/ad-hoc-subprocess.png diff --git a/docs/components/modeler/bpmn/ad-hoc/ad-hoc.md b/docs/components/modeler/bpmn/ad-hoc/ad-hoc.md new file mode 100644 index 00000000000..67883eccc32 --- /dev/null +++ b/docs/components/modeler/bpmn/ad-hoc/ad-hoc.md @@ -0,0 +1,75 @@ +--- +id: ad-hoc +title: "Ad-hoc" +description: "The ad-hoc marker is only available for embedded subprocesses, so called ad-hoc subprocesses." +--- + +The ad-hoc marker (**~** a tilde character) is only available +for [embedded subprocesses](../embedded-subprocesses/embedded-subprocesses.md), so called **ad-hoc subprocesses**. +Compared to regular subprocesses, it allows more flexibility for executing the inner elements. + +![A demo process with an ad-hoc subprocess. Some elements inside the subprocess are active.](assets/ad-hoc-subprocess.png) + +The inner elements of an ad-hoc subprocess are not connected to a start or end event. Each element can be executed +multiple times, in any order, or skipped. + +If elements depend on each other, the elements can be connected by a sequence flow to build a structured sequence +within the ad-hoc subprocess. + +When a process instance reaches an ad-hoc subprocess, it [activates the inner elements](#activate-an-element) and waits +for their completion. After the last element is completed, the process instance completes the ad-hoc subprocess and +takes the outgoing sequence flows. + +### Constraints + +An ad-hoc subprocess has the following constraints: + +- Must have at least one activity +- Must not have start events or end events +- Any intermediate catch event must have an outgoing sequence flow + +## Activate an element + +An ad-hoc subprocess can define an expression `activeElementsCollection` that should return a +[list](../../feel/language-guide/feel-data-types.md#list) of strings. Each string in the list should match to an id of +an inner element of the ad-hoc subprocess. Usually, the expression accesses a process instance variable that was +created before and holds the list of element ids. + +![A process with an ad-hoc subprocess that shows how a variable is used to active the inner elements.](assets/ad-hoc-subprocess-activation.png) + +When a process instance reaches an ad-hoc subprocess, it evaluates the expression `activeElementsCollection` and +activates all elements whose element ids are in the list. + +If the list is empty or the expression is not defined, no element is activated and the ad-hoc subprocess stays active. + +If the expression doesn't evaluate to a list of strings, or the list contains other values than inner element ids, the +process instance creates an incident. + +:::note +Currently, it is not possible to activate elements dynamically after the ad-hoc subprocess is activated, only on +entering the subprocess. +::: + +## Variable mappings + +An ad-hoc subprocess can define input and output +[variable mappings](../../../concepts/variables.md#inputoutput-variable-mappings). + +Input variable mappings are applied on activating the ad-hoc subprocess and before evaluating the expression +`activeElementsCollection`. They can be used to create local variables for the ad-hoc subprocess. + +Output variable mappings are applied on completing the ad-hoc subprocess. They can be used to propagate local variables +from the ad-hoc subprocess into the process instance. By default, no local variables are propagated. + +## Additional resources + +### XML representation + +```xml + + + + + ... more contained elements ... + +``` diff --git a/docs/components/modeler/bpmn/ad-hoc/assets/ad-hoc-subprocess-activation.png b/docs/components/modeler/bpmn/ad-hoc/assets/ad-hoc-subprocess-activation.png new file mode 100644 index 0000000000000000000000000000000000000000..104d5e30d174bade3f725c44bfcc2095800bd27d GIT binary patch literal 27193 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 T!x(t26N<9Dx?GWrdEoy6DgHqJ literal 0 HcmV?d00001 diff --git a/docs/components/modeler/bpmn/ad-hoc/assets/ad-hoc-subprocess.png b/docs/components/modeler/bpmn/ad-hoc/assets/ad-hoc-subprocess.png new file mode 100644 index 0000000000000000000000000000000000000000..ec266ccc75451eba0913cfface1df3d2073d4652 GIT binary patch literal 22773 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 NmiBE}>5T^w{|