IAP Naming Conventions
This guide highlights the set of rules around naming conventions for certain values inside of the Itential Automation Platform (IAP).
For custom applications, the
id in the
pronghorn.json file is a combination of the scope and the application name, which also represents the file path for the application within the
node_modules directory. For example, the scope could be
@scope and the name
app-name which would make this id
The rules for the scope and the application name are listed below:
- Must have a length of at least one character.
- Must not contain any uppercase characters.
- Must start with a lowercase character.
- Can contain a dot (e.g. ".").
- Can contain a dash (e.g. "-").
- Can contain an underscore (e.g. "_").
Parameter and Return Value Names
Parameter and Return values in methods and manual tasks are defined in the
pronghorn.json model for an application. The names of these values are restricted to the following rules:
- Must have a length of at least 1 (one) character, with a maximum length of 255.
- Can contain letters and characters from any written language that is supported in Unicode. Please see the Note below for the recommended approach.
- Can contain numbers.
- Can contain underscore (e.g. "_").
- Can contain dash (e.g. "-").
- Cannot contain punctuation from any written language that is supported in Unicode.
- Cannot start with a number or dash.
- Cannot contain other special characters.
- Cannot contain whitespace characters.
Note: It is recommended that parameter and return value names be limited to alphanumeric characters only and not unicode characters.
Job Variable Names
Any job variable names created by an automation designer within Automation Builder must follow the naming conventions and rules set forth by the Parameter and Return Value Names section above.