From a5a10a0cff79d77c23a6d21e0f50f3ab28dcc727 Mon Sep 17 00:00:00 2001 From: christinaausley <84338309+christinaausley@users.noreply.github.com> Date: Fri, 6 Dec 2024 16:29:45 -0500 Subject: [PATCH] migration support for zeebe user tasks (#4573) * migration support for zeebe user tasks * grammatical tweaks * begin updating migration guide * update imports * typo * update to c8 api * fix broken links * formatted table * Update resource-planning.md * rebase * rebase * update based on new changes * backport * adjust sidebars * adjust sidebars * revert some 8.5 changes * revert 8.5 changes * adjust link * adjust sidebar * revert 8.5 sidebar * update 8.5 sidebar * remove get user task from 8.6 * Update 03-task-application-architecture.md * Update the migration guide to Zeebe (Camunda) user tasks * Update the documentation about user tasks * Rename "Zeebe user task" to "Camunda user task" * Note that embedded forms are supported only by Job worked-based user tasks * revert a few changes in next * revert user task changes * backport a few changes * Update migrate-to-zeebe-user-tasks.md * resolve build errors --------- Co-authored-by: Jonathan Lukas Co-authored-by: volodymyr-melnykc --- .../02-user-task-lifecycle.md | 2 +- .../03-task-application-architecture.md | 12 +- .../migrate-to-zeebe-user-tasks.md | 187 +++++++++-------- .../assets/img/api-architecture.png | Bin 65054 -> 0 bytes .../tasklist-api-rest/sidebar-schema.js | 1 - .../specifications/assign-task.api.mdx | 2 +- .../specifications/complete-task.api.mdx | 2 +- .../specifications/get-task-by-id.api.mdx | 2 +- .../specifications/search-tasks.api.mdx | 2 +- .../specifications/unassign-task.api.mdx | 2 +- docs/apis-tools/zeebe-api-rest/tutorial.md | 2 +- .../concepts/process-instance-migration.md | 2 +- .../modeler/bpmn/user-tasks/user-tasks.md | 2 +- .../advanced-modeling/form-linking.md | 4 + docs/reference/release-notes/850.md | 2 +- optimize_sidebars.js | 5 - .../version-3.14.0-sidebars.json | 5 - sidebars.js | 1 + static/.htaccess | 5 + .../migrate-to-zeebe-user-tasks.md | 2 +- .../tasklist-api-rest-overview.md | 6 + .../03-task-application-architecture.md | 12 +- .../migrate-to-zeebe-user-tasks.md | 190 ++++++------------ .../tasklist-api-rest/sidebar-schema.js | 1 - .../tasklist-api-rest-overview.md | 6 + .../apis-tools/zeebe-api-rest/tutorial.md | 2 +- .../modeler/bpmn/user-tasks/user-tasks.md | 2 +- .../advanced-modeling/form-linking.md | 4 + .../reference/release-notes/850.md | 2 +- versioned_sidebars/version-8.6-sidebars.json | 9 +- 30 files changed, 214 insertions(+), 262 deletions(-) rename docs/apis-tools/{tasklist-api-rest => migration-manuals}/migrate-to-zeebe-user-tasks.md (61%) delete mode 100644 docs/apis-tools/tasklist-api-rest/assets/img/api-architecture.png rename versioned_docs/version-8.6/apis-tools/{tasklist-api-rest => migration-manuals}/migrate-to-zeebe-user-tasks.md (57%) diff --git a/docs/apis-tools/frontend-development/01-task-applications/02-user-task-lifecycle.md b/docs/apis-tools/frontend-development/01-task-applications/02-user-task-lifecycle.md index cabf0ea6826..85fdc6ea1eb 100644 --- a/docs/apis-tools/frontend-development/01-task-applications/02-user-task-lifecycle.md +++ b/docs/apis-tools/frontend-development/01-task-applications/02-user-task-lifecycle.md @@ -78,7 +78,7 @@ Make sure that you create your own validation logic that matches your use case. ## Implement the life cycle with the task API -To implement task life cycle operations with the Zeebe task API, call the respective endpoints: +To implement task life cycle operations with the task API, call the respective endpoints: - [`POST /user-tasks/:taskKey/assignment`](/apis-tools/zeebe-api-rest/specifications/assign-a-user-task.api.mdx) or [`DELETE /user-tasks/:taskKey/assignee`](/apis-tools/zeebe-api-rest/specifications/unassign-a-user-task.api.mdx) to change task assignment. - [`PATCH /user-tasks/:taskKey`](/apis-tools/zeebe-api-rest/specifications/update-a-user-task.api.mdx) to update a task. diff --git a/docs/apis-tools/frontend-development/01-task-applications/03-task-application-architecture.md b/docs/apis-tools/frontend-development/01-task-applications/03-task-application-architecture.md index 50dfb21ef17..b0027b95827 100644 --- a/docs/apis-tools/frontend-development/01-task-applications/03-task-application-architecture.md +++ b/docs/apis-tools/frontend-development/01-task-applications/03-task-application-architecture.md @@ -6,10 +6,10 @@ description: "Understand and decide on the architecture of your task application A typical task application architecture consists of a task application frontend, a backend-for-frontend, and one or more data sources or services that contain business data relevant for the application users to perform their work. The backend implements Camunda Zeebe and Tasklist clients to retrieve and interact with tasks via Camunda APIs. For historical process instance data, Operate is also required. -Depending on the user task implementation type (job-based vs Zeebe user task) you use in your processes, you need to run either the Tasklist or Zeebe client to run operations on task. Task, form, and variable retrieval happens via the Tasklist API. Learn more about the differences of the task implementation types in the [migration guide for Zeebe user tasks](/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md). +Depending on the user task implementation type (job worker-based vs Zeebe user task) you use in your processes, you need to run either the Tasklist or Zeebe client to run operations on task. Task, form, and variable retrieval happens via the API. Learn more about the differences of the task implementation types in the [migration guide for Zeebe user tasks](/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md). :::tip -Starting a completely new project? Use only Zeebe user tasks to simplify your implementation. +Starting a new project? Use Zeebe user tasks to simplify your implementation. ::: Click on any element of this diagram to jump to the documentation page for the respective component: @@ -72,14 +72,14 @@ style Tasklist stroke:#10c95d,color:#000 click Forms "../../forms/introduction-to-forms" click Rest "../../../tasklist-api-rest/tasklist-api-rest-overview" -click Job "../../../tasklist-api-rest/migrate-to-zeebe-user-tasks" -click ZeebeTasks "../../../tasklist-api-rest/migrate-to-zeebe-user-tasks" +click Job "../../../migration-manuals/migrate-to-zeebe-user-tasks" +click ZeebeTasks "../../../migration-manuals/migrate-to-zeebe-user-tasks" click ZeebeRest "../../../zeebe-api-rest/zeebe-api-rest-overview" ``` Follow these resources to learn more about the individual components: -- Familiarize yourself with the [Tasklist API](/apis-tools/tasklist-api-rest/tasklist-api-rest-overview.md) for task, variable, and form retrieval, and to run operations on job-based user tasks. -- Learn how to use the [Zeebe API](/apis-tools/zeebe-api-rest/zeebe-api-rest-overview.md) to run operations on Zeebe-based user tasks. +- Learn how to use the [Camunda 8 API](/apis-tools/camunda-api-rest/specifications/assign-user-task.api.mdx) for task, variable, and form retrieval, and to run operations on Zeebe user tasks. +- Familiarize yourself with the [Tasklist API](/apis-tools/tasklist-api-rest/tasklist-api-rest-overview.md) to run operations on job worker-based user tasks. - Understand how to design, embed, and customize [forms](/apis-tools/frontend-development/03-forms/01-introduction-to-forms.md). - Understand how this architecture fits into the overall Camunda architecture with the [Java greenfield stack](/components/best-practices/architecture/deciding-about-your-stack.md). diff --git a/docs/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md b/docs/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md similarity index 61% rename from docs/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md rename to docs/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md index b4f17bacb49..4b6a81d4d47 100644 --- a/docs/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md +++ b/docs/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md @@ -1,32 +1,32 @@ --- id: migrate-to-zeebe-user-tasks title: Migrate to Zeebe user tasks -description: "Learn how to migrate job worker-based user tasks to Zeebe-based tasks." +description: "Learn how to migrate job worker-based user tasks to Zeebe user tasks." --- import DocCardList from '@theme/DocCardList'; import FormViewer from "@site/src/mdx/FormViewer"; -import YesItem from "./assets/react-components/YesItem"; -import NoItem from "./assets/react-components/NoItem"; -import TableTextSmall from "./assets/react-components/TableTextSmall"; -import userTaskMigrationDecisionHelperForm from "./assets/forms/userTaskMigrationDecisionHelperForm.js"; -import "./assets/css/condensedTable.module.css"; -import styles from "./assets/css/cleanImages.module.css"; -import APIArchitectureImg from './assets/img/api-architecture.png'; -import ZeebeTaskSelectionImg from './assets/img/zeebe-user-task-selection.png'; - -Camunda 8.5 introduces a new [user task](/components/modeler/bpmn/user-tasks/user-tasks.md) implementation type: Zeebe user tasks. -Zeebe user tasks have several benefits, including: +import YesItem from "../tasklist-api-rest/assets/react-components/YesItem"; +import NoItem from "../tasklist-api-rest/assets/react-components/NoItem"; +import TableTextSmall from "../tasklist-api-rest/assets/react-components/TableTextSmall"; +import userTaskMigrationDecisionHelperForm from "../tasklist-api-rest/assets/forms/userTaskMigrationDecisionHelperForm.js"; +import "../tasklist-api-rest/assets/css/condensedTable.module.css"; +import styles from "../tasklist-api-rest/assets/css/cleanImages.module.css"; +import ZeebeTaskSelectionImg from '../tasklist-api-rest/assets/img/zeebe-user-task-selection.png'; + +Camunda 8.5 introduced a new [user task](/components/modeler/bpmn/user-tasks/user-tasks.md) implementation type: Zeebe user tasks. + +Zeebe user tasks have several benefits compared to job worked-based user tasks. It includes: - Running directly on the automation engine for high performance. - Removing dependencies and round trips to Tasklist. -- A more powerful API that supports the full task lifecycle. +- A powerful API that supports the full task lifecycle. In this guide, you will learn: - Under which circumstances and when you should migrate. - How to estimate the impact on a project. -- The steps you need to take for a successful migration without interrupting your operations. +- Steps you need to take for a successful migration without interrupting your operations. ## Decide on your migration path @@ -34,17 +34,6 @@ Zeebe user tasks require migration of the user tasks in both your diagrams and t With this in mind, you can migrate at your own pace. If you should migrate now or later, and what is required to migrate depends on your current setup and future plans. -Use the following decision helper questionnaire to figure out what's right for you: - - - ### Task type differences Learn the differences between both task types and make an informed decision, and understand the new capabilities of Zeebe user tasks. Refer to this table for important high-level differences of the two task types: @@ -58,7 +47,7 @@ Learn the differences between both task types and make an informed decision, and
Zeebe user tasks
- Recommended for new projects + Recommended for existing and new projects @@ -91,11 +80,11 @@ Learn the differences between both task types and make an informed decision, and
Partially
Queries, GET tasks, forms, variables - ℹ Currently, you must use Zeebe and Tasklist APIs to use Zeebe user tasks + ℹ Currently, you must use the Camunda 8 and Tasklist APIs to use Zeebe user tasks - Supports Zeebe API + Supports Camunda 8 API @@ -123,7 +112,6 @@ Learn the differences between both task types and make an informed decision, and - Task listeners will be introduced in a future release @@ -146,10 +134,9 @@ Learn the differences between both task types and make an informed decision, and Recommendations You can continue to use this task type on existing projects when you have a custom task application running on it and do not require any of the above features. - Refer to the decision helper above for a tailored recommendation. - Use this task type on any new projects when you run Tasklist. + Recommended for existing and new projects when you run Tasklist. Migrate existing projects and task applications/clients to this task type when you require one of the features above, or the following use cases:
    @@ -161,12 +148,11 @@ Learn the differences between both task types and make an informed decision, and
  • Enrich tasks with business data
 - Refer to the decision helper above for a tailored recommendation. -## Switch the implementation type of your user tasks +## Switch the implementation type of user tasks We recommend you migrate process-by-process, allowing you to thoroughly test the processes in your test environments or via your [CI/CD](/guides/devops-lifecycle/integrate-web-modeler-in-ci-cd.md). To do this, take the following steps: @@ -181,176 +167,183 @@ We recommend you migrate process-by-process, allowing you to thoroughly test the Repeat these steps for all user tasks in the process. Then, deploy the process to your development cluster and test it by running the process and ensuring your custom task applications work. -## Use the new Zeebe Task API +## Use Camunda 8 API :::note The Tasklist REST API is not deprecated, and you still need it for queries on both task types. ::: -Operations on Zeebe user tasks which modify the task state have to be performed using the new Zeebe REST API. However, queries and adjacent operations still require the Tasklist REST API. The following table provides a breakdown of which operations are supported in which API, and for which user tasks. +The following table provides a breakdown of which operations are supported in which API, and for which user tasks. - + + + + + + - - - + + + - - - + + + - - + + - - - + + + - - + + - - + + - + - - - + + +
Operation Tasklist APIZeebe Task API (8.5)Camunda 8 API
Deprecated on 8.7Supported from 8.6+
Query tasks✔ All types← Use Tasklist APIQuery user task✔ Job worker-based user tasks✔ Zeebe user tasks
Get task✔ All types← Use Tasklist APIGet user task✔ Job worker-based user tasks✔ Zeebe user tasks
Retrieve task variables✔ All types← Use Tasklist API✔ Job worker-based user tasks✔ Zeebe user tasks
Get task form✔ All types← Use Tasklist APIGet user task form✔ Job worker-based user tasks✔ Zeebe user tasks
Change task assignment✔ Job worker-based tasks✔ Zeebe tasks✔ Job worker-based user tasks✔ Zeebe user tasks
Complete task✔ Job worker-based tasks✔ Zeebe tasks✔ Job worker-based user tasks✔ Zeebe user tasks
Update task -✔ Zeebe tasks✔ Zeebe user tasks
Safe and retrieve draft variables✔ All types← Use Tasklist APISave and retrieve draft variables✔ Job worker-based user tasks -
-You can also operate both task types at the same time in the same application utilizing both APIs. We recommend this for a smooth migration, but you should eventually update all processes to use the new task type to use all benefits. The following image illustrates how to route API calls to the respective APIs: - -Task API Architecture - -The major changes are: - -- Create and maintain new, additional secrets for the Zeebe REST API. -- Call dedicated endpoints on separate components (Zeebe vs. Tasklist) for all state modifications on tasks for the respective task types. -- Manage new request/response objects. - The following table outlines the respective endpoints. Click the endpoints to follow to the API documentation and inspect the differences in the request and response objects. - + - + - + - + - + + - - + - + - + - +
Operation Tasklist APIZeebe Task API (8.5)Camunda 8 API
Query tasksQuery user tasks - + POST /tasks/search ← Use Tasklist API + + POST /user-tasks/search + +
Get taskGet user task - + GET /tasks/:taskId ← Use Tasklist API + + GET /user-tasks/:userTaskKey + +
Retrieve task variables - + GET /variables/:variableId -
- + 		+ POST /tasks/:taskId/variables/search ← Use Tasklist API
Get task form - + GET /forms/:formId ← Use Tasklist API + + GET /user-tasks/:userTaskKey/form + +
Assign a task - + PATCH /tasks/:taskId/assign - - POST /user-tasks/:taskKey/assignment + + POST /user-tasks/:userTaskKey/assignment
Unassign a task - + PATCH /tasks/:taskId/unassign - - DELETE /user-tasks/:taskKey/assignee + + DELETE /user-tasks/:userTaskKey/assignee
Complete task - + PATCH /tasks/:taskId/complete - - POST /user-tasks/:taskKey/completion + + POST /user-tasks/:userTaskKey/completion
Update task-- - - PATCH /user-tasks/:taskKey + + PATCH /user-tasks/:userTaskKey
Safe and retrieve draft variablesSave and retrieve draft variables - + POST /tasks/:taskId/variables ← Use Tasklist API-
@@ -373,9 +366,9 @@ docId:"apis-tools/tasklist-api-rest/tasklist-api-rest-overview" }, { type:"link", -href:"/docs/next/apis-tools/zeebe-api-rest/zeebe-api-rest-overview/", -label: "Zeebe API (REST)", -docId:"apis-tools/zeebe-api-rest/zeebe-api-rest-overview" +href:"/docs/next/apis-tools/camunda-api-rest/camunda-api-rest-overview/", +label: "Camunda 8 API (REST)", +docId:"apis-tools/camunda-api-rest/camunda-api-rest-overview" } ]}/> @@ -383,6 +376,6 @@ docId:"apis-tools/zeebe-api-rest/zeebe-api-rest-overview" If your task application does not work properly after migration, check the following: -- **The endpoints return specific error messages when you run them on the wrong task type**: Ensure to call the right endpoint for the right task type, c.f. above [table](#use-the-new-zeebe-task-api). +- **The endpoints return specific error messages when you run them on the wrong task type**: Ensure to call the right endpoint for the right task type, c.f. above [table](#use-the-new-camunda-8-api). - **Forms do not appear**: Ensure you have extracted embedded forms, if any, and [transformed them into linked forms](/components/modeler/bpmn/user-tasks/user-tasks.md#camunda-form-linked), before you change the task type implementation. - **Task update operation does not work**: The update operation is only available to Zeebe user tasks. diff --git a/docs/apis-tools/tasklist-api-rest/assets/img/api-architecture.png b/docs/apis-tools/tasklist-api-rest/assets/img/api-architecture.png deleted file mode 100644 index 93cf8ef7c8f2340c6a03a272fd9423a0c284df74..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 65054 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%0DVa;oa^68=}?4Anz_Pw2=Hdd)i+kZed~5WL2~H0 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 EAJ?<2?f?J) diff --git a/docs/apis-tools/tasklist-api-rest/sidebar-schema.js b/docs/apis-tools/tasklist-api-rest/sidebar-schema.js index 517c97c4df8..ebb41a15e74 100644 --- a/docs/apis-tools/tasklist-api-rest/sidebar-schema.js +++ b/docs/apis-tools/tasklist-api-rest/sidebar-schema.js @@ -7,6 +7,5 @@ module.exports = { { Specifications: require("./specifications/sidebar.js"), }, - "apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks", ], }; diff --git a/docs/apis-tools/tasklist-api-rest/specifications/assign-task.api.mdx b/docs/apis-tools/tasklist-api-rest/specifications/assign-task.api.mdx index 14546a99a99..e15045dcb79 100644 --- a/docs/apis-tools/tasklist-api-rest/specifications/assign-task.api.mdx +++ b/docs/apis-tools/tasklist-api-rest/specifications/assign-task.api.mdx @@ -44,7 +44,7 @@ When using REST API with JWT authentication token following request body paramet On success returned. -
Schema
+
Schema
An error is returned when the task is not active (not in the CREATED state).
An error is returned when task was already assigned, except the case when JWT authentication token used and `allowOverrideAssignment = true`. diff --git a/docs/apis-tools/tasklist-api-rest/specifications/complete-task.api.mdx b/docs/apis-tools/tasklist-api-rest/specifications/complete-task.api.mdx index 1f4e3b31ea8..a2205914bde 100644 --- a/docs/apis-tools/tasklist-api-rest/specifications/complete-task.api.mdx +++ b/docs/apis-tools/tasklist-api-rest/specifications/complete-task.api.mdx @@ -44,7 +44,7 @@ Variables to update or add to task during the task completion On success returned. -
Schema
+
Schema
An error is returned when the task is not active (not in the CREATED state).
An error is returned if the task was not claimed (assigned) before.
An error is returned if the task is not assigned to the current user. diff --git a/docs/apis-tools/tasklist-api-rest/specifications/get-task-by-id.api.mdx b/docs/apis-tools/tasklist-api-rest/specifications/get-task-by-id.api.mdx index c9ba57ae4b2..ca8de33aad9 100644 --- a/docs/apis-tools/tasklist-api-rest/specifications/get-task-by-id.api.mdx +++ b/docs/apis-tools/tasklist-api-rest/specifications/get-task-by-id.api.mdx @@ -37,7 +37,7 @@ Get one task by id. Returns task or error when task does not exist. On success returned. -
Schema
+
Schema
User has no permission to access the task (Self-managed only). diff --git a/docs/apis-tools/tasklist-api-rest/specifications/search-tasks.api.mdx b/docs/apis-tools/tasklist-api-rest/specifications/search-tasks.api.mdx index b4d862e180d..e8e2b223ace 100644 --- a/docs/apis-tools/tasklist-api-rest/specifications/search-tasks.api.mdx +++ b/docs/apis-tools/tasklist-api-rest/specifications/search-tasks.api.mdx @@ -69,7 +69,7 @@ An array of the task's variables. Only variables specified in `TaskSearchRequest The draft value of the variable. -
  • ]
  • ]
    • +
  • ]
  • ]
    • An error is returned when more than one search parameters among `[searchAfter, searchAfterOrEqual, searchBefore, searchBeforeOrEqual]` are present in request diff --git a/docs/apis-tools/tasklist-api-rest/specifications/unassign-task.api.mdx b/docs/apis-tools/tasklist-api-rest/specifications/unassign-task.api.mdx index 2ecc8512e03..2e474e4b709 100644 --- a/docs/apis-tools/tasklist-api-rest/specifications/unassign-task.api.mdx +++ b/docs/apis-tools/tasklist-api-rest/specifications/unassign-task.api.mdx @@ -40,7 +40,7 @@ Unassign a task with `taskId`. Returns the task. On success returned. -
    Schema
    +
    Schema
    An error is returned when the task is not active (not in the CREATED state).
    An error is returned if the task was not claimed (assigned) before. diff --git a/docs/apis-tools/zeebe-api-rest/tutorial.md b/docs/apis-tools/zeebe-api-rest/tutorial.md index ec299cbe3a6..2bb1795037a 100644 --- a/docs/apis-tools/zeebe-api-rest/tutorial.md +++ b/docs/apis-tools/zeebe-api-rest/tutorial.md @@ -41,7 +41,7 @@ In this tutorial, we will execute arguments to assign and unassign a user to and ## Assign a Zeebe user task (POST) :::note -In this tutorial, you will capture a **Zeebe user task** ID to assign and unassign users in this API. Camunda 8.5 introduced this new [user task](/components/modeler/bpmn/user-tasks/user-tasks.md) implementation type, and these Zeebe user tasks are different from job worker-based user tasks. See more details on task type differences in the [migrating to Zeebe user tasks documentation](/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md#task-type-differences). +In this tutorial, you will capture a **Zeebe user task** ID to assign and unassign users in this API. Camunda 8.5 introduced this new [user task](/components/modeler/bpmn/user-tasks/user-tasks.md) implementation type, and these Zeebe user tasks are different from job worker-based user tasks. See more details on task type differences in the [migrating to Zeebe user tasks documentation](/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md#task-type-differences). ::: First, let's script an API call to assign a Zeebe user task. diff --git a/docs/components/concepts/process-instance-migration.md b/docs/components/concepts/process-instance-migration.md index a48724ed25e..9e13aa0d367 100644 --- a/docs/components/concepts/process-instance-migration.md +++ b/docs/components/concepts/process-instance-migration.md @@ -370,7 +370,7 @@ The following limitations exist that may be supported in future versions: - An element that becomes nested in a newly added subprocess - An element that was nested in a subprocess is no longer nested in that subprocess - Mapping instructions cannot change the element type -- Mapping instructions cannot change the task implementation, e.g. from a job worker user task to a Zeebe User Task +- Mapping instructions cannot change the task implementation, e.g. from a job worker user task to a Zeebe user task - The process instance must be in a wait state, i.e. waiting for an event or external input like job completion. It may not be taking a sequence flow or triggering an event while migrating the instance A full overview of error codes can be found in the migration command [RPC](/apis-tools/zeebe-api/gateway-service.md#migrateprocessinstance-rpc) or [REST](/apis-tools/camunda-api-rest/specifications/migrate-process-instance.api.mdx). diff --git a/docs/components/modeler/bpmn/user-tasks/user-tasks.md b/docs/components/modeler/bpmn/user-tasks/user-tasks.md index 5212b2a3b2c..90a64a6191c 100644 --- a/docs/components/modeler/bpmn/user-tasks/user-tasks.md +++ b/docs/components/modeler/bpmn/user-tasks/user-tasks.md @@ -162,7 +162,7 @@ A user task does not have to be managed by Zeebe. Instead, you can also use job workers to implement a custom user task logic. Note that you will lose all the task lifecycle and state management features that Zeebe provides and will have to implement them yourself. Use job workers only in case you require a very specific implementation of user tasks that can't be implemented on top of Zeebe user tasks. :::info -If you started using Camunda 8 with version 8.4 or a lower version and upgraded to 8.5 or newer, your user tasks are probably implemented as job workers. Refer to the [migration guide](/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md) to find a detailed list of the differences between the task implementation types and learn how to migrate to Zeebe user tasks. +If you started using Camunda 8 with version 8.4 or a lower version and upgraded to 8.5 or newer, your user tasks are probably implemented as job workers. Refer to the [migration guide](/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md) to find a detailed list of the differences between the task implementation types and learn how to migrate to Zeebe user tasks. ::: You can define a job worker implementation for a user task by removing its `zeebe:userTask` extension element. diff --git a/docs/components/modeler/web-modeler/advanced-modeling/form-linking.md b/docs/components/modeler/web-modeler/advanced-modeling/form-linking.md index c7cf43464fe..cf43c6b50c5 100644 --- a/docs/components/modeler/web-modeler/advanced-modeling/form-linking.md +++ b/docs/components/modeler/web-modeler/advanced-modeling/form-linking.md @@ -89,6 +89,10 @@ To correct any instances affected by this issue, we recommend the following step ### Camunda Form (embedded) +:::info +Embedded forms are supported only by job worker-based user tasks and are not available for the [Zeebe user task implementation type](/components/modeler/bpmn/user-tasks/user-tasks.md#user-task-implementation-types). +::: + When choosing **Camunda Form (embedded)** as type you have the option to directly paste the form's JSON schema into the **Form JSON configuration** field of the properties panel. The form will be embedded directly into the BPMN diagram's XML representation. diff --git a/docs/reference/release-notes/850.md b/docs/reference/release-notes/850.md index 43f3806758c..d514f55adca 100644 --- a/docs/reference/release-notes/850.md +++ b/docs/reference/release-notes/850.md @@ -108,7 +108,7 @@ The first iteration of this feature brings back existing features from Camunda 7 -The first step to offer an intuitive and consistent experience via a single, [unified Camunda 8 REST API](https://camunda.com/blog/2024/03/streamlining-camunda-apis-zeebe-rest-api/) is to provide the Zeebe REST API. With this release, developers can use the Zeebe REST API to manage [Zeebe user tasks](/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md), enabling immediate task state changes. The Zeebe REST API includes support for Identity authentication and multi-tenancy, ensuring parity to the Zeebe gRPC API. +The first step to offer an intuitive and consistent experience via a single, [unified Camunda 8 REST API](https://camunda.com/blog/2024/03/streamlining-camunda-apis-zeebe-rest-api/) is to provide the Zeebe REST API. With this release, developers can use the Zeebe REST API to manage [Zeebe user tasks](/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md), enabling immediate task state changes. The Zeebe REST API includes support for Identity authentication and multi-tenancy, ensuring parity to the Zeebe gRPC API. ### Refactoring suggestions Modeler diff --git a/optimize_sidebars.js b/optimize_sidebars.js index 19965a7faab..7a7b5a97f81 100644 --- a/optimize_sidebars.js +++ b/optimize_sidebars.js @@ -2043,11 +2043,6 @@ module.exports = { }, ], }, - - docsLink( - "Migrate to Zeebe user tasks", - "apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks/" - ), ], }, diff --git a/optimize_versioned_sidebars/version-3.14.0-sidebars.json b/optimize_versioned_sidebars/version-3.14.0-sidebars.json index 8524cee6783..638ba5e0288 100644 --- a/optimize_versioned_sidebars/version-3.14.0-sidebars.json +++ b/optimize_versioned_sidebars/version-3.14.0-sidebars.json @@ -2426,11 +2426,6 @@ ] } ] - }, - { - "type": "link", - "label": "Migrate to Zeebe user tasks", - "href": "/docs/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks/" } ] }, diff --git a/sidebars.js b/sidebars.js index 486e440a9d9..c49653ca7d8 100644 --- a/sidebars.js +++ b/sidebars.js @@ -887,6 +887,7 @@ module.exports = { }, { "Migration manuals": [ + "apis-tools/migration-manuals/migrate-to-zeebe-user-tasks", "apis-tools/migration-manuals/migrate-to-camunda-api", ], }, diff --git a/static/.htaccess b/static/.htaccess index ac7a2e8363f..5455aece446 100644 --- a/static/.htaccess +++ b/static/.htaccess @@ -95,6 +95,11 @@ RewriteRule ^docs/reference/bpmn-processes/?(.*)$ /docs/components/modeler/bpmn/ # 8.7: content moves introduced prior to the release of version 8.7. #--------------------------------------------------------------------------------- +# Move migrating to Zeebe user tasks +RewriteRule ^docs/next/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks/?$ /docs/next/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks/$1 [R=301,L] +RewriteRule ^docs/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks/?$ /docs/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks/$1 [R=301,L] +RewriteRule ^docs/8.6/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks/?$ /docs/8.6/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks/$1 [R=301,L] + # Remove community clients RewriteRule ^docs/apis-tools/community-clients/c-sharp/?$ /docs/apis-tools/community-clients/$1 [R=301,L] RewriteRule ^docs/apis-tools/community-clients/micronaut/?$ /docs/apis-tools/community-clients/$1 [R=301,L] diff --git a/versioned_docs/version-8.5/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md b/versioned_docs/version-8.5/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md index b4f17bacb49..548529ec364 100644 --- a/versioned_docs/version-8.5/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md +++ b/versioned_docs/version-8.5/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md @@ -12,8 +12,8 @@ import TableTextSmall from "./assets/react-components/TableTextSmall"; import userTaskMigrationDecisionHelperForm from "./assets/forms/userTaskMigrationDecisionHelperForm.js"; import "./assets/css/condensedTable.module.css"; import styles from "./assets/css/cleanImages.module.css"; -import APIArchitectureImg from './assets/img/api-architecture.png'; import ZeebeTaskSelectionImg from './assets/img/zeebe-user-task-selection.png'; +import APIArchitectureImg from './assets/img/api-architecture.png'; Camunda 8.5 introduces a new [user task](/components/modeler/bpmn/user-tasks/user-tasks.md) implementation type: Zeebe user tasks. Zeebe user tasks have several benefits, including: diff --git a/versioned_docs/version-8.5/apis-tools/tasklist-api-rest/tasklist-api-rest-overview.md b/versioned_docs/version-8.5/apis-tools/tasklist-api-rest/tasklist-api-rest-overview.md index 51b479a2a4a..e0203e390e3 100644 --- a/versioned_docs/version-8.5/apis-tools/tasklist-api-rest/tasklist-api-rest-overview.md +++ b/versioned_docs/version-8.5/apis-tools/tasklist-api-rest/tasklist-api-rest-overview.md @@ -5,6 +5,12 @@ sidebar_position: 1 description: "Build applications for human-centered processes by querying human tasks, assigning users, and completing tasks with the Tasklist API." --- +:::note +Camunda introduced [Zeebe user tasks](/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md) with `8.5` to build more advanced functionalities. If you use Zeebe user tasks with `8.5`, task management endpoints in the Tasklist API will not work. + +To manage Zeebe user tasks Camunda has introduced the [Zeebe REST API](/apis-tools/zeebe-api-rest/zeebe-api-rest-overview.md), though you can still query Zeebe user tasks with the Tasklist API. +::: + ## Introduction The Tasklist API is a REST API designed to build task applications for human-centered processes. The API allows you to query user tasks, assign users to these tasks, and complete these tasks. diff --git a/versioned_docs/version-8.6/apis-tools/frontend-development/01-task-applications/03-task-application-architecture.md b/versioned_docs/version-8.6/apis-tools/frontend-development/01-task-applications/03-task-application-architecture.md index 50dfb21ef17..b0027b95827 100644 --- a/versioned_docs/version-8.6/apis-tools/frontend-development/01-task-applications/03-task-application-architecture.md +++ b/versioned_docs/version-8.6/apis-tools/frontend-development/01-task-applications/03-task-application-architecture.md @@ -6,10 +6,10 @@ description: "Understand and decide on the architecture of your task application A typical task application architecture consists of a task application frontend, a backend-for-frontend, and one or more data sources or services that contain business data relevant for the application users to perform their work. The backend implements Camunda Zeebe and Tasklist clients to retrieve and interact with tasks via Camunda APIs. For historical process instance data, Operate is also required. -Depending on the user task implementation type (job-based vs Zeebe user task) you use in your processes, you need to run either the Tasklist or Zeebe client to run operations on task. Task, form, and variable retrieval happens via the Tasklist API. Learn more about the differences of the task implementation types in the [migration guide for Zeebe user tasks](/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md). +Depending on the user task implementation type (job worker-based vs Zeebe user task) you use in your processes, you need to run either the Tasklist or Zeebe client to run operations on task. Task, form, and variable retrieval happens via the API. Learn more about the differences of the task implementation types in the [migration guide for Zeebe user tasks](/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md). :::tip -Starting a completely new project? Use only Zeebe user tasks to simplify your implementation. +Starting a new project? Use Zeebe user tasks to simplify your implementation. ::: Click on any element of this diagram to jump to the documentation page for the respective component: @@ -72,14 +72,14 @@ style Tasklist stroke:#10c95d,color:#000 click Forms "../../forms/introduction-to-forms" click Rest "../../../tasklist-api-rest/tasklist-api-rest-overview" -click Job "../../../tasklist-api-rest/migrate-to-zeebe-user-tasks" -click ZeebeTasks "../../../tasklist-api-rest/migrate-to-zeebe-user-tasks" +click Job "../../../migration-manuals/migrate-to-zeebe-user-tasks" +click ZeebeTasks "../../../migration-manuals/migrate-to-zeebe-user-tasks" click ZeebeRest "../../../zeebe-api-rest/zeebe-api-rest-overview" ``` Follow these resources to learn more about the individual components: -- Familiarize yourself with the [Tasklist API](/apis-tools/tasklist-api-rest/tasklist-api-rest-overview.md) for task, variable, and form retrieval, and to run operations on job-based user tasks. -- Learn how to use the [Zeebe API](/apis-tools/zeebe-api-rest/zeebe-api-rest-overview.md) to run operations on Zeebe-based user tasks. +- Learn how to use the [Camunda 8 API](/apis-tools/camunda-api-rest/specifications/assign-user-task.api.mdx) for task, variable, and form retrieval, and to run operations on Zeebe user tasks. +- Familiarize yourself with the [Tasklist API](/apis-tools/tasklist-api-rest/tasklist-api-rest-overview.md) to run operations on job worker-based user tasks. - Understand how to design, embed, and customize [forms](/apis-tools/frontend-development/03-forms/01-introduction-to-forms.md). - Understand how this architecture fits into the overall Camunda architecture with the [Java greenfield stack](/components/best-practices/architecture/deciding-about-your-stack.md). diff --git a/versioned_docs/version-8.6/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md b/versioned_docs/version-8.6/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md similarity index 57% rename from versioned_docs/version-8.6/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md rename to versioned_docs/version-8.6/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md index b4f17bacb49..d1f19118f98 100644 --- a/versioned_docs/version-8.6/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md +++ b/versioned_docs/version-8.6/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md @@ -1,32 +1,32 @@ --- id: migrate-to-zeebe-user-tasks title: Migrate to Zeebe user tasks -description: "Learn how to migrate job worker-based user tasks to Zeebe-based tasks." +description: "Learn how to migrate job worker-based user tasks to Zeebe user tasks." --- import DocCardList from '@theme/DocCardList'; import FormViewer from "@site/src/mdx/FormViewer"; -import YesItem from "./assets/react-components/YesItem"; -import NoItem from "./assets/react-components/NoItem"; -import TableTextSmall from "./assets/react-components/TableTextSmall"; -import userTaskMigrationDecisionHelperForm from "./assets/forms/userTaskMigrationDecisionHelperForm.js"; -import "./assets/css/condensedTable.module.css"; -import styles from "./assets/css/cleanImages.module.css"; -import APIArchitectureImg from './assets/img/api-architecture.png'; -import ZeebeTaskSelectionImg from './assets/img/zeebe-user-task-selection.png'; - -Camunda 8.5 introduces a new [user task](/components/modeler/bpmn/user-tasks/user-tasks.md) implementation type: Zeebe user tasks. -Zeebe user tasks have several benefits, including: +import YesItem from "../tasklist-api-rest/assets/react-components/YesItem"; +import NoItem from "../tasklist-api-rest/assets/react-components/NoItem"; +import TableTextSmall from "../tasklist-api-rest/assets/react-components/TableTextSmall"; +import userTaskMigrationDecisionHelperForm from "../tasklist-api-rest/assets/forms/userTaskMigrationDecisionHelperForm.js"; +import "../tasklist-api-rest/assets/css/condensedTable.module.css"; +import styles from "../tasklist-api-rest/assets/css/cleanImages.module.css"; +import ZeebeTaskSelectionImg from '../tasklist-api-rest/assets/img/zeebe-user-task-selection.png'; + +Camunda 8.5 introduced a new [user task](/components/modeler/bpmn/user-tasks/user-tasks.md) implementation type: Zeebe user tasks. + +Zeebe user tasks have several benefits compared to job worked-based user tasks. It includes: - Running directly on the automation engine for high performance. - Removing dependencies and round trips to Tasklist. -- A more powerful API that supports the full task lifecycle. +- A powerful API that supports the full task lifecycle. In this guide, you will learn: - Under which circumstances and when you should migrate. - How to estimate the impact on a project. -- The steps you need to take for a successful migration without interrupting your operations. +- Steps you need to take for a successful migration without interrupting your operations. ## Decide on your migration path @@ -34,17 +34,6 @@ Zeebe user tasks require migration of the user tasks in both your diagrams and t With this in mind, you can migrate at your own pace. If you should migrate now or later, and what is required to migrate depends on your current setup and future plans. -Use the following decision helper questionnaire to figure out what's right for you: - - - ### Task type differences Learn the differences between both task types and make an informed decision, and understand the new capabilities of Zeebe user tasks. Refer to this table for important high-level differences of the two task types: @@ -58,7 +47,7 @@ Learn the differences between both task types and make an informed decision, and
    Zeebe user tasks
    - Recommended for new projects + Recommended for existing and new projects @@ -91,11 +80,11 @@ Learn the differences between both task types and make an informed decision, and
    Partially
    Queries, GET tasks, forms, variables - ℹ Currently, you must use Zeebe and Tasklist APIs to use Zeebe user tasks + ℹ Currently, you must use the Camunda 8 and Tasklist APIs to use Zeebe user tasks - Supports Zeebe API + Supports Camunda 8 API @@ -123,7 +112,6 @@ Learn the differences between both task types and make an informed decision, and - Task listeners will be introduced in a future release @@ -146,10 +134,9 @@ Learn the differences between both task types and make an informed decision, and Recommendations You can continue to use this task type on existing projects when you have a custom task application running on it and do not require any of the above features. - Refer to the decision helper above for a tailored recommendation. - Use this task type on any new projects when you run Tasklist. + Recommended for existing and new projects when you run Tasklist. Migrate existing projects and task applications/clients to this task type when you require one of the features above, or the following use cases:
      @@ -161,12 +148,11 @@ Learn the differences between both task types and make an informed decision, and
    • Enrich tasks with business data
     - Refer to the decision helper above for a tailored recommendation. -## Switch the implementation type of your user tasks +## Switch the implementation type of user tasks We recommend you migrate process-by-process, allowing you to thoroughly test the processes in your test environments or via your [CI/CD](/guides/devops-lifecycle/integrate-web-modeler-in-ci-cd.md). To do this, take the following steps: @@ -181,176 +167,130 @@ We recommend you migrate process-by-process, allowing you to thoroughly test the Repeat these steps for all user tasks in the process. Then, deploy the process to your development cluster and test it by running the process and ensuring your custom task applications work. -## Use the new Zeebe Task API +## Use the Camunda 8 API :::note The Tasklist REST API is not deprecated, and you still need it for queries on both task types. ::: -Operations on Zeebe user tasks which modify the task state have to be performed using the new Zeebe REST API. However, queries and adjacent operations still require the Tasklist REST API. The following table provides a breakdown of which operations are supported in which API, and for which user tasks. +The following table provides a breakdown of which operations are supported in which API, and for which user tasks. - + - - - + + - - - + + + + + + + + - - + + - - - + + + - - + + - - + + - + - - - + + +
    Operation Tasklist APIZeebe Task API (8.5)Camunda 8 API
    Query tasks✔ All types← Use Tasklist APISupported from 8.6+
    Get task✔ All types← Use Tasklist APIQuery user task✔ Job worker-based user tasks✔ Zeebe user tasks
    Get user task✔ Job worker-based user tasks✔ Zeebe user tasks
    Retrieve task variables✔ All types← Use Tasklist API✔ Job worker-based user tasks✔ Zeebe user tasks
    Get task form✔ All types← Use Tasklist APIGet user task form✔ Job worker-based user tasks✔ Zeebe user tasks
    Change task assignment✔ Job worker-based tasks✔ Zeebe tasks✔ Job worker-based user tasks✔ Zeebe user tasks
    Complete task✔ Job worker-based tasks✔ Zeebe tasks✔ Job worker-based user tasks✔ Zeebe user tasks
    Update task -✔ Zeebe tasks✔ Zeebe user tasks
    Safe and retrieve draft variables✔ All types← Use Tasklist APISave and retrieve draft variables✔ Job worker-based user tasks -
    -You can also operate both task types at the same time in the same application utilizing both APIs. We recommend this for a smooth migration, but you should eventually update all processes to use the new task type to use all benefits. The following image illustrates how to route API calls to the respective APIs: - -Task API Architecture - -The major changes are: - -- Create and maintain new, additional secrets for the Zeebe REST API. -- Call dedicated endpoints on separate components (Zeebe vs. Tasklist) for all state modifications on tasks for the respective task types. -- Manage new request/response objects. - The following table outlines the respective endpoints. Click the endpoints to follow to the API documentation and inspect the differences in the request and response objects. - - - - - - - - - - - - - - - - - - - - - + - + - + - +
    Operation Tasklist APIZeebe Task API (8.5)
    Query tasks - - POST /tasks/search - - ← Use Tasklist API
    Get task - - GET /tasks/:taskId - - ← Use Tasklist API
    Retrieve task variables - - GET /variables/:variableId - -
    - - POST /tasks/:taskId/variables/search - -     		← Use Tasklist API
    Get task form - - GET /forms/:formId - - ← Use Tasklist APICamunda 8 API
    Assign a task - + PATCH /tasks/:taskId/assign - - POST /user-tasks/:taskKey/assignment + + POST /user-tasks/:userTaskKey/assignment
    Unassign a task - + PATCH /tasks/:taskId/unassign - - DELETE /user-tasks/:taskKey/assignee + + DELETE /user-tasks/:userTaskKey/assignee
    Complete task - + PATCH /tasks/:taskId/complete - - POST /user-tasks/:taskKey/completion + + POST /user-tasks/:userTaskKey/completion
    Update task-- - - PATCH /user-tasks/:taskKey + + PATCH /user-tasks/:userTaskKey
    Safe and retrieve draft variablesSave and retrieve draft variables - + POST /tasks/:taskId/variables ← Use Tasklist API-
    @@ -373,9 +313,9 @@ docId:"apis-tools/tasklist-api-rest/tasklist-api-rest-overview" }, { type:"link", -href:"/docs/next/apis-tools/zeebe-api-rest/zeebe-api-rest-overview/", -label: "Zeebe API (REST)", -docId:"apis-tools/zeebe-api-rest/zeebe-api-rest-overview" +href:"/docs/next/apis-tools/camunda-api-rest/camunda-api-rest-overview/", +label: "Camunda 8 API (REST)", +docId:"apis-tools/camunda-api-rest/camunda-api-rest-overview" } ]}/> @@ -383,6 +323,6 @@ docId:"apis-tools/zeebe-api-rest/zeebe-api-rest-overview" If your task application does not work properly after migration, check the following: -- **The endpoints return specific error messages when you run them on the wrong task type**: Ensure to call the right endpoint for the right task type, c.f. above [table](#use-the-new-zeebe-task-api). +- **The endpoints return specific error messages when you run them on the wrong task type**: Ensure to call the right endpoint for the right task type, c.f. above [table](#use-the-new-camunda-8-api). - **Forms do not appear**: Ensure you have extracted embedded forms, if any, and [transformed them into linked forms](/components/modeler/bpmn/user-tasks/user-tasks.md#camunda-form-linked), before you change the task type implementation. - **Task update operation does not work**: The update operation is only available to Zeebe user tasks. diff --git a/versioned_docs/version-8.6/apis-tools/tasklist-api-rest/sidebar-schema.js b/versioned_docs/version-8.6/apis-tools/tasklist-api-rest/sidebar-schema.js index 517c97c4df8..ebb41a15e74 100644 --- a/versioned_docs/version-8.6/apis-tools/tasklist-api-rest/sidebar-schema.js +++ b/versioned_docs/version-8.6/apis-tools/tasklist-api-rest/sidebar-schema.js @@ -7,6 +7,5 @@ module.exports = { { Specifications: require("./specifications/sidebar.js"), }, - "apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks", ], }; diff --git a/versioned_docs/version-8.6/apis-tools/tasklist-api-rest/tasklist-api-rest-overview.md b/versioned_docs/version-8.6/apis-tools/tasklist-api-rest/tasklist-api-rest-overview.md index 94cf88764af..31bedd5f7cd 100644 --- a/versioned_docs/version-8.6/apis-tools/tasklist-api-rest/tasklist-api-rest-overview.md +++ b/versioned_docs/version-8.6/apis-tools/tasklist-api-rest/tasklist-api-rest-overview.md @@ -5,6 +5,12 @@ sidebar_position: 1 description: "Build applications for human-centered processes by querying user tasks, assigning users, and completing tasks with the Tasklist API." --- +:::note +Camunda introduced the [Camunda 8 REST API](/apis-tools/camunda-api-rest/camunda-api-rest-overview.md) with `8.6` to manage and query process entities such as processes, decisions, forms, and user tasks. + +Camunda has also introduced [Zeebe user tasks](/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md) to build more advanced functionalities. If you use Zeebe user tasks with `8.6`, task management endpoints in the Tasklist API will not work. +::: + ## Introduction The Tasklist API is a REST API designed to build task applications for human-centered processes. The API allows you to query user tasks, assign users to these tasks, and complete these tasks. diff --git a/versioned_docs/version-8.6/apis-tools/zeebe-api-rest/tutorial.md b/versioned_docs/version-8.6/apis-tools/zeebe-api-rest/tutorial.md index ec299cbe3a6..2bb1795037a 100644 --- a/versioned_docs/version-8.6/apis-tools/zeebe-api-rest/tutorial.md +++ b/versioned_docs/version-8.6/apis-tools/zeebe-api-rest/tutorial.md @@ -41,7 +41,7 @@ In this tutorial, we will execute arguments to assign and unassign a user to and ## Assign a Zeebe user task (POST) :::note -In this tutorial, you will capture a **Zeebe user task** ID to assign and unassign users in this API. Camunda 8.5 introduced this new [user task](/components/modeler/bpmn/user-tasks/user-tasks.md) implementation type, and these Zeebe user tasks are different from job worker-based user tasks. See more details on task type differences in the [migrating to Zeebe user tasks documentation](/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md#task-type-differences). +In this tutorial, you will capture a **Zeebe user task** ID to assign and unassign users in this API. Camunda 8.5 introduced this new [user task](/components/modeler/bpmn/user-tasks/user-tasks.md) implementation type, and these Zeebe user tasks are different from job worker-based user tasks. See more details on task type differences in the [migrating to Zeebe user tasks documentation](/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md#task-type-differences). ::: First, let's script an API call to assign a Zeebe user task. diff --git a/versioned_docs/version-8.6/components/modeler/bpmn/user-tasks/user-tasks.md b/versioned_docs/version-8.6/components/modeler/bpmn/user-tasks/user-tasks.md index 5212b2a3b2c..90a64a6191c 100644 --- a/versioned_docs/version-8.6/components/modeler/bpmn/user-tasks/user-tasks.md +++ b/versioned_docs/version-8.6/components/modeler/bpmn/user-tasks/user-tasks.md @@ -162,7 +162,7 @@ A user task does not have to be managed by Zeebe. Instead, you can also use job workers to implement a custom user task logic. Note that you will lose all the task lifecycle and state management features that Zeebe provides and will have to implement them yourself. Use job workers only in case you require a very specific implementation of user tasks that can't be implemented on top of Zeebe user tasks. :::info -If you started using Camunda 8 with version 8.4 or a lower version and upgraded to 8.5 or newer, your user tasks are probably implemented as job workers. Refer to the [migration guide](/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md) to find a detailed list of the differences between the task implementation types and learn how to migrate to Zeebe user tasks. +If you started using Camunda 8 with version 8.4 or a lower version and upgraded to 8.5 or newer, your user tasks are probably implemented as job workers. Refer to the [migration guide](/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md) to find a detailed list of the differences between the task implementation types and learn how to migrate to Zeebe user tasks. ::: You can define a job worker implementation for a user task by removing its `zeebe:userTask` extension element. diff --git a/versioned_docs/version-8.6/components/modeler/web-modeler/advanced-modeling/form-linking.md b/versioned_docs/version-8.6/components/modeler/web-modeler/advanced-modeling/form-linking.md index c7cf43464fe..cf43c6b50c5 100644 --- a/versioned_docs/version-8.6/components/modeler/web-modeler/advanced-modeling/form-linking.md +++ b/versioned_docs/version-8.6/components/modeler/web-modeler/advanced-modeling/form-linking.md @@ -89,6 +89,10 @@ To correct any instances affected by this issue, we recommend the following step ### Camunda Form (embedded) +:::info +Embedded forms are supported only by job worker-based user tasks and are not available for the [Zeebe user task implementation type](/components/modeler/bpmn/user-tasks/user-tasks.md#user-task-implementation-types). +::: + When choosing **Camunda Form (embedded)** as type you have the option to directly paste the form's JSON schema into the **Form JSON configuration** field of the properties panel. The form will be embedded directly into the BPMN diagram's XML representation. diff --git a/versioned_docs/version-8.6/reference/release-notes/850.md b/versioned_docs/version-8.6/reference/release-notes/850.md index 43f3806758c..d514f55adca 100644 --- a/versioned_docs/version-8.6/reference/release-notes/850.md +++ b/versioned_docs/version-8.6/reference/release-notes/850.md @@ -108,7 +108,7 @@ The first iteration of this feature brings back existing features from Camunda 7 -The first step to offer an intuitive and consistent experience via a single, [unified Camunda 8 REST API](https://camunda.com/blog/2024/03/streamlining-camunda-apis-zeebe-rest-api/) is to provide the Zeebe REST API. With this release, developers can use the Zeebe REST API to manage [Zeebe user tasks](/apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks.md), enabling immediate task state changes. The Zeebe REST API includes support for Identity authentication and multi-tenancy, ensuring parity to the Zeebe gRPC API. +The first step to offer an intuitive and consistent experience via a single, [unified Camunda 8 REST API](https://camunda.com/blog/2024/03/streamlining-camunda-apis-zeebe-rest-api/) is to provide the Zeebe REST API. With this release, developers can use the Zeebe REST API to manage [Zeebe user tasks](/apis-tools/migration-manuals/migrate-to-zeebe-user-tasks.md), enabling immediate task state changes. The Zeebe REST API includes support for Identity authentication and multi-tenancy, ensuring parity to the Zeebe gRPC API. ### Refactoring suggestions Modeler diff --git a/versioned_sidebars/version-8.6-sidebars.json b/versioned_sidebars/version-8.6-sidebars.json index b78cbba1c69..66f10535b88 100644 --- a/versioned_sidebars/version-8.6-sidebars.json +++ b/versioned_sidebars/version-8.6-sidebars.json @@ -1592,8 +1592,7 @@ ] } ] - }, - "apis-tools/tasklist-api-rest/migrate-to-zeebe-user-tasks" + } ] }, { @@ -1765,8 +1764,14 @@ ] } ] + }, + { + "Migration manuals": [ + "apis-tools/migration-manuals/migrate-to-zeebe-user-tasks" + ] } ], + "Reference": [ "reference/overview", "reference/announcements",