Skip to content

Commit 10b3701

Browse files
committed
docu
1 parent e0483aa commit 10b3701

18 files changed

Lines changed: 1206 additions & 769 deletions

src/site/markdown/modelling/index.md

Lines changed: 26 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -21,28 +21,46 @@ connected (with, e.g. Sequence Flows, Associations, Data Flows, etc.) by selecti
2121

2222
The Tool Palette is, by default, located along the right edge of the Drawing Canvas. It consists of several standard BPMN2 elements that can be dragged onto the Drawing Canvas. The Imixs-BPMN plug-in provides a separate section called "Imixs-Workflow". This category contains the extension which allows you to annotate a BPMN Task or a Catch Event. The extension can be dragged like any other BPMN element onto a Task or Catch Event.
2323

24+
### Property Panel
25+
26+
On the bottom of the Drawing Canvas you have a property panel to edit the details of a BPMN element. To open the property panel you can double click an element or use the expand icon on the left side of the property panel header.
27+
28+
<img src="../images/modelling/open-bpmn_screen_02.png"/>
29+
2430
### The Workflow-Task
2531

26-
<img src="../images/modelling/bpmn_screen_04.png"/>
32+
<img src="../images/modelling/bpmn_task.png"/>
2733

2834
The "Workflow-Task" is used to describe a Task inside a process model controlled by the Imixs-Workflow engine. The Task Element typically reflects a task to be processed by a participant during the process life-cycle of a process instance. A Imixs Workflow-Task contains a custom set of properties used to describe the status of a process instance. Read more about the Task Element in the [section Task Properties](process.html). The "Workflow-Task" Element is an extension to the BPMN 2.0 Element "Task".
2935

3036
### The Workflow-Event
3137

32-
<img src="../images/modelling/bpmn_screen_05.png"/>
38+
<img src="../images/modelling/bpmn_event.png"/>
3339

3440
The "Workflow-Event" is used to describe a transition from one Task into another. The Event Element contains a custom set of properties to be evaluated during the execution by the Imixs-Workflow engine. Read more about the Event Element in the [section Event Properties](activities.html). The "Workflow-Event" is an extension to the BPMN 2.0 Intermediate CatchEvent.
3541

36-
## Examples
42+
### The Pools
3743

38-
In the section ['How to model'](howto.html) you will find examples how you can model your business logic with Imixs-BPMN.
44+
You can place BPMN elements directly on the Drawing Canvas or into a BPMN Pool element.
45+
BPMN Pools are used to group different worklfow groups into one model.
3946

40-
## Support & Community
47+
<img src="../images/modelling/bpmn_pools.png"/>
4148

42-
Imixs-BPMN and Open-BPMN are open source projects. You will find further information about the project here:
49+
### The Imixs Workflow Extension
4350

