Professional Documents
Culture Documents
IM 36J04A15-04E
© Yokogawa March 5 2012
11th Edition Issue 1
Exaquantum Engineering Guide – Volume 4 Web Authoring i
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
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.
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.
Highlights
The Highlights section gives details of the changes made since the previous issue of this
document.
Summary of Changes
Detail of Changes
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
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
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.
Web Server
External Data:
ERP,
PCS Interface
Exaquantum/PIMS
LIMS, etc
(Server)
Exaquantum/PIMS
(Server)
Exaquantum/PIMS
(Server)
OPC Servers
TIC1-2
http://<ExaquantumWebServerName>:<PortNumber>/ExaquantumHome
Where:
<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’.
The Exaquantum/Web client can be installed in either of two ways, in each case the user
must have administrator permissions on the PC:
Refer to the Exaquantum Installation Guide on the CD for more information on this topic.
1-2. The tool can be accessed from the Windows Start menu.
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.
♦ Data users
♦ Administrators.
http://<ExaquantumWebServerName>:<PortNumber>/ExaquantumHome
The first page the user will see is a Role based view of Exaquantum data. From here the user
can:
♦ 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:
♦ Pre-configured trends
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.
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.
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.
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.
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.
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 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.
If you have project specific requirements to end up with specially built pages, for example
LIMS data entry page, you can do this by:
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
You cannot change the look and feel of the Exaquantum/Web site, including the location or
size of screen elements.
There are two distinct authoring tools: Graphics Editor and a commercial tool
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.
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 client scripting, except pre-defined ones (see below).
The Web pages that you have to use SharePoint Designer or Expression Web to create include:
♦ Any mixture of any of these elements, e.g. a plant mimic showing a trend next to it
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:
♦ Parameterization in mimics – this allows a selection of data items to show, e.g. raw item,
hourly aggregated mean, etc.
♦ 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.
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.
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.
♦ 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.
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.
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:
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.
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.
2. Select Advanced Controls from the Component type (left column), then ActiveX
Control from the list displayed on the right.
3. Click on Next to display the controls that are available for selection.
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.
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.
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.
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.
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>
// 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.
♦ 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.
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.
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.
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:
Note: The History Replay option is only available in Exaquantum/Explorer and is not
supported in the Graphic Editor.
User Interface
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.
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
3 In the object’s Property Sheet dialog box, locate the Hyperlink property.
These take the form of a standard internet URL. An example could be:
http://www.yokogawa.com/
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
<path to file> is the file name and location of the file within the servers Web file system.
♦ 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.
<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
?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.
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.
Then how the new Internet Explorer window is displayed can be controlled using the
Hyperlink Navigation Properties window.
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:
♦ 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.
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:
♦ 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
♦ 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.
Palette
As in Exaquantum/Explorer, the palette has number of Native objects that can be used in the
PXG graphics:
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:
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:
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.
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.
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:
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:
♦ 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.
Simple Expressions
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):
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.
Note: Expressions can be evaluated once (when the View is first displayed), or on every
refresh.
The following table shows a list of valid operators that can be used in Simple expressions:
Operator Description
( ) Priority
+ Add
- Subtract
* Multiply
/ Divide
& Bit AND
| Bit OR
Conditional Expressions
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.
Figure 4-9 shows an example of the Expression Editor in Conditional Expression mode.
The following table shows a list of valid operators that can be used in 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
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.
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:
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.
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.
The log files are located in the users temporary folder (%TEMP%), for example on
Windows7:
C:\Users\<username>\AppData\Local\Temp
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
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”
uncheck "User must change password at next logon" and check “Password never
expires”
• 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.
• SVG File - Destination SVG file name. Refer to Converting SVA to SVG
• 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.
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..
This tool converts a graphic file on the HIS in EDF format, to an SVG file.
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.
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.
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:
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.
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.
The log files are located in the user’s temporary folder, for example:
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
• SVG File - Destination SVG file name. Refer to Converting SVA to SVG
• 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.
This tool converts a graphic file on the HIS in EDF format, to an SVG file.
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: 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.
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.
♦ 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.
♦ Other complex scripting will be lost. You have to re-engineer the features.
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.
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.
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.
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.
4 Save the file with File menu, Save as Web Page in the designated folder on the web
server. For example:
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
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.
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.
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
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.
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.
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.4 Remove the Web Server from the Exaquantum Data Server
1 Uninstall Exaquantum.
Caution
3 Restart Exaquantum.
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.
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.
♦ Contact Yokogawa to obtain a new licence key code to extend the number of
Exaquantum/Web clients permitted.
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.
4 Repeat the above is procedure for each unused profile that is to be removed.
Active Primitives
Limitation Description
Functions
9.2 Properties
Static Properties
Dynamic Properties
Active Primitives
Limitation Description
S01 9
10-4 Chapter 10 Scope of Centum VP Conversion
10.2 Properties
Static Properties
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
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
Limitation Description
d Fill area properties Gradation, Fill, texture and picture are set to solid.
S01 14
Exaquantum Engineering Guide – Volume 4 Web Authoring 11-1
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.
1 In IIS Manager, expand the local computer, and then browse to the Exaquantum virtual
directory, e.g. <local computer>\Sites\Default Site\Exaquantum
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
To restart IIS
6 Restart IIS by typing iisreset at a command prompt that has been run as administrator.