The DialogConditionTypeis used to represent Conditionsas dialogs. It is illustrated in Figure 10and formally defined in Table 24.

image013.png

Figure 10- DialogConditionType Overview

Table 24– DialogConditionType Definition

Attribute

Value

BrowseName

DialogConditionType

IsAbstract

False

References

NodeClass

BrowseName

DataType

TypeDefinition

ModellingRule

Subtype of the ConditionType defined in clause 5.5.2

HasComponent

Variable

DialogState

LocalizedText

TwoStateVariableType

Mandatory

HasProperty

Variable

Prompt

LocalizedText

PropertyType

Mandatory

HasProperty

Variable

ResponseOptionSet

LocalizedText [ ]

PropertyType

Mandatory

HasProperty

Variable

DefaultResponse

Int32

PropertyType

Mandatory

HasProperty

Variable

LastResponse

Int32

PropertyType

Mandatory

HasProperty

Variable

OkResponse

Int32

PropertyType

Mandatory

HasProperty

Variable

CancelResponse

Int32

PropertyType

Mandatory

HasComponent

Method

Respond

Defined in Clause 5.6.3.

Mandatory

The DialogConditionTypeinherits all Propertiesof the ConditionType.

DialogState/Idwhen set to True indicates that the Dialogis active and waiting for a response. Recommended state names are described in Annex A.

Promptis a dialog prompt to be shown to the user.

ResponseOptionSetspecifies the desired set of responses as array of LocalizedText. The index in this array is used for the corresponding fields like DefaultResponse, LastResponseand SelectedOptionin the Respond Method. The recommended localized names for the common options are described in Annex A.

Typical combinations of response options are

  • OK
  • OK, Cancel
  • Yes, No, Cancel
  • Abort, Retry, Ignore
  • Retry, Cancel
  • Yes, No

DefaultResponseidentifies the response option that should be shown as default to the user. It is the index in the ResponseOptionSetarray. If no response option is the default, the value of the Propertyis -1.

LastResponsecontains the last response provided by a Clientin the Respond Method. If no previous response exists, then the value of the Propertyis -1.

OkResponseprovides the index of the OK option in the ResponseOptionSetarray. This choice is the response that will allow the system to proceed with the operation described by the prompt. This allows a Clientto identify the OK option if a special handling for this option is available. If no OK option is available, the value of this Propertyis -1.

CancelResponseprovides the index of the response in the ResponseOptionSetarray that will cause the Dialog to go into the inactive state without proceeding with the operation described by the prompt. This allows a Clientto identify the Cancel option if a special handling for this option is available. If no Cancel option is available, the value of this Propertyis -1.