Adding logic and control                  Chapter 24 
Rockwell Automation Publication VIEWSE-UM006K-EN-E 
641 
Each HMI server in a network distributed application can run up to 20 event 
components, with up to 1,000 tags in each component. 
Note: Do not create events that depend on other events. Events are 
not processed sequentially. 
Modifying existing event components 
You can modify events during development, or when you run the application. 
If you change an event component at run time, the changes will not take 
effect until you stop and then restart events processing. 
Starting and stopping events processing 
There are many ways to start and stop events processing. Choose the way 
that works best for the application. 
To provide an operator with a way start and stop events processing, use 
FactoryTalk View commands and macros in conjunction with graphic 
objects. For details about FactoryTalk View command syntax, see the 
FactoryTalk View Site Edition Help. 
In the following methods, <component> represents the name of an events 
file. 
Ways to start events processing 
To start events processing, use any of these methods: 
In the HMI Server Properties dialog box, click the Components tab, 
select the Events check box, and then select an event component. 
The event component will start the next time the HMI server runs, or 
when the HMI server’s components are started manually.
In the Macros editor, create a macro that contains the command, 
EventOn <component>. In the HMI Server Properties dialog box, 
click the Components tab, select the Macro check box, and then 
specify the macro. 
Event detection will start when the HMI server runs. 
In the Graphics editor, create a button object and then specify the 
EventOn <component> 
command as the button’s press action. When 
the button is pressed, event detection starts. 
Add hyperlinks pdf file - insert, remove PDF links in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Free C# example code is offered for users to edit PDF document hyperlink (url), like inserting and deleting
add hyperlinks to pdf; pdf link open in new window
Add hyperlinks pdf file - VB.NET PDF url edit library: insert, remove PDF links in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Help to Insert a Hyperlink to Specified PDF Document Page
add links to pdf acrobat; add links to pdf online
Chapter 24                  Adding logic and control 
642 
Rockwell Automation Publication VIEWSE-UM006K-EN-E 
In the Graphics editor, create a graphic object and attach touch 
animation to it, using EventOn <component> in the Action box. When 
the object is touched, event detection starts. 
At the command line in FactoryTalk View Studio, or in the 
FactoryTalk View SE Administration Console, type EventOn 
<component>, and then press Enter
For the Login Macro in the FactoryTalk View SE User Accounts 
editor, specify the EventOn <component> command, or a macro that 
contains the command. 
For the Startup command in the Display Settings Behavior tab, 
specify the EventOn <component> command, or a macro that contains 
the command. 
Ways to stop events processing 
To stop a single event component, use any of these methods: 
In the Macros editor, create a macro that contains the command, 
EventOff <component>. In the HMI Server Properties dialog box, 
click the Components tab, select the check box, On shutdown macro, 
and then specify the macro. 
Events processing will stop when the HMI server shuts down. 
In the Graphics editor, create a button object and then specify the 
EventOff <component> 
command as the button’s press action. When 
the button is pressed, event detection stops. 
In the Graphics editor, create a graphic object and attach touch 
animation to it, using EventOff <component> in the Action box. When 
the object is touched, event detection stops. 
At the command line in FactoryTalk View Studio, or the FactoryTalk 
View SE Administration Console, type EventOff <component>, and 
then press Enter. 
For the Logout Macro in the FactoryTalk View SE User Accounts 
editor, specify the EventOff <component> command, or a macro that 
contains the command. 
For the Shutdown command in the Display Settings Behavior tab, 
specify the EventOff <component> command, or a macro that contains 
the command. 
You can also stop events processing by stopping all HMI server components 
running on the computer. For details, see To stop HMI server components 
manually on page 160
A macro is a series of FactoryTalk View SE commands stored in a macro 
component. 
Creating and using 
macros 
C# PDF Convert to HTML SDK: Convert PDF to html files in C#.net
Export PDF images to HTML images. Embed PDF hyperlinks to HTML links. Add necessary references: RasterEdge.Imaging.Basic.dll. using RasterEdge.XDoc.PDF;
add a link to a pdf in preview; add links to pdf file
VB.NET PDF Convert to HTML SDK: Convert PDF to html files in vb.
Embed PDF hyperlinks to HTML links in VB.NET. Add necessary references: This professional .NET solution that is designed to convert PDF file to HTML web page
add a link to a pdf; add url to pdf
Adding logic and control                  Chapter 24 
Rockwell Automation Publication VIEWSE-UM006K-EN-E 
643 
You can use a macro component anywhere a command can be used. When 
the component name is issued, the macro runs, carrying out all the 
commands in the component. 
You can create macros to perform almost any action or series of actions. For 
example, use a macro to:    
Open a group of graphic displays, and define their initial positions. 
Define temporary key definitions. 
Close any open graphic displays. 
Set tag values. 
To create a new macro: 
In FactoryTalk View Studio, open the Logic and Control folder, 
right-click the Macros icon, and then select New
To open the Command Wizard, double-click anywhere in the Macros 
editor. 
Macro syntax 
When typing commands in macros, follow these guidelines: 
Separate each identifier, specification, or string with a space or a tab. 
Start each command on a new line, or separate commands on the same 
line with a semicolon ( ; ). 
To insert a comment, type an exclamation mark ( ! ) at the beginning of 
a new line or immediately after a semicolon ( ; ). Everything between 
the exclamation mark and the end of the line, or the next semicolon, is 
treated as a comment. 
To replace a tag name with its current value when a command is 
evaluated, enclose the tag name in dollar signs ( $ ) to create a tag 
placeholder in the command. 
When a macro containing $tag $ run, the current tag value is substituted 
for the tag placeholder, before commands in the macro are issued. 
To indicate percent in a macro, use two percent signs ( % % ). One 
percent sign indicates a parameter in the macro. For details, see 
Specifying parameters in a macro on page 644
VB.NET PDF Page Replace Library: replace PDF pages in C#.net, ASP.
all PDF page contents in VB.NET, including text, image, hyperlinks, etc. Add necessary references to replace a PDF page with PDF page from other PDF file using VB
add links to pdf document; clickable pdf links
VB.NET PDF Thumbnail Create SDK: Draw thumbnail images for PDF in
PDF document is an easy work and gives quick access to PDF page and file, or even hyperlinks. How to VB.NET: Create Thumbnail for PDF. Add necessary references:
pdf link to specific page; add link to pdf file
Chapter 24                  Adding logic and control 
644 
Rockwell Automation Publication VIEWSE-UM006K-EN-E 
Note: 
Do not use dollar signs or percent signs in comments inserted 
in macros. This causes errors at run time. 
Example 1: A macro called Factory 
A macro called Factory contains the following commands: 
Display /Ingredients::Overview
Display /Ingredients::Detail
/Ingredients::Valve23 = Open
When the macro runs, the graphic display called Overview opens, then the 
display called Detail opens, and then the tag Valve23 is set to its open state. 
The displays and the tag all are located in the area called Ingredients. 
Example 2: A macro using placeholders in commands 
The first two entries in this macro are Display commands that use 
placeholders: 
Display /$Tag1$::Process1
Display /$Tag1$::TrendDisplay$Tag2$
Valve23 = Open
When the macro runs, FactoryTalk View replaces the placeholders ($Tag1$, 
$Tag2$) with the current values of the specified tags. 
For example, if Tag1 (a string tag) = Mixing, and Tag2 (an analog tag) = 2, 
then the graphic display Process1 from the Mixing area opens, followed by 
the display TrendDisplay2, also from the Mixing area. 
Finally, the tag Valve23 from the home area is set to its open state. In this 
example, the home area is also the area, in which the macro is run. 
You don’t need to put brackets around tag names when using placeholders in 
commands. 
Specifying parameters in a macro 
Macros can accept up to nine parameters. To specify a parameter in a macro, 
type a percent ( % ) sign followed by a number. 
To run the macro and parameters, specify the macro name followed by the 
parameters. Separate multiple parameters with spaces. 
Example 3: Factory macro with two parameters 
Re-create the Factory macro described in Example 1, as follows: 
PDF Image Viewer| What is PDF
with advanced capabilities, such as text extraction, hyperlinks, bookmarks and NET Imaging SDK, you may add it on you to quickly convert your PDF images into
adding links to pdf in preview; adding links to pdf document
.NET PDF SDK | Read & Processing PDF files
by this .NET Imaging PDF Reader Add-on. Include extraction of text, hyperlinks, bookmarks and metadata; Annotate and redact in PDF documents; Fully support all
pdf edit hyperlink; pdf hyperlink
Adding logic and control                  Chapter 24 
Rockwell Automation Publication VIEWSE-UM006K-EN-E 
645 
Display Overview
Display %1
Valve23 = %2
To run the macro, type the macro name with the parameters to substitute for 
the placeholders %1 and %2: 
Factory Detail Open
When the macro runs, it substitutes Detail wherever %1 occurs in the macro, 
and substitutes Open wherever %2 occurs in the macro. 
The actions performed are the same as in Example 1. However, in this 
example the macro runs in the home area instead of the Ingredients area. 
Typing macro names that contain spaces 
If the name of a macro contains spaces, enclose the name in quotation marks 
when typing the macro name. If the macro contains parameters, place the 
parameters outside the quotation marks. 
Example 4: Macro name with spaces and parameters 
The name of the macro in Example 3 is Factory Display, instead of Factory. 
To run the macro, type the following at the command line: 
"Factory Display" Detail Open
Nesting macros 
You can insert a macro within another macro 
this is called nesting. A 
macro can have up to eight nesting levels. 
Tip: 
The single quotation mark (‘) is a special character in 
FactoryTalk View and cannot be used in nested macros. 
Instead, use the double quotation mark ("). 
Example 5: Nesting macros 
A macro called Draw contains: 
Display Overview
Display Detail
and a macro called Factory contains: 
Draw
Valve23 = Open
Chapter 24                  Adding logic and control 
646 
Rockwell Automation Publication VIEWSE-UM006K-EN-E 
With the Draw macro nested in the Factory macro, running the Factory 
macro performs the same actions as in Example 3. 
Running macros 
At run time, an operator can run a macro anywhere they can run a 
FactoryTalk View command. Ensure you include a way for the operator to 
run commands or macros, for example, by specifying them as press actions 
for buttons. 
For more information about running macros, see Help. 
Running a macro when an HMI server starts 
If you have created an HMI server with components that must start in a 
particular order, create a Startup macro. To make this macro run when the 
HMI server starts, select it as the startup macro in the Components tab of the 
HMI Server Properties dialog box. 
For details about specifying the startup macro: 
In a network distributed application, see Selecting startup and 
shutdown components on page 142
In a local station application, see Selecting startup and shutdown 
components on page 174
Specifying user login and logout macros 
You can assign login and logout macros to any user or group of users listed 
in the Runtime Security editor, in FactoryTalk View Studio. Any macro 
component, containing any FactoryTalk View command, can be a login or 
logout macro. 
For example, a login macro might contain a command to bring up a specific 
graphic display in an area of the plant. A logout macro might contain 
commands to redefine sensitive keys. 
A user’s login macro runs when the user logs on to the FactoryTalk View 
SE Client. 
If the client is already running when the user logs on, the current user is 
logged off. If the current user is assigned a logout macro, the logout macro 
runs once the new user’s name and password are accepted.
In a network distributed application, a login or logout macro will only run in 
the area where it’s located.
Adding logic and control                  Chapter 24 
Rockwell Automation Publication VIEWSE-UM006K-EN-E 
647 
For example, if you specify a login macro located in the Bottling area, when 
the user logs on to the a FactoryTalk View SE Client, the macro will run only 
if the Bottling 
area is the client’s home area.
Tip: 
You specify the client’s home area when you select 
components for the client configuration file. For more 
information, click Help in the FactoryTalk View SE Client 
wizard. 
For more information about logging on and off at run time, and about 
assigning login and logout macros to users, see Setting up security on page 
85
A client key is associated with commands or macros that run when the key is 
pressed. 
Client keys are similar to object keys and display keys, except client keys are 
not dependent on a particular graphic object or display. Client keys are 
associated with the FactoryTalk View SE Client, and are active at all times. 
Use client keys to let operators perform actions without having to open a 
particular graphic display. For example, you might create a client key that 
recalls an overview menu, to let operators open the menu regardless of where 
they are in the application. 
To create a client key, you create a client key component in the Client Keys 
editor. A single component can contain more than one client key definition. 
Creating client keys 
Chapter 24                  Adding logic and control 
648 
Rockwell Automation Publication VIEWSE-UM006K-EN-E 
To open the Client Keys editor: 
In FactoryTalk View Studio, in the Explorer window, open the Logic and 
Control folder, right-click Client Keys, and then select New
For details about the options in the editor, click the Help button. 
Running client key components 
To run a client key component, use one of these methods: 
Use the FactoryTalk View Key command in a macro or anywhere else 
you can use FactoryTalk View commands. For details, see the 
FactoryTalk View Site Edition Help. 
Run the client key component when the FactoryTalk View SE Client 
runs. For details, see Help for the FactoryTalk View SE Client Wizard. 
Tip: 
You cannot run more than one client key component at a 
time. If you try to do this, the components are not 
merged; instead, the second component overrides the 
first component. 
Rockwell Automation Publication VIEWSE-UM006K-EN-E 
649 
Chapter 25 
FactoryTalk View commands 
This appendix describes: 
Where and how to use FactoryTalk View commands. 
Using absolute and relative references. 
Creating symbols. 
Using the Command Wizard
For details about specific FactoryTalk View commands, see the FactoryTalk 
View Site Edition Help. 
In a FactoryTalk View SE application, you can use commands in: 
Boxes that require you to enter an action. 
For example, use a command as the press, release, or repeat action 
when you attach touch animation to an object in a graphic display, or 
as the action for a button. 
Macros or symbols. 
The command line. 
Commands take precedence over macros. For example, if you have a macro 
called Display, the Display command will run whenever you try to run the 
Display macro. 
How to use commands 
When typing commands, or building them using the Command Wizard, 
keep the following guidelines in mind: 
In the descriptions of commands in the Help, parameters enclosed in 
angle brackets < > are required and parameters enclosed in square 
brackets [ ] are optional. 
Parameters do not have to be entered in the order they are listed in 
Help. 
Commands and parameters are not case sensitive. 
Using commands in 
a FactoryTalk View 
SE application 
Chapter 25                  FactoryTalk View commands 
650 
Rockwell Automation Publication VIEWSE-UM006K-EN-E 
To use several commands in sequence, start each new command on a 
new line, or separate commands on the same line with a semicolon ( ; ). 
Separate multiple parameters with a space. 
Enclose long file names containing spaces with double quotes when the 
file names are used as parameters. For example: 
Display PID /P"Temperature Loop 1"
Enclose area and component names that contain spaces, or are 
ambiguous, in double quotes. 
An ambiguous area name is one that is the same as another parameter 
for a command. For example, AlarmOn "/H" would turn alarm 
monitoring on in area H; whereas AlarmOn /H would turn alarm 
monitoring on with handshaking, in the current area. 
An exclamation mark ( ! ) at the beginning of a new line or 
immediately after a semicolon ( ; ) indicates the start of a comment. 
Everything between the exclamation mark and the end of the line, or 
the next semicolon, is treated as a comment. 
If a command accepts wildcard characters, this is noted in the 
description of the command in the Help. The wildcard characters are: 
* matches any number of characters, including the 
backslash ( \ ) and period ( . )
? matches any single character
Using tag placeholders in commands 
To replace a tag name with its current value when a command is evaluated, 
enclose the tag name in dollar signs ( $ ). This creates a tag placeholder in the 
command. 
When using tag placeholders in commands, keep these points in mind: 
Floating point tags can be a maximum of 17 digits long. If the value is 
longer than 17 digits, it is represented in scientific format. 
The maximum command length is 5000 characters. If tag values 
substituted for placeholders in a command cause the command to 
exceed this length, then the command will be truncated. 
Example 1: A macro using tag placeholders in commands 
Display Screen$Tag1$
Display $Tag3$$Tag2$
Valve23 = Open
Documents you may be interested
Documents you may be interested