Added an example and fixed both schema and dsl

Signed-off-by: Charles d'Avernas <charles.davernas@neuroglia.io>

Author: cdavernas

dsl-reference.md

@@ -277,7 +277,7 @@ The [AsyncAPI Call](#asyncapi-call) enables workflows to interact with external
 | Name | Type | Required | Description|
 |:--|:---:|:---:|:---|
 | document | [`externalResource`](#external-resource) | `yes` | The AsyncAPI document that defines the operation to call. |
-| operation | `string` | `yes` | The id of the AsyncAPI operation to call. |
+| operationRef | `string` | `yes` | A reference to the AsyncAPI operation to call. |
 | server | `string` | `no` | A reference to the server to call the specified AsyncAPI operation on.<br>If not set, default to the first server matching the operation's channel. |
 | message | `string` | `no` | The name of the message to use. <br>If not set, defaults to the first message defined by the operation. |
 | binding | `string` | `no` | The name of the binding to use. <br>If not set, defaults to the first binding defined by the operation |
@@ -382,7 +382,7 @@ The [OpenAPI Call](#openapi-call) enables workflows to interact with external se
 | Name | Type | Required | Description|
 |:--|:---:|:---:|:---|
 | document | [`externalResource`](#external-resource) | `yes` | The OpenAPI document that defines the operation to call. |
-| operation | `string` | `yes` | The id of the OpenAPI operation to call. |
+| operationId | `string` | `yes` | The id of the OpenAPI operation to call. |
 | arguments | `map` | `no` | A name/value mapping of the parameters, if any, of the OpenAPI operation to call. |
 | authentication | [`authentication`](#authentication) | `no` | The authentication policy, or the name of the authentication policy, to use when calling the OpenAPI operation. |
 | output | `string` | `no` | The OpenAPI call's output format.<br>*Supported values are:*<br>*- `raw`, which output's the base-64 encoded [http response](#http-response) content, if any.*<br>*- `content`, which outputs the content of [http response](#http-response), possibly deserialized.*<br>*- `response`, which outputs the [http response](#http-response).*<br>*Defaults to `content`.* |

examples/accumulate-room-readings.yaml

@@ -0,0 +1,46 @@
+document:
+  dsl: 1.0.0-alpha1
+  namespace: examples
+  name: accumulate-room-readings
+  version: 1.0.0-alpha1
+do:
+  consumeReading:
+    listen:
+      to:
+        all:
+          - with:
+              source: https://my.home.com/sensor
+              type: my.home.sensors.temperature
+            correlate:
+              roomId:
+                from: .roomid
+            output:
+              from: .data.reading
+          - with:
+              source: https://my.home.com/sensor
+              type: my.home.sensors.humidity
+            correlate:
+              roomId:
+                from: .roomid
+            output:
+              from: .data.reading
+      as: readings
+  logReading:
+    for:
+      each: reading
+      in: .readings
+    do:
+      call: openapi
+      with:
+        document:
+          uri: http://myorg.io/ordersservices.json
+        operationId: logreading
+  generateReport:
+    call: openapi
+    with:
+      document:
+        uri: http://myorg.io/ordersservices.json
+      operationId: produceReport
+timeout:
+  after:
+    hours: 1

schema/workflow.yaml

@@ -140,7 +140,7 @@ $defs:
               document:
                 $ref: '#/$defs/externalResource'
                 description: The document that defines the AsyncAPI operation to call.
-              operation:
+              operationRef:
                 type: string
                 description: A reference to the AsyncAPI operation to call.
               server:
@@ -158,7 +158,7 @@ $defs:
               authentication:
                 ref: '#/$defs/authenticationPolicy'
                 description: The authentication policy, if any, to use when calling the AsyncAPI operation.
-            required: [ document, operation ]
+            required: [ document, operationRef ]
             description: Defines the AsyncAPI call to perform.
         required: [ call, with ]
       - properties:
@@ -235,7 +235,7 @@ $defs:
               document:
                 $ref: '#/$defs/externalResource'
                 description: The document that defines the OpenAPI operation to call.
-              operation:
+              operationId:
                 type: string
                 description: The id of the OpenAPI operation to call.
               parameters:
@@ -249,7 +249,7 @@ $defs:
                 type: string
                 enum: [ raw, content, response ]
                 description: The http call output format. Defaults to 'content'.
-            required: [ document, operation ]
+            required: [ document, operationId ]
             description: Defines the OpenAPI call to perform.
         required: [ call, with ]
       - properties: