Examples of workflows with For Each Task #11442

DotCat1985 · 2022-03-28T09:50:38Z

DotCat1985
Mar 28, 2022

Hi,
could you give any visual examples of workflows with For Each Task?
Please leave examples of For Each Task settings.
Thank you.

DotCat1985 · 2022-03-31T07:20:25Z

DotCat1985
Mar 31, 2022
Author

Can I have any feedback? Thank you

2 replies

Skrypt Mar 31, 2022
Maintainer

Duplicate of #6527
Documentation needs to be written.

lampersky Apr 7, 2022

@DotCat1985 I've just prepared some example for you, once http GET request event is fired, I'm iterating over an array and creating few content items, each time incrementing counter based on Create Content Task result, finally I'm returning some JSON response using Http Response Task

here is how example result looks like:

example workflow recipe:

{
  "name": "",
  "displayName": "",
  "description": "",
  "author": "",
  "website": "",
  "version": "",
  "issetuprecipe": false,
  "categories": [],
  "tags": [],
  "steps": [
    {
      "name": "WorkflowType",
      "data": [
        {
          "WorkflowTypeId": "4544ffh23h049vkqvvdzq8xrmv",
          "Name": "ForEachTask Example",
          "IsEnabled": true,
          "IsSingleton": false,
          "LockTimeout": 0,
          "LockExpiration": 0,
          "DeleteFinishedWorkflows": false,
          "Activities": [
            {
              "ActivityId": "4ah1rgxnhjkcn20saxr8jagzc7",
              "Name": "HttpRequestEvent",
              "X": 10,
              "Y": 10,
              "IsStart": true,
              "Properties": {
                "ActivityMetadata": {
                  "Title": "StartingPoint"
                },
                "HttpMethod": "GET",
                "Url": "/workflows/Invoke?token=CfDJ8AYq_EnevT5Kl0IeIOzeBjGcswiYQWpiYHMZWiR2z0c9F2wZn-ugt8Q-8No4q-1cpLJM5aXqyD3RMDMbi9PKi3jsGIkdIZfqwy-BOpU3tg0NWPMw3J21fDPlPdU_IGpdLv4G8IRGloiaI7YkTf-BIfnjZxps6J2m8sspjDNdBTcWEtE-FXtXxbtmABkNYuSHvqcEdkDUfarJkTWJug-2ONpmLFORuLKVJ-LF4OZ9oS2i",
                "ValidateAntiforgeryToken": false,
                "TokenLifeSpan": 0
              }
            },
            {
              "ActivityId": "4tw20y9gycskt5fehp1kte36d9",
              "Name": "ForEachTask",
              "X": 240,
              "Y": 190,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": "Loop over array"
                },
                "LoopVariableName": "x",
                "Enumerable": {
                  "Expression": "[\"Orchard\", \"is\", \"great\"]"
                }
              }
            },
            {
              "ActivityId": "4w2xsjvgkn8pyrw2247fjmphmn",
              "Name": "HttpResponseTask",
              "X": 240,
              "Y": 420,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": "Return response json"
                },
                "HttpStatusCode": 200,
                "Content": {
                  "Expression": "{ \r\n\t\"success\" : \"{% if Workflow.Properties['success'] %}{{ Workflow.Properties['success'] }}{% else %}0{% endif %}\",\r\n\t\"failed\" : \"{% if Workflow.Properties['failed'] %}{{ Workflow.Properties['failed'] }}{% else %}0{% endif %}\"\r\n}"
                },
                "ContentType": {
                  "Expression": "application/json"
                },
                "Headers": {
                  "Expression": null
                }
              }
            },
            {
              "ActivityId": "436pwc1xrp4eg5mx6snvm0escs",
              "Name": "CreateContentTask",
              "X": 700,
              "Y": 190,
              "IsStart": false,
              "Properties": {
                "ContentType": "ExampleType",
                "Publish": true,
                "ContentProperties": {
                  "Expression": "{\r\n  \"DisplayText\": \"{{ Workflow.Properties['x']}}\"\r\n}"
                },
                "ActivityMetadata": {
                  "Title": null
                }
              }
            },
            {
              "ActivityId": "468xb5yssteed7wh5sqvam97mn",
              "Name": "SetPropertyTask",
              "X": 660,
              "Y": 380,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": "Increase Success Counter"
                },
                "PropertyName": "success",
                "Value": {
                  "Expression": "property('success') + 1"
                }
              }
            },
            {
              "ActivityId": "43yfm0rk28xx72ce9dmtjk3fwc",
              "Name": "SetPropertyTask",
              "X": 670,
              "Y": 10,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": "Increase Failed Counter"
                },
                "PropertyName": "failed",
                "Value": {
                  "Expression": "property('failed') + 1"
                }
              }
            }
          ],
          "Transitions": [
            {
              "Id": 0,
              "SourceActivityId": "4ah1rgxnhjkcn20saxr8jagzc7",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4tw20y9gycskt5fehp1kte36d9"
            },
            {
              "Id": 0,
              "SourceActivityId": "4tw20y9gycskt5fehp1kte36d9",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4w2xsjvgkn8pyrw2247fjmphmn"
            },
            {
              "Id": 0,
              "SourceActivityId": "4tw20y9gycskt5fehp1kte36d9",
              "SourceOutcomeName": "Iterate",
              "DestinationActivityId": "436pwc1xrp4eg5mx6snvm0escs"
            },
            {
              "Id": 0,
              "SourceActivityId": "436pwc1xrp4eg5mx6snvm0escs",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "468xb5yssteed7wh5sqvam97mn"
            },
            {
              "Id": 0,
              "SourceActivityId": "468xb5yssteed7wh5sqvam97mn",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4tw20y9gycskt5fehp1kte36d9"
            },
            {
              "Id": 0,
              "SourceActivityId": "436pwc1xrp4eg5mx6snvm0escs",
              "SourceOutcomeName": "Failed",
              "DestinationActivityId": "43yfm0rk28xx72ce9dmtjk3fwc"
            },
            {
              "Id": 0,
              "SourceActivityId": "43yfm0rk28xx72ce9dmtjk3fwc",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4tw20y9gycskt5fehp1kte36d9"
            }
          ]
        }
      ]
    }
  ]
}

