Table of Contents
Advertisement
"https://" in the URL address.
• Link Path: The link path is how to get to the node
of the tree you want to go to from where you are
now. If the Link Path field is blank, it is assumed
that the screen will be loaded at the same Tree node
where the current screen has been loaded. This can
be done by entering a "relative" path (preferred) or
an "absolute" path. Using the graphic in Figure 9-26
as an example, the fields would be populated with
the "relative" path information below when linking
the push-button widget to the AHU GS Screen:
Links: AHU
Link Path: CPC Bldg/CPC E2 Bldg/BX-400 1:
Suite 101/Air Handlers (AHUs)/RTU1 - OFFICES
NOTE: If a forward slash appears as part of
the name of the link path, it must be enclosed
inside quotation marks. For example, if the
path is BX-400 1: Suite/101, the unit name
would be: "BX-400 1: Suite/101" and quotation marks
would be needed around the text that contains the for-
ward slash.
9.4.1.10.Widget Screen Linking
Unique parameters that can be specified as the
Link on any widget:
• ${home} when this link is clicked on the widget, it
causes you to leave the current screen and go to the
GS screen home page (if defined). If no home page
is defined, or if you are already on the home pages,
a pop-up error message will appear.
• ${back} when this link is clicked on the widget, it
causes you to leave the current screen and go back a
page (just like the browser back button).
• ${forward} when this link is clicked on the widget,
it causes you to leave the current screen and go for-
ward a page (just like the browser forward button).
• ${graph} when this link is clicked on the widget, the
associated points will be graphed that opens in a sep-
arate window. If no points have been associated, an
"Invalid Reference" message will appear.
•${graph,N...} will graph a different point (where
N is a reference number for a valid reference in
the widget). For example, ${graph,1} will
graph the point specified by reference 1. You
can include multiple references in the graph by
separating them with commas; for example,
${graph,0,1,2} will graph the points specified
by references 0, 1, and 2 on the popup graph.
•${graph}ScreenName optionally, you may fol-
low the ${graph} link with the name of a
Widgets and Creating GS Screens
screen to show as part of the graph. For exam-
ple, ${graph,1,2}GraphSubScreen would
pop up the log graph for the points specified by
references 1 and 2, and also load the GS Screen
named GraphSubScreen as part of the popup
graph. The GS screen used in the popup graph
must be specially designed for this purpose.
• ${tree} applied by default to the screen link path
when a GS screen is created, this link parameter
causes the navigation tree to synchronize automati-
cally to the location where the GS screen is loaded.
By simply clicking on the widget, you can see exact-
ly where in the tree the GS screen is loaded.
• ${0.siteID} this is the ID of the site this point is in.
• ${0.controlsystemID} this is the ID of the control
system this point is in.
• ${0.unitID} this is the ID of the unit this point is in.
• ${businessAction}businessActionName creates a
link from the current GS Screen to a business action
UI screen (where businessActionName is the exact
business action name that is defined in the business-
ActionDescriptor.xml file). By clicking the widget,
the page will load the business action screen.
Please note that if any of these options are used,
they should be used exclusively in the link (without
any other replaceable parameters) and are not valid in
any other place where replaceable parameters can be
used and are only valid on a widget screen link.
NOTE: Link and Link Path support replace-
able parameters so that a screen name or link
path for that screen may be computed by using
any of the reference information, although
style information such as color will not be shown.
• Point Reference: To link a widget with a point, use
the Navigation Tree checkboxes to select the point.
NOTE: The recommended way to associate
points with a widget is to first select the point
you wish to associate, then add any text.
Graphical Status Screens/Floor Plans • 97
Advertisement
Table of Contents
