mirror of
https://github.com/sartography/spiff-arena.git
synced 2025-01-14 19:44:25 +00:00
c904ee907b
01a25fc3f Merge pull request #333 from sartography/feature/ruff 99c7bd0c7 ruff linting fixes 56d170ba1 Cleaning up badges in the readme. 51c13be93 tweaking action, adding button 96275ad7c Adding a github action to run tests c6c40976a minor fix to please sonarcloud. 03316babb Merge pull request #332 from sartography/updates-for-2.0-release ab70a34b5 Release Notes for 2.0.0_rc1 f0bf79bd9 copy edits a7c726951 Release Notes for 2.0.0_rc1 5f0468ba4 Merge pull request #330 from sartography/updates-for-2.0-release b9ad24406 Mostly minor edits e284dd8e2 corrections and tweaks to documentation 4b2e62600 add more examples 1ea258c6a update spiffworkflow concepts 851d7cdf6 fix a few bugs I found while testing the example repo 7a0a6bdf8 update bpmn docs 07c153f2d save/restore nested subprocess tests 340e9983b Merge branch 'main' of github.com:sartography/spiffworkflow into main 618afbc59 It is rare to submit an update that touches upon both religion and the origins of the universe. I think, for the sake of supporting all view points we must offer the possibility that there can be a thing that is not a child, but rather the beginning of all childen, that there is a chicken to the first egg, a single original big bank. a68dec77e use raw strings for regexes using escape sequences w/ burnettk 4644f2810 Merge pull request #329 from sartography/task/remove-deprecated-functions ca65602c0 correct typo in filename 39ab83f1f remove one deprecated and unused feature 23d54e524 Merge pull request #328 from sartography/improvement/task-spec-attributes 544614aa9 change dmn bpmn_id method to property 12ad185a4 update bpmnworkflow.waiting_events to use classname aec77097d fix some typos & add a few missing licenses 4b87c6d0c add some changes that didn't get included in the merge commit 965a5d4e1 Merge branch 'main' into improvement/task-spec-attributes a844b34f9 alternate bomnworkflow.cancel 0a455cdd2 Merge pull request #327 from sartography/feature/mark_tasks_in_sub_workflows_as_future_if_reseting_to_a_task_before_subworkflow 2bda992aa cancel tasks in subprocesses and return cancelled tasks 309937362 take account that we reset the parent when checking all sub-process executions. d4bcf1290 handle nested subprocesses when resetting tasks 032bedea6 reset subprocess task when resetting a task inside the subprocess 3a6abe157 change reset workflow to drop tasks and re-predict e9cd65757 move exceptions for bpmn into bpmn package e654f2ff1 add bpmn_id and bpmn_name attributes to task specs 74bb9cf1a Found that tasks within a sub-workflow were left in a state of "READY" after resetting to task before the sub-workflow. 957a8faec make all task specs in bpmn processes bpmn tasks b6070005c create actual mixin classes & improve package structure 666a9e4e5 Merge pull request #326 from sartography/feature/boundary_event_reset_fix 9fe5ae4ad Whenever a task is reset who's parent is a "_ParentBoundaryEvent" class, reset to that parent boundary event instead, and execute it, so that all the boundary events are reset to the correct point as well. fbc071af5 remove 'is_engine_step' and use existing 'manual' attribute instead 0d8e53a25 remove unused attributes, minor parser improvements 6ae98b585 Merge pull request #325 from sartography/bugfix/make-data-objects-available-to-gateways cefcd3733 make data objects available to gateways 6060fe778 Merge pull request #324 from sartography/task/update-license efa24bed2 update license 56271f7f7 Merge pull request #323 from sartography/bugfix/handle-dash-in-dmn 6de4e7e01 Merge pull request #322 from sartography/improvement/remove-celery 6ee0668cb remove unnecessary dependencies in test 7ceae68c2 change literal '-' in DMN input to None 4cffc7e7a remove celery task and dependency 580d6e516 Merge pull request #321 from sartography/improvement/allow-duplicate-subprocess-names e4440d4df remove legacy signavio parser 477a23184 remove absolute imports from tests failing in CI 15a812a92 use process ids only when storing process specs abaf1b9e9 move parallel gateway tests to their own package 29fd2d0d9 remove some redundant, unused, or unnecessary tests & consolidate others fda1480bc remove unused CORRELATE attribute from tests 21a2fdbee remove signavio files 299c2613c Merge pull request #320 from sartography/parser_funcs 01afc9f6e PR feedback 646737834 Cleanup dfd3f8214 Add same methods for dmn 764e33ccd Rename file, fix tests 9646abca4 Add bpmn in memory parser functions and tests 58f6bd317 Merge pull request #319 from sartography/feature/better_task_order_for_sub_processes fd7c9308f By swapping the order of these lines, we can assure that a call activity is returned BEFORE the tasks that it contains, rather than after it. 0a7ec19d6 Merge pull request #318 from sartography/feature/optionally-skip-call-activities-when-parsing 3430a2e9f add option to skip parsing call activities 1b1da1dd2 Merge pull request #317 from sartography/bugfix/non-bpmn-tutorial e82345d68 remove some bpmn-related stuff from core serializer 6f9bc279c use name for inputs/outputs in base serializer -- not sure why this was ever changed git-subtree-dir: SpiffWorkflow git-subtree-split: 01a25fc3f829786c4b65d19fd0fda408de37c79f
99 lines
4.4 KiB
ReStructuredText
99 lines
4.4 KiB
ReStructuredText
Data
|
|
====
|
|
|
|
BPMN Model
|
|
----------
|
|
|
|
We'll be using the following files from `spiff-example-cli <https://github.com/sartography/spiff-example-cli>`_.
|
|
|
|
- `bpmn-spiff/events <https://github.com/sartography/spiff-example-cli/blob/main/bpmn/tutorial/events.bpmn>`_ workflow
|
|
- `bpmn-spiff/call_activity <https://github.com/sartography/spiff-example-cli/blob/main/bpmn/tutorial/call_activity.bpmn>`_ workflow
|
|
- `bpmn-spiff/data_output <https://github.com/sartography/spiff-example-cli/blob/main/bpmn/tutorial/data_output.bpmn>`_ workflow
|
|
- `product_prices <https://github.com/sartography/spiff-example-cli/blob/main/bpmn/tutorial/product_prices.dmn>`_ DMN table
|
|
- `shipping_costs <https://github.com/sartography/spiff-example-cli/blob/main/bpmn/tutorial/shipping_costs.dmn>`_ DMN table
|
|
|
|
|
|
Data Objects
|
|
^^^^^^^^^^^^
|
|
|
|
Data Objects exist at the process level and are not visible in the diagram, but when you create a Data Object
|
|
Reference, you can choose what Data Object it points to.
|
|
|
|
.. figure:: figures/data/data_object_configuration.png
|
|
:scale: 50%
|
|
:align: center
|
|
|
|
Configuring a Data Object Reference
|
|
|
|
When a Data Output association (a line) is drawn from a task to a Data Object Reference, the value is copied
|
|
from the task data to the workflow data and removed from the task. If a Data Input Association is created from
|
|
a Data Object Reference, the value is temporarily copied into the task data while the task is being executed,
|
|
and immediate removed afterwards.
|
|
|
|
This allows sensitive data to be removed from individual tasks (in our example, the customer's credit card
|
|
number). It can also be used to prevent large objects from being repeatedly copied from task to task.
|
|
|
|
Multiple Data Object References can point to the same underlying data. In our example, we use two references
|
|
to the same Data Object to pass the credit card info to both tasks that require it. On the right panel, we can
|
|
see that only one data object exists in the process.
|
|
|
|
.. figure:: figures/data/data_objects.png
|
|
:scale: 30%
|
|
:align: center
|
|
|
|
Data objects in a process
|
|
|
|
If you step through this workflow, you'll see that the card number is not contained in the task data after
|
|
the 'Enter Payment Info' has been completed but is available to the 'Charge Customer' task later on.
|
|
|
|
Running The Model
|
|
*****************
|
|
|
|
If you have set up our example repository, this model can be run with the following command:
|
|
|
|
.. code-block:: console
|
|
|
|
./spiff-bpmn-runner.py -c order_collaboration \
|
|
-d bpmn/tutorial/product_prices.dmn bpmn/tutorial/shipping_costs.dmn \
|
|
-b bpmn/tutorial/events.bpmn bpmn/tutorial/call_activity.bpmn
|
|
|
|
|
|
Data Inputs and Outputs
|
|
^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
In complex workflows, it is useful to be able to specify required Data Inputs and Outputs, especially for Call Activities
|
|
given that they are external and might be shared across many different processes.
|
|
|
|
When you add a Data Input to a Call Activity, SpiffWorkflow will check that a variable with that name is available to
|
|
be copied into the activity and copy *only* the variables you've specified as inputs. When you add a Data Output,
|
|
SpiffWorkflow will copy *only* the variables you've specified from the Call Activity at the end of the process. If any
|
|
of the variables are missing, SpiffWorkflow will raise an error.
|
|
|
|
Our product customization Call Activity does not require any input, but the output of the process is the product
|
|
name and quantity. We can add corresponding Data Outputs for those.
|
|
.. figure:: figures/data/data_output.png
|
|
:scale: 30%
|
|
:align: center
|
|
|
|
Data Outputs in a Call Activity
|
|
|
|
If you use this version of the Call Activity and choose a product that has customizations, when you inspect the data
|
|
after the Call Activity completes, you'll see that the cutomizations have been removed. We won't continue to use this
|
|
version of the Call Activity, because we want to preserve all the data.
|
|
|
|
.. note::
|
|
|
|
The BPMN spec allows *any* task to have Data Inputs and Outputs. Our modeler does not provide a way to add them to
|
|
arbitrary tasks, but SpiffWorkflow will recognize them on any task if they are present in the BPMN XML.
|
|
|
|
Running The Model
|
|
*****************
|
|
|
|
If you have set up our example repository, this model can be run with the following command:
|
|
|
|
.. code-block:: console
|
|
|
|
./spiff-bpmn-runner.py -p order_product \
|
|
-d bpmn/tutorial/product_prices.dmn bpmn/tutorial/shipping_costs.dmn \
|
|
-b bpmn/tutorial/top_level.bpmn bpmn/tutorial/data_output.bpmn
|