Previous Topic Next topic Print topic


Enabled Condition

Enabled Condition is a general model class in which relationships can be linked to actions, tools or dialog input fields. This determines the conditions under which the execution of an action or tool is permitted or an input dialog field is editable, grayed out or hidden.

The boolean attribute Hide triggers whether the disabled action or dialog field will be grayed out or completely hidden from a UI context menu or dialog. This attribute is ignored for tool enabled conditions.

When modeling an enabled condition, the administrator defines the permitted values for certain properties, so that the action can be executed. By doing this, simple and complex rules can be defined, where complex rules link the simple rules via operators.

Simple Enabled Condition Example:

  • "If Property “Stage” has the value "DEV1", the action can be executed".

A Complex Enabled Condition contains any number of simple and complex enabled conditions, and links these via operators.

In addition, the number of resources that can/must be selected so that an action is executable can be determined for an enabled condition. This value is ignored for tool enabled conditions and for dialog fields enabled Conditions.

Attribute Type Meaning
Selection_Count [O] String Number of resources that must be selected for the referenced action to be executable.

Permitted values:

* = Number of resources is irrelevant

0 = No resources may be selected

n = Exactly n (n = 1,2,3,...) resources must be selected

[*|n]-[*|n] = A range of numbers (e.g. “2-*” = at least two resources must be selected)

Hide * Boolean Determines whether a disabled action or input dialog field will be grayed out or completely hidden from a UI context menu or dialog.
Complex_Enabled_Condition (0..1)[D] Complex Condition Complex condition. Consists of several conditions brought together.
Simple_Enabled_Condition (0..1)[D] Simple Condition Simple condition. Checks a property value for a specific value.
Modeling Action Enabled Condition

The enabled condition for an element action is defined here. It begins with a complex enabled condition (center, bottom), which links the two simple enabled conditions (lower left and right) with the AND operator. AWM interprets this model as follows:

Action ACT_X from ElementType ELE1 can only be executed if the property value of PROP_Protected is false and corresponds to the property value of Property PROP_Group “TEST”. In addition, exactly one Element must be marked.

A simple enabled condition checks a property value for a defined value or status, and activates or deactivates the action depending on the result of the check.

Attribute Type Description
TargetID Property Reference to the property whose value should be checked.
Operator Selection The check operator.

Valid values include:

  • Equals…(+ Value)
  • Equals not…(+ Value)
  • Regular Expression... (+ Value)

  • NULL
  • NOT_NULL
  • TRUE
  • FALSE
Value [D] String A fixed value that is compared with that of the Property.

The meanings of the various operators are shown in the following table:

Operator Meaning Example
Equals… Checks whether the property value of the referenced property has the same value as specified in "Value". The action can only be executed if the selected element is a COBOL program:

TargetID = PROP_Type

Operator = Equals…

Value = COBOL

Equals not… Checks whether the property value of the referenced property has a value different from the specified "Value". The action can only be executed if the selected element is not in production:

TargetID = PROP_Stage

Operator = Equals not…

Value = PROD

Regular Expression Checks whether the property value of the referenced property matches with the regular expression specified in "Value".

This check is not case sensitive.

The action can only be executed on COBOL files:

TargetID = PROP_FileSuffix

Operator = Regular Expression…

Value = (cbl)|(cob)

NULL Checks whether the referenced property has no property value. The action can only be executed if the selected element has no access key:

TargetID = PROP_AccessKey

Operator = NULL

NOT_NULL Checks whether the referenced property has any property value. The action can only be executed if the selected element has a change date:

TargetID = PROP_ChangeDate

Operator = NOT_NULL

TRUE Checks whether the referenced property has the Boolean value true. The valid value for true which is checked during run time is defined in the property definition. The action can only be executed if the selected element can be edited:

TargetID = PROP_Editable

Operator = TRUE

FALSE Checks whether the referenced property has the Boolean value false. The valid value for false which is checked during run time is defined in the property definition. The action can only be executed if the selected element is not write-protected:

TargetID = PROP_Protected

Operator = FALSE

Previous Topic Next topic Print topic