Quan Mai
Feb 9, 2015
  4221
(2 votes)

Building your custom Commerce workflow project

Recently we released EPiServer Commerce 8.7.1, with many updates, and the most important thing is to update our workflows to take advantages of new inventory system, and, to merge the two projects – Mediachase.Commerce.Workflow and Mediachase.Commerce.Workflow.Activities into one. The reason? To help simplifying the steps you need to build your customer workflow project. The project source code can be found here: http://world.episerver.com/download/Items/EPiServer-Commerce/episerver-commerce-8-tools-and-code-samples/

So if you have custom workflow project, you will need to rebuild it to apply new chances from our workflows. A few notes that might save you some headaches:

- You only need to install EPiServer.Commere.Core to your workflow project. Remove reference to old Mediachase.Commerce.Workflow.Actitivies.dll. If you are customizing by using our project (Build to Mediachase.Commerce.Workflow.dll), make sure to remove the reference to itself. This has been noted in our release notes.

- If you use activities from Mediachase.Commerce.Workflow.Activities in your own workflows, make sure to update namespaces to use Assembly=Mediachase.Commerce.Workflow (remove “.Activities” part).

- EPiServer Commerce 8.7.1 was built with EPiServer.CMS.Core 7.19.1. Build your workflow project before upgrading to later version of CMS/Framework (7.19.2, for example). The reason was to build workflows, Visual Studio will use msbuild and call to Microsoft’s WorkflowCompilation target, which does not care about the assembly binding redirects (defined in web.config or app.config). It cannot load EPiServer.Business.Commerce.dll 7.19.1 because it can’t load EPiServer.Framework.dll 7.19.1, and will throw a very cryptic message: "Compilation failed. Unable to load one or more of the requested types. Retrieve the LoaderExceptions property for more information."

Then you can build your custom project and experience interesting features of our new inventory service system.

Feb 09, 2015

Comments

Arve Systad
Arve Systad Feb 9, 2015 11:43 AM

I spent nearly a whole day struggling with this.

Future updates should be such that stuff released at the same time (typically the same "Update XX" patch) should be built all with the same, newest versions. If workflows can't be built with the newest CMS-version, it should be re-released with the same dependencies as the newest CMS-version. So in effect: "Update all" should be possible to do on the EPiServer nugets at any time without breaking the build (unless there are breaking changes to the APIs of course, which would be the exception).

K Khan
K Khan Feb 9, 2015 03:38 PM

+1 for Arve suggestion

Luc Gosso (MVP)
Luc Gosso (MVP) Feb 13, 2015 01:56 PM

I finaly got my workflow-project working in CMS 7.19.2. What i did was to download 7.19.1 separatly, and referenced my workflow project to these DLLs. Anyhow this is not desirable approach. I wonder what will happen on next update.

Luc Gosso (MVP)
Luc Gosso (MVP) Feb 13, 2015 02:05 PM

It seems that i have a similar error in commerce manager now. I did upgrade Mediachase.ConsoleManagerUpdate.sln thru PackageManagerConsole in VS2013 and when running Commerce manager i do get "Could not load file or assembly 'EpiServer.Implementatio, Version 7.19.1' or one of its dependencies". Even thought i have assembly bindings redirects to 7.19.2 in web.config in the commerce folder. How come? is it related?

Luc Gosso (MVP)
Luc Gosso (MVP) Feb 16, 2015 02:27 PM

Regarding Mediachase.ConsoleManagerUpdate. I did downgrad to 7.19.1 and it works. what does that mean --> never use Update-Package to the latest version? how should we know that "EPiServer Commerce 8.7.1 was built with EPiServer.CMS.Core 7.19.1."??

Please login to comment.
Latest blogs
AEO/GEO: A practical guide

Search changed. People ask AI tools. AI answers. Your content must be understandable, citable, and accessible to both humans and machines. That’s...

Naveed Ul-Haq | Feb 17, 2026 |

We Cloned Our Best Analyst with AI: How Our Opal Hackathon Grand Prize Winner is Changing Experimentation

Every experimentation team knows the feeling. You have a backlog of experiment ideas, but progress is bottlenecked by one critical team member, the...

Polly Walton | Feb 16, 2026

Architecting AI in Optimizely CMS: When to Use Opal vs Custom Integration

AI is rapidly becoming a core capability in modern digital experience platforms. As developers working with Optimizely CMS 12 (.NET Core), the real...

Keshav Dave | Feb 15, 2026

Reducing Web Experimentation MAU Using the REST API

Overview Optimizely Web Experimentation counts an MAU based upon the script snippet rendering for evauluation of web experiement. Therefore when yo...

Scott Reed | Feb 13, 2026