lampersky · 2022-04-07T20:17:01Z

lampersky
Apr 7, 2022

here you have also For Loop Task example, it is a simple calculator, which calculates sum of terms from arithmetic sequence

to test it, you need to pass 3 query params fromExp, toExp, stepExp

https://localhost:44300/workflows/Invoke?token=ENTER_TOKEN_HERE&fromExp=1&toExp=10&stepExp=1

{
  "name": "",
  "displayName": "",
  "description": "",
  "author": "",
  "website": "",
  "version": "",
  "issetuprecipe": false,
  "categories": [],
  "tags": [],
  "steps": [
    {
      "name": "WorkflowType",
      "data": [
        {
          "WorkflowTypeId": "48yr6102pcgbfsfxp1k901h35r",
          "Name": "ForLoopTask Example",
          "IsEnabled": true,
          "IsSingleton": false,
          "LockTimeout": 0,
          "LockExpiration": 0,
          "DeleteFinishedWorkflows": false,
          "Activities": [
            {
              "ActivityId": "44gmzvn2by7wk5zg7w2n4sfyna",
              "Name": "HttpRequestEvent",
              "X": 0,
              "Y": 10,
              "IsStart": true,
              "Properties": {
                "ActivityMetadata": {
                  "Title": "StartingPoint"
                },
                "HttpMethod": "GET",
                "Url": "/workflows/Invoke?token=CfDJ8AYq_EnevT5Kl0IeIOzeBjGMCO8gG4x21s5POQxkiXD2oEERjrsJFWu9TXkWa4B5VJQ6AOIwhsSS4-FD8r5oD4CxPAUmCszLtmud3juSeReelqMDaR5RSnRfOSCNGvax2QW79ap8z6gIxgcByQ4kPYy55zSaN_Q-1qrr5Dck1WQIie-tc7aOCs5BpQyt8LhMoaQHNGkOzOwl54cpXMvwzRGIwGSjenDynZyKnhbvuDHG",
                "ValidateAntiforgeryToken": false,
                "TokenLifeSpan": 0
              }
            },
            {
              "ActivityId": "4pe2z0g0ckj0vt9vcppr6r82xf",
              "Name": "ForLoopTask",
              "X": 710,
              "Y": 260,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": null
                },
                "From": {
                  "Expression": "parseInt(property('fromExp'))"
                },
                "To": {
                  "Expression": "parseInt(property('toExp'))"
                },
                "Step": {
                  "Expression": "parseInt(property('stepExp'))"
                },
                "LoopVariableName": "x"
              }
            },
            {
              "ActivityId": "49v15pat5hcrfvj8z2mwt1dhx1",
              "Name": "HttpResponseTask",
              "X": 1220,
              "Y": 270,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": null
                },
                "HttpStatusCode": 200,
                "Content": {
                  "Expression": "{ \r\n\t\"from\" : \"{{Workflow.Properties['fromExp']}}\",\r\n\t\"to\" : \"{{Workflow.Properties['toExp']}}\",\r\n\t\"step\" : \"{{Workflow.Properties['stepExp']}}\",\r\n\t\"sum\" : \"{{Workflow.Properties['sum']}}\",\r\n}"
                },
                "ContentType": {
                  "Expression": "application/json"
                },
                "Headers": {
                  "Expression": null
                }
              }
            },
            {
              "ActivityId": "4mddp4k1x8m570gaffg90wmsd0",
              "Name": "SetPropertyTask",
              "X": 500,
              "Y": 20,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": null
                },
                "PropertyName": "fromExp",
                "Value": {
                  "Expression": "queryString('fromExp')"
                }
              }
            },
            {
              "ActivityId": "4s1450j4s4cc13drzrmnxpbnn7",
              "Name": "SetPropertyTask",
              "X": 810,
              "Y": 20,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": null
                },
                "PropertyName": "toExp",
                "Value": {
                  "Expression": "queryString('toExp')"
                }
              }
            },
            {
              "ActivityId": "4j8e7p59r8yze5xxq2pkv441d3",
              "Name": "SetPropertyTask",
              "X": 1110,
              "Y": 30,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": null
                },
                "PropertyName": "stepExp",
                "Value": {
                  "Expression": "queryString('stepExp')"
                }
              }
            },
            {
              "ActivityId": "4y1xpw8mz7n1s3m6k81d9xxd4n",
              "Name": "SetPropertyTask",
              "X": 280,
              "Y": 260,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": null
                },
                "PropertyName": "sum",
                "Value": {
                  "Expression": "property('sum') + property('x')"
                }
              }
            },
            {
              "ActivityId": "4mvzs2gwqbweyxy8jfxh716146",
              "Name": "SetPropertyTask",
              "X": 240,
              "Y": 20,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": "Init Sum Variable"
                },
                "PropertyName": "sum",
                "Value": {
                  "Expression": "parseInt('0')"
                }
              }
            }
          ],
          "Transitions": [
            {
              "Id": 0,
              "SourceActivityId": "4mddp4k1x8m570gaffg90wmsd0",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4s1450j4s4cc13drzrmnxpbnn7"
            },
            {
              "Id": 0,
              "SourceActivityId": "4s1450j4s4cc13drzrmnxpbnn7",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4j8e7p59r8yze5xxq2pkv441d3"
            },
            {
              "Id": 0,
              "SourceActivityId": "4j8e7p59r8yze5xxq2pkv441d3",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4pe2z0g0ckj0vt9vcppr6r82xf"
            },
            {
              "Id": 0,
              "SourceActivityId": "4pe2z0g0ckj0vt9vcppr6r82xf",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "49v15pat5hcrfvj8z2mwt1dhx1"
            },
            {
              "Id": 0,
              "SourceActivityId": "4pe2z0g0ckj0vt9vcppr6r82xf",
              "SourceOutcomeName": "Iterate",
              "DestinationActivityId": "4y1xpw8mz7n1s3m6k81d9xxd4n"
            },
            {
              "Id": 0,
              "SourceActivityId": "4y1xpw8mz7n1s3m6k81d9xxd4n",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4pe2z0g0ckj0vt9vcppr6r82xf"
            },
            {
              "Id": 0,
              "SourceActivityId": "44gmzvn2by7wk5zg7w2n4sfyna",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4mvzs2gwqbweyxy8jfxh716146"
            },
            {
              "Id": 0,
              "SourceActivityId": "4mvzs2gwqbweyxy8jfxh716146",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4mddp4k1x8m570gaffg90wmsd0"
            }
          ]
        }
      ]
    }
  ]
}

