Basics content add (#310)

* Basics content add
* Fixing the stylesheet so forms wrap correctly.

---------

Co-authored-by: danfunk <daniel.h.funk@gmail.com>
This commit is contained in:
usama9500 2023-06-08 17:27:58 +05:00 committed by GitHub
parent ffe153be8e
commit ab5fa70e41
15 changed files with 33 additions and 52 deletions

View File

@ -1,48 +0,0 @@
# BPMN Unit Tests
Software Engineers test their code.
With this feature, BPMN authors can test their creations, too.
These tests can provide you with faster feedback than you would get by simply running your process model, and they allow you to mock out form input and service task connections as well as provide specific input to exercise different branches of your process model.
BPMN unit tests are designed to give you greater confidence that your process models will work as designed when they are run in the wild, both the first time they are used by real users and also after you make changes to them.
## Creating BPMN Unit Tests
First, create a process model that you want to test.
Navigate to the process model and add a JSON file based on the name of one of the BPMN files.
For example, if you have a process model that includes a file called `awesome_script_task.bpmn`, your test JSON file would be called `test_awesome_script_task.json`.
If you have multiple BPMN files you want to test, you can have multiple test JSON files.
The BPMN files you test do not have to be marked as the primary file for the process model in question.
The structure of your json should be as follows:
{
"test_case_1": {
"tasks": {
"ServiceTaskProcess:service_task_one": {
"data": [{ "the_result": "result_from_service" }]
}
},
"expected_output_json": { "the_result": "result_from_service" }
}
}
The top-level keys should be names of unit tests.
In this example, the unit test is named "test_case_1."
Under that, you can specify "tasks" and "expected_output_json."
Under "tasks," each key is the BPMN id of a specific task.
If you are testing a file that uses Call Activities and therefore calls other processes, there can be conflicting BPMN ids.
In this case, you can specify the unique activity by prepending the Process id (in the above example, that is "ServiceTaskProcess").
For simple processes, "service_task_one" (for example) would be sufficient as the BPMN id.
For User Tasks, the "data" (under a specific task) represents the data that will be entered by the user in the form.
For Service Tasks, the data represents the data that will be returned by the service.
Note that all User Tasks and Service Tasks must have their BPMN ids mentioned in the JSON file (with mock task data as desired), since otherwise we won't know what to do when the flow arrives at these types of tasks.
The "expected_output_json" represents the state of the task data that you expect when the process completes.
When the test is run, if the actual task data differs from this expectation, the test will fail.
The test will also fail if the process never completes or if an error occurs.
## Running BPMN Unit Tests
Go to a process model and either click “Run Unit Tests” to run all tests for the process model or click on the “play icon” next to a "test_something.json" file.
Then you will get a green check mark or a red x.
You can click on these colored icons to get more details about the passing or failing test.

Binary file not shown.

After

Width:  |  Height:  |  Size: 449 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 561 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 400 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.5 KiB

View File

@ -15,19 +15,37 @@ BPMN (Business Process Model and Notation) elements are the building blocks used
### Tasks
Tasks represent activities or work that needs to be performed as part of a process. They can be manual tasks that require human intervention or automated tasks that are executed by systems or applications.
| **Element** | **Symbol** | **Description** |
| **Task** | **Symbol** | **Description** |
|---------------|------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Service | <div style="width:100px"></div> ![Untitled](images/04-BPMN-Service-Task.png) | Task that uses a Web service, an automated application, or other kinds of service in completing the task. |
| Send | <div style="width:100px"></div>![Untitled](images/06-BPMN-Send-Task.png) | Task that sends a Message to another pool. The Task is completed once the Message has been sent. |
| Receive | <div style="width:100px"></div>![Untitled](images/23-BPMN-Receive-Task.png) | A Receive Task indicates that the process has to wait for a message to arrive in order to continue. The Task is completed once the message has received. |
| User | ![Untitled](images/08-BPMN-User-Task.png) | A User Task represents that a human performer performs the Task with the use of a software application. |
| Manual | ![Untitled](images/10-BPMN-Manual-Task.png) | A Manual Task is a Task that is performed without the aid of any business process execution engine or any application. |
| Business Rule | ![Untitled](images/12-BPMN-Business-Rule-Task.png) | Business Rule Task is newly added in BPMN 2.0. It provides a mechanism for a process to provide input to a Business Rules Engine and then obtain the output provided by the Business Rules Engine. |
| Script | ![Untitled](images/14-BPMN-Script-Task.png) | A Script Task is executed by a business process engine. The task defines a script that the engine can interpret. | |
| Business Rule | ![Untitled](images/12-BPMN-Business-Rule-Task.png) | Business Rule Task provides a mechanism for a process to provide input to a Business Rules Engine and then obtain the output provided by the Business Rules Engine. |
| Script | ![Untitled](images/14-BPMN-Script-Task.png) | A Script Task defines a script that the engine can interpret. | |
### Events
Events, represented with circles, describe something that happens during the course of a process. There are three main events within business process modeling: start events, intermediate events, and end events.
| **Event** | **Symbol**| **Description** |
|---------------|-----------|-----------------|
| Start Event |![Untitled](images/BPMN_start_event-47x47.png) | Signals the first step of a process |
| Intermediate Event | ![Untitled](images/BPMN_intermediate_event-47x48.png) | Represents any event that occurs between a start and end event. |
| End event | ![Untitled](images/BPMN_end_event-50x51.png) | Signals the final step in a process. |
### Gateways
Gateways represent decision points in a process. They determine which path the process will take based on certain conditions or rules. There are different types of gateways, such as exclusive gateways (XOR), inclusive gateways (OR), and parallel gateways (AND).
Gateways represent decision points in a process. They determine which path the process will take based on certain conditions or rules. There are different types of gateways:
| **Gateway** | **Symbol**| **Description** |
|---------------|-----------|-----------------|
| Exclusive gateway |![Untitled](images/exclusive-gateway-55x54.png) | Evaluates the state of the business process and, based on the condition, breaks the flow into one or more mutually exclusive paths |
| Event-based gateway | ![Untitled](images/event-based-gateway-52x54.png) | An event-based gateway is similar to an exclusive gateway both involve one path in the flow. In the case of an event-based gateway, however, you evaluate which event has occurred, not which condition has been met. |
| Parallel gateway | ![Untitled](images/parallel-gateway-57x57.png) | Parallel gateways are used to represent two tasks in a business flow. A parallel gateway is used to visualize the concurrent execution of activities. |
| Parallel event-based gateway | ![Untitled](images/parallel-event-based-gateway-52x53.png) | This gateway is similar to a parallel gateway. It allows for multiple processes to happen at the same time, but unlike the parallel gateway, the processes depend on specific events. |
| Inclusive gateway | ![Untitled](images/inclusive-gateway-54x53.png) | An inclusive gateway breaks the process flow into one or more flows. |
| Complex gateway | ![Untitled](images/complex-gateway-53x53.png) | complex gateways are only used for the most complex flows in the business process. They use words in place of symbols and, therefore, require more descriptive text. |
| |
### Flows
Flows represent the sequence or direction of activities in a process. There are different types of flows in BPMN, including sequence flows, message flows, and association flows. Sequence flows indicate the order in which tasks are performed, message flows represent the exchange of messages between participants, and association flows connect data objects or artifacts to activities.

View File

@ -0,0 +1,11 @@
.wy-table-responsive table td {
white-space: normal !important;
}
.wy-table-responsive {
overflow: visible !important;
}
html.writer-html5 .rst-content table.docutils td>p, html.writer-html5 .rst-content table.docutils th>p {
line-height: 1.5rem;
}