Installation and Configuration

For installing and configuring the Open Automation Software Server, please refer to the product documentation. To configure a web page to communicate with the server, you must include:

  • jQuery v1.8.3 or later, found at jquery.com and is also distributed with the OAS Web HMI product
  • The OAS Web HMI Script Library
  • The OAS Web HMI Stylesheet, which is used for styling modal dialogs and can be modified to fit your web design
  • A small block of Javascript containing an authentication token and URL location of the Open Automation Software Server – configuration options will be detailed below

NOTE: As of v2.6.0 of the Web HMI script library, object and attribute names have been changed to avoid confusion with OPC protocols and standards. The new object names are as follows:

  • OPC_config is now OAS_config
  • Top level OPC class used for calls such as OPC.authenticate is now OAS
  • Markup attributes are no longer prefixed opc-tag-, and are now oas-tag-.
  • Script libraries are backward-compatible, so existing code with “OPC” nomenclature will still function with no issues

To check your current script version, open an application using Web HMI in your browser, open a debug console and execute the command: OPC.version

The following is an example of a properly configured, minimal HTML page:

<html>
    <head>
        <script type="text/javascript" src="js/jquery-1.8.3.min.js"></script>
        <script type="text/javascript" src="js/opc-lib-min.js"></script>
        <link rel="stylesheet" stype="text/css" href="css/opc-style.css"/>
        <script type="text/javascript">
            OAS_config = {
                token:'7e61b230-481d-4551-b24b-ba9046e3d8f2',
                serverURL: 'http://localhost:58725'
            };
        </script>
    </head>
    <body>
        Hello World
    </body>
</html>

Of course, this example does not contain any bindings to OAS Server Tags, but contains all elements necessary to connect to a server located at http://localhost:58725 using an authentication token of7e61b230-481d-4551-b24b-ba9046e3d8f2.

Overview – Web HMI

If you are interested in visualizing your data in a desktop or mobile browser with zero programming, you may be interested in OAS Open UIEngine.
The UIEngine is a no-code robust web application and HMI builder for developing rich user interfaces all in a browser-based development environment.

For programmatic custom applications, Web HMI is an SDK for embedding real time OAS data in your own application code using Javascript.

OAS Web HMI provides a flexible, platform-independent way to integrate with Open Automation Software Servers.

  • “Controls” themselves are simply existing HTML elements marked up with attributes that are parsed at runtime, so you are free to use any web technology that you prefer, including (but not limited to) ASP.NET or .NET MVC, JSP, PHP, Ruby on Rails, or even static HTML with JavaScript.
  • Compatible with front end frameworks such as Angular and VueJS.
  • Easily integrates with existing web applications
  • Based on ubiquitous standard technologies including JavascriptjQueryJSONHTML, and CSS