{"componentChunkName":"component---src-templates-post-template-post-template-tsx","path":"/posts/sitecore-workflows-custom-workflow-actions/","result":{"data":{"markdownRemark":{"id":"08da780e-b7f0-58af-bc0a-6e2198640beb","html":"

This article will cover how we can create a custom workflow action for Workflows with Sitecore.

\n

OOTB Submit Actions

\n

Sitecore offers a few OOTB Submit Actions which can be used as per your requirements.

\n
    \n
  1. Auto Submit Action\nThis action can be utilized to automatically submit an item if it is saved by a user from a certain role.\nIt accepts the Type (which will remain the same), Next State and the Role Name.\nTemplate Path: /sitecore/templates/System/Workflow/Auto Submit Action
    2. \n
  2. Validation Action\nIt can be used to refuse a change in state if the item has validation errors.\nYou can mention the maximum allowed result - Warning, Error etc. and the messages to be shown in case of errors.\nTemplate Path: /sitecore/templates/System/Workflow/Validation Action
    3. \n
  3. Auto Publish\nAuto Publish, as the name suggests can be used to trigger a publish on the item if it moves to a certain final state.\nIt accepts parameters such as deep (To publish with subitems) and smart (For a smart publish).\nTemplate Path: /sitecore/templates/System/Workflow/Action\nType: Sitecore.Workflows.Simple.PublishAction, Sitecore.Kernel\nParameters: deep=1&smart=1 (Set to 0 if false, or exclude it).
    4. \n
  4. Email Action\nIt can be used to send an email to mentioned emails to inform a state change.\nTemplate Path: /sitecore/templates/System/Workflow/Email action
    5. \n
\n

Creating your own custom workflow action

\n

There are 2 steps in creating your custom workflow action:

\n
    \n
  1. Create a template with the fields that you need to be passed to the workflow action code. The Type field is a mandatory field.
    2. \n
  2. Create a class with a Process method accepting a parameter of type WorkflowPipelineArgs. The fully qualified name of this class will be populated in the Type field of the action item.
    3. \n
\n

The class will look like below:

\n
using Sitecore.Diagnostics;\nusing Sitecore.Workflows.Simple;\nusing System;\nusing Sitecore.Data.Items;\n\nnamespace Foundation.Workflow.Actions\n{\n    public class CustomWorkflowAction\n    {\n        public void Process(WorkflowPipelineArgs args)\n        {\n            try\n            {\n                Assert.ArgumentNotNull(args, \"args\");\n                Item dataItem = args.DataItem; // This will be the page item\n                ProcessorItem processorItem = args.ProcessorItem;\n                Item actionItem = processorItem?.InnerItem; // This will be the action item itself\n\t\tstring myValue = actionItem[\"My Field Name\"]; // Access the values from the action like this\n\t\t/*\n\t\t\tYour code goes here\n\t\t*/\n            }\n            catch (Exception ex)\n            {\n                Log.Error(ex.Message, this);\n            }\n        }\n\n    }\n}
\n

Now, you can add the action item under the workflow command on which you need it to be triggered. Remember to add the value for the Type field as the fully qualified name of the class.

\n

Happy Sitecoring!

","fields":{"slug":"/posts/2023-10-13-sitecore-workflows-custom-workflow-actions//posts/sitecore-workflows-custom-workflow-actions","tagSlugs":["/tag/sitecore/","/tag/workflows/"]},"frontmatter":{"date":"2023-10-13T16:33:25.581Z","description":"This article will cover how we can create a custom workflow action for Workflows with Sitecore.","tags":["Sitecore","Workflows"],"title":"Sitecore Workflows - Custom Workflow Actions","socialImage":{"publicURL":"/static/75be7c1e5ed43564cce58f6606e87463/vinayjadav_profilepicture.png"}}}},"pageContext":{"slug":"/posts/2023-10-13-sitecore-workflows-custom-workflow-actions//posts/sitecore-workflows-custom-workflow-actions"}},"staticQueryHashes":["251939775","288581551","401334301"],"slicesMap":{}}