Skip to end of metadata
Go to start of metadata

Introduction

  • Object names are added in a number of places for
    • workflows, jobs, variables, locks, file order sources, job resources, folders,
    • calendars, schedules.
  • The article explains naming rules to be considered when adding object names and labels.
  • JS7 does not enforce naming conventions for objects: users are free to choose naming conventions at their will, e.g. for job names to use 
    • camel case style as in: loadDataWarehouseDaily
    • mixed style as in: DataWarehouse-Load-Daily

Character Set

JS7 basically allows use of Unicode characters for object names.

Object Names

In addition a number of restrictions apply:

  • Naming Rules
    • The following naming rules for Java object names have to be considered: https://docs.oracle.com/javase/specs/jls/se7/html/jls-3.html#jls-3.8
    • No control characters are allowed: [^\\x00-\\x1F\\x7F\\x80-\\x9F]
    • No punctuation characters are allowed, however, dots '.', underscore '_' and dash '-' are allowed: [^\\x20-\\x2C\\x2F\\x3A-\\x40\\x5B-\\x5E\\x60\\x7B-\\x7E\\xA0-\\xBF\\xD7\\xF7]
      • Dot: not allowed as leading or trailing character and not two dots in sequence.
      • Dash: not allowed as leading or trailing character and not two dashes in sequence.
    • Spaces are not allowed.
    • Object Names may start with a digit.
    • Use of Java reserved keywords is not allowed:
      • "abstract", "continue", "for", "new", "switch", "assert", "default", "goto", "package", "synchronized", "boolean", "do", "if", "private", "this", "break", "double", "implements", "protected", "throw", "byte", "else", "import", "public", "throws", "case", "enum", "instanceof", "return", "transient", "catch",  "extends", "int", "short", "try", "char", "final", "interface", "static", "void", "class", "finally", "long", "strictfp", "volatile", "const", "float", "native", "super", "while"
      • Example: use of the reserved keyword "switch" is not allowed, use of "myswitch" is allowed.
  • Examples
    • National language characters such as Japanese:
      • こんにちは世界
    • Use of dot, dash, underscore:
      • Say.Hello
      • Say-Hello
      • say_hello

Labels

More relaxed rules apply to labels that are used to indicate the position of a job and order in a workflow:

  • Labels can start with digits, characters, _
  • Labels can include $, _, -, #, :, !
  • Labels cannot include whatever is not allowed for Object Names, e.g. no quotes, no spaces, [, ], {, }, /, \, =, +

Uniqueness of Object Names

Object Names in JS7 are unique per object type, e.g. per workflow, job, resource lock etc.

  • Users can add Object Names with any uppercase/lowercase spelling.
  • The object name is preserved by the JOC Cockpit GUI exactly as typed by the user.
  • However, users cannot add the same Object Name with a different spelling: assume an existing Object Name "myLock", then a new object with the name "mylock" cannot be created.

Length of Object Names

The maximum length of object names is as follows:

  • Basically object names can consume up to 255 Unicode characters.
  • The following restriction applies:
    • Objects typically are located in folders: the overall length of the folder hierarchy and object name may not exceed 255 characters.
  • Branches within a JS7 - Fork / Join Instruction are limited to 10 characters.
    • Such branches can be nested for up to 15 levels.



  • No labels
Write a comment…