0 replies

lampersky · 2022-04-07T21:02:11Z

lampersky
Apr 7, 2022

also prepared an example of While Task, yet another calculator, this time it is calculating highest common factor, to test it you need to provide two positive integers

https://localhost:44300/workflows/Invoke?token=ENTER_TOKEN_HERE&firstNumber=120&secondNumber=60

{
  "name": "",
  "displayName": "",
  "description": "",
  "author": "",
  "website": "",
  "version": "",
  "issetuprecipe": false,
  "categories": [],
  "tags": [],
  "steps": [
    {
      "name": "WorkflowType",
      "data": [
        {
          "WorkflowTypeId": "43gmqp0354vfv6s62g13rzfh5q",
          "Name": "WhileTask Example",
          "IsEnabled": true,
          "IsSingleton": false,
          "LockTimeout": 0,
          "LockExpiration": 0,
          "DeleteFinishedWorkflows": false,
          "Activities": [
            {
              "ActivityId": "462nkb36swcy51vetmy8fk4m4h",
              "Name": "HttpRequestEvent",
              "X": 0,
              "Y": 0,
              "IsStart": true,
              "Properties": {
                "ActivityMetadata": {
                  "Title": "StartingPoint"
                },
                "HttpMethod": "GET",
                "Url": "/workflows/Invoke?token=CfDJ8AYq_EnevT5Kl0IeIOzeBjGVNHtgfYn0neRlr4s5_LUglx0WeD1EcedlLENKTn0R80j6tUR_8r5vRhi4-5PyQCo6Oke2oHQ34jVBZMMY4DL4CpZG5K1m9O1QaP8hfqB-7kcWhDHZJuraLDZxhYzAxd9Y7Klg7O5KL8IEn_tpn5zUmF1W2hnWA3T9lEiLItQytv3I5xLuZDT7Lr9WIU_GSZF2qLhTWytW8KvflV9-uc8X",
                "ValidateAntiforgeryToken": false,
                "TokenLifeSpan": 0
              }
            },
            {
              "ActivityId": "4km90r8ddvnke5p2bbj6xp25m2",
              "Name": "HttpResponseTask",
              "X": 1250,
              "Y": 490,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": null
                },
                "HttpStatusCode": 200,
                "Content": {
                  "Expression": "{ \"Highest common factor\" : \"{{Workflow.Properties['firstNumber']}}\" }"
                },
                "ContentType": {
                  "Expression": "application/json"
                },
                "Headers": {
                  "Expression": null
                }
              }
            },
            {
              "ActivityId": "4vrkek9c5mdxr019jbk80wz6ns",
              "Name": "SetPropertyTask",
              "X": 300,
              "Y": 50,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": null
                },
                "PropertyName": "firstNumber",
                "Value": {
                  "Expression": "parseInt(queryString('firstNumber'))"
                }
              }
            },
            {
              "ActivityId": "4e66nt512tg0hxqcgdc1eave4d",
              "Name": "SetPropertyTask",
              "X": 770,
              "Y": 50,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": null
                },
                "PropertyName": "secondNumber",
                "Value": {
                  "Expression": "parseInt(queryString('secondNumber'))"
                }
              }
            },
            {
              "ActivityId": "4hjx042n4wr0g6jvkt2kjyz0xp",
              "Name": "WhileLoopTask",
              "X": 850,
              "Y": 490,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": null
                },
                "Condition": {
                  "Expression": "property('firstNumber') != property('secondNumber')"
                }
              }
            },
            {
              "ActivityId": "4kqqe59zm0va2rfh8tss9vksce",
              "Name": "ScriptTask",
              "X": 30,
              "Y": 490,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": null
                },
                "AvailableOutcomes": [
                  "FirstNumberIsGreatestOrEqual",
                  "SecondNumberIsGreatest"
                ],
                "Script": {
                  "Expression": "if(property('firstNumber') >= property('secondNumber')) {\r\n  setOutcome('FirstNumberIsGreatestOrEqual');\r\n}\r\nelse {\r\n\tsetOutcome('SecondNumberIsGreatest');\r\n}"
                }
              }
            },
            {
              "ActivityId": "4h70gwndv7pckrfgkdpzd7eccb",
              "Name": "SetPropertyTask",
              "X": 380,
              "Y": 410,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": null
                },
                "PropertyName": "firstNumber",
                "Value": {
                  "Expression": "property('firstNumber') - property('secondNumber')"
                }
              }
            },
            {
              "ActivityId": "4w4m898dr4ypd1cbrza53st5n5",
              "Name": "SetPropertyTask",
              "X": 340,
              "Y": 210,
              "IsStart": false,
              "Properties": {
                "ActivityMetadata": {
                  "Title": null
                },
                "PropertyName": "secondNumber",
                "Value": {
                  "Expression": "property('secondNumber') - property('firstNumber')"
                }
              }
            }
          ],
          "Transitions": [
            {
              "Id": 0,
              "SourceActivityId": "462nkb36swcy51vetmy8fk4m4h",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4vrkek9c5mdxr019jbk80wz6ns"
            },
            {
              "Id": 0,
              "SourceActivityId": "4vrkek9c5mdxr019jbk80wz6ns",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4e66nt512tg0hxqcgdc1eave4d"
            },
            {
              "Id": 0,
              "SourceActivityId": "4e66nt512tg0hxqcgdc1eave4d",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4hjx042n4wr0g6jvkt2kjyz0xp"
            },
            {
              "Id": 0,
              "SourceActivityId": "4hjx042n4wr0g6jvkt2kjyz0xp",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4km90r8ddvnke5p2bbj6xp25m2"
            },
            {
              "Id": 0,
              "SourceActivityId": "4hjx042n4wr0g6jvkt2kjyz0xp",
              "SourceOutcomeName": "Iterate",
              "DestinationActivityId": "4kqqe59zm0va2rfh8tss9vksce"
            },
            {
              "Id": 0,
              "SourceActivityId": "4kqqe59zm0va2rfh8tss9vksce",
              "SourceOutcomeName": "FirstNumberIsGreatestOrEqual",
              "DestinationActivityId": "4h70gwndv7pckrfgkdpzd7eccb"
            },
            {
              "Id": 0,
              "SourceActivityId": "4h70gwndv7pckrfgkdpzd7eccb",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4hjx042n4wr0g6jvkt2kjyz0xp"
            },
            {
              "Id": 0,
              "SourceActivityId": "4kqqe59zm0va2rfh8tss9vksce",
              "SourceOutcomeName": "SecondNumberIsGreatest",
              "DestinationActivityId": "4w4m898dr4ypd1cbrza53st5n5"
            },
            {
              "Id": 0,
              "SourceActivityId": "4w4m898dr4ypd1cbrza53st5n5",
              "SourceOutcomeName": "Done",
              "DestinationActivityId": "4hjx042n4wr0g6jvkt2kjyz0xp"
            }
          ]
        }
      ]
    }
  ]
}

