Understanding Property Data Type Parameters

When you create or edit a property, you can configure the property parameters. The settings depend on the property and its data type. For example, string properties let you specify the minimum and maximum lengths of property values.

Many data types provide parameters for default values, minimum and maximum values, decimal precision, whether upper- or lower-case values are allowed, and so on. In addition, some data types let you configure a property to allow only values that you specify.

When creating a property manually or when registering a Universal application, select the template that corresponds to the data type of the property that you want to create (for example, Custom.Integer).

Parameters for All Data Types

The parameters below can be set for all property data types.

Setting Description

Default Type

Note: This field is not available when you create a property during Universal application registration. Enter the specified value in Default Value or leave it blank if no default value is used.

Specify whether or not the property has a default value.

  • None: No default value is used for the property.
  • Specified: A default value is used for the property. Specify the value in Default Value.
  • Derived: The property's default value is calculated from an expression. Click Define Expression define expression (or define expression depending on your theme) to open the expression builder and create an expression to determine the value of the property. See Using Expressions to Define Custom Business Logic.

    Note:

    This option is available only when editing property parameters.
  • Derived and Stored: The property's default value is derived from an expression during a request, import, or viewpoint load and then stored on the node. Click Define Expression define expression (or define expression depending on your theme) to open the expression builder and create an expression to determine the value of the property. See Using Expressions to Define Custom Business Logic.

    Note:

    This option is available only when editing property parameters.
  • Calculate and Store: Available on Core.Name and CoreStats.Parent properties only. When request items are created, the node name or parent value is calculated from an expression and then stored on the node (for Name) or on the request item (for Parent).

    Click Define Expression define expression (or define expression depending on your theme) to open the expression builder and create an expression to determine the value of the property. See Using Expressions to Define Custom Business Logic.

    See Calculated and Stored Properties.

Default Value

If the property uses an Allowed Values list, select a default value from that list. Otherwise, enter a default value for the property.

Editable

Note: This field is not available when you create a property during Universal application registration. After the property is created by the registration, you can access this field in the property parameters.

Specify whether or not the property is able to be edited by users.

Lock on Commit

Specify that this property can only be updated on a newly added node. If this is enabled, after the request to add a node has been committed the value for the property is locked and can no longer be updated.

Note:

This option is available only when editing property parameters.

Lock on Commit is available for node-level properties only.

Caution:

Exercise caution when using Lock on Commit so that you don't unintentionally prevent users from being able to update a property that should be updated. For example, if you enable Lock on Commit on Core.Name, users will be unable to rename the node after it has been created. Or, if you enable Lock on Commit on a property but you do not specify a value for the property, users will be unable to update the property with a value after it has been committed.

Inheritance

The type of inheritance the property uses. See Inheriting Properties.

  • None: Property values are not inherited from another node.

  • Positional: Property values are inherited from an ancestor node.

Note:

You can override inheritance parameters at the application level only.

Note:

For node data type properties only, the Default Value that you enter in conjunction with the Node Set, Allowed Node Types, and Selection criteria property parameters (see Node Data Type Parameters) will be converted to a node value as follows:

  • If only one node is found then it is used as the property value.
  • If more than one node is found, the first node in the order of the Allowed Node Types is used as the property value.
  • If a node is found but it is not one of the allowed node types or does not meet the selection criteria, the string itself is used as the property value. You will be unable to validate the viewpoint with a string value in a node data type Default Values field.
  • If no nodes matching the string and other property parameters are found, the string itself is used as the property value. You will be unable to validate the viewpoint with a string value in a node data type Default Values field.

For more information on parameters for specific data types, see: