diff --git a/docs/components/connectors/use-connectors/index.md b/docs/components/connectors/use-connectors/index.md index 35a2aa5afa..2c7878056f 100644 --- a/docs/components/connectors/use-connectors/index.md +++ b/docs/components/connectors/use-connectors/index.md @@ -165,7 +165,11 @@ indicate internal website errors, which is why the website team is informed. The **Error Expression** property requires a [FEEL](/components/modeler/feel/what-is-feel.md) expression that yields a BPMN error object in the end. The BPMN error object can be an empty [context](/components/modeler/feel/language-guide/feel-data-types.md#context), [null](/components/modeler/feel/language-guide/feel-data-types.md#null), or a context containing at least a non-empty `errorType` and a non-empty `code` if the error type is `bpmnError`. You can use all available functionality provided by FEEL to produce this result. -Use the provided FEEL function [`bpmnError`](#function-bpmnerror) to conveniently create a BPMN error object and the provided FEEL function [`jobError`](#function-jobError) to conveniently create a fail job object. + +Use the provided FEEL functions: + +- [`bpmnError`](#function-bpmnerror) to create a BPMN error object. This triggers a [ThrowError call](/components/best-practices/development/dealing-with-problems-and-exceptions.md) to the workflow engine. +- [`jobError`](#function-jobError) to create a fail job object. This triggers a [FailJob call](/components/best-practices/development/dealing-with-problems-and-exceptions.md) to the workflow engine. The `bpmnError` FEEL function optionally allows you to pass variables as the third parameter. You can combine this with a boundary event to use the variables in condition expressions when handling the error event. Example FEEL expression: diff --git a/versioned_docs/version-8.2/components/connectors/use-connectors/index.md b/versioned_docs/version-8.2/components/connectors/use-connectors/index.md index c9a79442fd..ae76b97e69 100644 --- a/versioned_docs/version-8.2/components/connectors/use-connectors/index.md +++ b/versioned_docs/version-8.2/components/connectors/use-connectors/index.md @@ -161,7 +161,7 @@ indicate internal website errors, which is why the website team is informed. The **Error Expression** property requires a [FEEL](/components/modeler/feel/what-is-feel.md) expression that yields a BPMN error object in the end. The BPMN error object can be an empty [context](/components/modeler/feel/language-guide/feel-data-types.md#context), [null](/components/modeler/feel/language-guide/feel-data-types.md#null), or a context containing at least a non-empty `code`. You can use all available functionality provided by FEEL to produce this result. -Use the provided FEEL function [`bpmnError`](#function-bpmnerror) to conveniently create a BPMN error object. +Use the provided FEEL function [`bpmnError`](#function-bpmnerror) to conveniently create a BPMN error object. This triggers a [ThrowError call](/components/best-practices/development/dealing-with-problems-and-exceptions.md) to the workflow engine. Within the FEEL expression, you access the following temporary variables: diff --git a/versioned_docs/version-8.3/components/connectors/use-connectors/index.md b/versioned_docs/version-8.3/components/connectors/use-connectors/index.md index a02dd56eec..9e922dfa0b 100644 --- a/versioned_docs/version-8.3/components/connectors/use-connectors/index.md +++ b/versioned_docs/version-8.3/components/connectors/use-connectors/index.md @@ -161,7 +161,7 @@ indicate internal website errors, which is why the website team is informed. The **Error Expression** property requires a [FEEL](/components/modeler/feel/what-is-feel.md) expression that yields a BPMN error object in the end. The BPMN error object can be an empty [context](/components/modeler/feel/language-guide/feel-data-types.md#context), [null](/components/modeler/feel/language-guide/feel-data-types.md#null), or a context containing at least a non-empty `code`. You can use all available functionality provided by FEEL to produce this result. -Use the provided FEEL function [`bpmnError`](#function-bpmnerror) to conveniently create a BPMN error object. +Use the provided FEEL function [`bpmnError`](#function-bpmnerror) to conveniently create a BPMN error object. This triggers a [ThrowError call](/components/best-practices/development/dealing-with-problems-and-exceptions.md) to the workflow engine. Within the FEEL expression, you access the following temporary variables: diff --git a/versioned_docs/version-8.4/components/connectors/use-connectors/index.md b/versioned_docs/version-8.4/components/connectors/use-connectors/index.md index 962a75afa0..28c4da31ee 100644 --- a/versioned_docs/version-8.4/components/connectors/use-connectors/index.md +++ b/versioned_docs/version-8.4/components/connectors/use-connectors/index.md @@ -165,7 +165,11 @@ indicate internal website errors, which is why the website team is informed. The **Error Expression** property requires a [FEEL](/components/modeler/feel/what-is-feel.md) expression that yields a BPMN error object in the end. The BPMN error object can be an empty [context](/components/modeler/feel/language-guide/feel-data-types.md#context), [null](/components/modeler/feel/language-guide/feel-data-types.md#null), or a context containing at least a non-empty `errorType` and a non-empty `code` if the error type is `bpmnError`. You can use all available functionality provided by FEEL to produce this result. -Use the provided FEEL function [`bpmnError`](#function-bpmnerror) to conveniently create a BPMN error object and the provided FEEL function [`jobError`](#function-jobError) to conveniently create a fail job object. + +Use the provided FEEL functions: + +- [`bpmnError`](#function-bpmnerror) to create a BPMN error object. This triggers a [ThrowError call](/components/best-practices/development/dealing-with-problems-and-exceptions.md) to the workflow engine. +- [`jobError`](#function-jobError) to create a fail job object. This triggers a [FailJob call](/components/best-practices/development/dealing-with-problems-and-exceptions.md) to the workflow engine. The `bpmnError` FEEL function optionally allows you to pass variables as the third parameter. You can combine this with a boundary event to use the variables in condition expressions when handling the error event. Example FEEL expression: diff --git a/versioned_docs/version-8.5/components/connectors/use-connectors/index.md b/versioned_docs/version-8.5/components/connectors/use-connectors/index.md index 35a2aa5afa..2c7878056f 100644 --- a/versioned_docs/version-8.5/components/connectors/use-connectors/index.md +++ b/versioned_docs/version-8.5/components/connectors/use-connectors/index.md @@ -165,7 +165,11 @@ indicate internal website errors, which is why the website team is informed. The **Error Expression** property requires a [FEEL](/components/modeler/feel/what-is-feel.md) expression that yields a BPMN error object in the end. The BPMN error object can be an empty [context](/components/modeler/feel/language-guide/feel-data-types.md#context), [null](/components/modeler/feel/language-guide/feel-data-types.md#null), or a context containing at least a non-empty `errorType` and a non-empty `code` if the error type is `bpmnError`. You can use all available functionality provided by FEEL to produce this result. -Use the provided FEEL function [`bpmnError`](#function-bpmnerror) to conveniently create a BPMN error object and the provided FEEL function [`jobError`](#function-jobError) to conveniently create a fail job object. + +Use the provided FEEL functions: + +- [`bpmnError`](#function-bpmnerror) to create a BPMN error object. This triggers a [ThrowError call](/components/best-practices/development/dealing-with-problems-and-exceptions.md) to the workflow engine. +- [`jobError`](#function-jobError) to create a fail job object. This triggers a [FailJob call](/components/best-practices/development/dealing-with-problems-and-exceptions.md) to the workflow engine. The `bpmnError` FEEL function optionally allows you to pass variables as the third parameter. You can combine this with a boundary event to use the variables in condition expressions when handling the error event. Example FEEL expression: