You are on page 1of 72

Instruction Exaquantum Engineering Guide

Manual Volume 4 – Web Authoring


IM 36J04A15-04E

IM 36J04A15-04E
© Yokogawa March 5 2012
11th Edition Issue 1
Exaquantum Engineering Guide – Volume 4 Web Authoring i

Copyright and Trademark Notices

© 2012 Yokogawa Electric Corporation

All Rights Reserved

All rights are reserved in this document, which is the property of Yokogawa Marex Limited.
Information contained herein is the property of Yokogawa Marex Limited.

Unless agreed in writing by Yokogawa Marex Limited, the licensee shall not remove, release,
disclose, reveal, copy or extract all or part of the documentation.

Trademark Acknowledgements

Exaquantum, Exaopc and CENTUM are trademarks of Yokogawa.

Microsoft, Windows, Windows Vista, Windows Server 2008, Windows Server 2008 R2,
Windows 7 Professional, Microsoft Word, Microsoft Excel, Microsoft Office 2007,
Microsoft Office 2010, Visual Basic, Visual C++, SQL Server, MDAC, Microsoft .NET and
ActiveX are either registered trademarks or trademarks of Microsoft Corporation in the
United States and/or other countries.

Exaquantum uses Microsoft SQL Server as part of an Integrated Value Added Solution.

Adobe and Acrobat are registered trademarks of Adobe Systems Incorporated, and registered
within particular jurisdictions.

Ethernet is a registered trademark of XEROX Corporation.

Basic Scripting Engine provided by Cypress Software Inc., Copyright 1993 – 2000, all rights
reserved.

All other company and product names mentioned in this manual are trademarks or registered
trademarks of their respective companies.

We do not use TM or ® to indicate trademarks or registered trademarks in this manual.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


ii Contents

Highlights

The Highlights section gives details of the changes made since the previous issue of this
document.

Summary of Changes

This is 11th Edition of this document.

Detail of Changes

The changes are as follows.

Chapter/Section/Page Change
Chapter 1.4 Updated screen shot with addition of port number
Chapter 2 Added port number to web page addresses
Chapter 3.5 Removed as it refers to unsupported Operating Systems
Chapter 4.4 Removed limitation on number of objects
Chapter 1.2 Updated Exaquantum Web site address
Chapter 2.1 Updated Exaquantum Web site address
Chapter 4.2 Updated Exaquantum Web site address
Chapter 8.1 Updated Exaquantum Web site address

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring iii

Exaquantum Document Set

The documents available for Exaquantum are:

Exaquantum General Specification (GS 36J04A10-01E)

Exaquantum Technical Information (TI 36J04A10-01E)

Exaquantum/PIMS User's Manual (IM 36J04A11-01E)

Exaquantum/Explorer User's Manual Volume 1


General Information (IM 36J04A12-01E)

Exaquantum/Explorer User's Manual Volume 2


Custom Controls (IM 36J04A12-02E)

Exaquantum/Explorer User's Manual Volume 3


Microsoft Excel Reports (IM 36J04A12-03E)

Exaquantum/Explorer User's Manual Volume 4


Advanced Configuration (IM 36J04A12-04E)

Exaquantum Installation Guide (IM 36J04A13-01E)

Exaquantum API Reference Manual (IM 36J04A14-01E)

Exaquantum Engineering Guide Volume 1


Administration (IM 36J04A15-01E)

Exaquantum Engineering Guide Volume 2


Network Configuration (IM 36J04A15-02E)

Exaquantum Engineering Guide Volume 3


Support Tools (IM 36J04A15-03E)

Exaquantum Engineering Guide Volume 4


Web Authoring (IM 36J04A15-04E)

Exaquantum Engineering Guide Volume 5


PI Connection (IM 36J04A15-05E)

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


iv Contents

Table of Contents
Copyright and Trademark Notices .....................................................................................i 
Highlights......................................................................................................................... ii 
Exaquantum Document Set............................................................................................. iii 
Table of Contents .............................................................................................................iv 
Chapter 1  Introduction .............................................................................................................1-1 
1.1  General ............................................................................................................................... 1-1 
1.2  The Exaquantum/Web client.............................................................................................. 1-2 
1.3  Installing additional components on Web clients.............................................................. 1-3 
1.4  Web Server Manager.......................................................................................................... 1-4 
Chapter 2  Exaquantum/Web Site ............................................................................................2-1 
2.1  Data Users Web Site .......................................................................................................... 2-1 
2.2  Administrator’s Web Site................................................................................................... 2-2 
Chapter 3  Web Page Authoring Overview..............................................................................3-1 
3.1  Customising the web site.................................................................................................... 3-1 
3.2  Comparison of Web Authoring with Exaquantum/Explorer.............................................. 3-2 
3.3  How the Authoring Tools Work......................................................................................... 3-3 
3.4  Before You Start Authoring Web Pages ............................................................................ 3-4 
Chapter 4  Creating Graphics and Process Mimics ................................................................4-1 
4.1  Creating and Managing Mimics ......................................................................................... 4-1 
4.2  Graphic Editor Components............................................................................................... 4-2 
4.3  Expression Editor ............................................................................................................. 4-11 
4.4  Notes on Converting CS 3000 Graphics .......................................................................... 4-15 
4.5  Notes on Converting CENTUM VP Graphics ................................................................. 4-20 
4.6  Notes on Importing Exaquantum/Explorer Documents ................................................... 4-24 
Chapter 5  Creating Pre-configured Trend .............................................................................5-1 
5.1  Configuring the Trend Control........................................................................................... 5-1 
Chapter 6  Creating Pre-configured Alarms and Events Summary......................................6-1 
6.1  Configuring the Alarm and Event Control ......................................................................... 6-1 
Chapter 7  Moving a Web Server to a Dedicated PC..............................................................7-1 
7.1  Set Up the Dedicated Web Server...................................................................................... 7-1 
7.2  Back Up User Views .......................................................................................................... 7-1 
7.3  Restore User Views............................................................................................................ 7-1 
7.4  Remove the Web Server from the Exaquantum Data Server ............................................. 7-2 
7.5  Adjusting Views................................................................................................................. 7-2 
Chapter 8  Managing the Number of Users .............................................................................8-1 

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring v

8.1  Deleting User Profiles ........................................................................................................ 8-1 


Chapter 9  Scope of CS 3000 Conversion .................................................................................9-1 
9.1  CS 3000 Primitives ............................................................................................................ 9-1 
9.2  Properties............................................................................................................................ 9-4 
Chapter 10  Scope of CENTUM VP Conversion .....................................................................10-1 
10.1  CENTUM VP Primitives ................................................................................................. 10-1 
10.2  Properties.......................................................................................................................... 10-4 
Chapter 11  Enable read of large data volumes by Web client ..............................................11-1 
11.1  IIS 7.0 Increase ASP Response Buffering Limit in the IIS Manager............................... 11-2 

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


vi Contents

This page intentionally left blank

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 1-1

Chapter 1 Introduction
Exaquantum/Web allows users to connect to Exaquantum systems using Internet technology.
It provides a number of pre-configured, ready to use Web pages, while users can add their
own pages to extend the standard coverage.

Although the technology involved, such as access through port 80 (http protocol), would
generally be appropriate for the World Wide Web, clients are limited to Intranet users. This
is because of the highly confidential nature of both the data and the functionality that
requires strictly controlled access.

1.1 General
Fully installed Exaquantum clients can connect directly to an Exaquantum Server, but web
only clients must connect to an Exaquantum/Web Server.

Both types may co-exist physically as indicated:

Figure 1-1 Exaquantum Overview


Exaquantum/Web Exaquantum/Explorer

Web client Web client User PC User PC

Intranet Local Area Network

Web Server

Role Based View


OLE DB, Long-term
ODBC, etc Archive
Administration Tools

Real Time Database Historian

External Data:
ERP,
PCS Interface
Exaquantum/PIMS
LIMS, etc
(Server)

Exaquantum/PIMS
(Server)

Exaquantum/PIMS
(Server)
OPC Servers

PCS, DCS, PLCs etc

TIC1-2

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


1-2 Chapter 1 Introduction

1.2 The Exaquantum/Web client


The Exaquantum/Web client is a lightweight set of components that allow the Exaquantum
data to be displayed using a standard Web browser. It needs to be installed on every PC that
will access Exaquantum using the Web server interface.

The home page for users to access the Exaquantum/Web is:

http://<ExaquantumWebServerName>:<PortNumber>/ExaquantumHome

Where:

<ExaquantumWebServerName> is the name of the web server as specified during


the installation of the Exaquantum Web Client.

<PortNumber> is the port number as specified during the Web Server or Combined
Server installation.

For example:

http://MyExaquantumServer:8000/ExaquantumHome
4H

ActiveX security

