Nuxeo Server

How to Create an Automation Chain

Updated: September 22, 2017 Page Information Edit on GitHub

This guide explains how to create and configure an automation chain using Nuxeo Studio.

This is done in two steps:

  1. Create the chain.
  2. Bind it to a button, an action, or an event handler.

Create an Automation Chain

To create an automation chain:

  1. In the left menu, click on Automation and then on Automation Chains.
  2. Click on the New button.
  3. Give your automation chain an ID and click on the Next button.
    The automation chain editor is displayed. The Fetch > Context Document(s) is automatically added as the first operation of the chain.
  4. If needed, remove the Fetch > Context Document(s) and replace it with another Fetch operation. The Fetch operation feeds the chain with some document input, whether it is one document or a list of documents. There are various ways to fetch:
    • Context document will bring either the UI Current document, or the document attached to the event (depending on what you bound your operation chain, see later).
    • Fetch Query will bring back the result of the query as a document list.
    • Get Document fetches a document by its path.
  5. Start to drag and drop operations in the flow, respecting their input and output types. Leverage context and scripting capabilities to capture and reuse information all along the flow.

    Click on the Switch editor button to write your chain in YAML or paste a chain copied from a how-to for instance.

  6. Save your chain. You now need to bind your automation chain by creating a new action or a new event handler.

Automation Chain Binding

Binding the automation chain to a button, an action or an event handler is done in the User action and event handler edition forms.

Binding to an Action

To bind the chain to a button/action:

  1. Create a new user action from the Studio tree:
    1. In the Automation menu entry, click on User Actions.
    2. Click on the New button.
    3. On the pop up window displayed, give the action an ID, a name and select to which category of actions it should be tied (contextual icons, folder bar buttons, clipboard actions, user links...) then click on Next.
      The action edition form is displayed.
  2. Fill in all the required information : Label, icon, ...
  3. In the Action Activation section, give the necessary filtering information, to target your action to the right context.
  4. In the Action Execution section, select the automation chain to which you want the action to be bound.
  5. Click on the Save button.

Binding to an Event Handler

To bind the chain to an event handler:

  1. Create a new event handler from the Studio tree:
    1. In the Automation menu entry, click on Event Handlers.
    2. Click on the New button.
    3. On the pop up window displayed,, give the event handler an ID and click Next.
  2. Choose to which events the event handler should be bound (documentCreated, documentUpdated...) and indicate whether the chain should be run synchronously or asynchronously.
  3. In the Event handler Activation section, fill in the filtering information, to target your event handler to the right context.
  4. Choose the automation chain to which you want the event handler to be bound.
  5. Click on the Save button.

3 days ago manonlumeau NXDOC-1323: Update BDE doc
a year ago Manon Lumeau 36
a year ago Manon Lumeau 35
a year ago Manon Lumeau 34
a year ago Manon Lumeau 33 | Fix Studio menu label
3 years ago Solen Guitter 32 | link update
3 years ago Solen Guitter 31
3 years ago Solen Guitter 30
3 years ago Solen Guitter 29
3 years ago Solen Guitter 28
3 years ago Solen Guitter 27
3 years ago Solen Guitter 26
3 years ago Solen Guitter 25
3 years ago Solen Guitter 24
3 years ago Solen Guitter 23 | Update links and screenshots
3 years ago Solen Guitter 22 | Remove reference to 5.3 and formatting
4 years ago Solen Guitter 21
6 years ago Solen Guitter 19
6 years ago Solen Guitter 20 | Migrated to Confluence 4.0
6 years ago Solen Guitter 18
6 years ago Solen Guitter 17
6 years ago Solen Guitter 16 | updated screenshots and steps with latest UI
6 years ago Solen Guitter 15
6 years ago Solen Guitter 14
6 years ago Roland Benedetti 13
7 years ago Solen Guitter 12 | added screenshots and reorganized instructions
7 years ago Solen Guitter 11 | updated links
7 years ago Solen Guitter 10 | added anchors and links
7 years ago Solen Guitter 9
7 years ago Alain Escaffre 8
7 years ago Alain Escaffre 7
7 years ago Alain Escaffre 6
7 years ago Alain Escaffre 5
7 years ago Alain Escaffre 3
7 years ago Alain Escaffre 4
7 years ago Alain Escaffre 2
7 years ago Eric Barroca 1
History: Created by Eric Barroca