Professional Documents
Culture Documents
Copyright
Copyright Delta Controls Inc. All rights reserved.
Document Title: Delta Controls Administrator Guide
Current Edition: 3.4 0
Date: October 2011
2
Table of Contents
Using This Administrator Guide .............................. 6
Introduction .................................................................................................................. 7
Assumptions ................................................................................................................. 7
Getting Help ................................................................................................................. 8
4
PutArrayProperty ...................................................................................................... 86
PutProperty................................................................................................................. 87
Examples ...................................................................................................................... 88
Dynamic Graphics .................................................................................................. 94
Objects and Functions .............................................................................................. 94
Creating an Array of Image Files ....................................................................... 96
CreateImageArray ..................................................................................................... 96
Adding Data Links .................................................................................................. 97
LinkManager.AddLink ................................................................................................ 97
Adding Animation Links ........................................................................................ 98
LinkManager.AddAnimation ..................................................................................... 98
Adding a Stepping Image Link ............................................................................ 99
LinkManager.AddSteppingImage.............................................................................. 99
Creating Hyperlinks............................................................................................. 101
LinkManager.SetAnchor..........................................................................................101
Creating a Hyperlink to Specified Device Objects .................................... 102
LinkManager.SetAnchorToObject ........................................................................102
Adding a Digital Color Link ............................................................................... 103
LinkManager.AddDigitalColorLink .......................................................................103
Viewing the Online Status of Graphics ......................................................... 105
Function List Examples....................................................................................... 106
Using the Graphics Folder .....................................................................................113
5
Using This Administrator Guide
Using This Administrator Guide
Introduction
This Administrator Guide discusses the installation and
maintenance of the ORCAweb system. It deals specifically
with creating and managing user groups, system security, and
energy management, creating pages and graphics and setting
user access.
Purpose
The main purpose of this guide is to provide facility managers
and network administrators with a simple, concise treatment
of how to set up, use, and adjust the ORCAweb system.
Audience
The intended audience of this guide is the facility managers
and network administrators who will be installing,
programming, and maintaining the ORCAweb system.
Conventions
The ORCAweb documentation often refers to clicking on a
word or object that is acting as a hyperlink to a new web
page. This term always refers to using the left-mouse button
(for a right-handed person).
To access the online documentation press the Help button
that is visible in the Navigator, Tenant Portal, and
Administrator pages. The conventional use of F1 to access
help is not available in this release of ORCAweb.
Assumptions
We have made some assumptions about the Windows and
web knowledge that users already have when using this
software & documentation.
7
that describes the basics of selecting, clicking, and navigating
through Windows.
Getting Help
There are three separate online help documents for the
ORCAweb system:
ORCAweb Administrator Help
ORCAweb Operator Help
ORCAweb Tenant Help
Use the Help button within the ORCAweb system to access
these documents.
Electronic Documentation
The ORCAweb installation CD-ROM also includes PDF files
for the ORCAweb Administrator Guide along with the print
copy that came with the installation package.
8
1 - Introducing ORCAweb
What is ORCAweb?
ORCAweb is a web-based front-end for use by both facility
staff and building tenants. The application was developed with
the needs of both groups in mind. It is a PC-based web server
that connects to both the building automation network and
the facility LAN.
ORCAweb is based on client-server architecture. Based on
your access level, you may view graphics, device architecture,
object properties, Tenant Portals, and Virtual Stat.
ORCAweb has several functions that make it ideally suited
for use in large facilities with many tenants who may be
connected to the facility LAN or the Internet.
The system consists of several major components:
Administration pages
Navigator
Tenant Portals
Virtual Stat
Personal Digital Assistant (PDA) Access
Administration Pages
Administration pages allow the Administrator to add, create,
and modify users, areas, or user groups, as well as configure
ORCAweb and generate reports.
Navigator
The Navigator pages are used mainly by Operators, and it
allows them to view and modify control system objects
through a browser. This eliminates the need for ORCAview
on multiple PC's because ORCAview only needs to be
installed on the server PC.
10
1 - Introducing ORCAweb
Tenant Portal
The Tenant Portal is a source of information about the
area(s) that the tenants/users can access. Using the Tenant
Portal, users can control specific equipment within their
designated areas.
Based on the way the areas are setup by the Administrator, a
Tenant can view inside temperatures, outside temperatures,
occupancy status, and trend logs. The Tenant can also view
or modify the set point temperature, set point occupancy,
schedule, and calendar.
Users can customize their portal page by adding, reordering,
or removing an area, or by choosing which parameters will be
visible within a specific area.
Virtual Stat
Virtual Stat is a stand-alone program used by Tenants. Virtual
Stat allows the Tenant to view outdoor and indoor
temperatures, change the temperature setpoint, and turn
occupancy status on/off from their PC. Users can download
this program through their Tenant Portal.
11
ORCAweb Users
The ORCAweb system has three types of users.
Administrators
Administrators have access to the Administration pages
where they can add, delete, and modify users, user groups,
and areas used as Tenant Portals. Administrators can also
configure ORCAweb and generate reports.
Operators
Operators have access to Navigator, where they can modify
ORCAview system objects.
Tenants
Tenants have access to their personalized Tenant Portal and
Virtual Stat, where they can modify values such as the
Temperature Setpoint, Calendar, and Schedule for their
specific area.
System Architecture
The following diagram is an example of what the ORCAweb
system might look like.
12
1 - Introducing ORCAweb
System Requirements
Server PC
One Of:
Windows Server 2008 (32 / 64 bit)
Microsoft Internet Information Services 7.0
Windows Vista Business, Enterprise or Ultimate Edition (32 /
64 bit)
Microsoft IIS 7.0
Windows Server 2003 (32 / 64 bit)
Microsoft IIS 6.0
Windows XP Professional Edition (SP2)
Microsoft IIS 5.1
Windows 2000 Server (SP4)
Microsoft IIS 5.0
Windows 2000 Professional (SP4)
Microsoft IIS 5.0
ORCAview 3.33 software
ORCAweb 3.33 software
Software Key with ORCAweb feature enabled
Client PC
A Windows based computer that will run the supported
browsers.
A recommended screen resolution of 1024 x 768 or higher.
13
Supported Browsers
Internet Explorer 6.0 and higher for all features and functions
(Real-time Graphics are only supported in Internet Explorer).
Firefox 1.5, 2.0 or 3.0 for Navigator and the Tenant Portal.
Installing ORCAweb
There are three stages to installing ORCAweb:
install ORCAview;
install Internet Information Services (IIS);
install ORCAweb.
To Install IIS 5.0, 5.1 or 6.0 (for Windows 2000 Pro, XP and
Server 2003):
1. Install Windows 2000, Windows XP or
Windows Server 2003.
2. For Windows XP, Install Service Pack 1 (SP1) or
higher. Windows XP SP1 or higher is required.
3. Click Start, point to Settings, click Control Panel
and start the Add/Remove Programs application.
4. Click the Add/Remove Windows Components
button.
5. For Windows Server 2003, Check the
Application Server and click the Details button.
14
1 - Introducing ORCAweb
15
To locate the IP address:
1. On the server, open the Command Prompt.
2. Start > Programs > Accessories > Command
Prompt.
3. Run ipconfig in the Command Prompt window.
4. Write down the IP address.
Once you have the address, other users can access the server
by entering the following: http://IPaddress /deltaweb/login.asp
where, IP address would be replaced by the actual address,
for example, 192.143.2.132.
Logging in to ORCAweb
To log into ORCAweb, the user must enter their Username
and Password on the Login page. If a user attempts to access
any ORCAweb pages without logging in, they will be
redirected to the Login page. The user will remain logged into
ORCAweb until they close their browser or stop using
ORCAweb for more than 20 minutes.
16
1 - Introducing ORCAweb
17
2 - Using ORCAweb
2 - Using ORCAweb
Introduction
ORCAweb Administrators use the Administration pages to
configure and control user access. From the Main menu, they
can also access reports on database and tenant activity or
execute commands such as resetting the server. The settings
made by Administrators are stored in a database.
There are three major categories used to organize the
system: Users, User Groups, and Areas.
Users
Users are the people who log in and use the ORCAweb
system. This can include Tenants, Operators, and
Administrators. An Administrator should issue a username
and password to each person who will be using the system.
The areas of the system that a user can access are
determined by the groups a user belongs to and by the user
settings.
By default, users will be greeted with their Tenant Portal after
logging into the system. This page displays data about all the
areas the user can access, as well as links to the Navigator
and Administration pages (if they have access).
By default, there is a special user called Admin in the database. This
account should be used the first time the site Administrator logs into the
system.
User Groups
User Groups store settings that are common among a
number of users. These include: a groups access rights to
Navigator, specific areas they can access, and alarms received
via email.
By default there is a special user group called Administrators
in the database. To access the Administration pages, a user
must be a member of the Administrators group.
19
Areas
An area corresponds to a section of a building. These areas
have equipment associated with them that include
temperature, setpoint for the temperature, outside
temperature, and occupancy status. They may also contain a
Trend Log, Schedule and Calendar that is associated with an
area.
If an area has more equipment that needs to be included,
Administrators can add it. This could be another set of lights,
the areas humidity, control for a fan, etc.
Users and user groups are given access to areas either
directly or through group membership: if they have access,
the area appears on the users Tenant Portal page.
Example
Shayla and Tony are both members of the Admin user group.
This gives them administration access to the system. Richard
and Shayla are members of the QA user group, which gives
them access to the Quality Assurance area. Because Shayla is
a member of both user groups, she has access to all the areas
these groups include.
20
2 - Using ORCAweb
Hover you your cursor over the Main menu you can select
the following options:
Adminpage
Adminpage contains general information and properties about
the ORCAweb site.
Site Information displays the detail of the specific site
ORCAweb is connected to.
21
Statistics displays the Total Users, Total User Groups, Total
Areas, and Total Equipment available in the database.
I/O Statistics displays the Total Input/Output objects
currently in the system. The Input/Output Limit displays the
maximum allowable Input/Output objects (version
dependent).
If the Total Inputs/Outputs exceeds the Input/Output Limit,
ORCAweb will disable access to controllers in the network.
The Administrator will still be able to access all of the admin
pages to make information changes. Contact the vendor if
you require an ORCAweb version with a higher I/O Limit.
Adminpage Settings
Adminpage Settings allows the administrator to change
settings specific to the site.
To access these settings, either press Adminpage Settings
from the Main Menu or press the Settings button on
the top right corner of the Site Information section of the
Admin page. There are three main areas: Site Information,
Site Login and SMTP Settings.
Site Information
Under the Site Information section, the administrator will be
able to change the following information:
Company Name: The name of the company using
ORCAweb.
Site Name: The title seen on the Tenant Portal
pages. (The Administrator can choose any title.)
Administrator: The name of the Administrator for
the site.
Phone number: Administrators phone number.
Email address: Administrators email address.
22
2 - Using ORCAweb
23
Delta Site Login
Under the Delta Site Login section are the settings
ORCAweb uses when logging into the Delta ORCAview
software. These settings should be the same as those used to
log on to ORCAview. If the Site Name is left blank,
ORCAweb will use the default ORCAview site.
When changes are made in the ORCAview user name and password,
the ORCAweb username and password also need to be changed.
SMTP Settings
Under the SMTP Settings section, the user can set up the
SMTP server for sending email alarm notifications. ORCAweb
will send alarms through the server indicated in these settings
to the appropriate alarm recipients. If this feature is not
needed, these fields can be left blank.
Server: IP address or DNS name of the SMTP
Server.
Username: Username to logon to the SMTP server.
(Leave blank if not required)
Password: Password to logon to the SMTP server.
(Leave blank if not required)
Sender: The name that will appear in the email
header.
Sender Address: The sender email address that will
appear in the email header.
ORCAweb Address: The desired ORCAweb address
that is used to construct the hyperlinks in the alarm
notification email. The default is blank (ORCAweb
auto detects the address).
Navigator Settings
Under the Navigator Settings area of the Adminpage, the
administrator will be able to change:
24
2 - Using ORCAweb
25
Camera Server Settings
Under the 'Camera Server Settings' section, the user can add,
remove and edit camera servers in the Navigator tree.
26
2 - Using ORCAweb
Add Camera
1. Click Camera Server Settings found under the
Main menu on the left hand admin menu bar.
2. Click on the name of the camera server link to
which you want to add a camera to take you to
the Edit Camera Server page.
3. Click on the Add Camera link to add a new
camera.
4. Enter the cameras information.
Camera Name: Name of the camera
to be displayed in the Navigator tree.
URL Address: IP address or DNS of
camera.
5. Click Add to apply changes.
Edit Camera
1. Click Camera Server Settings found under the
Main menu on the left hand admin menu bar.
2. Click on the name of the camera server link you
wish to edit. This will take you to the Edit
Camera Server page.
3. Click on the name of the camera you wish to
edit. This will take you to the Edit Camera
page.
4. Edit the camera information.
5. Click OK or Apply to accept the changes.
27
Alarm Settings
The Alarm Settings page, which is found under the Main menu
on the left hand admin menu bar, contains the settings for
administrating the Alarms shown in Navigator and may
consist of two main parts.
Alarms Settings
Event Log Settings
Alarm Settings
The Alarm Settings allows for levels and priorities of alarm
event classes to be changed. The priority of an event class will
affect how the alarms are displayed in the 'Alarms' folder in
Navigator.
Each event class can have a color associated with it:
Red: High importance (critical)
Yellow: Medium importance
White: Low importance (notification)
An event class is also listed in priority within each level.
Alarms with a higher priority event class (higher up in the
Event Class Setting list), will be listed above other alarms in
the alarm folder. This helps draw attention to the most
important alarms in the alarms folder.
28
2 - Using ORCAweb
29
The ordering of this list determines the order the alarms are
shown in the alarms folder.
30
2 - Using ORCAweb
31
Menu Options: User
Users are the people who log in and use ORCAweb; this can
include Tenants, Operators and Administrators. An
Administrator should issue a username and password to each
person who will be using the system.
The areas of the system that a user can access are
determined by the groups a user belongs to, and by user
settings.
By default, after logging into the system, a user will be
greeted with their Tenant Portal. This page displays data
about all the areas the user can access, as well as links to the
Navigator and Administration pages (if they have access).
Adding Users
To add a new user:
1. Go to the Administration home page,
Adminpage.
2. Hover your cursor over the User button in the
menu on the left side of the screen.
Two options display, All Users and Add New
User.
3. Click Add New User. This will take you to the
Add New User page.
32
2 - Using ORCAweb
Copy user option will copy all information about the user and his/her
membership information. E-mail address, however, will not be copied.
33
Maintaining Current Users
Click the User or All Users menu options to access a list of
all the users in the system.
If there are more than 25 users in the system, the list will
appear on multiple pages. You can access additional pages by
clicking the arrow button on the bottom right of the page.
To access detailed information about a user, click that users
name.
This page also allows you to delete users. Click the box next
to a users name so that a checkmark appears, then choose
the Delete button to remove the selected user.
Clicking on the column title will re-sort the user list. If you click on User
Name, the users will be sorted into alphabetical order (A to Z or Z to A).
If you click Last Login, the users will be sorted starting with the most
recent login.
34
2 - Using ORCAweb
Administration Page
On login, the administration main page opens for the user. If a
user does not belong to the Administrators user group, then
an error page opens, and the user cannot access ORCAweb.
Navigator Page
On login, the main Navigator screen opens for the user. If a
graphic was selected (via the select graphic button located
beside the Start Page drop down box), then the right-hand
screen of Navigator will contain the selected graphic.
35
Tenant Portal Page
On login, the Tenant Portal main screen opens for the user. If
the user lacks access to any areas, then this main screen will
only contain a menu bar.
Graphic
On login, the selected graphic opens in full screen for the
user. This means that the Navigator tree is not present on
the left. If a user still has Navigator access (via a user group
with Navigator access) then the user can access other
ORCAweb pages by entering the complete URL in the
address bar. To prevent access to Navigator pages from the
address bar, ensure that all the User Groups for this user
have the Access Navigator checkbox deselected.
Click the OK or Apply button to apply any changes made to
the users information.
Active Alarms
On login, the Active Alarm screen opens in navigator frame
for the user.
To apply any changes made to the users Start Page options
Click Apply or OK.
User Membership
The User Membership section allows membership (of the
specific user) to be set for User Groups, Additional Areas,
Subscribed Alarms and Navigator Exceptions.
Member of
The Member of list allows for User Group membership to be
set.
36
2 - Using ORCAweb
Additional Areas
The Additional Areas list allows access to be granted for
additional areas that the user may not have access to via the
User Groups they belong to.
Subscribed Alarms
The Subscribed Alarms list indicates the alarms that the user
will be notified about through email. These alarms are in
addition to those already assigned via the User Groups they
belong to.
Navigator Exceptions
The Navigator Exceptions list indicates the objects that the
user can access apart from the access already provided via
the User Groups they belong to. Users will have full access
rights to the objects that are in the list.
37
On this page the areas or user groups can be changed. Items
can be moved between the lists by selecting the item and
clicking the Right or Left arrows. To return to the Edit User
Info page, click the OK button.
From this page you can add or remove the alarms that a user
is notified about through email.
To add or remove an Event or Event Class:
1. To add an event (EV) or event class (EVC),
reference it in the New box
2. Click the Add button.
- or -
1. To remove an alarm from the current list, select
the alarm you want to remove and
38
2 - Using ORCAweb
39
(includes both navigator and graphics). For example, if you
type in 8200.DEV8200, you should have access to all objects
in device 8200.
User access to Navigator and Navigator objects is given based on the
highest level of access that the user has, either through group membership
or Navigator Exceptions. For example, if a user belongs to two user
groups, one of which can access Navigator and the other that cannot, the
user WILL have access to Navigator.
40
2 - Using ORCAweb
The user group name must not be the same as any other group within the
system. If the name is not unique, then the user group is not created and
an error message will display.
41
To access detailed information about a user group; click on
the name of that user group. You can also delete user groups
from this page. Selecting the box next to a user group and
then clicking Delete will remove the selected group from the
list.
Clicking on the Group Name will resort the list alphabetically. If you click
on it again, the list will be reversed (z - a).
42
2 - Using ORCAweb
43
Navigator Access
In order for a user to view the Navigator pages, they must
belong to a user group that has been given Navigator access.
To give a user group access to Navigator, check the Access
Navigator checkbox on the User Group Editing page.
When the Access Navigator checkbox is selected, a table of
items becomes available to help further customize the access
for the user group.
44
2 - Using ORCAweb
add reports to the list, select the reports from the dropdown
menu underneath the table.
Device Tab
Device level access for the user group may be set here. If the
Restrict device access box is empty, the user group will have
access to all the devices on the entire site. If selected, then
the administrator may give the user group access to specific
devices, systems or a range of device numbers.
To set accessible devices for a restricted user group:
1. Click the + button in the Accessible Devices
table.
2. Select an Area, System (Subnet), Single (Device),
or Specific (Range) devices for accessibility.
45
BACnet Tab
Specific access to individual types of BACnet objects may be
set here. The device level access takes precedence over
object level access, and thus the object level permissions in
the BACnet tab will only be applied to the devices that the
user group has access to.
Object access levels can be set to the following:
None: If a user has 'None' access, then they can
neither view nor edit objects of that type.
Read: If a user has 'Read' access, then they can view
values for the given object type.
Edit: If the user has 'Edit' access, they can view and
edit values for the given object type.
46
2 - Using ORCAweb
V2 Tab
Specific access to individual types of V2 objects may be set
here. This tab acts in the same manner as the BACnet tab,
except that it deals with access to V2 objects. Please see the
above BACnet tab paragraph for an explanation on usage and
the access levels.
47
Accessible Areas all the defined areas that users in the
group can access.
Subscribed Alarms all the alarm notifications assigned to the
group members
48
2 - Using ORCAweb
49
has more equipment that needs to be included, the
Administrator can add them; equipment such as a different
set of lights, the areas humidity, control for a fan in this area,
etc.
Users and user groups are given access to specific areas. If a
user has access to an area, either directly or through group
membership, the area appears on the users Tenant Portal
page.
50
2 - Using ORCAweb
The Object Selector buttons beside the Calendar, Schedule, and Trend
Log will allow the user to choose the corresponding objects.
51
Manually Entering Object References
In some situations the Object Selector may not provide a
selection for the object type desired for a reference. In this
situation, the reference can be typed directly into the field.
The references should be entered in the following form:
BACnet objects: 500.AV1
Version 2 objects: V2.100.IP1
52
2 - Using ORCAweb
Clicking on the Area Name will re-sort the list alphabetically. If you click
on it again, the list will be reversed (z - a).
53
add or remove items from each list, click the Edit button
beside the user groups and users.
54
2 - Using ORCAweb
55
Custom Icons
To Use a Custom Icon you must:
Place the desired icon file in the 'images' folder
where ORCAweb has been installed. This is most
commonly located at
"C:\inetpub\wwwroot\deltaweb\media\images".
Select Other from the Equipment Icon drop down
box.
Enter the name of the image, including the extension,
(for example, myIcon.gif), into the edit box that
appears.
On the Tenant Portal page, the icon image size is fixed (32
pixels by 32 pixels) regardless the original size of the image
file. Use a small image file to reduce bandwidth.
56
2 - Using ORCAweb
Database Reports
Administrators can generate a report containing information
about the Users, User Groups, or Areas in the system using
the Database Report page.
To generate a Database Report:
1. Access the Database Report page by clicking on
the Report button or Database Report button
on the Adminpage.
57
2. In the Report Settings section of the report
generation page, select the desired type of
report (Users, User Groups or Areas).
3. Add a title for the report (optional), and choose
the filtering options.
58
2 - Using ORCAweb
Tenant Log
The Tenant Log shows all the changes made by tenants
through the Tenant Portal pages and Virtual Stat. It also
shows details of the changes made and is sorted by the time
of the change.
If there are more than 100 entries in the log, it displays on
multiple pages that can be accessed using the arrows at the
top and bottom of the log.
The search bar at the top of the report can filter for specific
logs based on a keyword; when a keyword is used to Search,
the logs containing that text or part of that text (in any
column of the table) will be shown in the report.
59
The log shows the changes made over the past few days. The
number of days recorded in the Tenant Log can be changed
on the Edit Admin Info page by adjusting the Tenant Log Size
found under 'Settings' on the Main admin page.
The Tenant Log will be automatically cleared out every day at midnight. In
this example, only the logs of the last 2 days will be shown.
Operator Log
The Operator Log shows all the changes made by Operators
via the object pages, graphics and Acknowledge Alarm. It
60
2 - Using ORCAweb
The log shows changes made over the past few days. The
number of days recorded can be changed by adjusting the
Operator Log Size found under 'Adminpage Settings' on the
Main admin page.
61
The Operator Log will be automatically cleared out every day at midnight.
In this example, only the logs of the last 2 days will be shown.
62
2 - Using ORCAweb
Reload Descriptor
This option commands ORCAweb to clear and reload object
descriptors from all devices.
Note: This command will only reset, it will not reset IIS nor
will it reset the PC.
Reset Server
This option button commands to restart the network
connection.
63
Alarm Notification Graphic Configuration
This feature allows administrators to configure a graphic with
an alarm that can be launched from the Active Alarm List and
Alarms Notification Bar by creating a text file that associates
graphics with the monitored objects.
An alarm sound occurs each time the alarm notification bar is
displayed for an off-normal alarm. This sound stops once the
alarm notification bar is closed or if the notification appears
after an alarm has already been acknowledged.
The contents of the text file that associates graphics with
monitored objects are text lines of 3 forms shown below.
graphic=<filename>
loadOnEvent=
<Object Reference>
64
2 - Using ORCAweb
graphic=AHU1_Alarm_Graphic_FreezeStat.gpc
loadOnEvent=yes
200.BI6
graphic=AHU1_Alarm_Graphic.gpc
loadOnEvent=yes
300.EV*
graphic=VAV1.gpc
loadOnEvent=yes
101.AV1, 101.AV2, 101.AV3
The text file MUST be an ANSI text file, not a Word document or a
UNICODE text file.
65
3 - Configuring System Security
3 - Configuring System Security
67
Service Packs (Win2000)
http://www.microsoft.com/windows2000/downloads/servicep
acks/default.asp
Service Packs (Windows Server 2003)
http://www.microsfot.con/technet/downloads/winsrvr/service
packs/default.mspx
Firewall
A firewall in a network is a node set up as a barrier to
prevent traffic crossing from one segment to another.
Firewalls are used to improve network traffic as well as for
security purposes, and may serve as a barrier between
connected public and private networks. A firewall may be
implemented in a router or it may be a network device
specialized for this purpose.
If you are using a Firewall, ensure that it is set up properly in order for
people from outside of the firewall to access ORCAweb.
68
3 - Configuring System Security
ORCAweb runs under the IIS service, it does not require a user to log on
to activate the service.
69
4 - Creating ORCAweb Graphics
4 - Creating ORCAweb Graphics
Required Knowledge
A user will need to have basic knowledge of HTML and ASP
(Active Server pages) to create graphics for ORCAweb.
ORCAweb support functions use VBScript and JavaScript
technology to retrieve real-time value. Although not required,
it is an asset if the user has knowledge of these languages.
Real-Time Graphics
71
Saving Illustrator Graphics as Web Pages
ORCAview allows the user to save Illustrator site graphics
into web pages. These web pages can be used in ORCAweb
to display real-time data.
Graphics Dimensions
Auto Scale: The output graphics will resize accordingly
when the user resizes the browser window.
Preserve aspect ratio: The aspect ratio of the graphics will
be preserved when resizing the browser window.
Fixed Size: Allows the user to specify a fixed size of the
output graphics (in pixels).
Use current size: The output graphics will be of the same
size as the current Illustrator graphics.
72
4 - Creating ORCAweb Graphics
Data Links
Show context menu: This pops up a context menu when
the user hovers the mouse over any data links. The user can
go to or command the linked object using the context menu.
Create hyperlinks to objects: Create hyperlinks on the
graphics elements to go to the linked objects (hyperlinks are
created only when the context menu is disabled).
Show tooltip: Shows a tooltip when the user hovers the
mouse over any data links (tooltips are only shown when the
context menu is disabled).
73
While saving the web page, you can select options that
pertain to a specific page.
74
4 - Creating ORCAweb Graphics
75
references to fields (or variables) in the current
graphic
object names found on the same form (eg:
"MyTextField")
a reference to a value contained in another object
(eg: "Text Box")
This edit box may contain real devices numbers (eg: 9900),
and/or object names found on the same form
(eg:"MyTextField") separated by either commas or
semicolons. (eg: 9900, "MyTextField") If object names are
specified, their current values will be used.
When the event is triggered, the values are passed to the
destination graphic and are used in the order that they are
discovered. For example, if three values are defined (x, y, z),
the newly opened graphic expects to find three placeholders
(%1, %2, %3) inside it.
A graphic file may also be pre-loaded with initial values. These
values are stored in an array in the form and are used if the
graphic is loaded directly from disk or if the calling graphic
neglects to specify the right number of arguments. It is
optional to enter in default device numbers in the
DefaultDevices array. These default numbers provide a
fallback if a graphic is loaded via a goto/replace in a way that
does not meet the expectations of the original design.
For example, if a graphic file with delayed links (placeholders)
is loaded stand-alone, by using the File->Open command,
then the graphic looks in the DefaultDevices array in the
Advanced tab of the object Properties to obtain the default
devices to use for the delayed links. These default device
values are also used when an insufficient number of device
numbers are specified in the Goto or Replace Graphic
methods.
76
4 - Creating ORCAweb Graphics
Group X FillColor
X can be inherited by child Shape,
X Line and Arc.
Text Text
Strikeout.Alignment
(Text does not wrap if too long)
Line / Polygon X X X X X
Arc StartArcAngle
X X EndArcAngle
Pushbutton Caption
X X
WallPaper (stretch mode only)
77
Size Fill Line Font Other Properties
Position
Visibility
EditBox Text
(Converted to
Text) Suffix (fixed style 1 space)
Digital FrameRate
Animation
Object StopItem
X
ItemList
AnimationMode
Analog RangeValue
Animation
Object X ItemList
Translation Properties
78
4 - Creating ORCAweb Graphics
Translation Properties
DirectFlag Visibility
ReverseFlag Visibility
Replace Graphics
79
PropertyAccess Function List
Eleven property access functions use ASP code. The following
examples use VBScript.
BatchGet
Retrieves the properties specified by BatchProperty.
Syntax
BatchGet()
Description
Call BatchGet to retrieve all the properties that are specified
by BatchProperty. Using BatchProperty and BatchGet is a
more efficient way of retrieving multiple properties.
Example
Set PropertySrv = Server.CreateObject("DeltaWebServe.PropertyAccess")
PropertySrv.BatchProperty("BAC.100.AI1.Value")
PropertySrv.BatchProperty("BAC.100.AI1.Units")
PropertySrv.BatchGet()
BatchProperty
Adds a property to a batch.
Syntax
BatchProperty( PropertyRef as String )
Description
Call BatchProperty to add a property to the batch. When
BatchGet is called, all the properties that are added to the
batch will be retrieved.
The data is then returned when GetProperty is called.
Using BatchProperty and BatchGet is a more efficient way of
retrieving multiple properties.
Example
Set PropertySrv = Server.CreateObject("DeltaWebServe.PropertyAccess")
80
4 - Creating ORCAweb Graphics
PropertySrv.BatchProperty("BAC.100.AI1.Value")
PropertySrv.BatchProperty("BAC.100.AI1.Units")
PropertySrv.BatchGet()
CommandObject
Issues a command to the specified object.
Syntax
CommandObject(ObjectRef as String, Command as String,
CommandValue as String)
Description
Call CommandObject to command the specified object to the
Auto/Manual state and/or specify the manual value.
The valid commands are as follows: Auto, Manual, ManualOn,
ManualOff, ManualValue, Reset, Reconfigure, SaveToFlash,
LoadFromFlash, and SetTime.
CommandValue is optional. It is only required when
Command is "ManualValue" or "SetTime".
For "Reconfigure", "SaveToFlash" and "LoadFromFlash"
commands, the ObjectRef must be a BACnet or V2 device
reference (e.g. BAC.100.DEV100 or V2.100.CP1).
For the "SetTime" command, ObjectRef must be a BACnet or
V2 device reference or can be "*" to set the time on all
devices on the network.
Example
Command an AO object to manual value 20.5.
Set PropertySrv = Server.CreateObject("DeltaWebServe.PropertyAccess")
PropertySrv.CommandObject("BAC.100.AO1.Value", "ManualValue","20.5")
81
GetArrayProperty
Retrieves an array property.
Syntax
GetArrayProperty ( PropertyRef as String ) as Array
Description
Call GetArrayProperty to retrieve all elements of an array
property. The functions will return an array of string.
If the user only wants to retrieve an individual element, use
GetProperty with the array index specified in a square
bracket. For example,
GetProperty(BAC.100.MV1.StateText[1])
Example
Set PropertySrv = Server.CreateObject("DeltaWebServe.PropertyAccess")
StateTextArray = "PropertySrv.GetArrayProperty("BAC.100.MV1.StateText")
GetDescriptor
Retrieves the descriptor (object name) of a specified object.
Syntax
GetDescriptor( ObjectRef as String ) as String
Description
Call GetDescriptor to retrieve the object name of a specified
object.
Example
Set PropertySrv = Server.CreateObject("DeltaWebServe.PropertyAccess")
Name = PropertySrv.GetDescriptor("BAC.100.AI1")
GetDeviceModelName
Retrieves the model name of a specified device.
82
4 - Creating ORCAweb Graphics
Syntax
GetDescriptor( ObjectRef as String ) as String
Description
Call GetDeviceModelName to retrieve the model name of a
specified device.
Example
Set PropertySrv = Server.CreateObject("DeltaWebServe.PropertyAccess")
ModelName = PropertySrv.GetDeviceModelName("BAC.100.DEV100")
GetDeviceStatus
Retrieves the online status of a specified device.
Syntax
GetDeviceStatus( DeviceRef as String ) as String
Description
Call GetDeviceStatus to retrieve the online status of a
specified device. The function will return OK if the device is
online and communicating, otherwise the function will return
Error.
Example
Set PropertySrv = Server.CreateObject("DeltaWebServe.PropertyAccess")
Status = PropertySrv.GetDeviceStatus("BAC.100.DEV100")
GetProperty
Retrieves the value of a specific property.
Syntax
GetProperty( PropertyRef as String ) as String
Description
Call GetProperty to retrieve the value of a specific property.
The Property Reference should be in a form of
BAC.100.AI1.Value where:
83
BAC = Object System
100 = Device Number
AI1 = Object Instance
Value = Property
If the property is not specified, the default value property
will be used. When getting multiple properties, it is
recommended to call BatchProperty and BatchGet before
calling GetProperty. BatchGet will combine all requests and
use a more efficient way to retrieve the data from the
network.
Example
Using GetProperty
Set PropertySrv = Server.CreateObject("DeltaWebServe.PropertyAccess")
Value = PropertySrv.GetProperty("BAC.100.AI1.Value")
Units = PropertySrv.GetProperty("BAC.100.AI1.Units")
PropertySrv.BatchProperty("BAC.100.AI1.Value")
PropertySrv.BatchProperty("BAC.100.AI1.Units")
PropertySrv.BatchGet()
Value = PropertySrv.GetProperty("BAC.100.AI1.Value")
Units = PropertySrv.GetProperty("BAC.100.AI1.Units")
GetRangeByDate
Retrieves Trend Log data by specifying the starting date and
number samples.
Syntax
GetRangeByDate( ObjectRef as String, StartDate as Date,
Count as Long ) as Array
84
4 - Creating ORCAweb Graphics
Description
Call GetRangeByDate to retrieve an array of Trend Log data.
If Count is positive, the function returns data after the
Startdate. If Count is negative, the function returns data
ending at the StartDate.
The returned data will be in the following format with the
value followed by the sampling date and time.
2.00 2001/7/20 10:33:00
Example
Get last 200 samples
Set PropertySrv = Server.CreateObject("DeltaWebServe.PropertyAccess")
TrendData = PropertySrv.GetRangeByDate("BAC.100.TL1", Now, -200)
GetRangeByIndex
Retrieves Trend Log data by specifying the starting index and
number of samples.
Syntax
GetRangeByIndex( ObjectRef as String, StartIndex as Long,
Count as Long) as Array
Description
Call GetRangeByIndex to retrieve an array of Trend Log data.
The StartIndex starts from 1 up to the total number of
samples. If the Count is positive, the function will retrieve
samples following the StartIndex. If the Count is negative, the
function will retrieve samples ending at the StartIndex.
The returned data will be in the following format, with the
value followed by the sampling date and time.
2.00 2001/7/20 10:33:00
Example
Get first 200 samples
Set PropertySrv = Server.CreateObject("DeltaWebServe.PropertyAccess")
85
TrendData = PropertySrv.GetRangeByIndex("BAC.100.TL1", 1, 200)
GetV2Trend
Get the trend data from a Version 2 trend log object.
Syntax
GetV2Trend(ObjectRef as String) as Array
Description
Call GetV2Trend to retrieve all trend data from a trend log
object on a Version 2 device.
The output is an array of strings with each entry formatted as
follows: Date Time, Value, Value, Value, and Value.
Example
Display the trend data for TL1 on device 10.
Set PropertySrv = Server.CreateObject("DeltaWebServe.PropertyAccess")
TrendArray = PropertySrv.GetV2Trend("V2.10.TL1")
For Index = 0 to UBound(TrendArray)
Response.Write TrendArray(Index) & "<br>"
next
The output will be a list of trend data, one entry per line, like
the following:
2002/1/24 19:27:01, 86.0, 26.0, 0.0, 5.7
2002/1/24 19:27:06, 87.0, 26.0, 1.2, 5.7
PutArrayProperty
Writes the supplied data to the array property.
86
4 - Creating ORCAweb Graphics
Syntax
PutArrayProperty( PropertyRef as String, Arraydata as Array)
Description
Call PutArrayProperty to write an array of data to the
specified array property.
Users should use PutProperty when writing an individual
element in the array. Use square brackets to indicate the
array index. For example,
DeltaSrv.PutProperty(BAC.100.MV1.StateText[1],
Option1)
Array index in the object property starts from 1, whereas, array index in
VBScript starts from 0.
Example
Dim StateText
StateText = Array()
ReDim StateText(2)
StateText(0) = "Option1"
StateText(1) = "Option2"
StateText(2) = "Option3"
PutProperty
Writes the supplied data to the property.
Syntax
PutProperty( PropertyRef as String, Data as String )
87
Description
Call PutProperty to write data to a specified property.
Example
Set PropertySrv = Server.CreateObject("DeltaWebServe.PropertyAccess")
PropertySrv.PutProperty("BAC.100.AV1.Value", "3.0")
Examples
Getting a Value
Sample ASP page for getting a value.
<HTML>
<HEAD>
</HEAD>
<BODY>
<%
Dim PropertySrv, ObjRef, Value
<HEAD>
</HEAD>
<BODY>
88
4 - Creating ORCAweb Graphics
ObjRef = "BAC.100.AV1"
Value = PropertySvr.GetProperty(ObjRef & ".Value")
Units = PropertySvr.GetProperty(ObjRef & ".Units")
%>
</BODY>
</HTML>
89
<HEAD>
</HEAD>
<BODY>
<%
Dim PropertySrv, ObjRef, Value, Units
Set PropertySvr = Server.CreateObject("DeltaWebServe.PropertyAccess")
ObjRef = "BAC.100.AV1"
</BODY>
</HTML>
<HEAD>
</HEAD>
<BODY>
Current value of AV1 is: 95.6%
</BODY>
</HTML>
90
4 - Creating ORCAweb Graphics
Getting a Descriptor
Sample ASP page for getting a descriptor (object name).
<HTML>
<HEAD>
</HEAD>
<BODY>
<%
Dim PropertySrv, ObjRef, Name
ObjRef = "BAC.100.AV1"
Name = PropertySvr.GetDescriptor(ObjRef)
%>
Name of AV1 is: <%=Name %>
</BODY>
</HTML>
<HEAD>
</HEAD>
<BODY>
Name of AV1 is: TestAV
91
</BODY>
</HTML>
ObjRef = "BAC.100.MV1"
StateText = PropertySvr.GetArraypropety(ObjRef & ".StateText")
</BODY>
</HTML>
92
4 - Creating ORCAweb Graphics
<HEAD>
</HEAD>
<BODY>
<li>State1</li>
<li>State2</li>
<li>State3</li>
<li>State4</li>
</BODY>
</HTML>
Writing a Value
A sample ASP page for writing a value.
<HTML>
<HEAD>
</HEAD>
<BODY>
<%
Dim PropertySrv, ObjRef, StateText, Index
ObjRef = "BAC.8200.AV1"
Call PropertySvr.PutPropety(ObjRef & ".Value", "33.3")
93
Current value of AV1 is: <%=Value %>
</BODY>
</HTML>
<HEAD>
</HEAD>
<BODY>
Current value of AV1 is: 33.3
</BODY>
</HTML>
Dynamic Graphics
Objects and Functions
ORCAweb provides functionality for creating Dynamic
Graphics through a JavaScript LinkManager object. Elements
in the graphics are continuously updated according to the
real-time values that they are linked to. The LinkManager
supports text link, animation, and stepping images.
To use the LinkManager object, users have to include a file in
the web pages and make some minor changes to the code.
94
4 - Creating ORCAweb Graphics
Example
<HTML>
<HEAD>
<!--#include virtual="/deltaweb/Graphics/include/LinkManager.inc"-->
<script language="javascript">
//-----Options
DefaultDecimal =1;
EnableLinkToObject = false;
EnableContextMenu = true;
EnableTooltip = true; // Only effective when ContextMenu is disabled.
function InitLinks() {
LinkManager.AddLink("AVValue","BAC.400.AV1");
}
</script>
</HEAD>
<BODY onload=Init() onunload=Exit()>
<a id=AVValue"> . . .</a>
</BODY>
</HTML>
Summary
LinkManager.inc contains all the support for creating the
dynamic graphics.
Script function InitLinks to create all data links.
Under the <BODY> tag, add onload=Init() onunload=Exit()
to ensure proper initialization and cleanup.
Assign a unique Id to each HTML element that requires
Dynamic data. For example, id=AVValue.
95
Default Settings Defined
DefaultDecimal: Default decimal places for analog value in
graphics.
EnableLinkToObject: Turn the linked values in the
graphics into hyper links that open the object.
EnableContextMenu: Enable context menu when hovering
mouse over linked values.
EnableTooltip: Enable the tooltip to popup showing the
name of the linked object. (The tooltip is only enabled when
the context menu is disabled.)
Context Menu
A context menu displays when you hover over a linked
element. Depending on the linked objects type, the menu
may allow users to open the object, command it to Auto,
Manual Value, Manual On and Manual Off.
Syntax
CreateImageArray(filename, filename, . . .)
Description
Call CreateImageArray to create an array of image files that
can be used for setting up animation or stepping image links.
Example
:
<script>
var TopFanImage=CreateImageArray( image/fan1.gif, images/fan2.gif,
images/fan3.gif, images/fan4.gif);
96
4 - Creating ORCAweb Graphics
Syntax
LinkManager.AddLink(Element, ObjRef, Property, Type,
Decimal)
Description
Call LinkManager.AddLink to add a data link to the graphics.
This function will establish a data link between the HTML
elements and the device object.
Depending on the link type, the graphics will get the real-time
value and change the text or other attribute of the element.
Element - Id of the HTML element to be linked. User
assigns the Id. Apply to all element types that allow specifying
Ids, for example, <a>, <span>, <p>, <div>, <td>, <img>, etc.
ObjRef - Object reference to retrieve value from.
Property - (Optional) Property of the object. If not specified,
the value property will be used by default.
Type - (Optional) Data link types:
WithUnits - Resulting text will be a value followed by units.
Binary - Resulting text will show the Active and Inactive Text
depending on the present value of the binary object.
DirectVisibility - Shows the element if the specified object
property value is true/active, otherwise hide the element.
ReverseVisibility - Hide the element if the specified object
property value is true/active, otherwise show the element.
Decimal - (Optional) Decimal places for the link. Applicable
for numeric value only. This value overrides the global
DecimalPlace graphic option. If Property and Type are not
specified, WithUnits will be used for analog objects, and
Binary will be used for binary objects.
97
Example
:
<script>
function InitLinks() {
LinkManager.AddLink(AVValue, BAC.400.AV1);
}
</script>
</HEAD>
<BODY onload=Init() onunload=Exit()>
AV Value = <span id=AVValue> . . .</span>
:
Syntax
LinkManager.AddAnimation(Element, ObjRef, Property,
ImageArray, ImageStop, FramePeriod, Direct)
Description
Call LinkManager.AddAnimation to add an animation link to
the graphics. This function will establish an animation link
between an image element <img> and the device object. If
the object value is ON, the image will be animated using the
supplied Image Array. If the object value is OFF, the
animation will stop and the Image Stop will be shown.
Element - Id of the <img> element to be linked.
The user assigns the Id.
ObjRef - Object reference to retrieve value from.
Property - (Optional) Property of the object. If not
specified, the value property will be used by default.
98
4 - Creating ORCAweb Graphics
Example
:
var TopFanImage = CreateImageArray
("images/fanimage1.jpg","images/fanimage2.jpg,...)
function InitLinks() {
LinkManager.AddAnimation("FanImage", BIReference, null, TopFanImage,
"image/fanoff.gif");
}
</script>
</HEAD>
<BODY onload=Init() onunload=Exit()>
<img id=FanImage>
:
Syntax
LinkManager.AddSteppingImage(Element, ObjRef, Property,
ImageArray, LowerBound, UpperBound)
99
Description
Call LinkManager.AddSteppingImage to add a stepping image
to a graphics. This function will establish a stepping image link
between an image element <img> and the device object.
Stepping Image links work for analog objects or numeric
properties. Depending on the current value, the
corresponding image will be shown in the graphics. It could
be used to show damper position, color-coded temperature,
water level, etc.
Element - Id of the <img> element to be linked.
User assigns the Id.
ObjRef - Object reference to retrieve value from.
Property - (Optional) Property of the object. If not
specified, the value property will be used by default.
ImageArray - Array of image file names. Created
by CreateImageArray.
LowerBound - (Optional) Lower bound of the
value range. The default is 0 if not specified.
UpperBound - (Optional) Upper bound of the
value range. The default is 100 if not specified.
The first and last image will be used when the object value is at the
LowerBound and UpperBound, respectively. Other images will be
distributed evenly in the value range.
Example
:
var AOReference = BAC.400.AO1
var DamperImage=CreateImageArray(images/topdamper6.jpg,
images/topdamper4.jpg, images/topdamper3.jpg, images/topdamper2.jpg,
images/topdamper2.jpg, images/topdamper.jpg);
function InitLinks() {
100
4 - Creating ORCAweb Graphics
Creating Hyperlinks
LinkManager.SetAnchor
Creates an anchor (hyperlink) to the linked elements.
Syntax
LinkManager.SetAnchor()
Description
Call LinkManager.SetAnchor to create a hyperlink the linked
elements. When the user clicks on the hyperlink, the browser
will jump to the object page where the user can modify the
settings.
LinkManager.SetAnchor should be called after all links have
been added. Usually call it at the end of InitLinks().
To create the hyperlink, the linked elements must be
anchored elements with the <a> tag. Other tags such as
<div>, <span>, etc. will not be affected.
This function is obsolete. The user can use the Graphics option
EnableLinkToObject to achieve the same behavior.
Example
:
function InitLinks() {
101
LinkManager.AddLink(AVValue, BAC.100.AV1);
LinkManager.SetAnchor();
}
</script>
</HEAD>
<BODY onload=Init() onunload=Exit()>
Value = <a id=AVValue></a>
</BODY>
:
Syntax
LinkManager.SetAnchorToObject(Element, ObjRef,
EnableHyperLink, EnableMenu)
Description
Call LinkManager.SetAnchorObject to create a hyperlink to
the specified device object. When the user clicks on the
hyperlink, the browser will jump to the object page where
the user can modify the settings.
Element - Id of the HTML element to be linked. The
user assigns the Id. Apply to all element types that
allow specifying the color. E.g. <div>, <img>, <a>
etc.
ObjRef - Object reference to link to.
EnableHyperLink - (Optional) set up a hyperlink to
the specified object. Default is true.
EnableMenu - (Optional) set up the context menu.
Default is false.
102
4 - Creating ORCAweb Graphics
Example
:
function InitLinks() {
LinkManager.AddLink("AVValue", "BAC.100.AV1");
LinkManager.SetAnchorToObject("fan", "BAC.100.BO1");
}
</script>
</HEAD>
<BODY onload=Init() onunload=Exit()>Value = <a id=AVValue></a>
<img id="fan" src="fan.jpg">
</BODY>
:
Syntax
LinkManager.AddDigitalColorLink(Element, ObjRef, Property,
OnColor, OffColor, Attribute)
Description
Call LinkManager.AddDigitalColorLink to add a digital color
link to the graphics. This function will establish a digital color
link between the HTML element and the device object. If the
object value is ON, the OnColor will be applied to the HTML
103
element. If the object value is OFF, the OffColor will be
applied to the element.
Element - Id of the HTML element to be linked.
User assigns the Id. Apply to all element types that
allow specifying the color. E.g. <a>, <p>, <div>,
<span>, etc.
ObjRef - Object reference to retrieve value from.
Property - Property of the object. If not specified,
the value property will be used by default.
OnColor - Color to be used when the object value
is ON.
OffColor - Color to be used when the object value
is OFF.
Attribute - (Optional) The attribute to apply the
color to. Either "color" or "backgroundColor". The
default value is "color".
Color could be specified in named terms e.g. red, green or
RGB value in hex format e.g. #ff000 or #00ff00
Example
:
<script>
function InitLinks() {
LinkManager.AddDigitalColorLink("FanValue", "BAC.400.BV1", "Auto", "green", "red");
LinkManager.AddLink("FanValue", "BAC.400.BV1");
}
}
</script>
</HEAD>
<BODY onload=Init() onunload=Exit()>
104
4 - Creating ORCAweb Graphics
Description
If users add a text element ( <div> or <span> ) in the
graphics and give the Id StatusText, the LinkManager object
will update its text to show the current status of the graphics.
If there is no StatusText element in the graphics, the status
will appear in the status bar of the browser.
If the graphics are getting their real-time data successfully, the
status text will show the last update time. If the graphics
failed to retrieve the read-time data from the server, the
status text will show an error.
Example
<HTML>
<HEAD>
<!--#include File=../include/LinkManager.inc-->
</HEAD>
<BODY onload=Init() onunload=Exit()>
Value = <a id= AAValue></a>
105
Function List Examples
Text Link
<script>
var AVReference = BAC.400.AV1;
var BOReference = BAC.400.BO1;
function InitLinks() {
LinkManager.AddLink(AVName, AVReference);
LInkManager.AddLink(BOValueLink, BOReference);
}
</script>
</HEAD>
<BODY onload=Init() onunload=Exit()>
106
4 - Creating ORCAweb Graphics
<script>
var AVReference = BAC.400.AV1;
var BOReference = BAC.400.BO1;
function InitLinks() {
LinkManager.AddLink(AVValue, AVReference, Name);
LinkManager.AddLink(BOValue, BOReference);
LinkManager.SetAnchor();
}
</script>
</HEAD>
<BODY onload=Init() onunload=Exit()>
</BODY>
</HTML>
107
Table
Sample graphics uses a table to show the status of multiple
pieces of equipment.
<HTML>
<HEAD>
<!--#include File=../include/LinkManager.inc-->
<script>
function InitLinks() {
LinkManager.AddLink(SATValue1, BAC.400.AI3);
LinkManager.AddLink(SATValue2, BAC.400.AI9);
LinkManager.AddLink(MATValue1, BAC.400.AI4);
LinkManager.AddLink(MATValue2, BAC.400.AI10);
LinkManager.AddLink(SFValue1, BAC.400.BO1);
LinkManager.AddLink(SFValue2, BAC.400.BO2);
LinkManager.SetAnchor();
}
</script>
</HEAD>
<BODY onload=Init() onunload=Exit()>
108
4 - Creating ORCAweb Graphics
<td>AHU1</td>
<td>AHU2</td></tr>
<tr>
<td>AHU Supply Air Temp</td>
<td id=SATValue1></td>
<td id=SATValue2></td></tr>
<tr>
<td>AHU Mixed Air Temp</td>
<td id=MATValue1></td>
<td id=MATValue2></td></tr>
<tr>
<td>AHU Supply Fan Status</td>
<td id=SFValue1></td>
<td id=SFValue2></td></tr></table>
</BODY>
</HTML>
Visibility
This sample graphic toggles the visibility of an image
depending on the value of a binary input.
<HTML>
<HEAD>
<!--#include File=../include/LinkManager.inc-->
<script>
var BIReference = BAC.400.BI7;
109
function InitLinks() {
LinkManager.AddLink(BIText, BIReference);
LInkManager.AddLink(BIImage, BIReference, null, DirectVisibility);
}
</script>
</HEAD>
<BODY onload=Init() onunload=Exit()>
BO Value = <span id=BIText>...</span>
<img id= BIImage src=Images/Alarm.gif>
</BODY>
</HTML>
Animation
These sample graphics show animation. The fan will rotate if
the binary output is active, otherwise, the fan will stop.
<HTML>
<HEAD>
<!--#include File=../include/LinkManager.inc-->
<script>
var BIReference = BAC.400.BI1;
function InitLinks() {
LinkManager.AddLink(FanText, BIReference);
110
4 - Creating ORCAweb Graphics
Stepping Image
This sample graphic shows the use of a stepping image. The
damper position will change depending on the analog output
value.
<HTML>
<HEAD>
<!--#include File=../include/LinkManager.inc-->
<script language=javascript1.2>
var AOReference = BAC.400.AO1;
111
function InitLinks() {
LinkManager.AddLink(DamperText, AOReference);
LinkManager.AddSteppingImage(DamperImage, AOReference, null,
DamperImage);
LinkManager.SetAnchor();
}
</script>
</HEAD>
112
4 - Creating ORCAweb Graphics
The user can create sub folders and graphics files in the
graphics folder that will show up in the ORCAweb Navigator
automatically.
Folder Location
By default the Graphics Folder is located on the server in:
C:\Inetpub\wwwroot\DeltaWeb\Graphics
File Types
To prevent any image file or other unwanted files from
showing up in the tree, only files with the following
extensions are listed:
.html, .asp, .htm, .aspx
Hidden Folder
Users can prevent a folder from appearing in the tree by
changing the folders status to hidden using Windows
Explorer.
113