- Naming Conventions

This section provides the common rules for names, paths, folders, files, and so on.

Common Rules for Names and Paths in the Management System

Item

Special Characters and Delimiters

Notes

Names

  • Must start with an alphabetic character. ("A...Z", "a...z", underscore "_" and the digits "0...9".
  • Must not contain any special characters such as : . * # $ @
  • Avoid using umlauts such as "ä", "ö", "ü" as their corresponding keys might not be available for international use. Also, the umlauts might not display correctly in foreign language systems.
  • Names are case sensitive
  • Name must be unique, well-readable, and context-oriented within the systems.
  • Use short naming conventions (max 20 to 30 characters) to meet the processing speed and disk space requirements.
  • For example, in standard applications such as Alarms and Events, correct maximum length of the names defines the correct display on the UI.

Paths

  • Paths are case sensitive.
  • Do not use spaces in the path.

 

Folders and File Names

  • Do not use characters such as , . ; / ? @ & = + $ < > # % { } │ \ ^ [ ] ‘

 

Naming Rules for Subsystem Elements

Item

Special Characters and Delimiters

Notes

System names (for example, Desigo CC)

  • Do not use characters such as blank space \ / " ? < > * │ : ; '
  • Do not use the characters such as . and : as separators of the complete element address.
  • A unique, well readable and context-oriented name within the systems.

Data point names / CNS name

For example: BACnet object names

  • Do not use characters such as blank space , . : ; ! ? [ ] { } / \ \\ │ * % @ \t $ % " '
  • Do not use the following characters as they are used in SQL queries + / ? % # &
  • Do not use characters such as '.' and ':' as separators of the complete element address.
  • You can use the underscore _ as the first character
  • If the import data in files such as (csv, s1x, and so on) contains data point or CNS names with special characters, then during import, the importer either ignores or skips these characters or replaces them with an underscore _

 

System description

For example: BACnet object description

  • You can use all characters except . in object descriptions.
  • If . is present in the description, it is replaced with _ during import.
  • You can enter descriptions in several languages in case of multilingual projects. For display (in panels, for example), individual fonts/sizes can be used as per the language.

User designation (UD) name

 

  • You can use all characters except : and *
  • If these characters are present in the user designations, then during import they are replaced with ;