Fluent Commerce Logo
Docs
Sign In

Workflow Naming Convention

Essential knowledge

Author:

Fluent Commerce

Changed on:

24 Oct 2023

Overview

The Workflow Naming Convention is a set of guidelines recommended for Orchestrated Entity Types in the Fluent Order Management System. This convention will help you:

  • Apply best practices for naming entities to achieve better implementation standards;
  • Make names consistent and ensure that names are recognisable and can be supported in the future;
  • Avoid unexpected system behaviour and decrease the likelihood of error because of incorrect symbol or space usage.

Key points

  • The Naming Best Practice of workflow rule and ruleset.

Naming Best Practice

  • Orchestrated Entities Types are named consistently
  • Use intuitive, familiar terminology where possible
  • Orchestrated Entities Type names should be short and descriptive (no more than 25 characters)
  • Use only English characters
  • Orchestrated Entities Types names are case sensitive, e.g., "CLICK_COLLECT" and "click_collect" are two different Types
  • Use uppercase letters and underscores (uppercase snake) for word separation, e.g., MY_ORDER_TYPE
Not Recommended:
  • Unclear, vague words or abbreviations that are not commonly understood
  • Regionally specific terms and phrases can be spelled differently in different versions of English (for example, fulfillment and fulfilment)
Not Supported:
  • Symbol characters: < > \ / | " ? [ ] ; = + & $ α β
  • Non-English-based symbols as part of the name, e.g., ü, ä, ß
  • Spaces are not supported. We recommend using underscores (_) instead, e.g., use 
    `MY_CUSTOM_TYPE`
     and not 
    `MY CUSTOM TYPE`

Example Names: Order Types

Consider the following examples when you create a new Order Type.

  • `ONLINE_HD`
     - standard eCommerce order type with the home delivery method
  • `ONLINE_CC`
     - standard eCommerce order type with the click-and-collect delivery method
  • `TRANSFER`
     - orders for moving stock from store to store
Fluent Commerce

Fluent Commerce

Copyright © 2024 Fluent Retail Pty Ltd (trading as Fluent Commerce). All rights reserved. No materials on this docs.fluentcommerce.com site may be used in any way and/or for any purpose without prior written authorisation from Fluent Commerce. Current customers and partners shall use these materials strictly in accordance with the terms and conditions of their written agreements with Fluent Commerce or its affiliates.

Fluent Logo