bpmn-io / bpmn-js-properties-panel

A properties panel for bpmn-js.
MIT License
295 stars 197 forks source link

UX of properties panel does not avoid confusion around jobs vs. external tasks and their configuration #494

Open MaxTru opened 3 years ago

MaxTru commented 3 years ago

Describe the Bug

When working with external service task in Camunda Platform, the properties panel offers to configure a Retry Time Cycle. This Cycle is valid for the Job Execution but not for the external service task worker per se.

However, there have been multiple cases where this was confused by users:

Steps to Reproduce

  1. Configure an external service task in camunda platform
  2. Add async before or async after
  3. Take a look at the appearing job execution section image

Expected Behavior

There are probably two aspects to this:

  1. The documentation should clearly explain that jobs and external tasks are two different concepts. The configuration in the prop panel relates to the job (and not the external task).
  2. The properties panel should make this clearer (e.g., link to docs? description?)

This issue is meant to find a solution for 2.

Environment

Any

MaxTru commented 3 years ago

Discussed with @andreasgeier , will move to backlog for now