The Attributes panel displays the settings of a selected BPMN element. You can use the panel to manage the element's attributes. You can also drag & drop attributes from the panel to the pane to display them in the diagram. If you use the panel preset, the attributes panel is displayed in the middle of the left sidebar:
To return to the panel preset, go to the user preferences and use button Reset Panels.
Refer to Customizing Editors and Panels for detailed information about panel management in general.
The attributes of the BPMN model itself are shown if you click on the empty diagram pane:
The standard attributes for BPMN elements are:
-
Name
-
Description
Some elements have specific attributes:
-
Form (User Task)
-
Image (Image (BPMN))
-
Roles (Lane)
-
Sequence Flow Type (Relation)
-
Timeout (Timer Event)
-
Timer (Timer Start Event)
-
Trigger Events (User Task, Plain Event, Message Event)
Refer to Styling BPMN Elements for detailed informations about the styling options for BPMN elements.
Managing the Attributes' Content
In the attributes panel, all attributes of an element are displayed. Some standard attributes are used for all elements, while other attributes are only available for specific elements. Find below a list of all attributes.
Standard Attributes
|
Attribute Name |
Description |
Availability |
|---|---|---|
|
Name |
Click here to insert or change the Name of the related element. Generated elements (like e.g. message) cannot be renamed. |
All BPMN elements. |
|
Description |
If you want to insert a description for your element, click here to open a text editor where you can enter and format your text:
|
All BPMN elements. |
Specific Attributes
|
Attribute Name |
Description |
Availability |
|---|---|---|
|
Form |
Attribute Form is only available for the element User Task. Use the selection list to assign a form to the user task. All forms you have created within the same service are displayed in the list:
Once you have selected a form, an icon appears. It allows you to open the selected form directly: Refer to chapter Modeling Forms for further information about the creation of forms. |
|
|
Image |
It is possible to create images on the diagram pane. Use element Image (BPMN) from the elements toolbar. Once created, use the element’s attribute Image to upload a picture into the empty frame or insert a link to an existing picture. Use option X to delete the field content. |
|
|
Roles
|
Attribute Roles is only available for the element Lane. Click Open role editor to assign different roles to the lane. The number of roles assigned to a lane is then displayed in the attributes panel. |
|
|
Sequence Flow Type |
Attribute Sequence Flow Type is only available for the element Relation. Most relations can only be of regular type. In these cases the sequence flow type Regular is displayed in read-only mode. There is one exception for outgoing flows of exclusive gateways:
|
|
|
Timeout |
Attribute Timeout is only available for the Timer Event. To set the duration of the timer, the event should be trigged by a persisted property of type integer or datetime. You have two options to set the timeout in the attributes panel:
|
|
|
Timer |
Attribute Timer is only available for the Timer Start Event. To define the timer settings, click Open Timer to open the timer editor. For detailed explanations see How to Use the Scheduler/Timer.
|
|
|
Trigger Events
|
Attribute Trigger Events is only available for the elements Message Event and Plain Event (as a boundary event) and for the element User Task. Use the selection list to assign which event triggers the default process flow of a BPMN process. Use the filter to search for a specific event:
|
How to Use the Scheduler/Timer
If you use option Open timer in the attribute panel, a separate editor will open where you can define the settings of your Timer Start Event. You have two options with different settings:
-
Scheduler (see below)
-
Timer (see below)
Scheduler
Use the scheduler if you want to define a pattern for your Timer Start Event, for example to start the model every monday, every hour etc. You can enter the desired duration as a valid cron expression with 7 values directly in field Time Duration. If you are not familiar with the formatting, open the field in edit mode:
An easy-to-use editor helps you put together the time pattern. Your entries in the fields below are combined into a time pattern that is displayed on top of the editor. You can use option Copy to copy this pattern to the clipboard:
Your changes will be saved when you exit edit mode or click Save at the bottom.
|
Setting |
Description |
Default |
|---|---|---|
|
Time Duration |
Open this field in edit mode to enter the desired duration as a valid cron expression with 7 values.
Click Learn more about time patterns to open our documentation page Date and Time Scheduling Patterns. |
0 0 * * * * * |
|
Seconds |
Use 0 to 59 or a pattern. |
0 |
|
Minutes |
Use 0 to 59 or a pattern. |
0 |
|
Hours |
Use 0 to 23 or a pattern. |
* |
|
Days |
Depending on the month, valid input are numbers from 1 to 31 or a pattern. |
* |
|
Weekdays |
Valid input:
|
* |
|
Months |
Use numbers 1 to 12 or a pattern. |
* |
|
Years |
Insert a positive integer or a pattern. |
* |
|
Allow Parallel Executions |
If checked, each time a scheduler pattern matches, the scheduler activity diagram is executed - even if another execution is already running.
|
Enabled |
Timer
Select the timer if you want to define an interval, e.g. to start the model after one week, after two hours etc. You can enter the desired interval as a valid duration expression directly in field Repeat Interval. If you are not familiar with the formatting, open the field in edit mode (the same applies to field First Occurrence):
An easy-to-use editor helps you put together the duration expression. Your entries in the fields below are combined into a duration expression that is displayed on top of the editor. You can use option Copy to copy this expression to the clipboard:
Your changes will be saved when you exit edit mode or click Save at the bottom.
|
Setting |
Description |
Default |
|---|---|---|
|
Repeat Interval |
Defines the time interval between two calls of the timer action. Open this field in edit mode to enter the desired interval as a valid duration expression. If you are familiar with the formatting, you can also insert the duration expression directly in the field. Click Learn more about time durations to open our documentation page Time Durations. |
- |
|
First Occurence |
Defines the wait interval after service start before the timer is executed for the first time. Open this field in edit mode to enter the desired wait interval as a valid duration expression. If you are familiar with the formatting, you can also insert the duration expression directly in the field. Click Learn more about time durations to open our documentation page Time Durations. |
0 seconds |
|
Unlimited Timer Event Occurrences |
If you want the timer to be endless, select this option. |
Enabled |
|
Limit Occurrences to |
If you want to define a count of repetitions, select this option. Insert a positive integer in the displayed field:
|
Disabled |