The Dialog Model is an extension of the Conditionmodel used by a Serverto request user input. It provides functionality similar to the standard Messagedialogs found in most operating systems. The model can easily be customized by providing Serverspecific response options in the ResponseOptionSetand by adding additional functionality to derived Condition Types.

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

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.

Respondis used to pass the selected response option and end the dialog. DialogState/Idwill return to False.

Signature

Respond(

[in] Int32 SelectedResponse

);

The parameters are defined in Table 25

Table 25– Respond parameters

Argument	Description
SelectedResponse	Selected index of the ResponseOptionSetarray.

Methodresult codes in Table 26(defined in Call Service)

Table 26– Respond Result Codes

Result Code	Description
Bad_DialogNotActive	See Table 103for the description of this result code.
Bad_DialogResponseInvalid	See Table 103for the description of this result code.

Table 27specifies the AddressSpacerepresentation for the Respond Method.

Table 27– Respond Method AddressSpace definition

Attribute	Value
BrowseName	Respond
References	NodeClass	BrowseName	DataType	TypeDefinition	ModellingRule
HasProperty	Variable	InputArguments	Argument[]	PropertyType	Mandatory
AlwaysGeneratesEvent	ObjectType	AuditConditionRespondEventType	Defined in 5.10.5