The Exaquantum Web user interface uses ActiveX technology. The ActiveX controls
supplied with Exaquantum are signed and are safe for scripting. The controls can be
downloaded on initial visit to the web site or explicitly from the CD. If downloading via a
browser, then the security settings ‘Download signed ActiveX controls’ must be set to
‘Enable’ or ‘Prompt’. For users to run the software, the ‘Run ActiveX controls and plug-ins’
should be set to ‘Enable’.

Installing Exaquantum/Web client

The Exaquantum/Web client can be installed in either of two ways, in each case the user
must have administrator permissions on the PC:

♦ Download from the Exaquantum/Web server – On a PC that has no


Exaquantum/Web client installed, the first time a user tries to access the
Exaquantum/Web server the client will be automatically downloaded and installed.

♦ Directly from the Exaquantum CD – Place the Exaquantum Installation CD in the


drive and follow the menu to the Exaquantum/Web client installation procedure.

Refer to the Exaquantum Installation Guide on the CD for more information on this topic.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 1-3

1.3 Installing additional components on Web clients


To provide the additional functionality for importing Exaquantum data into the Microsoft
Excel program, the Exaquantum Excel Add-in has to be installed on each PC that will use it.
The Excel Add-in software is available as a selectable item during the installation.
Alternatively it can be added at a later stage by using the update facility. Refer to the
Exaquantum Installation Guide for more information.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


1-4 Chapter 1 Introduction

1.4 Web Server Manager


To allow a user of the Excel Web Client to change connection settings, a new tool, the “Web
Server Manager” has been introduced. This tool provides a user interface, as shown in Figure 89H

1-2. The tool can be accessed from the Windows Start menu.

Figure 1-2 Web Server Manager Tool

This allows modification of the following settings:

1. Web server: This is the name of the machine that hosts the Exaquantum Web or
Exaquantum Combined server

2. Port: The port number for communication with the Exaquantum web site

3. User name: The username to use when logging on to the web server (may be blank to
use integrated authentication)

4. Password: The password to use when logging on to the web server (may be blank to
use integrated authentication)

Each of these settings is stored in the registry for the current user and the password is held in
encrypted form.

The tool also contains a Test button in order to validate connection with the new settings.

When settings have been modified, any existing excel web clients must be restarted in order
to use the new settings.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 2-1

Chapter 2 Exaquantum/Web Site


Exaquantum provides Web sites for two different types of users:

♦ Data users

♦ Administrators.

2.1 Data Users Web Site


This is a function-rich Web site that allows users to start using Web pages out-of-the-box.
The URL will normally be:

http://<ExaquantumWebServerName>:<PortNumber>/ExaquantumHome

The first page the user will see is a Role based view of Exaquantum data. From here the user
can:

♦ View tags and function blocks data, live or historical

♦ Update Tag Values

♦ Navigate through tags and function blocks by altering the role based view, or searching
tags or function blocks by name.

The user can also visit other types of pages such as:

♦ Mimics with a windows refresh period of 1 minute

♦ Pre-configured trends

♦ Pre-configured alarms and events summary.

How to configure these types of pages is described in this manual. Exaquantum provides the
navigation mechanism to access the configured pages, and the means to author them. There
are two ways in which a user can access a mimic/pre-configured trend/alarms and events
summary. These are:

♦ Start with the role based view, click the appropriate derived view entry (e.g. mimics) to
replace the view with a list of available entries, and then launch the target page (e.g. Plant
1 overview) in the list page.

♦ Show the list page as above, then check target page(s) and use ‘add to MyList’. This
creates an entry in the right hand view named MY LIST.
When user wants to get to the page(s) MY LIST view is used to select an entry in the My
List.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


2-2 Chapter 2 Exaquantum/Web Site

The content of My List is user-dependent. The user can use this mechanism to record
subjects of interest and access such pages without having to search for entries again and
again.

The QuickLink part of the page (on the right side) is for recording Web pages that the user
wants to visit frequently. This is also user-dependent content.

The QuickHelp part of the page (on the right side) shows the context-sensitive help entries
that are available for the current page.

2.2 Administrator’s Web Site


Certain parts of the Exaquantum system can be administered using a web browser interface.
A separate part of the Web site provides access to:

♦ System administration tools


http://<ExaquantumWebServerName>:<PortNumber>/Exaquantum/Applications/
admintools.asp

♦ Tag configuration viewer


http://<ExaquantumWebServerName>:<PortNumber>/Exaquantum/Applications/
tagconfigtool.asp

♦ Cross reference tool


http://<ExaquantumWebServerName>:<PortNumber>/Exaquantum/Applications/
xreftool.asp

♦ System event viewer


http://<ExaquantumWebServerName>:<PortNumber>/Exaquantum/Applications/
syseventview.asp

Although these facilities are displayed in a standard web browser, in the background they are
provided by the server as clients of a Windows Terminal Server. To enable this feature, the
first time it is used, an ActiveX control will be installed on the PC.

To access the server facilities, the user will need to log on using an account that has
permissions to access the server. The window will appear just like a window on the server.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 3-1

Chapter 3 Web Page Authoring Overview


The Exaquantum/Web site for data users allows additions of configured web pages. This
chapter describes the general guidelines for this configuration work.

Note: From this point onwards, the term ‘Exaquantum/Web site’ always means the web
site for data users. Administrators web sites are fixed and users cannot change them.

3.1 Customising the web site


Three types of web pages

The Exaquantum/Web site provides you with three places where you can locate your own
web pages:

♦ Mimics – they are usually plant animations that look very similar to
Exaquantum/Explorer mimics.

♦ Pre-configured trend – an equivalence to Exaquantum/Explorer’s Trend

♦ Pre-configured alarms and events summary – an equivalence to Exaquantum/Explorer’s


Alarms and Events Summary.

These categories are not rigorous. For example if you are creating a web page that consists
of a plant mimic together with various trends, you can locate the page in either mimics or
pre-configured trend (or even in pre-configured alarms and events). Three categories are
provided for the users’ convenience only.

Note: The rest of this manual describes in more detail how you can add and administer
these pages.

Importing mimics files from Exaquantum/Explorer or CS 3000

The import of mimics from Exaquantum/Explorer is a standard function. This function is


useful for converting existing Exaquantum/Explorer documents to the new Web environment,
however there are restrictions with this tool (see Section 4.6).
90H

Importing from a CS 3000 graphics file is an optional feature. In order for you to use this
feature you must order this option.

Note: When used in this document, the term ‘CS 3000’ means CS 1000 and CS 3000
graphics.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


3-2 Chapter 3 Web Page Authoring Overview

Adding your own web pages by programming them

If you have project specific requirements to end up with specially built pages, for example
LIMS data entry page, you can do this by:

1 Programming an ASP page to implement the required function.

2 Registering the ASP page into Exaquantum/Web site into one of three types mentioned
earlier.

As this is a programming exercise ask your Yokogawa representative for more details.

User preferences

The Exaquantum/Web site is a personally customizable web site. This means that some of
contents and settings are customizable on a user basis, and are preserved across uses. Such
customizable content and settings are:

♦ My List entries

♦ Quick Link links

♦ Availability of derived views of a view

♦ Heading title and icon.

Look and feel

You cannot change the look and feel of the Exaquantum/Web site, including the location or
size of screen elements.

3.2 Comparison of Web Authoring with Exaquantum/Explorer


The following paragraphs indicate the differences between Web Authoring and
Exaquantum/Explorer.

There are two distinct authoring tools: Graphics Editor and a commercial tool

Exaquantum/Explorer can do the whole job, that is configure Exaquantum/Explorer


documents and run them.

In the Web environment two types of tools are required:

♦ Graphics Editor (to author mimics)

♦ A commercial tool (to author other pages).

Microsoft SharePoint Designer or Microsoft Expression Web are the recommended


commercial tools, but you may use your preferred tool.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 3-3

Note: Exaquantum provides a Web Authoring Add-In for SharePoint Designer and
Expression Web that allow the incorporation of web pages into the
Exaquantum/Web site. This feature is not available in other tools.

Web mimics are slightly different from Exaquantum/Explorer mimics

The Graphics Editor originates from Exaquantum/Explorer, hence shares the same features.
However there are some functions that are not available in the Graphics Editor:

♦ You cannot use ActiveX inside Web mimics

♦ You cannot use client scripting, except pre-defined ones (see below).

You have to use Sharepoint Designer or Expression Web in various cases

The Web pages that you have to use SharePoint Designer or Expression Web to create include:

♦ Pre-configured trend page

♦ Pre-configured alarms and events page

♦ Any mixture of any of these elements, e.g. a plant mimic showing a trend next to it

♦ Mimics that have navigation features between them.

Client scripting is offered for pre-defined uses only

One of the advantages of Exaquantum/Explorer is its functionally rich client scripting that
allows inter-documents or inter-controls interactions. Because the client scripting in the
Web environment is limited to manipulation to render objects, the equivalence to
Exaquantum/Explorer client scripting in the Web is limited to pre-defined uses only:

♦ Report times in mimics – this allows a time selection of values to show

