Nuxeo Online Services

Naming Conventions

Updated: December 11, 2018 Page Information Edit on GitHub

This page offers naming conventions for customizing Studio items to facilitate usage, maintenance and support.

We strongly encourage you to follow these, especially if you are a beginner.

General rule

  • Use pascal case naming convention (initial uppercase letter).
    • Example: PascalCase
  • Avoid using hyphens (-) and use underscore. They will prevent your items to be usable by automation scripting.

Nuxeo Studio Modeler

Content Model

Item Rules Example
Document types Pascal case naming convention ContractLibrary
Schemas Lower case, separated by underscore only if readability is affected contractlibrary
Properties Pascal case naming convention ContractNumber
Lifecycle Pascal case naming convention ContractLifecycle
Lifecycle state Camel case, not separated ingestionInProgress
Lifecycle transition to_ followed by the lifecycle state name to_ingestionInProgress
Structure templates Pascal case naming convention ContractLibraryStructure

Workflow

Item Rules Example
Workflow template WF_ followed by the workflow template name WF_Contract
Workflow task TK_ followed by the workflow task name and the associated workflow template TK_ContractReview_WF_Contract

Page Providers

Item Rules Example
Page Providers PP_ followed by the document type name (if searching for a specific document type), and the search name PP_Obsolete_Contracts

Automation

Item Rules Example
Automation chains AC_ followed by the associated document type (if specific to a particular document type) and the automation name. AC_Contract_UpdateLifecycle
Automation scripting AS_ followed by the associated document type (if specific to a particular document type) and the automation name. AS_Contract_CreationPrefill
Event handlers EH_ followed by the associated automation chain/scripting name EH_AS_Contract_CreationPrefill

Templates

Item Rules Example
Document templates DT_ followed by the document template name DT_ContractReport
Mail templates MT_ followed by the mail template name. If relevant, add the corresponding workflow task triggering the mail template, an event, a button etc. MT_TK_ContractReview_WF_Contract

Roles and Permissions

Item Rules Example
Permissions Pascal case naming convention ReadWithoutDownload

Vocabularies

Item Rules Example
Vocabularies VOC_ followed by the property name (if relevant), and the vocabulary name VOC_ContractProvider

Advanced Settings

Item Rules Example
XML Extensions XML_ followed by the extension point type (actions, notifications, providers, doctype...) and the configuration name. If relevant, add the associated document type, automation chain, workflow task triggering the mail template, an event, a button etc. XML_notification_Contract_OnCreation

Nuxeo Studio Designer

Layouts

All elements from the Layout tabs are auto-generated by Nuxeo Studio Designer

UI

Item Rules Example
Document pages DP_ followed by the associated document type (if relevant), and the page name DP_Contract_Attachments
Left menu items LM_ followed by the associated document type (if relevant), and the page name LM_Contracts
Main menu pages MM_ followed by the associated document type (if relevant), and the page name MM_Contracts
Actions Button_ followed by the associated automation chain or automation scripting Button_AC_Contract_UpdateLifecycle
Themes Theme_ followed by the associated project Theme_ContractManagement
3 days ago manonlumeau Transition state naming convention
3 days ago manonlumeau Update due to review
a month ago Loubna Benzaama Fix Naming Conventions
a month ago Loubna Benzaama Greg feedback
a month ago Loubna Benzaama Fix naming conventions
a month ago Loubna Benzaama Add Confluence section
a month ago Loubna Benzaama Integrate Manon s feedback
2 months ago manonlumeau NXDOC-1650 fix about integrating changes, add mention on multiple attempts
3 years ago Karin Touchie 25
3 years ago Solen Guitter 24 | Fix format and TOC
4 years ago Vincent Dutat 23
5 years ago Solen Guitter 22 | Updated operation link to use Explorer
7 years ago Solen Guitter 20 | Added TOC
7 years ago Solen Guitter 21 | Migrated to Confluence 4.0
7 years ago Frédéric Vadon 19
7 years ago Frédéric Vadon 18 | typo
7 years ago Frédéric Vadon 17
7 years ago Frédéric Vadon 16
7 years ago Frédéric Vadon 15
7 years ago Frédéric Vadon 14
7 years ago Frédéric Vadon 13
7 years ago Frédéric Vadon 12
7 years ago Frédéric Vadon 11
7 years ago Frédéric Vadon 10
7 years ago Frédéric Vadon 9
7 years ago Frédéric Vadon 8
7 years ago Alain Escaffre 7
7 years ago Frédéric Vadon 6
7 years ago Frédéric Vadon 5
7 years ago Frédéric Vadon 4
7 years ago Frédéric Vadon 2
7 years ago Frédéric Vadon 3
7 years ago Frédéric Vadon 1
History: Created by Frédéric Vadon

We'd love to hear your thoughts!

All fields required