Loading...
Area: Episerver Commerce
Applies to versions: 10 and higher
Other versions:

Customizing order processing activity flows

Recommendations [hide]

This topic describes the customization of activity flows for order processing in Episerver Commerce. 

How it works

To replace or customize an activity flow:

  1. In a Visual Studio project, create and build a new activity flow.
  2. Add existing or new activities to it.

Classes in this topic are available in the following namespaces:

  • Mediachase.Commerce.Workflow. Contains the workflows.
  • Mediachase.Commerce.Workflow.Activities.Cart. Contains the activities.

Configuration

Configure the activity flows in a .CS file (the config file \Configs\ecf.workflow.config is no longer needed).

An activity flow should inherit from the ActivityFlow class. You can decorate it with an ActivityFlowConfiguration attribute.

[ActivityFlowConfiguration(Name = “Example”)]
public class ExampleActivityFlow : ActivityFlow

Each activity flow should have a unique name. If the Name parameter is not provided, the engine gets the ActivityFlow class name. In this example, Name is ExampleActivityFlow. The activity flow name is used to look up and execute.

Example: ExecutionManager.ExecuteActivityFlow(workflowName, parameters)

An activity flow should implement a Configure method to declare which activities are executed, and how they are executed. You can configure an activity flow to override another flow of the same name and mode by setting a higher priority. The default priority is zero (0). For example, you configure two flows with the same name and all in beta mode:

[ActivityFlowConfiguration(Name = “Example”)]
public class BetaExampleActivityFlow : ActivityFlow
[ActivityFlowConfiguration(Name = “Example”, Priority = 1)]
public class AlphaExampleActivityFlow : ActivityFlow

When the activity flow "Example" is called in beta mode, it creates an instance of AlphaExampleActivityFlow class, not BetaExampleActivityFlow. This means that only the AlphaExampleActivityFlow is registered for the "Example" activity flow.

Note: You can register a workflow without the ActivityFlowConfiguration attribute. If a workflow is inherited from the ActivityFlow class and not decorated by the attribute, it is still registered with same name as the name of class.

Creating a new activity to send notifications

The following example creates a new workflow activity, then uses it in a new workflow. It uses this workflow to replace the shipped CartCheckout workflow. The new activity sends an automated email to store customers after an order completion. This example illustrates how to update and customize a flow.

Creating a new activity

  1. Create a Workflow Activity Library project in Visual Studio. In this example, we named the project CustomActivityLibrary1.
  2. Add a new activity to the activities project for the email. Name the activity SendNotification.
  3. Set the inheritance for the activity to Mediachase.Commerce.WorkflowCompatibility.Activity.
  4. Make sure you installed the EPiServer.Commerce.Core NuGet package.
  5. Add the code to the new activity's code-behind file (SendNotification.cs) from the Code Sample section in this document. Ensure the naming is correct, that you create the stub of the method to send the email, and that your method is called in the activity's Execute method. A stub for the method is provided in the SendEmailNotification() method. See the SendEmails method code in the /Templates/Everything/BusinessControls/CheckoutControls/CheckoutWizardModule.cs file.

    Note: Use the activity OrderGroup object reference to retrieve the information about the order to be put in the email. To generate the formatted copy of the email body text with the order information, use the Mediachase.Commerce.Engine.Template.TemplateService. See sending Order Notifications for information about the template service.

  6. Build the project.

Adding activity to activity flow

Add the activity created above (along with other activities contained in the Mediachase.Commerce.Workflow.dll) to a new activity flow. Use this activity flow to replace the CartCheckoutActivityFlow (Mediachase.Commerce.Workflow.CartCheckoutActivityFlow).

  1. Create a Activity Flow project in Visual Studio. In this example, name the project MyCustomCartCheckout.
  2. Make sure you installed EPiServer.Commerce.Core NuGet package.
  3. Add a class to the customCartCheckout project. In this example, name it CustomCartCheckout. Set the inheritance for the activity flow to Mediachase.Commerce.Engine.ActivityFlow. And decorate the class with ActivityFlowConfiguration attribute. By setting the Name as CartCheckout, you override the default implementation of Mediachase.Commerce.Workflow.CartCheckoutActivityFlow.
  4. In the activity flow file (in this example named CustomCartCheckout.cs), implement the Configure method to configure the list of activities to be executed, and add the last step to use the SendNotification activity. See the relevant code in the code sample section in this document.
  5. Build the project.
  6. Locate the newly-built assembly and copy it to the project's bin folder.
  7. Recompile, and access the website where this activity is used during checkout.

Examples

Do you find this information helpful? Please log in to provide feedback.

Last updated: Oct 24, 2016

Recommendations [hide]