♦ Parameterization in mimics – this allows a selection of data items to show, e.g. raw item,
hourly aggregated mean, etc.

3.3 How the Authoring Tools Work


This overview of how your web pages are incorporated into the Exaquantum/Web site is
intended to facilitate a general understanding of the authoring steps.

What you Create when Authoring Web Pages

Authoring Web pages creates:

♦ A Web page file. This is usually a HTML file, with the exception of the SVG (Scalable
Vector Graphics) file in the case of the Graphics Editor.

♦ An entry to the Exaquantum/Web site. When you use SharePoint Designer or Expression
Web, Publish View via the Add In menu generates this information for you.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


3-4 Chapter 3 Web Page Authoring Overview

Web page files are to be located on the Web server. In order to accomplish this, there is a
pre-configuration made in advance of the authoring work (see Section 3.4 for further
91H

information). Each time you generate web page files (html files or SVG files), you have to
be careful to save the files at the designated location.

Entries appear in the list view of mimics, pre-configured trend and alarms and events
summary. This information is stored in the configuration database that resides on the
Exaquantum server. Populating this information is done by the Graphics Editor or Web
Authoring Add-In when you publish a view.

Installing Authoring Tools

In order for you to be able to author web pages, you have to install authoring components on
your client PC. This is a part of the client installation; see the Exaquantum Installation
Guide for more detail about installing client components.

The Exaquantum/Web authoring components consist of:

♦ Graphics Editor, a standalone Windows program

♦ Web Authoring Add-In, which provides these features:

♦ Tags and Function blocks browser to allow tags to be dragged and dropped into
components such as Trend. This is a useful mechanism to configure components that
require tag path names as parameters.

♦ Publish View, which creates an entry in the Exaquantum/Web site.

The authoring components require online access to both the Exaquantum server and
Exaquantum/Web server. Such servers are pre-defined during the installation. You cannot
change the Web server unless you re-install the components. If it is an Exaquantum multiple
server deployment, you can specify a primary server and a secondary server during
installation. Your authoring tool will try to access the primary server; it will go to the
secondary one if the primary fails to respond.

3.4 Before You Start Authoring Web Pages


You have to set up your client PC so that you can use the Exaquantum/Web authoring tools
properly.

Setting Up a Folder to Store Web Page Files

Web page files should be stored in the right place on a Web server; this is necessary for all
authoring users. Follow these steps:

1 Create the folder(s) that will be used to store your Views. The folder should reside under
the WebRoot folder, for example:

Drive:/<Install Folder>/Yokogawa/Exaquantum PIMS/WebRoot/Views

2 Share the folder that you have created.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 3-5

Note: If you want to be able to save views in this folder from other authoring PCs, you
will need to Share the Views folder.

Installing the Web Authoring Add-In

The installation is slightly different depending on the version of SharePoint Designer or


Expression Web being used.

Sharepoint Designer 2007:

Please note that later versions of SharePoint Designer are not supported.

1. From the Insert menu select Web Component; the Insert Web Component dialog is
displayed.

Figure 3-1 Insert Web Component

2. Select Advanced Controls from the Component type (left column), then ActiveX
Control from the list displayed on the right.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


3-6 Chapter 3 Web Page Authoring Overview

3. Click on Next to display the controls that are available for selection.

Figure 3-2 Insert Web Component – ActiveX Controls

4. If the required control is not shown, click on Customize to see the full list; the
Customize ActiveX Control List dialog is displayed. Proceed with Step 5 above.

Figure 3-3 Customize ActiveX Control List

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 3-7

Expression Web 4:

No additional steps are required before you use Expression Web 4 to configure web pages
and the Add-In should already be available.

1. From the Exaquantum menu select Insert Trending Control or Insert Event
Summary Control; the corresponding control is added to the page.

Figure 3-4 Exaquantum Menu

Understanding Control Activation

Interactive controls are ActiveX controls that provide user interfaces. When a web page uses the
APPLET, EMBED, or OBJECT elements to load an ActiveX control, the control's user interface
is blocked until the user activates it. If a page uses these elements to load multiple controls, each
interactive control must be individually activated.
When a control is inactive, the following effects occur.
• Dynamic HTML events related to user interaction, such as onblur and onclick, are blocked.
• The control does not respond to window messages generated by the keyboard or mouse.
• An overlay window, created on the control's OLE site, prevents keyboard and mouse
messages from reaching the inactive control.
When a control is inactive, it does not respond to user input; however, it does perform operations
that do not involve interaction. If, for example, you open a web page that uses Microsoft Windows
Media Player to play a music file, the music plays after the page loads. You cannot interact with
Windows Media Player until the control's user interface is activated, as shown in the following
figure.

Figure 3-5 Windows Media Player Control

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


3-8 Chapter 3 Web Page Authoring Overview

Note While inactive controls do not respond to direct user interaction; they do respond to script
commands.
To activate an interactive control, either click it or use the TAB key to set focus on it and then
press the SPACEBAR or the ENTER key. Interactive controls loaded from external script files
immediately respond to user interaction and do not need to be activated.

Loading Interactive Controls Externally