44-
- [Open-BPMN](https://www.open-bpmn.org/)
51+
To adapt a Task or Event element to be processed by the Imixs-Workflow Engine you need to add the extension from the Tool Palette to a Task or Catch Event:
4552

46-
- [GitHub](https://github.com/imixs/open-bpmn).
53+
<img src="../images/modelling/bpmn_imixs-extension.png"/>
54+
55+
This will extend the corresponding BPMN element with additional Properties used by the Imixs Workflow engine during the processing cycle. An BPMN element which is not annotated with the Imixs-Workflow extension will be ignored during the processing life-cycle.
4756

57+
You can recognize the extension by the additional yellow border of the element and by the additional properties in the property panel.
58+
59+
## What's Next...
60+
61+
Read more about Imixs BPMN:
62+
63+
- [How To Model](./howto.html)
64+
- [Open-BPMN](https://www.open-bpmn.org/)
65+
- [GitHub](https://github.com/imixs/open-bpmn).
4866
- [Discussion](https://github.com/imixs/open-bpmn/discussions)

src/site/markdown/modelling/process.md

Lines changed: 35 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,55 @@
11
# The Imixs-BPMN Task Element
22

33
When a Imixs BPMN Task Element is selected in the Drawing Canvas, different settings can be
4-
configured from the tabbed property sheets displayed in the Property View.
4+
configured from the tabbed property sheets displayed in the Property panel.
55

6-
<img src="../images/modelling/bpmn_screen_04.png"/>
6+
<img src="../images/modelling/bpmn_task.png"/>
77

88
The property settings are grouped into different sections.
99

1010
## General Properties
1111

12-
The property tab 'General' of a 'Task' element defines basic BPMN attributes.
12+
<img src="../images/modelling/bpmn_task_properties_01.png" />
1313

14-
<img src="../images/modelling/bpmn_screen_16.png" />
14+
The property tab 'General' of a 'Task' element defines basic BPMN attributes.
1515

16-
### Name
16+
| Property | BPMN Attribute | Type | Description |
17+
| ------------- | ------------------- | ------ | ------------------------ |
18+
| name | name | String | name of the task element |
19+
| documentation | bpmn2:documentation | String | short description |
1720

18-
The _name_ of the Task element is used as an human readable status identifier.
19-
The _name_ describes the status of a process instance within the process model (e.g. "open" or "approval" "closed").
21+
The _name_ of the Task element is used as an human readable status identifier. It describes the status of a process instance within the process model (e.g. "New Open", "In Approval", "Completed",...).
2022

21-
**Note:** Inernally each Task Element in a BPMN model has an unambiguously identifier called the _ID_. The _ID_ is assigned to a running process instance to identify the status of a WorkItem controlled by the Workflow Engine.
23+
The documentation can provide information how the task should be performed or which information need to be entered into a application.
2224

23-
### Documentation
25+
## Workflow
2426

25-
The documentation of the Task element is used by the Imixs Workflow System to provide the user
26-
with additional information about the task. Typically a documentation can provide information how the task should be performed or which information need to be entered into a application.
27+
<img src="../images/modelling/bpmn_task_properties_02.png"/>
2728

29+
The Tab 'Workflow' provides identifiers and additional properties used by the Imixs Workflow System to uniquly identify a task by its ID within the current workflow and to provide the user with additional information about the task.
2830
The documentation can also be created by assigning a TextAnnotation element to the task. In this case the documentation field of the Task should remain empty.
2931

30-
<img src="../images/modelling/bpmn_screen_33.png" />
32+
| Property | BPMN Attribute | Type | Description |
33+
| ---------- | ----------------- | ------- | ---------------------------------------------------- |
34+
| Process ID | imixs:processid | Integer | unique task identifier within the model |
35+
| Type | application.type | String | type definition to be assigned to a process instance |
36+
| Symbol | application.icon | String | Status icon to be assigned to a process instance |
37+
| Summary | workflow.summary | String | The definition of a workflow summary |
38+
| Abstract | workflow.abstract | String | The definition of a workflow abstract |
3139

32-
| Property | Type | Description |
33-
| ------------- | ------- | --------------------------------------- |
34-
| id | Integer | unique task identifier within the model |
35-
| name | String | name of the task element |
36-
| documentation | String | short description |
40+
### Process ID
3741

38-
## Workflow Properties
42+
Every Imixs Task Element has an unambiguously identifier called the _TaskID_. The _TaskID_ is assigned to a running process instance to identify the status of a WorkItem controlled by the Imixs Workflow Engine.
3943

40-
The Tab 'Workflow' contains Processing Information of a Task element. These information will be
41-
updated after a WorkItem was processed by the Workflow Engine.
44+
**Note:** The task ID of each Task Element must be unique within one model.
4245

43-
<img src="../images/modelling/bpmn_screen_17.png"/>
46+
### WorkItem Type
4447

45-
### ID
48+
The 'WorkItem Type' is a category assigned to the WorkItem by the Workflow Engine when the WorkItem was processed.
4649

47-
Every Imixs Task Element has an unambiguously identifier called the _TaskID_. The _TaskID_ is assigned to a running process instance to identify the status of a WorkItem controlled by the Imixs Workflow Engine.
50+
### Symbol - Status Icon
51+
52+
A 'Status Icon' can be a Image URL to visualize the current status of a WorkItem.
4853

4954
### Workflow Summary
5055

@@ -64,40 +69,26 @@ The Abstract is similar to the Workflow Summary and can also be dynamically comp
6469

6570
See the [Text Replacement feature](./textreplacement.html) how to insert WorkItem Values into a message text.
6671

67-
| Property | Type | Description |
68-
| ----------------- | ------ | ------------------------------------- |
69-
| workflow.summary | String | The definition of a workflow summary |
70-
| workflow.abstract | String | The definition of a workflow abstract |
71-
7272
## Application Properties
7373

74+
<img src="../images/modelling/bpmn_task_properties_03.png"/>
75+
7476
The Property Tab 'Application' defines information used to control the behavior of a WorkItem in the workflow application.
7577

76-
<img src="../images/modelling/bpmn_screen_18.png"/>
78+
| Property | Type | Description |
79+
| ------------------ | ------ | --------------------------------------------------- |
80+
| application.editor | String | Form editor id to be assigned to a process instance |
81+
| application.form | String | A form description (xml) |
7782

7883
### Input Form
7984

8085
The 'Input Form' can be used to control how a WorkItem in a specific status is displayed or how it can be edited inside the workflow application. This allows the model to control the behavior of the application in a specific way.
8186

82-
### Status Icon
83-
84-
A 'Status Icon' can be a Image URL to visualize the current status of a WorkItem.
85-
86-
### WorkItem Type
87-
88-
The 'WorkItem Type' is a category assigned to the WorkItem by the Workflow Engine when the WorkItem was processed.
89-
90-
| Property | Type | Description |
91-
| ------------------ | ------ | ---------------------------------------------------- |
92-
| application.editor | String | Form editor id to be assigned to a process instance |
93-
| application.icon | String | Status icon to be assigned to a process instance |
94-
| application.type | String | type definition to be assigned to a process instance |
95-
9687
## ACL Properties
9788

9889
The ACL defines the read-, write- and ownership, an actor will be granted for, after processing a WorkItem.
9990

100-
<img src="../images/modelling/bpmn_screen_31.png"/>
91+
<img src="../images/modelling/bpmn_task_properties_04.png"/>
10192

10293
Actors play an essential role within a human-centric workflow system.
10394
In Imixs-Workflow the actors can be defined statically by adding user- or group IDs, or the ACL can be dynamically computed based on the properties of a process instance.

0 commit comments

Comments
 (0)