You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: specification.md
-72Lines changed: 0 additions & 72 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -467,7 +467,6 @@ which would set the workflow version to `1.0.0`.
467
467
| description | Workflow description | string | no |
468
468
| version | Workflow version | string | no |
469
469
| schemaVersion | Workflow schema version | string | no |
470
-
|[dataSchema](#DataSchema-Definition)| Workflow data schema. Allows to set expected structure of workflow data input and output | object | no |
471
470
|[execTimeout](#ExecTimeout-Definition)| Defines the execution timeout for a workflow instance | object | no |
472
471
| keepActive | If "true", workflow instances is not terminated when there are no active execution paths. Instance can be terminated with "terminate end definition" or reaching defined "execTimeout" | boolean | no |
473
472
|[events](#Event-Definition)| Workflow event definitions. | array or string | no |
@@ -971,53 +970,6 @@ says that these events must all have a context attribute named "department" with
971
970
This allows developers to write orchestration workflows that are specifically targeted to patients that are in the hospital urgent care unit,
972
971
for example.
973
972
974
-
#### DataSchema Definition
975
-
976
-
| Parameter | Description | Type | Required |
977
-
| --- | --- | --- | --- |
978
-
| input | URI to JSON Schema that workflow/state data input should adhere to | string | no |
979
-
| output | URI to JSON Schema that workflow/state data output should adhere to | string | no |
980
-
981
-
<details><summary><strong>Click to view example definition</strong></summary>
982
-
<p>
983
-
984
-
<table>
985
-
<tr>
986
-
<th>JSON</th>
987
-
<th>YAML</th>
988
-
</tr>
989
-
<tr>
990
-
<td valign="top">
991
-
992
-
```json
993
-
{
994
-
"input": "http://myschemas.io/inputschema.json",
995
-
"output": "http://myschemas.io/outputschema.json"
996
-
}
997
-
```
998
-
999
-
</td>
1000
-
<td valign="top">
1001
-
1002
-
```yaml
1003
-
input: http://myschemas.io/inputschema.json
1004
-
output: http://myschemas.io/outputschema.json
1005
-
```
1006
-
1007
-
</td>
1008
-
</tr>
1009
-
</table>
1010
-
1011
-
</details>
1012
-
1013
-
DataSchema definition allows you to reference an input and/or output [JSON Schema](https://json-schema.org/).
1014
-
It can be used to describe the expected structure of workflow data input and data output.
1015
-
If used within a workflow state, it can be used to describe the expected structure of the state
1016
-
data input and data output.
1017
-
1018
-
The `input` property is an URI to a JSON Schema describing the expected structure of the data input.
1019
-
The `output` property is an URI to a JSON Schema describing the expected structure of the data output.
1020
-
1021
973
#### Correlation Definition
1022
974
1023
975
| Parameter | Description | Type | Required |
@@ -1100,7 +1052,6 @@ The following is a detailed description of each of the defined states.
1100
1052
| [onEvents](#eventstate-onevents) | Define the events to be consumed and one or more actions to be performed | array | yes |
1101
1053
| [timeout](#eventstate-timeout) | Time period to wait for incoming events (ISO 8601 format). For example: "PT15M" (wait 15 minutes), or "P2DT3H4M" (wait 2 days, 3 hours and 4 minutes)| string | no |
1102
1054
| [stateDataFilter](#state-data-filter) | State data filter definition| object | no |
1103
-
| [dataSchema](#DataSchema-Definition) | State data schema. Allows to set expected structure of the states data input and output | object | no |
1104
1055
| [transition](#Transitions) | Next transition of the workflow after all the actions have been performed | object | yes |
1105
1056
| [onErrors](#Error-Definition) | States error handling and retries definitions | array | no |
1106
1057
| [start](#Start-Definition) | Is this state a starting state | object | no |
@@ -1833,7 +1784,6 @@ Transitions allow you to move from one state (control-logic block) to another. F
1833
1784
| [stateDataFilter](#state-data-filter) | State data filter | object | no |
1834
1785
| [onErrors](#Error-Definition) | States error handling and retries definitions | array | no |
1835
1786
| [transition](#Transitions) | Next transition of the workflow after all the actions have been performed | object | yes (if end is not defined) |
1836
-
| [dataSchema](#DataSchema-Definition) | State data schema. Allows to set expected structure of the states data input and output | object | no |
1837
1787
| [compensatedBy](#Workflow-Compensation) | Unique name of a workflow state which is responsible for compensation of this state | String | no |
1838
1788
| [usedForCompensation](#Workflow-Compensation) | If true, this state is used to compensate another state. Default is "false" | boolean | no |
1839
1789
| [metadata](#Workflow-Metadata) | Metadata information| object | no |
@@ -1906,7 +1856,6 @@ Once all actions have been performed, a transition to another state can occur.
1906
1856
| [onErrors](#Error-Definition) | States error handling and retries definitions | array | no |
1907
1857
| eventTimeout | If eventConditions is used, defines the time period to wait for events (ISO 8601 format). For example: "PT15M"(15 minutes), or "P2DT3H4M" (2 days, 3 hours and 4 minutes)| string | yes only if eventConditions is defined |
1908
1858
| default | Default transition of the workflow if there is no matching data conditions or event timeout is reached. Can be a transition or end definition | object | yes |
1909
-
| [dataSchema](#DataSchema-Definition) | State data schema. Allows to set expected structure of the states data input and output | object | no |
1910
1859
| [compensatedBy](#Workflow-Compensation) | Unique name of a workflow state which is responsible for compensation of this state | String | no |
1911
1860
| [usedForCompensation](#Workflow-Compensation) | If true, this state is used to compensate another state. Default is "false" | boolean | no |
1912
1861
| [metadata](#Workflow-Metadata) | Metadata information| object | no |
@@ -2104,7 +2053,6 @@ The `eventDataFilter` property can be used to filter event when it is received.
2104
2053
| [stateDataFilter](#state-data-filter) | State data filter | object | no |
2105
2054
| [onErrors](#Error-Definition) | States error handling and retries definitions | array | no |
2106
2055
| [transition](#Transitions) | Next transition of the workflow after the delay | object | yes (if end is not defined) |
2107
-
| [dataSchema](#DataSchema-Definition) | State data schema. Allows to set expected structure of the states data input and output | object | no |
2108
2056
| [compensatedBy](#Workflow-Compensation) | Unique name of a workflow state which is responsible for compensation of this state | String | no |
2109
2057
| [usedForCompensation](#Workflow-Compensation) | If true, this state is used to compensate another state. Default is "false" | boolean | no |
2110
2058
| [start](#Start-Definition) | Is this state a starting state | object | no |
@@ -2161,7 +2109,6 @@ Delay state waits for a certain amount of time before transitioning to a next st
2161
2109
| [stateDataFilter](#state-data-filter) | State data filter | object | no |
2162
2110
| [onErrors](#Error-Definition) | States error handling and retries definitions | array | no |
2163
2111
| [transition](#Transitions) | Next transition of the workflow after all branches have completed execution | object | yes (if end is not defined) |
2164
-
| [dataSchema](#DataSchema-Definition) | State data schema. Allows to set expected structure of the states data input and output | object | no |
2165
2112
| [compensatedBy](#Workflow-Compensation) | Unique name of a workflow state which is responsible for compensation of this state | String | no |
2166
2113
| [usedForCompensation](#Workflow-Compensation) | If true, this state is used to compensate another state. Default is "false" | boolean | no |
2167
2114
| [metadata](#Workflow-Metadata) | Metadata information| object | no |
@@ -2364,7 +2311,6 @@ For more information, see the [Workflow Error Handling](#Workflow-Error-Handling
2364
2311
| [stateDataFilter](#state-data-filter) | State data filter | object | no |
2365
2312
| [onErrors](#Error-Definition) | States error handling and retries definitions | array | no |
2366
2313
| [transition](#Transitions) | Next transition of the workflow after subflow has completed | object | yes (if end is not defined) |
2367
-
| [dataSchema](#DataSchema-Definition) | State data schema. Allows to set expected structure of the states data input and output | object | no |
2368
2314
| [compensatedBy](#Workflow-Compensation) | Unique name of a workflow state which is responsible for compensation of this state | String | no |
2369
2315
| [usedForCompensation](#Workflow-Compensation) | If true, this state is used to compensate another state. Default is "false" | boolean | no |
2370
2316
| [metadata](#Workflow-Metadata) | Metadata information| object | no |
@@ -2440,7 +2386,6 @@ Referenced workflows must declare their own [function](#Function-Definition) and
2440
2386
| data | JSON object which can be set as state's data input and can be manipulated via filter | object | yes |
2441
2387
| [stateDataFilter](#state-data-filter) | State data filter | object | no |
2442
2388
| [transition](#Transitions) | Next transition of the workflow after subflow has completed | object | yes (if end is set to false) |
2443
-
| [dataSchema](#DataSchema-Definition) | State data schema. Allows to set expected structure of the states data input and output | object | no |
2444
2389
| [onErrors](#Error-Definition) | States error handling and retries definitions | array | no |
2445
2390
| [compensatedBy](#Workflow-Compensation) | Unique name of a workflow state which is responsible for compensation of this state | String | no |
2446
2391
| [usedForCompensation](#Workflow-Compensation) | If true, this state is used to compensate another state. Default is "false" | boolean | no |
@@ -2656,7 +2601,6 @@ This allows you to test if your workflow behaves properly for cases when there a
2656
2601
| [stateDataFilter](#state-data-filter) | State data filter definition | object | no |
2657
2602
| [onErrors](#Error-Definition) | States error handling and retries definitions | array | no |
2658
2603
| [transition](#Transitions) | Next transition of the workflow after state has completed | object | yes (if end is not defined) |
2659
-
| [dataSchema](#DataSchema-Definition) | State data schema. Allows to set expected structure of the states data input and output | object | no |
2660
2604
| [compensatedBy](#Workflow-Compensation) | Unique name of a workflow state which is responsible for compensation of this state | String | no |
2661
2605
| [usedForCompensation](#Workflow-Compensation) | If true, this state is used to compensate another state. Default is "false" | boolean | no |
2662
2606
| [metadata](#Workflow-Metadata) | Metadata information| object | no |
@@ -2886,7 +2830,6 @@ The results of each parallel action execution are stored as elements in the stat
2886
2830
| [eventDataFilter](#event-data-filter) | Callback event data filter definition | object | no |
2887
2831
| [stateDataFilter](#state-data-filter) | State data filter definition | object | no |
2888
2832
| [onErrors](#Error-Definition) | States error handling and retries definitions | array | no |
2889
-
| [dataSchema](#DataSchema-Definition) | State data schema. Allows to set expected structure of the states data input and output | object | no |
2890
2833
| [transition](#Transitions) | Next transition of the workflow after callback event has been received | object | yes |
2891
2834
| [start](#Start-Definition) | Is this state a starting state | object | no |
2892
2835
| [end](#End-Definition) | Is this state an end state | object | no |
@@ -3473,11 +3416,6 @@ Workflow data input is passed to the workflow's [start state](#Start-Definition)
3473
3416
<img src="media/spec/workflowdatainput.png" height="350px" alt="Workflow data input"/>
3474
3417
</p>
3475
3418
3476
-
In order to define the structure of expected workflow data input you can use the workflow
3477
-
[`dataSchema`](#DataSchema-Definition) `input` property. This property allows you to link to a [JSON Schema](https://json-schema.org/) definition
3478
-
that describes the expected workflow data input. It can be used for documentation purposes or implementations may
3479
-
decide to strictly enforce it.
3480
-
3481
3419
#### Event Data
3482
3420
3483
3421
[Event states](#Event-State) wait for arrival of defined CloudEvents, and when consumed perform a number of defined actions.
@@ -3520,11 +3458,6 @@ There are two of rules to consider here:
3520
3458
<img src="media/spec/basic-state-data-passing.png" height="350px" alt="Basic state data passing"/>
3521
3459
</p>
3522
3460
3523
-
In order to define the structure of expected state data input and output you can use the workflow
3524
-
["dataSchema"](#DataSchema-Definition) property. It allows you to link to [JSON Schema](https://json-schema.org/) definitions
3525
-
that describe the expected states data input/output. It can be used for documentation purposes or implementations may
3526
-
decide to strictly enforce it.
3527
-
3528
3461
#### State Data Filtering
3529
3462
3530
3463
Data filters allow you to select and extract specific data that is useful and needed during workflow execution.
@@ -3987,11 +3920,6 @@ Once a workflow instance reaches an end state (where the `end` property is defin
3987
3920
the data output of that result state becomes the workflow data output. This output can be logged or indexed depending on the
3988
3921
implementation details.
3989
3922
3990
-
In order to define the structure of expected workflow data output you can use the workflow
3991
-
[`dataSchema`](#DataSchema-Definition) `output` property. This property allows you to link to [JSON Schema](https://json-schema.org/) definition
3992
-
that describes the expected workflow data output. It can be used for documentation purposes or implementations may
3993
-
decide to strictly enforce it.
3994
-
3995
3923
### Workflow Error Handling
3996
3924
3997
3925
Serverless Workflow language allows you to define `explicit` error handling, meaning you can define what should happen
0 commit comments