Extensions.HMI.ShowDocumentDialog
Classification
Name | ShowDocumentDialog |
Short Description | Dialog that can display a document |
Class | Action |
Extension | OTX HMI extension |
Group | Dialog related actions |
Exceptions | InvalidReferenceException |
Checker Rules | - |
Standard Compliant | Yes |
OTL Syntax
HMI.ShowDocumentDialog(StringTerm message, StringTerm title, StringTerm document);
Description
The ShowDocumentDialog activity will open a dialog that can display a document which is identified by e.g. a URI. The document can be any resource. The call will block until the user has confirmed reading the document.
Typical usage of this node is to show additional documentation to the users, such as repair guides and schematics, or lengthy security information that the user must read before proceeding with a potentially dangerous operation.
In case that a document type can not be opened and displayed by the test application itself, the runtime may delegate the opening of the document to the application which is registered for that document type on the operating system.
Ultimately, if a document type is supported neither by the test application nor by any external viewer, then the test application shall show a suitable error message indicating that the document type is not supported and can therefore not be displayed.
Properties
Name | Data Type | Class | Default | Cardinality | Description |
Document | String | Term | - | [1] | This element identifies the external document that should be shown. |
OTL Examples
/// Local Declarations
/// Flow
HMI.ShowDocumentDialog( "Message", "Title", "file:///D:/abc.txt");