4 replies

Skrypt Apr 7, 2022
Maintainer

Maybe you could create documentation as a Markdown file that you could share?

DotCat1985 Apr 8, 2022
Author

It's clear. Thank you! I think you could share these example on documentation, because workflow feature could represent a killer feature of OrchardCore.

lampersky Apr 8, 2022

I've started preparing examples, will add a few soon.

lampersky Apr 9, 2022

@Skrypt I've prepared very simple CRUD app using just Workflows module.

only authorized users can access chat, not authorized users will be redirected to login page with returnUrl parameter,
users can add new text messages,
users can remove ONLY their own messages,
users can list messages.

Here you can find how it looks like in the action:
https://youtu.be/fUhMQ3VYUaA

used events and tasks:

handle incoming HTTP request,
validate user,
set property,
HTTP redirect,
HTTP response,
Retrieve content,
Create content,
Delete content,
If/Else.

Here is a recipe:
https://github.com/lampersky/OrchardCoreWorkflowsExamples/blob/main/WorkflowShoutbox.json

Once signal bug PR is merged, I will commit another example.

Examples of workflows with For Each Task #11442

Uh oh!

DotCat1985 Mar 28, 2022

Replies: 3 comments · 6 replies

Uh oh!

DotCat1985 Mar 31, 2022 Author

Uh oh!

Skrypt Mar 31, 2022 Maintainer

Uh oh!

lampersky Apr 7, 2022

Uh oh!

lampersky Apr 7, 2022

Uh oh!

lampersky Apr 7, 2022

Uh oh!

Uh oh!

Skrypt Apr 7, 2022 Maintainer

Uh oh!

DotCat1985 Apr 8, 2022 Author

Uh oh!

lampersky Apr 8, 2022

Uh oh!

lampersky Apr 9, 2022

DotCat1985
Mar 28, 2022

Replies: 3 comments 6 replies

DotCat1985
Mar 31, 2022
Author

Skrypt Mar 31, 2022
Maintainer

lampersky
Apr 7, 2022

lampersky
Apr 7, 2022

Skrypt Apr 7, 2022
Maintainer

DotCat1985 Apr 8, 2022
Author