Forms Inside InTouch OMI

You can use forms inside InTouch OMI.

1. Complete the Initial Steps.

2. In the System Platform IDE, double-click on the instance of the view app.

   The instance of the view app is opened.

3. On the Toolbox tab, click WorkTaskApp, and then drag and drop the Fillform control to a panel in the Layout.

4. On the Properties tab, map or enter the Workflow Gateway.

5. On the Properties tab, map or enter the Form Name.

6. On the Properties tab, map or enter the Form Version, if required.

   Note: If the version of the form is not specified, then the system makes use of the latest published version of the form.

7. On the Properties tab, map or enter the Input XML, if required.

8. On the Properties tab, set the Display Alert Message to True, if you want to display an alert message when the form is submitted.

9. On the Properties tab, set the Default User Always to True, if you want to specify the default user. Otherwise, the user who configured the Workflow Gateway object will be considered as the default user.

10. On the Properties tab, map or enter the Default User, if the Default User Always is set to True. The user set here will be considered as the user for submission of the form.

11. On the Properties tab, configure other settings as required.

12. Click Save.

    The control, along with the set properties, is saved.

13. Click Preview to preview the Fill Form in InTouch OMI, if required.

14. In the System Platform IDE, right-click on the instance of the view app, and then click Deploy.

    The Deploy dialog box appears, and shows the progress of the deployment.

15. Click Close.

    The Fill Form can now be used inside InTouch OMI.

16. Run Wonderware Application Manager, and then click Launch for the configured instance of the view app to use the Fill Form.

Note:
- The Fill Form control shows published forms including those not associated to workflows. It even shows forms disabled in the Enterprise Console.
- If Security Level changes are made with respect to the rights given to the user, then the view app should be redeployed before previewing the Fill Form.
- When running Wonderware Application Manager, if you get an error that “You should be part of either the Administrators, SkeltaAdmins, or SkeltaRemoteUsers role.”, then run Wonderware Application Manager as an Administrator.

If InTouch OMI is setup on a different machine, then launching the instance of the view app will lead to an error about unauthorized user. In such cases, configure the Internet Options as follows:

17. On the Security tab, under Select a zone to view or change security settings, click Trusted sites.

18. Click Sites, in the Add this website to the zone box, type the URL of the Enterprise Console set for the Workflow Gateway object, click Add, and then click Close.

19. Under Security level for this zone, click Custom level.

20. Under Settings, browse to User Authentication > Logon and click Automatic logon with current username and password, and then click OK.

21. Click OK to close Internet Options.

Passing Contextual Information in Forms from InTouch OMI

You can pass real-time value from InTouch OMI property to Fill Form control. Passing contextual information through attributes or hard-coded value is supported only for String data type.

The XML that is passed populates values of the controls on the form when loading the form. You can pass only the XML for the required controls. However, ensure the XML matches the syntax of the instance XML and does not exceed 1023 characters.

Example

To populate only the text controls TEXTINPUT1 and TEXTINPUT2:

Script the XML as follows:

<SKRootDefinition><TEXTINPUT1>Value1 </TEXTINPUT1><TEXTINPUT2>Value1</TEXTINPUT2></SKRootDefinition>

OR

Bind the attribute as follows:

InputXmlAttribute="<SKRootDefinition><TEXTINPUT1>"+Galaxy:Drum_Conveyor.DrumCount+"</TEXTINPUT1><TEXTINPUT2>"+Galaxy:Drum_Conveyor.Speed+"</TEXTINPUT2></SKRootDefinition>";

Here InputXmlAttribute, Galaxy:Drum_Conveyor.DrumCount, and Galaxy:Drum_Conveyor.Speed are attributes, and the InputXmlAttribute attribute is of string data type.

Passing Contextual Information in Forms using Navigation App

You can pass the contextual information from the selected Asset using Navigation app to Fill Form control. When you use the Navigation app, you need to enter the attribute names in braces {}.

Example:

Form Name: {Attribute001}

Form Version: {Attribute002}

Input XML: {Attribute003}

Form Name is read from the {Attribute001} of the selected Asset.

Form Version is read from the {Attribute002} of the selected Asset.

Input XML is read from the {Attribute003} of the selected Asset.