Nuxeo Server

Workflow Models Packaging

Updated: November 13, 2017 Page Information Edit on GitHub

This page deals with how a workflow model is created on a Nuxeo instance. Note that when using Nuxeo Studio, everything is done transparently. The goal of this page is to let you understand what Studio generates in the JAR when you use the Studio feature and how the workflow is created and persisted when deploying the Studio project.

Nuxeo workflows are declared via the following contribution:

<extension target="org.nuxeo.ecm.platform.routing.service" point="routeModelImporter">
<template-resource id="TimeOffRequest" path="data/TimeOffRequest.zip"/>
<template-resource id="TimeOffUpdateCancelRequest" path="data/TimeOffUpdateCancelRequest.zip"/>
</extension>

As you can see, the workflow definition is referenced in a zip "data/TimeOffRequest.zip" (that is in the JAR bundle). In this zip you find the serialization in core-io format of the workflow graph: the parent document corresponds to the workflow model, and you have as many children as there are nodes in your graph.

Workflow and nodes, with their properties configured from Studio, are serialized as Nuxeo documents.

Once the runtime deploys the bundle that contains such a contribution, the workflows are created from the archive, under the path /document-route-models-root. The workflow model is persisted as a document of type "DocumentRoute" and children nodes as documents of type "RouteNode". You can see the list of workflow models in the Admin Center (see the workflows deployed on the demo site).

Once deployed, depending on what has been set as the availability criteria for your workflow in Studio (stored on the DocumentRoute document, field docri:availabilityFilter) you will see the workflow in the "start workflow" drop down list on the summary of the document. You can now start a new workflow.

5 days ago manonlumeau Added content-review-lts2017 label
a month ago manonlumeau NXDOC-1346-FT review screenshot
2 years ago Alain Escaffre 12
2 years ago Manon Lumeau 11
4 years ago Solen Guitter 10
4 years ago Mariana Cedica 9
4 years ago Mariana Cedica 8
4 years ago Mariana Cedica 7
4 years ago Solen Guitter 6
4 years ago Alain Escaffre 5
4 years ago Alain Escaffre 3
4 years ago Alain Escaffre 4
4 years ago Alain Escaffre 2
4 years ago Alain Escaffre 1
History: Created by Alain Escaffre