Create a new Parameter Schema

Click the New button and the schema screens appear.

Entity Type Settings

The Entity Type Settings tab has the following fields:

Entity Type Name -- An identifier for the schema.

Description -- A text description for the schema.

Category -- A category for the schema.

Version -- An automatically-created version number.

Attribute Settings

Click the New Attribute button and select the attribute type and open editor panel and configure the attribute. Configured attributes appear in a tree to the left of the editor panel. Click a listed attribute to edit it after it has been created.

The editor panel has the following fields:

Label -- An identifier for the attribute. These can have spaces, but not underscores.

Description -- A text description for the attribute.

The following tabs may appear, depending on the type of attribute you are configuring (some are absent). Additional fields may appear, depending on the attribute type you are configuring:

Datatype Settings

Default Value -- An optional default value for the attribute.

Collection Settings

Is Collection? -- Check to classify this attribute as a collection.

Allow Duplicate Values -- Check to enable allowing duplicates.

Allow Reordering -- Check to enable allowing reordering.

Collection Min / Max Length -- Enter the minimum/maximum number of characters in this attribute.

Properties

Upper / Lower Case -- Check to validate on case.

Case Insensitive -- Validation ignores case.

Multi Line Text -- Check to enable multiline text.

One Way Encrypt -- Check to encrypt.

Truncate -- Truncate the attribute.

Attribute Settings

You can create new attribute schemas. See Attribute Editor Panels below for information about different datatypes’ fields. Once you create a set of attributes, they remain available for re-use as a schema, or collection of attributes. To identify schemas, enter the following fields:

Label -- A unique, mandatory identifier for the collection of attributes.

Description -- A text description of the entity.

Click New to create or select an attribute in the displayed tree and click Edit to open an editor where you can create or modify attributes. Select an attribute and click Remove to delete it from the list.

Attribute Editor Panels

The following panels appears, depending on the attribute type selected from the pick list. The fields in the editor depend on this selection. Available types include Boolean, Coded Value, Date, Decimal, IP Address, Integer, Long, Inventory Reference, and Select the Reference Type entity with the list that appears when you click the green plus (+), then use the side-by-side widget’s arrows to move available attributes from Available to Selected. You can change the Reference Type by deleting it with the red minus (-), then selecting a new type with the green plus.String. The following fields appear for each of these types (omitting redundant fields):

Configure the data type of an attribute before you save a task. After attributes are in Scripts, you cannot change the data type.

Boolean

Default Value -- Check for True.

Coded Value

Default Coded Value -- Enter the default coded value. If an attribute a Coded Value then enter valid values in the format of NUMBER:Display Label. For example:

10:Hello World

20:Hello Moon

Without this pattern a validation error appears. Coded values become a Drop Down (Combo Selection) at runtime containing the Display labels within it (like Hello World, Hello Moon). Selecting one gives the script the numeric value (If users select Hello World, the value the script gets is 10)

The default appears by default in this list of alternatives. Enter any other alternatives below this field in the Valid Values.

Valid Values -- Enter a valid value in the line above the table of valid values, then click the green + to add the value entered to the list. Click the Remove icon (the red -) to delete a selected value. These must be formatted like the Default Coded Value.

Date

Default Value -- Enter a default date, or use date icon to display a calendar where you can select one. Click off the calendar to make it disappear.

Valid Values -- Enter valid date values above the list, and click the green plus to add them to the list.

Decimal

Default Value -- Enter a single or range of default decimal values.

Constraints --Enter a range of acceptable numbers separated by a colon. For example, Constraints = 2:4096. At runtime, a field where you can enter numbers. validates that entered numbers are between 2 and 4096 when running the Adaptive CLI. If you enter a number outside this range, a validation message appears and the attribute name turns red. You can also include several numbers or ranges separated by the pipe (|) character. If you specify a range, the lowest number must be to the left of the highest number. For example 9:99|999:1010.

Valid Values -- Enter valid decimal range values, and click the green + (the red - removes them). You can manage these as described in Coded Value above.

IP Address

See also Validating IP Address Variables.

Default Value -- Enter a default IP Address.

Valid Values -- Enter valid values as described in Coded Value above. Check IP Mask, Subnet, Allow 32 Bit Mask, and Allow Any Valid Ip in the Properties tab if you want the values entered to be those.

Editable Valid Values -- Check to enable editing of default or entered IP addresses.

Integer

Default Value -- Enter a default integer.

Constraints --Enter a range of acceptable numbers separated by a colon. You can also include several numbers or ranges separated by the pipe (|) character. If you specify a range, the lowest number must be to the left of the highest number. For example 9:99|999:1010.

Valid Values -- Enter ranges of valid values as described in Decimal above.

Editable Valid Values -- Check to enable editing of default or entered integer.

Long

Default Value -- Enter a default long.

Constraints --Enter a range of acceptable numbers separated by a colon. You can also include several numbers or ranges separated by the pipe (|) character. If you specify a range, the lowest number must be to the left of the highest number. For example 9:99|999:1010.

Valid Values -- Enter ranges of valid values as described in Decimal above.

Inventory Reference

Select the Reference Type entity with the list that appears when you click the green plus (+), then use the side-by-side widget’s arrows to move available attributes from Available to Selected. You can change the Reference Type by deleting it with the red minus (-), then selecting a new type with the green plus.String

Default String -- Enter a default string.

Valid Values -- Enter valid values as described in Coded Value above.

Editable Valid Values -- Check to enable editing valid values.

Constraint --Enter the regular expression constraints, if any, on the string attribute.

Constraint Description --Enter the message to appear if the regular expression constraints are not met.

Min / Max Length -- Enter the minimum / maximum number of characters in a valid string.

Click Apply to accept your edits for the attribute, or Cancel to abandon them.