Ha260749u005 7
Ha260749u005 7
Ha260749u005 7
User Guide
HA260749U005
The manufacturer pursues a policy of continuous development and product improvement. The specifications
in this document may therefore be changed without notice. The information in this document is given in good
faith, but is intended for guidance only. The manufacturer will not accept responsibility for any losses arising
from errors in this document.
USER SCREEN EDITOR HELP MANUAL
Table of Contents
1 USER SCREEN EDITOR ................................................................................................................................................................. 15
1.1 RELATED DOCUMENTS .................................................................................................................................................. 15
1.1.1 LINtools Online Help................................................................................................................................................. 15
1.1.2 LIN Blocks Reference Manual ................................................................................................................................. 15
1.1.3 Application And Control Modules Operator Manual ....................................................................................... 15
1.2 USER SCREEN EDITOR - OVERVIEW ........................................................................................................................... 16
1.2.1 Page Sets, Pages, and Targets ................................................................................................................................. 16
1.2.2 Panes ............................................................................................................................................................................. 16
1.2.3 Page Items.................................................................................................................................................................... 17
1.2.4 Page Item Properties dialogue ............................................................................................................................... 17
2 GETTING STARTED ....................................................................................................................................................................... 18
2.1 DESIGNING A USER SCREEN ......................................................................................................................................... 18
2.2 OPEN THE USER SCREEN EDITOR ............................................................................................................................... 18
2.2.1 To open the User Screen Editor: ........................................................................................................................... 18
2.3 USE THE USER SCREEN EDITOR ................................................................................................................................... 19
2.3.1 To use the User Screen Editor: ............................................................................................................................... 19
3 MAIN DISPLAY REGIONS ............................................................................................................................................................ 20
3.1 MAIN DISPLAY ................................................................................................................................................................. 20
3.1.1 Page set ........................................................................................................................................................................ 20
3.1.2 Pages and Panes ......................................................................................................................................................... 21
3.1.3 Page items.................................................................................................................................................................... 23
3.1.4 To Define customised colours ................................................................................................................................ 24
3.2 REPORT WINDOW ........................................................................................................................................................... 25
3.3 LIN DATABASE BROWSER ............................................................................................................................................. 26
3.3.1 Associating a LIN Database with the Page Set ................................................................................................... 26
3.3.2 Instrument browser ................................................................................................................................................... 27
4 TARGET DEFINITION .................................................................................................................................................................... 28
4.1 HOW TO CREATE A TARGET SCREEN TYPE .............................................................................................................. 28
4.2 HOW TO EDIT THE TARGET SCREEN TYPE................................................................................................................ 29
5 MENUS ............................................................................................................................................................................................ 30
5.1 FILE MENU ........................................................................................................................................................................ 30
5.2 EDIT MENU ....................................................................................................................................................................... 32
5.3 VIEW MENU ...................................................................................................................................................................... 34
5.4 PAGESET MENU ............................................................................................................................................................... 35
5.5 PAGE MENU ...................................................................................................................................................................... 35
5.6 WINDOW MENU .............................................................................................................................................................. 36
5.7 HELP MENU....................................................................................................................................................................... 36
HA260749U005 Page 3
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
6 TOOLBARS...................................................................................................................................................................................... 37
6.1 MAIN TOOLBAR............................................................................................................................................................... 37
6.1.1 New Page Set command .......................................................................................................................................... 37
6.1.2 Open Page Set command ........................................................................................................................................ 37
6.1.3 Save Page Set command .......................................................................................................................................... 37
6.1.4 New Page command ................................................................................................................................................. 37
6.1.5 Open Page command ............................................................................................................................................... 38
6.1.6 Close Page command ............................................................................................................................................... 38
6.1.7 Build Output (OIFL) Files command ..................................................................................................................... 38
6.1.8 Verify Page Set command ....................................................................................................................................... 38
6.1.9 Find command ............................................................................................................................................................ 38
6.1.10 Open Database command ....................................................................................................................................... 38
6.1.11 Back Command .......................................................................................................................................................... 38
6.1.12 Cut command ............................................................................................................................................................. 38
6.1.13 Copy command .......................................................................................................................................................... 38
6.1.14 Paste command .......................................................................................................................................................... 38
6.1.15 Undo command ......................................................................................................................................................... 39
6.1.16 Redo command .......................................................................................................................................................... 39
6.1.17 Zoom Factor command............................................................................................................................................ 39
6.1.18 Whats This? command ............................................................................................................................................. 39
6.2 STATUS BAR ..................................................................................................................................................................... 39
6.3 TEXT BAR ........................................................................................................................................................................... 40
6.3.1 Font style command ................................................................................................................................................. 40
6.3.2 Align Text Left command ........................................................................................................................................ 40
6.3.3 Align Text Left-biased Centre command ............................................................................................................. 40
6.3.4 Align Text Right-biased Centre command .......................................................................................................... 40
6.3.5 Align Text Right command ...................................................................................................................................... 40
6.4 PLACEMENT BAR ............................................................................................................................................................. 41
6.4.1 Grid settings dialogue ............................................................................................................................................... 42
6.5 DRAW BAR ........................................................................................................................................................................ 43
7 HOW TO... ...................................................................................................................................................................................... 45
7.1 SPECIFY/CONFIGURE A TARGET SCREEN TYPE ........................................................................................................ 45
7.2 SPECIFY CHARACTER MAPPINGS ................................................................................................................................ 45
7.3 ASSOCIATE A LIN DATABASE WITH A PAGE SET .................................................................................................... 46
7.4 SHOW COLD START VALUES ....................................................................................................................................... 46
7.5 VERIFY A PAGE SET ......................................................................................................................................................... 46
7.5.1 To verify a Page Set ................................................................................................................................................... 47
7.6 USE THE FIND DIALOGUE ............................................................................................................................................. 47
7.6.1 To find all occurrences of a text string ................................................................................................................ 47
7.7 SET DEFAULT OFF SCREEN FUNCTION KEY (OSFK) PANE ................................................................................... 48
7.8 WRITE PAGE ITEM ACTIONS......................................................................................................................................... 48
Page 4 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
HA260749U005 Page 5
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Page 6 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
HA260749U005 Page 7
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Page 8 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
HA260749U005 Page 9
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
13.8.3 OK .................................................................................................................................................................................. 93
13.8.4 Apply ............................................................................................................................................................................. 93
13.8.5 Cancel ........................................................................................................................................................................... 93
13.9 BAR CHART PROPERTIES PAGE .................................................................................................................................... 93
13.9.1 Fill direction ................................................................................................................................................................ 93
13.9.2 Underline used for bar chart .................................................................................................................................. 93
13.9.3 OK .................................................................................................................................................................................. 94
13.9.4 Apply ............................................................................................................................................................................. 94
13.9.5 Cancel ........................................................................................................................................................................... 94
13.10 BITMAP ENUMERATION PROPERTIES PAGE ............................................................................................................. 94
13.10.1 Enumerated ............................................................................................................................................................ 94
13.10.2 Variable selection ................................................................................................................................................. 94
13.10.3 Bitmap selection ................................................................................................................................................... 95
13.10.4 OK ............................................................................................................................................................................. 95
13.10.5 Apply ........................................................................................................................................................................ 95
13.10.6 Cancel ...................................................................................................................................................................... 95
13.11 BITMAP PROPERTIES PAGE ........................................................................................................................................... 96
13.11.1 Bitmap ..................................................................................................................................................................... 96
13.11.2 OK ............................................................................................................................................................................. 96
13.11.3 Apply ........................................................................................................................................................................ 96
13.11.4 Cancel ...................................................................................................................................................................... 96
13.12 BROWSER BLOCK ............................................................................................................................................................ 97
13.12.1 Browser Field (no subfields) .............................................................................................................................. 97
13.12.2 Browser Field (with subfields) ........................................................................................................................... 97
13.12.3 Browser Multi-bit field ........................................................................................................................................ 97
13.12.4 Browser Selection box ......................................................................................................................................... 97
13.12.5 Browser Subfield ................................................................................................................................................... 97
13.12.6 Browser Type box ................................................................................................................................................. 98
13.13 BUTTON TOOL PROPERTIES PAGE.............................................................................................................................. 98
13.14 COLOUR PALETTE ........................................................................................................................................................... 98
13.15 CHARACTER BASED SCREEN TYPES ............................................................................................................................ 99
13.16 COLOUR ATTRIBUTE PROPERTIES PAGE ................................................................................................................... 99
13.16.1 Colour Change....................................................................................................................................................... 99
13.16.2 Variable selection ................................................................................................................................................. 99
13.16.3 Colour selection .................................................................................................................................................. 100
13.16.4 OK ........................................................................................................................................................................... 100
13.16.5 Apply ...................................................................................................................................................................... 100
13.16.6 Cancel .................................................................................................................................................................... 100
13.17 COLOUR LIMITS PROPERTIES PAGE .......................................................................................................................... 100
13.17.1 Colour Limit Minimum ...................................................................................................................................... 100
13.17.2 Colour Limit Maximum ..................................................................................................................................... 101
Page 10 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
HA260749U005 Page 11
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Page 12 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
HA260749U005 Page 13
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Page 14 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
Contact your distributor if these documents are unavailable.
HA260749U005 Page 15
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
From Version 1.9, the User Screen Editor is NOT compatible with previous releases of the User Screen
Editor and will ONLY run on Windows XP and later operating systems.
The purpose of the User Screen Editor is to simplify the creation of interactive and inactive screens that can be
displayed on a specific Target Instrument Screen type, Target Panel. Each Target Panel contains a combination
of Pages (Page Sets), each Page representing a Pane on the Target Panel screen.
Beware…
User Screen Editor project files (.uxp) should be edited using the appropriate User Screen Editor version.
Failure to do so will result in the Page Set becoming incompatible with previous versions of the User
Screen Editor. To resolve this problem, Open and Save each Page Set in turn using the latest User Screen
Editor version, available from the manufacturer.
1.2.2 Panes
The Main pane is used to display the most significant information. It occupies most of the Target Instruments
screen, but other types of smaller pane are also configurable, e.g. 'Pop-up' panes that overlay the Main pane,
and a permanently visible 'Status' pane, often used as an alarm banner.
Page 16 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
HA260749U005 Page 17
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
2 GETTING STARTED
2.1 DESIGNING A USER SCREEN
Before starting to use to User Screen Editor to produce the required screens for the Target Instrument, try to
understand how all the appropriate information can be displayed on each Page, including any specific
information that is required at all times.
Start by analysing the process or instrument. To help with the analysis, it is very useful to sub-divide the process
or instrument into smaller groups of related functionality or equipment.
NOTE
These smaller groups are the equivalent to the Pages of the User Screen Editor.
Information only relevant to a specific process or instrument could be displayed in the Main or User Panes.
Information that requires immediate attention, and therefore needs to be constantly displayed, such as Alarms,
could be displayed in a Status Pane.
Specific function block information could be displayed on both the Point and Faceplate Panes. The Point Pane
is a full size image, while the Faceplate Pane is a thumbnail version.
Tip!
Creating a storybook or description of what is to appear on each of the Pages required is usually of help in
later stages of generating the User Screens, for the definition of Pop-up Panes, or Point Panes.
When satisfied with what is required on each Page, open the User Screen Editor and continue to generate the
required Pages using the Panes.
NOTE
If LINtools is currently open, simply select and open the Page Set file (.uxp) using the File > Open
command or double-click the selected Page Set file (.uxp). Alternatively, create a new Page Set file (.uxp)
using the File > New command. The Location of DB file for Page Set may still need to be configured.
Page 18 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
Customised Target Screen types can be created. This is not recommended as each file (.uxt) contains the
unique pre specified configuration of the selected Target Screen type.
HA260749U005 Page 19
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
Page Set filenames are assigned a .uxp extension when saved.
Before generating the individual screens for the Target Instrument, first create an 'empty' Page Set to
accommodate them. When the Pages are complete and ready to download to the Target Instrument, the whole
Page Set is downloaded, rather than the individual Pages.
TO CREATE OR EDIT A PAGE SET
NOTE
If LINtools is currently open, simply select the File > New Page Set command to open the User Screen
Editor and display the New Page Set dialogue.
With the User Screen Editor open, simply select File > New Page Set command to display the Page Set dialogue.
Alternatively, click the New Page Set button.
Enter a name in the Name of new Page Set field that matches the LIN Database (.dbf) filename. The Target
Instrument uses the Page Set that matches the LIN Database (.dbf) filename.
From the Target Panel field, click the drop-down menu and select the required Target Panel type.
Enter the filename of the OIFL file (.ofl), in the Status Pane OIFL file field, needed for display in the Status Pane.
NOTE
This field should remain unchanged unless an alternative Status Pane is required.
Finally, locate and select the LIN Database file (.dbf) that is to be associated with this Page Set Use the Browse
button to display the Open dialogue, which will assist with locating the required LIN Database file. Confirm
using the OK button.
NOTE
New Page Sets created within the Project environment are automatically associated with the default LIN
Database filename (.dbf) in the same the Instrument folder.
Page 20 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
Pages are stored in a Page Set, which is associated with a particular Target Instrument.
A Page must be configured with a Page Name, ID number, and Page Title, and the particular Pane in the
associated Target Instrument that the Page will be displayed on.
NOTE
After opening the required Page, the colour of the User Screen background can be customised using the
Page > Panel Colour command.
A Pane is part of the User Screen Editor displaying specific types of information. Each Pane has unique
dimensions, applicable to the Target Instrument it is configured for, but other types of smaller pane, see below,
can be included in the Page Set.
NOTE
Each Target Panel has a specific default set of Panes.
Main Pane This Pane occupies most of the Target Instrument screen, except for a narrow strip along the
top where the Status pane is located. It is used for a specific area of the system. Only one
Main Pane is configurable for a given target display. (In general, the location of the main
pane is target-dependent).
User Pane This is similar to the Main Pane occupies most of the Target Instrument screen.
Pop-up Pane This Pane will overlay the Main and User panes, but not the Status Pane, until closed by the
User. Several differently-sized Pop-up Panes can be configured.
Status Pane This Pane is a narrow strip located at the top of the Target Screen that is permanently visible,
i.e. 'always on top'. It is often used to show alarm status information. There can only be one
Status Pane in a display. (In general, the location of the status pane is target-dependent).
Point Pane This Pane has dimensions of 320 170 (VGA) and 800 450 (SVGA). It can be use d to
display a graphical representation for a specific block and its parameters. This is a Panel size
version of a Faceplate Pane.
Faceplate Pane This Pane has dimensions of 132 40 (VGA) and 172 80 (SVGA). It can be used to display
a graphical representation for a specific block and its parameters. This is a thumbnail version
of a Point Pane, allowing multiple Faceplate Panes to be displayed on one screen.
Off Screen Function Key (OSFK) Pane
This Pane has dimensions that are dependent on the size of the Target Screen. It is used to
configure the operation of the function keys (Fn) for Target Screen types that support off
screen keys, and is displayed below the pane when viewing or editing a page.
Dialogue Box Pane This is similar to a Pop-up pane, but is invoked by the system rather than by the operator. It
is often used to display warnings and system messages.
HA260749U005 Page 21
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
The 'home page' is normally assigned an ID of '1'. This is usually the power-up and timeout page, and is
accessible from the top-level menu. 'Built-in' pages have IDs > 999.
14. Edit the Page Title parameters. This is title of the Page as it appears on the instrument display.
For a fixed title, simply type the required character string into the Title field. Check the Use
Dictionary box if you want the title to change if the language is changed. Enter the corresponding
user-dictionary reference number in the Dictionary Entry No field, e.g. 'U123'. At runtime, the current
user dictionary is consulted and the string referred to by the specified reference is displayed as the
title.
15. Edit the Target field. Only the Pane field can be edited.
Select the required Pane type from the drop-down list. All other fields were defined when the Page
Set was created.
NOTE
These fields become Read Only when the New Page dialogue is complete and accepted.
Page 22 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
These Page Items can be configured to change colour dynamically if required.
NOTE
After opening the required Page, the colour of the User Screen background can be customised using the
Page > Panel Colour command.
HA260749U005 Page 23
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
Up to sixteen customised colours can be stored using the vacant Custom colors slots.
NOTE
To select a Page Item click anywhere on or within its outline. This applies to unfilled as well as to filled
shapes.
30. The Page Item Properties dialogue appears, displaying all the pages applicable to the selected Page
Item.
31. Select each page in-turn, editing the parameters as required. Individual text strings can be found
and/or replaced using the Search command to reveal the Find dialogue.
32. Press OK to confirm the parameter changes and close the dialogue, or Cancel to ignore the changes
and close the dialogue.
Page 24 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Tip!
Double-click an error or warning record to access the application needed to correct the problem.
HA260749U005 Page 25
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
LIN Databases are associated with a Page Set using either the New Page Set or the Page Set Properties
dialogues.
33. A LIN Database can be associated when first creating a Page Set. Select the File > New Page Set
command to display the New Page Set dialogue. Alternatively, select File > Properties > Page Set to
display the Page Set Properties dialogue.
34. The required LIN Database filename can be entered in the Location of DB file for Page Set field. If the
LIN Database filename (. dbf) is unknown, press the Browse… button to reveal the Open dialogue to
help locate the LIN Database filename. If the LIN Database functions are unavailable because the LIN
Database file (.dbf) failed to load, the LINDBIF.dll could be missing.
35. Press OK to confirm LIN Database selection.
Page 26 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
HA260749U005 Page 27
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
4 TARGET DEFINITION
A Target is an Instrument manufactured with a specific screen type. The screen type capabilities are pre
specified in a Target Definition file. All existing Target Screen type templates can be edited using the Target
Panels dialogue.
Each Target Definition file contains all relevant information about the screen type, i.e. overall screen size, what
Panes, Drawing tools, Capabilities (such as, Signing (21CFRpt11), or Touch Areas) are supported.
NOTE
Customised Target Screen types can be created. This is not recommended as each file (.uxt) contains the
unique default configuration of the selected Target Screen type.
Beware…
Target Definition (.uxt) files should NOT be created or edited by users who are not fully competent to do
so. Otherwise, Target Definition files may be created that are NOT compatible with any of the
manufacturers Target Screen types. In such as case, pages using incompatible Target Definition files will
have to be redrawn in their entirety using the appropriate Target Definition file.
NOTE
The Target Definition may be password protected. If either the Default Password or changed Password is
configured any attempt to open this dialogue will request a password to continue.
Press ‘New’ to initiate the Target Panel wizard. The first dialogue of the Target Panel wizard appears.
Enter an appropriate template name for the Target Screen type being created. Select the Target Instrument
and Target Screen type (Pixel based or character based).
Select the type of database the Target Instrument uses (LIN Database or SIB, (not supported - greyed out)).
Press ‘Next’ to continue.
Enter the required Target Screen type size in pixels. Enter the width of the Target Screen type. Enter the
height of the Target Screen type.
If the Character based screen type was selected previously, additional width and height characters parameters
are requested. Press ‘Next’ to continue.
Select the colour capabilities of Target Screen type.
Select a radio button to specify the colour capabilities supported by the Target Screen type.
Press ‘Next’ to continue.
Select the interactive capabilities of Target Screen type.
Select the appropriate checkboxes to specify the interactive capability supported by the Target Screen type.
Press Next to continue.
Page 28 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
The Set Password button is used to restrict access to the Target Panels dialogue. If a Password is configured any
attempt to open this dialogue will request a password to continue.
HA260749U005 Page 29
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
5 MENUS
The Menu Bar is a special toolbar at the top of the screen that contains 7 pulldown functions. Each pulldown
displays a list of commands.
The File pulldown enables the User to manage the User Screen Editor by offering the following commands.
NOTE
Some commands are only available in certain circumstances. When unavailable, commands are greyed out.
New Page Set Click this to display the New Page Set dialogue allowing the Page Set Properties to be
configured in readiness for the required Target Instrument Pages.
Open Page Set Click this to display the Open/Browse dialogue in order to locate an existing Page Set. If
another instance of the selected file is already open, a message appears asking if a new
instance of the page set is to be opened, or if the existing instance should be switched to.
Where several instances are open, ‘Switch to…’ always opens the first instance.
Close Page set Click to close the selected Page Set window. A prompt dialogue may appear if there are
unsaved changes.
Import Page set Click this to display the ‘Open’ dialogue. This allows a Page Set from another source to be
included in the current Target Instrument.
Save Click to save the currently open file with its current file name, location, and file format,
overwriting the existing file.
Save As… Saves the active file with a different file name, location, or file format.
Page 30 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Target definitions… Click this to display the Target Panels dialogue. This allows the Target Panel type to be
specified.
Options… Click this to display the Options dialogue. This allows the user to change the destination of
the Target Panel type files and Portmap files using the Browse button.
Build Output (OIFL) files
Click this to open the Report Window and build the current Page Set, listing any errors and
warnings that may cause the Target Instrument to function incorrectly.
Configure automatic building of output files
Click this display the Save OIFL dialogue. This allows the configuration of a default response
to saving an OIFL to be specified.
Print Setup Click this to display the Print Setup dialogue. This configures the paper source, paper size,
page orientation, and other layout options for the active file.
Print Preview Click this to display an impression in the Print Preview window of the selected Page when
printed.
Print… Click this to display the Print dialogue. This prints the active file or selected items.
HA260749U005 Page 31
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
Some commands are available only in certain circumstances. Unavailable commands are greyed out.
Undo Click this to reverse the last command or deletes the last entry you typed. To reverse more
than one action at a time, click the arrow next to the Redo tool command, and then click
the actions you want to undo.
Redo Click this to reverse the action of the Undo command. To redo more than one action at a
time, click the arrow next to the Undo tool command, and then click the actions you want
to redo.
Cut Click this to remove the selected object from the active document and place it on the
Clipboard.
Copy Click this to copy the selected object to the Clipboard.
Paste Click this to insert the contents of the Clipboard at the insertion point, and replaces any selection.
This command is available only if you have cut or copied an object, text, or contents of a
cell.
Delete Click to remove the selected object from the currently open window.
Select All Click to select all objects in the currently open window, either Pages in the Page Set or Page
Items in the Page
NOTE
Multiple objects or files can be selected individually while pressing the <Ctrl> key, or a consecutive group of
files by selecting the first file, then while pressing the <SHIFT> key, click the last file.
Save to Library… Click this to store a copy of the selected object or grouped objects to the User Screen Editor
library. The Library can store commonly used Page Items.
Load from Library...Click this to display the library of commonly used Page Items.
Find… Click this to display the Find and Replace dialogue. This dialogue permits the User to search
for specific sequence of characters. When located the results can be sorted in alphabetical
ascending or descending order.
Properties Click to reveal a further menu, allowing selection of the Page Set, Page or Page Item.
Selection displays the appropriate Properties dialogue.
Page 32 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
FIND DIALOGUE
Use this to search for a specific text string within a Page Set, and if required, to replace it with another defined
text string. The fields are:
Find what Enter the text string that is to be searched for.
Incremental searching
Indicates that the search for the specific text string will commence immediately, refining the
search as characters are added to the text string.
Exact match Indicates that the search for the specific text string will list only those occurrences that
match the ‘Find what’ text exactly.
Match case Indicates that the search for the specific text string will list only those occurrences that
match the case as entered in the Find what field. For example, Type in AcSource, not
Acsource to find the LIN Variable, AcSource.
Replace Enables the Replace with field, and indicates that any occurrence of the specific text string
being searched for can be replaced with the text string in the Replace with field.
Replace with This is the LIN Variable, Instrument Variable, or specific text string that will replace the text
string entered in the Find what field. Use the Browse button to display the LIN Database or
the Instrument Browser dialogue, may assist in locating the required Variable.
LIN Variable Use this radio button to select to search the LIN Database Variable. Use the Browse button
to display the LIN Database Browser dialogue, to assist with locating the required Variable.
Instrument Variable
Use this radio button to select to search the Instrument Variable. Use the Browse button to
display the Instrument Browser dialogue, to assist with locating the required Variable.
Start search Initiates the search for the text string specified in the Find what field.
Replace Replaces the selected occurrence of the text string specified in the Find what field with the
text string in the Replace with field.
Replace all Replaces all occurrences of the text string specified in the Find what field with the text string
in the Replace with field.
Done Closes the dialogue.
Table Lists all occurrences of the text string specified in the Find what field.
HA260749U005 Page 33
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Toolbar The Toolbar hosts icon buttons that enable quick access to a limited amount of Edit and
View commands. It is displayed by default and located at the top of the User Screen Editor.
Drawbar The Drawbar tools allow the user to create new graphical and text items on the active Page.
The items may be static, or if linked to an instrument or LIN database can be made to
change colour, to ‘fiil’ or ‘empty’ etc. according to the value of the variable.
Textbar The Textbar permits quick access to the Text tools provided, which are used to modify the
attributes and appearance of Text Page Items on the currently open Page.
Statusbar The Status Bar displays specific User Screen Editor information, such as, current editor action
or status, and various properties of the Page Item(s) selected on the page. It is displayed by
default and located along the foot of the User Screen Editor.
Large Icon Click to show the contents of the selected Page Set in a standard size icon format.
Small Icons Click to show the contents of the selected Page Set in a small size icon format.
List Click to show the contents of the selected Page Set in list format, alphabetically and
numerically.
Details Click to show the contents of the selected Page Set in list format, but including further
specific information for each Page.
Page 34 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
New Page… Click this to display the New Page dialogue allowing the Page Properties to be configured.
Open Page Click this to open the Page currently selected in the Page Set.
Close Page Click this to close the currently open Page.
Verify Page Set Click this to immediately open the Report Window and build the current Page Set, listing any
errors and warnings that may cause the Target Instrument to function incorrectly.
On-line to panel Click this to create a communications link from the current Page Set to the Target
Instrument, defined in the Location of DB for Page Set in the Page Set Properties dialogue,
in a live system.
Show Page Set OIFL Strings
Click this to display all OIFL Strings used in the current Page Set in a Read-Only OIFL Strings
for… window.
Show OIFL Strings Click to display the OIFL Strings used on the current Page. The OIFL strings are displayed in a
Read-Only window.
Show Cold Start Values
If this item is selected, the User Screen representation shows the Show Cold Start Value if
possible, or a series of question marks ( ? ) if the value does not fit the graphic. If not
selected, or if the values are not available for a particular Variable, the value appears as a
series of asterisks ( * ). The number of asterisks displayed is equivalent to the number of
display characters allocated to the variable, which can edited on the worksheet.
Panel Colour... Click to display the Colour palette dialogue. This allows the user to select the required
colour for the User Screen of the Target Instrument, defined in the Location of DB for Page
Set field of the Page Set Properties dialogue, in a live system.
HA260749U005 Page 35
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Cascade Click this to display the currently open windows one on top of the other, but in such a way
that title bar for each window remains visible.
Tile Click this to display the currently open windows equally in the main User Screen Editor, so as
to display as much of the window as possible.
Arrange Icon Click this to display all open files in separate windows on the screen. The Arrange Icon
command makes it easier to drag between files.
Current Window Click the required entry to display it as the main window.
Help Opens the on-line help file including Contents, Index, and Search facilities. <F1> help also
opens this help file, but at a topic appropriate to the cursor position.
About User Screen Editor…
This displays the program details including the name, version number, and description.
Page 36 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
6 TOOLBARS
6.1 MAIN TOOLBAR
Click this to display the New Page Set dialogue allowing the Page Set Properties to be configured in readiness
for the required Target Instrument Pages
Click this to display the Open/Browse dialogue in order to locate an existing Page Set. If another instance of the
selected file is already open, a message appears asking if a new instance of the page set is to be opened, or if
the existing instance should be switched to. Where several instances are open, ‘Switch to…’ always opens the
first instance.
Click this to overwrite the current Page Set information with the current changes.
Click this to display the New Page dialogue allowing the Page Properties to be configured.
HA260749U005 Page 37
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Click this to open the Page currently selected in the Page Set.
Click this to immediately open the Report Window and build the current Page Set, listing any errors and
warnings that may cause the Target Instrument to function incorrectly.
Page 38 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
VIS: This field shows the Access State of the selected Page Item as defined in the objects
Properties dialogue.
WRI: This field shows the Variable State of the selected Page Item as defined in the Page Item
Properties dialogue.
MAX: This field shows the High Limit, if supported by the selected Page Item, as configured in the
Limit Page of the Page Item Properties dialogue.
MIN: This field shows the Low Limit, if supported by the selected Page Item, as configured in the
Limit Page of the Page Item Properties dialogue.
X: Y: This field shows the page co-ordinates in Pixels of the most upper left point of the selected
Page Item.
W: H: This field shows the Width and Height in Pixels of the selected Page Item.
total items This shows the total number of Page Items used and how many are currently selected on
this Page.
Communications Status
This indicates the communication status of the User Screen Editor, e.g. that it is
communicating with the Target Instrument in a live system.
Time This indicates to current time according to the location of the User Screen Editor.
HA260749U005 Page 39
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Click this to select a font type for the currently selected Text Page Item.
Click to align the selected Text Page Item within the available text frame, to the left.
Click to align the selected Text Page Item, within the available text frame, to the centre with a left-hand bias.
Text is aligned to the nearest character width. ‘Left-biased Centre’ biases the alignment one character-width to
the left when the string cannot be positioned in the exact centre.
Click to align the selected Text Page Item within the available text frame to the centre with a right-hand bias.
Text is aligned to the nearest character width. ‘Right-biased Centre’ biases the alignment one character-width to
the right when the string cannot be positioned in the exact centre.
Click to align the selected Text Page Item within the available text frame to the right.
Page 40 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Bring to front. Click to bring the selected Page Item to the front of the page, i.e. to the top layer.
Send to back. Click to send the selected Page item to the back of the page, i.e. to the bottom layer.
Bring Forward. Brings the selected item forward (up) one layer.
Send backward. Sends the selected item back (down) one layer.
Custom rotate. Allows the user to enter an absolute angle for the item.
Increasing angle rotates clockwise.
Toggles gridline visibility on and off. If enabled, ‘Snap to Gridlines’ still operates when grid lines off.
Gridlines do not appear at the target screen.
Grid Colour. Allows the user to select a colour for the gridlines.
Grid settings. Allows the grid and ‘snap to grid’ characteristics to be edited. See ‘Grid settings’, below,
for further details.
Snap object(s) to grid. If ‘Snap to grid’ is disabled in ‘Grid settings’, then this button can be used to
snap individual items to the grid if required. Aligns the top and left edges to the nearest grid line.
HA260749U005 Page 41
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Accessed by clicking on the grid settings icon in the Placement bar. The tool is disabled for character-based
targets, where settings are fixed (based on target character cell size).
Tip!
Turning the Grid on will help when attempting to align Page Items.
NOTE
A Grid will have the same effect when displayed or hidden.
Page 42 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Rectangle tool. Allows rectangles to be drawn. Squares are deemed to be rectangle with sides of equal
length.
Rounded Rectangle Tool. Not applicable with this version of software. Always 'greyed out' (disabled).
Ellipse tool. Allows ellipses to be drawn. A circle is an ellipse having minor axes the same length as the
major axis.
Triangle tool. Triangles are drawn with the base horizontal: the corner positions must be edited if any
other orientation is required.
Bitmap tool. Allows a bitmap image to be placed on the screen. Initially, this item is drawn with the text
'Bitmap undefined' inside its area. The bitmap is defined, by selecting it using the Browse key, as described in
the Bitmap Properties page topic.
Barchart tool. Allows the inclusion of a barchart display on the screen. Initially, this is drawn containing a
question mark to indicate that there is no source defined for the item. Once a suitable source has been
selected the question mark disappears. One way of doing this is to double click on the bar chart and then to
use the browse key in the resulting 'Bar Chart Item Properties' page to navigate to a suitable variable which is
then clicked-on to select it. See 'Bar Chart Properties page' for more details.
HA260749U005 Page 43
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Trend Graph tool. Allows a Trend Graph to be incorporated in the user screen. As described for 'Barchart',
above, it is initially drawn with a question mark within it, and this remains until a variable has been assigned to
the trend. See 'Trend Graph Properties page' for more details.
Program Profile tool. Similar to the Trend Graph tool, this allows a set point programmer profile to be
added to the screen. This can either be static or dynamic as selected from the Program Profile properties page.
The item is initially drawn containing a question mark which remains until a program block has been assigned
to it..
Text Variable tool. This allows a 'dynamic' text string (a process variable value for example) to appear on
the user screen, by linking the text to a database variable. Initially the item appears as a string of question
marks, but once linked to the database, the question marks change to a asterisks (*). If a suitable variable is
selected, the Enumerations area of the Text Variable Properties page can be used to change text strings
according to the value of the variable. Further, for supporting instruments only, if a suitable variable is
selected, then the text variable can be configured such that the actual text string displayed at the instrument's
operator interface can be selected, by the user, from a drop down (combo) list.
Touch Area tool. This allows an area of the screen to become touch sensitive. The action(s) to be carried
out when this area of screen is touched are defined in the Touch Area properties page, described in a separate
topic. The touch area is invisible at the Operator interface, but it can be overlaid by another suitable item if
required, Alternatively other page items, such as triangles, rectangles etc. can be made touch sensitive by
configuring the 'Touch Area' tab of their properties page appropriately.
Button Tool. Allows a 'button' to be positioned on the screen. Buttons are items that are touch sensitive;
the action(s) to be carried out being configured in the 'Touch Area' tab of the Button Tool Properties page.
OIFL tool. This allows an area containing Operator Interface Language text to be positioned on the screen.
See the 'OIFL properties page' topic for further details.
Line / Text Colour. This defines the default colour for Text and Line page items. Text
appears on a background colour defined in the Fill / Background, but line items such as rectangles, triangles
etc. are filled only if 'Object is filled' is enabled in the item's properties. The required colour is selected from a
pull down palette which appears when the down arrow is clicked-on.
Fill/Background colour. This defines the default background colour for text (which appears
in the Foreground colour), and the fill colour for any line item which has 'Object is filled' enabled in its
properties page. The required colour is selected from a pull down palette which appears when the down arrow
is clicked-on
Page 44 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
7 HOW TO...
7.1 SPECIFY/CONFIGURE A TARGET SCREEN TYPE
This indicates the specific Screen type, including the supported capabilities, fitted in the Target Instrument. To
configure a target screen:
Select the Target Definitions command, File > Target Definitions, to display the Target Panels dialogue.
Alternatively, press <Crtl + T>.
This dialogue shows a list of pre-defined Target Screen types. Either:
Press ‘New’ to initiate the Target Panel wizard and create a Customised Target Screen type template,
Click a pre-defined Target Screen type and press ‘Edit’ to reveal the Target Properties dialogue allowing these
properties to be edited, or
Click a pre-defined Target Screen type and press ‘Remove’ to delete the Target Screen type template after
confirmation.
Click a Target Screen type and press ‘OK’ to accept.
NOTES
The Target Definition may be password protected. If a Password is configured any attempt to open this dialogue
will request a password to continue.
Customised Target Screen types can be created. This is not recommended as each file (.uxt) contains the unique
default configuration of the selected Target Screen type.
See also: Create a Target Screen type, Edit a Target Screen type
HA260749U005 Page 45
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
LIN Databases are associated with a Page Set using either the New Page Set or the Page Set Properties
dialogues.
A LIN Database can be associated when first creating a Page Set. Select the File > New Page Set command to
display the New Page Set dialogue. Alternatively, select File > Properties > Page Set to display the Page Set
Properties dialogue.
The required LIN Database filename can be entered in the Location of DB file for Page Set field.
If the LIN Database filename (. dbf) is unknown, press the Browse… button to reveal the Open dialogue to help
locate the LIN Database filename.
If the LIN Database functions are unavailable because the LIN Database file (.dbf) failed to load, the LINDBIF.dll
could be missing.
Press OK to confirm LIN Database selection.
Beware…
You MUST verify a Page Set and eliminate all problems before downloading to the Target Instrument.
Failure to do so will result in downloading Pages (screens) to the instrument, which may be incorrect.
This could cause problems with the operation of the instrument.
To resolve this problem,
Follow the instructions below.
(Continued)
Page 46 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Tip!
Double-click an error or warning record to access the application needed to correct the problem.
EXAMPLES
“Warning: Database Not Defined. Variable references will not be verified.”
This indicates that one or more Variables have been specified incorrectly.
Tip!
Use wildcard characters or enter only part of the required sequence of characters to broaden the results.
By using the ‘%’ wildcard character any single character is found; a search for ‘s?t’ finds ‘sit’ and ‘set’ and
the ‘*’ wildcard character finds any multiple characters in a string of text, a search for ‘s*t’ finds ‘seat’,
‘sent’ and ‘settlement’.
NOTE
Incremental searching can improve response time when searching for a text string across many Pages.
If the text string in the Find what field must be replaced, select the Replace checkbox to enable Replace with
field. Use the LIN Variable radio button, Instrument Variable radio button and Browse button to specify what
the text string in the Find what field must be changed to.
Press the Start search button to initiate the search for the text string entered in the Find what field. As each
occurrence is located it is listed in the table below the Replace with field.
HA260749U005 Page 47
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
7.8.1 Example
ST:"[PID1.SL]:=SL+10.0;" (increments SL when button pressed).
7.8.4 Actions
<Action> ::= <Action Mnemonic> [{ ‘:’ <Action Qualifier> }]
Page 48 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
HA260749U005 Page 49
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
The Text tool is disabled if the target has no Fonts specified.
NOTE
A font can also be selected from the Page Item’s Text Properties page, or Text Variable Properties page.
NOTE
Text can also be aligned using the item’s Text Properties page, or Text Variable Properties page.
Page 50 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
Text can also be aligned using the item’s Text Properties page, or Text Variable Properties page.
NOTE
Text can also be aligned using the item’s Text Properties page, or Text Variable Properties page.
NOTE
Text can also be aligned using the item’s Text Properties page, or Text Variable Properties page.
HA260749U005 Page 51
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
The Bar Chart tool is disabled for targets not supporting bar charts. Character targets using underline
characters for Bar Charts can draw them only within the underline character areas.
NOTE
The Bitmap tool is disabled for all character targets, and pixel targets not supporting bitmaps.
Page 52 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
The Button tool is disabled if the target has no Fonts specified.
NOTE
The Text Variable tool is disabled if the target has no Fonts specified.
NOTE
The Touch Area tool is disabled for targets not supporting touch areas.
HA260749U005 Page 53
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
The Trend Graph tool is disabled for targets not supporting Trend Graphs.
Page 54 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
The Line tool is disabled for character targets not supporting angled line draw characters. Character-based
targets approximate to the ideal line, in a rectangular bounding-box.
NOTE
The Rectangle tool is disabled for character targets not supporting straight line draw characters.
HA260749U005 Page 55
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
The Ellipse tool is disabled for all character targets, and pixel targets not supporting ellipses.
Page 56 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
HA260749U005 Page 57
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Page 58 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
The ‘Configure using default font’ button changes the Grid Settings to fit the Font Style selected in the Text
Bar.
HA260749U005 Page 59
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
An Action is a set of instructions written in Structured Text (ST), specifying direct operations on the LIN
Database of the running control strategy.
Structured Text (ST) strings are limited to the form "<name>:=<value>;", where <name> is the name of a LIN
Database field or subfield enclosed in square brackets, and <value> is a string representing the value to be
assigned.
The value string may be enclosed in single quotes, and may then make use of standard Structured Text (ST) ‘$’
escape sequences. Alternatively, it may be unquoted, in which case it is terminated by ‘;’ or a space.
Space characters are permitted either side of ":=" and before the ‘;’. The effect of the assignment will be the
same as if the value string had been typed in via LINtools.
For numeric or Boolean variables, <value> may also be a limited form of Structured Text (ST) expression,
involving only fields within the function block being assigned.
Example:
ST:"[PID1.SL]:=SL+10.0;" (increments SL when button pressed).
With the use of the instruction categories below, the User Screen Editor can achieve a specific response to a
User Screen action, or changes of a value at a specified point.
(*ADJUST TEMP SETPOINT*) TIC_100.SL:= REC1.A4;(*A statement*)
Dig_A.Out AND 64 (*An expression*)
Page 60 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
Hexadecimal digits are not case-sensitive.
HA260749U005 Page 61
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
Time units may be input as upper or lower case.
Block Field(s)
COUNT SetCount
TOTAL Target
NOTE
Any Field that cannot be written to via a screen readout cannot be written to by Structured Text.
Page 62 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
9.5.1 Arithmetical
Example: (Block_5.PV + 3.5) / Const.A7 + Const.A6
Example: COS(Block_6.PV)**1.5
Example: Dig_A.Out AND 64
9.5.2 Logical
Example: Recipe.A0 < 4
Example: Dig_B.Out.Bit5 = Dig_A.Out.Bit3
vSTEP3.T >= T#4m
See also ‘Notation Formats’
NOTE
'_' is the underscore (underline) character, not the hyphen or minus sign.
NOTE
Variable names containing bad Identifiers can be made recognisable as Variables by enclosing the whole
Variable name in square brackets:
Example: [6366.MN]
Example: [DG_CONN3.W Field2.Bit6]
Example: [x*y*z.OP]
HA260749U005 Page 63
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
In an Expression, the evaluation order of operators follows the table, with the earliest-evaluated operators at
the top.
Some operators are effective only with the appropriate operand types. E.g. the power operator (**) requires A
to be positive; the MOD operator must have positive integer operands, etc.
Page 64 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
- Negate -A
+ Add A+B
- Subtract A-B
= Equals A=B
HA260749U005 Page 65
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
OR Logical OR A OR B
[1] ‘A’ must exceed zero. [2] ‘A’ and ‘B’ must be integers.
Page 66 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
Space characters occupy the same amount of memory as other characters.
NOTE
Statements must be terminated by a semicolon.
9.9.1 Assignment
variable := expression;
Various types of assignment are possible, including the following examples:
Assign a constant to a real variable.
Example: PIC_004.PV:=35.5;
Assign a calculation to a real variable.
Example: ANOP_3.PV:=Const.A6 + (Block_5.PV+3.5) / Const.A7;
Assign a constant to a digital variable. Example: Dig_B.Out.Bit0:=1;
Assign a calculation to a digital variable. Example: SEQ4.Hold:=(PIC_005.PV > 30) AND Dig_B.Out.Bit5;
Assign a string to a mode. Example: PIC_004.Mode:="CASCADE";
Assign an integer to a bitfield. Example: Dig_A.Out:=96;
Assign a bitwise calculation to a bitfield. Example: Dig_A.Out:=Dig_B.Out XOR 96;
HA260749U005 Page 67
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
9.9.2 IF-statement
IF expression THEN statement-list
{ELSIF expression THEN statement-list}
{ELSE statement-list}
END_IF;
NOTE
The IF-statement allows zero or more ELSIF clauses, and zero or one ELSE clause. IF-statements can be nested.
Example:
IF PIC_004.PV < 10 THEN
Dig_B.Out.Bit0 := 1;
RECORD.A4 := ANIN_004.HR;
ELSE
Dig_B.Out.Bit1 := 1;
END_IF;
Example:
IF LEVEL.OP < REC1.A0
THEN Dig_B.Out.Bit1 := 0;
END_IF;
See also ‘Notation Formats’
Page 68 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
Database names are not case-sensitive, i.e. capital or small letters may be freely used or mixed in the names.
Example: Dig_A.OUT.BIT3 is equivalent to Dig_A.Out.
9.12.1 Bitfields
8-bit bitfields may be referred to as decimal integers in the range 0 to 255 (i.e. binary 00000000 to 11111111).
Example: Dig_A.Out:=96; assigns the binary value 01100000 to the bitfield.
16-bit bitfields may be referred to as decimal integers in the range -32768 to +32767 (i.e. binary 1000 0000
0000 0000 to 0111 1111 1111 1111, in 2's complement format).
9.12.2 Aliases
TagName aliases can be used in Structured Text.
NOTE
Identifiers contained in a Variable must be valid.
HA260749U005 Page 69
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
To access the User Screen Editor’s help file, pull down the Help menu and click Help Topics. The help file opens
at the ‘Welcome to the User Screen Editor!’ topic.
If already open, the help topic last accessed is displayed instead.
Use the help window’s Contents, Index, or Search tabs to get help on any topic.
If you want to step from one topic to the next in a logical order, click the browse buttons in the required
direction.
Page 70 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
HA260749U005 Page 71
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
11.2.2 Add
Use this button to display the Add Bitmap dialogue. The Add Bitmap dialogue allows the configuration of a new
Bitmap in the list of the required Bitmap properties.
11.2.3 Edit
Use this button to display the Edit Bitmap dialogue revealing the properties of the Bitmap selected in the Table
list. The Edit Bitmap dialogue allows the properties, as displayed in the Table list, of the selected Bitmap to be
edited.
11.2.4 Remove
Use this button to remove the selected Bitmap from the Table list.
Beware…
The selected Bitmap is removed without requesting confirmation. This may the cause the User Screen
page to display incorrectly.
Page 72 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
11.3.1 Capabilities
This series of checkboxes define the resources supported by the Target Screen type.
Supports display agent driven sub-panes
If enabled, the Target Screen type will display sub-panes requested from an Agent.
Supports flashing If enabled, a configured Page Item continuously alternates its appearance, e.g. flashes on and
off, or switches between two different colours.
Supports highlighting
If enabled,, a configured Page Item is displayed differently from non highlighted objects, e.g.
with increased colour brightness, or with swapped foreground and background colours.
Supports touch areas
If If enabled, the Target Screen type will respond to an operation originating from a Touch
Area. Touch areas are intrinsically invisible, but can be identified to the operator by
overlapping them with suitable graphics.
Supports buttons If If enabled, the Target Screen type will respond to an operation originating from a Button.
Further configuration may be required if a Target Screen type requires a Button to have an
internal border, see next point.
Buttons have a VT220-style single character border
If enabled, the Target Screen type Button will have an single character internal border. This
is disabled if the ‘Supports buttons’ capability is not enabled (not ticked).
Supports signing (21CFR11)
If enabled, the Target Screen type will request Confirmation when the configured Action is
operates.
NOTE
The Confirmation Properties page will appear on the appropriate Page Item Properties dialogues to configure
the required confirmation.
HA260749U005 Page 73
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
These colour specifications are not downloadable to the Target Instrument. Their purpose is simply to
ensure that the colours seen on the User Screen Editor worksheet match as closely as possible those
appearing on the Target Screen when the configurations are downloaded and run.
11.4.2 Setup
Use this button to display the ‘Colour Setup’ dialogue. This allows the default background and foreground
colours to be defined and to specify that the Target Screen type can support Colour change commands.
11.4.3 Add
Use this button to display the Add Colour dialogue. The Add Colour dialogue allows the configuration of a
new colour in the Table list of the required Colour properties. Customised Colours can also be defined.
11.4.4 Edit
Use this button to display the Edit Colour dialogue revealing the properties of the Colour selected in the Table
list. The Edit Colour dialogue allows the properties, as displayed in the Table list, of the selected Colour to be
edited and customised Colours to be defined.
11.4.5 Remove
Use this button to remove the selected Colour from the Table list.
Beware…
The selected Colour is removed without requesting confirmation. This may the cause the User Screen page
to display incorrectly.
Page 74 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
Change the Filename field, and the Target name field on the General page, to create a duplicate set of
Target Screen type properties.
HA260749U005 Page 75
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
11.7.2 Setup
Use this button to display the Font Setup dialogue. This allows the default Font to be specified, and indicate
that the Target Screen type can support Font change configuration.
11.7.3 Add
Use this button to display the Add Font dialogue. The Add Font dialogue allows the configuration of a new Font
in the Table list of the required fonts properties.
11.7.4 Edit
Use this button to display the Edit Font dialogue revealing the properties of the Font selected in the Table list.
The Edit Font dialogue allows the properties, as displayed in the Table list, of the selected Font to be edited.
11.7.5 Remove
Use this button to remove the selected Font from the Table list.
Beware…
The selected Font is removed without requesting confirmation. This may cause the User Screen page to
display incorrectly.
Page 76 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
11.8.2 Dimensions
Width Use this field to specify the width, in pixels, of the designed Target Screen Type.
Height Use this field to specify the height, in pixels, of the designed Target Screen Type.
NOTE
Height and width fields are omitted for configuration of Pixel-based Target Screen types.
NOTE
A maximum of 9999 pixel intervals can be configured.
HA260749U005 Page 77
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
11.10.2 Add
Use this button to display the ‘Add Instrument’ dialogue. The ‘Add Instrument’ dialogue allows the
configuration of a new Instrument in the list of the required Instrument properties.
11.10.3 Edit
Use this button to display the ‘Edit Instrument’ dialogue revealing the properties of the Instrument type
selected in the Table list. The ‘Edit Instrument’ dialogue allows the properties, as displayed in the Table list, of
the selected Instrument to be edited.
11.10.4 Remove
Use this button to remove the selected Instrument from the Table list.
Beware…
The selected Instrument type is removed without requesting confirmation. This may prevent the display of
the User Screen page.
Page 78 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
11.11.3 Browse…
Use this button to reveal the ‘Open’ dialogue. This can then be used to locate an existing file containing all
required ASCII Codes.
11.12.2 Database
LINDB This shows the type of Database used by the Target Screen type.
HA260749U005 Page 79
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Page 80 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
11.14.2 Setup
Use this button to display the ‘Pane Setup’ dialogue. This allows a default Font to be defined.
11.14.3 Add
Use this button to display the ‘Add Pane’ dialogue which allows the configuration of a new Pane type in the
Table list of the required Pane properties.
11.14.4 Edit
Use this button to display the ‘Edit Pane’ dialogue revealing the properties of the Pane selected in the Table list.
The ‘Edit Pane’ dialogue allows the properties, as displayed in the Table list, of the selected Font to be edited.
11.14.5 Remove
Use this button to remove the selected Pane from the Table list.
Beware…
The selected Pane is removed without requesting confirmation. This may cause prevent the display of a
User Screen page.
HA260749U005 Page 81
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Page 82 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
11.16.2 Add
Use this button to display the ‘Target Variable’ dialogue. The ‘Target Variable’ dialogue allows the configuration
of a new Variable in the list.
11.16.3 Edit
Use this button to display the ‘Target Variable’ dialogue revealing the properties of the Variable selected in the
Table list. The ‘Target Variable’ dialogue allows the properties, as displayed in the Table list, of the selected
Instrument to be edited.
11.16.4 Delete
Use this button to remove the selected Variable from the Table list.
Beware…
The selected System Variable is removed without requesting confirmation. This may the cause the User
Screen page to display incorrect information.
11.16.5 Export
Use this button to display the ‘Save As’ dialogue and generate a Text file (.txt) of the selected Variable from the
Table list.
11.16.6 Import
Use this button to display the ‘Open’ dialogue and locate a Text file (.txt) of a required Variable instance.
Tip!
Use the Import and Export buttons to generate a Text file (.txt) of System Variables that are used
consistently throughout the System.
HA260749U005 Page 83
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
12 WHAT IS
12.1 A LIN DATABASE?
A LIN Database (.dbf) is a software program that runs in a LIN Instrument. The running LIN Database takes in
signals from sensors in an outside entity (e.g. an industrial plant), processes them in specified ways, and then
outputs signals to actuators in the entity to control its behaviour in the required manner.
The cycle of signal input to the LIN Database, signal processing, and signal output to the entity is repeated
continuously while the LIN Database runs.
More than one LIN Instrument can be involved in controlling a single entity, but only one LIN Database can run
in a single LIN Instrument at a time.
A LIN Database can work in conjunction with one or more LIN Sequences running in the LIN instrument. It can
also make use of LIN Actions stored in action files in the LIN instrument.
Page 84 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
BREAK Boolean Make this the final action in the list, if true. Example:
ST:"[COND.In_1]:=TRUE;",BREAK:"[COND.In_2]",ST:"[COND.In_3]:=TRUE;"
means that the "COND.In_3" action is not carried out whilst the break
condition (IP_2 status) is true. See also ‘CONTINUE’
CONTINUE Boolean Go to the next action in the list only if true. Example:
ST:"[COND.In_1]:=FALSE;",CONTINUE:"[COND.In_2]",ST:"[COND.In_3]:=TRUE;"
means that the "COND.In_3" action is carried out only whilst the continue
condition (IP_2 status) is true. See also ‘BREAK’
DESC Integer Descend to the Agent with the specified ID number. A subsequent use of the
‘escape’ key will return to the current Main page. Example: DESC;50
DICT_ADD String: integer Moves the specified dictionary’s pointer by the value of the integer. Example:
DICT_ADD:"W":-2 decrements the dictionary W pointer by 2.
Omission of the integer results in an OIFL error.
DICT_SET String: integer Sets the specified dictionary’s pointer to the value of the integer. Example:
DICT_SET:"W":1 sets the dictionary W pointer to location 1.
DICT_PUT String:[integers] Replaces the dictionary entry, or entries, in the location(s) specified by the
String integer(s) with a new value. Example:
DICT_PUT:"W":1:5:"Help" places the word ‘Help’ into locations 1 to 5 of
dictionary W.
EVENT String:[Integer] Generate an event in the Event Log with string (max 16-characters) and
priority indicator (default = 1). Example:
EVENT:"Filling Started":2
NOTE String:[Integer] Generate a note (max. 24 characters) in the Event log with a priority indicator
as specified by the integer (default =1). Example: NOTE:"Agitator started":6
REPEAT None If this action is present in the list, the action is repeated for as long as the
button or touch area is touched. The repetition rate depends on the screen
update rate.
HA260749U005 Page 85
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
SKIP [Integer] Skip the current SPP program segment. If the integer qualifier is included then
this action will only be enabled for the specified segment number.
NOTES
The total length of all text in a list of actions must not exceed 200 Characters.
The action text specified may be a list of comma-separated variables, with each action being performed in
sequence starting with the leftmost and proceeding rightwards to the end unless an exit condition such as
BREAK is detected.
Within the limit above, there is no restriction on the number of Enables and Disables in a string.
An action is enabled only when all relevant enables are True and all relevant disables are False. An action is
disabled if any relevant enable is false and /or any relevant disable is true.
Page 86 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
12.4 A VARIABLE?
A Variable is a list of LIN function block, or System block, fields or subfields currently used in the LIN Database
(.dbf) (LIN Variable) or in the Target instrument itself (Instrument Variable), respectively.
NOTE
Each LIN Block has a specifically associated Data type.
NOTE
Each System block has a specifically associated Data type.
12.5 AN AGENT?
An 'Agent' is a software module that encapsulates User Screen functionality and 'drives' an area of the screen.
Agents are given names and IDs for reference.
A user-configured Page is an example of an Agent.
Target Instruments may have in-built default agents for commonly required displays, e.g. Alarm History, Clock
Set-up, etc. These have IDs of 1000 and upward.
IDs 1 - 999 is reserved for user generated Pages created using the User Screen Editor.
NOTE
Some instruments may contain built-in Agents (e.g. T2900). These are generally accessible via User Screen
touch-enabled objects.
HA260749U005 Page 87
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Tip!
Double-click an error or warning record to access the application needed to correct the problem.
Page 88 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
13 OTHER ITEMS
13.1 3D STYLING PROPERTIES PAGE
This dialogue applies only to the rectangle page object. Use it to add a 3-dimensional 'bevel' effect at the edges
of a rectangle drawn with the rectangle tool, making it appear either raised or lowered (recessed).
This effect is particularly useful if the rectangle is to act as a push-button (via the Touch Area Properties page).
To access the dialogue, right-click the object and select Properties…, from the context menu to pop up the
relevant Page Item Properties page. Then click the 3D Styling page.
The fields are:
13.1.1 Bordering
Style Select either the ‘Bevelled, Raised’ or the ‘Bevelled, Lowered’ styling from this list. In these
effects, the rectangle appears to be lit from the top-left of the display.
Depth Specify the depth of the bevel in this field, i.e. the amount by which the rectangle appears to
lie above or below the plane of the screen. Use the scrollable box to select a value from 0 to
10 (maximum depth). Entering zero, (the default) removes the 3D-bevel effect completely.
13.1.2 OK
Accepts the parameter changes and closes the dialogue.
13.1.3 Apply
Accepts the changes, and allows further configuration.
13.1.4 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
NOTE
By default, Variables are 'always visible' and 'never writable'. These settings can be edited via the
appropriate radio buttons and input fields.
13.2.1 Visibility
Always visible Use this radio button to indicate that the Page Item must always visible to any operator.
Visible if operator level is
Use this radio button, in conjunction with the additional fields beside, to indicate that the
Page Item can only visible to an operator with privileges that correspond to the defined
parameters. Use the relationship (=, >=, <) from the pull-down menu, and an access level (1-
4) from the spin button. The Page Item will only be visible to operators whose access level
corresponds to these parameters.
HA260749U005 Page 89
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
13.2.2 Writability
Never writable Use this radio button to indicate that the Variable linked to the Page Item is Read-Only.
Always writable but unreadable (Password)
Use this radio button to indicate that the Variable linked to the Page Item can be written to
if visible, but is only displayed as a series of asterisks (*), e.g. for password-entry use.
Always writable Use this radio button to indicate that the Variable linked to the Page Item can be written to
if visible.
Writable if operator level is
Use this radio button, in conjunction with the additional fields beside, to specify a minimum
operator access level for writing to the Variable linked to the Page Item, if visible. The Page
Item will be writable only by operators whose access level equal or exceed the level
specified in the field beside.
13.2.3 OK
Accepts the parameter changes and closes the dialogue.
13.2.4 Apply
Accepts the changes, and allows further configuration.
13.2.5 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
13.3.3 Description
Description A concise description of the Bitmap file, as stored in the target/bitmaps directory.
13.3.4 Add
Use this button to accept the changes and close this dialogue.
13.3.5 Cancel
Use this button to ignore the changes and close this dialogue.
Page 90 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
13.4.2 Colour
Colour swatch Shows a colour sample for the Colour specified by the User defined Name and Number
fields.
Edit Use this button to reveal the Colour editing palette. This will allow the User to change the
colour shown in the colour swatch, that will eventually be defined by the User defined Name
and Number fields.
13.4.3 Add
Use this button to accept the changes and close this dialogue.
13.4.4 Cancel
Use this button to ignore the changes and close this dialogue.
13.5.2 Dimensions
Width Shows the Width of the specified Font type, in pixels.
Height Shows the Height of the specified Font type, in pixels.
13.5.5 Add
Use this button to accept the changes and close this dialogue.
13.5.6 Cancel
Use this button to ignore the changes and close this dialogue.
HA260749U005 Page 91
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
13.6.2 Dimensions
Width Shows the Width of the specified Pane type, in pixels.
Height Shows the Height of the specified Pane type, in pixels.
13.6.3 Description
Description A concise description of the Pane, as stored in the target/bitmaps directory.
13.7.2 Add
Use this button to accept the changes and close this dialogue.
13.7.3 Cancel
Use this button to ignore the changes and close this dialogue.
Page 92 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
13.8.1 Line/Text
Weight Applies only to pixel-based Target Screen types. Used to change the line thickness (in pixels).
Foreground colour Used to change the line/text colour for the specified Target Screen type.
13.8.2 Fill/Background
Object is filled Use this checkbox to specify the fill parameters of the selected Page Item.
Background/Fill Use this pull-down menu to specify the background colour for the selected Text Page Items
or a fill colour for the selected geometrical Page Item.
NOTE
For lines, background colour applies only for character-based Target Screen Type.
13.8.3 OK
Accepts the parameter changes and closes the dialogue.
13.8.4 Apply
Accepts the changes, and allows further configuration.
13.8.5 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
NOTE
‘Underline’ Bar Chart types can grow only horizontally.
HA260749U005 Page 93
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
13.9.3 OK
Accepts the parameter changes and closes the dialogue.
13.9.4 Apply
Accepts the changes, and allows further configuration.
13.9.5 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
13.10.1 Enumerated
Tick this checkbox to enable the enumeration action of the bitmap object. If left unchecked, the bitmap
displayed will be the one specified in the Bitmap Properties dialogue. If ticked, the Bitmap Properties dialogue
is partially disabled to avoid conflicts.
NOTE
The Editor auto-validates entries, a red cross indicating an invalid field; a green tick a valid field.
Page 94 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
13.10.4 OK
Accepts the parameter changes and closes the dialogue.
13.10.5 Apply
Accepts the changes, and allows further configuration.
13.10.6 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
HA260749U005 Page 95
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
.bmp, .pcx, .emf, .gif, .png bitmaps can be used. Bitmap filenames must be in standard DOS 8.3 format,
(i.e. the 8-character filename is restricted to characters ’A’ .. ‘Z’, ‘a’ .. ‘z’, ‘0’ ..’9’, and ‘_’. No other
characters are permitted as they could cause OIFL (. ofl) file-parsing problems in the target instrument.)
To access this Properties page, right-click the object and select ‘Properties…’, from the context menu to pop-up
the relevant Page Item Properties page. Then click the ‘Bitmap’ page.
NOTE
If bitmap enumeration has been enabled (in the Bitmap Enumeration Properties dialogue), all fields and
buttons are disabled except for the ‘Monochrome’ and ‘Transparent’ checkboxes, which remain
effective.
13.11.1 Bitmap
Dictionary Click this radio button if the bitmap is language-dependent. The correct user-dictionary
reference number must be entered in the Bitmap field, see below).
Filename Click this button for a fixed bitmap specified by its filename (entered in the Bitmap field).
Bitmap For language-dependent bitmaps, enter the correct user-dictionary reference number in this
field, e.g. 'U123'. At runtime, the current user dictionary is consulted and the bitmap
referred to by the specified reference is displayed. For fixed bitmaps, enter the full path and
filename of the required bitmap file.
Monochrome Tick this checkbox if you want the bitmap to display in ‘black-and-white’ only, even if the
original bitmap is in colour.
Transparent Tick this checkbox to make the bitmap appear ‘transparent’, i.e. other page objects overlaid
by the bitmap will remain partially visible.
Browse… Click this button to search for a suitable bitmap file to enter in the Bitmap box.
13.11.2 OK
Accepts the parameter changes and closes the dialogue.
13.11.3 Apply
Accepts the changes, and allows further configuration.
13.11.4 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
Page 96 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
When only LIN Function Blocks can be selected (e.g. a GROUP block in the Trend Graph Variable properties
dialogue), ‘expand’ boxes are absent.
If the browser lets you select a block, click the required block icon or name to select it. The block name and
block category appear in the ‘Selection’ and ‘Type’ boxes, respectively, at the foot of the Browser window.
HA260749U005 Page 97
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
Page 98 HA260749U005
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
NOTE
The Editor auto-validates entries, a red cross indicating an invalid field; a green tick a valid field.
HA260749U005 Page 99
Issue 7 Dec 14
USER SCREEN EDITOR HELP MANUAL
13.16.4 OK
Accepts the parameter changes and closes the dialogue.
13.16.5 Apply
Accepts the changes, and allows further configuration.
13.16.6 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
NOTE
The variable type must be the same as that of the Colour Attribute controlling variable.
13.17.3 OK
Accepts the parameter changes and closes the dialogue.
13.17.4 Apply
Accepts the changes, and allows further configuration.
13.17.5 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
NOTE
If one or more Actions in a list is in the disabled state, then none of the actions execute when the object
is activated, even the enabled ones. For Button Page Items, the 'disabled' state is indicated by the button
legend being 'greyed out'.
13.20.2 OK
Accepts the changes and closes the dialogue.
13.20.3 Apply
Accepts the changes, and allows further configuration.
13.20.4 Cancel
NOTE
If the Variable is not recognised by the User Screen Editor, it may have to be entered manually.
BooleanEN Bit (0 or 1)
TimeNC Time-of-Day
(hh:mm:ss or hh:mm:am/pm)
Date Date
(dd:mm:yyyy) [plus International formats]
NOTE
NC = Not Compatible Colour Change Data Type.
BC = Compatible Bar Chart Page Item Data Type.
EN = Enumeration compatible Text Variable Page Item Data
Type (via the Enumeration Properties dialogue).
13.23.1 OK
Accepts the parameter changes and closes the dialogue.
13.23.2 Apply
Accepts the changes, and allows further configuration.
13.23.3 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
13.24.3 OK
Accepts the parameter changes and closes the dialogue.
13.24.4 Apply
Accepts the changes, and allows further configuration.
13.24.5 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
13.26.4 OK
Accepts the parameter changes and closes the dialogue.
13.26.5 Apply
Accepts the changes, and allows further configuration.
13.26.6 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
Tip!
Turning the Grid on will help when attempting to align Page Items.
NOTE
A Grid has the same effect when displayed or hidden.
Access the dialogue by clicking the Grid Settings button in the Placement Bar. The dialogue fields are:
13.27.5 OK
Click to close the dialogue and enable the grid settings.
13.27.6 Cancel
Click to close the dialogue without altering the existing grid settings.
NOTE
Limits do not affect the linked LIN Database Variables, only their display.
To access the dialogue, right-click the object and select ‘Properties…’ from the context menu to pop-up the
relevant Page Item Properties dialogue. Then click the ‘Limits’ tab. The fields are:
NOTE
The Variable type (i.e. boolean) must be the same as that of the linked Variable (i.e. boolean).
Instrument Variable
Use this radio button to select to link the Page Item with a Instrument Variable. Use the
Browse… button to display the Instrument Browser dialogue, to assist with locating the
required Variable.
NOTE
The Editor auto-validates entries, a red cross indicating an invalid field; a green tick a valid field.
13.28.2 Maximum
Use these fields in the same way as the corresponding ‘Minimum’ fields – see above.
13.28.3 OK
Accepts the parameter changes and closes the dialogue.
13.28.4 Apply
Accepts the changes, and allows further configuration.
13.28.5 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
13.29.1 Miscellaneous
Generate OIFL string for this page
A ticked check box indicates an OIFL string will be immediately generated for the selected Page Item and
appended to the OIFL file (that ultimately will be downloaded to the Target Instrument).
An empty check box indicates an OIFL string is either not generated, or, is deleted if the string for that Page
Item already exists in the file.
13.29.2 OK
Accepts the parameter changes and closes the dialogue.
13.29.3 Apply
Accepts the changes, and allows further configuration.
13.29.4 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
NOTE
The OIFL for the whole page can be inspected using the Page > Show OIFL Strings drop-down menu.
Beware…
The Page Set name MUST match the LIN Database (*.dbf) filename so the correct screens are displayed
when downloaded.
Failure to ensure this will result in downloading a Page Set to the Target Instrument, which may be
incorrect. This could cause problems with the operation of the instrument.
To resolve this problem,
Rename the Page Set. Select Edit > Properties > Page Set to display the Page Set Properties dialogue.
NOTE
If left in its pre-configured default value (blank) the default Status pane will be specified.
NOTE
This field can initially be left blank.
13.30.5 OK
Accepts and closes the configured Page Set dialogue. An empty Page Set window appears on the worksheet
entitled with the name entered in the ‘Name of new Page Set’ field.
NOTE
A Page Set can also be saved using the Save commands.
13.30.6 Cancel
Closes the dialogue without making any changes to the Page Set properties.
NOTE
The OIFL Page Item is not shown as an object on the actual Target Screen.
To access the page, right-click the OIFL Page Item and select ‘Properties…’ from the context menu to pop up
the Page Item Properties dialogue. Then click the ‘OIFL’ page. The fields are,
13.31.1 Display
Label Enter a suitable identifying legend to appear on the OIFL Page Item. This is not seen in the
OIFL code or anywhere else.
13.31.2 OIFL
Type in the OIFL code you want added to the output for the page.
OIFL code syntax is not described in this help file. Contact the manufacturer for further information.
13.31.3 OK
Accepts the parameter changes and closes the dialogue.
13.31.4 Apply
Accepts the changes, and allows further configuration.
13.31.5 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
13.32 PAGE
13.32.1 Page Item Actions - Example
RUN
This action runs the currently loaded SPP program.
ACK_ALL,GOTO:4
This list causes all alarms to be acknowledged, then jumps to the User Screen with an ID of 4. (It could also
jump to a built-in page if its ID is correctly specified, e.g. the Alarm History page, which has a default ID of
9010.)
ST:"[PID1.SL]:=12.34;"
This ‘Structured Text’ Action sets the function block input PID1.SL to 12.34.
ST:"[PID1.IN]:=NOT[IN];"
This ‘Structured Text’ Action creates a Toggle button. It causes a configured Page Item to toggle between the
Background colour and original appearance when activated. Add this text to the Touch Area page of the Page
Item Properties dialogue and ensure the Action radio button is defined.
ENA:"[MTR01.MODEACT.MANACT]"
This provides an ‘Enable’ instruction, used to enable an action. It causes a configured Page Item to remain
disabled until a specified condition is achieved. Add this text to the Touch Area page of the Page Item
Properties dialogue and ensure the Action radio button is defined.
When entering the 'Action' text, add the ‘Enable’ instruction and ‘Structured Text’ Action, separated with a
comma (,). The following example shows a motor start button, that will remain disabled unless the motor is in
manual mode.
Example
ENA:"[MTR01.ModeAct.ManAct]",ST:"[MTR01.Demand]:=1;"
NOTE
A Confirmation page appears if an appropriate Target Panel type was selected, e.g. svga v4.0 Auditor
(Pixel).
NOTE
User dictionaries have filenames such as _user.uyl (for single-language systems), or _user n.uyl (for
multilingual systems, where n = 0 to 9).
NOTE
The Off Screen Function Key (OSFK) pane is only available if the Target Screen type supports Off Screen
Function Keys.
Click the ‘OSFK’ tab to see the OSFK page of the dialogue.
Beware…
The Page Set name MUST match the LIN Database (*.dbf) filename so the correct screens are displayed
when downloaded. Failure to ensure this may result in downloading a Page Set to the Target Instrument,
which may be incorrect. This could cause problems with the operation of the instrument.
To resolve this problem rename the Page Set: Select Edit > Properties > Page Set to display the Page Set
Properties dialogue.
NOTE
This field can initially be left blank.
NOTE
If left in its pre-configured default value (blank) the default Status pane will be specified.
13.33.5 OK
Accepts and closes the configured Page Set dialogue. An empty Page Set window appears on the worksheet
entitled with the name entered in the Name of new Page Set field.
NOTE
A Page Set can also be saved using the Save commands.
13.33.6 Cancel
Closes the dialogue without making any changes to the Page Set properties.
NOTE
Space characters are valid password characters.
13.37.1 Instrument
Type Enter the required Instrument type name, i.e. T800, T820, T940, etc., used in the system.
Version Enter the Version of the Instrument type specified in the Type field, i.e. v4.7, v4.8, etc., used
in the system.
Tip!
Use existing table entries as a guide to clarifying the Instrument Type and Version.
13.38.2 New
Initiates the Target Panel wizard. This wizard makes creating a Target Screen type easy.
NOTE
Customised Target Screen types can be created. This is not recommended as each file (.uxt) contains the
unique default configuration of the selected Target Screen type.
13.38.3 Edit
Displays the Target Panel dialogue after selecting the Target Screen type that requires editing.
13.38.4 Remove
Deletes the selected Target Screen type.
13.38.5 OK
Stores the new Target Screen type specifications and closes the dialogue.
13.38.6 Cancel
Closes the dialogue without making any changes to the Page Set properties.
NOTE
Use the Set Password button to restrict access to the Target Panels dialogue. Any attempt to open this
dialogue will request a password to continue.
13.39.1 Font
Use Windows Fonts Use this checkbox to indicate that the defined Target Screen type supports Windows Fonts,
installed in the Fonts directory.
Font name Use this list to specify a required Font type for the specified Target Screen type.
Flashing Use this checkbox to specify a flashing text is required. Predetermined colour-pairs in the
instrument palette provide the flashing. The Editor shows only one of an alternating pair of
colours, i.e. does not flash.
Highlighting Use this checkbox to specify a highlighting text is required.
Select Font Shows the Font dialogue. This dialogue permits the selection of a specific Font already
installed in the Fonts directory.
NOTE
‘Left Centre’ and ‘Right Centre’ bias the alignment one character-width in the specified direction when the
string cannot be positioned in the exact centre.
Underlining… Click this button to access the target’s underline options. (Only for targets supporting
underlining.)
13.39.3 Text
Use Dictionary Use this checkbox if you want the text to change if the language is changed.
Dictionary Entry No Enter the correct user-dictionary reference number in this field, e.g. 'U123'. At runtime, the
current user-dictionary is consulted and the string referred to by the specified reference
number is displayed as the text.
NOTE
User dictionaries have filenames such as _user.uyl (for single-language systems), or _user n.uyl (for
multilingual systems, where n = 0 to 9).
13.39.4 OK
Accepts the parameter changes and closes the dialogue.
13.39.5 Apply
Accepts the changes, and allows further configuration.
13.39.6 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
13.40.2 OK
Accepts the parameter changes and closes the dialogue.
13.40.3 Apply
Accepts the changes, and allows further configuration.
13.40.4 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
13.41.3 Action
In this edit box, type a comma-separated list of User Screen Actions to be executed when the object is
activated. Up to 200 characters may be entered.
Typical user screen actions might include, setting a function block field to a specified value, acknowledging
alarms, and changing the programmer state.
13.41.4 OK
Accepts the parameter changes and closes the dialogue.
13.41.5 Apply
Accepts the changes, and allows further configuration.
13.41.6 Cancel
Closes the dialogue without making any changes to the Page Item Properties
13.42.2 OK
Accepts the parameter changes and closes the dialogue.
13.42.3 Apply
Accepts the changes, and allows further configuration.
13.42.4 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
13.43.1 Variable
Group FB Name Enter the tagname of the relevant GROUP LIN function block in this box, or click the
'Browse…' button to locate the LIN function block name in the associated LIN Database if
needed (see next).
NOTE
The Editor auto-validates entries, a red cross indicating an invalid field; a green tick a valid field.
Browse… Click this button to pop up a LIN Database Browser window. This lets you to select the
required GROUP LIN function block tagname from the LIN Database associated with the
Page Set (via the Page Set Properties dialogue), or the New Page Set dialogue.)
13.43.3 OK
Accepts the parameter changes and closes the dialogue.
13.43.4 Apply
Accepts the changes, and allows further configuration.
13.43.5 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
13.44 VARIABLE
The types of Variable that can be used are:
LIN Database field names. Example: PIC_004.PV
LIN Database Bitfields. Example: Dig_A.Out;
Aliases. Example: Dig_A.Out;
LIN Sequence step variables. Example: END_STEP.X
DATA ENTRY
For those instruments which support the facility, if a variable is selected which takes a file name as its value, the
'Data Entry' configuration area appears.
Offer file picklist when editing this variable
If this is enabled (ticked), then all the files on the instrument which match the search string
defined in the 'Filter' field (below), appear in a drop-down list at the instrument's operator
interface, when the associated text is touched.
Filter Allows the user to define the types of file which are to appear in the drop-down list on the
user screen. Multiple filters can be specified separated by commas. The '?' and '*' wildcards
can be used in the filter.
13.44.3 OK
Accepts the parameter changes and closes the dialogue.
13.44.4 Apply
Accepts the changes, and allows further configuration.
13.44.5 Cancel
Closes the dialogue without making any changes to the Page Item Properties.
14 DEFAULT PASSWORD
The default Password is,
kjsneckjn
15 INDEX
.bmp file .................................................................... 80, 104 Agents ................................................................................. 92
.dbf file.............................................................. 92, 119, 125 Alarm ................................................................................... 92
.emf file ............................................................................. 104 Align
.gif file ............................................................................... 104 left/right centre biased ............................................. 133
.ofl file ...................................................... 94, 119, 121, 125 Text ................................................................................ 131
.pcx file.............................................................................. 104 Align................................................................................... 131
.png file ............................................................................. 104 Align................................................................................... 133
.txt file ................................................................................. 87 Appearance
.uxp file ...................................................................... 16, 125 Properties dialog ........................................................ 100
.uxt file ...................................................................16, 19, 47 Appearance ...................................................................... 100
.uyl file...................................................................... 123, 131 ASCII key code .................................................................. 83
3D Styling Properties dialog .......................................... 95 Background colour .......................................................... 44
ABORT ................................................................................. 50 Background/Fill colour ................................................... 44
Access level Bar Chart
page ............................................................................... 123 fill direction ................................................................. 100
Access level ........................................................................ 22 linkable data types ....................................................... 92
Access level ...................................................................... 123 Properties dialog ........................................................ 100
Access Properties dialog................................................. 95 underline characters.................................................. 100
ACK_ALL .................................................................... 50, 122 Bar Chart ............................................................................ 92
Action Bar Chart .......................................................................... 100
Example......................................................................... 122 Barchart tool ..................................................................... 44
execute via touch area.............................................. 135 Bevel effects
supported ....................................................................... 50 depth ............................................................................... 95
syntax............................................................................... 50 Bevel effects ...................................................................... 95
writing ............................................................................. 50 Binary format .................................................................. 116
Action .................................................................................. 50 Bitmap
Action ................................................................................ 122 Enumeration Properties dialog ............................... 102
Action ................................................................................ 135 language-dependent ................................................. 102
Action qualifier Properties dialog ........................................................ 104
T# ..................................................................................... 64 selection ....................................................................... 102
Action qualifier ................................................................. 64 Bitmap ............................................................................... 102
Add/Edit Bitmap dialog .................................................. 97 Bitmap ............................................................................... 104
Agents Bitmap tool ........................................................................ 44
Alarm history ................................................................. 92 BlockRef .............................................................................. 92
built-in ............................................................................. 92 Boolean ...................................................................... 92, 102
Clock setup .................................................................... 92 Bordering effects .............................................................. 95
default ............................................................................. 92 Browser
preconfigured................................................................ 92 'expand' box ................................................................ 105
Multi-bit field selection (whole field) ....................... 105 Properties dialog ............................................... 123, 125
Name title .......................................................................... 22, 123
Page Set ............................................................... 119, 125 Page ..................................................................................... 22
Name ................................................................................. 119 Page ................................................................................... 123
Name ................................................................................. 125 Page ................................................................................... 125
New Page Page Item
dialog ............................................................................... 22 Edit ................................................................................... 24
New Page ............................................................................ 22 high/low display ranges ............................................ 118
Normalised ......................................................................... 92 linking variable to ...................................................... 138
NormHigh ........................................................................... 92 Properties dialog .......................................................... 24
NormLow ............................................................................ 92 visibility ........................................................................... 95
NULL .................................................................................... 50 writability ........................................................................ 95
Number accuracy ........................................................... 116 Page Item ........................................................................... 24
Offer file picklist when editing this variable ........... 138 Page Item ........................................................................... 95
OIFL tool ............................................................................. 44 Page Item ......................................................................... 118
Operator access level ...................................................... 95 Page Item ......................................................................... 138
Operator InterFace Language Page Properties dialog - OSFK page .......................... 124
.ofl file .................................................................. 119, 121 Page Set
adding code ................................................................. 121 associated target panel ............................................. 125
Properties dialog ........................................................ 121 creating new ................................................................ 119
Status pane .................................................................. 125 DB file location ........................................................... 125
string generation ........................................................ 119 name .............................................................................. 125
viewing strings ............................................................. 121 Properties dialog ........................................................ 125
What is? .......................................................................... 94 verify ................................................................................ 48
Operator InterFace Language ....................................... 94 Page Set .............................................................................. 48
Operator InterFace Language ..................................... 119 Page Set ............................................................................ 119
Operator InterFace Language ..................................... 121 Page Set ............................................................................ 125
Operator InterFace Language ..................................... 125 Pane
Operators and Functions associate with page .................................................... 125
Structured Text ............................................................. 68 popup ..................................................................... 22, 125
Operators and Functions................................................ 68 select ............................................................................... 22
Padding with leading zeroes........................................ 116 Pane ..................................................................................... 22
Page Pane ................................................................................... 125
access level ........................................................... 22, 123 Panel
built-in ........................................................................... 123 Target ............................................................................ 125
decription ....................................................................... 22 Panel .................................................................................. 125
description ................................................................... 123 Password entry format.................................................... 95
home ............................................................................. 123 Preview .............................................................................. 128
legend..................................................................... 22, 123 Program profile .............................................................. 128
name & ID ............................................................. 22, 123 Program Profile tool ........................................................ 44
new .................................................................................. 22 Properties
Contact Information
Eurotherm Head Office Worldwide Offices
Faraday Close www.eurotherm.com/global
Durrington
Worthing
West Sussex
BN13 3PL
Eurotherm, the Eurotherm by Schneider Electric logo, Chessell, EurothermSuite, Mini8, Eycon, Eyris, EPower, EPack nanodac, piccolo, versadac,
optivis, Foxboro, and Wonderware are trademarks of Invensys plc, its subsidiaries and affiliates. All other brands may be trademarks of their re-
spective owners.
All rights are strictly reserved. No part of this document may be reproduced, modified or transmitted in any form by any means, neither may it
be stored in a retrieval system other than for the purpose to act as an aid in operating the equipment to which the document relates, without the
prior written permission of Invensys Eurotherm Limited.
Eurotherm Limited pursues a policy of continuous development and product improvement. The specifications in this document may therefore
be changed without notice. The information in this document is given in good faith, but is intended for guidance only.
Eurotherm Limited will accept no responsibility for any losses arising from errors in this document.