To create Web pages that load interactive controls that respond immediately to user input, use
Microsoft JScript to load controls from external script files. You cannot write script elements in
line with the main HTML page to load your control externally. If the script is written inline
programmatically, for example with the writeln function, the loaded control will behave as if it
was loaded by the HTML document itself and will require activation. To ensure a control is
interactive when it is loaded, use one of the following techniques to load your control from an
external file.
The following example uses document.write to load a control dynamically.
<!-- HTML File -->
<html>
<body leftmargin=0 topmargin=0 scroll=no>
<script src="docwrite.js"></script>
</body>
</html>
// docwrite.js
document.write('<object classid="clsid:6BF52A52-394A-11d3-B153-
00C04F79FAA6">');
document.write('<param name="URL" value="example.wmv">');
document.write('<param name="autoStart" value="-1"></object>');
External script files can also modify an element's outerHTML property to achieve the same effect,
as shown in the following example.
<!-- HTML File -->
<html>
<body>
<div id="embedControlLocation">
<script src="embedControlOuterHTML.js"></script>
</div>
</body>
</html>
// outerhtml.js
embedControlLocation.outerHTML = '<embed src="examplecontrol">';
The next example uses document.createElement to load an ActiveX control using the OBJECT
element.
Important When using createElement to add an Object or Embed element to a web page, use care
to create the element, initialize its attributes, and add it to the page's DOM before creating the
ActiveX control to be loaded by the new element.
<!-- HTML File -->
<html>
<body>
<div id="DivID">
<script src="createElementExplicit.js"></script>
</div>
</body>
</html>

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 3-9

// createElementExplicit.js
var myObject = document.createElement('object');
DivID.appendChild(myObject);
myObject.width = "200";
myObject.height = "100";
myObject.classid= "clsid:6BF52A52-394A-11d3-B153-00C04F79FAA6";
myObject.URL = "example.wmv";
myObject.uiMode = "none" ;
The next example uses innerHTML and a JScript function to load an ActiveX control while
specifying parameter values.
<!-- HTML File -->
<html>
<head>
<script src="external_script.js" language="JScript"></script>
</head>

<body>
<div id="EXAMPLE_DIV_ID">
This text will be replaced by the control
</div>
<script language="JScript">
CreateControl( "EXAMPLE_DIV_ID",
"clsid:6BF52A52-394A-11d3-B153-00C04F79FAA6",
"EXAMPLE_OBJECT_ID", "600", "400", "example.wmv",
"-1")
</script>
</body>
</html>
// external_script.js
function CreateControl(DivID, CLSID, ObjectID,
WIDTH, HEIGHT, URL, AUTOSTART)
{
var d = document.getElementById(DivID);
d.innerHTML =
'<object classid=' + CLSID + ' id=' + ObjectID +
' width=' + WIDTH + ' height=' + HEIGHT +'>
<param name="URL" value=' + URL + '>
<param name="autoStart" value=' + AUTOSTART + '/>';
}

There are sample documents installed on an Exaquantum/Web server that demonstrate these
techniques. They can be found under Program Files\Yokogawa\Exaquantum
PIMS\WebRoot\Samples. These samples also include an example of a page that displays a
blank trend along with a data selector so that tags may be dragged onto the trend.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


3-10 Chapter 3 Web Page Authoring Overview

This page intentionally left blank

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 4-1

Chapter 4 Creating Graphics and Process Mimics


The Graphics Editor is a “Design Time” only version of Exaquantum/Explorer. It provides
the following functionality:

♦ An environment to create graphic plant views in PXG format (the native source format of
the program), which can then be saved as a web documents (SVG) for deployment over
the Web.

♦ An Import mechanism to convert existing Explorer (PXD) and CS 3000 (sva) graphics
documents into PXG documents.

This chapter covers how to create and manage mimics, followed by a more detailed
description of the features and operations of the Graphics Editor. Finally, there is
information about importing Explorer graphics, and converting CS 3000 graphics.

NOTE. This applies to Graphics Editor running on Windows 2008, Windows 2008 R2,
Windows Vista or Windows 7, with Virtualization enabled (Local Security Policies,
“User Account Control: Virtualize file and registry write failures to per-user locations”).
Virtualization was introduced in these Operating Systems, as part of the security
enhancements. This feature controls write access to files and folders, to which the user
does not have write access (for example, to the windows “Program Files” folder). If a
user creates a folder or saves a pxg document to such a location, the Operating System
writes the actual file or folder to the users Virtual Store Folder. This location is
determined by the value of the userprofile environment variable. The effect of this is that
users other than the user who created the file or folder, will not be able to read that
location. Therefore, users wishing to create shared documents should be careful when
selecting the location of where to save the stored files.

4.1 Creating and Managing Mimics


Creating Mimics from Scratch

1 Start the Graphics Editor and use the File menu, New option.

2 Drag and drop palette components onto the main drawing screen and configure the
properties of each component.

3 You can enrich functionality with features such as:

♦ Hyperlinks to other web pages

♦ Managing many components by way of layers

♦ Expressions that allow conditional rendering.

4 Save the mimic regularly in PXG format to avoid losing the file accidentally. You will
need this file again if you want to make amendments to the mimic, so store it in a secure
location that is backed up regularly.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


4-2 Chapter 4 Creating Graphics and Process Mimics

5 When editing of the mimic is complete, use File menu, Save as Web Page option. This
generates an SVG format file available for viewing through the Exaquantum/Web site. Use
the folder on the Exaquantum/Web server that you created to hold these files, for example:

Drive:/<Install Folder>/Yokogawa/Exaquantum PIMS/WebRoot/Views

6 Use Publish View to make the mimic available for viewing.

Note: The History Replay option is only available in Exaquantum/Explorer and is not
supported in the Graphic Editor.

4.2 Graphic Editor Components


General features of the Graphics Editor are described in this section.

User Interface

Figure 4-1 Graphic Editor User Interface - Example

As with the existing Exaquantum/Explorer programs, objects from the Palette may be
dragged onto the central work area to create a static plant mimic and plant information may
be dragged from the Data Selector to animate this static view. For example, in Figure 4-1
the ‘A’ object from the Palette has been dragged underneath the right tank, and the open PV
object in the Data Selector has been dragged into it. This will mean that the live value of
Test.Root.TestTag.20FIC053.PV will be shown when the mimic is finally viewed.

Mimics produced should be saved in a native PXG format, which works as a source for
future enhancements. When mimics are ready for viewing over the Web, they must be saved
as an SVG file and incorporated into the Exaquantum/Web site.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 4-3

Data Selector

You can use the standard Data Selector to add tags to the view via property pages. As in
Exaquantum/Explorer, tags can be attached to Gauges, Pointers, Color dynamics etc., to
provide dynamic graphics.

The update rate of the data item can be set explicitly. During run time the data will be
updated at a frequency no greater than 1 minute. This is to not overload the client machine.

Navigation

Hyperlinks can be used to provide navigation from objects on the current page to any other
web page that is available, either on the Internet, an intranet or on the Exaquantum/Web
server. Whenever a user clicks on an object for which a Hyperlink is set, the target page will
be opened.

♦ The target page for the Hyperlink is set in the object’s ‘Property Sheet’ dialog box.

♦ Exactly how the target page opens will depend on settings in the ‘Hyperlink
Navigation properties’ dialog box.

Setting a Hyperlink

To set an objects hyperlink:

1 To access the object properties, right-click on the object.

2 From the context menu select ‘Object Properties’.

3 In the object’s Property Sheet dialog box, locate the Hyperlink property.

4 In the Hyperlink property, enter the address in the appropriate format.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


4-4 Chapter 4 Creating Graphics and Process Mimics

Figure 4-2 Object Property sheet highlighting Hyperlink property

Hyperlink address formats

There are three distinct forms of links:

♦ Links to standard web pages on the Internet, or an intranet.

These take the form of a standard internet URL. An example could be:

http://www.yokogawa.com/

♦ Links to pages on the Exaquantum/Web server

These are web pages served by the Exaquantum/PIMS server. They can be standard HTML
files such as those created with a web editor like SharePoint Designer for displaying Trend or
Alarm and Event data; or system originated pages generated using ASP (Active Server Pages).

This sort of address takes a similar form to that above, but the address of the local Web
server is used instead:

http://<servername>:portnumber>/<path to file>

where

<servername> is the name of your Exaquantum/Web server;

<portnumber> is the port through which to communicate to the web site

<path to file> is the file name and location of the file within the servers Web file system.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 4-5

♦ Links to Exaquantum mimic pages created with the Exaquantum Graphics editor.

Web pages created by the Exaquantum Graphics Editor are in SVG (Scaleable Vector
Graphics) format. This means they have to be loaded into a host framework in order to be
displayed.

The Hyperlink takes the form:

<Address of framework>?svg=<address of target page>

Which is made up of three elements;

<Address of framework> - This is the address and name of the basic framework page that
will be used to host the target page. This is provided as part of the system. In a default
installation, the address will be similar to:

http://<servername>:<portnumber>/exaquantum/applications/wa
c/mimicframeset.asp

where

<servername> is the name of your Exaquantum/Web server;

<portnumber> is the port through which to communicate to the web site

?svg= - This is the instructions to the system to use the following information as the target
page to be displayed in the framework.

<address of target page> - This is the address and name of the target page that was
originally created using the Exaquantum Graphics Editor.

A complete example would be:

http://servername:8000/exaquantum/applications/wac/mimicfra
meset.asp?svg=../../TargetPage.svg

In this case, the address to the target is a relative address using standard file system paths.
The base for calculating the relative address is the location of the framework page.

There is an alternative form of address that uses the web address to locate the target:

http://servername:8000/exaquantum/applications/wac/mimicfra
meset.asp?svg=http://servername/exaquantum/TargetPage.svg

In this case, the base of the address is the Exaquantum/Web server ‘WebRoot’ folder.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


4-6 Chapter 4 Creating Graphics and Process Mimics

Hyperlink Navigation Properties

Then how the new Internet Explorer window is displayed can be controlled using the
Hyperlink Navigation Properties window.

Figure 4-3 Hyperlink Properties in an Animation Component

Clicking on the Hyperlink Navigation entry displays the Hyperlink Navigation Properties
window. The style of Internet Explorer window can be selected from the drop-down list, and
the display settings and window dimensions can be checked and set as required.

Window target allows you to specify the name of the window in which the URL will be
opened. (This name is used as the value for the TARGET attribute on a form or an <a>
element.) There are 4 pre-defined targets:

♦ New Window – the URL is loaded into a new, unnamed window

♦ Parent Window – the URL is loaded into the current frame's parent. If the frame has no
parent, this value acts as the Replace Window.

♦ Replace Window – the current document is replaced with the specified URL

♦ Main Window – the URL replaces any framesets that may be loaded. If there are no
framesets defined, this value acts as the Replace Window.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 4-7

If New Window or a specific target name is supplied, then the options in Display settings
may be set to control how the new Internet Explorer window is displayed:

♦ Show Directory buttons – specifies whether to add directory buttons

♦ Display Fullscreen – specifies whether to display the browser in full-screen mode. Use
full-screen mode carefully. Because this mode hides the browser's title bar and menus,
you should always provide a button or other visual clue to help the user close the window.
ALT+F4 closes the new window.

♦ Show Location bar – specifies whether to display the input field for entering URLs
directly into the browser

♦ Display Menubar – specifies whether to display the menu bar

♦ Resizable Window – specifies whether to display resize handles at the corners of the
window

♦ Show Scrollbars – specifies whether to display horizontal and vertical scroll bars

♦ Show Status bar – specifies whether to add a status bar at the bottom of the window

♦ Show Toolbar – specifies whether to display the browser toolbar, making buttons such as
Back, Forward, and Stop available.

The third section allows the user to amend the Window dimensions:

♦ Left – specifies the left position, in pixels. This value is relative to the upper-left corner
of the screen. A value of –1 uses the default Left position.

♦ Top – specifies the top position, in pixels. This value is relative to the upper-left corner
of the screen. A value of –1 uses the default Top position.

♦ Width – sets the width of the window, in pixels. A value of –1 uses the default Width.

♦ Height – specifies the height of the window, in pixels. A value of –1 uses the default
Height.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


4-8 Chapter 4 Creating Graphics and Process Mimics

Palette

As in Exaquantum/Explorer, the palette has number of Native objects that can be used in the
PXG graphics:

Table 4-1 Palette

Line

Ellipse

Border

Polyline

Bitmap

Pointer

Text

Arc

Gauge

Layers

To assist in creating views, the Graphics Editor allows you to define layers, put objects on
any of the layers, and view any number of layers simultaneously. To set the layer
configuration, click on an empty area of the view to display the Property Sheet; then click
the ellipsis in the right column of ‘ViewLayers’ to see the layers sheet:

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 4-9

Figure 4-4 Layers Sheet

By default all the objects on the sheet are placed in the default layer, but you can add more
layers as shown, and make them visible or invisible. You can move objects from layer to
layer through their property sheets:

Figure 4-5 Property Sheet

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


4-10 Chapter 4 Creating Graphics and Process Mimics

Calculations and Manipulating the View

You can manipulate many of the properties of the objects on the view by associating them
with a value of tags. For example, the level shown by a gauge object can be directly linked
to a process variable (PV). More complex manipulations involving constants, ‘report times’,
and multiple tag values are also possible.

Variables

The property sheet of the view itself includes ‘Variables’. To access the View’s property
sheet, right-click on an empty area of the sheet. Clicking on the right column of ‘Variables’
displays the Variables window. There are two tabs (Local Variables and Data Variables).
You can add named local variables by right clicking in the ‘Name column’. A pop-up menu
is displayed, as shown.

Figure 4-6 Variables

Once a variable has been defined, you can refer to it in the expression editors of any of the
objects on the sheet. See Section 4.3 for a description of the Expression Editor.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 4-11

Report Times

Report Times are also properties of the View and may be used in a similar way to the local
variables. They are set with the dialog shown below:

Figure 4-7 Set Local Report Times

4.3 Expression Editor


Overview

Imported CS 1000/CS 3000 graphics may include Expressions. The Graphics Editor
supports these, and you may edit them or create new ones regardless of the original source of
the file. The created Expressions may include Graphics Editor Specific functionality such as
Parameterization and Report Times. This functionality is a web-based equivalent of
Exaquantum Explorer’s scripting.

You can bind an expression to an object in the same way as a constant or Data Variable. The
Expression Editor can create two basic types of expression:

♦ Simple Mathematical Expressions

♦ Conditional Expressions.

It allows the use of both Data Variables and Local variables with a number of simple
operators.

Before allowing the Expression to bind to a property, the Editor will parse the expression to
ensure that it is valid.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


4-12 Chapter 4 Creating Graphics and Process Mimics

Simple Expressions

A simple expression returns a result directly into a property, for example:

( [TestRootTestTag20FIC053PVValueValue] + [OFFSET] )/100

This adds an Exaquantum Tag (Data Variable) to the value of OFFSET (Local Variable), and
divides the result by 100.

An equation like this could be bound to any Text property (Top, Width, Value etc.).

For example, suppose a user wanted to control the height of an ellipse according to the value
of the expression above. Right click the ellipse and chose ‘Object Properties’ to display the
Property Sheet. Then click in the right column of ‘Height’ to display the Property Binder.
Selecting the Expression radio button then displays the interface (Figure 4-8):

Figure 4-8 Expression Editor in Simple Expression Mode

Note: The names of the variables are used (not their paths) and square brackets are used to
separate the operands from the operators.

Tip: The names of the data variables are automatically created from their paths and are
often cumbersome to type. If you temporarily create a text field on the work area and drag
the tag into it, you can then copy the name from the work area into the clipboard (Ctl C) and
paste it into the Property Binder text box (Ctl V). Delete the item from the work area later.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 4-13

Note: Expressions can be evaluated once (when the View is first displayed), or on every
refresh.

Valid Operators in Simple Expressions

The following table shows a list of valid operators that can be used in Simple expressions:

Table 4-2 Valid Operators for Simple Expressions

Operator Description
( ) Priority
+ Add
- Subtract
* Multiply
/ Divide
& Bit AND
| Bit OR

Conditional Expressions

A Conditional Expression returns a value to a property depending on a set of conditions. For


example:

FIC100.PV >50.0
FIC100.PV +FIC300.PV <=FIC400.PV
FIC100.PV >50.0 and FIC200.PV < FIC100.ALRM
FIC100.AOFS =”AOF”

These four conditions are evaluated in order. When a condition is found to be true, a
specified value (such as a color code) is returned to the property.

These types of expressions are mainly used for setting color dynamics on objects by
comparing the values of a number of different tags.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


4-14 Chapter 4 Creating Graphics and Process Mimics

Figure 4-9 shows an example of the Expression Editor in Conditional Expression mode.

Figure 4-9 Expression Editor in Conditional Expression Mode

Valid Operators in Conditional Expressions

The following table shows a list of valid operators that can be used in Conditional
expressions:

Table 4-3 Valid Operators for Conditional Expressions

Operator Description
= Equal
<> Not Equal
> Greater than
< Less than
>= Greater than or Equal To
<= Less than or Equal to
AND And
OR Or

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 4-15

4.4 Notes on Converting CS 3000 Graphics


This section provides information useful to start converting CS 3000 graphics.

Scope of conversion

The conversion tool is based on the CS 3000 feature to export CS 3000 graphics into SVG.
For more details about the restrictions this imposes, refer to Chapter 9.

Note 1: This is an optional feature that is only available when the correct licence key code
has been used to install the Exaquantum software.

Note 2: Before starting the conversion, make sure that the pre-processing options are
properly configured. The pre-processing is to absorb commonly observed
differences between CS 3000 graphics and Exaquantum mimics. See Section 4.4
for more detail.

Pre-processing CS 3000 Graphics Files

CS 3000 graphics are often used for operational purposes, whilst Exaquantum mimics are
meant more for managerial purposes. Due to such differences there are usually deficiencies
between the two. The conversion program provides pre-processing to address this.

Pre-processing involves applying small changes to an input file. Each step is defined in a
file, and files are to be located in:

<Exaquantum install directory>\Graphics Editor\SVG Filters

for Graphics Editor and

<Exaquantum install directory>\Explorer\SVG Filters

for Exaquantum Explorer.

These files are applied in alphabetical order, according to their file names.

The standard Exaquantum provides these definition files in their order of application. A
number of these pre-processing files are for the standard conversion. These can be added to
by prefixing the developed style sheet with a number, e.g. O60_MyConversion, to ensure the
correct order of processing.

Note: The definition file is a XML style sheet, and creating a style sheet requires
knowledge of the XML technology. Ask your Yokogawa representative about
adding any required changes.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


4-16 Chapter 4 Creating Graphics and Process Mimics

Graphics conversion logs

Because the names used for Tags in the Exaquantum database and those used in the CS3000
graphic may be different, it is possible that not all the references can be reconciled. To help
resolve these issues, whenever graphics conversion is used, two log files are created.

TAGxxxx_Mapped.log – Contains a list of all the tag names found in the graphic being
converted.

TAGxxxxMissing.log – Contains a list of all the tag names that could not be reconciled with
names in the Exaquantum database.

Where xxxx is a unique string allocated by the system.

The log files are located in the users temporary folder (%TEMP%), for example on
Windows7:

C:\Users\<username>\AppData\Local\Temp

Converting CS 3000 Graphics

You can import CS 3000 graphics into Exaquantum/Web using this feature.

1 Start the Graphics Editor and then from the File\Import menu select one of the following
as described in step 2, Importing graphics: Import HIS Graphic… or Import SVG File...

2 Importing graphics

♦ Import HIS Graphic…

Figure 4-10 Import HIS Graphic

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 4-17

Note: Before importing a HIS graphic, it is necessary to register the login user on the
CENTUM HIS computer.

This example shows how to enable HIS graphic import for the user “User1”

This user may also be a workgroup user or a domain user.

It is necessary for User1 to be member of QUserGroup and QExplorerDesignGroup, in


order to edit Exaquantum Graphics Editor Documents.

Register the login user to CENTUM HIS PC as follows.

1. Login on the HIS PC as a user with Administrator privileges.

2. Select [Start] - [Settings] - [Control Panel]

4. Click ‘Administrative Tools’.

5. Click ‘Computer Management’.

6. Double-click ‘Users and Passwords’.

7. Click ‘Local users and Groups’.

8. Click Users in ‘Local users and Groups’ and right click.

9. Select ‘New User’ .

10. Register User name as “User1” and set a Password.

password must be the same password as for “User1” on Exaquantum PC

uncheck "User must change password at next logon" and check “Password never
expires”

11. Push create button.

Set the following:

• HIS HostName - Destination HIS computer name

• Project Name - CS3000 project name. This will be automatically populated


with the default project found on the HIS HostName computer.

• Graphic Document – The SVA or EDF graphics file to convert

• Exaquantum Server – The Exaquantum server computer name

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


4-18 Chapter 4 Creating Graphics and Process Mimics

• OPC Server – The OPC gateway name. Only used when a CENTUM tag
(e.g. T100.PV) is converted to an Exaquantum path name (e.g.
Root.Folder.T100.PV.Value:Value). This field may contain the SQL
wildcard character “%” in order to match zero or more characters. For
example, if we have two OPC servers called OPCGateway1 and
OPCGateway2, then it is possible to specify "OPCGateway%" in the OPC
Server field to find tags from both OPC servers.

Click the OK button to begin the conversion.

♦ Import SVG File…

Figure 4-11 Import SVG File

Set the following:

• SVG File - Destination SVG file name. Refer to Converting SVA to SVG

• Exaquantum Server – The Exaquantum server computer name

• OPC Server – The OPC gateway name. Only used when a CENTUM tag
(e.g. T100.PV) is converted to an Exaquantum path name (e.g.
Root.Folder.T100.PV.Value:Value). This field may contain the SQL
wildcard character “%” in order to match zero or more characters. For
example, if we have two OPC servers called OPCGateway1 and
OPCGateway2, then it is possible to specify "OPCGateway%" in the OPC
Server field to find tags from both OPC servers.

Click the OK button to begin the conversion.

3 The program starts to convert the graphics into the native Graphics Editor, PXG, format.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 4-19

Note: The time taken for the conversion process is dependent on the complexity of the
source graphics file. The progress viewer will provide an indication of the
current progress made in the conversion process.

4 On completion of the conversion process the converted graphic may be edited as normal..

Converting SVA to SVG

This tool converts a graphic file on the HIS in EDF format, to an SVG file.

Figure 4-12 SVG Convert Tool

The following steps describe the conversion process:

1. Copy the files “ToolSVGConvert.exe” and “LibToolSVGConvertRes.dll” from the


“\Tools\Graphic Converter for HIS” folder on the Exaquantum Install CD to a
location on the HIS.

2. Double-click the file to execute the application

3. Select the Project Name from the dropdown list.

4. Select the Station Name from the dropdown list.

5. Select a graphic file or graphic files to convert from the list.

6. Click on the Convert button. A dialog will be displayed in order to specify where
the converted destination file(s) will be saved. SVG files are written to the specified
folder.

Note: This tool can only be used on the HIS computer.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


4-20 Chapter 4 Creating Graphics and Process Mimics

4.5 Notes on Converting CENTUM VP Graphics


This section provides information useful to start converting CENTUM VP graphics.

Scope of conversion

The conversion tool is based on the CENTUM VP feature to export CENTUM VP graphics
into SVG. For more details about the restrictions this imposes, refer to Chapter 10 Scope of
CENTUM VP Conversion.

Note 1: This is an optional feature that is only available when the correct licence key code
has been used to install the Exaquantum software.

Note 2: Before starting the conversion, make sure that the pre-processing options are
properly configured. The pre-processing is to absorb commonly observed
differences between CENTUM VP graphics and Exaquantum mimics. See Section
4.5 for more detail.

Pre-processing CENTUM VP Graphics Files

CENTUM VP graphics are often used for operational purposes, whilst Exaquantum mimics
are meant more for managerial purposes. Due to such differences there are usually
deficiencies between the two. The conversion program provides pre-processing to address
this.

Pre-processing involves applying small changes to an input file. Each step is defined in a
file, and files are to be located in:

<Exaquantum install directory>\Graphics Editor\SVG Filters

for Graphics Editor and

<Exaquantum install directory>\Explorer\SVG Filters

for Exaquantum Explorer.

These files are applied in alphabetical order, according to their file names.

The standard Exaquantum provides these definition files in their order of application. A
number of these pre-processing files are for the standard conversion. These can be added to
by prefixing the developed style sheet with a number, e.g. O60_MyConversion, to ensure the
correct order of processing.

Note: The definition file is a XML style sheet, and creating a style sheet requires
knowledge of the XML technology. Ask your Yokogawa representative about
adding any required changes.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 4-21

Graphics conversion logs

Because the names used for Tags in the Exaquantum database and those used in the
CENTUM VP graphic may be different, it is possible that not all the references can be
reconciled. To help resolve these issues, whenever graphics conversion is used, two log files
are created.

TAGxxxx_Mapped.log – Contains a list of all the tag names found in the graphic being
converted.

TAGxxxxMissing.log – Contains a list of all the tag names that could not be reconciled with
names in the Exaquantum database.

Where xxxx is a unique string allocated by the system.

The log files are located in the user’s temporary folder, for example:

C:\documents and settings\<username>\Local Settings\Temp

Converting CENTUM VP Graphics

You can import CENTUM VP graphics into Exaquantum/Web using this feature.

1 Start the Graphics Editor and then from the File\Import menu select Import SVG File...

2 Importing graphics

♦ Import SVG File…

Figure 4-13 Import SVG File

Set the following:

• SVG File - Destination SVG file name. Refer to Converting SVA to SVG

• Exaquantum Server – The Exaquantum server computer name

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


4-22 Chapter 4 Creating Graphics and Process Mimics

• OPC Gateway – The OPC gateway name. Only used when a CENTUM tag
(e.g. T100.PV) is converted to an Exaquantum path name (e.g.
Root.Folder.T100.PV.Value:Value). This field may contain the SQL
wildcard character “%” in order to match zero or more characters. For
example, if we have two OPC servers called OPCGateway1 and
OPCGateway2, then it is possible to specify "OPCGateway%" in the OPC
Server field to find tags from both OPC servers.

Click the OK button to begin the conversion, the OPC Gateway will be validated
automatically, and an error message displayed if the details are invalid.

3 The program starts to convert the graphics into the native Graphics Editor, PXG, format.

Note: The time taken for the conversion process is dependent on the complexity of the
source graphics file. The progress viewer will provide an indication of the
current progress made in the conversion process.

4 On completion of the conversion process the converted graphic may be edited as normal.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 4-23

Converting SVA to SVG

This tool converts a graphic file on the HIS in EDF format, to an SVG file.

Figure 4-14 CentumVP SVG Converter

The following steps describe the conversion process:

1. Copy the files


“Yokogawa.IA.iPCS.CENTUMVP.ENG.UTY.SVGConvertTool.exe ” and
“LibToolSVGConvertRes.dll” from the “\Tools\Graphic Converter for
CENTUMVP” folder on the Exaquantum DVD to a location on the HIS.

2. Double-click the file to execute the application

3. Select the Folder Name from the Add Folder button.

4. Select the File Name from the Add File(s) button.

5. Select a graphic file or graphic files to convert from the list.

6. Click on the Browse button. A dialog will be displayed in order to specify where
the converted destination file(s) will be saved.

7. Click on the Convert button. SVG files are written to the specified folder.

Note: This tool can only be used on the HIS computer.

Note: When a Graphic file created by CS 3000 is to be used by the Convert tool, it is
necessary to open that graphic file on CENTUM VP graphic builder and save it
again before running the conversion to SVG.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


4-24 Chapter 4 Creating Graphics and Process Mimics

4.6 Notes on Importing Exaquantum/Explorer Documents


Restrictions

You can create Web mimics based on an existing Exaquantum/Explorer document. This
import does lose some Exaquantum/Explorer document features:

♦ Only the supported controls, lines, arcs, borders etc. will be converted. All other controls
will be lost. See the information about Palette, in Section 4.2, for the supported controls.

♦ All ActiveX components, including Trend, Alarms and Events, are removed from the
converted file. You have to create an html file to embed the converted mimic file (SVG)
together with other ActiveX equivalence configured in the html portion.

♦ All of the scripting will be removed.

♦ Parameterization will be available in the converted mimics, hence no need to amend


the outcome.

♦ Report time will be available in the converted mimics, hence no need to amend the
outcome.

♦ Navigation between documents will be lost. You have to wrap the SVG with a html
file that has navigation features configured.

♦ Inter-components manipulation will be lost. You have to configure each component


with the same condition.

♦ Other complex scripting will be lost. You have to re-engineer the features.

Importing Existing Exaquantum/Explorer Documents

You can start with an existing Exaquantum/Explorer document to create a Web page.

1 Start the Graphics Editor and use the File menu, Import option.

2 In the File Import dialog, select Exaquantum/Explorer document (PXD) file type and
open an Exaquantum/Explorer document file.

3 The program starts to convert the graphics into the native PXG format.

Note: This may take some time depending on the complexity of the source graphics
file. You can see the progress on the screen.

4 Once imported you can edit the file as in the case of a mimic created from scratch.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 5-1

Chapter 5 Creating Pre-configured Trend


The trend page is an html page that consists of the Yokogawa Exaquantum Web Trending
Control, with or without other controls or text around it.

If you just want to see a trend view, you can configure the trend control as described below.
If you want to add more features, for example to show the name of a product being produced,
you have to configure those features around the trend control using standard authoring
functions. This chapter does not cover this case. You should refer to the user manual of the
authoring tool that you are using to add these features.

5.1 Configuring the Trend Control


1 Place the control on the page.

SharePoint Designer: Click on Insert, Advanced, ActiveX Control, then choose the
Yokogawa Exaquantum/Web Trending Control.

Expression Web: Click on Insert Trending Control from the Exaquantum Add-in menu.

2 Modify its dimensions using its resize handles.


Right click anywhere on the control and choose ‘ActiveX Control Properties’ to get the
properties dialog.

Note: Most of the trend properties are the same as those in the trend control in
Exaquantum/Explorer, and you set them in the same way.

3 The ‘Attached data’ items in the Trend Template must be populated with tags that are
dragged from the Data Selector add-in.

Note: You always have to configure tags.

4 Save the file with File menu, Save as Web Page in the designated folder on the web
server. For example:

Drive:/<Install Folder>/Yokogawa/Exaquantum PIMS/WebRoot/Views

5 Use Publish View from the Exaquantum Add-in to add this view to the
Exaquantum/Web site. Supply the name, description and URL of this trend page.

Note: You do not have to supply the entire URL for the page that you have created.
Exaquantum knows the location of the web site, so you need only specify the
folder structure that you have created when you publish a view. For example:

URL /views/trend1.htm

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


5-2 Chapter 5 Creating Pre-configured Trend

This page intentionally left blank

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 6-1

Chapter 6 Creating Pre-configured Alarms and Events


Summary
The Alarms and Events Summary page is an html page that consists of the Yokogawa
Exaquantum Web Event Summary Control, with or without other controls or text around it.

If you want to just see an Alarms and Events Summary view, you can configure the control
as described below. If you want to add more features, for example to show the name of a
product being produced, you have to configure those features around the control using
standard authoring functions. This chapter does not cover this case. You should refer to the
user manual of the authoring tool that you are using to add these features.

6.1 Configuring the Alarm and Event Control


1 Place the control on the page.

SharePoint Designer: Click on Insert, Advanced, ActiveX Control, then choose the
Yokogawa Exaquantum/Web Event Summary Control.

Expression Web: Click on Insert Event Summary Control from the Exaquantum Add-in
menu.

2 Modify its dimensions using its resize handles.


Right click anywhere on the control and choose ‘ActiveX Control Properties’ to get the
properties dialogue.

Note: Most of the properties are the same as those in the control in
Exaquantum/Explorer and you set them in the same way.

3 Save the file with File menu, Save as Web Page in the designated folder on the web
server.

4 Use Publish View from the Exaquantum Add-in to add this view to the
Exaquantum/Web site. Supply the name, description and URL of this page.

Note: You do not have to supply the entire URL for the page that you have created.
Exaquantum knows the location of the web site so you need only specify the
folder structure that you have created when you publish a view. For example:

URL /views/event1.htm

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


6-2 Chapter 6 Creating Pre-configured Alarms and Events Summary

This page intentionally left blank

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 7-1

Chapter 7 Moving a Web Server to a Dedicated PC


As the number of web clients grows, it will become necessary to provide a web server that
runs on a dedicated PC, rather than sharing resources with the Exaquantum server.

On a system that has been running for a period of time, users will have created views and
may have set up MyList and QuickLinks to make selection of their favorite web pages as
simple as possible. This information resides in files that reside on the Exaquantum/Web
server.

To move a Web Server from a combined Exaquantum and Web server to a dedicated Web
Server follow the steps below.

7.1 Set Up the Dedicated Web Server


1 Install the Exaquantum prerequisites for a dedicated Web Server from the Exaquantum
prerequisites CD. (For more information see the Exaquantum Installation Guide.)

2 Install the Web Server from the Exaquantum software CD. (For more information see
the Exaquantum Installation Guide.)

Note: It is strongly recommended that the installation folder is identical to that of the
combined Exaquantum and Web Server.

7.2 Back Up User Views


Views are web pages that have been saved in the Exaquantum/Web site. They must be
copied to the same location in the new web server file structure if they are to continue to be
available to users.

<install>/Program Files/Yokogawa/Exaquantum PIMS/WebRoot/......

The standard Backup function can be used to make a copy of these files. Copy the Back Up
file to the dedicated web server.

7.3 Restore User Views


1 Restore the views from the back up file.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


7-2 Chapter 7 Moving a Web Server to a Dedicated PC

7.4 Remove the Web Server from the Exaquantum Data Server
1 Uninstall Exaquantum.

2 Reinstall the Exaquantum without the Web Server option.

Caution

Do not overwrite the Exaquantum database.

3 Restart Exaquantum.

7.5 Adjusting Views


When Trend views and Alarm and Event views are created using Microsoft Front Page, each
instance of the control on a web page has a URL defined that specifies the location of the
Exaquantum/Web site. When the web server moves to a machine with a different name, the
location of the web site moves with it, and the URL will need to be changed.

The standard URL for the Exaquantum/Web site is <Web Server Machine Name>:<Port
Number>/Exaquantum. If the web server machine name has been changed, the URL
becomes invalid and every reference to it must be changed.

Change the URLs by loading the web page into the Web Authoring tool, making the change
and resaving the page.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 8-1

Chapter 8 Managing the Number of Users


Each Exaquantum/Web client PC connected to Exaquantum must be licensed. However,
because web clients are not bound to any particular client PC, a system of user profiles is
used to manage access to Exaquantum.

When there are more users accessing an Exaquantum/Web server than are covered by the
license, a warning message will be displayed in the browser window.

To avoid this message being displayed to users, you can either:

♦ Contact Yokogawa to obtain a new licence key code to extend the number of
Exaquantum/Web clients permitted.

♦ Remove some currently unused user profiles from the server.

8.1 Deleting User Profiles


User profiles can be removed from the system using the Web Administration Tool, which is
available on the Exaquantum Web server. To be able to access the Web Administration Tool,
you must be a member of one of the Exaquantum Administrators groups:

QAdministratorsGroup (Legacy Security Model)

QTM_MAINTENANCE (Standalone and Domain Security Model)

QTM_MAINTENANCE_LCL (Standalone and Domain Security Model)

To delete User Profiles:

1 From the Windows Start menu, select Programs, Exaquantum, Web Administration Tool.

2 From the list displayed in the Web Administration Tool window, select the User Profile
to be removed.

3 Click on the Delete button.

4 Repeat the above is procedure for each unused profile that is to be removed.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


8-2 Chapter 8 Managing the Number of Users

This page intentionally left blank

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 9-1

Chapter 9 Scope of CS 3000 Conversion


9.1 CS 3000 Primitives
Static Primitives

Table 9-1 Static Primitives

CS 3000 Primitives PXD/PXG Converter


Support
Pen Yes (Limit-C,D)
Straight Line Yes
Polyline Yes (Limit-D,E,F)
Arc Yes (Limit-C)
Rectangle Yes (Limit-C,D)
Circle Yes (Limit-C)
Ellipse Yes (Limit-C)
Sector Yes (Limit-C)
Fill-Area Yes (Limit-C,D)
Marker Yes (Limit-G)
Text Yes (Limit-H,I)
Bitmap No
ISA Symbol Yes
Group Object Yes

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


9-2 Chapter 9 Scope of CS 3000 Conversion

Active Primitives

Table 9-2 Active Primitives

CS 3000 Primitives SVG Converter Support


Process data character Yes
Data Rectangle Yes(limit-A)
Data Arrow Yes
Data Circle Yes
Line-segment Graph Yes
User-defined line-segment Graph Yes
Bar Graph Yes
Step Graph Yes
Radar Graph Yes
2D-Graph Yes
Touch Target Yes (limit-B)
Push Button Yes (limit-B)
Face Plate Block Button No
Instrument Diagram No
Window No
Message No
Dialog Name No
Trend No
Control (ActiveX) No
Overview No
Soft key No

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 9-3

Table 9-3 Limitations

Limitation Description

A Centre not supported.

B Calling user-defined graphic window only.

C Fill area properties Graduation and Fill are set to solid.

D “Roundness of Edge” is not converted.

E Background is not converted.

F Bezier curves are drawn as straight lines.

G Split into independent primitives.

H Text path (D3-5) will not be converted.

I Up vector (D3-6) will not be rotated.

Functions

Table 9-4 Functions

CS 3000 Primitives SVG Converter Support


Calculation Yes
Graphic Modify Yes
Modify Coordinate Yes
Action Yes(limit-B)
Data Bind No

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


9-4 Chapter 9 Scope of CS 3000 Conversion

9.2 Properties
Static Properties

Table 9-5 Static Properties

CS 3000 Primitives SVG Converter Support


Property Item notes
Window Panel Type No
Size Yes
Screen refresh period No
Screen BG colour Yes
Window name Yes
Window Comment Yes
Common Object Name Yes
Position Yes
Size Yes
Tag Object No
Debug No
Line Line Style Yes
Line Thickness Yes
Line Colour Yes
Arrow Yes
Roundness of Edge Yes All types of roundness are converted to same roundness
Fill Fill type Yes “pattern”, “gradation” => “Fill”
FG colour No Data for “pattern”
BG colour Yes
Pattern No Always solid fill
Gradation No Always solid fill
Text Font type Yes
Font size Yes
Font style Yes
Text colour Yes
BG colour Yes
Text angle Yes

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 9-5

Marker Marker Type Yes


Marker Size Yes
Marker Colour Yes

Dynamic Properties

Table 9-6 Dynamic Properties

CS 3000 Primitives SVG Converter Support


CS 3000 SVG attribute Notes
Property
Modifier Change type Yes
Condition No. No Order has same meaning.
Conditional formula Yes
Color change type (*) Overview color is
supported if selected
Normal colored change Yes
process tag.
Alarm color change Yes
Overview color change Yes (*)
Blink No
Transparent Yes
Modify X-Data Yes
Coordinates
Y-Data Yes
Last Move position Yes
Data Bind Set No. Yes

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


9-6 Chapter 9 Scope of CS 3000 Conversion

This page intentionally left blank

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 10-1

Chapter 10 Scope of CENTUM VP Conversion


10.1 CENTUM VP Primitives
Static Primitives

Table 10-1 Static Primitives

CENTUM VP Primitives PXD/PXG Converter


Support
Pen Tool Yes (Limit-B,C,E,K)
Straight Line Yes (Limit-K)
Polyline Yes (Limit-C,D,K)
Arc Yes (Limit-K,M)
Rectangle Yes (Limit-B,C,K)
Circle Yes (Limit-B,K)
Ellipse Yes (Limit-B,K)
Sector Yes (Limit-B,K)
Fill-Area Yes (Limit-B,C,K)
Marker Yes (Limit-F,K)
Text Yes (Limit-G,H,I,L,O)
Bitmap No
ISA Symbol Yes (Limit-J,K)
Group Object Yes (Limit-J,K)
Motor Yes (Limit-J,N)
Others Yes (Limit-J,K)
Pipe Yes (Limit-J,K)
Pump Yes (Limit-J,K)
Switch Yes (Limit-J,K)
Tank Yes (Limit-J,N)
Valve Yes (Limit-J,K)

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


10-2 Chapter 10 Scope of Centum VP Conversion

Active Primitives

Table 10-2 Active Primitives

CENTUM VP Primitives SVG Converter Support


Data character display Yes (limit-I,N)
Rectangle bar Yes (limit-A,K)
Arrow bar No
Circle bar No
Polyline Graph No
User-defined polyline Graph No
Bar Graph No
Step Graph No
Radar Chart No
Two-Dimensional-Graph No
Touch Target No
Push Button No
Face Plate Block Button No
Instrument Diagram No
View No
Message No
Trend No
Windows Control No
Overview No
Soft key No

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 10-3

CENTUM VP Primitive Restrictions

Table 10-3 CentumVP Primitive Restrictions

Limitation Description

A Centre not supported.

B Fill area properties Gradation, Fill, texture and picture


are set to solid.

C “Roundness of Edge” is not converted.

D Background is not converted.

E Bezier curves are drawn as straight lines.

F Split into independent primitives.

G Text path (D3-5) will not be converted.

H Up vector (D3-6) will not be rotated.

I Only MS Gothic will be supported.

J Rotate Right, Rotate left, flip horizontal and flip


vertical will not be supported.

K Degrees of rotation can be supported only 90, 180, 270,


-90, -180 and -270.

L Degrees of rotation can be supported only -90.

M Arrows will not be converted.

N Rotation will not be supported.

O Rotation after grouping will not be supported.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012

S01 9
10-4 Chapter 10 Scope of Centum VP Conversion

10.2 Properties
Static Properties

Table 10-4 Static Properties

CENTUM VP Primitives SVG Converter Support


Property Item notes
Attribute Panel Type No
Size Yes
Screen refresh period No
Window BG colour Yes
Scaling Mode No
Window Name No
Window Comment No
Call Call Window No
Window
Instrument Instrument Command Operation No
Command
Operation
Generic Set No Yes (limit – a)
Name
Set No
Comment No
Generic Name No
Data Value Yes (limit – b)
General Object Name No
Position Yes
Size Yes
Tag Object No
Debug No
Visible Yes Always Visible valid
Enable Yes Always Enable valid
Comment No
Line Line Style Yes
Transparent No
Line Thickness Yes

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 10-5

Hairline Yes
Line Color Yes
Arrow Yes (limit – c)
Arrow Size No
Round Corner No
Disjoint Yes
Arc Arc Size Yes
Clockwise(Sweep Direction) Yes
Counterclockwise(Sweep Yes
Direction)
Is Large Arc Yes
Fill Fill type Yes (limit – d)
FG color No Data for “pattern”
BG color Yes
Transparent Yes
Solid No Always solid fill
Pattern No Always solid fill
Gradient No Always solid fill
Texture No Always solid fill
Picture No Always solid fill
Font Font Yes (limit – e)
Size Yes
Style Yes
Strikeout No
Underline No
Display BorderStyle No
ForegroundBorderStyle No
Style No
Thickness No
Foreground Yes (limit – d)
Background Yes (limit – d, j)
BorderBrush No
ForegroundBorderBrush No

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012

S01 12
10-6 Chapter 10 Scope of Centum VP Conversion

EngineerUnitColor No
Data Is Advanced Alignment No Always Is Advanced
Character Alignment valid
Type No
Date Format No
Time Format No
Number of Digits Yes (limit – f)
Decimal Points Yes (limit – f)
User Specified Alignment No
Alignment No
Leading Zeros Yes
Trailing Zeros Yes Always Trailing Zeros valid
Show Engineering Unit Yes (limit – g)
Engineering Unit No
Unit Length No
Data Bar Bar Type No
Growth Direction Yes
Reference Point No
Marker Shape Yes
Marker Size No
FG Color Yes
Transparency (FG color) No
BG color Yes
Transparency(BG color) Yes
Marker shadow No

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


Exaquantum Engineering Guide – Volume 4 Web Authoring 10-7

CENTUM VP Dynamic Properties

Table 10-5 CentumVP Dynamic Properties

CENTUM VP Primitives SVG Converter Support


CENTUM VP SVG attribute Notes
Property
Modifier Execution Mode Yes
Condition No. No
Conditional formula Yes
Continue Yes
Normal Color Change Yes
Alarm-specific Color Change No
Overview Color Change No
Blink No
Alarm-specific Blinking No
Screen Blinking No
Overview Blinking No
Transparent No
Modify String No
Invert Yes (limit – h, k)
Advanced data X-Axis Value No
linking
X-Axis Low Limit No
X-Axis High Limit No
Y-Axis Value No
Y-Axis Low Limit No
YX-Axis High Limit No
Last Move Position X-Coordinate No
Last Move Position Y-Coordinate No
Data link Property No
Value Yes (limit – i)
Low limit Yes
High limit Yes
Contents No

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


10-8 Chapter 10 Scope of Centum VP Conversion

CENTUM VP Property Restrictions

Table 10-6 CentumVP Property Restrictions

Limitation Description

a Tag Name of Conditional formula will be converted as data variable

b Generic Name of conditional formula will be converted to be replaced


as data Value.

c All arrows will be converted as fixed Arrow Type.

d Fill area properties Gradation, Fill, texture and picture are set to solid.

e Only MS Gothic will be supported.

f Maximum digit number will be supported fifteen.

g In case “Show Engineering Unit” is valid, another format(“Number of


digits”, “Decimal Points”, “Leading Zeros” and “Trailing Zeros” will
be converted as invalid.

h Only text and data character display will be converted.

i Only data character display and rectangle bar will be converted.

j Rectangle bar will be converted as transparency.

k In case it was set to be standard colour change simultaneously, it will


not be supported.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012

S01 14
Exaquantum Engineering Guide – Volume 4 Web Authoring 11-1

Chapter 11 Enable read of large data volumes by Web client


Internet Information Services (IIS), version 6.0 and above, imposes a restriction on the
amount of data that may be returned to a web client in a single message. This may cause
problems for customers upgrading from IIS 5.0 who are accustomed to requesting large
volumes of data (for example, using the Exaquantum Excel Add-in to request data for long
periods or for many tags). The IIS limits may be increased by the following procedure.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012


11-2 Chapter 11 Enable read of large data volumes by Web client

11.1 IIS 7.0 Increase ASP Response Buffering Limit in the IIS Manager
The IIS Response Buffering Limit can be edited using the IIS Manager. After making the
changes IIS will need to be re-started.

This procedure must be run as Administrator on the web server. IIS Manager may be found
from the Control Panel\Administrative Tools menu or by running
mmc %systemroot%\system32\inetsrv\iis.msc.

To modify the ASP Response Buffering Limit in IIS Manager

1 In IIS Manager, expand the local computer, and then browse to the Exaquantum virtual
directory, e.g. <local computer>\Sites\Default Site\Exaquantum

1 Open the ASP feature

2 Expand the Limits Properties node to locate the Response Buffering Limit

3 Change the Response Buffering Limit to a higher value (the default value for Response
Buffering Limit is 4194304 – the exact value to be set will depend on the volumes of
data required), for example: Response Buffering Limit ="41943040" (See Figure 11-1)
102H

Figure 11-1 ASP Settings

4 Apply the changes

5 Repeat for the ExaquantumHome virtual directory if required.

To restart IIS

6 Restart IIS by typing iisreset at a command prompt that has been run as administrator.

IM 36J04A15-04E 11th Edition Issue 1 March 5 2012

You might also like