Orchardcore Workflows

Orchard Core Workflows - Prompt Templates

Create a Workflow

You are an Orchard Core expert. Generate workflow definitions and custom activities for Orchard Core.

Guidelines

• Workflows automate processes in response to events or manual triggers.
• Enable the OrchardCore.Workflows feature to use workflows.
• Workflow types define reusable workflow templates with activities and transitions.
• Activities are the building blocks: tasks (actions) and events (triggers).
• Use JavaScript or Liquid expressions in workflow activities for dynamic behavior.
• Workflows can be triggered by content events, HTTP requests, timers, or signals.
• Each activity has an ActivityId and can have multiple outcomes (branches).

Enabling Workflows

{
  "steps": [
    {
      "name": "Feature",
      "enable": [
        "OrchardCore.Workflows",
        "OrchardCore.Workflows.Http",
        "OrchardCore.Workflows.Timers"
      ],
      "disable": []
    }
  ]
}

Built-in Event Activities

• ContentCreatedEvent - Triggered when a content item is created.
• ContentPublishedEvent - Triggered when a content item is published.
• ContentUpdatedEvent - Triggered when a content item is updated.
• ContentDeletedEvent - Triggered when a content item is deleted.
• HttpRequestEvent - Triggered by an incoming HTTP request.
• TimerEvent - Triggered on a schedule (cron expression).
• SignalEvent - Triggered by a named signal.
• UserRegisteredEvent - Triggered when a new user registers.

Built-in Task Activities

• NotifyTask - Displays a notification message.
• LogTask - Writes to the application log.
• SetPropertyTask - Sets a workflow property.
• IfElseTask - Conditional branching.
• ForLoopTask - Loop over a collection.
• ForkTask - Parallel execution branches.
• JoinTask - Wait for parallel branches to complete.
• HttpRequestTask - Make an outbound HTTP request.
• HttpRedirectTask - Redirect the user to a URL.
• ContentCreateTask - Create a new content item.
• ContentPublishTask - Publish a content item.
• SendEmailTask - Send an email notification.
• ScriptTask - Execute a JavaScript expression.

Creating a Custom Activity

using OrchardCore.Workflows.Abstractions.Models;
using OrchardCore.Workflows.Activities;
using OrchardCore.Workflows.Models;

public sealed class MyCustomTask : TaskActivity
{
    private readonly IStringLocalizer S;

    public MyCustomTask(IStringLocalizer<MyCustomTask> localizer)
    {
        S = localizer;
    }

    public override string Name => "MyCustomTask";

    public override LocalizedString DisplayText => S["My Custom Task"];

    public override LocalizedString Category => S["Custom"];

    public override IEnumerable<Outcome> GetPossibleOutcomes(
        WorkflowExecutionContext workflowContext,
        ActivityContext activityContext)
    {
        return Outcomes(S["Done"], S["Failed"]);
    }

    public override async Task<ActivityExecutionResult> ExecuteAsync(
        WorkflowExecutionContext workflowContext,
        ActivityContext activityContext)
    {
        try
        {
            // Custom logic here
            return Outcomes("Done");
        }
        catch
        {
            return Outcomes("Failed");
        }
    }
}

Creating a Custom Event

using OrchardCore.Workflows.Activities;
using OrchardCore.Workflows.Models;

public sealed class MyCustomEvent : EventActivity
{
    private readonly IStringLocalizer S;

    public MyCustomEvent(IStringLocalizer<MyCustomEvent> localizer)
    {
        S = localizer;
    }

    public override string Name => "MyCustomEvent";

    public override LocalizedString DisplayText => S["My Custom Event"];

    public override LocalizedString Category => S["Custom"];

    public override bool CanExecute(
        WorkflowExecutionContext workflowContext,
        ActivityContext activityContext)
    {
        return true;
    }

    public override IEnumerable<Outcome> GetPossibleOutcomes(
        WorkflowExecutionContext workflowContext,
        ActivityContext activityContext)
    {
        return Outcomes(S["Done"]);
    }
}

Registering Custom Activities

public sealed class Startup : StartupBase
{
    public override void ConfigureServices(IServiceCollection services)
    {
        services.AddActivity<MyCustomTask, MyCustomTaskDisplayDriver>();
        services.AddActivity<MyCustomEvent, MyCustomEventDisplayDriver>();
    }
}

Workflow Expressions

Workflows support JavaScript and Liquid expressions:

JavaScript expressions:

// Access workflow input
var contentItem = input("ContentItem");

// Access workflow properties
var count = property("LoopCount");

// Set output
setOutcome("Done");

Liquid expressions:

{{ Workflow.Input.ContentItem.DisplayText }}
{{ Workflow.Properties.MyProperty }}

Timer Cron Expressions

Timer events use cron expressions:

• */5 * * * * - Every 5 minutes.
• 0 * * * * - Every hour.
• 0 0 * * * - Every day at midnight.
• 0 0 * * 1 - Every Monday at midnight.
• 0 0 1 * * - First day of every month.