OtfScreenMapping

Introduction

The HMI extension (Human Machine Interface) provides access for interacting with the user through the display of graphical screens. To achieve this goal, there are two ways to operate with screens:

1. Basic Screen - A set of basic dialogs providing by the operating systems
2. Custom Screens - Customizable screens that allow arbitrary flexibility

Custom screens only define an interface to a screen. The screen itself is externally created. The layout and functionality of this screen is not defined in the OTX. The interface to the screen is the OTX Screen Signature. A Screen Signature defines all IN-, OUT- and INOUT-Parameters of a screen. The OTX Runtime have to map the Screen Signature Parameters to the proper screen controls. The OTF supports two kinds of Custom Screens:

1. Generic Screen
2. Screen Mapping

Screen Mapping

In principal the Screen Mapping bounds the properties of controls found in a form of an .NET assembly (*.dll or *.exe) to OTX Screen Signature Parameters via Data Binding. In opposite to the Generic Screen, which is completely generic, easy to use but limited, the Screen Mapping is not limited related to the layout or the used controls.

Windows Forms

For the Screen Mapping the user have to create an executable application (*.exe) or an assembly (*.dll) with one or more Windows Forms. This job can be done graphically with the Windows Forms Designer of Microsoft Visual Studio or with free Forms Designer of SharpDevelop. All controls found in that form can be bound to Screen Signature Parameters via the Screen Mapping Editor, see below. The form can contain arbitrary program logic or can be just a form with controls and without internal logic.

Screen Mapping Editor

The "HMI" page allows for managing the screen mapping files

The "Screen Mapping Editor" dialog box and the "Signature/Screen-Mapping" dialog box

In this page, you can create the screen mapping files to bind the screen signatures to GUI controls of external applications.

To create a screen mapping file, please proceed as follows:

1. Click on the "New" button.
2. In the "1. Step*" section, click "Add*" button.
3. Select a screen signature in the "1. Step**" section and select the application in the "2. Step**" section.
4. If there is no application has been added before, click "Add" button in the "2. Step**" section, find and select an application and click "Open" button.
5. If the loaded application is a WPF form, you have to select "WPF Window" in the "Screen Type" drop-down list.
6. Click "OK**" button.
7. After that, click "Add*" button in the "Step 2*" section.
8. In the new row, click on the drop-down list in the first cell and select a screen parameter.
9. Continue to select a value for the application control, the property and the event.
10. Click "OK*" button.
11. Enter the name for the new screen mapping file and click "OK" button.
12. To use the screen mapping file, please select it in the "Runtime Environment" page above or in the "Runtime Environment" tab of the Ribbon.

(* implies that it belongs to the "Screen Mapping Editor" dialog box, ** implies that it belongs to the "Signature/Screen-Mapping" dialog box)

To edit a screen mapping file, select the screen mapping file and click the "Edit" button or just double-click on the screen mapping file.

To delete a screen mapping file, select the screen mapping file and click the "Delete" button.