Documente Academic
Documente Profesional
Documente Cultură
3. Configuration ___________________________________________________________________ 21
Introduction 21
Network license 23
4. Projects ________________________________________________________________________ 25
Project Manager 25
Project Manager 25
Menu commands 26
Dialog New project 27
Dialog Project selection 27
Dialog Runtime configuration 27
Dialog options 28
Dialog Cross reference 29
Dialog Rename elements 30
iii
Manual AMS Asset Graphics 5.4
Standard programs 30
Runtime 31
Runtime program 31
Using 31
Project administration 31
Creating a new project 32
Configure a default project 32
Inserting programs in the program list 32
Copying project files 32
User management 33
Overview password protection 33
Dialogs 33
Using 35
Password protection 35
Define operator rights 35
Define operator, password and lifetime, assign rights 35
Define operator right for input objects 36
Define user right for the acknowledgment in the Eventjournal 36
Define password protection of editors 37
Replication 37
Configuring a database replication 37
Requirements for an successful replication 38
AMS Asset Graphics database tables 39
Dialog Add/delete tables 39
Dialog Select destination 39
Dialog Select database 39
Database Replication Runtime 40
5. Graphic ________________________________________________________________________ 41
Graphic Editor 41
User interface 41
User Interface 41
Tree view 42
Shortcuts 42
Dialogs 43
Dialog Action 43
Dialog Shortcut 43
Search element 43
Dialog Rename elements 44
Dialog File selection with preview 44
Toolbars 44
Alignment commands 44
Toolbar Alignment 45
Toolbar Input 45
Toolbar Colors 45
Toolbar Language 45
Toolbar Symbol 46
Toolbar Draw 46
Toolbar Zoom 46
Menus 47
Menu commands 47
Menu File 47
iv
Table Of Contents
Menu Edit 48
Menu View 49
Menu Alignment 49
Menu Properties 49
Menu Window 49
Editor 50
Dialog Properties Editor 50
Tab Insert (Properties Editor) 50
Tab Object selection (Properties Editor) 50
Tab Grid (Properties Editor) 51
Using 52
Select objects 52
Selecting objects 53
Arranging objects 53
Resizing objects 54
Grouping objects 54
Zooming a picture 54
Define a flashing color 54
Selecting a polygon or a polyline to change its form 55
Create Metafiles from selected objects 55
Working with symbols 55
Objects 56
Overview Objects 56
Working with different screen resolutions 57
Line, Rectangle, Round rectangle, Ellipse 57
Polygon, Polyline 57
Text 58
Number 58
OLE-objects 58
Graphic 60
Group 60
Button 60
Graphic Button 61
Checkbox 61
Radio Button 61
Scrollbar 61
Slider 62
Window 62
Link-symbol 62
Special VBScript-functions 63
Dialogs 67
Using a property dialog 67
Tab Graphic 67
Tab View options 68
Tab Position 69
Tab Size 70
Tab Rotate 71
Tab Color 72
Tab Filling 73
Tab VBScript 73
Special dialogs 74
Tab Action (OLE-OBJECT) 74
v
Manual AMS Asset Graphics 5.4
vi
Table Of Contents
vii
Manual AMS Asset Graphics 5.4
viii
Table Of Contents
ix
Manual AMS Asset Graphics 5.4
x
Table Of Contents
xi
Manual AMS Asset Graphics 5.4
xii
Table Of Contents
xiii
Manual AMS Asset Graphics 5.4
xiv
Table Of Contents
xv
Manual AMS Asset Graphics 5.4
xvi
Introduction
AMS Asset Graphics is task-oriented organized. With editor program a special task is configured, and the
task is exercised in the corresponding runtime program.
E.g. you define in the Graphic Editor the pictures incl. the user interface, the corresponding runtime
program is the Visualization (see AMS Asset Graphics functionality).
The Project Manager has a central function for the configuration. Keep it open during the complete project
phase, all editors as well as the runtime program can be started from this program.
With a double-click on a document, the relevant editor will be started and the document opened
for processing.
In addition the Project Manager offers a toolbar Development for starting the individual editors.
If you want to test your project during runtime, save the documents in the editors, switch to the Project
Manager and start the runtime program (at the easiest via toolbar Runtime).
Program description
Start working with AMS Asset Graphics
Program description
AMS Asset Graphics for Windows is a process management system for IBM compatible computers. It
consists of a development environment and a runtime program. The runtime program receives and
processes data of external devices. These data are represented on the screen. However, AMS Asset
Graphics does not only visualize data, at the same time an operator may enter data, which will be sent to
the process via the process assignment. By means of this, the operator is able to control the process.
1
Manual AMS Asset Graphics 5.4
The function pallet is rounded off with options like Eventjournal, data storage, trend charts and Recipe
Runtime. An online debugger can display and modify the contents of variables during runtime.
Due to that, there are various possibilities to display and record data, to archive them and to make them
accessible for further processing. Thus, AMS Asset Graphics also takes over the functions of a process
control computer.
Design and function of the runtime are defined in the development environment:
The process pictures are drawn and animated with in the Graphic Editor. However, they can also be drawn
with any other Windows Graphic Editor, copied into the clipboard and then inserted in AMS Asset
Graphics.
Process dependant Objects with dynamic properties such as position, size, color, rotation and filling levels
are basic elements of the process visualization.
The operation, which shall be possible during runtime (data input, function keys, password protection etc.),
can be defined freely and independently for every picture.
The dynamic objects are linked to the current process, e.g. a control device, via process assignment or
OPC. For the connection to the process there are drivers for different PLCs, bus systems and data
acquisition cards. The list of available drivers is being extended continuously.
2
Introduction
Data-elements contain numbers or texts, i.e. values. These values are represented as dynamic properties of
objects. There are six different dynamic properties: Position, Size, Filling level, Color, Rotation and script
functions. These properties can be assigned to the objects as described in table Properties of graphic
objects.
3
Manual AMS Asset Graphics 5.4
See also
Using a property dialog
It is possible to present a value in different ways i.e. to combine a data-element with various objects and to
assign it different properties. It is e.g. possible to indicate a temperature value as a numeric value and as a
filling level in a thermometer graphic, which means that a data element will be shown as a dynamic number
and as rectangle or polygon with the dynamic property Filling.
Instead of data-elements certain entry fields can also be filled with constants.
Trigger concept
So called triggers are used to start actions or to notify events. Every num-element can be used as trigger.
An action, to be triggered, is for example to start a data transmission to a device (e.g. to an PLC). A
successful data transfer can in turn be reported as event.
So called control-triggers start actions, while so-called notification-triggers signal events.
Type Description
Control-trigger Actions, for which a control trigger is defined, (e.g. sending data to the process) are
started, if the value of the corresponding element changes.
Notification- Events, reported to the system, change the value of the corresponding element.
trigger
Example 1
The data-element SEND shall be modified via a function key. Since data-element SEND has been defined in
the process assignment as control-trigger for sending, a single data transfer to the PLC will be performed.
Example 2
In the same process assignment table the data-element READY was defined as notification-element to
signal the end of sending. When the system has finished the sending operation to the process, the trigger
READY will be changed.
READY can be used again at another place as control-trigger. With the help of the trigger concept it is
possible to start an arbitrary number of actions, depending on each other.
4
Introduction
If the number of digits and fractional digits have not been defined, per default the number will be output in
form of an 8-digit floating point number. Floating point numbers, which cannot be displayed due to their
number of digits, will be output as exponential numbers.
If the character $ shall be used in the text, $$ must be entered.
Example
A value of 12.3 with $TEMP:5:2 will be displayed as 12.30 and with $TEMP as 12.3.
AMS Asset Graphics uses internally the current color resolution (adjusted under the operating system). The
required minimum color resolution amounts to 256 colors.
For a project you can define up to 8 flashing colors. The flashing colors are available at every color
resolution.
The color selection is made from a palette of 16 primary colors, 224 extra colors and the 8 flashing colors.
5
Manual AMS Asset Graphics 5.4
Example
Object type Rectangle can change its position, its size, its filling level and its color and it can be
assigned to script functions. However, it cannot be rotated.
Installation
AMS Asset Graphics is dongle protected. If you want to develop AMS Asset Graphics runtime programs on
several computers at the same time, you need additional licenses.
Dongles are available as USB, parallel, PCI or PCMCIA device.
Note During the setup the dongle has to be disconnect from the PC.
Beside the installation relating the hardware, a software installation of the dongle has to be made as well.
For this purpose you have to enter the data of the license document, which you have received together with
the software into tab License in program Configuration.
USB dongle
After the setup you can connect the USB dongle to the PC.
The integrated LED is on, if the dongle is identified by Windows as an device.
6
Introduction
See also
Network license
7
General operation
Overview
Here you find the descriptions of the following functions:
General
AMS Asset Graphics user interface
Using a table
Using dialogs
Using the right mouse button
Menus
Menu Edit
Menu Views
Menu Window
Menu Language
Menu ?
Further elements
File selection
Element selection (cross reference)
Color selection
PMS Value Control
Select type
Tab Print
Above the character or table window there is a title bar which extends over the complete window width and
which shows the name of the editor.
If you have opened a file, the title bar shows the current document and the project name round brackets.
In the top right part of the title bar you can see window-like buttons to minimize and maximize the screen
size or to restore and close the window.
A further range in the top part of the AMS Asset Graphics editors (directly below the title bar) is the Menu
bar. The menu bar contains commands which can be accessed by selecting the menu names.
Below the menu bar there is a number of buttons. This element is called toolbar and permits the fast access
on many of the functions, frequently needed, which can also be found in the menu bar.
The Status bar is shown in the bottom part of the windows of the AMS Asset Graphics editors. It provides
information about the currently selected object or the function just executed.
If you open a project document, another window will be opened to edit the document. In some editors these
windows contain an own toolbar with table specific functions.
9
Manual AMS Asset Graphics 5.4
If you would like to see different parts of your process picture or your tables, which do not fit in your window,
use the Scrollbars.
Using tables
Tables are used in every editor to enter data for the configuration of the process visualization.
Selection of the active cell
Click with the mouse on the cell which contents shall be edited. With the help of the scrollbars the visible
part of the table can be moved.
You can move within a table with of the following keys:
Key Description
The active cell is moved to the right or to the left by one position. If the new, active cell is
not completely visible, the displayed area will be shifted correspondingly. In the first or last
column the corresponding button has no function anymore.
If the cell is being edited, with these buttons the cursor can be moved to the right or to the
left by one character.
The active cell is moved up or down by one line. In the first or last line the corresponding
buttons have no functions anymore.
Page These keys can be used to scroll the table page for page.
Page
TAB The active cell is moved one position to the left or to the right. If the new, active cell is not
Shift+TAB completely visible, the displayed area will be shifted correspondingly.
ENTER The editing process in the active cell is terminated. The cell in the next line is now the
active cell.
Del Deletes the complete contents of the active cell.
Esc, The previous content of the active cell will be restored.
CTRL+Z
CTRL+Alt+ With this key code the contents of the current cell is transferred into the cell above or below
CTRL+Alt+ of this cell.
Tabs
At some tables, the number of definitions is so large that the table is subdivided into several tabs. The active
page can be selected with tabs at the top of the table. The tab for the current page is shown pushed down.
As long as the edit mode is active, no tab can be selected before this mode is terminated again. The tabs
are selected with the mouse or with the key codes Ctrl+Tab or Ctrl+Tab+Shift.
Key Description
CTRL+Tab With these key codes you select the current tab of the table. With Ctrl+Tab you
CTRL+Shift+Tab move one tab to the right. At changes to another tab, the current line will remain the
same. By pressing button Shift in addition, you will move one tab to the left.
Having reached the last tab and if you would like to go on, the program will move to
the first tab again (or vice versa).
10
General operation
Option Description
Search for Enter a search text or a part of the search text here.
Match whole word If this field is activated, the search text must agree with an entire word and not
only only with parts of it.
Match case For the search procedure, the case of the text is taken into account.
Only in the current If this field is marked, the text will be searched only in the current column.
column
Search direction Set the desired search direction here.
The search starts in the cells of a line starting from left to right, it will then continue in the next line
(depending on the search direction) until the search text matches to the text of a cell.
With button F3 the search will be continued, starting at the current cell.
Option Description
Search for Enter the search text here.
Replace with Enter the new text, to replace the search text.
Match case Searches for case-sensitive occurrences of a word or phrase. This limits the search so it
only locates text that matches the upper- and lowercase characters you enter.
Replace in To define the range, where the text replacement shall be performed.
Complete All cells of the table are processed.
table
Current If this field is marked, all cells of the current column are processed.
column
Selected cells Only the selected cells will be processed.
11
Manual AMS Asset Graphics 5.4
Enter the parameters for the automatic filling of cells that are placed in a table one below the other.
Option Description
Fill text Type in the text, which shall entered in the active cell or the cells below in a column. As wild-
card for numnbers you can enter a ? here. When closing the dialog with OK, the wild-
cards will be replaced by the number value, defined with number, start value and
increment. Max. 10 question marks in series may be used in each filling text.
Number Type in the number of cells, which shall be set with the filling text.
Start value Type in the value, which replaces the question marks in the first cell.
Increment Type in the value by which the start value is increased after one replacement. Negative
values are possible as well.
Example
If you enter a Fill text "Test???_??, with Number 3, Start value 10 and Increment 1, the current cell
as well as the both following cells will be set with the values: "Test010_10, Test011_11 Test012_12".
If an error occurs during the filling procedure, e.g. due to an invalid element name, the process will
be stopped.
Using dialogs
In a dialog you get information about settings and can change them.
The data input in a dialog is terminated with the buttons OK, Cancel and Close. With OK the changes of the
dialog are accepted, with Cancel they will be rejected. Key ESC has the same function as the button
Cancel. If dialogs can only be terminated with Close their data will always be saved.
Button Apply accepts the entered data and applies the result directly, without closing the dialog. If the dialog
is then closed by Cancel or ESC, the changed data will remain accepted.
Color buttons
Buttons that are used to select colors are called color buttons.
If you press a color button the dialog Color selection appears.
12
General operation
See also
Using a property dialog
Menu Edit
Cut
With this command the highlighted data of the document and copied into the clipboard and then deleted.
Copy
This command copies highlighted data into the clipboard.
Paste
With this command, a copy of the clipboard contents is copied at the current cursor position into the
document.
13
Manual AMS Asset Graphics 5.4
Insert line
With this command, a new line will be inserted previous to a selected table line.
Delete line
With this command, a selected table line is deleted.
Properties...
This command opens a dialog to configure the properties of the current document or object.
Menu View
Optimize columns
Use this command to optimize the width of columns in a table:
Without the SHIFT-key being pressed, the maximum available place will be used for the display,
all columns will then be visible.
When you press the SHIFT-key at the same time, every column of the table will use only the
maximum required place to display the complete cell text.
Always on top
As long as this option is on the application is always visible in the foreground.
Visualization
With this command, the visualization window can be switched to the foreground.
Menu Window
Cascade
Use this command to show the opened windows in an overlapping arrangement.
Tile windows
Use this command to arrange the opened windows beside each other.
Arrange icons
Use this command to arrange the symbols of the minimised windows in the bottom area of the main window.
Menu Language
Select the language for the currently opened program.
14
General operation
Menu ?
In this menu you find the following commands:
Help topics
With this command, the online help of the editor can be called. The online help can also be called at any
time with the key F1.
If a dialog is active when pressing F1, the help topic for the current dialog will be displayed (context sensitive
help).
About
Select command About...in menu ? to open the dialog AMS Asset Graphics.
This dialog displays general information about the program and AMS Asset Graphics.
The version number shows the version number of the program.
The license field displays the serial number and the version name (MINI, MIDI, MAXI) for the quantity of
licensed variables.
Below the Copyright notice you find a link to the Machinery Health Management internet address.
Before contacting Product Support, first please note the version and serial number and the version name to
permit a fast handling of your problem.
Option Description
Project In this list field you can select the project, where the file to be selected is stored.
All files of the selected type, contained in this project, are displayed in the file selection field
below.
File The name of the file, selected in the file selection field, is shown here.
name The name of the file can also be entered via the keyboard.
File type The file type can be selected here. Generally, a certain file type is preset, depending on the
function that was used to open the dialog.
15
Manual AMS Asset Graphics 5.4
You open a reference list by clicking in a dialog with the right mouse button on an entry field. Edit fields with
an element selection have a blue background, when they have the input focus.
The element selection is also possible from tables, however, in this case the background will not be shown
in blue.
Option Description
Type Here you select the document type. If you are working e.g. with the Data Storage Editor, it is
useful to select type Process assignment to have access on the elements read from a PLC.
Alternatively you may select type Runtime elements to show all used elements.
Document Here you select a special document.
Data type Here you select with data type Num the display num-elements and with data type Text the
display of text-elements.
Elements Select the wanted element from the list with a double click or with the command OK.
See also
Selecting elements from the reference list
16
General operation
You can also use transparency. Select the small, white, crossed out box in the top right corner. If you
use the transparent color e.g. as fill color for a rectangle, the inner area will get transparent that way. At the
use of the transparent color as frame color, the frame will be drawn with dash size 0 and will thus
be invisible.
Flashing colors are colors which change their color with a fixed clock rate. To define the flashing colors for a
project use menu command Project | Flashing colors... in the Graphic Editor.
Flashing or transparent colors are not always selectable, e.g. the text color of a text object cannot be
transparent.
With keys ESC or button Cancel the dialog will be closed without applying a color.
Note If your Windows system is adjusted with less than 256 colors, only the 16 primary colors can be
selected.
The element name can be entered directly or simply selected by clicking Element selection with the right
mouse button.
(This is the default setting with an activated control)
After activation of button Edit Script a dialog to edit the VBScript function will be called. If this function
does not yet exist, it will be generated. The text cursor will be set automatically to the corresponding
function.
17
Manual AMS Asset Graphics 5.4
Tab Print
In this tab you define parameters for printing. The printout is configured with the AMS Asset Graphics Report
Designer. In the Report Designer you can use various variables and fields. You can move this variables with
the mouse in the page.
If there shouldn't be a report definition yet, then the program uses a default configuration.
Option Description
Layout Name of the report definition file. Standard is DefaultDiagramLayout. This file is
always available.
New With this function you open a new layout file.
You will be asked, whether you would like to create the new file from the copy of an
existing file. If yes, you must select the source file. If no, the new file will be prepared by
the program with a default contents.
The AMS Asset Graphics Report Designer will be started with the new layout file.
Edit With this command you open the selected layout for editing.
Start Here you can enter a data-element used as a trigger to start printing.
Destination Enter here a text-element (or VBScript) to configure the destination for printing. You
must use the following syntax:
Destination;Parameter
With Destination you define the destination or the format. Parameter configures a file
or a device. If there is no parameter specified a default device will be used or a file
dialog will be opened.
See samples.
Printing Here you configure, if the background color shall be used for printing. Note This option
background is not always available.
color
Texts In this table you can configure additional variables for printing.
Parameter Here you can enter variables, which can be used in the AMS Asset Graphics Report
Designer as variable.
Text The text entered here is used for the parameter. You can also use variables in the text.
18
General operation
Text Description
PICTURE_MULTITIFF;c:\report.mtiff Printing in the file report.mtiff (Multi TIFF).
RTF;c:\report.rtf Printing in the file report.rtf (Rich Text Format.
TTY;c:\report.prn Printing in the file report.prn (Binary Printer File).
TXT;c:\report.txt Printing in the text file report.txt. Only the content of tables will be
printed.
XLS;c:\report.xls Printing in the file report.xls (Excel XLS).
XML;c:\report.xml Printing in the file report.xml (Excel XLM). Note If necessary
several files are created.
19
Configuration
Introduction
The program Configuration is a dialog-based application.
The program has several tabs, where you can make cross-project settings for the PC.
Tab License
On tab License you can enter up to 99 dongle entries with different parameters. The entries are saved in
section Dongle in the file WINVISU.INI (in the program directory).
Option Description
Entry number Enter the number of the entry here. Entries of 1 to 99 are possible. You
create a new entry by typing in a number that has not yet been used and
pressing button New.
Serial number The serial number is in the range of 40000000 to 49999999 (8-digit).
Version At present the version number of AMS Asset Graphics is 5.00 (4-digit).
Program options Here the program options are defined (8-digit).
Number of num-elements, Here you must enter the max. number of useable num- and text-elements (5-
Number of text-elements digit).
Number of network stations Here you must enter the max. number of network stations (4-digit).
Password With this text, the inputs will be verified (12-digit, only numerics or small
letters).
The information, necessary for an entry, can be found in the license document, you have got with the
delivery.
Option Description
Active Set this option to activate the network license.
Server name or IP Enter the name of the computer or the IP address of the computer, where the
address network dongle is installed.
Port Enter a free port number of the computer with the network dongle. If necessary, ask
your network administrator for a free port.
The function description for the network license can be found here: Network license
21
Manual AMS Asset Graphics 5.4
Tab Directories
On tab Directories you can configure directory locations.
Option Description
Global data The (global) data directory is defined here.
directory
Use local data Several alternatives to organize a network project are possible.
directory If a local data directory shall be used, you have to activate the option and enter the
name of the local data directory into the field below.
It will be checked, whether the directory belongs to a local fixed disk.
Tab Network
On this tab the settings for the network mode are defined.
Option Description
General
Station number Here, you enter the network station number for the current workstation. Via this
number the station will be addressed at the definition of the network project.
The master will have station number 0.
Master The computer name or the IP address of the master is entered here (in the
redundancy mode the primary master).
Port For the data communication, a port must be set. The port number must be the same
on all network computers!
Redundancy
Active Here it will be defined, whether the redundancy mode is active. If this option is not
switched on, the stations will operate with only one master.
Second master Here you can define, whether this computer is the secondary master (station number
is 0).
Secondary master The computer name or the IP address of the secondary master is entered here.
Redundant data The (global) data directory for the access on the secondary master must be entered
directory here.
See also
AMS Asset Graphics directory structure
Network license
Opening a network project
Set up redundancy mode
22
Configuration
Network license
When using a network license the license will be requested from a license server via the network. The
number of stations (computer, on which an AMS Asset Graphics program is running) is configured on tab
License.
Editor and runtime programs can be run on the computer with the network dongle and as well on other
computers in the network. The computer with the dongle is always included in the number of stations.
On tab Floating license the settings for the network license and for the computer with the network dongle will
be made.
The request of a network dongle will only be executed, if no local dongle could be found. If a program has
read the network dongle, it will always use the network dongle until the program is started anew.
For using network licensing the network protocol TCP/IP is absolutely necessary.
If the dongle cannot be read by the runtime for three hours, the system will be terminated after another three
hours. The system data-element _LicenceError is set on 1, if the dongle couldn't be read for 3 hours.
23
Projects
Project Manager
Project Manager
The Project Manager offers the user of the development version a user interface, with this help he can
manage a project Thereby, several projects can be opened at the same time. By means of this user
interface it is possible to copy or delete single files from project to project. In the file view, the single files are
displayed with small and large symbols or in form of a list with all details, in the same way as with the
Windows explorer.
With a double-click on a document the associated editor is started and the document opened for editing.
Moreover, the Project Manager offers a toolbar Development for the start of the individual editors and a
toolbar Runtime to start the Runtime and the Debugger. Button Stop all runtime programs will stop all
active runtime programs.
Via the tree view of the Project you can define, which files shall be shown to the right of the file view. When
the entry All files is activated, all files of the project will be shown. By selecting another branch, the display
of files will be filtered to a certain AMS Asset Graphics program.
By double-clicking on a branch, the corresponding editor will be started and the last opened documents are
opened automatically. The reloading of the documents can be disabled by pressing the Shift-key at the
same time.
In the file view the files of the current project are displayed.
By clicking on the corresponding title field, the files will be sorted in ascending or descending order
according to name, file type, date of the last change or file size.
With a double-click on the file symbol, the related editor or the corresponding Windows application will be
opened for editing.
You can refresh the file view with the key F5.
See also
Menu commands
Getting started with AMS Asset Graphics
Password protection
Recording operator actions and system messages in the activity log
25
Manual AMS Asset Graphics 5.4
Menu commands
The following non-standard commands are available in the Project Manager:
Menu File
Command Description
New See Creating a new project.
Save as After the choice the dialog Project save as appears.
If option Copy all project files is set, not only the runtime configurations will be stored in
another project, but also all project files.
See also Copying project files.
Delete With this command you can delete a complete project. After the choice the dialog Project
selection appears.
The data from the project folder will be deleted irrevocably.
Menu Edit
you find the commands Copy, Paste and Delete. With these commands you exchange project files via the
clipboard between different projects or with other applications: (e.g. Windows Explorer). These commands
can also be found in the context menu of the file view (click the right mouse button).
In addition, the commands Select all and Invert selection are available.
Menu View
The following four commands will be used for changing the display in the file view. The file view presents the
files with big and small symbols and in form of a list with and without all details. These commands can also
be found in the context menu of the file view (click the right mouse button).
With the command Arrange icons you can arrange the icons according to Name, File type, Last change
and Size.
With command Refresh the display will be redrawn.
Menu Configuration
offers the possibility to configure different items of the program:
Runtime...
Password protection
Activity logging
Touch panel...
Database replication
Menu Options
offers the possibility to get a sight in the Cross reference list or rename data-elements in all project files.
See also
General Operation
26
Projects
See also
Creating a new project
Option Description
Network options
Network project Activate this option to define the current project as network project. In the selection
field to the right of it, you define, for which station the program list, defined below, shall
apply and whether it applies for the master.
Copy >> Click this button to copy the settings of the current program list to the program list of
those station or master that was selected to the right of the button.
Program list The program list offers space for any number of program entries. The programs will be
started by the Runtime-program in exactly the same order as defined in the list.
There are several possibilities, to entry programs into the program list, see Insertion of
programs.
Program Enter the name of the program, that you want to use. When it is not stored in the same
directory as the AMS Asset Graphics programs and when it is also not stored in a
search path, you have to enter the complete path including the drive letter.
Note Look out, that the specifications are valid. A wrong spelling or not available
programs may cause problems at runtime.
Comment Enter here descriptions for the corresponding programs, or change the comment for
the standard programs.
27
Manual AMS Asset Graphics 5.4
Option Description
Initialization Enter here an num-element, which is set on 1 by the runtime program, when starting
the corresponding program. The runtime program will start the next program not
before this element was reset on 0 again. By this means, the start of the different
programs can be synchronized.
View options Here you define the displaying option for a program. For this, click with the right
mouse button in a field of this column. Dialog Display options will be opened.
Standard program From this list you can select a standard program.
Options... Press the button to open the dialog Options.
Dialog options
In this dialog you can set a few runtime options for a project.
Option Description
Runtime
Block Set this option to disable the key combination ALT+F4 for all runtime programs. With this, you
Alt+F4 prevent the abortion of single runtime programs with this key combination. Even with the
system menu, the runtime programs cannot be aborted in this case.
Disable With the help of this function, unwanted user activities can be prevented.
task Function Disabling task switch deactivates all key functions, that allow a change to another
switch program, such as ALT+Tab and Ctrl+ALT+DEL.
The disabling will be started, after the runtime has started all programs. The disabling
function will be switched off again, when the runtime (LZ32.EXE) was terminated.
Important: Task switches with the mouse will further be possible. Thus, the task bar must not
be accessible by mouse and must be covered (e.g. by the visualization window).
The shortcut Ctrl+ALT+DEL can be disabled, when running under 32bit operating systems:
To enable this feature you have to perform following steps:
1. Copy InvGina32.dll into the System32-directory.
2. Create the entry GinaDLL (as character sequence) in the registry with value
'InvGina32.DLL' in subkey
\HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\Winlogon
After that, a restart of the operating system is required.
Attention Make a backup before you change the registry.
Note The shortcut Ctrl+ALT+DEL can't be disabled, when running under Windows Vista,
Windows 7 or an 64bit operating system..
28
Projects
Option Description
Update Per default, the update time during the runtime is predefined on 500 ms. It can be changed
[ms] with this option in the range 100 to 1000 ms. Enter the desired value either directly with the
keyboard or use the arrows to the right of the entry field.
Activity logging runtime programs
Start Enter here the log level, which the runtime programs will be given at the start/stop.
Stop
VBScript
Debugging Mark this option, to debug your VBScripts. The procedure for debugging your VBScripts is
active described in chapter VBScript debugging.
This dialog displays in a table the use of data-elements in a project. The table is sorted after data-elements
in ascending alphabetic order, capital letter are before small initial letters, system elements, that start with an
underline, are below the capital letters.
After a double-click on a cell, all project files will be shown in dialog Display documents, where the element
is used. The element will be shown in the title of the 1. column. With a double-click on a project file, the
related editor is started and the document loaded.
29
Manual AMS Asset Graphics 5.4
The renaming action is started with command Rename. In project root directory, the file Rename.xml is
generated with the renaming information. After this, the editors are called, which then the renaming. During
this action, the button is disabled.
With the command Refresh, the element list is build anew. Entries, which were already carried out, will be
lost.
See also
Using tables
Standard programs
The AMS Asset Graphics standard programs include the following programs:
30
Projects
Runtime
Runtime program
With the help of the runtime program, all programs, entered in the Program list of the Project Manager, will
be started.
When a program cannot be started (not enough memory, wrong path indication etc.), you will be asked in a
dialog, whether the initialization shall be aborted or continued without this program.
When the Runtime Program is terminated, all other runtime programs will also be stopped.
Starting of a project
Open the desired project in the Project Manager. Select then in the toolbar Runtime the command
Runtime.
Using
Project administration
With the Project Manager you can manage projects, like directories and files are managed with the Windows
explorer. It is possible to copy single files from project to project or to delete them. The single project files
are displayed with small and large symbols or in form of a list with all details.
If in the tree view a program option is selected, only the regarding project files are displayed (filtered view).
A double-click on a program option starts the accompanying editor.
A double-click on a document starts also the editor. In this case the last used documents are not loaded
automatically.
31
Manual AMS Asset Graphics 5.4
Note If you have to edit several similar projects, project files which are identical in every project, can be
deposited in the default project, so that they are already available when opening a new project .
See also
Configuration of a default project
32
Projects
User management
See also
Password protection (Step-by-step instructions)
Dialogs
With button Save the settings will be stored and the dialog closed.
33
Manual AMS Asset Graphics 5.4
Option Description
Options
External access Set this option to enable user log in with an external control (key-switch). In this case,
the system-element _UserExtern will be evaluated. With the value of the element, the
user in the regarding line in the user list will be logged in, without the necessity of a
special password request.
Example:
_UserExtern has the value 3: The user, defined in the 3. line, is logged in.
User list In the user list, up to 100 different users and their properties are defined.
Name Enter here the name of the operator. The name may have a length of up to 32
characters.
Password The password of the user may have up to 32 characters. However, the password will but
not be shown in plain text and cannot be edited directly in the table.
With the button Change password you can call the dialog Change password to change
a password.
Attention The password is case sensitive.
Lifetime The lifetime is the time, that the user may work in the system without renewed request
for this data, when he has once entered his user name and password. At every operation
function the lifetime starts running anew. When the lifetime has elapsed, the user has to
log in again.
When the lifetime shall never elapse, which could be useful e.g. at the external user
login, enter the value -1 as lifetime.
Rights Press button Assign to open dialog Assign rights. Here you select the rights for an user.
In line 1 have a user with name Supervisor is firmly predefined. Only password and lifetime can be
configured.
Option Description
User / Enter the operator name and the corresponding (old) password.
Old password
New password Enter the new password here. For safety reasons, the new password has to be repeated
/ in field confirmation.
Confirmation
34
Projects
Column Description
Editor In this column, the individual editors are registered. You cannot make any change.
Right The default access right is Unprotected. If you want to protect an editor enter here the user
right as number or as name. By clicking with the right mouse button you open dialog Select
access right. Here you select the user right from a selection list.
Note User name, password and the assignment to the rights you can define with command
Configuration | Password protection | User... in dialog User table.
See also
Password protection
Using
Password protection
To protect the system against unauthorized access, you can define operators which are assigned to access
rights and passwords. During runtime, password-protected actions may only be made by operators with the
relevant access right.
35
Manual AMS Asset Graphics 5.4
For every password you can define a Lifetime. If the configured time has elapsed, the operator
must login again.
You can assign the rights for every operator by pressing button Assign in the dialog Assign
rights. Close the dialog with OK. For the currently selected operator line the selected rights are
displayed in the Rights.
36
Projects
Replication
First setup a connection with the SQL server by entering the name of the SQL server instance in the edit
field SQL Server and then press Connect.
The connecting takes several seconds. If an error occurs you will get an error message normally after 60
seconds.
The name of the AMS Asset Graphics SQL Server instance is commonly
ComputerName\inVISU_PMS.
Note The using of an IP address instead of a computer name will result in an error, when the replication is
executed. So you must use a computer name.
If a connection to a database is not possible because the respective IP address cannot be resolved, you can
solve the problem with an entry in the Hosts-file (e.g. C:\WINDOWS\system32\drivers\etc\hosts).
After a successful connection to the SQL Server you can select a database from the list. This database will
be the primary part of the replication. For this database you will define one or more subscribers. With every
subscriber a database replication is made.
37
Manual AMS Asset Graphics 5.4
With the button Add/delete database table you open the dialog to select tables, which shall be replicated.
In the list of the database tables you find the tables used by AMS Asset Graphics programs.
After the selection of the tables you must create a snapshot with the so named command. This initial
snapshot is absolutely necessary.
With the command New you add a new subscription to the database.
First you select the SQL server in the dialog Select destination. After a successful connection to this SQL
server you select the database in the dialog Select database.
If the subscription could be established the new subscription is displayed in the table.
Column Description
Subscription Here you see the name of the subscriptions. The structure is SQL Server:Database
name name.
Database name is name of the database on the destination system.
Example: WS002094\INVISU_PMS:OperationLog.
Start The here configured num-element starts the replication.
Note It is necessary that the program Database replication is added in the program list
(see dialog Runtime configuration).
Ready This num-element is a notification-trigger for the end of a replication, independent
whether successful or not.
Error This num-element contains the last error number from the SQL Server. 0 indicates the
status successful (no error).
Status text This text-element reports the last action or error as text with a maximum of 80
characters.
Progress With this num-element you can retrieve the progress of the replication in percent.
38
Projects
Note The using of an IP address instead of a computer name will result in an error, when the replication is
executed. So you must use a computer name.
If a connection to a database is not possible because the respective IP address cannot be resolved, you can
solve the problem with an entry in the Hosts-file (e.g. C:\WINDOWS\system32\drivers\etc\hosts).
39
Manual AMS Asset Graphics 5.4
The task of the Database Replication Runtime is to start the various replication operations.
In the program window you will find information about each subscription. This is a help for the error
diagnostics.
Sample output:
Server: Master1\INVISU_PMS
Database: OperationLog
Subscription:Master2\INVISU_PMS:OperationLog
State/Error: idle
Start time: 23.03.2006 16:00:00
Finish time: 23.03.2006 15:00:34
Initializing
Connecting to Publisher 'Master1\INVISU_PMS'
Connecting to Subscriber 'Master2\INVISU_PMS'
Retrieving publication information
Retrieving subscription information
Line Description
Server SQL Server instance of the primary database.
Database Name of the primary database.
Subscription Name of the subscription.
State/Error Current state or error.
Start time Start time of the last replication operation.
Finish time Finish time of the last replication operation.
Following Here you see all action and error output produced by the SQL server during the
lines replication operation.
40
Graphic
Graphic Editor
The Graphic Editor is a main part of the process management system AMS Asset Graphics. With this
program the process pictures are drawn and the user interface configured. The appearance of the process
data on the screen will be defined as well as the options for the user to control the process from the
computer.
The graphics are realized as vector graphics. All elements of a picture are so called objects, which can be
drawn edited at any time.
Generally, objects have three main properties:
Static properties, such as position, size and color
Dynamic properties, such as change in visibility, position, color, and rotation
VBScripts can be edited for every object (VBScript is the short form for Visual BASIC Script).
With the Graphic Editor an arbitrary number of pictures can be edited. Every view of a picture can in turn be
divided into up to 4 parts.
Overview objects
See also
Using a property dialog
User interface of the Graphic Editor
Menu commands
Shortcuts
User interface
User Interface
The user interface of the Graphic Editor offers different toolbars for file operations, for drawing, for opening
entry fields, for the color selection, for aligning several objects, for editing of symbols and for zooming the
picture. The same functions can also be executed via the menu commands above. In the center of the
screen there are one or several windows to draw the process picture.
At the start of the Graphic Editor, the data directory defined in program Configuration (tab Directories), will
be used automatically. When the directory is not accessible, a message will be displayed and the program
terminates.
See also
Toolbar Draw
Toolbar Input
Toolbar Colors
Toolbar Align
Toolbar Symbols
Toolbar Zoom
Toolbar Language
Tree view
41
Manual AMS Asset Graphics 5.4
Tree view
The tree view displays all objects in a hierarchical manner. All objects can be selected and configured.
If the tree view window has not the input focus, it will be shown darker.
With the TAB-key the input focus changes to the picture.
You can select an object with a left-click it in the picture or in the tree view.
When pressing the CTRL-key at the same time, the status changes between selected and not selected.
When pressing the Shift-key, all objects between the last selection and the current position will be selected,
whereat only objects of the same hierarchical level can be selected, e.g. all objects, that are part of a group
object.
Shortcuts
42
Graphic
Dialogs
Dialog Action
In this dialog you can select one of the following actions:
Action Description
SET The data-element will be set on the value of a constant or a variable.
TIP As long as the button is pressed, the data-element has value 1. When releasing the button, the
data-element will be set on 0. When other values as 1 and 0 shall be used, enter them in field
minimum (= button not pressed) and maximum (= button pressed).
ADD The data-element will be added up with the value of a constant or variable.
SUB A constant or variable will be subtracted from the value of the data-element.
MUL The data-element will be multiplied with the value of a constant or variable.
DIV The data-element will be divided by the value of a constant or variable.
TGL The data-element will be changed independently from the value of a constant or variable. At this,
the value will be increased by 1 at every TGL action . When the value has reached 255, it will
start again at 0. The system registers this change and can trigger follow-up actions automatically.
SWP The data-element will be set from the minimum- on the maximum-value and vice versa.
Dialog Shortcut
Here you have the following input possibilities:
The 12 function keys
Every numerical key 0 to 9
Every letter, it is not distinguished between capital letters and small initial letters.
The Scroll-key
The keys Ins and Del
The keys Home and End
The PgUp and PgDn
The arrow keys: up, down, left and right
All keys may be combined with the Shift-key, the Ctrl-key or the Alt-key. These keys can be combined
together and also with further keys.
When you confirm the dialog with OK, the key or key combination is set as shortcut into the corresponding
entry field.
Search element
With this dialog you can search for a data-element in a picture. All objects of the current picture will be
scanned. In group objects, all grouped objects are also scanned. When an element is found in an object, the
object will be marked automatically.
Option Description
Search for Enter here a search string or a part of the search string. With the browse-button you can
also select an element from the reference list.
Match whole When this option is set, the search string must match completely with the element
word only name.
When this options is not set, the search string must match only in parts with the element
name.
Match case At the search, the capitalization and use of small letters of the element names are used
to find a data-element.
Start at begin Starts searching at the first object in the current picture.
43
Manual AMS Asset Graphics 5.4
Option Description
Find next Beginning at the currently selected object, the next object (element name in an object) is
searched for.
Edit The property dialog for the found object will be opened.
Dialog Rename elements
This is a comfortable feature, to rename data-elements, used in one or several highlighted objects, also in a
group of objects. All data-elements, used in the selected objects, will be shown in the lines of the grid.
Values of constants in VBScript can also be changed.
Shortcut
The dialog can also be accessed with the key CTRL+R.
Column Description
Original The name of the original data-element/constant is shown here. It cannot be changed.
New Enter here the name of the new data-element or the new value of the constant. Data-elements
can be selected from the reference list with a click with the right mouse button. Text-constants
will be enclosed in " ".
Type The Data type of the data-element/constant is shown here.
This entry cannot be edited.
Dialog File selection with preview
Option Description
Project or Select in this list field the project or the library, where the file to be selected is stored. The
library expression [Project] stands for files in the current project.
All files of the selected type of this project or library will be shown in the file selection field
below.
File name The name of the file, selected in the file selection field, is shown.
You can also enter the name of the file via the keyboard.
File type Select the file type. Depending on the function, that was used to open the dialog, one
particular file type (picture or symbol) is predefined generally.
Preview Activate this option to show a reduced image of the document in the preview window.
Toolbars
Alignment commands
44
Graphic
Grid display With this command you can switch on or off the grid. You configure the grid
space on tab Grid.
Grid capture With this command you can switch on or off the grid capture function. When
this option is activated, all new marked objects will be aligned at the currently
adjusted grid.
Lock mode With this command you can switch on or off the lock mode. When the lock
mode is off, you can also select locked objects in the picture with the mouse.
Toolbar Alignment
The toolbar Alignment has the comfortable commands to align objects relative to a reference object.
The reference object is the first selected object. Press the Shift-key pressed and mark with the left mouse
button every object, which shall be aligned at the reference object.
You can also mark objects, by drawing a marking rectangle around the object with the mouse. Also here
applies: first mark the reference object with a mouse click. The reference object has black tracker points, the
other objects have gray points.
The commands for changing the level of the object, can only be used when one object is selected.
The functions of the different buttons can be found in Alignment commands.
Toolbar Input
Here you find the commands for creating objects, that can be used with the mouse or keyboard to change
the value of data-elements.
See also
Button
Graphic Button
Checkbox
Radio Button
Scrollbar
Slider
The translation mode is enabled/disabled with the command Language text on/off. The language can be
selected in the list.
45
Manual AMS Asset Graphics 5.4
Toolbar Symbol
Symbols are a collection of dynamic objects, which are administrated in libraries. In such a symbol library
often used symbols are deposited.
To insert symbols precisely into a picture you should operate with the options grid and grid capture.
New library
With this command you open a new symbol library. When you activate the command the dialog New library
appears.
Enter here the name of a new symbol library. It will be created as sub directory in subdirectory Library in the
program directory.
Load symbol
With this command, you select a symbol from the list of existing symbols and insert it in the picture.
When you activate the command the dialog File selection appears.
Link-symbol
Creates a new link-symbol object and assigns the selected symbol file to the new link-symbol.
Save as symbol
Select first one or more objects, that you want to save as symbol. After selecting a file name in the dialog
File selection the selected objects are saved as symbol.
Toolbar Draw
Here you find the commands for selecting, drawing and editing of objects.
Select the wanted command and draw the corresponding object.
When you press the ESC-key the command Select objects will be activated.
Commands
Select objects
Edit polygon
Line
Rectangle
Rounded rectangle
Ellipse
Polygon
Polyline
Text
Number
Graphic
Group objects
Ungroup
Create metafiles
Windows
Trend chart
XY-trend chart
New object
Toolbar Zoom
Toolbar Zoom has commands to extend or to reduce the view on process pictures. The use of the zoom
function does not affect the document, but only the display of it.
46
Graphic
Zoom control
Select list field Zoom control in toolbar Zoom, which offers predefined zoom steps to select sizes in
percent. Predefined values are 25%, 50%, 75%, 100%, 200%, 400% and 800%.
Beside this, you can also enter other zoom values directly into the input field such as e.g. 500%.
Zoom in
This commands multiplies the current Zoom value with 2.
Zoom out
This commands divides the current zoom value with 2.
AutoZoom
After activating this command you can select a zoom area in the picture with the mouse.
Original size
When you activate command Original size in toolbar Zoom, the views will be reset on the original size,
100%.
Menus
Menu commands
In the Graphic Editor there following commands in the main menu:
File
Edit
Alignment
View
Properties
Window
Language
?
Menu File
In this menu item you find commands, to create new process pictures or open existing ones, to print
pictures, to close or save them. Beside this, the following commands are available:
Print...
Select this command to print a document. When selecting the command, the standard-dialog Print appears,
for the configuration of the printer and to select other options for the printer setting.
Print preview
Select this command to show a preview of the current picture. When selecting this command, the main
window will be replaced by a page view window, which shows the picture in its print format. In addition, you
can show the page enlarged and reduced or you can start a print job.
47
Manual AMS Asset Graphics 5.4
Printer settings...
Select this command to define a printer and a printer port in the dialog Printer settings.
Menu Edit
Command Description
Undo Use this command to make the last action undone. You can make undone up to 10
actions.
Redo Use this command to restore the last action that was made undone. You can
restore up to 10 actions.
Cut Use this command to remove the currently selected objects from the picture and
copy it into the clipboard.
Copy Use this command to copy currently highlighted objects into the clipboard.
Paste Use this command to insert a paste of the clipboard contents into the picture at the
current cursor position.
The Graphic Editor can deal the data types AMS Asset Graphics objects, metafile
and bitmap.
If a Metafile or a Bitmap shall be pasted, the dialog File selection will be opened.
Enter a name for the Metafile or Bitmap file and convert it to an AMS Asset Graphics
object, before pasting it into the picture.
Delete Use this command to delete all selected objects.
Select all Use this command to select all objects in the current picture.
Deselect all Use this command to deselect all objects in the current picture.
Invisible As a help function for editing objects can be made invisible in the Graphic Editor to
(submenu) get access on objects, placed below them.
Invisible objects cannot be selected anymore!
Make selected All selected objects will get invisible. This command can also be called with shortcut
objects invisible Ctrl+I.
Show all objects All selected objects will get visible. This command can also be called with shortcut
Ctrl+Shift+I.
Trend charts All trend objects are made invisible.
invisible
Windows invisible All window objects are made invisible.
Lock With this command you can lock a object. This means the object cannot be
selected anymore in the picture. In the tree view the selection of the object is
always possible.
Lock mode When the lock mode is not activated, also locked objects can be selected in the
picture.
Search element The locations of use of a data-element can be found with dialog Search element.
Rename elements Data-elements can be given a new name in the dialog Rename elements.
OLE-Objects For configuring OLE-objects (ActiveX-Objects) you can use the commands Insert
new object, Ole link and an Object specific popup menu.
48
Graphic
Menu View
In this menu item, the various toolbars and the status bar are switched on and off to use optimally the
available space on the screen.
Command Description
Draw With this command, toolbar Draw can be switched on or off.
Input With this command, toolbar Input can be switched on or off.
Colors With this command, toolbar Colors can be switched on or off.
Alignment With this command, toolbar Alignment can be switched on or off.
Symbol With this command, toolbar Symbol can be switched on or off.
Zoom With this command, toolbar Zoom can be switched on or off.
Language With this command, toolbar Language can be switched on or off.
Tree view With this command the tree view for the objects can be switched on or off.
Menu Alignment
In this menu you find commands to align several objects at one reference object.
For this purpose first select the object, at which the other objects are to be aligned. Keep the CTRL-button
pressed and select with the left mouse button every object, which shall be aligned at the first object.
You can also select objects by drawing a selection rectangle around the object with the mouse. Also here
applies: first mark the reference object with a mouse click. The object, to which other objects are aligned, is
drawn with black tracker points, the other objects with gray trackers.
The commands for changing the z-order of the object, are only accessible, when only one object is selected.
The description of the commands you found in Alignment commands.
Menu Properties
In menu Properties, you can configure the Graphic Editor itself, project settings and the current picture.
Project
Visualization...
Shortcuts
Fonts...
Flashing colors...
Rename elements in the project settings.
Picture
Picture properties
Shortcuts
Test input
Menu Window
New Window
Use this command to open a window, which has the same contents as the active window. You can open
several windows at the same time, which permits you to view different parts or views of a process picture in
parallel. When you make changes at the contents in one of the opened windows, these changes will be
taken over by all windows, which contain the same picture. When opening a new window, it will get the
active window and will be viewed in front of all other opened windows.
49
Manual AMS Asset Graphics 5.4
Cascade
Use this command to arrange the opened windows in overlapping order.
Tile windows
Use this command to arrange the opened windows in a parallel view.
Arrange icons
Use this command to arrange the symbols of the minimized windows in the bottom part of the main window.
If there is an opened picture window, it could be possible, that some or all of the symbols are covered by this
picture window.
Split
Use this command to split the currently opened window.
To show the picture again in one window, double-click on the split area.
Tip When you work at a monitor with a low screen resolution and when your target system has a high
resolution, you cannot see the complete picture on the monitor. To move or copy objects between parts of
such a picture, split the window into two parts. Fade in the objects to be moved or copied in one section and
fade in the insertion range in the other section. Now, mark the desired elements, and move them over the
window separator.
Editor
Dialog Properties Editor
In this dialog editor properties are defined. The last settings will be stored and used again at the next start of
the Graphic Editor.
Option Description
Multiple selection At the Multiple selection, a rectangle as selection area is drawn.
With this option you can define, when objects shall be considered as selected.
Partial in the An object is selected, when parts of the object are within the selection rectangle. In
selection rectangle the example below, all objects will be selected.
Complete in the When this option is highlighted, only objects will be selected, which are placed
selection rectangle completely in the selection area. In the example, this applies for objects 2 and 4.
50
Graphic
Option Description
Polygon selection With this option you can configure, when a Polygon- / Polyline object is highlighted
with a mouse click.
Only inner area When this option is highlighted, the polygon object will only be selected, when you
click directly on the inner area of the object. In the example, this is valid for the
yellow area.
Bounding rectangle When this option is highlighted, the polygon object will be selected, when the mouse
click is within the enclosing rectangle (see example).
Tracker With this option the size of the tracking points are defined. In the preview you see the
effect. Possible values are between 3 and 10.
Option Description
Show grid Activate this option to align objects at the grid. This option can also be switched on or
off in toolbar Alignment.
Align on grid Activate this option to align objects at the grid. This option can also be switched on or
off in toolbar Alignment.
Grid spacing
Horizontal / Here you define the space of the horizontal and vertical grid lines. Possible values are
vertical between 4 and 100.
Origin
Horizontal / Define the horizontal and vertical reference point. Possible values are between 0 and
vertical 100.
51
Manual AMS Asset Graphics 5.4
Using
Select objects
Use this command in the toolbar Draw to select an object. While holding the Ctrl key you can click several
objects with the mouse and thus mark them. The first highlighted object will get black editing points and is
the reference object, the following objects will have gray points.
Note When you want to select multiple objects, draw a marking frame with the mouse around the
objects. This function is predefined that way, that all objects are selected, that are partially in the
selection area. This option (Multiple selection) can be changed in tab Object selection.
Copying of objects
Highlighted objects can be moved or copied. There are two possibilities to copy objects: either Copy the
object(s) with pressed CTRL-key and with the left mouse button or by means of CTRL+C and CTRL+V. The
objects will be copied on the original position, from this point you can move them to the desired position.
52
Graphic
See also
Polygon
Selecting objects
Press button Select objects in toolbar Draw in the Graphic Editor.
Clicking on an object with the left mouse button is the fastest method to select individual objects. Several
objects can be selected, by keeping the Ctrl-key pressed while single objects, object groups or several
object groups are clicked with the mouse.
Function Proceeding
Selecting one object Click with the left mouse button on the object.
Selecting several Keep the Ctrl-key pressed and click with the left mouse button on every object.
objects
Selecting a group Click with the left mouse button in the selection frame of the grouped objects.
Selecting several Keep the Ctrl-key pressed and click with the left mouse button in the selection
groups frames of all groups to be selected.
An alternative to select objects is drawing a frame around the desired objects with the left mouse button.
See also
Selecting polygons or polylines to edit their form
Arranging objects
The functions to arrange objects provide the possibility to arrange objects left-aligned or right-aligned, to
move them on the same horizontal line, arrange them with identical distances and to adjust their size.
For all functions to arrange objects, the following apply: first select the reference object, at which the other
objects are to be arranged. Keep the Ctrl-key pressed and select with the left mouse button every object,
which shall be arrange to the reference object.
You can also select objects, by drawing a selecting rectangle around the object with the mouse. Also here
applies: first mark the reference object with a mouse click. The first object, the reference object is painted
with black trackers, the other objects have gray trackers.
Function Button
Align Left, Centered, Alignment left, centered or right relative to the reference object.
Right,
Align Top, Center, Alignment top, center or bottom relative to the reference object.
Bottom
Same The horizontal/vertical space between all highlighted objects will be adjusted by
horizontal/vertical keeping the positions of the two outer objects and by dividing up the space among
spacing the other objects.
Same width All objects will be given the same width as the reference object. The left x-position
remains unchanged.
Same height All objects will be given the same height as the reference object. The upper y-
position remains unchanged.
Same size All objects will be given the same width and height as the reference object.
53
Manual AMS Asset Graphics 5.4
Resizing objects
You can resize objects in horizontal and vertical direction.
Function Proceeding
Resizing horizontally Click with the left mouse button on the right or left pulling point of the object.
Resizing vertically Click with the left mouse button on the upper or lower pulling point of the object.
Resizing simultaneously Click with the left mouse button on one of the pulling points at the corners of the
horizontally and object.
vertically
Grouping objects
With the command Group objects you can combine several objects to one unit. Each of the objects
assigned to the group will keep its properties. Beside this, the group objects can be assigned further group
properties. Objects should be grouped, when their relation to each other shall be protected of being changed
accidentally.
Click on button Select objects in toolbar Draw.
Select the objects with the left mouse button.
Select button Group objects in toolbar Draw.
With the command Ungroup the contained objects are separated and the group object is destroyed.
See also
Dynamic actions in a group
Edit grouped objects
Zooming a picture
For a better display of details and for a better picture configuration, the Graphic Editor has the possibility to
show image details magnified. You can magnify and minimize again the image details gradually.
Zoom in
Press button Zoom in in toolbar Zoom. Half of the screen contents will be displayed with twice
the size, i.e. the current zoom level value is multiplied by 2 up to a zoom value of 800%.
In field zoom-control you can select predefined zoom steps (25%, 50%, 75%, 100%, 200%, 400%
and 800%).
Zoom out
Press button Zoom out in toolbar Zoom. Half of the screen contents is now displayed with a 50%
reduction, i.e. the current zoom value is divided by 2, down to a zoom value of 25%.
AutoZoom
Select button AutoZoom in toolbar Zoom. Then mark the detail, which shall be magnified. The
current zoom value will be displayed in the zoom control.
In field zoom control you can enter desired zoom factors directly.
Start the Graphic Editor (button Graphic Editor in toolbar Development in the Project Manager).
54
Graphic
Open an existing picture of the project for which you would like to define flashing colors. If you
want to create a new picture, give it a name and save it in the project. Before saving the picture, it
cannot be assigned to any project and project-related commands cannot be executed.
Select menu command Properties | Project | Flashing colors to open dialog Flashing colors.
Click on the color button below Color1 and select the desired color.
Click on the color button below Color2 and select the second color which shall flash intermittently
with Color1.
Define the time interval for the flashing frequency in seconds. Values of 0.5 to 5 seconds are
possible.
Define further flashing colors or close the dialog with Save.
With the command Create metafiles from selected objects (toolbar Draw) you save the drawing in a
metafile and open a Graphic object. This function is only available, when you have selected at least one
object before. Having pressed the button the dialog File selection appears. Metafiles will be stored as *.EMF
(Enhanced Metafiles).
See also
Display an object with different states (step-by-step instructions)
Symbols are objects, grouped objects or also interleaved grouped objects, which are saved with their
complete functionality in the AMS Asset Graphics Graphic Editor. Simple geometric forms, display and input
elements are also part of this.
Symbols may be used in different pictures and projects. Stored symbols can be changed belatedly in their
size. With that, the effort of making similar pictures can be reduced considerably.
55
Manual AMS Asset Graphics 5.4
Load symbols
Press button Load symbol in toolbar Symbol to open the dialog for file selection.
Select the desired symbol. To the right of the list of symbols you see a preview on the highlighted
symbol. Press button Open.
Place the symbol to the desired position on the screen.
Now, you have the possibility to resize the symbol and edit the properties of the object. If it is a grouped
object, you can ungroup it and go on editing the single objects (see Group objects).
Changes, which you have made after loading the symbol, are not referred to the stored symbol. If you want
to save the changes of the symbol, you have to proceed as described under Create symbols.
Note Metafiles can be saved in a procedure similar to that of symbols. The essential difference between
symbols and Metafiles is, that symbols save the complete functionality of objects, which Metafiles cannot
do. Moreover, Metafiles rather offer the possibility to save complex graphics as an object and thus to
reduce display update times. They can be used in pictures in the same way as symbols.
Objects
Overview Objects
The following objects can be used in the Graphic Editor:
Basic-Objects:
Line
Rectangle
Round Rectangle
Ellipse
Polygon/
Polyline
Text
Number
Graphic
Group
Operation-Objects:
Button
Graphic Button
Scrollbar
Slider
Dialog objects
Further Objects:
Window
Link-Symbol
(Time-)Trend chart
XY-Trend chart
OLE
56
Graphic
When designing the graphic, some special features must be taken into account.
If you create your picture with a resolution of 1024 * 768 and then switch to a resolution of 640 * 480, you
can see, that the partitioning of the picture agrees, but that single objects look partly different. The reason for
this is, that almost every second pixel gets lost due to the lower resolution.
When you intend to operate your project with a resolution of 640 * 480, it is recommended to design the
project already with this resolution. When you notice later, that you have to adapt the project on other
resolutions, or when the project is intended to run on different target systems, you possibly have to adjust
the objects. Thereby the functions in toolbar Alignment will help.
If the visualization must handle with different screen resolutions, its a good idea to use project fonts.
At the object round rectangle you can change the roundness of the curve by moving the additional tracker.
Polygon, Polyline
Select command Polygon in toolbar Draw to draw a polygon. At every click with the left mouse button, a
new polygon point will be inserted (condition: the new point has different coordinates as the previous).
With a double-click on the left mouse button (or by pressing the enter-key) the drawing of a polygon is
completed. With the ESC key the drawing of a polygon is cancelled, i.e. the object will be deleted.
When you want to configure a polygon, open dialog Properties POLYGON with a double-click on the object
or via the context menu.
The dialog has the special tab Pipe.
The standard tabs are described in Using a property dialog.
See also
Edit polygon points
57
Manual AMS Asset Graphics 5.4
Text
Select command Text in toolbar Draw to place a text on the screen. A new text object has the default text
"Text".
With a double-click on the graphic or via the context menu you can open dialog Properties TEXT.
The dialog contains up to 9 tabs to configure the properties of the Text. The standard tabs are described in
Using a property dialog.
Tab Text
Tab Input
Tab Touch Panel
See also
Show the current time (step-by-step instructions)
Number
Select this command to place a number on the screen. With a double-click on the graphic or via the context
menu you can open dialog Properties Number.
The dialog contains up to 9 tabs to configure the properties of the Number. The standard tabs are described
in Using a property dialog.
Tab Number
Tab Input
Tab Touch Panel
See also
Display a numerical value (step-by-step instructions)
OLE-objects
Originally, OLE was an acronym for Object Linking and Embedding (combining and embedding objects).
OLE-documents, traditionally called composite documents, integrate smoothly different data types or
components. Audio data, calculation tables and bitmaps are typical examples for components in OLE-
documents. For example, in the Graphic Editor it is possible to integrate an Excel-table into a picture,
without having to change to Excel. Via the OLE-functionality, the menu and the toolbars of Excel will be
displayed. Embraced by the term OLE-object are also the OLE-control elements, also designated as
ActiveX-Controls.
OLE-object are re-usable software-components, which support a great number of the OLE-functions and
which can be tailored to many software-requirements. They are based on the Common Object Model
(COM). An OLE-object is a COM-based object, that can draw itself in its own window, can react on events
(such as mouse clicks) and that can be configured via an interface, which contains properties and methods.
With the Graphic Editor you can integrate OLE-objects in pictures. At runtime, they will be shown at the
defined position. The Graphic Editor and the Visualization operate as so-called OLE-container.
An OLE-container interacts with the OLE-object by methods and properties. The embedded OLE-object is in
connection with the container also via events, to inform the container, that an action has occurred. The
properties of OLE-objects can be edited in the property dialog of the object. Calling of methods and
configuring of events is not yet possible.
58
Graphic
Behaviour at runtime
When loading pictures at runtime, OLE-objects will be loaded and stay in a loaded state.. In this state the
OLE-object cannot be operated. An activation with mouse or keyboard is not possible. You can activate the
object, by triggering an action). The successful loading of an OLE-object pre-supposes, that the object was
registered correctly on the local computer and that linked documents can be found on every computer.
An active OLE-object has the priority for the input, thus the operation via function keys maybe not possible,
since the OLE-object has the input focus.
It is possible, to execute all verbs of the OLE-object. However, there is a possibility, to get the visualization
into a condition by means of the OLE-object, that can only be terminated with program exit. When planning
projects with OLE-objects, you have to take care, to avoid such conditions (do not call the corresponding
verbs).
Furthermore it is possible at many OLE-objects to call the edit-action. This operation is only useful at linked
objects since at changes of pictures the changes of embedded objects will get lost.
Click on Create from file to insert a complete document into the currently opened picture. The file will be
inserted as object. You can edit it with the program, that was used to create it.
With the option Link you define, whether the file is linked or will be embedded into the picture.
When you link the file, changes of the connected file will have an effect also on the original file, and
changes of the original file will also affect the connected file.
When you embed the file (option Link not set), changes of the embedded file will have no effect on the
original file, that means a copy of the file is used. Changes with the Graphic Editor in the linked file will be
stored in the picture. Changes in the visualization are not useful, because they are not stored in the picture
and are lost after a picture change.
Ole link
This command in menu Edit is only available, when links with other documents are integrated in the picture
(see Insert new object).
All OLE-objects with links of the current picture are shown in a list.
To show the update status of a link, click on the link, then click on button Automatic or Manual.
If the source file for the link cannot be found, the Update column will read Unavailable. This typically
happens if the source file is on an unavailable network drive or if the file has been moved.
Properties of OLE-objects
The properties of an OLE-object will be configured with the following tabs:
Tab Action (OLE-OBJECT)
The standard tabs are described in Using a property dialog.
Note At dynamic changes of position and size during runtime, the characteristics of active OLE-objects are
not clearly defined, so the behavior depends also on the internal functionality of the OLE-object.
59
Manual AMS Asset Graphics 5.4
Graphic
Select command Graphic in toolbar Draw to show a graphic file in a picture. With a double-click on the
graphic or via the context menu you can open dialog Graphic.
The dialog contains 6 tabs to configure the properties of the Graphic object.
The standard tabs are described in Using a property dialog.
Tab Graphic files.
Group
A group is a container for objects.
When the group changes its position or size, the coordinates of the assigned objects will adjusted.
If a group is invisible, all included objects are also invisible
The properties of the individual objects of a group will be preserved at the grouping. You can go on editing
individual objects without disintegrating the group. Selection of objects is done in the Tree view.
When you have copied a group of objects, you possibly have to rename single data-elements. There is a
comfortable way for renaming data-elements, to avoid opening dialog Properties for every object. For this
purpose, select command Rename elements... in the context menu to open the dialog rename elements.
Command Ungroup
Use this command to de-arrange a group of objects.
When de-arranging a group, the group object is destroyed and the group properties are lost.
Note The de-arrangement of a group is not necessary, when you want to edit single objects. For this you
can use the tree view.
See also
Edit grouped objects in the Graphic Editor (step-by-step instructions)
Dynamic actions in a group (step-by-step instructions)
Button
A button is a control which can be clicked with the mouse and which triggers one or several actions.
Click on command Button in toolbar Input to place a button on the screen.
With a double-click on the graphic or via the context menu you can open dialog Properties Button.
The dialog contains up to 9 tabs to configure the properties of the Button. The standard tabs are described
in Using a property dialog.
Tab Design
Tab Design2
Tab Touch Panel
Tab Function
See also
Change to another picture (step-by-step instructions)
60
Graphic
Graphic Button
A graphic button is a picture range, which can be clicked with the mouse during runtime and which triggers
one or several actions.
Click on command Graphic button in toolbar Input to place a button on the screen. With a double-click on
the graphic or via the context menu you can open dialog Properties Graphic button.
The dialog contains up to 8 tabs configure the properties of the Graphic Button object. The standard tabs
are described in Using a property dialog.
Tab Design
Tab Touch Panel
Tab Function
See also
Define a graphic button (step-by-step instructions)
Checkbox
With a checkbox you can display and change the values of num-elements. With every click on a checkbox
the status changes between marked and unmarked. The corresponding num-element changes also its
value.
Radio Button
Radio buttons are used when you want to let the user select one - and just one - option from a set of
alternatives. Radio buttons are linked with a common num-element, whereas the single radio button
represents a dedicated value. With a click on a radio button the status changes to marked and the num-
element is set to the predefined value.
Select command Checkbox or Radio button in the toolbar Input to place a checkbox/radio button on the
screen. With a double-click on the graphic or via the context menu you can open the dialog Properties
CHECKBOX or RADIO BUTTON.
The dialog contains tabs to define the different settings of the object. The standard tabs are described in
Using a property dialog.
Tab Design
Tab Design2
Tab Function
Scrollbar
A scrollbar control can display and change the value of a num-element. The value will be displayed via the
position of the thumb, which can also be used to change its value. In addition, the value can be changed
with the arrow buttons.
Select command Scrollbar in toolbar Input to place a scrollbar on the screen. With a double-click on the
graphic or via the context menu you can open dialog Properties SCROLLBAR.
The dialog contains up to 7 tabs to configure the properties of the Scrollbar. The standard tabs are
described in Using a property dialog.
Tab Design
Tab Function
61
Manual AMS Asset Graphics 5.4
Slider
A slider control can display and change the value of a num-element. The value will be displayed via the
position of the thumb, which can also be used to change its value. In addition, the value can be changed
with the arrow buttons. The slider can also be displayed with a scale.
Select command Slider in toolbar Input to place a slider on the screen. With a double-click on the graphic or
via the context menu you can open dialog Properties SLIDER.
The dialog contains up to 7 tabs to configure the properties of the Slider. The standard tabs are described in
Using a property dialog.
Tab Design
Tab Function
Window
With a window object you can display an other process picture. This picture in picture has all display
features and several possibilities for operating of a "normal" picture. You can use it for example to get an
overview on another part of the plant or to provide configuration possibilities.
Select command Window in toolbar Draw, to place a window on the screen. With a double-click on the
graphic or via the context menu you can open dialog Properties WINDOW.
The dialog contains 7 tabs to configure the different settings of the window. The standard tabs are described
in Using a property dialog.
Tab Design
Tab Function
See also
Display operation windows (show a picture in the picture) (step-by-step instructions)
Link-symbol
A link-symbol is an object, that refers on a symbol file. This means, by changing the symbol file, these
changes can be performed centrally for all link-symbols connected with it.
The data-elements and constants, used in the symbol, can be replaced in the link-symbol by ‚local‟
elements/constants.
Select command Link-symbol in toolbar Symbol to open an object of type link-symbol. First, a valid symbol
file must be selected with the file selection. The link-symbol will then be opened with its original size in the
center of the visible picture detail. With a double-click on the graphic or via the context menu you can open
dialog Properties LINK-SYMBOL.
The dialog contains 6 tabs to configure the properties of the Link-symbol. The standard tabs are described
in Using a property dialog.
Tab Link-Symbol.
62
Graphic
Special VBScript-functions
The properties of objects can be extended with the following VBScript-functions.
Various Functions
Function name Description Object
TextColorRGB Text color as RGB-value Number, Text
InputEleName Data input element Number, Text
InputMinEleName Data input Minimum Number
InputMaxEleName Data input Maximum Number
InputIncDecEleName Data input IncDec Number
EleName Position Slider, Scrollbar
MinRangeEleName Minimum Slider, Scrollbar
MaxRangeEleName Maximum Slider, Scrollbar
MinSelectionEleName Minimum range Slider
MaxSelectionEleName Maximum range Slider
Resolution Resolution as Number Slider, Scrollbar
ToolTipText Text, that shall be shown as tooltip Button, Graphic Button,
Scrollbar, Slider
ButtonColorRGB, Color of the button or the text color as Button (Color button activated)
TextColorRGB RGB-value
EleName Defines the element for the status. Checkbox, Radio button
ReferenceValue Defines the reference value for the status Checkbox, Radio button
checked.
GraphFilename Sets the filename of graphic file. Graphic
Example1:
Set ColorR = CreateObject("PMS.NumEle")
ColorR.SetName("ColorR")
Set ColorG = CreateObject("PMS.NumEle")
ColorG.SetName("ColorG")
Set ColorB = CreateObject("PMS.NumEle")
ColorB.SetName("ColorB")
function TextColorRGB
TextColorRGB = ColorB.Value * 256 * 256 + ColorG.Value * 256 + ColorR.Value
end function
63
Manual AMS Asset Graphics 5.4
Example2:
const MotorNr = 123
Set MotorSoll = CreateObject("PMS.NumEle")
Sub OnStart
MotorSoll.SetName("Motor" & MotorNr & "_Soll")
End Sub
function InputEleName
InputEleName = "Motor" & MotorNr & "_Soll"
end function
function InputMinEleName
InputMinEleName = "600"
end function
function InputMaxEleName
InputMaxEleName = "Motor" & MotorNr & "_SollMax"
end function
Function NumberValue
NumberValue = MotorSoll.Value
End Function
Example3:
const MachineNumber = 3
function ToolTipText
ToolTipText = "This is machine " & MachineNumber
end function
Example:
Set TEXT = CreateObject("PMS.TxtEle")
TEXT.SetName("TEXT")
sub OnChangeInputState(InputState)
if (InputState >= 2) then
TEXT.Value = "Eingabe 1"
end if
if (InputState = 0) then
TEXT.Value = ""
end if
end sub
64
Graphic
Mouse messages
Mouse messages can be processed with VBScripts for the objects picture (Properties picture), buttons and
graphic buttons.
For this purpose, the corresponding VBScript-function for the object has to be defined in the VBscript:
Example1:
Set PositionX = CreateObject("PMS.NumEle")
PositionX.SetName("PositionX")
Set PositionY = CreateObject("PMS.NumEle")
PositionY.SetName("PositionY")
65
Manual AMS Asset Graphics 5.4
The scroll wheel of the mouse can be evaluated for picture-objects with the VBScript-function
OnMouseWheel.
Example:
Sub OnMouseWheel(Flags, Delta, xPos, yPos)
End Sub
Example:
' Local project path
Set ProjectPathLocal = CreateObject("PMS.TxtEle")
ProjectPathLocal.SetName("_ProjectPathLocal")
66
Graphic
Dialogs
Using a property dialog
When you want to set properties of an object, open dialog Properties with a double-click on the object or via
the context menu. Depending on the object type it contains various tabs to define the various properties.
The first tab is tab Graphic, which contains the static properties.
Then follow tabs with the object-specific properties (e.g. Text at object Text, Number at object Number,
Trend line at object Trend chart).
The following tabs are tabs with general dynamic properties like Position, Size, VBScript.
Option Description
Name Enter a name for the object to identify. For example, the name helps you at grouped
objects, when you want to edit individual objects of the group via the tree view. New
created objects will be given an object-specific standard name.
Border
Width Determine here the width of the border. Valid values are between 0 and 100, whereat 0
indicates, that no border is shown.
Style At a width of 1 you can select different painting styles for the border.
Color A new object gets the border color, which is defined in toolbar Colors.
When you click here, Color selection opens and you can select a color.
Surface
Color A new object gets the inner color, which is defined in toolbar Colors.
When you click here, Color selection opens and you can select a color.
Coordinates Position and size of an object is defined here in screen coordinates. The top left corner of a
picture has the coordinates 0,0.
When the size of a picture changes, the coordinates will be adapted automatically.
Position Define here the position of the object.
Size Define here width and height of the object.
Description Here you can enter an additional description for the object.
Notes
Not all options can be used for every object, for example, sliders have no border.
At line objects the fields Position / Size are labeled with Position1 / Position2. As special feature, the
coordinates of both endpoints of the line have to be entered.
67
Manual AMS Asset Graphics 5.4
Option Description
Display at
(PMS Value Here you can define when the object shall be visible. (If no entry is made, the object will
Control) always be visible.)
If both of the following options are selected, both conditions must be fulfilled, to make
the object visible.
If the visibility of the object shall depend on operating states, enter here a dynamic input
quantity. The object will be visible, when the value is unequal to 0
The name of the corresponding VBScript-function is: ShowVisibleValue.
User has With this option the object will only be visible, when the current user has the
access right corresponding access right.
Right At objects, where no operator right can be assigned, (e.g. rectangle), it can be assigned
a right in field Right, at the other objects field Right will only show the currently
selected right.
Disabled when
(PMS Value Definite objects (buttons, graphic buttons, sliders and scrollbars), can be represented
Control) disabled, i.e. gray shaded. In this status the objects cannot be used.
An object will be represented disabled, if at least one of the following conditions is met.
The object will be disabled, when the value is unequal to 0.
The name of the corresponding VBScript-function is: ShowGrayedValue.
User has no When this option is set, the object is drawn disabled, when the current user does not
access right have the corresponding access right.
68
Graphic
Notes
At graphic buttons, the condition disabled can also be assigned an individual graphic.
The property View options is not at selectable at OLE-Objects.
During a data input the state of visibility of objects, that are involved in the data input, does not change.
Tab Position
On this tab you can configure a dynamic position for an object.
Option Description
Horizontal /Vertical
Active When you want to change the position of an object, activate this option.
You define the input value for the position via a PMS Value Control as a num-element or with a
VBScript function. The name of the corresponding VBScript-functions are: OffsetHorzValue and
OffsetVertValue.
Value / In these fields you define the range of values of the position. Predefined is a 1:1 scaling, this
Pixel means, a change by 1 of the element corresponds to a horizontal move by 1 pixel.
It is possible to enter also floating point numbers.
Note When changing the screen resolution, this value will be adjusted automatically.
See also
Let objects run over the screen (step-by-step instructions)
69
Manual AMS Asset Graphics 5.4
Tab Size
On this tab you can configure a dynamic size for an object.
Option Description
Horizontal /Vertical
Active When you want to change the size of an object, activate this option.
You define the input value for the size via a PMS Value Control as a num-element or with
a VBScript function. The name of the corresponding VBScript-functions are: WidthValue
and HeightValue.
Origin As origin for the width you can select Left, Center or Right and for the height Top,
Center or Bottom.
Value / In these fields you define the range of values of the size. Predefined is a 1:1 scaling, this
Percentage means, a change by 1 of the element corresponds to a to a change in size of 1 percent.
In the example above, the object is always displayed with at least 50 percent of its width.
With a value change of 1, the width will be increased by 10 percent.
See also
Change the size of objects dynamically (step-by-step instructions)
70
Graphic
Tab Rotate
On this tab you configure rotation properties for an object.
Option Description
Active Activate the option.
You define the input value for the angle via a PMS Value Control as a num-
element or with a VBScript function. The name of the according function is:
RotateValue.
Rotation center Here you enter the x- and y-position of the center of rotation.
Value / Angle In these fields you define the range of values for the rotation. Predefined is a
scaling of values between 0 and 100 to angles between 0 and 360°, i.e. a value
change by 1 corresponds to a rotation by 3.6°.
Calculate rotation center If highlighted, the center of rotation will be calculated relatively to the object.
relative to the object This means, when the object changes in size, the center of rotation will be
adapted accordingly. If this option is not set, the center of rotation will remain
fixed and will thus not change when the object changes in size.
See also
Let an object (a pointer) rotate (step-by-step instructions )
71
Manual AMS Asset Graphics 5.4
Tab Color
On this tab you can configure the dynamic color settings for an object.
Option Description
Line color / Fill color
Active When you want to have dynamic changes of line or fill colors, activate this option.
You define the input value for the color via a PMS Value Control as a num-element or with a
VBScript function. The name of the corresponding VBScript-function for line colors is:
LineColorValue, the VBScript-function for fill colors is: FillColorValue.
Table In the table you assign ranges of values to various colors. The number of the ranges of values is
not restricted. The ranges must be defined in ascending order. If the range of values was not
defined in ascending order, the incorrect cell will be marked in red.
The range of values will be defined with the cells From and To. The expressions -INF and INF
are abbreviations for minus infinite and infinite. When a new value is entered in the cell with value
INF, a new line will be created automatically.
To start a color selection double-click on the color cell.
The buttons Insert and Delete operate line by line (without safety request).
Example
In the sample above a rectangle has a dynamic fill color. The fill color is e.g. blue, when the value of
num-element FillColor is greater than or equal to 4 and smaller than 400. At every value greater
than/equal to 1024, the fill color will be red.
See also
Assign a color change to a filling level indicator (step-by-step instructions )
72
Graphic
Tab Filling
On this tab you can configure the dynamic filling settings for an object.
Thereby the object is filled horizontally or vertically. The filling extends from a reference point up to a
maximum percentage rate to be defined in this tab. Filling is made with the color, which is defined on Tab
color for the corresponding range of values.
Option Description
Horizontal /Vertical
Active When you want to have dynamic filling properties, activate this option.
You define the input value for the filling via a PMS Value Control as a num-element or with a
VBScript function. The name of the corresponding VBScript-functions are: FillHorzValue and
FillVertValue.
Origin At the horizontal filling, as reference point for the filling direction can be selected Left, Center
or Right and for the vertical filling Top, Center or Bottom.
Value / In these fields you define the range of values of the filling. Predefined is a 1:1 scaling, this
Percentage means, a change by 1 of the element corresponds to a filling of 1 percent. If, in the example
above, num-element Silo1 has the value 128, the rectangle will be filled to 12,5 % (from the
bottom).
See also
Design a filling level indicator (step-by-step instructions)
Tab VBScript
Here you enter mathematical and logical expressions. A detailed description can be found in VBScript.
By clicking the right mouse button, you get a context menu with commands to support your work.
73
Manual AMS Asset Graphics 5.4
Special dialogs
Tab Action (OLE-OBJECT)
On this page all actions (verbs) of the OLE-Object will be shown in a table. Each action can be assigned a
trigger-element. When the corresponding trigger-element changes its value the corresponding action of the
OLE-object will be executed.
Tab Design (Properties BUTTON)
Option Description
Text Here you set the text for the button. New buttons have standard text "Button".
(Static, Dynamic) If you select a static text for the button, you can also use variables in the text.
If you use the dynamic option, you define via a PMS Value Control the button text with
a text-element or with a VBScript function. The name of the according function is:
ButtonTextValue.
Alignment
Horizontal Here you configure, whether the button text has to be left-aligned, right-aligned or
center.
Vertical Here you configure, whether the button text shall be placed top, in the center or
bottom.
Font Here you define the font settings.
Project font A project font is a font with a fixed size. Properties of project fonts can be defined and
changed centrally.
When you select a project font, the following font options are disabled.
Name Click on the browse-button at the right of the font name to open dialog Font. Here you
select a font and the font style.
You can also enter the font name with the keyboard as well. The input is restricted to
max. 31 characters.
Note The settings of effects, color and size are not used.
Bold, These options define, whether the text is displayed bold or italic.
Italic
Number of lines With this parameter, you define, the number of lines to show the text. Valid values are
0.5 to 20.
Tooltip Here you set the tooltip text. You can also use variables in the text.
Shortcut In this field you can assign a shortcut to the button. While the assigned short is pressed
the function, defined on tab Function (button), will be executed. When pressing the key,
the button will also appear pressed.
Click on the Browse-button to the right of the field to open dialog Shortcut.
74
Graphic
Option Description
Graphic
(Table) In this table you can define the graphic files for the appearance of the graphic buttons.
Possible graphic formats are bitmaps (file extension BMP) and metafiles (file extension WMF
or EMF).
The definition of graphic files is not implicitly necessary. See the following paragraph Display
options for a Graphic Button.
In column Status, the button states normal (not pressed), pressed, and disabled (grayed)
are firmly predefined.
In columns File name / Library you enter the name (including extension) and library
directory for a graphic file. The name [Project] is a synonym for the current project directory.
If File name and Library do not specify an existing file, the text will be shown in red.
It is useful, not to enter the file and library name directly, but to select it from the dialog File
selection (open with right mouse click).
Cursor You can use a special pointer for the graphic button. The (special) mouse pointer will be
shown, whenever the mouse is moving over the graphic button. It is possible to use static
mouse pointers (file extension CUR) as well as dynamic mouse pointers (file extension ANI).
When selecting (standard), the standard Windows mouse pointer is used.
With 3D- When this option is activated, the graphic button will always be drawn with a 3D-frame. If the
border option is not activated, no frame will be drawn.
Tooltip Here you can enter a text, that shall be shown as tooltip. You have also use variables in the
text.
Shortcut In this field you can assign a shortcut to the graphic button. If the assigned shortcut is
pressed, the function, defined on tab Function (button) will be executed. When pressing the
shortcut, the graphic button will also appear pressed.
The key combination cannot be entered directly as text, you must use the browse-button to
open dialog Shortcut to define the key combination.
Status disabled:
If the button is disabled, the corresponding graphic will be shown. If no graphic was defined for the
disabled state, the graphic button is drawn with an additional hatching pattern.
75
Manual AMS Asset Graphics 5.4
See also
Tab View options
Define a graphic button (step-by-step instructions)
Tooltip Here you can enter a text, that shall be shown as tooltip. You can also use variables in the
text.
76
Graphic
Title bar
Active When you want to display a title bar, activate this option. The following options can only
be selected, if a title bar is displayed.
Title Enter here a text for the title bar.
Color The color of the title bar can be changed by pressing this button.
System menu Activate this option, when you want to show the System menu.
Symbol field Activate this options, when you want to show the Symbol field / Zoom field in the title
Zoom field bar.
Note The options Symbol field and Zoom field can only be used, if System menu is
activated.
Movable Activate this option, when the window shall be movable by the user.
Consider also the functionality when changing sizes and positions.
77
Manual AMS Asset Graphics 5.4
Cursor The button can be assigned a special mouse pointer with this selection field. The
(special) mouse pointer will be shown, whenever the mouse is moving over the button. It
is possible to use static mouse pointers (file extension CUR) as well as dynamic mouse
pointers (file extension ANI).
When selecting (standard), the standard Windows mouse pointer is used.
Tab Design 2 (Properties Checkbox / Radio button)
Option Description
Status
Defines the condition, when the checkbox / radio button (in the following called control)
is displayed in the status checked.
Value Here you enter a num-element, which defines the status for the control or is changed by
the control.
Reference value Reference value must be an integer.
When Value and Reference value are equal, the control is displayed in the status
checked.
When the control is checked, Value will be set to the Reference value.
When the control is unchecked, Value will be set to 0 (1 if the reference value is 0).
Colors
Background Defines the background color for the control.
Text The text color
Disabled Defines the color, when the control is disabled.
Cursor The button can be assigned a special mouse pointer with this selection field. The
(special) mouse pointer will be shown, whenever the mouse is moving over the control.
It is possible to use static mouse pointers (file extension CUR) as well as dynamic
mouse pointers (file extension ANI).
When selecting (standard), the standard Windows mouse pointer is used.
78
Graphic
Functions of a Button
Column Description
Element Enter here the name of the element, that shall be changed by pressing the button.
Action Here you define the actions for the button. An action can be entered with keyboard or mouse.
Click with the right mouse button in this column into the corresponding entry field. Dialog
Action appears. Select one action.
The short term of the selected action will be entered into the entry field of column Action.
Value The numerical constant or the variable is entered here, by means of which the action shall be
executed.
Minimum, Define here the minimum and maximum values, that may be reached. Constants as well as
Maximum num-elements may be entered here.
If no check shall take place, leave the corresponding entry field empty.
Type Into column Element you can enter num- or text-elements. Click the right mouse button on this
field to open dialog Select type.
Note When selecting type TXT the action SET is predefined and cannot be changed, because
text-elements can only be set with texts.
If a click with the left mouse button is made on a button, the VBScript-function OnLButtonClicked - if
configured - will be called.
79
Manual AMS Asset Graphics 5.4
Option Description
Value You define the value via a PMS Value Control as a num-element or with a VBScript function. The
name of the according function is: GraphicValue.
Files In the table you assign ranges of values to different graphic2s. The number of the ranges of
(Table) values is not restricted. The ranges must be defined in ascending order. If the range of values
was not defined in ascending order, the incorrect cell will be marked in red.
The range of values will be defined with the cells From and To. The expressions -INF and INF
are abbreviations for minus infinite and infinite. When a new value is entered in the cell with
value INF, a new line will be created automatically.
For the selection of graphic files, click with the right mouse button in a name- or library cell to
open the dialog for file selection. You can use different graphic files.
Note Library and file name will be drawn in red, when they graphic files are not accessible.
The buttons Insert and Delete operate line by line (without safety request).
80
Graphic
Option Description
Active With this option you can activate a data input on the object.
Data input
Element Here you must enter the element, on which the data input is made.
Note This must not necessarily be the element, which is shown, but is useful in
many cases.
Minimum, Maximum Define here the minimum and maximum value, that may be reached.
(only for object Number) The value may be a constant or another num-element. If you try to enter a value,
during runtime, which is not within the limits, a warning will appear and the value
will not be accepted.
Inc/Dec Enter here the amount for changing the data value, when, during runtime, the
(only for object Number) keys PgUp or PgDn are pressed.
The value may be a constant or a num-element.
Buffer modifications Activate this option to apply all modifications after the regular end of the data
input.
When this option is not activated, all changes during the data input will be
written immediately into the database. Cancelling the data input will then abort
the data input, but the changed values have already been accepted and cannot
be made undone.
Operating management
Password protection Enter the access right, or click with the right mouse button to open dialog Select
access right and to select a user right.
Log level Enter here a Log level.
See also
Tab Input (Properties Pictures)
Define setpoints (step-by-step instructions)
Tab Link-Symbol
The special properties of a link-symbol are defined here.
Option Description
Symbol file Here you select the name of the attached symbol file.
The storage location of the symbol file is defined with name and library. The expression
[Project] at Library is a synonym for the graphic-directory in the current project (see AMS
Asset Graphics directory structure).
Press the browse-button to select a symbol file with the file selection dialog.
Rename In the table you have the possibility, to replace elements and constants, used in the
elements Symbol, by ‚local‟ elements and constants.
(Table) With the command Autofill all in the symbol used elements and constants are filled into
the table. Table entries with no equivalent in the symbol will be deleted.
With button Delete, the current row will be deleted without safety request.
Below you find the description of the columns.
81
Manual AMS Asset Graphics 5.4
82
Graphic
Option Description
Active If this option is activated, the object will be drawn in a pipe style.
Definition The drawing options for pipe are defined here.
Color Defines the outer color of the of the pipe.
End cap Determines, how the endpoints are drawn. Possible options are Round, Square and Flat.
This setting is only valid at polylines.
Join cap Determines, how folding points shall be drawn. Possible options are Round and Flat.
Example
1) Endpoints round, folding points round
2) Endpoints square, folding points round
3) Endpoints flat, folding points flat
83
Manual AMS Asset Graphics 5.4
Option Description
Text
Static / Here you set the text for the text object. New text objects have standard text "Text".
Dynamic If you select a static text, you can also use variables in the text.
If you use the dynamic option, you define via a PMS Value Control the text with a text-
element or with a VBScript function. The name of the according function is: TextValue.
Note When you want to use the text object as input element, it is useful, to activate option
dynamic and to use the same text-element as defined on tab Input in field Element.
Alignment Here you make the alignment settings for the text.
Angle For the display, the angles 90°, 0° and 90° may be selected.
Horizontal You can define whether the text has to be left-aligned, right-aligned or centered.
Vertical You can define whether the text has to be vertically aligned from the top, from the bottom
or centered.
Font Here you define the font.
Project font A project font is a font with a fixed size. Properties of project fonts can be defined and
changed centrally.
When you select a project font, the following font options are disabled.
Name Click on the browse-button at the right of the font name to open dialog Font. Here you
select a font and the font style.
You can also enter the font name with the keyboard as well. The input is restricted to max.
31 characters.
Note The settings of effects, color and size are not used.
84
Graphic
Option Description
Color If you want to change the color of the font, press the color button. The dialog Color
selection will be opened.
Wordwrap When you activate this option, words will be written into the next line, if they do not match
completely in a line.
Note This option must also be activated, if your text contains words, which are separated
by spaces.
Bold These options define, whether the text is displayed bold or italic.
Italic
Number of Here you define, in how many lines your text shall be shown. Valid values are 1 to 1000.
lines
Dialog objects
Dialog objects
Dialog objects in AMS Asset Graphics are special automation objects, which wrap modal dialogs.
While a modal dialog is open operation in the visualization is disabled. Therefore, the user must first close
the dialog, before he can go on operating the visualization again.
Dialog objects are configured with VBScript code (editing of VBScript codes see VBScript).
Note When one of the dialogs is open, the picture change is blocked.
Dialog object InputDialog
The properties of the dialog are defined in a VBScript. First an object of the class InputDialog must be
generated with the HostCreateObject function.
85
Manual AMS Asset Graphics 5.4
Sub CreateInput
InputDlg.Left = 100
InputDlg.Top = 100
InputDlg.Width = 300
InputDlg.Height = 50
InputDlg.Caption = "Value input"
InputDlg.Description = "Please enter the speed:"
InputDlg.Value = SpeedEle.Value
InputDlg.NumberOnly = True
InputDlg.Minimum = 20
InputDlg.Maximum = 4500
InputDlg.Value = SpeedEle.Value
InputDlg.Show
End Sub
Sub InputDlg_OnOk(bCloseDlg)
SpeedEle.Value = InputDlg.Value
End Sub
In the example the input dialog will be configured and displayed in subroutine CreateInput.
Methods
Show Shows the dialog. Function does not wait until the dialog is closed.
Events
OnOK This event function will be called up when clicking button OK. Generally, the
(bCloseDlg) entered value will be evaluated here. With parameter bCloseDlg you can avoid
closing the dialog, by setting the parameter on False.
OnCancel Function is called up when clicking button Cancel. With parameter bCloseDlg you
(bCloseDlg) can avoid closing the dialog, by setting the parameter on False.
86
Graphic
The properties of the dialog are defined in a VBScript. First an object of the class ListDialog must be
generated with the HostCreateObject function.
Sub CreateList
ListDlg.Caption = "Picture selection"
ListDlg.Left = 100
ListDlg.Top = 50
ListDlg.Width = 250
ListDlg.Height = 140
ListDlg.MultiSelect = False
ListDlg.Clear
ListDlg.AddItem "Overview"
ListDlg.AddItem "Production"
ListDlg.AddItem "Final Assembly"
ListDlg.AddItem "Washer"
ListDlg.ListIndex = 1
ListDlg.Show
End Sub
Sub ListDlg_OnOk(bCloseDlg)
Set NewPic = CreateObject("PMS.TxtEle")
NewPic.SetName "_NewPic"
NewPic.Value = ListDlg.List(ListDlg.ListIndex)
End Sub
In the example, the listbox is configured and shown over subroutine CreateList. At this picture selection
function it is assumed, that the pictures have got the corresponding names.
87
Manual AMS Asset Graphics 5.4
88
Graphic
The properties of the dialog are defined in a VBScript. First an object of the class MessageDialog must be
generated with the HostCreateObject function.
Sub DoEnd
QuestionDlg.Show "Do you really want to end the visualization?",_
"Question", vbYesNo or vbQuestion
End Sub
Function Description
Method
Show Shows the dialog, but in opposition to the VBScript MsgBox function, it
(Text, Title, Options) does not wait until the user has clicked a button.
Text, that is shown as message in the dialog.
Title, that is shown in the title bar of the dialog.
Options
Numeric value, that represents the combination (or-function) of the values
for the following definitions: Number and type of the buttons, type of icon
to be used, definition of the default button. Valid values are shown in table
Options.
Event
Closed Will be called up after closing of the dialog. RetVal contains a value that
(RetVal) shows which button was pressed in the dialog.
The possible value for RetVal can be found in table Return values.
89
Manual AMS Asset Graphics 5.4
90
Graphic
The properties of the dialog are defined in a VBScript. First an object of the class TextDialog must be
generated with the HostCreateObject function.
Sub CreateEdit
EditDlg.Caption = "Info"
EditDlg.Left = 200
EditDlg.Top = 100
EditDlg.Width = 500
EditDlg.Height = 300
EditDlg.Filename = "Text.rtf"
EditDlg.EnableEdit = True
EditDlg.Show
End Sub
In the example the text dialog will be configured and displayed in subroutine CreateEdit.
91
Manual AMS Asset Graphics 5.4
Picture
Picture
Select menu command Properties | Picture to configure the settings for the current picture.
The following commands can be used:
Picture properties
Shortcuts
Test input
Tab Graphic
Option Description
Picture name Enter a name for the picture, it do not have to be identical to the file name.
Background
Color Activate this option, to show a color in the background. When pressing button Color
you can select a color in the Color selection dialog.
Bitmap Activate this option, to show a bitmap in the background. When clicking browse-
button the dialog File selection appears. You can select only bitmaps, which belong to
the current project.
The selected bitmap will be shown tiled in the background.
Picture size In field Window size you can select, whether the window with the process picture is
shown as sub window on the complete screen. When you display the window on the
complete screen, thus, when option Sub-window is deactivated, you cannot make
inputs here.
The options for Relative, Complete picture and Absolute have no consequences
on the runtime behavior, it only serves the assistance for project planning in the
Graphic Editor.
Sub picture Set this option, if you want to display the picture as a sub picture (picture in the
picture). Now you can select, whether the picture size is calculated relative or
absolute or has the full screen size.
Relative With this option the picture size is calculated relative to the current screen resolution.
Full screen With this option the picture size has the same size as the screen resolution.
Absolute With this option the picture size is fix and predefined in pixel.
Screen resolution The current screen resolution is shown here. In this field you cannot be edited.
Window size When you have selected relative or absolute, in the first field you define the width
and in the second field the height of the window.
Keep object If this option is set, the objects in a picture keep its positions and size, when the
positions picture size is changed in the Graphic Editor.
92
Graphic
Tab Input
In every picture data input fields can be assigned, so that the user can change the values of data-elements
(e.g. setpoints) directly in a picture. The data input functionality can be set for objects of type Text and
Number.
The user can change all entry fields and select freely the field for data input with the arrow-keys or with the
mouse. The data input will be started by toggling the system-element _InputStart or by the key combination,
defined on this tab. Thus it is possible to start the data input with a button or a key combination.
For the definition of function keys see also
Shortcuts (Project/Picture)
While a data input is active the system-element _InputActive has value 1 (otherwise value 0).
Every object can be configured so, this changed values get buffered until the data input is finished.
In order to find the individual entry fields on the screen and to select one of them for the input, different
background and text colors are assigned to every data input field.
Depending on the status of the data input, the entry field will drawn in one of the four background or text
colors.
Status Description
Active The data input is active.
Selection The corresponding entry field is selected.
Input In the entry field a direct data input can be performed.
Modified A change of values, caused by the data input, will be buffered.
When the data input was started, the active entry field can be selected with the help of the arrow-keys (this
field will then have the color Selection.). With the keys Pg up and Pg down the value of the entry field can
be increased or decremented in predefined steps with consideration of the minimum- / maximum conditions.
The steps are defined with the option Inc/Dec in tab Input.
When a direct input of the value is preferred, you can press the Enter key or click with the left mouse button
on a field (the entry field will then have color Input). With the Enter key the entered value will be accepted,
with the Esc key the initial value will be restored.
The data input can be aborted with the Esc key. If on tab Input the option Takeover changes at the end of
data input is activated, all performed changes are discarded. Without this option all value modifications are
executed immediately.
The data input will be ended with a defined shortcut or by toggling the system-element _InputStop. In this
case all buffered changes will be transferred to the database.
During the data input are for data input objects possible dynamic color modifications not recognizable.
During the data input, other operations such as buttons and keys are possible, only the picture change is
disabled. In case _NewPic was changed during the data input, the picture change will be executed after the
data input has ended.
The system-element _Input will be toggled at every change of a data-element during the data input.
On tab Input you can define the data input settings for the picture. You determine, which notification-trigger
shall be used, in which colors the entry field shall be shown during the data input and the shortcuts to start
and end the data input.
93
Manual AMS Asset Graphics 5.4
Option Description
Trigger (The following triggers are notification-trigger. If you do not want this information, leave
the field empty.)
At start input Here you define the data-element, that is triggered at the start of the data input.
At end input Here you define the data-element, that is triggered at the end of the data input.
At abort input Here you define the data-element, that is triggered, when the data input was aborted with
the Esc key.
Color
In order to find the individual entry fields on the screen and to select one of them for the
input, different background and text colors are assigned to every data input field. The
colors are dependent on the current data input status of the object.
Click with the mouse on the color fields to select a color from the color palette.
Active The colors for background and text, in active status.
Selection The colors for background and text show, that this entry field is selected.
Input The colors for background and text show, that a direct input is currently performed in
this entry field.
Modified The colors for background and text show, that the changed value in this entry field will
be buffered.
Operating management
Password level Enter the access right, or click with the right mouse button to open dialog Select access
right and to select the right.
Log level Enter here a Log level.
Keyboard Here you can define the keys to start and end the data input.
Start Click on the browse-button to open dialog Shortcut.
End
Option Description
View options
Always visible If highlighted, the touch panel input window will always be visible.
Visible at A num-element can be entered here, to control the visibility of the touch panel
window.
Coordinates
Use project The project settings will be used.
definition
Absolute With this option, the touch panel window will be set to a fixed position.
(Position X and Y)
See also
Touch panel (Step-by step instructions)
Touch panel Project properties
Touch panel Object properties
94
Graphic
Tab VBScript
Here you enter mathematical and logical expressions. A detailed description can be found in VBScript.
Note The VBScript, written here, is called picture script, because it is active as long as the picture is picture
is loaded.
See also
Tab Input for objects
Testing data input
Shortcuts (Project/picture)
Select menu command Properties | Project | Shortcuts or Properties Picture Shortcuts to define
shortcuts for the complete project or picture. The shortcuts can be programmed with actions, which are
executed, when the corresponding shortcut is pressed.
Option Description
Shortcut Click with the right mouse button to open dialog Shortcut and select a key combination.
Element Enter the name of the data-element, whose value you want to change with the shortcut.
Action Here the action type is defined. Click with the right mouse button in this column, to open dialog
Action and select one.
Value Enter here a constant, a num- or a text-element as parameter for the action.
Minimum/ Define here the minimum or maximum values, that may be reached. Constants or num-
Maximum elements may be entered here.
Type Into column Element you can enter num- or text-elements. Click the right mouse button on this
field to open dialog Select Type.
Note At type TXT only the action SET is possible.
P-Level Enter the value for access right, or click with the right mouse button to open dialog Select
access right and to select a user right.
Log Enter here a Log level.
Note These shortcuts are only active, if the shortcuts are pressed, when the visualization has the input
focus.
See also
Define functions keys (step-by-step instructions)
95
Manual AMS Asset Graphics 5.4
Project
Project
In menu item Properties | Project you find commands to set project properties. A project property is for
instance a global VBScript or the size of the main window of the visualization.
When you have made changes here, you will be asked before leaving the Graphic Editor, whether the
changes of the project settings shall be saved.
The following commands can be selected here:
Visualization...
Shortcuts
Fonts...
Flashing colors...
With the command Rename elements... elements used in the project properties can be renamed.
Note The commands are only selectable, when a picture of a project is open.
Properties Visualization
Select command Properties | Project | Visualization... to define the properties of the visualization of the
current project. The dialog Properties Visualization appears.
Tab Design
On this tab you define the start picture and the size of the visualization window on the screen.
Option Description
Start picture Press the browse-button to open the dialog File selection. Select the picture that you
want to have opened first, from the pictures stored in the current project. Confirm the
dialog with Open.
The predefined picture name is Main. If you have now created a picture Main, this will
be shown first when starting the visualization.
Picture size Here you can define, whether the visualization window shall cover the total screen or
only over a part of it.
Note When you define another size for the absolute or relative window size as was
set before, the contents of the window will also be adjusted, thus will be greater or
smaller correspondingly.
Relative Select this option, when size of the window shall be set relative to the screen
resolution.
Full screen Select this option, when the visualization window shall have the same size as the
screen resolution.
96
Graphic
Option Description
Absolute With this option you define an absolute size for the visualization window.
Position Enter the x-position of the window into the left entry field and the y-position into the
right field.
Size Enter the width of the window into the left field and the height into the right field.
Note It is possible to enter greater values here as the current screen resolution. In this
case scrollbars will be shown, if the screen size is smaller than the window. This
option is also helpful, when the project planning is made at a smaller screen, as will
be used later during runtime.
See also
Working with different screen resolutions
Information The options, outlined here, serve the information on the currently selected screen
resolution and the drawing area, available for AMS Asset Graphics.
Graphic resolution In the left field, the x-expansion of the current screen resolution appears and in the
right field the y-expansion.
Window size Here you see the drawing area, available for AMS Asset Graphics. It corresponds to
the screen resolution, when the window size complete picture was selected and when
no title bar is displayed (See also tab Window styles). When no complete picture was
selected, it corresponds to selected window size. When a title bar was displayed, the
height of the drawing area will be reduced by the vertical expansion of it.
Option Description
Title bar
Active Activate this option, when you want to show a title bar. When you do not activate the
option, you cannot make further entries here.
Title Enter the text for the title bar. Variables may also be used in the text.
System menu Activate this option, when the system menu shall be displayed to the top left of the screen.
Note When this option is not activated, the other options (symbol field, zoom field, thick
frame and movable) will also remain inactive.
Symbol field Activate this option, when the symbol field shall be displayed in the title bar. With the
symbol field you have the option to minimize the visualization window.
Zoom field Activate this option, when the zoom field shall be displayed in the title bar. With the zoom
field you have the option to maximize the visualization window or to restore its previous
size.
Thick border Activate this option, when a thick frame shall be drawn around the window. This is
necessary if you want to resize the window with the mouse.
Movable Activate this option, when the user shall have the possibility to move the window manually.
Tab VBScript
Here you enter mathematical and logical expressions. A detailed description can be found in VBScript.
Note The VBScript, written here, is called project script, because it is active as long as the visualization is
running. That means you can write functionality, which is independent from pictures.
97
Manual AMS Asset Graphics 5.4
Shortcuts (Project/picture)
Select menu command Properties | Project | Shortcuts or Properties Picture Shortcuts to define
shortcuts for the complete project or picture. The shortcuts can be programmed with actions, which are
executed, when the corresponding shortcut is pressed.
Option Description
Shortcut Click with the right mouse button to open dialog Shortcut and select a key combination.
Element Enter the name of the data-element, whose value you want to change with the shortcut.
Action Here the action type is defined. Click with the right mouse button in this column, to open dialog
Action and select one.
Value Enter here a constant, a num- or a text-element as parameter for the action.
Minimum/ Define here the minimum or maximum values, that may be reached. Constants or num-
Maximum elements may be entered here.
Type Into column Element you can enter num- or text-elements. Click the right mouse button on this
field to open dialog Select Type.
Note At type TXT only the action SET is possible.
P-Level Enter the value for access right, or click with the right mouse button to open dialog Select
access right and to select a user right.
Log Enter here a Log level.
Note These shortcuts are only active, if the shortcuts are pressed, when the visualization has the input
focus.
See also
Define functions keys (step-by-step instructions)
Option Description
Color1 Click with the left mouse button, to open dialog Color selection. Select the color, that shall flash
in change with Color2.
Color2 Click with the left mouse button, to open dialog Color selection. Select the color, that shall flash
in change with Color1.
Interval Here you define the flashing interval. Possible values are .0.5 to 5 seconds.
98
Graphic
Option Description
Name Name of the font, e.g. ButtonLarge.
Font Name of the font.
Size Size of the font as type size.
Bold Attribute bold.
Italic Attribute italic.
Comment Possible comment for the font.
Visualization
Purpose of the visualization is the presentation of the static and dynamic objects, which were defined in the
Graphic Editor.
99
Manual AMS Asset Graphics 5.4
Using
100
Graphic
101
Manual AMS Asset Graphics 5.4
Activate the option Active in group Horizontal. Into the entry field on the right you have to enter the
name of the num-element, which value shall control the horizontal size. In the example above,
origin Center was selected to change the size of the text simultaneously to the right and to the left.
With fields Value and Percentage it can be defined, which change of the value shall correspond to
which change in percent of the horizontal size. In the example, the range of values of the num-
element TextSizeX is 0 to 5 which is scaled to a percentage of 50% to 100%.
According to this value 2 corresponds to 70%.
The text shall change in both directions, horizontally and vertically. For this reason you have to
activate also the switch Active below text Vertical. In this example, the vertical size will be
controlled by the same num-element as the horizontal size.
Confirm the dialog with OK and save you changes.
102
Graphic
Mark the first circle and click on button Create metafile from selected objects in toolbar Draw
and save the metafile, in this example with name Engine1_ON. With this, a new graphic-object
was generated, which is highlighted now. Delete it with key Delete.
Proceed in the same way with the second circle and name the metafile Engine1_OFF.
Double-click on the graphic object to open dialog Properties graphic.
Select tab Graphic files.
Into the entry field on the right, you have to enter the name of the num-element, which shall
control the appearance of the graphic files, in this example Engine1_OFF.
Click on button Insert.
Into the second line below metafiles you have to enter the file, which shall be displayed, when
the Num-element Engine1 has got value 1, in this example Engine1_ON.
Confirm the dialog with OK and save your changes.
103
Manual AMS Asset Graphics 5.4
Activate the option Active. Into the entry field on the right you have to enter the name of the num-
element, which value shall control the rotation of the line.
Enter the bottom right endpoint of the line in field Rotation center. In tab Graphic you can check
the coordinates of the bottom right endpoint.
With fields Value and Angle it can be defined, which change of the value shall correspond to the
rotation angle. In the example above the range of values of the num-element LineAngle is 0 to
90, which is scaled to a change of the angle of 0° to 90°. Therefore, a change of the num-element
LineAngle by 35 corresponds to the change of the angle of 35°.
Confirm the dialog with OK. The pivot point is displayed as a little cross.
Save your changes.
104
Graphic
The minute-pointer shows on 30, the grouped object has a size of 130%.
The minute-pointer shows on 55, the grouped object has a size of 155%.
105
Manual AMS Asset Graphics 5.4
Set the option Active below Horizontal. Enter system-element _Min01 into the edit field to the
right of it, the value of this element will be increased every minute from 0 to 59 and shall thus
control the horizontal change of the size. In the example above, Origin center was selected to
change the size of the group object simultaneously to the right and to the left. With fields Value
and Percentage it can be defined, which change of the value shall correspond to which change in
percent of the horizontal size. The value range of system-element _Min01 is 0 to 60, which is
scaled to a percentage change of 100% to 160%. According to this, value 30 corresponds to a
horizontal width of 130%.
The group element shall change in both directions, horizontally as well as vertically. For this
reason you have to activate also the checkbox below Vertical. The vertical expansion will also be
controlled with system-element _Min01. The remaining interface settings in field Vertical are the
same as in field Horizontal.
Confirm the dialog with OK and save your changes.
106
Graphic
Enter the num-element (or a VBscript) which value shall be displayed as number into field Value.
Select alignment Right.
With Numerical format you define the total number of digits that are displayed and the number of
After digits. Please note, that the decimal point is included in this number. In the example above,
the num-element Silo1 will be displayed with 3 digits and without digits behind the decimal point.
The selected dimension is m ³.
Confirm the dialog with OK and save your changes.
107
Manual AMS Asset Graphics 5.4
108
Graphic
Set option Active below Fill color to control the fill color dynamically.
Enter the name of the same num-element, which you have entered on tab Fill, into the entry field
to the right, in our example FillColor.
Enter the value ranges for the different colors and the corresponding colors into the fields below.
In this example, the filling level indicator shows the black color in the range < 4, between 4 and
400 blue, as of 400 the color green, etc. and as of 1024 the indicator will always be red.
Note The range of values must have an ascending order.
Confirm the dialog with OK and save your changes.
109
Manual AMS Asset Graphics 5.4
Define setpoints
AMS Asset Graphics offers a comfortable possibility to enter data directly in the picture into special
configured fields. For this, numbers or text objects are defined that way, that they can take up numerical
values or texts. It will be defined for the total picture, how the user activates and deactivates the input and
with which colors the input fields will be shown.
This could e.g. look like this:
Draw an object of type Number in the Graphic Editor. At first you have to proceed as if you just
would like to display the number (see Displaying a numerical value).
To permit a data input, select tab Input and set the option the option Active.
With Element you specify the name of the num-element, which shall be changed with the data
input.
Note You should enter the same num-element that was also entered on tab Number in field
Value.
With Minimum and Maximum you can limit the value which can be entered.
In field Inc/Dec you have to define, by which amount the data-element shall be
increased/decreased when the operator presses the key PgUp or PgDn.
Confirm the dialog with OK.
With this definitions you have created an entry field. Now, you can define further entry fields of type
Number or also of type Text. The definition of text entry fields correspond to those of the text-
elements, with the only difference that not num-elements but just text-elements are changed.
Now define how the data input shall be activated and deactivated and how it shall be represented
visually.
Select in the main menu Properties | Picture | Picture properties... or click the right mouse button
and select Picture properties in the context menu. Select tab Input.
Select in field Colors different colors for the background and the text for the entry fields. The
color, which you enter into field Active will be displayed when the input is activated, this applies
for all entry fields except for the currently selected one. You define the color of this field upon the
moment of Selection. The color, which you enter into field Input, is shown in the selected field,
namely if this field was enabled for the input with the Enter-key.
In field Keyboard you define the shortcuts for starting and ending the data input. Select the
browse-button beside Start and click on the wanted key or key combination in dialog Shortcut.
Confirm the dialog with OK. The button will be shown directly beside Start. When you press the
shortcut in the visualization the data input will start.
Proceed likewise for the key to end the data input.
Confirm the dialog with OK and save your changes.
110
Graphic
Note The definitions you have made for the input, shall only valid for the picture for which you have
saved them. If other pictures shall have the same input properties, these properties must be saved in a
default project or defined again newly.
111
Manual AMS Asset Graphics 5.4
112
Graphic
113
Manual AMS Asset Graphics 5.4
To avoid deformations, you have to define the picture size that way, that it corresponds to the size
of the operation window in the large picture. For this you have to select the menu command
Properties | Picture | Picture properties.
Define the picture as a sub picture in the group Picture size. The picture size can be configured
Relative, Full screen or Absolute.
The size of the sub picture has to be entered under option Window size.
Enter a name for the picture and open the parent picture in which the operation window shall be
opened.
Select command Window in toolbar Draw.
Draw a window on the screen. A window is drawn like a rectangle (see Drawing basic forms). As
long as no properties have been defined you will see an empty window with a frame.
Double click on the window to open the dialog Properties Window.
Select tab Design.
Press the browse-button next Picture name to show the dialog for File selection and to select
your sub picture.
Select the Window type. If you select Popup, the operation window will be placed in front of the
other picture objects, by selecting Child window it will be placed behind them.
You may draw the window with either no frame or with a thin or a thick frame line.
If necessary the window can display Scrollbars or always shows the complete picture. When
selecting the option Original window size the sub picture uses the size defined for the sub
picture.
114
Graphic
If you want to display a title bar, set the relevant checkbox and enter the Title into the entry field.
Select a color for the background of the headline. If you want to display System menu, Symbol
field or Zoom field or if you want to move the total window, you have to activate the relevant
options.
Select tab View options in dialog Properties Window.
Enter a num-element into the entry field beside Visible at to control the visibleness, e.g.
ShowPanel. If element ShowPanel is set on 1, the window will be opened, if it is set on 0,
the window will be closed again.
Your sub picture is now ready. To control the picture there are more options. As an example, the
picture could be made invisible and be shown, only if required. After the set values or positions
have been defined completely, the window could be closed again. To open and close the window
you can use a button to execute this task.
To control element ShowPanel via a button select the command Button in toolbar Input.
Draw a button on the screen. A button is drawn like a rectangle (see Drawing basic forms). The
button will automatically be given the name "Button".
Double click on the button to open the dialog Properties Button.
Select tab Design and enter another name for the button into the entry field below Text, e.g.
Operator panel.
Select tab Function.
Enter into the first cell of column Element the element which controls the visibility of the operating
window, in our example the element ShowPanel.
Make sure that type NUM has been selected.
In the next column Action you define the action, that shall be started with this element by
pressing button Operator console. For this, click with the right mouse button on the first cell of
the column. Dialog Action will be opened.
Select action SWP. At this action, the value of the element changes between a minimum and a
maximum, i.e. when the value is on minimum, it will be set on maximum by pressing the button and
vice versa. Enter 0 in column Minimum and 1 in column Maximum. In doing so the value of
ShowPanel changes between 0 and 1. At 1 the operating window will be opened and at 0 closed
again. You do not have to enter any value into field Value.
Confirm the dialog with OK and save your changes.
115
Manual AMS Asset Graphics 5.4
Start the runtime program. A picture of your project could look like this:
116
Graphic
When pressing button Operator panel your picture could be like that:
Enter the new set values and positions in the operating window. By pressing button Operator
console the window will be closed again.
If you have in mind to use several operating windows for different set values or data-elements,
AMS Asset Graphics can ease your work.
Copy the first window and rename the element names, used here. Thus, you do not have to create
a new picture that you want to use as sub picture.
For this mark the original window and copy it (button Copy in toolbar Standard).
Then select button Paste. The new window can be inserted in any other picture as well.
Move the new window to the desired position.
Double click on the new window to open dialog Properties Window.
In case your window has got a headline which clearly refers to the original window, change the
title on tab Design.
Select tab View options.
If you have entered an element that controls the visibility, use another control element.
Select tab Function.
Select new names for the elements of your original window under Rename elements, so that the
new window can use other data-elements than the original window.
Enter the name of the element into column Original, which has been defined in the picture on
which the window does refer.
Enter a new name into column New, that shall be valid for this window.
Define in column Type, whether the element shall be a num- or a text-element.
Confirm the dialog with OK and save your changes.
117
Manual AMS Asset Graphics 5.4
Global shortcuts
It is useful, first to define the buttons which shall apply for the total project, e.g. bringing the Eventjournal in
the foreground in every picture with the key F9 (see Project shortcuts).
Note When you have defined the same button for a project as well as for a picture, the function for the
picture will be executed.
118
Graphic
119
Manual AMS Asset Graphics 5.4
Note These shortcuts are only active, if the Visualization has the input focus.
120
Graphic
To call the Eventjournal Runtime, the program must be started together with the other runtime programs.
This setting is made in the Project Manager.
Make sure that the project that you want to edit is opened in the Project Manager.
Open dialog Runtime configuration with the corresponding button in the toolbar.
Select the program Eventjournal from the list of the standard programs into the program list.
Note If the Eventjournal Runtime is the last program in the program list, it will be opened as topmost
program on the screen.
To call the Recipe Runtime, the program must be started together with the other runtime programs. This
setting is made in the Project Manager.
Make sure that the project that you want to edit is opened in the Project Manager.
Open dialog Runtime configuration with the corresponding button in the toolbar.
Select the program Recipe from the list of the standard programs into the program list.
Note If the Recipe Runtime is the last program in the program list, it will be opened as topmost program on
the screen.
121
Manual AMS Asset Graphics 5.4
Trend charts
Editor
Trend chart
Trend charts display the course of one or several datapoints as curve over a horizontal axis. Trend charts
use the data storage as a data source. Every diagram can display up to 28 data-elements at the same time,
shown in different colors. The scaling can be selected separately for every curve. Also a second Y-axis can
be displayed.
The divisions of the horizontal X- and vertical Y-axis are configured separately. Optional a grid can be
shown in the diagram. During the runtime, you can print trend lines and modify the scaling of the
coordinates, thus you can also access on historical data. In addition you can select one or several stored
datapoints and to display them as a trend line.
Select command Trend chart in toolbar Draw to place a trend chart on the screen. With a double-click on
the object or via the context menu you can open dialog Properties Trend chart.
The dialog contains several tabs to define the different properties of the object. The properties Graphic,
View options, Position, Size and VBScript are described in section using a property dialog.
122
Graphic
Tab X-axis
Option Description
Period Here you define the time period for the scaling of the x-axis. Time periods from one
second up to several years can be used.
Suppress When this marking is activated, the milliseconds from the time stamp of the datasets
milliseconds in the data storage files will not be taken into account.
Text
Color Here you define the color of the axis text.
Alignment Here you define the alignment of the text with an angle between 0 and 90°.
Format
Number Here you define the number of the vertical grid lines and of the appropriate
labeling. An input is only possible, if option Automatic has been deactivated.
Automatic If you want to have an automatic labelling, activate this checkbox.
Hour, Min, Sec, Milli By activating the relevant checkbox, you can define whether the x axis shall be
Year, Month, Day, labeled with year, month, day, hour, minute and/or second.
Dynamic period
Update This num-element provides the information, whether the automatic update of the
trend chart is on (1) or off (0). By writing the element the status can be changed
correspondingly.
Original size This control-trigger restores the initial range settings (this applies for the period and
the value ranges).
Width This num-element provides the information about the current used time period in
seconds. By writing the element the time period can be changed correspondingly.
Offset This num-element is used to scroll relative within the trend chart. In doing so the
automatic update of the trend chart will be disabled. Positive values (in seconds) will
scroll to future times, negative values to the past. After the scrolling the element will
automatically be set to 0.
123
Manual AMS Asset Graphics 5.4
Tab Profile
A so called profile is used to save the current settings of a trend chart, e.g. the value range, the displayed
datapoints or the line colors. These settings can be restored by loading the profile..
In the runtime profiles can be used by menu commands (loading and saving profiles).
Option Description
Designation You must enter here a string to enable the use of profiles. Profiles are stored with this
designation.
You can combine profiles of different trend chart, if you use the same designation.
Profile name You can enter here a text-element for the profile name, if you want to control the loading
externally, e.g. the profile name is set via a button.
AutoLoad Enter here the name of a profile, which shall be automatically loaded, when the trend chart
is created.
AutoSave Enter here the name of a profile, where the last settings are automatically be saved, when
the trend chart is destroyed.
The description of the tabs Y-axis, Help lines, Grid and Miscellaneous you find here.
Tab VBScript
Inside the VBScript of the trend chart the object name ThisObj can be used to access functions and
properties.
Functions and properties with VBScript.
Name Parameter Description
Functions
SetDataSource DSFileName Use this function to set the name of the data storing file.
As parameter a file name with the file extension iDSF or
an extension of a data storing archive (000 to 999) can be
used. If you address a filename without an extension, the
extension iDSF is used. If the parameter DSFileName is
only a file name without path, the data storing path is
used.
SetDateTime DateTime This function is used to set the displayed time at the right
corner of the trend chart. The parameter DateTime takes
the absolute date and time information.
OffsetX Seconds This feature moves the time. The parameter in seconds. A
positive number changes the time to right field. The
update of the timeline is automatically switched off.
ShowTrackingDlg This feature displays the tracking display.
HideTrackingDlg The tracking display is closed.
Print Print the trend chart on the default printer.
ShowSettingsDlg This feature displays the dialog properties trend chart.
Unzoom The display range, which is designed with the Graphic
Editor, is reinstated.
124
Graphic
Properties
TimeActual This property indicates/controls the automated update of
the time axis.
Width This property indicates/controls the width in seconds of
the trend chart.
ProfileIdentification Use this property to get or set the current profile
identification.
ProfileElementName This property indicates/controls the element with is used
to switch the between the profiles.
UseDataSourceInProfile With this property you control if the data storing file can be
changed with loading a profile. Set this property to true, if
the data storing file can be changed. The default value is
false.
XAxisMinimum, Minimum and maximum from the X-axis. Both variable
XAxisMaximum contain a value of type Date (see VBScript help).
Example:
ThisObj.XAxisMaximum = Now
ThisObj.XAxisMinimum = ThisObj.XAxisMaximum
- 1 / 1440
YAxisMinimum, LineNumber Minimum and maximum from the Y-axis. LineNumber
YAxisMaximum (started with 0) is the desired line.
Example:
ThisObj.YAxisMaximum(0) = 50
ThisObj.YAxisMinimum(0) = 10
125
Manual AMS Asset Graphics 5.4
Example:
Set ArchiveDate = CreateObject("PMS.TxtEle")
ArchiveDate.SetName("ArchiveDate")
dummy = ArchiveDate.IsChanged
Sub OnRun
If ArchiveDate.IsChanged Then
ThisObj.SetDataSource ArchiveDate.Value
ThisObj.TimeActual = true
End If
End Sub
In the above example, the data storage file is changed by a text-element.
Function ChangeLabelStr
The function ChangeLabelStr is called during the drawing of the trend. With this function the labels on the X
and Y axis can be modified.
126
Graphic
Example:
Sub ChangeLabelStr (LabelStr, LineNumber, LabelNumber, Value)
If LineNumber = -1 Then
LabelStr = "X: " & LabelNumber & "; Value: " & Value
Else
LabelStr = "Y-" & LineNumber & ": " & LabelNumber & "; Value: " & Value
End If
End Sub
You can also use functions OnStart (initialization), OnRun (cyclical) and OnEnd (end of Operation Log
Runtime). A detailed description of the possible functions can be found in section VBScript.
See also
Trend chart runtime
Displaying a trend chart
XY-trend chart
XY-trend charts display the course of one or several datapoints as curve over a horizontal axis. Differently to
the time related trend charts, the horizontal axis is not a time axis, but a value-axis (such as the vertical
axles). XY-trend charts use a CSV file as data source.
Note By means of the CSV-Export of the data storage data storage files can also be used indirectly as data
source.
For the representation of the data all datasets of the CSV-file will be read. One value of the dataset defines
the X-value, up to 28 values, marked with different colors, can be displayed as Y-value over the X-value. A
line will be drawn with all data from first to the last dataset. The scaling can be selected separately for every
curve.
For every XY-trend chart the properties of the horizontal X- and vertical Y-axis are defined separately. As an
option a grid can be shown in the diagram.
You can print XY-trend chart and modify the scaling of the coordinates, thus you can also access on other
ranges of values. In addition, you have the possibility, to select one or several stored datapoints and to
display them as one of the 28 lines.
Select command XY-trend chart in toolbar Draw to place a XY-trend chart on the screen. With a double-
click or via the context menu you can open dialog Properties XY-trend chart.
The dialog contains several tabs to configure the different properties of the object. The properties Graphic,
View options, Position, Size and VBScript are described in section using a property dialog.
127
Manual AMS Asset Graphics 5.4
On tab Data source you can define, on which CSV-file shall be accessed under which conditions.
Option Description
Source file Enter here the name of the CSV-file including directory, from which the trend lines
shall be loaded at runtime. Use button Browse, to select an existing file. For the input
you can use also variables e.g.: @_ProjectPathCSV_files\DATA.CSV. The file
name has to be entered with extension.
Format
CSV separator Here you configure the separator char, which shall be used when reading the CSV
file. The following chars are possible: comma, semicolon, tabulator and space.
Trigger
Start reading Enter here the name of a data-element, which starts the reading of the CSV-file
(control-trigger), as soon as the data-element changes.
Reading complete Define here the name of a num-element, which has to change when reading of the
CSV-file and drawing is complete (notification-trigger). The element will also be
changed in case of an error. The element will be increased by 1 and reset on 0 when
reaching 255.
Error
Number This num-element will be set on 1 after completing the action successfully and on -1 in
case of an error.
128
Graphic
Option Description
Variable Enter here for the X- and Y-values the name of a column in the CSV-file. If on tab Data
source a file is indicated with parameter Source file, which can be read also by the editor
(file already available and no variable used), a choice of the column name is possible via a
selection list. CSV-Dateien without description have the following column names [1] for
the first column, [2] for the 2. column etc.
At CSV-files with description, the column name must be indicated.
Name Here you enter a name for the value column. If a name is indicated, this name will be used
instead of the variable name for the label of the axis (X-Axis) or for the legend text (Y-
axis).
Color Each of the 28 lines can be assigned an individual color.
From / To Every variable may have an individual range of values, that you have to enter in field
From / To. The various ranges of values will then also be visible in the scaling. You can
also use num-elements, to achieve a variable scaling.
Single scaling If all variables are in the same range of values, activate this option. In this case, all
variables will have the same scaling. Define here the color and the ranges of values.
You can configure further properties for a line with command Options....
Tab X-axis
On this tab you configure the properties of the horizontal X-axis.
In group Format you define the angle of the axis text. You can select in this group, whether the number of
the scale-subdivisions of the X axis shall be defined automatically. Alternatively you enter a number
manually. By choosing the automatic description, the number of scale subdivisions will be adjusted
automatically to the range of the trend line. In addition, you decide the format of the number at the X-axis.
Option Description
Label
Alignment Here you define the alignment of the text.
Color In this color the text of the axis will be drawn.
Automatic If you want to have an automatic labeling, activate this option.
Number Here you define the number of the horizontal grid lines and of the appropriate labeling. An
input is only possible, if the option Automatic is deactivated.
Format
Automatic Here you can enable the automatic calculation of the number of digits.
Decimal If you have deactivated option Automatic, you define here the decimal digits.
digits
129
Manual AMS Asset Graphics 5.4
The description of the tabs Y-axis, Grid and Miscellaneous you find here.
Tab VBScript
Inside the VBScript of the XY-trend chart the object name ThisObj can be used to access functions and
properties.
Functions and properties with VBScript.
Name Parameter Description
Functions
SetRedraw bEnable This member function sets or clears the redraw flag. While the
redraw flag is cleared, the contents will not be updated after each
change and will not be repainted until the redraw flag is set again.
For example when setting multiple variables (function
SetVariable) it makes sense to clear the redraw flag with
ThisObj.SetRedraw false. After setting all variables the redraw
flag is enabled with ThisObj.SetRedraw true.
SetSize LineNumber, Set the number of points used for the line assigned with
nValues LineNumber (starting with 0). When setting the values by
VBScript this function has to be used. nValues is the number of
requested points.
SetXAxisVariable VariableName This function is used to set the variable for the X-axis. If the CSV
data is used, all data curves are using the data from this variable.
SetVariable LineNumber, Use this function to assign the curve to another data point.
VariableName LineNumber (started with 0) is the requested line. VariableName
130
Graphic
SetXYValue LineNumber, With this function one data point is set of the curve assigned with
Index, LineNumber (started with 0). Index (started with 0) is used to
x, assign the point. The parameter x and y are used to display the
y point.
PlotXvsY LineNumber, This function set the data from all points with two arrays. The first
x, parameter selects the curve (starting with 0). The second includes
y all X values, and the third all Y values.
PlotXvsY2 LineNumber, The same function as PlotXvsY, but the two arrays are passed as
x, pointers.
y
Refresh This function forces a redraw of the XY-trend chart.
Unzoom The display range, which is configured in the Graphic Editor, is
reused.
Properties
UseCsvFile This variable indicates whether the projected CSV file is used or
not. Set this variable to false, the CSV file is no longer read, and
the data can be set via VBScript.
AutoScaleX With this property the auto scale function of the X axis is
activated.
Example:
ThisObj.AutoScaleX = true
XAxisMinimum Minimum and maximum from the X axis.
XAxisMaximum Example:
ThisObj.XAxisMinimum = -20
ThisObj.XAxisMaximum = 20
AutoScale LineNumber With this property the auto scale function of the Y axis is activated.
LineNumber (started with 0) is the desired line.
Example:
ThisObj.AutoScale(0) = true
YAxisMinimum LineNumber Minimum and maximum from the Y axis. LineNumber (started with
YAxisMaximum 0) is the desired line.
Example:
ThisObj.YAxisMinimum(0) = 10
ThisObj.YAxisMaximum(0) = 50
EnableZoom With this property the zoom function is enabled/disabled. The
default value is true.
EnablePopupMenu Use this property to enable/disable the popup menu at runtime.
The default value is true.
LineColor LineNumber This property can be used to read the color (RGB value) of a line.
LineNumber (started with 0) is the requested line. The property is
read only.
131
Manual AMS Asset Graphics 5.4
Example:
ThisObj.UseCsvFile = False
ThisObj.SetSize 0, 1024
dim xValues(1024)
dim yValues(1024)
PI = 4 * Atn(1)
delta = 2*PI / 1024
phi = 0
Sub OnRun
For i = 0 To 1023
xValues(i) = sin(phi*15) * i/1023
yValues(i) = cos(phi*15) * i/1023
phi = phi + delta
Next
phi = phi + delta*2
ThisObj.PlotXvsY2 0, xValues, yValues
ThisObj.Refresh
End Sub
In the above example, in each program cycle 1024 points are calculated and set to the XY-trend chart
Function ChangeLabelStr
The function ChangeLabelStr is called during the drawing of the trend. With this function the labels on the X
and Y axis can be modified.
Example:
Sub ChangeLabelStr (LabelStr, LineNumber, LabelNumber, Value)
If LineNumber = -1 Then
LabelStr = "X: " & LabelNumber & "; Value: " & Value
Else
LabelStr = "Y-" & LineNumber & ": " & LabelNumber & "; Value: " & Value
End If
End Sub
You can also use functions OnStart (initialization), OnRun (cyclical) and OnEnd (end of Operation Log
Runtime). A detailed description of the possible functions can be found in section VBScript.
See also
Displaying a XY-trend chart
XY-trend chart runtime
Access to data storage files
132
Graphic
Tab Y-axis
Option Description
Text alignment
Left axis Here you enter the alignment for the text at the left Y-axis. Valid values are -90 to 90°.
Right axis Here you enter the alignment for the text at the right Y-axis. Valid values are -90 to 90°.
Format
Automatic If you want to have an automatic labeling, activate this checkbox. In this case, the
number of horizontal scale subdivisions will be adjusted automatically to the range of the
trend chart.
Number If the option Automatic is disabled you can enter here number of the horizontal grid
lines manually.
Tab Grid
On this tab you define the design of the grid of the trend chart. The number of vertical main grid lines you
configure on tab X-axis, the number of the horizontal main grid lines you configure on tab Y-axis in group
Format.
Minor grid lines subdivide the main grid in addition and are shown as dotted lines.
Option Description
Horizontal Here you define the design of the horizontal grid lines.
Active If the horizontal grid lines shall be shown, activate this checkbox.
Main grid Define the color of the horizontal main grid lines by pressing this button.
color
Line Define the thickness of the horizontal lines with a number between 1 and 9.
thickness
Minor grid Defines the color of the minor grid lines.
color
Minor grid If you want to have displayed minor grid lines in between the horizontal main grid lines,
lines enter the corresponding number here.
Vertical Here you define the design of the vertical grid lines.
Active If the vertical grid lines shall be shown, activate this checkbox.
Main grid Determine the color of the vertical main grid lines by pressing this button.
color
Line Define the thickness of the vertical lines with a number between 1 and 9.
thickness
Minor grid Defines the color of the minor grid lines.
color
Minor grid If you want to have minor grid lines in between the vertical main grid lines, enter the
lines corresponding number here.
Border color With this command you change the border color.
133
Manual AMS Asset Graphics 5.4
Option Description
Color Color of help line
X1, The both endpoints of each line are defined with these four columns. Two respective columns
Y1, define one point with X and Y value. In the trend chart, the bottom left corner is defined by X=0
X2, Y2 and Y=0, the top right corner is defined with X=1 and Y=1. Instead of constant numbers, you can
enter here also num-elements.
Opt. With this command you open dialog Line. Here you define style and width of the line.
Tab Miscellaneous
Option Description
Legend The legend shows besides the names of the variables, lines in the corresponding
color and thickness.
Active Activate this option to show the legend.
Text color With this command you can configure the text color of the legend.
Tracking lineal
Color Select here the color for the tracking lineal. You should select a color, which has a
good contrast with the values (drawn in the colors of the lines).
Trigger elements Here you can configure optional control-triggers to start several actions. Thus, these
actions are available, even without using the mouse.
Tracking dialog Enter here a num-element to switch on displaying of the tracking dialog, e.g. system-
element _F9.
Tracking lineal Enter here a num-element, to switch on displaying of the tracking lineal, e.g. system-
element _F10.
Edit properties Enter here a num-element, to open the property dialog of the trend chart.
134
Graphic
Properties line
This dialog contains one tab to configure properties for a drawing line.
Tab Standard
Option Description
Line Define here line style and size of the line. The line style can be set to no line.
Symbol Here you select a symbol, which distinguishes this line from the other lines by its color
(important for printouts on monochrome printers).
Surface You can assign another color to this symbol.
color
Number format
Automatic Activate this option, to activate the automatic calculation of the number of digits at the Y-
axis.
Total digits When you deactivate option Automatic, you have to define the number of total digits here.
At the total number of digits, the decimal point will be calculated as one digit. Enter here a 0,
if no labelling for the Y-axis is desired.
After digits When you deactivate option Automatic, you determine here the number of digits after the
decimal point.
Unit Enter the unit of the variable into the entry field.
Note When you have selected a single scaling on tab Trend lines, only the unit of the 1.
line in the scale will be used.
Not If the dimension shall not be shown, activate this parameter switch.
displayed
Assign to Y- If the dimension shall be shown at the scale, activate this option.
axis
Legend Enter here a text, which is used in the legend instead of the variable name. If no entry is
made here, the variable name is used.
At runtime an additional archive selection is offered to select further data storage files as source.
135
Manual AMS Asset Graphics 5.4
Runtime
Trend chart
Trend charts display the course of one or several datapoints as curve over a horizontal axis. Trend charts
use data-elements, that were stored before in a data storage table.
Every diagram can display up to 28 data-elements at the same time, shown in different colors. The scaling
can be selected separately for every curve. Also a second Y-axis can be displayed.
To record data, the Data Storage Runtime must be entered into the program list in the Project Manager in
dialog Runtime configuration.
By clicking with the right mouse button on a trend chart window, a context menu will be opened, where the
scaling of the axes and presentation designs can be changed and historical data shown. The program will
continue to record the current data.
Zoom-in
With the zoom function a part from the trend chart will be displayed enlarged. At that, the automatic update
of the trend chart will be switched off automatically.
1. Click with the left mouse button in the trend chart, and keep the mouse button pressed.
2. Move the mouse pointer, till the desired range has the correct size. The range will be shown inverted.
3. Release the mouse button. The selected range will now be represented enlarged.
See also
Display archived data in a trend chart
Dialog Trend chart
Tab General
Here you change the period and the data-elements to be displayed.
Option Description
Update When this function is switched on, changes in the data storage are represented immediately
in the trend chart. When the function is switched off, at the time indication the last time will be
shown that shall be represented.
Period Here, the time period is defined, that shall be displayed. The time period is entered in
seconds, minutes, hours, days, weeks, months or years.
Time/Date Here, the end time of the period is defined, that shall be displayed.
Lines The scaling of the lines can be predefined separately for every variable.
Variable Here, the data-elements are selected, which shall be presented. There are all data-element
for choice, which are used in the data storage table. If a curve shall not be shown, select (no
line).
From, To From defines, with which value the element starts at the origin. To is the maximum value to be
represented.
Color Every variable should be assigned an individual color.
Opt. You can configure further properties for a line with command ....
136
Graphic
Tab Tracking
Option Description
General
Calculate intermediate Set this option to display not only the recorded values, but also interpolated
values values.
Ruler
Color Select a background color for the tracking lineal.
Delete all positions All historical lineal positions will be deleted. The displayed historical rulers are
deleted.
Tracking views
Tracking dialog
A vertical line in the trend chart shows the position of the values to be indicated. By moving the mouse
pointer this position can be changed.
Option Description
Time Here you see the time stamp of the ruler at the current mouse position
(table) The table displays variable names and the values at the current position.
Tracking ruler
Another option to see numerical values at different positions is the tracking ruler. The tracking draws a
vertical ruler at the current mouse position. The current values are displayed on the line.
This menu command Tracking ruler shows or hides the ruler.
137
Manual AMS Asset Graphics 5.4
By clicking with the right mouse button on a trend chart, a context menu will be shown.
The property dialog, the Tracking dialog, the Tracking ruler and the command Print can be called also
over a function key or a button (see tabs Miscellaneous and Print).
Command Description
Update When this function is on, changes in the data storage are displayed immediately in the
trend chart.
Note When you zoom in a part of the trend chart, the update will be switched off
automatically. Switch the update on again, to show up-to-date data.
Default range With this command the original ranges of time and values, as defined in the Graphic
Editor, are restored. If the update is switched off, the end time (time at the right side) will
remain unchanged. With the update switched on, the end time will be set on the time of
the most current dataset in the data storage file.
Tracking dialog The Tracking dialog displays the values of a trend chart as numerical values.
Tracking ruler This command shows or hides the tracking ruler.
Print Select this command, when you want to print the trend chart.
Trend charts will be printed colored on color printers. On monochrome printers, the lines
are printed in different patterns.
Profile This submenu is displayed, if the profile mode is enabled for the trend chart. You can
load, save and delete profiles.
The selection of a profile is made in the dialog Profile selection.
Properties With this command the dialog Properties trend chart is opened.
XY-trend chart
XY-trend charts display the course of one or several datapoints as curve over a horizontal axis. Differently to
the time related trend charts, the horizontal axis is a value-axis (such as the vertical axles).
XY-trend charts use a CSV file as data source.
By clicking with the right mouse button over a XY-trend chart, the context menu is opened. Here you find the
commands to restore the original range, to show the tracking dialog or to print the chart.
Zoom-in
With the zoom function a part of the XY-trend chart will be displayed enlarged.
1. Click with the left mouse button in the XY-trend chart, and keep the mouse button pressed.
2. Move the mouse pointer, till the desired range has the correct size. The range will be shown inverted.
3. Release the mouse button. The selected range will now be represented enlarged.
138
Graphic
Option Description
X-Axis
Variable Here a variable from the CSV-file is selected, which is used for the X-axis. All variables of the
CSV-file are for choice.
From, From defines, with which value the X-axis starts at the left. To is the maximum value to be
To displayed.
Y-Axis
Variable Here variables from the CSV-file are selected, which shall be displayed. All variables of the
CSV-file are for choice. If a line shall not be shown, select (no line).
From, The scaling of the lines can be defined separately for every variable. From defines, with which
To value the element starts at the origin. To is the maximum value to be displayed.
With the command Archive you open a dialog to select a CSV-File. The start directory of the CSV-file
selection is the directory of the CSV-file, currently shown in the XY-trend chart.
If another CSV-file is selected, the column assignment in dialog Properties XY-Trend chart will be
readapted. At this, the column names, presently selected, will be searched for in the new CSV-file and, if
possible, pre-selected in dialog Properties XY-Trend chart. If the variable name is not found, no line will be
selected.
With the command Original all XY-trend chart settings will be reset again on their original values. In
difference to function Original range in the context menu, beside the loading of the original ranges also the
column assignment and the CSV-File will be reset on their original values.
If in the definition, a file name with variables is defined as data source, the program will "switch" on the file,
which is currently defined by the variables.
Tracking dialog (XY-trend chart)
A cursor (cross) in the XY-trend chart shows the position of the values to be indicated. By moving the
mouse pointer this position can be changed.
Option Description
X The X value at the current cursor position is displayed.
value
Y The Y values at the current cursor position are displayed here. A unit will be shown behind the
value value, if it is configured for the Y-axis.
139
Manual AMS Asset Graphics 5.4
By clicking with the right mouse button on a XY-trend chart, a context menu will be shown.
The property dialog, the Tracking dialog and the command Print can be called also over a function key or
a button (see tabs Miscellaneous and Print).
Command Description
Default range With this command, the original range of values at the X-axes and Y-axes, that was
defined in the Graphic Editor, can be restored. If no constant but variable elements are
defined, the current values of the elements define the original range.
Tracking dialog The Tracking dialog displays the values of a XY-trend chart as numerical values.
Print Select this command, when you want to print the XY-trend chart.
XY-trend charts will be printed colored on color printers. On monochrome printers, the
lines are printed in different patterns.
Properties With this command the dialog Properties XY-trend chart is opened.
A profile stores various settings like value range, variables name or the line color.
With this dialog you select a profile
140
Graphic
Using
Displaying a trend chart
Trend charts access on stored data and display them online or show historical diagrams for a selected time
period.
141
Manual AMS Asset Graphics 5.4
For the next, draw the trend chart and assign it to this data storage table.
Start the Graphic Editor (button Graphic Editor in toolbar Development in the Project Manager).
Select the picture, in which the trend chart shall be displayed or open a new picture.
Press button Trend chart in toolbar Draw in the Graphic Editor.
Draw a trend chart in the picture. A trend chart is drawn like a rectangle (see Drawing basic
forms).
Double-click on the trend chart to open dialog Properties trend chart.
On tab Graphic you can change the color of the border and the surface.
Select tab Trend lines.
Select a data storage table with option Data storage.
In the table you can enter up to 28 variables, which data shall be displayed as lines.
Into the fields From and To you configure the range for the data-elements.
Then you define the Color for a line.
Press button Option to configure more properties for the line.
Define here line style and thickness and the Number format for the Y-axis. With Unit you define
whether the unit of a data-element shall be shown or not.
Confirm the dialog with OK.
Make your definitions for as many data-elements as you want to have displayed in the trend
chart.
142
Graphic
143
Manual AMS Asset Graphics 5.4
For example, during runtime an XY- trend chart could look like this:
The CSV file Force_Displacement, this XY- trend chart is based on. CSV looks like this:
NUM;NUM
Force;displacement
1950;44.2
1678;38.8
1400;29.5
1250;40
1200;50
1080;53
950;69
750;81
550;95
500;77
320;42.2
200;46
150;67
100;88
50;49
0;0
The first line of the CSV file is a definition line in which the contained types are indicated. For num-elements
the token NUM is used, for texts the token TXT. All types are separated by the selected separator char. After
the last type a new line starts, without typing a separator. Possible separators are ',' or ';' or space or a
tabulator, in the example it is a ';'. The CSV file can be edited with MS-Excel or with a text editor.
In the second line of the CSV file the names of the elements are shown, which values follow below, in the
example, force and displacement.
144
Graphic
Now, draw the XY- trend chart and assign it to this CSV file.
Start the Graphic Editor (button Graphic Editor in toolbar Development in the Project Manager).
Select the picture, in which the XY-trend chart shall be displayed or open a new picture.
Select button XY-trend chart in toolbar Draw.
Draw an XY-trend chart on the screen. An XY-trend chart is drawn like a rectangle (see Drawing
basic forms).
Double-click on the XY-trend chart to open dialog Properties XY-trend chart.
On tab Graphic you can change the color of the border and the surface.
Select tab Data source.
Select the a CSV file with option Source file. Click browse-button Browse to select the file in
dialog Open.
Select the CSV separator, which is used in the selected CSV file.
In field Trigger you indicate a data-element with Start reading, which change triggers the loading
of the CSV file.
You have the possibility to select the data-element from the reference list. Click with the right
mouse button on the edit field to open dialog Element selection.
Select tab Trend lines.
In group X-value you enter the variable, which shall be applied at the X-axis.
In field Name you can enter another expression for the element, which will then be shown at the
right end of the X-axis.
In group Y-value you can configure up to six elements, which values shall be displayed as lines.
Beside this, you can enter another description for the elements below Name which will then be
shown in the legend, if it is activated on tab Miscellaneous.
Beside this field, you can define the color of the respective line in field Color.
Into the fields From and To you configure the range for the data-elements.
When pressing button Options, a dialog opens and shows the properties of the respective line.
Define here line style and thickness and the Number format for the Y-axis. With Unit you define
whether the unit of a data-element shall be shown or not.
Confirm the dialog with OK.
Make your definitions for as many data-elements as you want to have displayed in the XY-trend
chart.
Select tab X-axis.
In group Label you configure color and format of the X-axis description.
In group Format you configure if the number of the scale-subdivisions of the X-axis shall be defined
automatically. Alternatively you enter a Number manually. With the automatic format, the number
of scale subdivisions will be adjusted automatically to the range of the XY-trend chart.
Select tab Y-axis.
Here you configure Text alignment and Format of the Y-axis.
Select tab Grid.
The number of main grid lines varies depending on the number of subdivisions of X- and Y-axis.
At this point you can define for the horizontal and vertical grid, whether it shall be active, which
color shall have major and minor grid lines, the line thickness and the number of grid lines.
Moreover, the border color of the internal border of the trend chart can be configured.
Confirm the dialog with OK and save the picture.
145
Manual AMS Asset Graphics 5.4
146
Graphic
Touch Panel
Touch panel
A touch panel permits the input of numerical values or texts at PCs, which are not provided with a keyboard
but only with a touch screen.
The Touch Panel input can be activated for buttons, graphic buttons, numbers and texts.
For the definition of the touch panel you have to proceed in the following way:
1. Project settings
Start the Project Manager.
Open the project (button Open in the standard toolbar).
Select menu command Configuration | Touch panel to open dialog Touch panel (project).
Activate the touch panel functionality by setting the option Active.
Enter Position and Size of the touch panel. The position can be adjusted individually as picture
or object property.
If the touch panel operation shall be supervised (i.e. if a data input was started, it will be aborted
automatically when the operator inputs have stopped) enter a Life time unequal to zero.
Close the dialog with Save.
2. Picture settings
(Only for the touch panel dialog for numbers)
Start the Graphic Editor.
Open the relevant picture (button Open in the standard toolbar).
Select command Picture properties in the context menu.
Select tab Touch panel.
You can configure the visibility of the touch panel in 2 ways:
1) If option Always visible is set, the touch panel will always be shown. If the touch panel input is
not active, the touch panel control elements are grayed out.
2) With a num-element that you can enter in field Visible at. If this element has a value different
from 0, the touch panel will always be visible in the picture.
Enter the position of the touch panel. At graphic objects, the position can be adjusted
individually.
Confirm the dialog with OK and save your changes.
147
Manual AMS Asset Graphics 5.4
3. Object settings
Select the object, which shall have a touch panel input. This is possible at numbers, texts, buttons
and graphic buttons. Open dialog Properties with a double-click.
Select tab Touch panel.
Set the option Active.
At buttons and graphic buttons select data type (NUM or Text) for the touch panel input.
Set the texts for description and the unit at number objects. Variables may also be used in the
texts.
Set the Element which value shall be set with the touch panel input. Minimum and Maximum
can be entered optionally. At number and text objects no entries can be made here, since the
settings from tab Input will be used for the touch panel input.
When entering a number, you have then to define the position of the touch panel. With the option
Use picture definition the position from the touch panel picture settings is used. With the option
Relative to the object the touch panel is shown directly at the object.
Confirm the dialog with OK and save your changes.
See also
The touch panel input dialog for numbers
The touch panel input dialog for texts
Touch panel
By means of the touch panel it is possible to enter numbers and texts via a touch screen. For numbers and
texts there are different input dialogs (see input dialog for Numbers and Texts).
Input of numbers
This input possibility can only be used for the visualization. The input dialog may be always visible or only
visible, if required.
The input of numbers can be configured at:
Buttons , Graphic Buttons and Numbers.
Input of texts
This input dialog will be displayed automatically if an input is necessary and if the function is switched on.
For the activation, the left mouse button must be clicked on an entry field.
The input dialog appears at:
At password-dialogs for the login, changes of the password and in the dialog User table.
At the visualization of Buttons, Graphic Buttons and Texts (can be configured for every object).
In the Eventjournal, the Filter name can be edited.
In the Recipe Runtime when creating new recipes (name of the recipe) and when editing new
recipes.
148
Graphic
In this dialog you have the possibility, to activate the touch panel-input (separated for Number and Text) for
a project and to make general settings for the touch panel.
Option Description
Active Set this option to activate the touch panel functionality for a project.
Only if this option is activated, inputs for the touch panel can be made in the Graphic
Editor.
Coordinates Position and size of the touch panel dialog will be defined here.
Position X, Y The position (upper left corner) of the touch panel dialog is defined here in pixels.
Note At the input of numbers, the position can be configured per picture or also for single
graphic objects.
Size X, Y The size of the touch panel dialog is defined here in pixels.
Life time [s] With the lifetime, the touch panel dialog can be watched.
At every operation in the dialog, the lifetime starts running anew. After the lifetime has
elapsed, the touch panel dialog will be closed automatically (a takeover of already existing
changes is not made).
If this functionality is not wanted, enter as lifetime 0.
Per default, the lifetime is predefined on 0 seconds. With this option, it can be changed in
the range 0 to 3600 seconds. Enter the desired value either directly with the keyboard or
use the arrows to the right of the entry field.
See also
Step-by-step instructions Touch Panel
Touch Panel Definition for a picture
Touch Panel Definition for an object
Option Description
View options
Always visible If highlighted, the touch panel input window will always be visible.
Visible at A num-element can be entered here, to control the visibility of the touch panel
window.
Coordinates
Use project The project settings will be used.
definition
Absolute With this option, the touch panel window will be set to a fixed position.
(Position X and Y)
See also
Touch panel (Step-by step instructions)
Touch panel Project properties
Touch panel Object properties
149
Manual AMS Asset Graphics 5.4
Option Description
Active Activate this option, to permit a touch panel data input on the object.
Data type At buttons and graphic buttons, the data type (NUM or TEXT) for the input is defined here.
See also
Touch Panel (step-by-step instructions)
Touch Panel Project properties
Touch Panel Picture properties
150
Graphic
The touch panel dialog for numbers has the following components:
1. Description ('speed')
2. Unit ('rpm')
3. Minimum ('0')
4. Maximum ('3000')
5. The current input ('2800'), up to 15 characters possible
6. 12 input button: (10 numbers, sign and decimal point)
7. Backspace-button (deletes the last character of the input).
8. Cancel-button (input will be discarded)
9. OK-button (value is accepted)
Data input
With of the 12 input buttons the value is entered into the input field, by pressing the backspace-button, the
last character will be deleted. The decimal point may be entered only once. The input is performed, when
the button is released. There is no repeating function.
At the first input after the activation (except backspace-key) the edit field will be deleted and filled- in with the
new value.
151
Manual AMS Asset Graphics 5.4
Data input
The input of values operates the same way as with a normal keyboard.
The input is performed, when the button is released. There is no repeating function.
152
Process Assignment
Introduction
The process assignment connects AMS Asset Graphics data-elements with the real process values. Thus,
the visualization can display current process data at the screen. Data-elements, which were changed by an
user or by calculations, can be transferred to the control unit.
Receiving and sending data is event-driven. The conditions (trigger) are defined in tab Communication.
Cyclical events can also be used and are predefined with time-dependent system-elements.
To get the real values from the process, there must be an communication interface to the process. This is
realized with so called drivers. There are different drivers for the most common PLCs (programmable logic
controller) available. Beside the PLC-drivers, there are also other driver, e.g. for bus systems or other
process interfaces. A description of available drivers can be found here.
The Process Assignment Editor is designed as MDI-application, this means, several documents (process
assignment tables) can be edited at the same time.
In so called Driver profiles the behavior of the of a specific driver is defined.
In process assignment tables data-elements are assigned to memory addresses in the PLC. During the data
transfer an adaptation to different value ranges can be performed.
See also
Organization and procedure of process assignment tables
Behavior of the process assignment at runtime
Define the process assignment (step-by-step instructions)
Insertion of programs
153
Manual AMS Asset Graphics 5.4
If all driver profiles were loaded successfully, the tables are loaded. The tables will be assigned to the driver
profiles or rejected, if they shall not be used on this station in a network project.
After finishing the initialization phase, the Process Assignment Runtime will start the cyclical processing of
the tables.
The Runtime checks with the start sending and receiving triggers, whether the table shall be processed or
not. In case, that both triggers are active at the same time, the priority setting is used.
When closing the runtime program, the process assignment will de-install the drivers again.
The processing sequence of the tables can be influenced with the names of the tables. The tables will be
loaded, sorted in alphabetic order and then assigned to the profiles.
User interface
The Process Assignment Editor is designed as MDI-application, this means, several documents (process
assignment tables) can be processed at the same time.
New
Select command File | New to open a new process assignment table. Dialog Table New appears.
Select the project for the new table. When you confirm the dialog with OK, it will be checked, whether a valid
driver profile is available. If no valid profile does exist, the dialog Driver profiles (project name) will be
opened. If this dialog is closed without opening a new driver profile, a new window with an empty process
assignment table will be opened. Here, all fields and buttons are shaded in gray, as long as a valid driver
profile was selected for this table.
When there is a valid profile, when opening a table, dialog Properties will be opened.
154
Process Assignment
Driver profile
Driver profiles summarize some settings which describe precisely the behavior of the process assignment
when editing a definite driver. For every driver an arbitrary number of profiles may be generated. A driver
profile can be assigned to a user-defined number of process assignment tables.
Select a command in the submenu File | Driver profiles to deal with driver profiles:
Command Description
Open The dialog Open driver profiles will appear. Here you select the project, which driver profile
shall be opened.
Save All edited profiles are stored.
Edit Select this command to edit the driver profiles for the currently selected project. Dialog Driver
profiles (project name) appears.
See also
General operation
Dialog Properties
The dialog has 5 tabs, in which general parameters of the table, the address range to transfer with the
partner device, the error handling, conditions of the communication and VBScript are configured.
Tab General
On this tab you define, which driver profile shall be used by the table.
Option Description
Driver
Profile Select the driver profile that shall be used by the table from the list of profiles that you
had defined.
Attention When you enter no profile or an incorrect one, you cannot make entries in
the table.
Use profile Activate this option, when the table shall use the defaults, that you have made at the
presettings definition of the driver profile on tab Table presettings.
In this case the corresponding options are disabled for input (in tab Error handling
Repeat and Log level and in tab Communication Program start).
Number The internal number of the driver is displayed here.
155
Manual AMS Asset Graphics 5.4
Tab Addressing
This tab is specific to the selected driver. Exemplarily, the Siemens PG-driver is described.
Here you define, which address ranges in the partner device shall be accessed. You can address relatively
or absolutely.
Option Description
Relative / Absolute With absolute addressing, all address definitions are referred to absolute addresses
in the partner device.
At the relative addressing, all entries are calculated relatively to the first address
(from data word). This means, in this case the data word serves as pointer to the
first address of the range in the partner device.
Example
In field from data word value 20 is entered registered. With the entry 0 in column
Word 1, (see tab Range in the process assignment table) address 20 is mentioned.
At word 1 = 17, address 37 will be addressed.
Data type Select the data type from the list of data types, supported by the driver.
The Siemens-PG-driver (SIPG) can process the data types DB = data block and DX
= extended data block.
Data block Enter here the number of the data block.
From word The first and the last address are defined here.
To word
(or Number at
relative addressing)
Tab Communication
Here you define the conditions for sending and receiving data.
Option Description
Active at
Element The data of the table will only be transferred, when the num-element, that you enter
here, has a value unequal to zero.
Picture You can enter a picture name. The data of the table will only be sent or received,
when the picture is displayed.
Network station The data of the table will be processed only on the given network station.
Automatic
Priority If the table shall be sent as well as received, you can decide here, whether sending
or receiving shall be carried out prior-ranking. This definition is important, when both
control triggers change simultaneously.
Send at change Set this option, when the table shall be sent, when the content of a data-element,
used in the table on the PC side, has changed.
Note When the parameters Send at change and Priority are both activated,
changed elements in the system will not be overwritten, when reading a table. With a
change of the elements (already before reading of the table) the table will be sent to
the hardware. This behavior is only activated in the combination of the settings as
described. This is necessary, to avoid overwriting of the inputs in the system by
reading a table (e.g. time controlled).
156
Process Assignment
Option Description
Trigger
Start sending Enter here the name of the num-element, which shall start sending of the table when
the data-element changes its value (control trigger). The amount of the change is
irrelevant.
Sending complete Define here the name of a num-element, which has to change when sending of the
table was completed (notification-trigger). The element will be increased by 1 and
reset on 0 when reaching 255.
Start receiving Enter here the name of the num-element, which shall start receiving of the table
when the data-element changes its value (control trigger). The amount of the change
is irrelevant.
Receiving complete Define here the name of a num-element, which has to change when the table was
received completely (notification-trigger). The element will be increased by 1 and
reset on 0 when reaching 255.
Program start
Receive Here you define, what shall apply for the table at the start of the program: Receive
required, unnecessary or try.
When receiving of the table at the program start was defined as necessary, the
program will try again and again to receive the table when a receiving has failed. The
program will not be initialized further.
When the receiving is defined unnecessary, the table will not be received at the
program start.
When the program shall try to receive the table, the program will skip this table after
an unsuccessful attempt.
In dialog Driver profile on tab Table presettings you can make the definitions for the
program start. When you have activated option Use profile presettings on tab
General, you cannot make an input here.
Option Description
Error
Counter Enter here a num-element, which increments its value at every error in the data
communication of this table.
Status Enter here a num-element, which is set after every data transfer (sending and
receiving). When the communication was successful, the element contains the value 0.
If not, it will get value 1.
Repeat This value defines how often a not correctly transferred telegram is repeated. The
telegram is only then regarded as faulty if the number of predefined repeats is reached.
Note When you have activated the option Use profile presettings on tab
General this field will be shaded in gray, thus you cannot enter parameters.
Number This num-element contains the number of the last error that has occurred in this table.
The meaning of the error numbers can be found in the description of the drivers.
Text In this text-element the last error is reported as plain text.
Log level Enter a Log level greater than 0, is an incorrect telegram shall be recorded in the
activity log.
Note When you have activated option Use profile presettings on tab General this
field will be shaded in gray, thus you cannot enter parameters.
157
Manual AMS Asset Graphics 5.4
Option Description
Deactivation
Number of errors Here you set the number of errors, when the table shall be deactivated. With a 0 the
table is always active.
Status You can enter a num-element for the deactivation status. The element has the value 1,
if the table is deactivated, otherwise it will have value 0.
Reactivation Here you enter a num-element to control the reactivation of the table. If this element
changes its value, the table will be reactivated.
Tab VBScript
On this tab you define further functions, to be called in this table.
Function Description
OnStart This function will be called once, when the table is generated.
OnRun This function will be called cyclically.
OnEnd This function will be called, when the table is terminated.
OnCommError This function is called in case of an error, e.g. to disable the driver.
(ErrCode)
OnSendStart This function will be called before sending the table.
OnSendReady This function will be called after a successful sending of the table.
OnReceiveStart This function will be called before receiving the table.
OnReceiveReady This function will be called up after successful receiving of the table.
See also
Define the process assignment (step-by-step instructions)
158
Process Assignment
Tab Profile
General settings can be made on tab Profile.
Option Description
Use When you activate this option, the driver profile will be used. If this option is not set, all tables,
that use this profile, will be deactivated. This is useful e.g. at commissioning.
In the dialog for selecting different driver profiles, an unused profile is marked graphically with a
red line between two devices.
Driver Select here a driver from the list.
Name Enter an appellative name for the driver profile. With this name you can select the driver profile
at other places.
Active Here you enter a num-element, if you want to activate/deactivate the profile dynamically. When
at the value of the num-element is 0, the profile will not processed, when the value is different to 0,
the profile will be processed.
If you do not want this function, leave the field empty.
Timeout This option defines the maximum time (in milliseconds) for the exchange of data, before the
transfer order is aborted. After that, the repetitions will start. The number of possible repetitions
will be predefined on tab Table presettings in option Error handling Repeat.
Number The driver profile has an assigned internal number, which cannot be changed. With this number
a profile is explicit identified in a project.
Version Here you see the version information about the driver.
Tab Logging
On this tab you define a log file, which records messages on the communication between PC and partner
device.
Option Description
Log file
File name Here you enter the name for the log file. The file name may include a directory path.
max. size Enter here the maximum size for the log file. If the log file is full, the logging stops.
[kB]
Open new file If this option was activated, a new log file will be opened at every start of the Process
at start Assignment Runtime. In doing so, the old log file will be overwritten. If the old log file has to
be analyzed before, it must be copied to another place.
Type
Hardware When you activate this option, the data, that were transferred between driver and
hardware, will be entered into the log file in form of hex values. (At serial drivers, the
ASCII-characters will be logged).
Status When you activate this option, the status commands, exchanged between process
assignment and driver, will be entered into the log file.
Option
Only at errors If this option is set, only reading or writing orders, which finished with an error, are
recorded in the log file.
159
Manual AMS Asset Graphics 5.4
Option Description
Error
Counter Enter here a num-element, which increments its value at every error in the data
communication.
Status Enter here a num-element, which is set after every communication (sending and
receiving). When the communication was successful, the element has the value 0. If
not, it will get value 1.
Show error dialog When you activate this option, communication errors will be displayed in a message
dialog.
If several errors occur at the same time, only the last error will be shown. The error
message can be confirmed with OK.
This function is a useful help function during the commissioning of a plant and is
recommended to be used to show directly the errors that have occurred.
Number This num-element contains the number of the last error, occurred in this driver profile.
The meaning of the error numbers can be found in the description of the drivers.
Text This text-element gets the last error, occurred in this driver profile, in plain text.
Deactivation
Number of errors Here you set the number of errors, after which this driver profile shall be deactivated.
When entering a 0, the profile will never be deactivated.
Message Enter a num-element here to get the deactive status of the driver profile.. This element
element has value 1, if the profile is deactivated, otherwise it has value 0.
Reactivation Enter here a num-element to control the reactivation of the driver profile. As soon as
the num-element changes its value, the driver profile will be reactivated.
On this tab you define the presettings for the process assignment tables, which use this driver profile. In
order to activate the presettings, option Use profile presettings on tab General must be enabled.
Option Description
Error handling
Repeat Here you define, how often a faulty telegram has to be repeated. The error counters, which are
defined on tab Error handling, will be changed not before the number of repetitions are reached.
Log level Enter a log level > 0 to record faulty telegrams in the activity log.
Program start
Receive Define here the default setting for the behavior of tables at program start. See tab
communication.
Note This defaults can also be used, to make temporarily settings invalid, which you have made in individual
process assignment tables, e.g. at a commissioning, where receiving of the tables at the program start is not
required under some conditions.
160
Process Assignment
Tab VBScript
On this tab you can define VBScript functions for the driver profile.
Function Description
OnStart This function will be called once, when the table is generated.
OnRun This function will be called cyclically.
OnEnd This function will be called, when the table is terminated.
OnCommError This function is called in case of an error, e.g. to disable the driver.
(ErrCode)
Valid and activated driver profiles have the icon with a green line between two devices.
The icon for a deactivated driver has a red line between two devices.
Driver profiles with no selected driver are displayed with the crossed-out circle.
Changed driver profiles are marked with an asterisk behind the profile name.
With the commands New or Delete you can create a new or delete an existing driver profile.
To edit a profile select the profile and press Edit or double-click on the profile. You can then edit the profile
settings in the dialog Driver profile.
Press Save to save the changes for all profiles.
Note This dialog can also be opened by pressing button Edit profile in the table specific toolbar.
See also
Define the process assignment (step-by-step instructions)
161
Manual AMS Asset Graphics 5.4
Column Description
Element Enter here the names of the data-elements, which shall be used with this table.
Function Click with the right mouse button, to open dialog functions.
The description of the functions can be found in table functions.
Note When you want to change the functions of several lines at the same time, mark the
required fields, and click with the right mouse button on one of the highlighted fields. The
function selection will then refer to all highlighted fields.
Address 1 Enter here the address, that shall be transmitted. Or set the start address for a range.
Bit 1 Enter here the bit to be transmitted. If not used this field is gray.
Address 2 Enter here the address, that shall be transmitted. Or set the end address for a range. If not
used this field is gray.
Bit 2 Enter here the bit to be transmitted. If not used this field is gray.
Type Depending on the function the data type (NUM or TXT) of the data-element is shown here.
Tab Scaling
On this tab you define the value ranges in AMS Asset Graphics and in the partner device. During the data
transfer the values are automatically scaled.
Column Description
Element In this column you find the names of the Elements, which shall be used with this table.
Internal (from to In these columns you have to enter the value range of the data in AMS Asset Graphics.
)
External (from In these columns you to enter the value range in the partner device.
to) If the values, entered here, are outside of the possible range of values, it will be shown
in blue letters.
Type See tab Data mapping.
162
Process Assignment
Tab All
On this tab you find all elements in common, which are contained on the other tabs. By means of this, tab
All offers the possibility to exchange the complete process assignment table, using the clipboard or drag &
drop, with other programs. In addition, all information are available at a glance.
See also
Define the Process assignment (step-by-step instructions)
163
Manual AMS Asset Graphics 5.4
164
Process Assignment
Option Description
Standard settings When you activate this option, the standard settings of the serial interface are used for
this driver and cannot be changed. If you want to use other settings, you have to
deactivate the option.
Interface No. In this line you enter the number of the serial interface (COM port), where the partner
device is connected.
Baud rate Select the required baud rate for the communication from the possible baud rates of a
serial interface.
presetting: 9600
Parity Select the parity mode of the interface from possible settings (EVEN, ODD, NO).
presetting: EVEN
Number of Bits Select the number of bits of the interface from possible settings (7-bit, 8-bit).
presetting: 8 bit
Stop bits Select the number of stop bits for the interface from possible settings (1 -bit, 2 -bit).
presetting: 1Bit
Process assignment
The process assignment connects the data-elements used in the visualization with real process values.
Thus, it looks after updating the process data at the screen and, in the other direction, that data-elements,
which were changed by the user or by calculations, will be transferred to the partner device.
See also
Behavior of the process assignment at runtime
Initialization
For every profile of the project, an initialization dialog will be shown at start. In the table on the left, all
process assignment tables, assigned to this profile, are listed. Depending on the project planning in the
editor, tables has to be read. When the reading of such a table has failed, this has to be repeated as often,
till the reading action was successful or the user has deactivated the table. Beside this, the user has the
possibility to deactivate all tables of this profile simultaneously. This could be useful, when the hardware,
which is part of this profile, is not connected and therefore a processing is not possible.
Note Another possibility is the Process Assignment Editor to deactivate all tables in common, that access on
the same profile. In this case, deactivate the option Use on tab Profile in Dialog Driver profile.
With respect to the deactivation, all other settings in the editor do not have influence on the handling of a
table at the initialization. Here, only the configuration point Receive at program start.... will be taken into
account.
Caution When a table was deactivated and when in its properties no reactivation element (tab Error
handling in dialog Properties Process assignment table) was scheduled, this table can only be reactivated
with a new start.
165
Manual AMS Asset Graphics 5.4
Symbols Description
Black arrow Current table
Green hook Action successful (see table above)
Red cross Table deactivated
When an error occurs when reading a table, the error will be shown to the right of the table listing. The last
error message will remain on the screen. It can be clearly assigned to a table, since the table is always be
listed together with the error message.
Start the Process Assignment Editor (button Process Assignment Editor in toolbar development
in the Project Manager).
Define a driver profile first. For this, select menu command File | Driver profiles | Open. Dialog
Open driver profiles will be shown.
Select the project in which you want to define the process allocation and confirm the dialog with
OK. Dialog Driver profiles will be opened. If you start first with the definition of the process
assignment, the dialog will be empty. If you have already defined driver profiles, they will be
shown here.
Press button New to create a new driver profile. Dialog Driver profile will be opened automatically
to configure the properties for the new profile.
The dialog contains tabs, which are adapted depending on the selected driver. The tabs Profile,
Logging, Error handling, Table presettings and VBScript are always available.
The selection of the driver is made on tab Profile in the option Driver. Click on the selection
arrow to the right and select S7_Ethernet.
The tabs will automatically be adapted to this driver. Driver-specific tabs are in this case PLC and
Connection.
In field Name you can define a name for the driver profile in order to address it at further process
assignments.
Set the option S7-addressing mode on the PLC tab.
Select tab Connection and enter the IP address of the CPs into field Address and select ISO-
on-TCP as Connection type.
Configure the PLC software in the S7.
Further settings can be made on the other tabs. However, this is not necessary to communicate
with the PLC.
166
Process Assignment
Confirm the dialog with OK. In dialog Driver profiles, the driver profile including the name, you
have just defined, is indicated valid with a green icon. The asterisk behind the driver name means
that changes have been made which are not yet saved. Here you can open further driver profiles,
which may also have access on the same driver.
Save the driver profile and close the dialog.
Now, open a new process-assignment table (button New in the toolbar). Dialog Table new will be
opened.
Select the project. A new table window will be opened in the Process Assignment Editor. Entries
can be made not before a valid driver profile has been selected.
Dialog Properties opens automatically to select the driver profile. The dialog has 5 tabs: General,
Addressing, Communication, Error handling and VBScript. Tab Addressing is specific to the
selected driver.
Select the driver profile with the selection list Profile on tab General.
Select tab Addressing. Here you can define, which data range of the PLC shall be addressed.
Activate the corresponding option, depending on whether you want to address relatively or
absolutely, in this example the addressing is set to absolute.
At absolute addressing, all address definitions (e.g. from address, to address) are referred to
absolute addresses in the PLC. At the relative addressing, all entries are calculated relatively to
the first address (e.g. from address).
Set the options:
Data type: DB
Data block: 13
from address: 0
to address: 9
Select tab Communication. Here you define the conditions, when data shall be sent or received.
In our example the receiving of the table is controlled with system-element _Sec01, so that the
data will be received every second. If the table was received successfully, the notification-element
ReadOK will be increased by 1 and can thus control further actions.
In group Program start the option Receive is set to Required. If the table cannot be received, the
program will try again and again receiving the table, thus the initialization will not go on.
Confirm the dialog with OK.
167
Manual AMS Asset Graphics 5.4
Now assign data-elements to the data in the PLC. The Process assignment table includes 3 tabs,
in which data mapping and value scaling can be defined.
Enter the data-elements that shall be assigned with the PLC into column Element on tab Data
mapping.
You can also select elements from the reference list. Click with the right mouse button on the cell in
column Element to open dialog Element selection.
With the selection from the reference list the element type is entered automatically into column
Type.
Select the desired function in column Function, by clicking with the right mouse button on the cell
to open dialog Functions.
Select one of the offered functions.
Depending on the selected function the columns Address 1, Bit 1, Address 2 and Bit 2 are
shaded in gray or white. Enter the addresses or the bits, which shall exchange data with the PC,
into the white cells. In the example above, analog measuring values are received in form of
individual bytes.
The entry in column Type cannot be edited, with the selection of the function it will be set
automatically.
168
Process Assignment
Select tab Scaling. Here you can match the possibly different ranges of the PLC data on the
value ranges of the PC.
Enter the range of values of the PC data into the columns Internal from/to. Enter the range of
values of the PLC data into the columns External from/to. If you leave the default setting
(everywhere 0), the data will be transferred 1:1. In the example above, the data of the PLC are
stored in the 4. line in the range 0 to 100 and will be scaled to range 0 to 50 in the PC.
Save the settings, you have made in the table. Now configure additional tables or exit the Process
Assignment Editor and test the communication.
Driver
Introduction
Driver are programs, that realize the data exchange between the Process visualization and external devices
(e.g. PLC) or plug-in cards. The connection between Data-elements and physical addresses are defined in
the Process Assignment Editor.
The drivers will be started and terminated automatically by the process assignment (Runtime). In a Project it
is possible to use several drivers.
Siemens
S5-CP-Interface
S5-PG-Interface
S7 PPI (S7-200)
S7 MPI (S7-300/400)
S7 Ethernet
S7 Softnet
AEG
A120/A250
169
Manual AMS Asset Graphics 5.4
Mitsubishi
FX-Series
Phoenix
Interbus-S for Win NT
Miscellaneous
Apex
Modbus / ModbusTCP
Note The list of available drivers is being extended continuously. If you need a driver, that is not listed here,
please contact us.
See also
Driver specific settings
Logging the communication
The possible settings depend on the selected driver. In the example, these are the settings of the serial
interface, the interface number and the baud rate.
170
Process Assignment
Example: CP-settings
This is a specific tab for the Siemens CP-driver. The character delay time for the protocol can be set here.
In every driver, a logging function can be enabled. The protocol will be written in the ASCII-format into the
specified file in the project directory.
Logging means additional efforts for the driver, for this reason it should only be activated in case of problems
with the communication.
171
Manual AMS Asset Graphics 5.4
Option Description
Log file
Name Enter here the name of the log file. The file is written in the current project directory.
Max size The maximum size of the file
Create on start If this option is set, the file is delete at every program start.
Type
Hardware The hardware logging writes the data, transmitted between driver and hardware, as
hexadecimal value into the protocol.
Status The status logging writes the status commands, exchanged between process assignment
and driver, into the protocol file.
Option
Only at errors This option defines, that the file logging is only done, if there was an error in the
processing of the last order.
See also
Structure of the protocol file
172
Process Assignment
After the end of the hardware protocol, the status answer of the driver is registered.
The next order will follow.
APEX
APEX
With the Apex driver you can connect to PLCs, which are equipped with Apex components. In the PC you
must install the special PAD PC card.
The configuring of the bus is done with the Apex program NetPro.
Installation
The driver uses the function interface from Apex (PAD interface) to access via the PC card (PAD-PC) the
programmed VDM data cells.
The interface delivered with the Apex driver and is named PADITF32.DLL. This interface accesses to a
special device driver, which is delivered with the PC card.
Under Windows NT/XP you must install the device driver PADITF32.SYS.
Under Windows 98/Me you must install the device driver PADITF32.VXD.
Please read the installation instructions from the Apex manual.
173
Manual AMS Asset Graphics 5.4
Functioning
The driver accesses directly to so called PV numbers.
The driver checks, wether the numbers are correctly configured in NetPro as read cell (when reading) or as
write (when writing) cell.
AEG_PG
AEG PG Interface
Description
Driver for the connection of an AEG PLC by using the programming cable.
The following PLCs can be connected with the driver: A120 and A250.
174
Process Assignment
175
Manual AMS Asset Graphics 5.4
Data transmission
(Tab Ser. interface in dialog Driver profile)
Option Description
Baud rate 9.600
Number of bits 8
Parity ODD
Stop bits 1
176
Process Assignment
H1TCP
Siemens H1TCP
By means of driver H1TCP, the Simatic control devices S5 and S7 can be connected to AMS Asset
Graphics. The hardware connection between PC and PLC will be realized via Ethernet. Data blocks and
flags can be read from the PLC or written to them.
Note When communicating with an S7 PLC, you should use the driver S7_Ethernet. With this driver, the
addressing is byte oriented according to the S7-Standard.
See also
Required hardware
Special error messages
Installation of the PLC software
Tab Addressing (driver H1TCP)
With the driver, the following data types can be read and written:
Data type Description
DB Data block DB
DX Extended data block DX
Flag byte Flag byte
177
Manual AMS Asset Graphics 5.4
Data Enter here the number of the data block (1 - 255), which shall be transferred with the process
block assignment table.
From Enter here the number of the first data word (0 – 2047) which shall be transferred with the
word process assignment table.
To word Enter here the number of the last data word (including) or the number (0 – 2047), which shall
(or be transferred with the process assignment table.
number)
Flag byte
Option Description
Data type Select here data type Flag byte.
From byte Enter here the number of the first flag byte (0 – 255) which shall be transferred with the
process assignment table.
To byte Enter here the number of the last flag byte (including) or the number (0 – 255), which shall be
(or transferred with the process assignment table.
number)
Required hardware (H1TCP)
Connection
By means of driver H1TCP, Simatic control devices (S5 and S7) can be connected to AMS Asset Graphics
via Ethernet. For the connection, the corresponding CPs (communication processors) are used in the PLCs.
The computer uses a network card with TCP/IP-protocol.
PLC Types:
178
Process Assignment
Tab PLC
Depending on the used PLC type, select S5 or S7.
Possibly, the option S7-addressing mode must be set on S7-PLC, if the CP interprets takes the start
address as byte address.
179
Manual AMS Asset Graphics 5.4
Tab Connection
Option Description
Address Enter here the IP address of the PLC to be connected, e.g. 192.168.1.1.
Read
TSAP Enter here the identification text for the read connection to the PLC. It must correspond to
(ASC) the setting in the PLC.
TSAP Displays the length of the TSAP text.
length
Write
TSAP Enter here the identification text for the write connection to the PLC. It must correspond to
(ASC) the setting in the PLC.
TSAP Displays the length of the TSAP text.
length
Programming the CP
1. Adjust the MAC address (CP basic initialization)
2. Set the own IP address and the subnet mask (TCP/IP initialization)
3. Program the CP
Fetch Transport Connection with the TSAP „INVISURD"
Receive Transport Connection with the TSAP „INVISUWR"
File „TCP1430.DAT" shows an example configuration and is contained in the scope of supply of the driver.
Overview
1. Configure the CP for the Ethernet.
2. Configure the connections of the CP in the CPU.
180
Process Assignment
2 The Write-Connection
Make a new connection with connection type ISO-on-TCP connection and the station definition
(unspecified).
In dialog Properties of the ISO-on-TCP connection, the following definitions have to be made
Tab Settings
General Enter e.g. AG-Write as name.
The Active connection establishment has to be switched off.
Addresses Enter here the IP address of the AMS Asset Graphics PC.
As TSAP you have to enter twice INVISUWR.
Options The operating mode has to be set on Write passive.
If available, set the option S7 addressing mode.
181
Manual AMS Asset Graphics 5.4
IBSNT
Phoenix Interbus-S Windows NT (IBSNT)
Description
With driver IBSNT, can be exchanged word oriented with an Interbus-S circuit.
As indicated in the name, driver IBSNT can only be used with Windows NT. By means of it, IBS FC cards
can be connected directly and IBS Remote field controllers (RFC) via Ethernet. In the profile of the process
assignment, the hardware (RFC- or FC Card), the connection mode (Bus master or Co-processor) and the
address (station- or card number) can be selected.
Further information
Dialog Driver profile
Addressing
Settings FC Card
Settings RFC
Commissioning
Special error messages
Addressing of process assignment tables (IBSNT)
In the Process Assignment Editor you can select the data types Inputs, Outputs, Ext. Input words and
Ext. Output words.
182
Process Assignment
See also
Tab Addressing in the process assignment
Dialog Driver profile (IBSNT)
Tab Profile
Select here driver IBSNT.
Tab Connection
On this page of the profile, the hardware (RFC Ethernet or FC Card), the address of the hardware (station or
card number) and the mode of connection (bus master or co processor) can be selected.
Option Description
Hardware A connection is made via Ethernet with a Remote field controller.
RFC Ethernet A connection is made via Ethernet with a Remote field controller.
The station number of the Remote Field controller is set here (0-99).
FC Card A connection is made by means of an Interbus-S PC-card.
The number of the Interbus-S card can be selected here (1-8).
Bus
controlling
Bus Master At the login, AMS Asset Graphics is started as bus master and takes over the complete
bus control. This means, that with starting and stopping of AMS Asset Graphics, the
Interbus-S will be started and stopped.
Co Processor AMS Asset Graphics will be logged-in at the co-processor of the RFC. No bus control is
carried out. Only data of the DTA memory range can be exchanged.
Check Offers a possibility to supervise the hardware configuration. The supervision of the
number of modules is only possible in the bus master mode.
Module number With this, the number of modules can be checked, this means, the driver will only
provide values, if the current number of modules agrees with the selected number
(otherwise error messages will be printed).
If the number of modules is 0, no check is done.
183
Manual AMS Asset Graphics 5.4
DIP-Switch: Addressing
3F8 hex ON ON ON ON ON ON ON
Remark of Phoenix:
Upon delivery, switch 1 is in the off-state. Please do not change this setting.
The PC-address is set on 120 Hex and can be adjusted individually on your demands by means of the
switches 2 to 8.
Copy file IBDDIWIN.INI of Phoenix into the Windows directory, and match it to your hardware environment.
Copy file IBDDIWNT.DLL into the Windows system32-directory.
184
Process Assignment
Frequent errors
If the error message E0070002 or E0078532 appears, probably the Interbus S drivers of Phoenix
driver are not installed.
The settings in file IBDDIWIN.INI in the Windows-directory are not adapted or it was missed to
adapt them after changing the hardware.
The entries for several RFCs in the registration are not available. Presently, the settings have to be
made manually, since the program PC WORX of Phoenix does not apply them automatically.
When accessing inputs and outputs, the program does not show the current values. This might
happen, if no physical addressing runs on the Interbus. With logical addressing it is only possible to
address the extended inputs and outputs, since the normal input and output ranges are not
updated anymore by the IBS firmware.
Special error messages (IBSNT)
185
Manual AMS Asset Graphics 5.4
MIFX
Mitsubishi FX
With the driver MIFX you can transfer data with control devices of the FX family of Mitsubishi.
The hardware connection between the PC and the PLC units will be realized by the SC 07-converter of
Mitsubishi. Data registers, special data registers, inputs, outputs, flags, special flags, C contacts, counters
(16 and 32 bit), T contacts, timers and sequencer be read or written.
PLC types
Mitsubishi FX-Series
PLC
FX
FX0
FX0N
FX0S
186
Process Assignment
187
Manual AMS Asset Graphics 5.4
Modbus / ModbusTCP
Modbus (serial) / ModbusTCP
The modbus driver communicates with the modbus protocol (in the so called RTU mode) serial or over
ethernet (TCP/IP) with partner devices.
Possible data type are Coils, Discrete Input, Holding Register and Input Register.
For the communication you need either a standard serial port or a network connection to the partner device.
Tab Modbus
Option Description
Data model starts If this option is set, data addressing begins with 1 (otherwise start address 0 is used).
with address 1
Tab Modbus
Option Description
Address Enter here the IP address of the partner device.
Port Enter here the port number (502 is the default Modbus port).
Unit Enter here the unit number (possible value 0 .. 255).
Data model starts If this option is set, data addressing begins with 1 (otherwise start address 0 is used).
with address 1
188
Process Assignment
Coils
Coils are addressed bit by bit and are read with the Modbus function 1 and written with function 15.
Option Description
Data type Select here the data type Coils.
from address Enter here the first address (0 – 65535), which shall be transferred with the process
assignment table.
to address (or Enter here the last address (0 – 65535) or the count, which shall be transferred with
count) the process assignment table.
Discrete Inputs
Discrete Inputs are addressed bit by bit and can only be read (Modbus function 2).
Option Description
Data type Select here the data type Discrete Inputs.
from address Enter here the first address (0 – 65535), which shall be transferred with the process
assignment table.
to address (or Enter here the last address (0 – 65535) or the count, which shall be transferred with
count) the process assignment table.
Holding Register
Holding Register are addressed word by word and are read with the Modbus function 3 and written with
function 16.
Option Description
Data type Select here the data type Holding Register.
From register Enter here the first register (0 – 65535), which shall be transferred with the process
assignment table.
To register (or Enter here the last register (0 – 65535) or the count, which shall be transferred with the
count) process assignment table.
Input Register
Input Register are addressed word by word and can only be read (Modbus function 4).
Option Description
Data type Select here the data type Input Register.
from register Enter here the first register (0 – 65535), which shall be transferred with the process
assignment table.
to register (or Enter here the last register (0 – 65535) or the count, which shall be transferred with the
count) process assignment table.
189
Manual AMS Asset Graphics 5.4
S7PG
Siemens S7 PG-Interface (S7-300 and S7-400)
With the driver S7 PG, Simatic S7-300 and S7-400 PLCs can be connected to AMS Asset Graphics. The
hardware connection between the PC and the PLCs of the MPI-network is realized by the PC-adapter of
Siemens. Data words will be read from or written to the data blocks. By means of the driver it is possible to
address up to 126 stations (S7-300 or S7-400).
See also
Required hardware
Special error messages
Note To exchange Real-values with an S7-PLC, the special function FloatSwap must be defined in the
process assignment tables.
Required hardware (S7PG)
PC-Adapter
The connection between PC and MPI-network consists of a special Siemens PC-adapter-cable with level
converter RS232 to MPI-standard.
In the test, the following PC-adapter was used:
PC adapter SVPJ7301022
Order number: 6ES7 972-0CA21-0XA0
Dialog Driver profile (S7PG)
Tab Profile
Select driver S7PG here.
190
Process Assignment
CPU slot number Set here the number of the CPU slot number (0 - 18). In general, the default value of 0
do not have to be changed. At some CPU-types, this definition must explicitly be made
(symptom: communication does not work). In this case, you have to enter the correct
number of the CPU slot number.
Data type Here you can only select data type Data block.
Data block Enter here the number of the data block (1 - 8192), which shall be transferred with the
process assignment table.
From word Enter here the number of the first data word (0 - 32767), which shall be transferred with
the process assignment table.
To word Enter here the number of the last data word (including) or the number (0 - 32767),
(or number) which shall be transferred with the process assignment table.
Special error messages (S7PG)
The driver can display the following special error messages:
Error message Description
Initialization of the station has The initialization of the station number in the PC-adapter has failed
failed! (incorrect station number)
Connection telegram has failed! The connection with the MPI station has failed (no station with this MPI
number in the network)
Life-telegram has failed! The life telegram of a station was not received.
Data telegram not terminated Incorrect data transmission to a station (e.g. because of a missing data
correctly! block).
191
Manual AMS Asset Graphics 5.4
S7_Connection
Siemens S7_Connection
With the driver S7_Connection Simatic S7 PLCs can be connected to AMS Asset Graphics. The hardware
connection between PC and PLC units will be realized via Ethernet. As protocol S7-connection is used.
Data blocks and flags can be read from the PLC or written to it. The addressing is made according to the
S7-standard as byte address.
See also
Driver specific settings
Special error messages
Driver specific settings (S7_Connection)
Make the driver specific settings in the dialog Driver profile on the tabs Profile and Connection.
See also
Process assignment tables at driver S7_Connection
Dialog Driver profile (S7_Connection)
Tab Profile
Select here the driver S7_Connection.
Tab Connection
Option Description
Address Enter here the IP address of the PLC to be connected, e.g. 192.168.1.1.
S7-300 / S7- Enter here the PLC type.
400
S7-200
S7-300 / S7-400
Connection Choose here the connection type for the communication.
type You can select: PC (default), OP or PG.
Note The communication only can be established if a connection resource of the chosen
type is available in the PLC.
Rack Enter here the rack number.
Slot Enter here the slot number.
S7-200
Local TSAP To communicate with a S7-200 TSAPs have to be entered as 4-digit hexadecimal number
Remote TSAP according the configuration in the S7-200.
The value 4D57 (hex) is predefined and can be used without configuration in the S7-200.
192
Process Assignment
With the driver, the following data types DB (Data block) and flags can be read and written:
Flag
From byte Enter here the address of the first flag byte (0 – –65535), which shall be transferred
with the process assignment table.
To byte Enter here the address of the last flag byte (0 – –65535) or number of bytes, which
(or Number) shall be transferred with the process assignment table.
Note In a S7-200 the variable memory area can be accessed as data type DB and the data block number 1.
193
Manual AMS Asset Graphics 5.4
S7_PPI
Siemens S7 PPI
Description
The driver S7_PPI substitutes the driver S7_200_PG.
By means of driver S7_PPI, Simatic S7 200 PLCs can be connected to AMS Asset Graphics. The hardware
connection between the PC and the PLC units of the MPI-network will be realized by the PC-PPI adapter of
Siemens. It is possible to read from or write to variable memories, flags, special memory, counters, inputs
and outputs. It is possible to address up to 31 stations.
See also
Required hardware
Dialog Driver profile (S7_PPI)
Tab Profile
Select here the driver S7_PPI.
Tab Configuration
Select here the station number of the PC (default value 1).
Baud rate Select the required baud rate for the communication from the list of possible baud rates.
Possible values are 9600 or 19200.
Option Description
Data type Select here required data type.
Station Set here the station number of the PLC (2 - 126).
number
From byte Enter here the number of the first byte, which shall be transferred with the process
assignment table.
To byte Enter here the number of the last byte (including) or the number of bytes to be
(or number) transferred.
194
Process Assignment
S7_Ethernet
Siemens S7_Ethernet
With the driver S7_Ethernet Simatic S7 PLCs can be connected to AMS Asset Graphics. The hardware
connection between PC and PLC units will be realized via Ethernet. As protocol, an ISO-on-TCP connection
or a TCP-connection can be selected. Data blocks and flags can be read from the PLC or written to it. The
addressing is made according to the S7-standard as byte address.
See also
Driver specific settings
Required hardware
Special error messages
Installation of the PLC software
Dialog Driver profile (S7_Ethernet)
Tab Profile
Select here the driver S7_Ethernet.
Tab PLC
Option Description
PLC type Presently PLC type S7_BYTE is defined and cannot be changed.
S7 addressing Option S7 addressing mode must be set, if the CP interprets the start address as
mode byte-address.
If this option is not offered in the S7-software, it must not be selected here.
Tab Connection
Option Description
Connection type The connection protocol ISO-on-TCP-connection or TCP-connection is selected
here.
Address Enter here the IP address of the PLC to be connected, e.g. 192.168.1.1.
195
Manual AMS Asset Graphics 5.4
Option Description
TCP-connection The necessary port numbers for a TCP-connection are entered here.
See also
Installation of the PLC software
Fetch Ports Enter here the port numbers for the read connection to the PLC. Local stands for
the PC, Partner for the PLC.
Explanation of Partner* see below.
Write Ports Analogous to the read connection, the port numbers for the write connection to the
PLC are entered here.
With the driver, the following data types DB (Data block) and flags can be read and written:
Flag
From byte Enter here the address of the first flag byte (0 – –65535), which shall be transferred
with the process assignment table.
To byte Enter here the address of the last flag byte (0 – –65535) or number of bytes, which
(or Number) shall be transferred with the process assignment table.
196
Process Assignment
See also
Process assignment tables at driver S7_Ethernet
Required hardware (S7_Ethernet)
Connection
With the driver S7_Ethernet Simatic S7 programmable logic controller can be connected to AMS Asset
Graphics. For the communication the PLC must have a communication processor module (CP). The
computer uses the standard ethernet network interface.
It is required that the CP can handle a ISO-on-TCP-connection or -TCP-connection.
Samples are:
CP 343-1, CP 343 Lean.
Overview
Configure the CP for the Ethernet.
Configure the connections of the CP in the CPU.
197
Manual AMS Asset Graphics 5.4
In dialog Properties of the ISO-on-TCP connection, the following definitions have to be made
Tab Settings
General Information Enter e.g. AG-read as name.
The option Active connection establishment has to be switched off.
Addresses Enter here asRremote IP the IP address of the AMS Asset Graphics PC.
As TSAP you have to enter twice INVISURD.
Options The Mode has to be set on Fetch passive.
If available, set the S7-addressing mode.
2 The Write-Connection
Make a new connection with connection type ISO-on-TCP connection and the station definition
(unspecified).
In dialog Properties of the ISO-on-TCP connection, the following definitions have to be made
Tab Settings
General Information Enter e.g. AG-write as name.
The option Active connection establishment has to be switched off.
Addresses Enter here as Remote IP the IP address of the AMS Asset Graphics PC.
As TSAP you have to enter twice INVISUWR.
Options The operating mode has to be set on Write passive.
If available, set the S7-addressing mode.
2 The Write-Connection
Make a new connection with connection type TCP connection and the station definition (unspecified).
In dialog Properties of the TCP connection, the following definitions have to be made
Tab Settings
General Information Enter e.g. AG-Write as name.
The option Active connection establishment has to be switched off.
Addresses Enter the IP address of the AMS Asset Graphics PC in field Remote.
In addition the Local and Remote port number has to be entered.
Options The Mode has to be set on Write passive.
If available, set the S7-addressing mode.
198
Process Assignment
S7_Softnet
Siemens S7_Softnet
With the driver S7-Softnet you can exchange data Simatic PLCs.
The communication is done via the so called SAPI software interface (Siemens software package), which
realizes the communication.
Precondition is a correctly installed Simatic PC station.
Further information you can get from Siemens, e.g. with the following articles:
Communication with CP 5611 via MPI, Entry ID:16513313
Communication with CP 5611 via ProfiBus, Entry ID:16518259
Communication via Industrial Ethernet, Entry ID:17532609
SIMATIC NET Commissioning PC Stations, Entry ID:13542666
199
Manual AMS Asset Graphics 5.4
Tab Profile
Select driver S7_Softnet here.
The Timeout should be set to a value bigger than 5000 ms, because the initializing of a connection can
spend a few seconds.
Tab Addressing
Option Description
Access point Via the name of an access point applications can access communications
components. The access points are configured with the Simatic program
Configuration Console.
Application name Here you must enter the name of a user application, which was configured in
the HW Config for the PC station.
Connection identification Here you must enter the name of the connaction, which shall be used.
Connections are configured in NetProt.
With the driver you can read and write the following data types:
Data type Description
DB Data block
A Output
E Input
M Flag
PA Peripheral output
PE Peripheral input
T Timer
C Counter
Timer and counter are transferred in the BCD format (16 Bit).
For processing timers you can use the function S5Time, at counters you should use BCD-Word.
200
Process Assignment
S7_MPI
Siemens S7_MPI (S7 300 and S7 400)
With the driver S7_MPI AMS Asset Graphics can exchange data with Simatic S7 300 and S7 400 PLCs. The
hardware connection between the PC and the PLCs of the MPI-network can be realized by the PC-adapter
of Siemens. Data will be read from or written to the data blocks. With this driver it is possible to address up
to 126 stations (S7 300 or S7 400).
See also
Required hardware
Special error messages
Note To exchange floating point values with an S7-PLC, the special function FloatSwap must be defined in
the process assignment tables.
Dialog Driver profile (S7_MPI)
Tab Profile
Select driver S7_MPI here.
201
Manual AMS Asset Graphics 5.4
202
Process Assignment
SICP
Siemens S5 CP-Interface
Description
The data are exchanged via a communication processor CP. At the CP the procedure 3964R and the
interpreter RK512 has to be set.
Addressing in the process assignment (Tab Addressing in dialog Properties of the process
assignment table)
It is possible to address both data types DB and DX.
Data type DB
Option Description
CPU number Enter here the number of the CPU. Possible values are 0 to 4. At this, the following
applies:
0 = all CPUs are possible
1 - 4 = CPU-number
Data type Select here data type DB = Data block.
Data block Enter here the number of the data block. Possible value are between 0 and 255
DB
From word Number of the first data word
To word Number of the last data word (including)
Data type DX
Option Description
CPU number Enter here the number of the CPU. Possible values are 0 to 4. At this, the following
applies:
0 = all CPUs are possible
1 - 4 = CPU-number
Data type Select here data type DX = extended data block.
Data block Enter here the number of the extended data block. Possible value are between 0 and 255
DX
From word Number of the first data word
To word Number of the last data word (including)
203
Manual AMS Asset Graphics 5.4
Further Information
Cable connection
Installation of the PLC software
Special settings
Siemens S5 CP-Interface (Installation of the PLC software)
The CP has to be programmed as follows:
1. Program the CP with by using the procedure 3964R and interpreter RK512.
2. Set the priority on low.
3. Select the desired baud rate.
204
Process Assignment
SIPG
Siemens S5 PG-Interface
Description
The data will be exchanged via the programming interface of the PLC. Data words will be read from or
written to the data blocks.
The followings PLCs can be used:
PLC Driver
90U SIPG
95U SIPG
100U SIPG
115U CPU 941 - CPU 944 SIPG
Data type DX
Option Description
Data type Select here data type DX = extended data block.
Data block DX Enter here the number of the extended data block. Possible value are between 0 and 255
From word Number of the first data word
To word Number of the last data word (including)
205
OPC
Editor
Introduction
OPC (OLE for Process Control) is based upon the Windows-based technology of OLE (Object Linking and
Embedding), COM (Component Object Model) and DCOM (Distributed Component Object Model).
A client-server architecture classifies the software components in OPC Server and OPC Client. An OPC
Server provides data via the OPC interface, for example it collects data via a field bus system and offers
them to other clients. The OPC Runtime (client) has access on measuring points via so called OPC items.
The OPC items have logical names (such as "Filling level" or "Weight") and can be combined to a group.
The access for reading and writing will proceed on this group level.
At the data point assignment you can look for available servers, also for the AMS Asset Graphics OPC
Server. You can start the servers, if they are not yet active and select variables via a browser. At hierarchical
OPC Servers you can change between the individual branches. The indication of the data points can be
specialized by using filters.. If a data point is included into the assignment list, the complete Server-ItemID
will be accepted as OPC tag name and the data point description as data-element.
See also
User interface
OPC table window
Define an OPC Client
User interface
The OPC Editor is designed as MDI-application, this means, several documents (process assignment
tables) can be processed at the same time.
Connect
Select this command to connect the current OPC table with the selected OPC Server. This command is only
at disposal, if a server is selected.
Disconnect
Select this command to disconnect the current OPC table from the selected OPC Server. This command is
only at disposal, when the table is connected with a server.
Append item
Select this command to open dialog Append item.
See also
General Operation
207
Manual AMS Asset Graphics 5.4
Tab OPC
On tab OPC you determine the local server or the remote computer.
Option Description
Server
Name Select one OPC Server from the list of servers.
Note This place, also the AMS Asset Graphics OPC Server can be attached.
Server in Activate this option, when you start an OPC Server not on the local computer.
network In the field Computer name you enter here the name of the computer or its IP address.
Computer Here you enter the name of the computer or its IP address.
name
Group
Name Enter here a name for the group of OPC items. The access for reading and writing will take
place on this group level.
Update [ms] Here you enter the shortest update time in milliseconds, the server can inform the client
about changed data. The value 0 means: as fast as possible.
Tab Connection
On tab Connection the settings for activation and check of the server connection are entered.
Option Description
Active at
Element Enter here the name of a num-element, which determines whether the OPC table is active or
not. If the value of the data-element is 0, the OPC table is inactive, otherwise the OPC table is
being processed.
If no element name is entered here, the OPC-table is always active.
Station With this option you define on which network station the OPC table shall be processed (0 for the
master, 1 – 31 for the desired station).
This field is only available at a network project. For this, you must have activated the option
Network project in the dialog Runtime Configuration in the Project Manager.
OPC server status
Active Enter here the name of a num-element, which shows the status of the connection to the OPC
Server. The element will be set on 1, when there is a connection. If the connection is inactive or
broken the element will be set on 0.
Note Only the connection between OPC Server and Client will be checked. The connection
between OPC Server and the communication hardware will not be checked.
Update This field defines the update time in seconds to test the connection to the OPC Server.
Tab Logging
208
OPC
Tab VBScript
In this VBScript you enter a Sub Routine named OnDataChanged. This Routine is called on every change
message from the OPC Server.
The first parameter of this Sub Routine is the name of the num-element, which is entered in the OPC table.
The second parameter is an OPC tag. This OPC tag has the following 5 properties:
Property Description
Name Name of OPC tag.
Quality Quality of the OPC tag. This value is a 16bit number, where the two upper bits of the
lower byte represent the quality. If both bits are 1, the quality is good. To mask the
quality from this 16 bit value use an AND gating with the value 192 (hex C0).
Value Value of the OPC tag.
TimeStampLocal Date and time of the OPC tag as locale PC time.
TimeStampUTC Date and time of the OPC tag as UTC time.
Example:
Sub OnDataChanged(Element, OpcTag)
Set NameEle = CreateObject("PMS.TxtEle")
NameEle.SetName(Element & "_Name")
NameEle.Value = OpcTag.Name
You can also use functions OnStart (initialization), OnRun (cyclical) and OnEnd (end of Operation Log
Runtime). A detailed description of the possible functions can be found in section VBScript.
209
Manual AMS Asset Graphics 5.4
Column Description
Element Enter here the data-element, which shall be transmitted to the OPC Server.
OPC tag name Enter here the OPC tag name, that shall correspond to the data-element.
Internal Enter here the value range for the data in the PC.
(From / To)
External Enter here the value range for the data in the OPC Server.
(From / To) If the entered values are not in the valid range, the text will be printed in blue.
Type The data type (NUM or TXT) of the data-element is shown here.
When you enter an element via dialog Append item the element name and OPC tag name will automatically
be entered. As OPC tag name, the complete Server ItemID will be accepted and the data point description
as data-element.
If the same element name is used in multiple lines, the concerned lines will be highlighted in red.
Note Furthermore, you have to take the rules for element names in AMS Asset Graphics PMS into account.
See also
Define an OPC Client
210
OPC
Example:
'Parameter 1' is used as prefix for element names.
Function BuildElementName(Para1, Para2, OpcTagName)
BuildElementName = Para1 & OpcTagName
End Function
The OPC Runtime program has not a special user interface like the Eventjournal Runtime. Status messages
are displayed in the program window, though.
211
Manual AMS Asset Graphics 5.4
OPC-Server
Introduction
The AMS Asset Graphics OPC Server has access on all data-elements of the AMS Asset Graphics
database. Thus it permits devices from other companies, to access on AMS Asset Graphics data simply via
a standard-Interface. The OPC-version 2.03 will be supported. In addition it permits the junction of several
projects to a comprehensive project. Thereby, single projects may also be stored on different computers in
the network, since AMS Asset Graphics OPC Servers can be remote controlled.
All data-elements can be read and written. The num-elements will be at disposal as data type „VT_R8" (8
bytes, this corresponds to a double-value) and the text-elements as „VT_BSTR". The server supports
browsing and filtering of items, for fast results at searching elements. The data are represented, as they are
available in the reference lists. This means, that elements which appear in different reference lists, will be
listed several times.
At any one time, exactly one project can be connected with the server. The project will be selected in dialog
Options. In case of a change, the data exchange will take place.
Registration
Before the use, OPC Servers must be registered once. The AMS Asset Graphics OPC Server will be
registered by parameter /RegServer and unregistered by parameter /UnregServer.
for example
„C:\AMS Asset Graphics\InvOPCServer32.exe" /RegServer
When you install the AMS Asset Graphics OPC Server with the help of the setup, all necessary OPC-
components are installed, and the OPC Server registered automatically.
User Interface
The AMS Asset Graphics OPC Server offers the user the normal AMS Asset Graphics runtime-user
interface. The server can be terminated over menu command file Exit. Via menu command Options | Global
Settings... the Start project for the server can be selected.
Program start
The OPC Server is usually started automatically from the OPC Client, which wants to access on the server.
If the server has already been started, it will be used. However, the server can also be started manually. At
the program start, a connection to the current runtime project or to the selected start project is made.
Program end
Usually, the OPC Server is terminated automatically from the last client, which is connected to the
server. The server can also be terminated manually over menu item File exit. If there are still some clients
connected to the server, a warning will be output.
Option Descriptions
Start project
Current runtime Set this option to configure the current runtime project as start project.
project
Fixed project Set this option to configure a fixed project as start project. When clicking the browse-
selection button to open the dialog Project selection.
212
OPC
Remote-operation
Prerequisite for the remote-operation is the network connection of the computer via TCP/IP.
IMPORTANT NOTE
You have to make sure, that the user accounts (user-profiles) on both computers have access on the
same working group or the same domain.
The behavior of the OPC Server in the local mode is the same as in the remote operation (client and server
on one computer).
To use the OPC Server in the remote operation, some settings in the Windows system configuration have to
be made. The program part, where the settings must be carried out, is called DCOM (Distributed
Component Object Model).
To configure DCOM, start program DCOMCNFG from directory WINNT\SYSTEM32 of the environment of
your operating system. Start this program on both computers, to configure the OPC-remote operation.
213
Manual AMS Asset Graphics 5.4
214
OPC
215
Manual AMS Asset Graphics 5.4
216
OPC
217
Manual AMS Asset Graphics 5.4
218
Events
Editor
Eventjournal Editor
The Eventjournal provides information for the user of a plant, when a measuring value has violated a
predefined limit value, when a malfunction was indicated, a valve opened or closed etc. The individual
events will be entered at runtime into a list: the Eventjournal.
The Eventjournal Editor offers the user of the development version a user interface to configure the events
for a project. An event is the message on the condition of a data-element under specific, previously defined
conditions. This message will be entered into the Eventjournal and can be watched there.
Events can be written simultaneously on up to three printers and into one file.
Depending on the state of the event and the optionally required acknowledgement, events can have up to 4
different states, which are marked in the Eventjournal Runtime with (freely selectable) colors of the entries.
Properties of the events are defined in up to 100 groups. Every event is assigned to a group.
At the definition of the alarm texts it is possible, to design them depending on the language. The possible
languages are defined in dialog Used languages in the Language Editor. When generating an alarm text
during runtime, the texts will be shown depending on the current language (see system-element
_Language).
The Eventjournal Editor offers the support for the definition of the events. Thereby, event definitions of
several projects can be opened at the same time.. An exchange of definitions can be made via the clipboard
and drag & drop.
Moreover, the Eventjournal offers the possibility, to generate databases with historical alarms. This is a
group property (see: tab General in dialog Group). The data are stored in a SQL database.
Runtime function
If an event occurs, it will be entered into the Eventjournal as text. After the event has gone again, or if it was
acknowledged, the entry in the journal will be actualized (by removing from the journal or adding the time
and changing the text color).
The Eventjournal is activated by changing the system-element _SetTopEJ (e.g. via a function key). While
watching this list, the entries will be actualized.
An event, which is no longer active and has already been acknowledged or an event, which is no longer
active and need not be acknowledged, will be removed from the Eventjournal.
Thus, the Eventjournal only contains active and not acknowledged events and therefore presents the current
state of event messages.
The Eventjournal comprises a maximum of 5000 events. When reaching 90% of this limit, a warning will be
output, at 100% a message is output and no more events will be detected. Therefore you have to take care,
that events, which are not removed automatically from the list, will be acknowledged regularly.
When activating the Eventjournal, the system-elements _AlarmCome and _AlrmGone are set on 0.
See also
Define an event (Step-by-step instructions)
219
Manual AMS Asset Graphics 5.4
User Interface
The Eventjournal Editor is designed as MDI application, i.e. the event configuration of several projects can
be edited at the same time.
See also
General operation
Groups
Various properties of alarms are defined in up to 100 groups. Every alarm belongs to one group
You can select the colors for the outputs of the event texts. In addition you can activate the event history,
stored in a SQL database. You can select one or more printers for the output.
You define, whether events of a group has to be acknowledged or not and you can define an automatic
change of pictures, when an event occurs. In this way you can define definite priorities for various events
with the help of different groups.
An active alarm indicates that the reason for the message is still available, at an inactive alarm, the reason is
not available anymore and the message is not yet acknowledged.
With the menu command Edit | Groups, the dialog Group selection will be opened. Select a group and edit
then the properties in the dialog group.
Dialog Group
On three tabs, the properties of an alarm group are defined.
Tab General
On the tab General, the following settings are made for a group:
Option Description
Group
Name Enter here a name for the alarm group.
Automatic picture Activate the option, if the visualization shall change automatically to an alarm picture
change when an alarm occurs. The alarm picture is configured in the event definition
window on tab Extras in column Alarm picture.
Group elements With group elements its is possible, to summarize information of all messages which
are part of a group.
Alarm detected The element, entered here, will be set on 1, if an alarm of this group is active.
Otherwise it will be set on 0.
220
Events
Option Description
Alarm text The text-element, defined here, contains the alarm text of the last occurred alarm of
this group. If there is no alarm of this group, the contents of this element is empty.
Acknowledgment
Necessary Activate the option, if an event of this group must be acknowledged.
Password Enter here a password level, or click with the right mouse button to open dialog
Select access right and to select the password level.
Log level Enter here a log level between 0 and 99. When log level 0 is entered, no record is
made in the activity log.
History
Old mode (Compatibility option, use for new projects option Active)
Activate this option, if an alarm of this group shall be written in a historical database (
Access format).
At every status change (Coming, Going, Acknowledged an new entry is made in the
database (one database per day, see Historical alarms).
Active Set this option to active the storing of events in the SQL database for events.
Include alarm texts With this switch you decide, whether the alarm texts shall also be written into the
historical table of the SQL database. At static alarm texts (no dynamic text via the
parse function) this option is not necessary. The required memory space in the
database is smaller without alarm text.
Delete data after... Define here, when the historical data shall be deleted. After each change of the day,
the system checks whether data have to be deleted. At 0, the data will never be
deleted.
Export data before Mark the field to export the data into a CSV file before deleting them.
deleting
Destination Define here the name of a destination file to export the data. You can also use
variables in the text, example:
D:\export\$_Year\$_Month\daten.csv.
Attention If you use special characters, consider that not all characters can be used
for as file name.
If the file does already exist, the data will be appended to the end of the files.
221
Manual AMS Asset Graphics 5.4
Option Description
Print on status change
Coming Activate this option, if the alarm shall be printed, as soon as it has occurred.
Going Activate this option, if the alarm shall be printed, as soon as the alarm condition has
disappeared.
Acknowledged Activate this option, if the alarm shall be printed, as soon as it was acknowledged.
Print to
Printer 1, 2, 3 Set this option to activate the output of an alarm on the named printer 1 (2, 3). The printer
are configured in dialog Printer assignment.
File When you activate this option, an alarm of the group will be written into the file, entered in
the edit field below (incl. disk drive, path and name e.g.
"C:\AMS_ASSET_GRAPHICS_Alarm.txt"). New alarms will always be appended at the
end of this file. This file can then be printed at a later time.
You can also use variables in the text, example:
@_ProjectPath\ALARM.TXT.
Attention You have to take into account that the file size increases with every new entry!
Option Description
Text prefix
Alarm came in, Here you can configure prefix texts for messages. Prefix texts can be different for coming
Alarm went out and going alarms.
Acknowledgment
Delete If this option is on and an event of the group was acknowledged, the message will also
messages be deleted in PageControl.
222
Events
Printer
With the menu command Edit | Printer the dialog Printer properties will be opened.
The dialog has three tabs to configure the printer. The title bar of the dialog shows the physical printer, for
which the settings are just made.
Tab General
On the tab General the following parameters can be set:
Option Description
Print title This entry contains the headline for the printout. It may contain also data-elements.
Margins
Left Here you can define the width of the left margin. The definition is made in characters. possible
values: 0 - 10.
Top Here you can define how many lines at the beginning of the text shall be left free. The
definition is made in lines. possible values: 0 - 10.
Bottom Here you can define how many lines at the end of the page shall be left free. The definition is
made in lines. possible values: 0 - 10.
Printing mode
Direct You can select between two printing modes. The Direct mode sends the events to be printed
directly to the printer. This print mode is suitable especially for dot-matrix printers.
Note If two defined logical printers use the same physical printer and if one of them was
defined for direct printing, at the time scheduling for the print jobs (advanced printer properties,
see operating system) the option Start printing after after last page is spooled must be
activated, since otherwise the function Direct printing will be blocked.
Windows The second print mode will print the pages after terminating the Eventjournal Runtime or by
request from the runtime program. Depending on the printer setting in the operating system
(see Direct print) every complete page will be printed.
Test page With this command you can print a test page by using the current settings (mode, margins,
color, etc.).
Note If you have changed the parameters before, press Apply to use the changed settings.
223
Manual AMS Asset Graphics 5.4
Printer assignment
You open the dialog Printer assignment with the menu command Edit Assign Printer.
Here you can assign up to three physical printers to logical names. In addition, the orientation can be
selected (Portrait or Landscape).
If option Standard is set, the program uses the current standard printer of Windows, defined at the program
start. Moreover, a name can be defined for the printer, which will then be used also for the group and printer
settings.
An event has occurred, when a num-element has violated the alarm limits. The valid range is defined with
minimum and maximum in the table. It is possible to define multiple events for a num-element.
In order to avoid permanent messages in the limit range between valid and invalid, e.g. at analog values, a
hysteresis can be defined. An event condition is not cancelled before the hysteresis range is left again.
The alarm text, the group, optional alarm element and optional alarm pictures are further definitions for every
event. The acknowledging element offers the possibility, to acknowledge an alarm via a num-element. An
acknowledging information element supplies information, how many alarms are not acknowledged. If the
notification and alarm system PageControl is installed, you can specify receiver for alarm forwarding.
The tabs
The event definition-window has of a toolbar and six different tabs.
On individual tabs various settings will be made, which will be explained in the following part. Every tab
contains the element name in the first column. The width of the first column is identical on all tabs. When
you want to change the width of a column with the mouse in the head line.
224
Events
Tab Parameter
Column Description
Element Here you must enter the element to be monitored.
Bit At the definition of an alarm, a bit number between 0 and 31 can be selected. If a bit was
declared, it will only be regarded for the calculation of a range violation, this means for the
minimum-/ maximum evaluation: only the values 0 and 1 can appear.
Minimum Enter here a limit. If the value is below this limit, an event will be triggered. Constants or
num-elements may be entered here. If no lower limit is wanted, you do not have to enter a
value here.
Maximum Enter here a limit. If the value is above this limit, an event will be triggered. Constants or
num-elements may be entered here. If no upper limit is wanted, you do not have to enter a
value here.
Alarm range
A range for an active alarm can be defined by a maximum less than the minimum.
Example:
An alarm shall be active, when an element has the value 38.
Define and 38.1 for the minimum and 37.9 for the maximum.
Alarm group Select with the right mouse button a group from dialog group selection or enter the group
number directly in the cell.
Note You can also select and change several cells at the same time.
Def-ID Here, the unique identification number for the alarm definition is shown in this column. This
ID is used in the historical alarms to identify an alarm.
225
Manual AMS Asset Graphics 5.4
Tab Extras
Column Description
Element Here you must enter the element to be monitored.
Alarm element A num-element will be entered here, which has the value 1 as long as the alarm is
active. If the alarm is inactive, the Alarm element has value 0.
This alarm element can be shown in every process picture.
If an alarm element was set on 1 by several events, it will be reset on 0, not before all
events are inactive again. Thus, the alarm element is an OR operation of the active
events.
Alarm picture It is possible to define pictures, which will be displayed, when an alarm occurs. The
name of the picture is entered here.
If in the group the option Automatic picture change is activated, at the appearance of
the event in the visualization, the picture with the contained name will be shown. In
the Eventjournal the change of pictures can also be performed with button alarm
picture.
See also
Automatic change of pictures in alarm situations (step-by-step instructions)
Alarm forwarding If PageControl is installed, you can select a separate receiver (defined in
Coming, PageControl) for coming and going alarms. Receivers have to be defined in
Going PageControl in advance.
The input of an alarm receiver will be checked in the following. With the right mouse
you open dialog receiver selection, where one receiver can be selected.
Note With the connection of PageControl to the Eventjournal, there are extended
possibilities for the notification of persons in case of alarm situations.
In this process, the receiver will be informed by a voice message (call on mobile
telephone or telephone and output of the alarm as spoken text), SMS-message, E-
mail, fax or Scall, etc.
At the start of the Eventjournal the runtime, all registered receivers will be compared
with the receivers, defined in PageControl. If a receiver does not exist, this will be
indicated.
Ackn. element The acknowledging element offers the possibility, to acknowledge an alarm via a
num-element. With this, an alarm can also be acknowledged from a PLC.
If an alarm occurs, it will be acknowledged, as soon as the acknowledging element
changes its value.
If the acknowledgement is password protected, it will not be requested in this case.
If the group property Acknowledgment necessary isn't set, the entry will be shown in
gray. In this case it has no function.
Ackn. information The acknowledgement information element provides information, how many
alarms are not yet acknowledged.
Enter here a num-element, which is initialized with 0 at the start of the journal. When
an alarm occurs, that has to be acknowledged, the value of this element is increased
by 1. By acknowledging the alarm, the value of the element will be decreased by 1. If
an element is used by several alarms, the value of this element provides information
about how many alarms have still to be acknowledged.
If the group property Acknowledgment necessary isn't set, the entry will be shown in
gray. In this case it has no function.
226
Events
Tab Hysteresis
Column Description
Element Here you must enter the element to be monitored.
Value hysteresis To avoid generating events permanently in the transition range between permitted and
inadmissible ranges (at fluctuating values), a value hysteresis can be defined here. At
this, the following functionality applies: If the limit value is reached exactly, within the
range of ± switching hysteresis, it is considered to be outside of it any longer. If this
behavior is not desired, leave the hysteresis on the default value 0.0.
Detecting time An alarm will be only created, if the alarm condition is permanent given for the entered
time. The time is configured in seconds.
If no detecting time is wanted, you do not have to enter a value here.
Resolving time An alarm will be only resolved, if the alarm condition is not permanent given for the
entered time. The time is configured in seconds.
If no resolving time is wanted, you do not have to enter a value here.
Tab All
Tab All presents a summary of the other tabs.
With tab All you can paste all events completely into the clipboard or to copy it by drag & drop into other
programs or to load from other program.
In addition, all information are available at a glance.
See also
Define an event
Define events for other languages
227
Manual AMS Asset Graphics 5.4
The entries Server, Catalog, User and Password are used for the database connection. Via the entries
SubProjectName and SubProjectNumber you can store additional information to the event data in the
database. So it is possible to store the event data of several AMS Asset Graphics projects centrally in one
database.
Furthermore, it is possible to store the data simultaneously in several databases by a multiple start of the
TEJ_DM32.exe. For this purpose, another section with the same key name has to be configured in
Project.ini. The name of the section has to be passed as parameter at the start of TEJ_DM32.exe.
Example:
Tej_dm32.exe DB2
Tej_dm32.exe DB3
[DB2]
Server=172.16.31.22\inVISU_PMS
...
[DB3]
Server=172.16.31.33\inVISU_PMS
...
228
Events
Table Description
Def_Table Here, the data of the definition are stored. For every definition line of the Eventjournal
Editor one dataset is generated.
Def_Groups The group properties will be stored here.
ExtraText Every additional text of the additional text file will be stored here as dataset.
SubProjects In this table, all sub projects are entered with name and sub project number.
DataManagers Every instance of an Event Data Manager (Tej_DM32.exe), connected with this
database, will be shown in the table with a dataset.
CurrentState This table contains an image of the active and unacknowledged events of the
Eventjournal.
InfoCurrentState This table contains an change counter which changes, when new data are entered in
table CurrentState or when data have changed.
EventHistory Every change of the state (coming, going and acknowledged) will be entered into this
table with a time stamp.
AcknowledgeJobs Datasets in this table are used to acknowledge events.
Tab VBScript
In this VBScript window you can implement different functions such as OnStart (initialization), OnRun
(cyclic) and OnEnd (end of Eventjournal Runtime). A detailed description of these three functions is given in
the section VBScript.
Apart from the standard functions the following functions and objects can be used:
Object Application to read information and to generate new events.
Function OnEventStateChanged is implemented here. This function is called with the status
change of an event.
Handle mouse events from the Eventjournal.
Object Application
The Application object has following properties and methods:
Property/Method Description
SetAlarmOn(DefID, DateTime) This function creates a new event from the alarm definition with the
definition ID DefID. The second parameter is the time in the UTC time
format, which is shown under column Coming in the Eventjournal runtime.
The function returns 0 for success. On errors an error code is returned.
SetAlarmOff(DefID, DateTime) This function resets an event, which was set by the function SetAlarmOn.
The two parameters are the same as with the SetAlarmOn function. The
Eventjournal Runtime displays the DateTime in the column Going.
AcknowledgeAlarm(DefID, With this function all events of the definition ID DefID are acknowledged.
DateTime, Comment) The 2. parameter DateTime is used as acknowledging time. The
parameter Comment is used in the activity log as comment to the
acknowledge message.
Definitions Definitions is a collection of all definition lines. Every definition line can be
read by an item of the array. An access for writing is not possible.
Events Events is a collection all events from the event journal. An access for
writing is not possible.
229
Manual AMS Asset Graphics 5.4
Examples:
In the following example an event is produced for the definition ID 1173.
Application.SetAlarmOn 1173, PmsLocalDateTime2Utc("2005/07/15 08:34:23")
OnEventStateChanged
This function is called each time when a event is coming, when it is acknowledged and when it's going.
The OnEventStateChanged functions has the following parameters:
Parameter Description
NewState This value indicates the new state of the event.
1, event comes
2, event goes
3, event is acknowledged
EventObj Is a variable of the type EventObject. This variable represents information to the event. Some
properties are writable.
Example:
The coming and going time of the events from group 6 is changed. Instead of the current time the time of a
data-element is used.
Sub OnEventStateChanged(NewState, EventObj)
If EventObj.Definition.GroupNumber = 6 Then
Set EventTime = CreateObject("PMS.TxtEle")
EventTime.SetName(EventObj.Definition.ElementName & "_Time")
'set time stamp
If NewState = 1 Then EventObj.Coming = EventTime.Value
If NewState = 2 Then EventObj.Going = EventTime.Value
End If
End Sub
Mouse events
Mouse messages from the Eventjournal Runtime can be handled in this VBScript
To do this the appropriate VBScript function must be defined:
230
Events
Example:
Open a PDF document when the right mouse button is clicked in the event window.
Set WinExec = CreateObject("PMS.TxtEle")
WinExec.SetName("_WinExec")
Set ProjectPath = CreateObject("PMS.TxtEle")
ProjectPath.SetName("_ProjectPath")
Type Events
This type is a collection of EventObject's.
Option Description
Count Count is a field, where the number of the EventObject variables is stored. This field is read
only.
Item(Index) With this function the individual EventObject variables can be accessed. Every value is of
type EventObject . The access on one of the EventObject variables is made via the index
(example: Item (5)). The index must have any value between 0 and Count.
Type EventObject
This type contains the data of an event.
Option Description
AlarmText Is the text, which is displayed in the event window and recorded in the database for events.
This text can be also changed, if you have write access to the EventObject (in function
OnEventStateChanged).
Coming This variable contains the time in the UTC time format at that the event arose. This value can
be changed, if you have write access.
Going Time (UTC time format) the event disappeared. This value can be changed, if you have write
access
Acknowledged Acknowledgement time in the UTC time format.
Definition Is a variable of the type EventDefinition.
231
Manual AMS Asset Graphics 5.4
Type Definitions
This type is a collection of EventDefinition's.
Option Description
Count Count is a field, where the number of the EventDefinition variables is stored. This field is
read only.
Item(Index) With this function the individual EventDefintion variables can be accessed. Every value is of
type EventDefintion. The access on one of the EventDefintion variables is made via the
index (example: Item (5)). The index must have any value between 0 and Count.
DefID(ID) With this function, the individual EventDefinition variables can be accessed as well.
However, the access on one of the EventDefintion variables is made via the definition ID.
The definition ID must be valid, otherwise a zero will be returned.
Type EventDefinition
This type contains the definition data of an event.
Option Description
DefID Definition ID
ExtraTextNumber Additional text number
ElementName Name of the num-element
GroupName Name of the group
GroupNumber Number of the group
Picture Alarm picture to the event
Minimum Lower limit
Maximum Upper limit
BitNumber Bit number
Error codes
Code Description
-1 Eventjournal Runtime isn't initialized yet.
-2 Event journal is full.
-3 The definition ID couldn't be found.
-4 Event is still active.
-5 Event is still inactive.
-6 The parameter DateTime is invalid.
232
Events
PageControl
The product PageControl is an extension for the Eventjournal Runtime to alarm via SMS, E-Mail or voice.
Brief instruction
Install PageControl with the Setup program.
Copy the configuration file PageCtrl.cfg in the AMS Asset Graphics project directory. Otherwise
PageControl will work only in the demo mode. You find the file in the PageControl installation
directory, e.g. C:\Program files\informel\PageControl.
Open in the Project Manager the corresponding project and start PageControl (toolbar Add Ins).
Create at least one receiver (or group) in PageControl.
Now you can select for every alarm a receiver (single person or group) in the event definition
window, which shall be notified.
The Eventjournal Runtime automatically starts and stops PageControl, if at least one alarm receiver
is configured.
Runtime
Overview
The Eventjournal offers the user a user interface, which shows him the events , that appear during runtime.
By means of the Eventjournal, these events can be administrated, printed and acknowledged.
The events will be entered into the Event window in the order of their appearance.
The Eventjournal can include up to a maximum of 5000 events. When reaching 90% of this limit, a warning
will be given, at 100% a message displays that no more new events can be processed. Therefore you have
to take care, that events, which are not removed automatically from the list, will be acknowledged regularly.
On the user interface of the Eventjournal, there are four different possibilities for the different actions, to
achieve the same result. This redundancy results from the fact, that the commands are at disposal over
function keys, with menu commands, with the toolbars Alarm or Alarm buttons.
The Eventjournal can generate databases with historical alarms. This option can be enabled as option
Active in group History on the tab General.
Commands Eventjournal
The Eventjournal can be operated in different ways: with the menu Alarm, with shortcuts or with commands
in the toolbars Alarm and Alarm buttons.
Visualization (F2)
With this command, the visualization can be moved to the foreground.
233
Manual AMS Asset Graphics 5.4
Acknowledge (F8)
At this action, all highlighted events will be acknowledged. When no event is highlighted, the action
is obtained on the actually selected event. When the acknowledged events are not valid anymore,
they will be deleted from the Eventjournal.
Print (F9)
At this action, all highlighted events will be printed on the standard printer.
The following data will printed:
1 Coming time
2 Acknowledging ting
3 Going time
4 Alarm text
If no event is highlighted, actual printouts (defined by group definitions) will be terminated. With this,
a printout of the events, that have occurred up to this time, can be forced. At the appearance of a
new alarm of the group, the respective print job will be started anew.
Note In case, there are marked alarms, the actions Acknowledge and Print are related to the
highlighted alarms. With the help of marks it is possible, to deal with a big number of alarms
simultaneously.
Beep
When the option Beep is enabled you will hear a beep at every new event.
Tip Provided that you a sound card installed in your system, you can output a wave file in case that
an event has occurred. At coming events, the WAV-file will be processed, which is assigned to the
standard signal in the system control in menu Acoustical signals.
234
Events
Event window
In this window, the individual events are displayed. All events are displayed in one table or, filtered over five
different filters, displayed in five different tabs.
The table consists of at least one column with the line numbers and column Alarm text. Depending on,
which additional information are desired for the events, up to six further columns are shown.
Column Description
Alarm text This column shows the alarm texts of up to 5000 received events.
Came in In this column the time appears, when the alarm has come.
Went out In this column the time appears, when the alarm has gone.
Alarm group In this column the group of the alarm is shown.
Alarm picture In this column the name of the alarm picture is shown.
Acknowledged In this column the time appears, when the alarm was acknowledged.
Element In this column the name of the alarm element is shown, when an alarm element was
defined for this alarm.
The additional text-window can display, for a selected event, additional text.
(see tab Additional text).
Options
With this dialog, you can define, which additional columns shall be shown. The description of the columns
can be found in the event window.
The settings apply for the respectively active tab.
Filter
With this dialog it will be defined, which alarms shall be indicated in the current tab.
Filter condition is the association to a group. In the list field, those groups are highlighted, which alarms shall
be shown. If no name has be assigned for a group, instead of this, the group number will be shown in
square brackets. In addition, also the name for the tab can be entered. At this, variable texts (e.g. for
changing the language) can be used.
Qith the commands All marks Set/Delete all groups will be selected or de-selected simultaneously.
For tab All alarms in the event window, no filters can be selected.
All following operation actions, (print, acknowledge) are always obtained on the alarms, shown in the current
tab.
235
Manual AMS Asset Graphics 5.4
The Eventjournal generates databases with historical alarms, if the option Old mode is enabled. The
database will be generated in the MDB-format (MS Access). The database contains entries on coming,
going and acknowledging of an alarm.
For every day, a new database will be generated. The databases will be generated in a directory with name
EJ as subdirectory of the project directory. Furthermore, a directory will be generated automatically for every
year and every month. The file gets an EJ_ followed by the number of the current day as name and gets the
ending .MDB. Therefore, the following structure results for the file with the historical alarms from August 14,
2000 in the project directory:
Project directory\EJ2000\08\EJ_14.MDB.
236
Events
If an error occurs when writing an entry, this error can be evaluated by two system-elements:
_AlarmHistoryError and _AlarmHistoryErrorText (see: system-elements for the Eventjournal).
237
Manual AMS Asset Graphics 5.4
Viewer
Overview
The Eventjournal offers the user a user interface, which shows him the events that appear during runtime.
By means of the event viewer, these events can be administrated, output and acknowledged.
In the event view all active and not acknowledged events are shown. In this view the events can be
acknowledged. By using the profile properties, you can sort, filter, remove table columns and define the print
lay-out. These profiles can be stored under a name and simply selected directly over the toolbar.
If the status of an event changes the view is automatically updated.
In the historical view are shown all status changes with a time stamp, such as come, gone and
acknowledging all events. By using the profile properties, you can sort, filter, remove table columns and
define the print layout as well as the period. The historical view can show the events also in form of groups,
to represent number and total duration of the events. These grouped historical views are called statistics.
The Historical view can also display the data as statistic, classified by events or groups.
In the status bar, in the bottom right part, a green light symbol shows that the connection to the database
and to all sub-projects is ok. If this symbol is red, either the database connection is broken or all subprojects
are inactive. When the database connection is ok and only one subproject is broken, the light symbol will get
yellow.
With a left mouse click on the symbol, you can open a dialog with more details.
The Event Viewer can be moved to the foreground with element _SetTopEJViewer.
In the additional text -window, additional text will be shown for the selected event.
238
Events
Operation
Via the list in the toolbar to the left, several different profiles can be loaded. To the right of the list there are
two buttons to Edit and Save the current profile. If in the table, at least one event is marked, that is not yet
acknowledged, it can be acknowledged via button F8 or via the button with the green hooklet. A printout or
export of the table is possible via the printer button.
Views History
In this window three different views can be displayed. Which view is active, you can define Tab Table in the
profile properties.
Views 1: History
Here are shown all status changes with a time stamp, such as come, gone and acknowledging all events.
239
Manual AMS Asset Graphics 5.4
All entries of the historical data are summarized here (grouped). For every alarm group, the number is
counted and the total duration of the events of the group summed-up.
Operation
Via the list in the toolbar to the left, several different profiles can be loaded. To the right of the list there are
two buttons to Edit and Save the current profile. A printout or export of the table is possible via the printer
button.
Tab General
On this tab you make general settings for the profile as well as setting of parameters for printing. The
printout is configured with the AMS Asset Graphics Report Designer. In the designer the columns of the
table are at disposal as field-variables.
Option Description
Title Enter here a name for the current profile. This name will be shown in the title of the views.
Operating management
Password Enter the access right, or click with the right mouse button to open dialog Select access right
protection and to select a user right. By means of the selected access right, opening of the profile
properties is protected.
Log level Enter here a Log level for storing the profile file.
Option Description
Relative Activate this control field, if the period shall be shown as relative period.
Period Here you define, how many days shall be displayed.
End of period Here you determine the end of the displayed period. For example, if you leave the default
before setting Before 0 days, the data will always be displayed including the actual day.
Absolute Set this option, if the period shall be shown as absolute period.
From Defines the first day to be displayed. Press the arrow to the right of the date, to open a
calendar and to select the desired date.
To Defines the last day to be displayed. Press the arrow to the right of the date, to open a
calendar and to select the desired date.
240
Events
Tab Table
In selection box Type you can select one of the following views:
Type Description
History Here are shown all status changes with a time stamp, such as come, gone and
acknowledging all events.
Statistics All entries of the historical data are summarized here (grouped). For every event definition,
(event) the number is counted and the total duration accumulate.
Statistics All entries of the historical data are summarized here (grouped). For every alarm group, the
(group) number is counted and the total duration of the events of the group accumulate.
If you want to display a further column, mark the desired column at the available columns. Press the
button with the arrow (->), to pass on this column to the selected columns.
If a selected column shall not be displayed anymore, you have to proceed the other way round.
Tab Sort
On this tab you define, whether and how entries shall be sorted. Three criterion can be selected for the
sorting. If the first criterion does not show a difference at several entries, the second criterion will be used,
then the third. For every criterion, you can select one of the table columns.
Tab Filter
In this tab you can set filter options, this means, only those entries will be shown, which agree to the filter
option. For every table column, one filter can be entered. You may also use the keywords or and and.
Example: 1or 2
The maximum number of events, that shall be indicated, will be set in the entry field to the top right of the
dialog.
Having entered the data of a filter, in the dialog below SQL WHERE will be shown. This can also be edited
freely, when you activate marking field Edit SQL-WHERE string. With this, also complex filters are possible.
241
Manual AMS Asset Graphics 5.4
At a time filter it has to be taken into account, that the data are already filtered due to the settings on tab
Period.
Example for a free SQL-Where string (show all events between 15:11 and 15:18):
WHERE DATEPART(hour, EventTime) = 15 AND DATEPART(minute, EventTime) BETWEEN
11 AND 18
Tab Print
242
Events
As database, the local SQL server instance of AMS Asset Graphics will be used as a standard. Here, the
data are stored into the database Events.
However, it can also be used another SQL server. For this purpose the section EventDatabase has to be
entered in the Project.ini.
[EventDatabase]
Server=.\inVISU_PMS
Catalog=Events
User=InvisuSystem
;Password=
AcknowledgeStationNumber=40
The entries Server, Catalog, User and Password are for the database connection. With the
AcknowledgeStationNumber you define the station number, which is to use for the acknowledgement of
events.
Example:
TEJ_Viewer32.exe DB2
TEJ_Viewer32.exe DB3
[DB2]
Server=172.16.31.22\inVISU_PMS
...
[DB3]
Server=172.16.31.33\inVISU_PMS
...
243
Manual AMS Asset Graphics 5.4
Using
Define an event
If you have not yet defined alarm groups, you can do that now. Press button Group properties in
the toolbar with alarm-specific functions. Select a group in dialog Group selection and press Edit to
open dialog Properties group.
Select tab General.
Enter a name for the group, e.g. Alarms. Decide, whether an acknowledge is required and
whether an automatic change of the pictures shall take place and set the corresponding options.
244
Events
Select tab Color settings and configure the different colors for the alarm group.
When the events of this group shall be printed automatically, select tab Printer settings.
Define, whether the coming, going or acknowledged alarms are to be printed and set the
corresponding checkboxes.
Alarms can be printed on several printers and simultaneously into a file. Activate the
corresponding checkboxes.
Note The assignment of the physical printer devices to the logical printer Printer 1, Printer 2 and
Printer 3 can be defined with the menu command Edit | Printer assignment.
Close the group window with OK. Go on editing other groups or close dialog Group selection.
Now enter the desired alarm text. For this select tab Alarm text.
Enter the desired alarm text into column English. This text may have a length of up
to 100 characters. If you dispose of a license for the option Language selection, you can enter
the alarm text in other languages as well. According to the settings in the Language Editor you can
enter the required languages beside column English in further columns.
Save your settings (command Save in the toolbar) and close the Eventjournal Editor.
Notes
Remember to enter the Eventjournal into the program list of the runtime tasks in the Project Manager (see
Add Programs).
Pop up the Eventjournal Runtime via a button (see Calling the Eventjournal).
Printing an event
Bring the Eventjournal Runtime in the foreground.
Mark the event that you want to print. Print several events at the same time by selecting the
corresponding lines in the numbering column.
Then press the function key F9 or button Print in the toolbar Alarm buttons or button Print
alarms in the toolbar Alarm.
Acknowledging an event
There are several ways to acknowledge an event:
In the Eventjournal Runtime
In the Event Viewer.
With an acknowledgment element (e.g. controlled from the visualization or a PLC)
245
Manual AMS Asset Graphics 5.4
Enter a num-element into column Ackn. element, whose change in value will acknowledge the
event. The change can be triggered by a partner device or from the visualization from an
operator (e.g. by means of a button or a function key).
The language can be switched with the of changes of system-element _Language. This can e.g. be realized
with a button.
246
Events
Note If you intend to display the alarm line in every picture, it is advisable to make at the beginning a picture
of your work with a standard layout which you can use as a basis for every further picture. This standard
layout then can contain the alarm line and other standard elements which shall be displayed in every picture.
At first draw a picture in the Graphic Editor which shall be displayed in the alarm situation.
Start the Eventjournal Editor and define an event.
Before you close the editor open tab Extras.
In column Element you can find the num-elements which are monitored. Enter the name of the
picture into column Alarm picture which shall be displayed in the alarm situation.
Save your changes.
247
Manual AMS Asset Graphics 5.4
248
Events
Tip If you have a sound card in your system, you can play a WAV file at incoming events. The system plays
the WAV file, which is assigned to the Standard signal in the Windows System control under Acoustic
signals.
249
Data Storage
Editor
Introduction
AMS Asset Graphics does not only give you information about the current state of a plant, it can also store
process values and can access on the stored data. This functionality is called Data Storage.
With the Data storage, every num- and text-element can be stored to configurable times (e.g. every 2
minutes) or depending on events (e.g. when an error or an value change occurs). These stored data can be
accessed with the trend charts. So the user can watch the status of his plant as temporal trend and to
archive the data for later evaluation.
In addition, the stored data can be exported in CSV-files (Comma Separated Values files) or in MDB-files
(MS Access format) to permit viewing and further processing with external programs.
Data with a time stamp can be imported in form of CSV-files. With that, the user can also view historical data
of remote stations with his visualization system and archive or export these data.
Moreover, the data storage file can be stored redundantly at two independent places, also in the network.
This is to prevent a data loss due to hardware defects.
Several data-elements are summarized in datasets and stored at the same time. The datasets are stored in
data storage files in form of ring buffers. Every data storage file can contain up to 100.000 datasets. This
means, if a dataset of a data storage table consists of 5 elements, the values of all 5 elements including the
time stamp will be written 100.000 times, before the first dataset is overwritten.
The Data Storage Editor offers the user a user interface, to define data storage tables. Thereby, several
data storage tables of several projects can be opened at the same time. An exchange of definitions can be
made with the clipboard and drag & drop. The most important properties of a data storage table are the
definitions on the size of the ring buffer and which data-elements shall be stored at what time.
Runtime function
During runtime certain data are stored, when the defined trigger event occurs. The trigger may be initiated
on events (e.g. function key) or on the time (e.g. system-element _Sec01, every second).
See also
Creating a data storage (Step-by-step instructions)
251
Manual AMS Asset Graphics 5.4
Dialog Properties
Dialog Properties
On tab General you define the general settings for a data storage file.
On tab Archive you define files and conditions for archives.
On tab Export you can determine, when and on which conditions the data shall be exported to which
location,
on tab Import you make the corresponding specifications to import a file.
On tab VBScript you can define a num-element for an external timestamp.
See also
Creating a data storage (Step-by-step instructions)
Tab General
On this tab you make general settings for a data storage table. You determine, when data shall be stored,
whether the storage of data shall be stopped, e.g. in case of special situations. You can enter trigger to
delete all datasets in the data storage file. You can also activate the use of a second data storage file at any
location in the network.
Here you define the size of the data storage file. Data storage is internally organized via a ring buffer. When
the ring buffer is filled with data, the oldest data will be overwritten, i.e. for processing there are always the
most current data available.
Via the options Elements per dataset, Max. nr of datasets and the Type you define the size of the ring
buffer (max. size approx. 50 MB, assuming type NUM).
The behavior after changing the definition is as follows:
An existing data storage file will be renamed and gets in the file name the extension
_YYMMDD_hhmmss.
Sample: Test.iDSF ir renamed to Test_061208_080912.iDSF.
A new data storage file will be created and useful data will be read from the old data storage file.
Option Description
Active at
Element Enter here the name of a data-element,if you want to control dynamically whether
the data storage is active or not. If the value of the data-element is 0, the data
storage table is inactive, otherwise data can be stored.
Note If no element name is entered here, data can always be stored.
Station With this field you define, on which network station the data storage table shall be
processed (0 for the master, 1 – 31 for a station).
This field is only accessible at a network project. For this, you must have activated
the option Network project in dialog Runtime configuration.
Definition
Elements per dataset Define here how many elements shall be stored at the same time (max. 128).
Max. nr of datasets Define here, how many datasets shall be stored in the ring buffer until the first
stored dataset will be overwritten (max. 100.000).
File size With the definitions Element per dataset, Max. nr of datasets and Type, the size
of the ring buffer will be calculated and displayed here.
252
Data Storage
Option Description
Trigger
Save on change If this option is set, a new dataset of the table will be stored, when the value of one
element has changed.
Start saving Enter here the name of a num-element, which triggers the storage of data as soon
as its value changes (control-trigger). The amount of the change is not important.
You can use a num-element, which changes continuously (e.g. system-element
_Sec01, which changes its value every second). However you can use also num-
elements, that changes discontinuously.
Saving complete Define here the name of a num-element, which has to change its value, when a
dataset was successfully stored (notification-trigger). The element will be increased
by 1 and reset on 0 when reaching 255.
Start deletion Enter here the name of a num-element, which triggers the deletion of data, as soon
as its value changes (control trigger).
You can use a num-element which changes continuously (e.g. system-element
_Day); however, you can use a num-element, that changes discontinuously (e.g. a
function key).
After deletion, the current data storage file does not contain any dataset. You can
use this function to delete all entries at the end of a time period. With that, the file
does only contain data of a selected time period (e.g. a day, a shift etc).
Deletion complete Define here the name of a num-element, which change its value, when the data in
the table are deleted (notification trigger).
Redundancy
Active Set this the option, if you want to save a redundant data storage file at a second
location. This is useful, when the stored data has to remain available even in case
of a destroyed data storage file (possibly at a defect of the hard disk).
Destination folder Define the directory, where the redundant data storage file shall be stored. Use the
browse-button to select an existing directory.
Note Pay attention, that the destination directory is located on another hardware
(fixed disk or computer) as the original data storage file.
Tab Archive
The data storage offers the possibility of creating archives of data storage files. You can create two archive
files. With that, redundancy is even possible at archives. If an archive of the runtime file is created, the data
storage file will keep all entries. With that, the current data will be at disposal and can be displayed in a trend
chart.
If an error occurs upon the creation of an archive, it will be reported with a special error element. Archives
can be created automatically when the ring buffer is full or with of a trigger.
While creating an archive the data storage will save furthermore data in an internal buffer. The buffered
writing procedure avoids loss of data when creating new archives. However, since also this buffer has a
limited size, loss of recording data could occur, when the archive is stored on a slow device (e.g. floppy
disks, CDRW, slow network).
Option Description
Trigger
Buffer full If this option is activated, the data storage file will be archived exactly at that moment,
when the ring buffer is full, i.e. when the last (physical) dataset of the data storage file
was written with values.
Start archiving Enter here the name of a num-element to start the archiving (control-trigger). The
archiving will be started, as soon as the num-element changes. Beside this you can
also archive discontinuously (for example via of a function key) or depending on a
specific process variable.
If no controlled archiving is desired, the field remains empty.
253
Manual AMS Asset Graphics 5.4
Option Description
Archiving complete Define here the name of a num-element, which has change its value when archiving
was completed successfully (notification- trigger). The element will be increased by 1
and reset on 0 when reaching 255.
Error
Number This num-element contains the number of the last error that has occurred during
archiving.
If the error has occurred at File 1, the fraction part is a 1; if the error has occurred at
File 2, the fraction part is a 2. If both files have produced an error, error code refers to
File 2. The integer part of the value corresponds to the error number (see error
codes).
Number
Max. This option defines how many archives are generated for a data storage table.
Possible values are 1 to 1000.
Example:
If 7 was entered as maximum number of copies, the program will create
archives with the extension numbers 000 to 006.
Destination
File 1 Enter here directory and file name for the archives. Use the browse-button to select
an existing directory or an existing file.
For the input you also can use variables e.g.
@_DataStoringPath\Basin
The file name is defined without extension, because the file extension will be
generated as continuous number at every copy action, beginning with 000.
If an error occurs during archiving, it will be reported via the error element (or entered
into the activity log).
If no archiving is wanted, the field remains empty.
Attention Not all special characters can used for a file name.
File 2 Here you can enter a second destination. The functionality is identical to that of File
1.
See also
Archiving data (step-by-step instructions)
Tab Export
The data storage offers the possibility, of exporting data of the data storage file. For this, there are two
different formats at disposal. These data can be exported as MDB-files (MS Access Format) or as CSV-files
(Comma Separated Values files), to be read e.g. with MS Excel).
254
Data Storage
The second line contains the element names. For the type DATE, the name Date is used, for type TIME the
name Time. The names of the other elements will be written in the order they are defined in the Data
Storage Editor. Every entry will be separated from the next one with a separator char.
While exporting the data storage will save furthermore data in an internal buffer. The buffered writing
procedure avoids loss of data. However, since also this buffer has a limited size, loss of recording data could
occur, when the export is made on a slow device (e.g. floppy disks, CDRW, slow network).
Option Description
Trigger
Buffer full If this option is activated, the data storage file will be exported into the target file
exactly at that moment, when the ring buffer is full, i.e. when the last (physical)
dataset of the data storage file was filled with values.
When archiving If this option is activated the data storage file will be exported into the target file
exactly at that moment, when the data storage file was archived as well. This means
you can also create an export file together with the Archive function.
Start exporting Enter here the name of a num-element, by means of which the export shall be
started (control-trigger). The export will be started, as soon as the num-element
changes. Beside this you can also export discontinuously (for example via a function
key) or depending on a specific process variable.
If no export is desired, the field remains empty.
Exporting complete Define here the name of a num-element, which change its value, when exporting of
the table was completed successfully (notification-trigger).
255
Manual AMS Asset Graphics 5.4
Option Description
Destination file Define here the name of a destination file to export the data. Use browse-button to
select an existing directory or an existing file.
In the text you also can use variables, e.g.
@_DataStoringPath\$_Year\$_Month\Data$_Day.csv
Thus you have a possibility for a structured storing of export files. If an error occurs
during export, it will be reported via the error element.
Attention If there are already exported files with the same name in the target
directory, they will be overwritten.
Format
MDB If you have activated this option, the data storage file will be exported as MDB-file.
This file can then be edited with MS Access or other database programs, which
support this format, to evaluate the data according to your requests.
CSV If you have activated this option, the data storage file will be exported as CSV-file.
This file can then be edited with MS Excel or other programs, which support this
format, to evaluate the data according to your requests.
CSV Separator This option defines the separator used for the export into a CSV-file.
Decimal marker This option defines the decimal point used for the export.
Format date Enter formatting codes to specify the date values (Default: %Y-%m-%d).
Format time Enter formatting codes to specify the time values (Default: %H:%M:%S:).
Append Check this option to append milliseconds to the time stamp.
milliseconds
Error
Number This num-element contains the number of the last error that has occurred during
export (see error codes).
Tab Import
The data storage offers the possibility of importing datasets into a data storage file. The datasets to be
imported must be contained in a CSV-file.
Format of a CSV-file
see tab Export
Example of a CSV-file ( separator , )
DATE,TIME,TXT,NUM
Date,Time,TextEle,NumEle
2006-01-01,00:00:00:000,"END",50012
2005-12-31,23:59:59:999,"contain a separator char",1.2345
2005-11-26,14:05:37:281,"entry, which can also",258.123e-028
2005-11-26,14:05:36:279,"Hello this is a text",1.2e+039
The time may be defined with resolutions up to nanoseconds. Very fast events can be captured with a
special hardware and the data stored in a CSV-file. In the following the CSV-file will be imported in a data
storage file to be viewed in the visualization system.
The separator char for importing can be selected freely. The individual entries must correspond exactly to
the syntax. Element names and types must agree with the defined data storage table. With that it can be
guaranteed, that the imported data are compatible to the definition table.
As decimal marker the point will always be used.
Before importing a CSV-file its syntax is checked. If an error occurs during import, it will be reported via the
error element.
256
Data Storage
Even if an import is defined, it is furthermore possible to save datasets. If saving of data was started during
an active import, the dataset will temporarily be written into an internal buffer. After the import is completed,
the datasets will be written from the buffer into the data storage file. The buffered datasets are appended to
the file (not sorted by the time stamps).
If an Export or Archive of data is activated while the Buffer full, this will also be processed during the data
import (in case, the buffer has got full during import). For this, the import procedure will be interrupted.
Exporting or archiving of data activated by a start trigger will not interrupt an active import..
Option Description
Trigger
Start importing Enter here the name of a num-element, by means of which the import shall be
started (control-trigger). The import will be started, as soon as the num-element
changes. Beside this you can also import discontinuously (for example by means of
a function key) or depending on a specific process variable.
If no import is desired, the field remains empty.
Importing complete Define here the name of a num-element, which change its value, when the import
is successfully completed (notification-trigger).
Source file Enter here directory and file name, to read the data to be imported. Use the
browse-button to select an existing directory or an existing file.
For the input you also can use variables e.g.
@_DataStoringPath\ImportFile.csv
The file name may be entered with or without file extension.
Delete after import If this option is set, the CSV-file will be deleted after a successful import.
Format
CSV separator This option defines the separator used for the export into a CSV-file.
Decimal marker This option defines the decimal point used for the export.
Error
Number This num-element contains the number of the last error that has occurred during
import (see error codes).
Tab VBScript
In this VBScript window you can implement different functions such as OnStart (initialization), OnRun
(cyclic) and OnEnd (end of Data Storage Runtime). A detailed description of these three functions is given
in the section VBScript.
257
Manual AMS Asset Graphics 5.4
sub OnRun
MyDate = "14.7.2009 11:58:10"
DsTimestamp.Value = CDate(MyDate) + _
300 / 24 / 3600 / 1000 ' 300 milliseconds
end sub
The conditions for the storage of data are defined in the dialog Properties.
Column Description
Element Enter here the names of the elements to be stored.
Description For the use of the data for the trend chart every element will be assigned a description.
Type Into column Element you can enter num- or text-elements. Click the right mouse button over
a cell and select from the dialog NUM (for num-elements) or TXT (for text-elements).
Note You can also mark and change several cells at the same time.
Error codes
At the processing of data storages the following errors can occur:
258
Data Storage
File operations
Error code Description
104 An unspecified error occurred.
105 The file could not be located.
106 All or part of the path is invalid.
107 The permitted number of open files was exceeded.
108 The file could not be accessed.
109 There was an attempt to use an invalid file.
110 The current working directory cannot be removed.
111 There are no more directory entries.
112 There was an error when trying to set the file pointer.
113 There was a hardware error.
114 SHARE.EXE was not loaded, or a shared region was locked.
115 There was an attempt to lock a region that has already been locked.
116 The disk is full.
117 The end of file was reached.
118 Unknown file version or file is not a data storage file.
119 File could not be deleted.
120 The set to be read is not contained in the file.
121 ASCII / UNICODE-Error (File was created with the other version).
General errors
Error code Description
155 The passed element type was different to the type of the data storage file.
157 The file name has a wrong extension.
Import errors
Error code Description
160 Requested memory could not be defined.
161 Separator could not be found.
162 Date entry has invalid syntax or is not at first position.
163 Time-entry has invalid syntax or is not at second position.
164 Data type does not correspond to the definition file.
165 Element name does not correspond to the definition file.
166 Number of elements different from definition file.
167 Invalid date format.
168 Invalid time format.
169 Invalid NUM format.
170 Invalid TXT format.
259
Manual AMS Asset Graphics 5.4
Export errors
Error code Description
230 DAO error occurred during export of data.
The data storage files will be started in alphabetic order. The regular processing of the tables is also done in
an alphabetical order.
The data files will be created in a separate directory with name DS under the project directory. The name of
a runtime file results from the name of the data storage table, it will be given the extension iDSF.
If the runtime is started another time, Data Storage Runtime will open the already existing data storage file
(Message: connect file: Filename).
If the runtime is started another time after an element name was changed in the definition of a data storage,
the data storage file will be adapted. The changed elements will be set on 0 or "empty string" in the
complete ring buffer. The information, previously stored at these locations will be lost (message: File:
Filename adjusted.
At network projects you define for every data storage definition the station number, where the data storage
shall be processed. If the Data Storage Runtime is started on an other station the file is not processed at this
station (message: SKIP file: Filename on this station).
Using
260
Data Storage
In order to activate the data storage during runtime, the Data Storage Runtime must be entered into the
program list of the Project Manager (see Add programs).
261
Manual AMS Asset Graphics 5.4
Saving data
With this function, arbitrary num- and text-elements are saved in predefined time periods (e.g. every 2
minutes) or depending on events (e.g. when a failure occurs). These data may be visualized with trend
charts or external programs for presentation or further processing.
Several data-elements, which shall to be saved at the same moments, are combined integrated in datasets.
Archiving data
Since the data are stored in ring buffers, the oldest values will be overwritten as soon as the buffer is full. To
avoid loss of data, the program offers the option to archive them.
Start the Data Storage Editor (command Data storage in the Project Manager).
Press button Open in the toolbar of the Data Storage Editor to open that data storage
table, which data you want to archive.
Press button Edit properties in the table specific toolbar (see Start archiving data) to open dialog
Properties.
Select tab Archive.
262
Data Storage
In group Trigger you define the conditions for copying the ring buffer data into archive files. In the
example above the buffer will always be copied when it is full. The program makes up to seven
copies (Number). Then, the oldest copy will be overwritten. So the archive always contains the
data of one week.
In group Destination files you have to enter in File 1 the name of the archive file. Enter the
name without extension, because during copying the file extension will be generated
automatically with a continuous number sequence.
Attention Make sure that the defined disk drive has enough free space during runtime.
Confirm the dialog with OK and save the changes.
Start the Data Storage Editor (button Data storage in the Project Manager).
Select button Open in the toolbar of the Data Storage Editor to open an existing data storage
table.
If you activate the data storage with other conditions or if you want to change the definition of the
ring buffer, select button Edit Properties of the table specific toolbar (see Create a data storage).
Save your changes (button Save in the toolbar of the Data Storage Editor).
Attention If you want to modify the number of data-elements or datasets in the ring buffer or if text-elements
have to be exchanged with num-elements or vice versa, the ring buffer must be recreated.!
This is done automatically when the Data Storage Runtime starts:
An existing data storage file will be renamed and gets in the file name the extension
_YYMMDD_hhmmss.
Sample: Test.iDSF ir renamed to Test_061208_080912.iDSF.
A new data storage file will be created and useful data will be read from the old data storage file.
Note If you already know, when programming the data storage table, that later on you want to save further
elements which names are not yet defined, first create lines without element names for the later use.
However, you must already define the type of future elements.
Note In case you change belatedly the name of an element, the data of the previous element in the .iDSF
file will get lost, since the new element is now saved at that location and the data will therefore be initialized
in all datasets.
263
Recipes
Editor
Introduction
Often the same data have to be transmitted to the partner device, e.g. during running-in of complex plants
or at the definition of mixture ratios. Especially, when big amounts of data have to be handled, the Recipe
Runtime of AMS Asset Graphics is a helpful tool. It permits the user to load and save groups of data as
recipes.
The Recipe Editor is designed as MDI-application, this means, several documents (recipe tables) can be
edited at the same time.
In the Recipe Editor you define recipe groups, which are used as templates to load and save recipes.
During runtime an unlimited number of recipes may be saved for every recipe group.
For every recipe group a special recipe can be defined, which is loaded or saved automatically by the
Recipe Runtime.
See also
General operation
Define a recipe group (step-by-step instructions)
Column Description
Element Enter here the names of the elements which shall be part of the Recipe.
Type You can enter num- or text-elements into column Element. Click the right mouse button on
this field and select from dialog Select type.
Description For a more detailed explanation, every element can have a description.
The conditions, on which the recipes shall be loaded and stored, are defined in dialog Properties RECIPE
GROUP.
See also
Define a recipe group (step-by-step instructions)
265
Manual AMS Asset Graphics 5.4
Dialog Properties RECIPE GROUP has 5 tabs, to define the properties of a recipe group.
Tab Trigger
The loading and saving of data in recipes can be controlled by triggers. The trigger are used, if recipes shall
not only be loaded or saved via operator actions in the Recipe Runtime.
Option Description
Recipe name Enter here a text-element, to determine the recipe, on which one or more of the
following trigger actions shall be related.
If you leave this field empty, the system-element _RecipeName will be used. This
element will only be used, if recipes shall be loaded or saved automatically during
runtime (i.e. not with the menu-driven Recipe Runtime).
Start loading Enter here a num-element to start the loading/saving of a recipe (control-trigger).The
Start saving recipe name is specified by the content of the text-element, entered in option Recipe
name.
Loading complete Enter here a num-element, which changes its value, if a recipe was loaded or saved
Saving complete successfully.
See also
Save a recipe directly with a function key
Tab Automatic
On this tab you determine a dedicated recipe for this recipe group, which shall be loaded automatically at
the start of Recipe Runtime or saved automatically when the program ends.
This functionality can be used e.g. to go on operating with the data of the last runtime session in case of a
restart of the visualization.
Option Description
Autoload Enter here the name of a recipe of the recipe group, which shall be loaded automatically when
starting the Recipe Runtime.
Autosave Enter here the name of a recipe, which is saved automatically when the Recipe Runtime ends.
See also
Save a recipe automatically at program end
266
Recipes
Tab Diagnosis
On this tab you can define notification-elements, which contain information about the recipe processing.
Option Description
Recipe loaded Enter here a text-element, which is set with the name of the last loaded recipe.
Recipe saved Enter here a text-element, which is set with the name of the last saved recipe.
Error text- Enter a text-element to get the error text, when an error has occurred during loading or
element saving a recipe. The contents of the text element will not cleared, if an action for a
recipe was executed successfully.
The description of the possible error numbers and texts you can find in table Error
list Recipe Runtime.
Error num- Enter here a num-element here to get the error number, when an error has occurred
element during loading or saving a recipe. The contents of the num-element will not be set to 0,
if an action for a recipe was executed successfully.
If no error has occurred, the element has the value 0, in case of an error, the value will
be > 0.
See also
Detecting errors when loading or saving recipes
Tab Operation
On this tab you define whether recipes shall be indicated and operated during runtime, which access
authorization shall be required for this and whether these actions shall be entered into the activity log.
Option Description
Operation Here you define, which action with which authorization (P-level) may be performed and
management whether these actions have to be recorded in the activity log (Log).
New Define here password and log level for creating a new recipe.
Load With this line you define password and log level for loading an existing recipe.
Note For loading a recipe there are three variants: automatically, trigger-controlled
and user-controlled. According to this, a corresponding remark 'Trigger' or 'User' will
be written into the activity log at the actions 'Autoload' and 'Autosave'.
Save Define here password and log level for saving a recipe.
Functionality see description for Load.
Delete Define here password and log level for deleting a recipe.
Edit Define here password and log level for editing recipe data in the recipe table.
View options
Recipe group Set this option, when the recipe group shall not be displayed in the Recipe Runtime. In
invisible this case there is no possibility, in the Recipe Runtime to change a recipe in any form.
Tab VBScript
On this tab you can define VBScript functions for a recipe group.
Function Description
OnStart This function will be called once, when the table is generated.
OnRun This function will be called cyclically.
OnEnd This function will be called, when the table is terminated.
267
Manual AMS Asset Graphics 5.4
Example
Cannot save: recipe is read only: [exhibition configuration] 24.05.06
13:53:03
268
Recipes
Runtime
Command Description
Visualization When you press this button, the Recipe Runtime window will be moved to the background
and the visualization window to the foreground.
New Having pressed this button dialog New recipe appears.
The values of the selected recipe group will be stored automatically with the name of the
new recipe.
You can also define the name of an existing recipe. After a safety request, it will be
overwritten.
Load Press the button, to load the selected recipe.
The corresponding values are read from the recipe database and copied into the data-
elements of the selected recipe group.
Data-elements, which are not part of the recipe (this is e.g. possible, when the recipe
definition was extended, after the recipe was already stored), will be not changed.
Save Click the button, to save a recipe.
The current values of the data-elements of the selected recipe group are stored under the
selected recipe name in the recipe database.
Delete Click this button, to delete the selected recipe.
After a safety request, the selected recipe will be deleted.
Edit In addition to the input of recipe values in the visualization, you can edit the values in a
table.
This command opens the dialog Recipe.
You can see the data- elements of the recipe and their contents, which can also be
changed.
For the operation you can also use function keys instead of buttons. The abbreviation of the accompanying
button is part of the documentation.
Notes
Prerequisite for the functionality of the recipe runtime is a correct DAO installation!
269
Manual AMS Asset Graphics 5.4
The database -access on recipe files is done non-exclusively by the recipe runtime.
See also
Create a new recipe
Save a recipe
Load a recipe
Column Description
Element This column contains the elements, which are part of the recipe. You cannot make any
change.
Type Here you see the type of the data-element (num- or text-element). You cannot make any
change.
Contents The contents of the data-element is shown here. You may change it and take it over into the
recipe with button Save. When you click on button Cancel, the old contents of the element
will be restored.
Description Here you see the description defined in the Recipe Editor for this element. You cannot make
any change.
270
Recipes
Using
Using recipes
Recipes are groups of values of data-elements (e.g. setpoints for a machine control device or mixing ratios
in the building or construction trade and the chemical industry) which are loaded and saved as group.
Recipe groups are defined in the Recipe Editor as empty templates for recipes. During runtime, several
recipes with specific values can be used for a recipe group.
271
Manual AMS Asset Graphics 5.4
Return to the visualization (button Visualization), when the data-elements are edited in the
visualization.
If the components of the recipe are not yet assigned to values or if you want to modify them, select
button Edit to edit the recipe. Dialog Edit will be shown.
Enter the values of the new recipe into column Contents.
Save your changes (button Save). The dialog will be closed now.
Go on creating further recipes or return to the visualization (button Visualization).
Note Do not forget to enter the program Recipe Runtime into the program list (see Add Programs).
Load a recipe
You have several options of loading recipes during runtime.
Note Don't forget to enter the program Recipe Runtime into the program list in the Project Manager (see
Add programs).
Activate Recipe Runtime e.g. via a button (see calling the Recipe Runtime).
Select the group from the list of the available recipe groups from which you want to load a recipe.
The existing recipes are shown in the list of recipes.
Select the recipe you want to load from the list of recipes.
Click button Load.
Return to the visualization (button Visualization).
272
Recipes
Enter a text-element into field Recipe name. This text-element can be changed with a text input
field in the visualization.
See also Define setpoints.
Define the num-element in field Start load, which starts the loading of the recipe, in this example
_F4.
Confirm the dialog with OK and save your changes in the Recipe Editor.
Save a recipe
During runtime you can assign other values to the individual variables of an existing recipe. How to create a
new recipe can be found under (Create a new recipe).
273
Manual AMS Asset Graphics 5.4
Another possibility consists in assigning the values to the existing recipe via a table, which is
called up from the Recipe Runtime.
Activate Recipe Runtime e.g. via a button (see calling the Recipe Runtime).
Select the group in which you want to save a recipe from the list of the existing recipe groups.
The available recipes are shown in the list of recipes.
Select the recipe, you want to save, from the list of recipes.
If you have already entered the values of the data items in the visualization, which are part of the
recipe, press Save. After that, you can return to the visualization (button Visualization). If you still
want to change the components of the recipe, select button Table to edit the recipe. Dialog
Recipe group: recipe name will be displayed.
Enter the new values of the recipe into column Contents.
Save your changes (button Save). The dialog will be closed.
Change additional recipes or return to the visualization (button Visualization).
Enter a variable text-element into edit field Recipe name. This text-element can be opened as
edit field in the Graphic Editor, to enter the name of the recipe, that shall be saved with the
function key, during run time.
See also Define setpoints
Define the num-element in field Start save, which starts the saving of the recipe, in this example
_F5.
Confirm the dialog with OK and save your changes in the Recipe Editor.
274
Recipes
Define a recipe group in the Recipe Editor (see define a recipe group).
Select button Properties in the table specific toolbar.
Select tab Automatic in dialog Properties recipe group.
Enter the name of the recipe, to be saved at program (with the current values) into edit field
Autosave.
Confirm the dialog with OK and save your changes in the Recipe Editor.
Enter a text-element into edit field Recipe loaded, which contains the name of the last loaded
recipe. adopts the name of the recipe of this recipe group that was loaded last.
Enter a text-element into edit field Saved recipe which contains the name of the last saved
recipe.
In option Error text-element you have to enter a text-element which includes an error message
when an error has occurred during loading or saving of a recipe.
In option Error num-element you can enter a num-element which indicates, when an error has
occurred during loading or saving of a recipe. If no error has occurred, the element has the value
0, in case of an error the value is > 0.
The description of the possible error numbers and texts you can find in table Error list Recipe
Runtime.
Confirm the dialog with OK and save your changes in the Recipe Editor.
275
DDE
Editor
Introduction
The abbreviation DDE stands for the expression Dynamic Data Exchange. DDE is a mechanism of
Windows, which permits the data exchange between different applications.
With the AMS Asset Graphics DDE task, arbitrary data-elements are transmitted to other DDE-capable
Windows applications (e.g. Excel or Word) at defined times (e.g. every 2 minutes) or depending on events
(e.g. when an error occurs). The data exchange may take place in both directions, this means, data-
elements are transmitted to other applications as well as data are received from other applications.
In addition, there is the possibility, to send commands to other applications to trigger certain actions (e.g.
loading a file).
Several data-elements, that has to be transmitted at the same time, are organized in tables. AMS Asset
Graphics distinguishes between two table types, the tables for the data exchange and that for the command
transfer. In a data exchange table, up to 1000 num- and text-elements will be stored. A command table may
contain up to 1000 command lines.
The most important properties at the specification of the dynamic data exchange are the definitions, which
data-element shall be transferred to which location and at what time.
Runtime function
During runtime certain data or commands are sent or received if the defined condition (Trigger) raises. The
trigger may be activated depending on events (e.g. function key) or depending on the time (by a system-
element like _Sec01).
Which data are sent and received, or which commands shall be sent, is defined in the DDE Editor.
When starting the runtime program, all DDE-tables belonging to the current project will be loaded. After
loading the tables, the DDE Runtime tries to start the applications, which are entered as Application name
on tab DDE connection.
See also
Exchange data via DDE (Step-by-step instructions)
277
Manual AMS Asset Graphics 5.4
Tab Connection
On this tab you make basic settings for a DDE connection.
Option Description
Application
Name Enter here the name of a Windows application, with which you want to exchange data. The
application with which you want to exchange data must be capable for DDE.
In addition, the program should be stored in the search path, that it can be started
automatically from the DDE Runtime. If it was not entered in the search path, it must have
been started before arrival of the connecting trigger (see also tab Trigger (data exchange)),
started manually or entered into the program list of the Project Manager (see also Runtime
configuration).
Note The DDE-expression for the application topic is Server.
Topic To established a DDE connection, you need the name of the application as well as a topic
supported by this application. For example, if you would like to exchange data with an MS
Excel table, the table name corresponds to the topic of the DDE connection.
At command tables, this field may remain clear. It should remain clear, if you want to
address several topics with the same command table.
At a data exchange table a DDE-connection can only be established, if a valid topic is
configured. For MS-Excel this means, that the corresponding table must have been loaded.
This can for example be realized by creating a command table before.
Example
If you define a DDE connection with MS Excel and if you have entered a table name as topic, the DDE
connection will refer only on this table. However, if you leave this field clear, a DDE connection will be
established with all possible topics of MS Excel. This option is useful when you want to send commands to
several topics of an application, e.g. to load different tables in Excel.
See also
Data exchange via DDE (Step-by-step instructions)
Tab Diagnosis
On this tab the notification-elements can be entered, which contain information about possible errors during
the communication..
Option Description
Notification-elements
Error text-element Enter a text-element here, which takes up an error message, when an error has
occurred during loading or saving of a command table.
The "Error num-element" should always be 0. If an error occurs, this element will be
given a definite value >0. With this value an error can then be diagnosed.
Error num- Enter a num-element here, to take up an error message, when an error has occurred
element during loading or saving of the command table. If no error has occurred, the element
has the value 0, in case of an error, the value will be >0.
Deactivation
Number of errors Here you indicate the number of errors, when the table shall be deactivated. With a 0,
the table is not deactivated, thus will always be active.
Notification- Enter a num-element here, to signal when the table was deactivated. This element will
element be given value 1 if the table was deactivated, otherwise it has value 0.
Reactivation Here you indicate a num-element to control the reactivation of the table. If this element
changes its value, the table will be reactivated.
278
DDE
Tab Activation
On this tab you define, on which conditions the data or the command transfer is active.
Option Description
Active at
Element The data of the table will only be transmitted or received, when the num-element, that you
enter here, has a value > 0. If the value is 0, the connection will be deactivated. If you do not
enter an element name, the connection will always be active.
Picture The data of the table will only be transmitted or received, when the picture, whose name you
enter here, is shown in the visualization as main picture.
Station This field only is active, if you edit a network project. For this, you must have activated the
option network project in dialog Runtime configuration in the Project Manager.
If you want to restrict the processing of a DDE-table to a definite station, enter the number of
the station here (0 for the master, 1 -31 for a station).
Option Description
Start receiving Enter a num-element here, whose change will start the reading of data from a DDE
server to AMS Asset Graphics.
Receiving Enter a num-element, whose value changes, when reading of data from a DDE server
complete is completed.
Start sending Enter a num-element, whose change will start the sending of data from AMS Asset
Graphics to a DDE server.
Sending Enter a num-element, whose value changes, when sending of data to a DDE server is
complete completed.
Option Description
Replace dot with AMS Asset Graphics uses "." as decimal point. Set this option, if you would like to
comma replace the decimal point by a decimal comma in another Windows application.
Remove 'carriage Other applications may mark the end of a text with CR. Activate this switch if this
return' at end of line string shall not be transferred. This behavior appears e.g. at connections with some
versions of MS-Excel.
279
Manual AMS Asset Graphics 5.4
Example
To combine the data-element pH_value_Basin1 in the first line of the dialog above with the cell of the
second line and second column of an MS-Excel-table, enter Z2S2 for this field.
Regarding the name conventions of elements in other applications, the corresponding operating manuals
have to be contacted.
See also
Exchange data via DDE (Step-by-step instructions)
Command tables
In DDE command tables you configure commands, which can be sent to another application.
The application is defined in dialog Properties command.
Column Description
Element Enter here the name of the data-element, which shall start the sending of the related
command (control-trigger).
Command Enter here the command, that you want to send. The instruction must be enclosed in
square brackets.
Notification- Define here the data-element, which change sits value, when the command was
element executed successfully (notification-trigger).
Comment For a more detailed explanation, every command instruction will be assigned a
comment.
See also
Data exchange via DDE (Step-by-step instructions)
Runtime
DDE-connection
The DDE Runtime combines the functionality of the DDE-Client with the functionality of the DDE-Server.
With a DDE-client you can request data from other applications (DDE server) and send them data or
commands. The DDE-client processes the data exchange and command tables, configured in the DDE
Editor.
The DDE-server provides the values of the AMS Asset Graphics data-elements for other applications. It will
be started automatically at runtime by entering the DDE (Client/server) in the program list in the dialog
Runtime configuration in the Project Manager and do not have to be configured.
280
DDE
For the DDE-client the logging of the data exchange and command tables is possible for the error diagnosis.
For every definition file a separate logging window can be opened (menu command Logging). In the
Logging window all actions will be shown, which are caused by the triggers of the table.
The logging is recorded only temporarily, but can be pasted in the clipboard. The size of the logging is
restricted, old dataset will by typed over by new ones.
The following topics are defined in the AMS Asset Graphics DDE server:
General topics
Topic Function
NumEle Topic for reading and writing a num-element
TxtEle Topic for reading and writing a text-element
NumRead Topic for reading a num-element
NumSend Topic for writing a num-element
TextRead Topic for reading a text-element
TextSend Topic for writing a text-element
Theme ’System’
Element Contents
SysItems returns the system-topics of the DDE- TopicItemList; Formats; Topics; SysItems
server
Topics returns all topics of the DDE-server System; NumEle; TxtEle; NumRead; NumSend;
TextRead; TextSend
TopicItemList returns the elements of the TopicItemList; Formats
system
Formats returns the supported data TEXT
interchange formats
See also
Examples DDE-Server
281
Manual AMS Asset Graphics 5.4
Using
Server-Functions
Requesting data from AMS Asset Graphics into an Excel sheet
Note Enter the program DDE Runtime into the program list (see inserting programs). Enter also
the application into the program list, which shall exchange data via DDE, in this example EXCEL.EXE.
282
DDE
On tab Connection in field Name you have to enter the name of the application, which shall
receive data from this table, in this example Excel.exe. Enter the name of the Excel document
with which data shall be exchanged into field application Topic, in this example FillLevel.xls.
Select tab Trigger. Enter the name of an data-element into field Start sending which change
shall trigger the sending of a data exchange table to Excel, in this example the system-element
_F1.
Confirm the dialog with OK.
Enter the data items into column Element, which values shall be written into the Excel sheet.
Here you can also select elements from the reference list. Click with the right mouse button on the
cell in column Element to open dialog Element selection. Select the element and confirm the
dialog with OK. The type of data-element is entered automatically into column Type.
Indicate in column field the corresponding field of the Excel sheet.
See also
Sending commands to Excel
283
Manual AMS Asset Graphics 5.4
Select tab Trigger. Enter an num-element into field Start receiving, which triggers the receiving
of the data exchange table from Excel, in this example num-element _F2.
Confirm the dialog with OK.
Enter the data-elements into column Element, which values shall be read from the Excel table.
Here too, you have the possibility to select the element from the reference list. Click with the right
mouse button on the cell in column element to open dialog Element selection. Select the
element and confirm the dialog with OK. The type of data-element is entered automatically into
column Type.
284
DDE
See also
Sending commands to Excel
285
Manual AMS Asset Graphics 5.4
Enter the name of the application which shall receive DDE-commands from this table on tab
Connection into field Name, in this example Excel.exe.
286
DDE
To display the num-element Silo1 in Excel, enter the following term into one cell:
=TDDE32|NumEle!Silo1
To show the text-element TEXT1 in Excel, enter the following term in one cell:
=TDDE32|TxtEle!TEXT1
The so-called pipeline symbol "|" stands between program name and topic name, it is a syntax of Excel.
The exclamation mark behind the topic name separates the topic from element name.
Note The syntax of the program releases is partly different. Please use the Excel manual for further
information.
Note Word does not update the fields continuously, but when opening the document. The syntax of the
program releases is partly different. Please use the Word manual for further information.
287
ODBC
Introduction
User Interface
The ODBC Editor is designed as MDI application, this means an arbitrary number of documents (in the
following called ODBC tables) can be processed at the same time.
Fill column
Use this command to fill the definition file automatically with all columns, defined in the table on tab
Connection. At this, the lines Database column, Variable type, Value size and Element type can be
filled with the information from the database.
See also
General operation
289
Manual AMS Asset Graphics 5.4
Tab Connection
On this tab define database and table for the ODBC-connection and the conditions for opening. In addition,
the database connection can be protected by user name and password.
Option Description
ODBC Database
Connect Click this button to select an ODBC database and to connect it with this document.
The name of the selected ODBC database will be shown in the entry field behind
button Connect.
Open write When you activate this option, the database will be opened write-protected and
protected changes in the database are not possible. Other applications may open the database at
the same time.
Table Enter here a table of the above mentioned database. When you are connected with the
database, you may select a table.
Authorization You may enter user name and password for the database connection here.
Name Enter here user name for the database connection.
Password Enter here the password for the user name.
290
ODBC
291
Manual AMS Asset Graphics 5.4
Tab Navigation
On this tab you define elements for scrolling in the database table.
Option Description
Scroll line
Forward/ Define here a num-element, which value change causes forward/backward scrolling in the
Backward database table. The number of lines, that are scrolled, results from the difference to the old
value.
Example
Previous value 2, new value 5: the database will be scrolled forward by 3 lines.
Scroll With the help of the following num-elements, it is possible to scroll in the database page by
page page. A page consists of the number of the defined element lines in the ODBC definition
table.
Forward/ Define here a num-element, which value change causes scrolling one page forward/backward
Backward in the database table. The number of pages, that are scrolled, results from the difference to
the old value.
292
ODBC
Column Description
Active at Enter here a num-element to activate the SQL orting / filter instructions. The SQL sorting /
filter instruction is active, if this element has a value different to 0.
SQL Sort or Here you can enter a sorting- or filter instruction. The commands must be defined
/ according to the SQL syntax.
Filter Examples:
command
Filter: WHERE Recipe name="Cherry gateau" AND property="fresh"
Sorting: Order BY Recipe name AND production date
Comment Enter here a comment for the command.
ODBC
The ODBC Runtime program has not a special user interface like the Eventjournal Runtime. Status
messages are displayed in the program window, though.
293
Language
Editor
Introduction
With the language changeover you can switch between different languages during runtime.
This is useful, e.g. if a machine with a visualization shall be delivered into multilingual countries. The same
visualization software can then be delivered to the different countries with the user texts in the respective
national language.
Another example: a system with visualization was delivered from Germany to Spain. The users on site can
watch all texts in Spanish. The system requires a maintenance, which is done by a service technician from
Germany. He switches the language from Spanish to German and gets all texts – failure messages, notes
on the maintenance etc. – in German.
See also
Language definition window
Define a project for several languages (step-by-step instructions)
295
Manual AMS Asset Graphics 5.4
In this table you define the text for the language-elements. The text for the different languages has to be
entered into the columns. The columns to be displayed, are defined in dialog Used languages.
Every line, you have defined in the language table, corresponds to a language-element (pseudo text-
element). Language-elements start with two underlines and a letter sequence TX, followed by a four-digit
number. Thus, line 17 of the language table corresponds to language-element __TX0017. If you want to
display the text of the fourth line of the language table, define a dynamic text object with name __TX0004.
Language-elements may be used always there, where text-elements are used.
Column Description
Text This column shows the number of the language-element. This setting cannot be
changed.
German Enter here the text, which the language-element shall be assigned to, if the language is
German. (In this case the system-element _Language has value 0.)
... other Enter here the text, which the language-element shall be assigned to, if the
languages... corresponding language was selected. (In this case the system-element _Language will
have the value of the other language, e.g. 1 for English.)
See also
Creating a project in several languages
Attention This setting here influences the language dependent alarm texts in the Eventjournal (see Tab
Alarm text in the Event definition window).
Using
296
Language
297
Manual AMS Asset Graphics 5.4
In the example, the texts "Behälter 1" and "Container 1" are linked in the pseudo-text-element
__TX0050, the texts "Behälter 2" and "Container 2" in pseudo-text-element __TX0051 and
"Behälter 3" and "container 3" in pseudo-text element __TX0052.
Save the language definition.
Note At the same time you may leave open the Language Editor to read the number of the language-
elements.
298
Network
Editor
Introduction
The network mode permits to visualize and operate an AMS Asset Graphics project on several computers.
Generally it is possible to access on all data and to carry out all operating functions from every workstation.
However, this can be restricted by defining password levels for individual operators.
The basis for the network mode is an arbitrary network hardware and a operating system, which permits a
use of the TCP/IP protocol. If you use a firewall it is necessary that the AMS Asset Graphics programs have
access on the network. The network communication uses one configurable port.
For the identification, every workstation gets the so called network station number. The computer with
station number 0 is the master. The master coordinates the data exchange and monitors the other stations,
therefore it has to be always in operation. An operation at the master is possible in the same way as at other
stations.
Every computer stores its database in the memory. In the network mode the values of all data-elements on
all stations are synchronized. Data-elements, which are used only locally at one workstation, can be defined
in the Network Editor in the Exclude-List.
At parameter definitions in editors at network projects, such as the process assignment or the data storage,
it will be defined on which station the respective table shall be processed. This setting is only possible, if the
project was defined as network project in the Project Manager. In addition you can define in the Project
Manager, which program shall be started on which station.
See also
Configuration of network computers
Station definition table
Creating a network project
Setup redundancy mode
See also
General operation
299
Manual AMS Asset Graphics 5.4
Option Description
Name Enter here the name for the Master (max. 80 characters). The name is at disposal
with the system-element _MPStationName.
Note This system-element should be contained in the Exclude-List, to permit
every station to enter its own name.
Update Enter here a num-element, which change starts the synchronization of data by the
master. Normally, a time-dependant system-element such as e.g. _Sec03 is
entered.
Note If you don't use you a time-dependent system-element, you have to make
sure that a change of the element appears, before a timeout will be recognized at
the stations.
Start picture Enter here the name of a start picture (per default picture MAIN will be started) for
the visualization on the master (max. 80 characters).
Timeout Enter here a time period in seconds, within this period the master has to perform
an synchronization before the stations will shut down automatically and waiting for
a restart of the master. Possible values are 0 to 1800 seconds. If the data-element
to trigger the update has not changed within the indicated time, the stations
recognize a timeout.
There is a direct context between the trigger for update and the timeout period.
The relationship between them should be defined that way, that a timeout is
recognized after 30 or more update cycles.
If the master has detected that a station does not work anymore (timeout has
occurred), this station will be deleted from its list of active stations.
Status Enter here a num-element, which receives the status information to the master. It
will be set by each of the stations. Since every station sets this element, it should
be included into the Exclude declaration. The master sets the element only to
online or offline, since a timeout of the master can only be recognized by the
stations.
For the status applies:
0 = Station is offline
1 = Station is online
2 = Station will be signed off because of timeout.
Time synchronization A num-element can be indicated here, at the change of the data-element the
stations will synchronize with the current master time. Useful are time-dependant
system-elements, e.g. _Day.
Note However, a time synchronization is only possible, if the user logged-in at the
station, is authorized to change the time.
Stop stations with If this function is activated, all stations will be switched off automatically, if the
master master stops.
300
Network
Some data-elements were already entered into the EXCLUDE list per default, these are the system-
elements, that shall not be transferred. These elements are part of the standard, and will be determined in
the file MPExclude.ini. It contains the sections [Numelements] and [Textelements]. Directly after the
start of the section, there is key Number, which indicates, how many elements are part of this section. If you
want to add new elements or delete existing elements, you must ensure that the correct number of elements
is indicated that all these elements can be found. The file is stored in the program directory and thus applies
for all projects.
With the commands Insert and Delete you can insert or delete lines in the table.
Press button Standard to add all elements from file MPExclude.ini, if they are not yet in the Exclude
declaration.
Column Description
Element Enter here the name of the element, which shall be added to the Exclude declaration.
Description Here you can comment the element with a more detailed text.
Type Into column Element you can enter num- or text-elements. Click the right mouse button over
this field and select from the dialog NUM (for num-elements) or TXT (for text-elements).
Note You can also mark and change several cells simultaneously. For this, click with the
right mouse button on one of the highlighted cells.
Notes
The Exclude declaration should be maintained very conscientiously, otherwise unwanted effects could
appear. If, for example, system-element _NewPic is not in registered in the declaration, all workstation will
switch to the same picture, when this was executed on a station.
You have also to take into account, that triggers to start specific actions, will only be transferred, if you have
defined this during planning of the project in exactly this way, otherwise actions could be executed twice.
Also data-elements which control the visibility of trend charts or Window objects must be added into the
Exclude declaration.
Column Description
Station Here is the number of the station for which the entry in the line shall apply.
Name Enter here the name for the station (max. 80 characters). The name is at disposal with the
system-element _MPStationName.
Note This system-element should be contained in the Exclude declaration, to permit every
station to enter its own name.
Update Enter here a num-element, which change starts the synchronization of data by the station.
Normally, a time-dependant system-element such as e.g. _Sec03 is entered.
Note During planning of the project, you have to take into account the transmission rate of the
network.
301
Manual AMS Asset Graphics 5.4
Column Description
Start Enter here the name of a start picture (per default picture MAIN will be started) for the
picture visualization on the respective station (max. 80 characters).
Timeout The network programs perform timeout monitoring to check, whether the stations are still
working. Possible values are 0 to 1800 seconds.
If a network station detects, that its master does not work anymore, it tries to login at the
master anew. During this time, the status element of the master is set on 2.
Note The timeout must always be longer than the update time.
Status Enter here a num-element, which receives the status information to the respective station. It
will be set by the master and transferred over the network system.
For the status applies:
0 = Station is offline
1 = Station is online
2 = Station will be signed off because of timeout
See also:
Master properties
Exclude declaration
Runtime
Network system
The network ability permits to visualize and operate an AMS Asset Graphics project via several computers.
For the identification, every workstation gets the so-called network station number. The computer with
station number 0 is the master. The master coordinates the data exchange and monitors the other stations,
therefore it has to be always in operation. An operation at the master station is possible in the same way as
at other stations.
Every computer has stored its database in the working memory in the same way as at a single computer
station. The data transmission is made via Ethernet and TCP/IP.
The AMS Asset Graphics network task performs the updates of data-elements by coordinating the contents
of the (local) database with the network database. There are two different types of network programs: the
Master runs on the master computer, Station on the other computers.
The Master
After a successful start the master opens a window, where the individual actions are shown, which the
master is performing during the start phase. If an error occurs, this will be notified with a message.
The Station
After a successful start the station opens a window, where the individual file actions shown, which the
station is performing during the start phase. If an error occurs, this will be notified with a message.
In the title bar, the station number of the computer will be shown, where the station was started.
To start a network project automatically on the master and all stations, the automatic network start must be
prepared.
302
Network
If it has determined, that the master has been started, it will start the runtime on this station. There will be a
delay time, that you can define with an entry in file MPStartDelay.ini (in the project directory). If the master
is shut-down, MPStart will switch over automatically to the supervising mode. If the master is started with
various projects, MPStart will start also the stations with the corresponding projects.
The active stations will be displayed in black, inactive stations in gray. The current working mode is
displayed in the status bar.
Press button Cancel only, when the complete runtime shall be terminated.
Using
To define the station number for a workstation, start program Configuration, select tab Network and set the
desired station number. On this tab IP address and port for the communication are also configured.
At every station you must configure the global data directory in this way that it addresses to the same
physical directory.
When pressing button OK or Accept, the settings will be written into the registration of that PC.
Note Since the entries will be accepted not before the first program start, it is necessary, to start all AMS
Asset Graphics programs anew to accept the entries.
See also
Creating a network project.
303
Manual AMS Asset Graphics 5.4
Basic settings are made in the same way at all three methods. You have to proceed as follows:
1. Activate option Network project in dialog Runtime configuration in the Project Manager. Define
the programs for the master and for the stations which shall be started. Prerequisite for the
network mode is program Master for the Master computer and program Station at a Station
computer!
2. Define the data-elements in the Network Editor, which shall trigger the update and the Timeout-
times of the master and the stations. Make all other settings, which are useful for the project
(name, status, time synchronization, shut down of stations from the master). Edit the Exclude
declaration.
3. Check all editor documents on their network settings such as data storage of a table on a definite
station (see also tab General of a data storage table) or editing a process assignment table on a
definite station (see also tab Communication of a process assignment table).
4. You have to take into account, that the reaction time of the Eventjournal on the stations depends
on the network settings, since it operates with messages between master journal and station
journal. These messages will be transferred over the network system.
5. Please note, that the reaction time of trend charts, which operate with data storage files of
another station, depends on the network settings. The information of a storage will be transmitted
with messages. These messages will be transferred over the network system.
304
Network
See also:
AMS Asset Graphics directory structure
Synchronizing a project
Automatic network start
First the Redundancy license options has to be enabled on every computer involved.
The network data-exchange is done with the TCP/IP-protocol. For this reason, a so called port number must
be defined. Other AMS Asset Graphics runtime programs use furthermore on the ‚normal‟ file access.
305
Manual AMS Asset Graphics 5.4
306
Network
More redundancy-settings:
The settings can be made in the PROJECT.INI in section Redundancy.
Before a master gets active it will wait for a delay time (PrimaryMasterStartDelay and
SecondaryMasterStartDelay), whether the other master is not already active. In doing so, e.g. the problem
of both masters are booting simultaneously after a power break, can be avoided. The master with the
shorter delay time will then get the active master.
The monitoring time between both masters will be defined with the entry MasterMasterTimeout.
More information on the redundancy status and the manual change of the active master can be found in
section System-elements for network.
307
Activity Log
Activity Logging
For every project, an activity log can be defined, to record operation actions at runtime and important actions
of single programs. The activity log entries are also intended for saving of changes in the editor programs.
Different log levels between 0 and 99 can be defined. If log level 0 was selected, no message is generated.
The log level for operator functions in the visualization is defined in the Graphic Editor, the log level for
operator functions in the Eventjournal in the Eventjournal Editor.
The entries in the activity log can be watched and printed with the Activity Log Viewer. Operation actions will
be recorded, independently from the fact, whether the Activity Log Viewer is started or not.
The log level for start and exit of runtime programs can be defined in the dialog Runtime options.
See also
Recording operator actions and system messages in the activity log
Viewer
Introduction
In the Activity Log user inputs and important actions of programs are recorded.
Which actions and user inputs are recorded into the activity log will be configured in various editors like
Project Manager, the Graphic Editor, the Eventjournal Editor, the Operation Log Editor, etc.
The Activity Log Viewer displays the activity log. In order to find specific information, the Activity Log Viewer
has extensive sorting and filter options.
The Activity Log Viewer can display several views. The log messages are shown in a table.
309
Manual AMS Asset Graphics 5.4
You can assign different time periods and sort and filter options to a view. The summary of the settings is
called profile, which can be stored in a file and can be reused.
See also
Recording operator actions and system messages in the activity log (Step-by-step instructions)
New log view
Toolbar
General Operation
Toolbar
In the Activity Log Viewer specific toolbar the following commands are available:
Category
Select here one out of 2 categories:
Category Description
User This category includes all messages, which were triggered by an user action.
Applications This category includes all messages, which were triggered by the system, e.g. when there is
not enough memory available or when the printer does not respond.
All Select All to view both categories.
Select Profile
Select a profile here. Predefined are the profiles <All> and <Default>. These profiles cannot be changed
and stored with the same name.
Edit profile
Select this button to open dialog Profile properties.
Save profile
Click this button to save the current profile. When one of the profiles <All> or <Default> has been selected,
changes cannot be saved under the same name. Enter a new name for the profile in dialog Save as....
Optimize columns
Optimizes the width of the table columns that way, that all columns are visible.
310
Activity Log
Tab Period
On this tab you configure the span of the displayed period and whether it is displayed relatively or
absolutely.
Option Description
Relative Activate this option, if the period shall be displayed relative to the current date.
Period Here you define the number of days that shall be displayed.
End of period Here you determine the end of the displayed period. For example, if you leave the default
before setting before 0 days, the activity log will always be shown including the current day.
Absolute Activate this option, when the period shall be shown as absolute period.
From The first displayed day is defined here.
Until The last displayed day is defined here.
Tab Table
On this tab you configure the displayed columns.
Option Description
Available columns Here the columns are listed, which are still available.
Selected columns Here the columns are listed, which are selected and which are shown.
If you want to display a further column of the activity log, select it at the Available columns. Press the
button (->) to transfer the column to the Selected columns.
You can deselect a column with the button (<-).
Tab Sorting
On this tab you define sorting options for the view. Three criteria can be selected for the sorting. If the first
criterion doesn't produce any difference at several activity log entries, the second criterion will be used, then
the third.
Option Descriptions
Date When sorting on the date in descending order, the entries of the latest day will be set to the
top of the table.
Time With sorting criterion time, the entries will be sorted on the time of the day. When sorting on
the Time in descending order, the activity log entries with the latest time of the day can be
found at the top of the table.
Station At descending sorting on the station number, the activity log entries with the highest station
number are set to the top of the table.
User When sorting on user names in descending order, the activity log entries will be shown in the
table in alphabetic order. With descending sortings the entries will be sorted in the following
order: z...a, Z...A, 9...0.
Log level At descending sorting on the log level, the entry with the highest level is set to the top of the
table.
Program It will be sorted in alphabetical order according to the name of the program.
Type It will be sorted in alphabetic order according to the type of the entry. When sorting in
descending order, the warnings above are at the top of the list, then the information, then
the errors.
Event ID At descending sorting on the Event IDs, the activity log entry with the highest Event-ID will be
set to the top of the table.
Description It will be sorted in alphabetical order according to the text of the descriptions.
Comment It will be sorted in alphabetical order according to the text of the comments.
311
Manual AMS Asset Graphics 5.4
Tab Filter
This tab offers the possibility to set filter options for a view, this means, only those entries will be shown,
which match to the filter option.
It is possible to set filters for individual users, for a program, a station and the description.
Option Description
Type Activate one or several of the options, to permit viewing only entries of the desired type
(information, warnings, errors).
User When you want to have displayed only log entries, which are assigned to a specific user,
enter the user name here.
Program When you want to have displayed only log entries, which are assigned to a specific program,
enter the program name here.
Station To display only those log entries, which were created at a specific network station, enter the
station number here.
Description When you want to have displayed only log entries, which contain a specific text, enter the
text here.
Column Description
Date, The date and time, when the message was generated.
Time
Station The network station, where the message was generated.
User The logged-in user, when the message was generated.
If an alarm was acknowledged in the Eventjournal (MASTER), the user currently logged-in,
will be entered as user.
If an alarm was acknowledged in PageControl, 'PageControl' will be entered into the activity
log as user and the PageControl receiver name will be entered into field Comment.
If an alarm was acknowledged in a network system, the current user of the station will be
entered as user. The registered Time is the time, when the alarm was acknowledged by the
master.
When an alarm is acknowledged by an element, the current user of the master will be
registered as user together with the comment 'Acknowledged by element'.
Log level The level of the message.
Program The program, that has produced the message.
Type The type of the message (Error, Information or Alert).
Event ID The ID of the message (corresponds to the message as number).
Description The plain message.
When alarms are entered into the activity log, the alarm text appears here.
Comment A remark to the message.
312
Activity Log
Using
With the activity log operator inputs as well as important actions of individual programs are
recorded. Individual reports are recorded independently from the fact, whether the runtime program has
been started or not. Which actions and operator inputs are recorded in the activity log, are defined
with Project Manager, Graphic Editor, the Process Assignment Editor, etc.
Definitions for the activity logging are made with the Project Manager.
With the Activity Log Viewer you can watch the current activity log. Recording of messages in different levels
is controlled via the log level. To find specific information, the Activity Log Viewer offers extensive sorting
and filter options. The activity log is saved in the .mdb format, thus it can be used with external programs.
The Activity Log Viewer can be started also together with the runtime program. For this you have
to proceed as follows:
Open the dialog Runtime configuration with the menu command Configuration | Runtime.
Select Activity Log Viewer from the list of standard programs into the Program list.
Open a new log view (command New view in the toolbar). Select the desired project and one of
the profiles in the dialog New log view.
313
Manual AMS Asset Graphics 5.4
The profiles <Default> and <All> are predefined. Profile <Default> contains the columns Date,
Time, Users, Program and Description. Further profiles with more columns can be created at an
open log window.
Per default, the activity log of the current day is displayed. If you would like to watch another
period, select button Edit profile in the toolbar. In dialog Profile Properties you can set another
period on tab Period.
Select the columns to be displayed in the Log Viewer on tab Table. Shift the available columns
to the selected columns, if you want to display the columns, and in the opposite way, the
selected columns to the available ones if these shall not be shown anymore.
You can also define the order of the columns here. An available column will be inserted before
a selected, highlighted column. If no selected column is highlighted, the new column will be
displayed as the last one.
On tab Sort you define the sorting order. Select the sorting criterion and direction, e.g.
Ascending according to Date and Time.
On tab Filter the filter criteria can be defined to show only special records in the activity log, e.g.
only those entries which are assigned to operator Zimmermann.
Confirm the dialog with OK.
You can save the settings of the profile properties permanently under a new profile. Click on
button Save profile in the toolbar. If you have worked till now with one of the predefined
profiles, dialog Save as will be opened. Enter the new profile name here and confirm the dialog
with OK. If you have changed the properties of a self-defined profile, the changes will be
saved immediately after pressing the button.
Make sure that the project, you want to edit, has been opened in the Project Manager.
Select the menu command Configuration | Activity logging | Editor programs in the main
menu... to open dialog Activity logging editor programs.
Type in the desired log level for every editor.
Confirm the dialog with Save to save your changes.
Input objects as well as their log levels are defined in Graphic Editor.
Start the Graphic Editor (command Graphic Editor in toolbar Development in the Project
Manager).
Open the picture.
Select the object that shall get another log level, e.g. a number, a text, a scrollbar, a slider, a
button or a graphic button, etc. Open dialog Properties with a double-click.
Select tab Input with Number or Text objects or tab Function at one of the other object types.
Enter the log level into the edit field Log level.
Close the dialog with OK and save the picture.
Input objects as well as their log levels are defined in Graphic Editor.
Start the Graphic Editor (command Graphic Editor in toolbar Development in the Project
Manager).
314
Activity Log
315
Operation Log
Editor
Introduction
AMS Asset Graphics does not only provide information on the current state of a plant, but also permits to
save data and to access on the stored data.
With the operation log, several protocols and reports can be generated, which can be watched, edited and
printed with the Operation Log Runtime. There are reports for a day, week, month and year. The reports
include the measuring values of the elements to be supervised in form of minimum, maximum, average and
sum values. The day reports are used to generate reports for a week, month and year. The data of the
reports can be displayed and printed also as diagram.
Runtime function
The data, generated during the runtime, are stored in a Microsoft SQL database. The MSDE (Microsoft SQL
server desktop engine) is used. Generally, the MSDE runs on the AMS Asset Graphics computer (in network
systems on the master). However, it is also possible to install the MSDE on a separate network server or to
use an SQL server, available in the network. This server must be prepared for the arising date volume.
During runtime defined data-elements are read from the database and calculated to single values. These
single values are saved in the database. If the hour changes (at 24 day values), a day value will be
calculated with the single values and stored in the database. At the change of the day, the day values will be
combined to a total day result. These total day values will then be summarized to week, month and year
values. The calculation function is defined in the Operation Log Editor.
To limit the data volume of the database, it must be defined, when the values of the relevant compression
level are to be deleted. Before deleting the data an export of them can be made.
The day, week, month and year data can be displayed with table views. These tables offer the possibility to
enter data manually.
A printout of data can be made via reports. These reports are defined in the Operation Log Editor or in the
Operation Log Runtime. It must be defined, which data shall be printed and in which form this shall be made.
Beside a printout on paper, the report can also be exported into other data formats such as PDF, bitmap,
XML, Excel, HTML etc.
Another form of displaying the data is the output as a diagram. Here, the data of different process variables
are shown as lines in a diagram.
See also
Protocol definition window
Diagram definition window
317
Manual AMS Asset Graphics 5.4
With the menu command Edit | Open report definition and the selection in the dialog Report selection the
AMS Asset Graphics Report Designer will be started.
Column Description
Standard
ID Every definition line gets an ID as identification. This ID is generated automatically by
the program and has a great importance for the runtime. In the database all data with
this ID will be assigned to the corresponding process variable. Within a table the ID
must be unique. An exception are definitions with the line type copy.
Name In addition you can define here a name for the identification. Within a table the name
must be unique. This name is optional. It helps to retrieve the process variables in the
report designer. If no name was entered, DefID_X will be used in the report designer,
whereby X is used for the ID number. When changing the name, the report designer
definitions have to be adapted as well.
Element Here you have to enter the name of the num-element, which value shall be used for the
calculation of the process variable. Instead of a num-element a VBScript function can
also be used. In this case, the function name has to be extended by a () as identifier for
function, example: SumSpecial(). VBScript functions are drawn in green in the table.
The function is to implement on tab VBScript.
Description The description of the process variable is entered here.
Designation In this column the designation (short description, plant designation) of the process
variable can be entered.
Group Select with the right mouse button a group from dialog Group selection or enter the
group number.
Note You can also select multiple cells and then select a group.
Unit Enter here the unit such as e.g. h, m³, etc. This unit will be used for all reports. On tab
Miscellaneous you may define an individual unit for each of the reports (m³/d, m³/w,
m³/m, m³/a). These units will then have priority over this default unit.
Line type By clicking he right mouse button you can select the line type by using the dialog
Selection line type. Alternatively you can also enter the name of the line type.
Number format Configure here the total number of digits and digits after the comma, which shall be used
Total digits, to display the numerical values. This input is optional.
After digits
Functions A function defines how multiple value are summarized to a new value. A calculation is
made at every compressing level. A description of the functions can be found here.
Standard, Enter here the abbreviation for the function, or right mouse select a function via dialog
further columns Function selection, which shall be used as standard function.
If in the following columns another function is used, that function will have priority.
Instead of the standard functions VBScript functions can be entered. You have to
append () to this function name, example: MySum(). See tab VBScript compression.
Limit values
Overflow Enter her a number, which will be used as overflow limit for the sum function, when
calculating the single values from the scan values.
At the calculation the current value is compared with the previous value. If the difference
exceeds half of the overflow limit, a new difference will be defined under consideration of
an overflow case.
Example:
In column Overflow the limit is configured with 30000.
The value itself changes from 29000 to 2000: the difference 3000 is computed.
The value itself changes from 1000 to 22000: the difference -9000 is computed.
The process variable must not change by more than half of the overflow limit (e.g. from
500 on 15700), since otherwise a wrong difference will be calculated.
318
Operation Log
Column Description
Minimum These values are used as limits for the manual input.
Maximum When exceeding or falling below the limit the value can be displayed in different colors.
These parameters are optional.
Note The values Minimum/Maximum of the corresponding report type on tab
Miscellaneous have priority over this input.
Substitute values
Active With this option you can activate the using of substitute values. When active the process
value will be replaced by a substitute value, if the process value is outside the limits.
Minimum The upper and lower substitute limits will be entered as constant values here. In case of
Maximum a limit violation, the substitute value will replace the process value.
Value In this column the substitute value is entered.
Activation Enter here an element, which can force the use of the substitute value. If the element
has the value 1, the substitute value will be used.
Miscellaneous
Manual input Enter the access right, or click with the right mouse button to open dialog Select access
P-Level, right and to select a user right. During runtime, this authorization is used for the manual
Log input.
Enter a Log level to record manual inputs in the activity log.
Day view,
Week view,
Month view,
Year view
Visible Set the option, if the process variable shall be displayed in the corresponding view.
Min, These parameters are optional. Enter here the limit values for the corresponding view.
Max Especially when using the sum function, it is useful to have other limit values for e.g. the
month sums as for the day total sum. The values have a higher priority than Minimum /
Maximum on tab Limit values.
Dim This input is optional. Enter here a unit for the corresponding view (e.g. m³/d for the day
view).
Valid
From These parameters are optional. Enter a date from which the definition is visible, or after
To the line is hidden. The calculation is only performed, if the current day is within the range
limits. Outside the range limits the definition is not counted as process variable.
319
Manual AMS Asset Graphics 5.4
Tab Database
On this tab you define the properties for the connection to the database. If marking field Standard is
selected, the MSDE instance inVISU_PMS on the local computer will be used (at a network system, the
master computer). Operating Log Runtime uses the database OperationLog and registers with user name
inVisuSystem and a predefined password. This user is available in the database. The SQL server
authentication will be used to login.
Remove the marking beside Standard, if you would like to use a special SQL server. Now, you can enter
name of the SQL server instance. The server name consists of computer name or IP address followed by
the name of the instance.
Examples of a server name:
ComputerABC\DB1
172.18.205.74\Protocols
Within an SQL server instance, a database must have been opened, the name of which you have to enter in
the dialog beside Database. For the login the fields User and Password are used. Also here, the SQL
server authentication will be used to login. The user must be authorized for reading and writing in the
database and he must be able to create tables.
Tab Definition
Define here name and resolutions for the report.
Option Description
Report name Enter the name here, which shall later on during runtime be displayed as identification to
the users. If you do not make any entry here, the file name of the definition will be shown
in square brackets (example: [report 1]).
Scanning During a scanning process, all data-elements will be scanned for the report definition and
stored for calculating the single values. If a VBScript function is used instead of a data-
element, this function will be called during the scanning procedure. Scanning of the
database is made with a maximum speed of 1/sec.
Every change If this field is highlighted, every change of an element will start a scanning process. If
there is no change at any of the elements, no scanning process will be carried out.
Trigger Enter here the name of a num-element, which starts a scanning process, as soon as its
value changes (Control-trigger). The amount of the change is irrelevant. You can use a
num-element which changes continuously (e.g. system-element _Sec01, which changes
its value every second). However, you can also select a num-element, that changes
discontinuously.
Time periods
Day value Select here one of the possible intervals for the day values. For every day X day values
will be calculated for each of the process variables. The number of the day values is
determined by the interval time. With an interval time of 2 hours this results in e.g. 12
values per day.
Single values Select here one of the possible interval times for the single values. For every day, X
single values will be calculated for each of the process variables. The number of the
single values is determined by the interval time. With an interval time of 15 minutes this
results in e.g. 96 single values per day.
Records per In this field it will be shown, how many records are stored in the database per process
day and variable and day.
definition line
320
Operation Log
Tab Groups
Up to 100 group names can be defined. The group names can be edited in this dialog. Every process
variable will be assigned to a group.
Option Description
Data
Database table For information purposes the database table name is displayed here. In this table the
data for the corresponding compressing level are stored.
Delete data after Define here, when the data of this table shall be deleted. Depending on the
compressing level the period is specified in days or months.
After each day change the system checks whether data have to be deleted.
At 0 the data will never be deleted.
Resources For information purposes, the consumption of the data volume is shown in the
database. For the calculation, the number of the process variables, currently in the
table will be taken into account. The percentage load of the MSDE is related to 2
GByte data, the limit value for the MSDE. This indication of the load is not very
precise and should therefore be considered only as reference value.
Export data Mark the field to export the data into a CSV file before deleting them.
before deleting
Destination Define here the name of a destination file to export the data. You can also use
variables in this definition.
D:\Export\$_Year\$_Month\data.csv.
Note If the file already exists, the data are appended to the end of the file.
Status
Set total state to The total value will be given status manual, if X input values have got status manual.
'manual', on If you enter 0 this function is deactivated.
Set total state to The total value will be given status substitute, if X input values have got status
'substitute', on substitute.
If you enter 0 this function is deactivated.
Option Description
Data
acquisition
Error code The last occurred problem at the data acquisition can evaluated with this element
Show error Set this option to report errors, which appear during the data acquisition, to the user.
dialog Especially if there are connection problems to an external SQL server.
Data
compression
Error code The last occurred problem at the data compression can evaluated with this element
Show error Set this option to report errors, which appear during the data compression, to the user.
dialog
321
Manual AMS Asset Graphics 5.4
Tab Miscellaneous
On this tab you define whether reports shall be indicated and operated during runtime, which access
authorization shall be required for this and whether these actions shall be entered into the activity log.
Option Description
Operating management
Here you define the authorization (P-level) for an action and whether these action have to
be recorded in the activity log (Log).
The table has the rows:
Error Error messages can be recorded in the activity log.
messages
Report In this row you define password and log level for opening the report designer.
designer
Day view In this rows you define password and log level for opening the corresponding views.
Week view
Month view
Year view
Export
Column Mark this field, if you want to have a column heading in the 1. line of the CSV file.
names
first line
UTC time With this field you decide that time stamps are written in the UTC format. The UTC
(Universal Time Coordinated) format is a worldwide well-defined time.
If this option is not set, the local time is used for the time stamps.
CSV Here you define the separator char used for the CSV file.
separator
See also
VBScript compression – User functions for the calculation during the compression
VBScript – User functions for the calculation during scanning
322
Operation Log
End Sub
The procedure name (here MyFunction) can be entered in column Function instead of a standard
functions. For this, a "()" has to be appended to the function name (example: MyFunction()). You may
select any name for the procedure. If the function is available in the script and if it also has got the two
parameters, the function will be called at the calculation. If the function is not available, no calculation will be
made and the total value will be set on status invalid.
Parameter Values is a variable of type Values and parameter NewValue is of type DBValue.
Example:
Sub MySum (Values, NewValue)
Dim HelpDouble
HelpDouble = 0
Dim Anz
Anz = 0
For I = 1 To Values.Count
Set val = Values.Item(I)
If val.ItemState > 0 Then 'is valid?
HelpDouble = HelpDouble + val.ItemValue
Anz = Anz + 1
End If
Next
The above example shows an implementation of the sum function which is already available in the system.
All values of the array Values with a valid status are added up. If there is at least one valid value, the
variable NewValue will be set with the sum.
The following picture shows the use of this function:
323
Manual AMS Asset Graphics 5.4
Example:
Set F1 = CreateObject("PMS.NumEle")
F1.SetName("_F1")
dummy = F1.IsChanged
Sub OnRun
If F1.IsChanged Then
Set ColCells = ThisReport.GetColCells(1, date + TimeSerial(8, 0, 0))
ColCells.DefID(7).ItemValue = 67.5
ColCells.DefID(7).ItemState = 1
End If
End Sub
In the example above, at every change of element_F1, a value of 67.5 will be written in the hour value 8h of
today in the line with DefinitionID 7.
Function OnColChanged
At every interval change, e.g. at changes every 15 min, every hour, every day or every month, the function
OnColChanged will be called. Here you have the possibility to control the data once again after the interval
change. The function will be called also after a manual input.
324
Operation Log
Example:
Sub OnColChanged (TableType, ColDateTime)
Set ColCells = ThisReport.GetColCells(TableType, ColDateTime) 'get data cells
from column
If ColCells.DefID(8).ItemState > 0 And ColCells.DefID(7).ItemState > 0 Then
' add the 2 values
ColCells.DefID(9).ItemValue = ColCells.DefID(8).ItemValue +
ColCells.DefID(7).ItemValue
ColCells.DefID(9).ItemState = 1
Else
ColCells.DefID(9).ItemState = 0
End If
End Sub
In the example above the value of the line with DefID 7 will be added to the value of the line with DefID 8
and the result written into line 9.
You can also use functions OnStart (initialization), OnRun (cyclical) and OnEnd (end of Operation Log
Runtime). A detailed description of the possible functions can be found in section VBScript.
Tab VBScript
In this VBScript you enter VBScript code, which is executed during the scanning process. Instead of a data-
element, a VBScript function name followed by () can be entered in column Element of table Definition. If
this function is found in this VBScript, it will be called. The return value must be a number.
Example:
Randomize ' Initialize random-number generator.
const MaxValue = 7000
const MinValue = 1000
Function Zufall
Zufall = Int((MaxValue - MinValue + 1) * Rnd + MinValue)
End Function
The example above returns random numbers in the range 1000 to 7000.
The following fig. shows the usage of this function:
Function OnInitRow
With the function OnInitRow the visibility of each row can be switched on or off. The function is called once
for each row of the definition while the view is opened.
325
Manual AMS Asset Graphics 5.4
Example:
Sub OnInitRow(TableType, DefID, bVisible)
If DefID = 2 Then
bVisible = 0
End If
End Sub
TableType is the type of the current table (2 for daily report, 3 for weekly reports, 4 for monthly report and 5
for annual report). DefID is the definition ID of the line. bVisible indicates whether the line is shown or
hidden. This variable is writable to control the visibility of the line.
You can also use functions OnStart (initialization), OnRun (cyclical) and OnEnd (end of Operation Log
Runtime).
A detailed description of the possible functions can be found in section VBScript.
Type Values
This type is a collection of Value variables.
Option Description
Count Count is a field where the number of the value variables is stored. This field is read only.
Item(Index) With this function the individual values can be accessed. Every value is of type Value.
The access on a value is made via the Index, example: Item(5). The index must be a
value between 0 and Count.
PreviousValue (Version 6.0)
This variable serves the last value from the previous interval. The value is of type Value.
Sample: The data type values are the daily totals from the month of April. In this case the
variable PreviousValue contains the daily total of 31 March.
Type Value
This type contains an operation log value. Every value has a status, a time stamp, minimum and maximum.
Option Description
ItemState Status of the value.
ItemTime Time stamp of the value.
ItemValue The value itself.
MaxState Status of the maximum.
MaxTime Time stamp of the maximum.
MaxValue Value of the maximum.
MinState Status of the minimum.
MinTime Time stamp of the minimum.
MinValue Value of the minimum.
326
Operation Log
Type DefRows
This type is a collection of DefRow variables.
Option Description
Count Count is a field, where the number of the DefRow variables is stored. This field is read only.
Item(Index) With this function the individual DefRow variables can be accessed. Every value is of type
DefRow. The access on one of the DefRow variables is made via the index (example:
Item(5)). The index must have any value between 0 and Count.
DefID(ID) With this function, the individual DefRow variables can be accessed as well. However, the
access on one of the DefRow variables is made via the definition ID. The definition ID must
be valid, otherwise a zero will be returned.
Type DefRow
This type contains information on an operation log definition line. All variables can be read only.
Option Description
DefID Definition ID of the line.
Description Description text of the line.
ElementName Name of the AMS Asset Graphics data-element.
LineType Line type has the following values:
0 for automatic
1 for manual value
2 for title
PlantDataText Designation for the process variable
Type Cells
This type is a collection of Cell variables.
Option Description
Count Count is a field where the number of the Cell variables is stored. This field is read only.
Item(Index) With this function the individual Cell variables can be accessed. Every value is of the
type Cell. The access on one of the Cell variables is made via the index (example:
Item(5)). The index must have any value between 0 and Count.
DefID(ID) With this function, the individual Cell-variables can be accessed as well. However, the
access on one of the Cell-variables is made via the definition-ID. The definition-ID must
be available, otherwise zero will be returned.
Value(IDName) With this variable a direct access to the values is possible. Pass the identification name
as parameter. A read and write access is possible. If the value is written, the calculated
flag is added to the status of the value.
If you read the value from an element which can not be found with the identification
name, or if there is no value, a runtime error is generated.
Sample:
Set ColCells = ThisReport.GetColCells(TableType,
ColDateTime)
With ColCells
On Error Resume Next
.Value("Total") = .Value("Quantity1") +
.Value("Quantity2")
.Value("Temperature") = 18.9
End With
In the example above, the command On Error Resume Next is used to handle a
possible runtime error. The assignment of 18.9 is also done, when for example, the
Quantity2 has no value, and the addition is interrupted by an runtime error.
327
Manual AMS Asset Graphics 5.4
Type Cell
This type is identical to type Value. As expansion, it still contains the DefID as variable for reading.
Type DBValue
This type is identical to type Value. As expansion, it contains in addition the variable WriteDBValue. Per
default this variable is predefined with True. If the variable is set to False during a calculation for the
compression, the storing of the value into the database will be suppressed.
Status values:
Every status variable may be an OR-combination of the following values:
Value Description
0 Value is incorrect.
1 Value is OK.
2 Manual input (value was edited by a user).
4 Manual input (value was set to manual input by the system, at the calculation, X values were set
on manual state).
8 Value smaller than minimum.
16 Value has exceeded the maximum.
32 Value is a substitute value.
64 Value is a calculated value.
Tab Lines
With each of the lines of the table you can to define one line for the diagram.
Option Description
Data item With the right mouse button you open a the dialog Select data-element. With the
Report/Variable selected data-element you define the process variable to be displayed as line.
Range of values For every data item in the diagram you can assign individual ranges of values. Thus,
From/To data items with various ranges can be compared.
Color Color of the line
Opt. With this button you open a dialog with special properties for the line.
328
Operation Log
Tab General
Option Description
Background
Color1 / Color2 Here you define the colors for the background. The background is drawn with a
color gradient from left (Color1) to right (Color2). If you do not want to have a color
gradient select two identical colors.
Operating management
Password protection Set here the right to open the configuration of the diagram during runtime. Enter the
right as number or click with the right mouse button to open the dialog Select access
right.
Log level Enter a Log level greater than 0 to record the storing of the diagram properties into
the activity log.
Format x-axis
Color Here you define the color of the label.
Alignment Here you define the alignment of the label. The orientation is described by an angle
between 0 and 90.
Number Here you define the number of the vertical grid lines and of the appropriate labels.
An input is only possible, if the option Automatic is off.
Automatic If you want to have an automatic labeling set this option. In this case, the number of
vertical grid lines will be adjusted automatically to the width of the diagram.
Year, Month, Day, You can define whether the x-axis shall be labeled with Year, Month, Day, Hour,
Hours, Min, Sec Minute and/or Second.
Format y-axis
Align left Here you enter the orientation for the text at the left / right y-axis. Valid values are -
Align right 90 to 90°.
Automatic If you want to have an automatic labeling set this option. In this case, the number of
horizontal scale subdivisions will be adjusted automatically to the height of the
diagram.
Number Here you define the number of the horizontal grid lines and of the appropriate labels.
An input is only possible, if option Automatic is off.
Tab Grid
On this tab you configure the design of the diagram grid. Minor grid lines subdivide the main grid in addition
and are shown as dotted lines.
Option Description
Horizontal/Vertical Here you define the design of the horizontal/vertical grid lines.
Active Set this option to show grid lines.
Major grid color Configure the color of the major grid lines.
Line thickness Select the width of the lines with a number between 1 and 9.
Minor grid color With this command you change the color of the minor grid lines.
Minor grid lines If you want to have displayed minor grid lines in between the horizontal main grid
lines, enter the corresponding number here.
Border color If you want to change the border color press this button.
329
Manual AMS Asset Graphics 5.4
Tab Print
The description of tab Print you find here here.
In the Report Designer you will see a variable with name Trend. You can move this variable in the page to
place the diagram on the paper.
On the one hand, you determine the period with the duration in days, weeks, months or years and on the
other hand with an offset to the current time. The offset is defined also in days, weeks, months or years. An
offset of 0 will shift the end (right side of the diagram) on the endpoint of the current day, week, month or
year (depending on your choice). An offset of 1 means preceding day, week, month or year.
Beside begin and end, the start and end date will be displayed for control purposes.
330
Operation Log
Examples:
Current month:
Duration: 1 month
Offset: 0 months
Previous year:
Duration: 1 year
Offset: 1 year
The reports with time tables display each single period in one column. The process variables are printed
line-by-line.
Reports with value tables display the values of the process variables in the columns. In every line a value of
the corresponding time period is displayed (e.g. 31 lines with 31 day values).
Define time period and type and open one of the offered reports.
With button New you open a report with name Default. If this report doesn't exist, it will be created
automatically.
331
Manual AMS Asset Graphics 5.4
Functions
The functions determine, how the output value is to calculate from the input values.
Input values can be the following: Scan values, single values, day values, total day values, week values and
month values.
The output value is the value that contains the result of the function.
These functions are used at the following conversions:
Scan values to single value
Single values to day value
Day values to total day value
Total day values to week value
Total day values to month value
Month values to year value
332
Operation Log
Note At the opened report designer, the help function can be opened with button F1.
Every value is provided with a definite structure, in the following called value structure.
In the following picture, you find the different variables, provided for every value of the operation log.
In the following table the individual variables of the value structure are described.
Variable Description
Value The value as number.
Value_Str The value as string. If the value is invalid, this string will contain "- - -".
Time Time stamp of the value as date/time variable.
Time_Str Time stamp as string.
State Status of the value. See section data type Values.
Color Dependent on the status the color will be passed as RGB value.
Comment The remarks for the value.
Min
Value The minimum as number.
Value_Str The minimum as string. If the value is invalid, this string will contain "- - -".
Time Time stamp of the minimum as date/time variable.
Time_Str Time stamp as string.
State Status of the minimum.
Color Dependent on the status of the minimum the color will be passed as RGB value.
Max Same structure as Min, however with the values of the maximum.
333
Manual AMS Asset Graphics 5.4
Variables
Normally, the contents of variables remain unchanged on every print page. Both report types (time tables
and value tables) have the same variables.
Example of a process variable with name Sample_1:
The following variables are provided by the Operation Log in the AMS Asset Graphics Report Designer:
Variable Description
General
General.Name Text variable, includes the name of the report (see tab definition)
General.Date Date of the current view
General.Day Day of the current view
General.Month Month of the current view
General.Year Year of the current view
General.NumberValues This field is only available at reports with time tables. It contains the number of
columns, e.g. 30 for 30 days.
General.Comment Text variable; includes the remarks on the current view.
Process variables Every process variable is provided by a structure in the report designer. The
name of this structure is defined by the Identification ID or by the
Identification Name (see description column ID and Name Protocol definition
window).
Sample_1 Identification name of the process variable.
Description Description of the process variable.
TagName Name of the data-element.
nDigits Number of digits for formatting
nPostCommaDigits Number of digits after the comma for formatting
Day, Week, Month, The structure of these four variable structures is identical.
Year
Unit Unit of the corresponding variable
Min Minimum of the corresponding variable
334
Operation Log
Variable Description
Max Maximum of the corresponding variable
Current Complete value structure of the current day, week, month or year value.
Previous1 Complete value structure of the previous day value, previous week value,
previous month value or last year's value.
Diagram In this branch all available diagrams are listed. If you pull a diagram on the page
via drag & drop, the diagram will be printed here.
The displayed period depends on the diagram settings and the period of the
current view.
Example:
The definition of the period of the diagram includes that the preceding month
shall be reported. In the month view you have selected January 2007. In the
report a diagram with the data of December 2006 is printed.
Fields
Fields are variables, which will have new data in every line of a table. The available fields depend on the
report type. Report types with time tables contain other fields than reports with value tables.
Variable Description
Description Description of the process variable
PlantData Designation
Group.Name Group name as text
Group.Number Group as number
Function The used function as string (see Functions)
Unit Unit
DefID Identification ID
Type Type of the line. See data type DefRow.
Summary Complete value structure with the summary of the current day, week, month or year
value.
Val_x Complete value structures with individual values (e.g. all day values in the month report).
335
Manual AMS Asset Graphics 5.4
Variable Description
From, To Every line (every dataset of the field) in the table contains for every process variable a
value for a definite time period (e.g.: days in the month report). This period is passed
in the variables From and To, whereby From defines the start and To the end of the
period.
Process variables Complete value structure for every process variable.
Example here: Sample_1
Runtime
Overview
The Operation Log Runtime generates data from the current values of the AMS Asset Graphics database
and saves them in an SQL database.
With this user interface, the stored data can be displayed in form of Day views, Week views, Month views
and Year views.
The data of these views can be changed with manual inputs. The changes are marked and can be made
undone.
Furthermore, a graphic display of the data from the SQL server is possible in a Diagram view.
Via the toolbar or menu File | Open you can open a report view or a diagram view.
Report views
The report views show the operation log data of a defined period in tabular form. Several views can be
opened for one or several reports.
There are 4 types of views: day, week, month and year.
The table shows the each process variable in a separate table line.
The first columns are Description and Unit, followed by the summary with minimum and maximum
values, then followed by special columns:
At a day view the single day values then follow.
At a week view the single day total values then follow.
At a month view the single day total values then follow.
At a year view the 12 month values then follow.
Via the context menu you can open a dialog to enter remarks to each value. These remarks are shown with
a tooltip text and are available in the AMS Asset Graphics Report designer. Cells with remarks are marked
red on the top left corner.
336
Operation Log
Every report view has a special toolbar with the following commands:
Button Description
Date control With this control element you select a date or a date range.
Manual input With this command you can toggle the manual input mode. This mode is available to avoid
mode inadvertent or unauthorized data input. This command can also be found in the context
menu of the table.
Abstract With this command the special columns are switched on and off.
Show single (This command is only available in a day view.)
values With this command you can display the dialog with the single values of a process variable.
Report With this command you can start the AMS Asset Graphics Report designer. The dialog
design Report selection will be opened. Having made the choice of a report, the designer will be
opened.
Report With this command you open the report selection dialog to print or export a report.
output
Remarks With this command you open a dialog to edit the remarks on the current view.
Diagram view
A diagram view displays the data of one or several process variables as a trend chart.
You find the following commands in the toolbar in the upper range of the diagram view:
Button Description
Settings With this command you open dialog Properties diagram. Among other things you define
which process variables shall be displayed.
Print This command prints the current view on the printer.
diagram As alternative to the printer you can export the views in the formats e.g. HTML, PDF, RTF
etc.
Time Opens the dialog Data range and time period.
period
<< 365 and These commands shift the displayed period by one year to the left or to the right.
>> 365
<< 31 and These commands shift the displayed period by one month to the left or to the right.
>> 31
<< 7 and These commands shift the displayed period by one week to the left or to the right.
>> 7
<< 1 and These commands shift the displayed period by one day to the left or to the right.
>> 1
^v2 This command doubles the displayed range in vertical direction.
v^2 This command halves the displayed range in vertical direction.
^^ With this command the displayed range is moved vertically up.
vv With this command the displayed range is moved vertically down.
337
Manual AMS Asset Graphics 5.4
You save the settings of the diagram with the menu commands File | Save or File | Save as.
Dialog Remarks
In this dialog you can edit on the one hand the remarks from the currently displayed day, week, month or
year. In this case in the head of the dialog the report name is shown. If the dialog is opened with the context
menu of the table, the remarks to a value are edited. The associated data-element is shown in the head
area and the cell in the table is marked with a red background color.
Via button Save you close the dialog again.
338
Maintenance
Editor
Introduction
The maintenance module serves the preventive maintenance, for this purpose it compares setpoints and
actual values of the operation intervals. In the maintenance database all maintenances are registered, that
were performed.
With the Maintenance Editor you define the individual maintenance tasks.
Among others, a maintenance task will be defined with the following settings:
Description of the task (e.g. replacement of carbon brush, fan motor)
Designation of the unit (e.g. K_2045_LM)
Definition of the operation hours or the switching cycles until the next maintenance is due.
Data-element for the detection of operation hours or switching cycles.
Operating hours or the switching cycles are evaluated and compared with the preset values. In a table view
the percentage rate of the maintenance intervals, that have already passed, will be displayed. With a
configurable notification-element you can trigger an alarm in the Eventjournal, when reaching a limit value.
It is possible to show information or instructions for every maintenance task. Furthermore, remarks can be
entered for every task.
A executed maintenance will be entered in a special input mask. Date, time, user and all remarks that were
entered, are stored with the maintenance. In a table view all performed maintenances are displayed.
Network mode
When working in network mode, the calculation of runtime data is only made at the master. The
Maintenance Runtimes on stations are only viewer and you can make manual inputs.
When manual inputs on setpoints shall be possible, a write permission on the definition file of the
maintenance (Maintenance.ilH) in the project directory is required.
See also
Maintenance definition window
Dialog Properties Maintenance
Design of the maintenance database
User interface
The Maintenance Editor is designed as MDI-application, this means you can configure the maintenance
settings of several projects at the same time.
See also
General Operation
339
Manual AMS Asset Graphics 5.4
Tab Definition
On this tab you set the parameters for the database connection of the maintenance database.
Option Description
Database
Standard If this option is set, all other edit fields are disabled. Maintenance Runtime uses then the
standard SQL-server instance INVISU_PMS In a network project the database on the Master
is used otherwise the database on the local computer.
Server Name of the SQL-server.
Examples:
’.\inVISU_PMS’ local SQL-server with the instance name inVISU_PMS.
’ServerXY\inVISU_PMS’ SQL-server running on computer ServerXY with the
instance name inVISU_PMS.
Database Name of the database, e.g. Maintenance.
User With this user name is used to log on the database.
Password Password for login.
Tab Print
In this tab you define parameters for printing.
Option Description
Title
Main title Here you enter a name for the maintenance definition. The name can be used within the
report designer, e.g. in the title, for printing.
Subtitle 1 – Beside the main title, another four texts can be entered, which can also be used in the report
4 designer.
Tab Groups
On this tab, the group properties of the maintenance is defined. Up to 100 groups can be defined.
Option Description
Number Group number
Name Name of the group. This name will be shown in the maintenance table.
On tab VBScript you can program special calculations and analyses for the maintenance.
340
Maintenance
Maintenance tasks are configured in the maintenance definition window. The data are presented in a table.
The table is subdivided in tabs whereby tab All presents a summary of the other tabs.
For the description, the designation and the group name, language texts also can be indicated instead of
static texts. The language-element has to be entered with the following syntax: @__TX0003.
To show the contents of the language-element in the editor, select command Display language texts
on/off in the toolbar. Adjust the desired language with Switch language list.
Column Description
Standard
Element Here you have to enter the name of the element, which value shall be used for the
calculation of the actual value.
Description The description of the unit is entered here.
Designation In this column the designation (brief description) of the unit is entered.
Group Select with the right mouse button a group from dialog Group selection or enter the
desired group number.
Note You can change several group at the same time.
Unit Enter here the unit such as e.g. h, ltr etc.
Setpoint In this column, the setpoint for a maintenance is predefined. Depending on the
function, the setpoint is entered as number or as time period. Time periods will be
predefined in hours.
Function Here you enter the function for the computing of the maintenance. You can enter a
function by typing in the function name or select one with the dialog Function selection.
Miscellaneous
Element Same column as in tab Standard of the table.
Overflow If an external operating hour counter or an external pulse counter is defined, an
overflow limit can be defined in this column.
An overflow is detected, when the value of a counter is smaller than the previous
scanned value.
When an overflow occurs the limit will be added internally. Overflow limits are e.g. 255
at an 8-bit-counter or 65535 at a 16-bit-Counter.
If no overflow limit was entered, no evaluation of overflows will be made.
Notification You can enter here a num-element, which can indicate the status of the maintenance
Element and for a device. If the current value is equal or greater than the Limit value (values in
Limit value percent) the element is set on 1, otherwise it has the value 0.
Info text Here you can indicate an additional text (RTF-Format), to be shown during runtime.
There is a possibility, to show an additional explanatory text for every maintenance
line, e.g. maintenance instructions, information on the unit, spare part lists or
manufacturer information. During runtime, this text will be indicated on a separate
display.
In this line you enter the number of the additional text that shall be loaded, when the
maintenance line is selected in the runtime. The text itself is contained in a file with
name IH_INFO_x.RTF, which must be stored in the project directory. At this, the x
corresponds to the current language, i.e. IH_INFO_0.RTF for German or
IH_INFO_1.RTF for English.
The assignment of an additional text to a maintenance line is done with numbers.
Every additional text in the RTF-file will be introduced by a line with designation
##xxxx, whereby xxxx describes the number of the additional text.
341
Manual AMS Asset Graphics 5.4
Column Description
Example for an additional text file:
##1
This is the additional text, which will be shown as additional
text with number 1.
All lines up to the next designation are part of additional text
1.
##3
This is the text, which will be shown as additional text with
number 3.
Edit the additional text with an editor, e.g. WORDPAD.EXE. With WORDPAD it is also
possible to integrate graphics into the additional text.
Def-ID This Def-ID is generated automatically by the program and has a great importance for
the runtime. In the database all data with this ID will be assigned to the corresponding
process variable. Within a table the ID must be unique.
Manual inputs
Element Same column as in tab Standard of the table.
Edit total value With this column you permit the user to change the total value with manual inputs. This
is necessary e.g. at the replacement of components in a plant.
Active, If manual inputs are allowed, this can protected by an access right (P-level). With a
P-level, right-click you can open dialog Access Right to select the right.
Log If you enter a Log level greater 0, the action will be recorded in the activity log.
Edit definition With this column you permit the user to change the definition. When this column was
marked, a new setpoint and a new notification limit can be entered.
Active, If manual inputs are allowed, this can protected by an access right (P-level). With a
P-level, right-click you can open dialog Access Right to select the right.
Log If you enter a Log level greater 0, the action will be recorded in the activity log.
Execute maintenance
P-Level and Log You can protect the execution of the maintenance by an access right (P-level). With a
right-click you can open dialog Access Right to select the right.
If you enter a Log level greater 0, the maintenance action will be recorded in the
activity log.
342
Maintenance
Function Description
_Sum extern This function uses an external counter.
Die Maintenance Runtime uses the element value directly as operation number.
If an overflow limit is defined, the program will follow it.
_Sum intern This function performs an edge detection to increment the operation number.
If the value changes from 0 to 1 (or another value unequal 0), the internal
operation counter will be increased by 1.
_Runtime The runtime function does not require an element as input parameter. The time,
since the first start of the Maintenance Runtime, is used to calculate the
operating time. This function is used at tasks, which have to be performed in
definite time periods (e.g. every 3 months).
_Operating hours extern This function uses an external operating hour counter.
The value is specified in hours. Possibly the value must be scaled in the
Process Assignment or in the OPC Client.
The Maintenance Runtime uses the element value directly as operating hour
counter.
If an overflow limit is defined, the program will follow it.
_Operating hours intern This function uses an element state to calculate the operating hour.
The time, when the element has the value 1, will be measured internally and
then be added to the actual value.
VBScript function With a VBScript function an individual calculation of the actual value is possible
In this entry field you can enter a function name. This function will be called in
the VBScript for the maintenance table (see dialog Properties Maintenance).
The function in the VBScript must have the following syntax:
Sub FunctionName (Value, EleValue, DefID)
End Sub
FunctionName is the placeholder for the function entered in the edit field.
The following parameters are passed to the function:
Value current value and new value at a value assignment within the
function.
EleValue current value of the database-element.
DefID Definition-ID of the current maintenance line.
343
Manual AMS Asset Graphics 5.4
Table EditorDefinition
In this table the information from the definition of the editor are stored.
Column Description Type Length
ID Consecutive table ID. int 4
DefID Unique identification number of the definition line. int 4
Description Description (plain text) of the maintenance task. nvarchar 80
PlantData Designation of the unit. nvarchar 20
GroupID Group number (see table Groups). int 4
Unit Unit for the maintenance task. nvarchar 20
NominalValue Setpoint of the maintenance task. float 8
NotifyLimit Limit value for the notification-element.. tinyint 1
Table Groups
Here you find the Group settings.
Column Description Type Length
GroupID Unique identification number of the group. int 4
Name Group name. nvarchar 50
Table Maintenance
Here you find the actual data of the different maintenance tasks. If definition lines are deleted in the editor,
the relevant data of this table will be deleted at the moment of starting the runtime.
344
Maintenance
Table MaintenanceHistory
In this table you find all performed maintenances. This table grows with every registered maintenance. The
datasets will not be deleted. In general, the number of maintenances, will not lead to disk space problems.
However, if a problem arises, due to many maintenances, the data have to be deleted manually.
Column Description Type Length
MaintenanceHistoryID Consecutive table ID. int 4
DefID Unique identification number of the definition line. int 4
MaintenanceDateTime Date / time, when the maintenance was registered. datetime 8
ActValue Value of the maintenance task at the time of the float 8
maintenance.
NominalValue Setpoint at the time of the maintenance. float 9
TotalValue Total value at the time of the maintenance. float 8
MaintenanceUser User, who has entered the maintenance. nvarchar 32
Station Network station, where the maintenance was entered. smallint 2
Info Information text, edited by the user when entering the nvarchar 3960
maintenance.
Table Settings
In this table you find informations about the database design and the definition of the Maintenance Editor.
Column Description Type Length
ID Consecutive table ID. int 4
Version Version number of the database structure. int 4
InstDefinitionTime Date / time of the last change of definition. datetime 8
Note At the opened report designer, the Help function can be opened with button F1.
Runtime
Maintenance Runtime
With the Maintenance Runtime you can supervise the condition of the maintenance jobs. There are 3
different views, which can respectively be switched on or off.
The Maintenance view displays the current operating times and switching cycles in a table.
In the Maintenance history view you see the performed maintenances.
The Maintenance info view shows an additional text for the currently selected maintenance.
345
Manual AMS Asset Graphics 5.4
See also
Menu commands
Additional information
Remarks for a maintenance job
Executing a maintenance
Edit the total value
Edit setpoints
Commands
In the Maintenance Runtime you can use the following commands.
Menu File
Command Description
Exit With this command you terminate the Maintenance Runtime.
Print The Info view will be printed. However, before this, a dialog for the choice of the printer
will be shown.
Print preview A Print-preview for the current additional info will be displayed.
Printer this command opens dialog Printer settings to select the printer and to define the printer
settings port.
Menu Edit
The menu Edit includes the following commands:
Remarks
Select this command to show or enter the remarks for the current line in the maintenance table. The same
function can be activated with Ctrl+B.
The dialog Remarks will be opened.
The text is displayed in the dialog and can be edited. Via button Save you close the dialog again.
Executing maintenance
Select this command to register a maintenance for the current selected line. The same function can be
activated with Ctrl+W.
The dialog Maintenance on 'xx' will be opened.
In field Remarks you can edit information for the maintenance. With command Maintenance executed the
maintenance will be registered and the dialog closed. Now, the maintenance data will be entered into the
maintenance list with the current time, the current user and the entered remarks. Furthermore, the current
maintenance interval will be reset on 0.
Note In network mode this dialog can only be opened, if the current maintenance line is not being edited on
other station.
346
Maintenance
Edit setpoints
Select this command to change the setpoint value of this definition. Possibly you have to login before this
dialog is opened. The same function can be activated with Ctrl+S.
The dialog Edit setpoints will be opened.
In edit field Setpoint the current setting of the definition is shown. You can enter here a new setpoint.
Edit field Limit value shows the actual message limit, as of which a message will be generated. You can
enter a new message limit here. With OK, the new values will be accepted. The system will work directly
with the new definition data.
Note If the maintenance definition is at the same time opened in the Maintenance Editor, the setpoints will
be overwritten, when the Editor save the definition.
Note In network mode this dialog can only be opened, if the current maintenance line is not being edited on
other station.
Report
The Maintenance and Maintenance history view will be printed using report layouts designed in the AMS
Asset Graphics Report Designer.
After activating command the dialog Print Options appears to change the output device and other options.
The printout is started with command Start.
Menu View
Command Description
Visualization With this command you can bring the visualization to the foreground.
The same function will be activated with button Visualization or with F2.
Maintenance, With this menu commands the Maintenance view, Maintenance Info for Service and
Maintenance Info, the Maintenance history view can be switched on or off.
Maintenance history
Status bar The status bar can be switched on or off.
Refresh At active maintenance views, a command Refresh is available to force a refresh of
the table. This command is also available by F5.
Maintenance views
Maintenance view
In this window, the individual maintenance tasks are displayed in one table. With the toolbar at the top of the
view, the unit of time-dependent maintenance tasks can be switched from hours to days. Furthermore, you
can find a display filter. Besides 'All' you find the filters '> = 80%', '> = 100%' and '> = 120%'.
Column Description
Description In this column, the description of the device is shown.
Designation The plant /type designation of the device is shown.
Unit The physical unit for the setpoint, actual value and total value.
Group Here it is shown to which group the device belongs.
Actual value Actual value since the last maintenance.
% Actual value since the last maintenance in percent of the setpoint.
347
Manual AMS Asset Graphics 5.4
Column Description
Setpoint Planned setpoint for the execution of the maintenance
Total Total operating hours or switching cycles of the device.
The sequence of the individual columns can be configured with the mouse and drag & drop.
Column Description
Description In this column, the description of the maintenance task is shown.
Designation The plant /type designation of the device for the maintenance task is shown.
Unit The physical unit for set value-, actual value and total value.
Group Here it is shown, to which group the maintenance task belongs.
Data at the maintenance time
Date / Time Date and Time when the maintenance was done.
Actual value Actual value at the maintenance time.
% Actual value at the maintenance time in percent of the setpoint value.
Setpoint Setpoint at the maintenance time.
Total Total operating hours or switching cycles of the device at the maintenance time.
User The user who has entered the maintenance.
Station The station number, where the maintenance was performed.
Info Information, that the user has edited when entering the maintenance.
The sequence of the individual columns can be configured with the mouse and drag & drop.
Info view
Activate this view to display the additional information for the current line in the maintenance table. This
function is only available, if also an information text to the current line is stored in RTF-format. The text is
displayed only and cannot be edited. With the menu command File | Print this additional text can be printed.
348
Debugger
Introduction
The debugger offers a user interface, which shows the values of the elements of the AMS Asset Graphics
database during runtime. The user can display and manipulate these elements with the help of the
debugger.
The debugger is a useful instrument to check, even without a connected PLC, how the objects behave with
different values.
It helps as well at the search for problems. In this way, also process values can be shown, which are
normally not visible.
Every debugger document can contain a script.
See also
How to work with the Debugger (Step-by-step instructions)
User Interface
The debugger is designed as MDI application, i.e. several debugger documents can be edited
simultaneously. Every debugger document is shown as table and shows basically the values of data-
elements.
See also
Toolbar Debugger
General operation
Dialog VBScript
You can also use functions OnStart (initialization), OnRun (cyclical) and OnEnd (Debugger document is
closed).
A detailed description of the possible functions can be found in section VBScript.
349
Manual AMS Asset Graphics 5.4
Option Description
Num-elements Here, the information about the num-elements is shown.
Max The maximum possible number of num-elements is shown here.
Current Here you see the current number of used num-elements.
Usage The usage of the database is shown here in percent, with respect to the num-elements.
Text elements Here, the information about the text-elements are shown.
Max The maximum possible number of text-elements is shown here.
Current Here you see the current number of used text-elements.
Usage The usage of the database is shown here in percent, with respect to the text-elements.
Database user The number of the current database users (programs) is shown here.
Table view
Into the tables you enter elements, that you want to supervise or change.
Column Description
Element name Here you have to enter the name of the element, which shall be displayed. You can enter
num- or text-elements. A new element can be inserted, by entering the element name into
column Element name and by defining, whether the element is a num- or a text-element.
Or you click the right mouse button in column Element. In this case the dialog Element
selection will be opened to select the Element.
Value The contents of the data-element is shown here. If the element is not yet opened in the
AMS Asset Graphics database, the message Element not available will appear in this
cell.
If you change a value in a cell, the relevant data-element will be written as soon as the
cell is not in edit mode anymore.
Type Into column Element you can enter num- or text-elements. Click the right mouse button
over this field and select from the dialog NUM (for num-elements) or TXT (for text-
elements).
If you enter the element via dialog Element-selection, the element type will be set
automatically.
350
Debugger
Toolbar Debugger
Command Description
Optimize columns Optimizes the width of the table columns that way, that all columns are visible.
Insert line Inserts a line previous to the selected line.
Delete lines Deletes the currently selected lines.
Edit Script Select this button to open dialog VBScript.
Visualization on top Press this button to set the visualization on top.
Database information Select this button to open dialog Database information.
Always on top Select this command to configure, whether the debugger window shall be shown
always in the foreground, also when another application has the input focus.
Elements
With toolbar Elements the contents of data-elements can be changed comfortably.
The commands effect only selected lines in the table.
Command Description
Increment This command increases the selected elements by the value, entered on the right side.
Decrement This command decreases the selected elements by the value, entered on the left side.
Set This command set the selected elements to the value, entered on the right side.
Create With this command the Debuggers tries to create data-elements in the database. A num-
element element will be assigned value 0, a text-element will be empty.
351
Manual AMS Asset Graphics 5.4
Select the data-element, that you want to test, in this example num-element Silo1.
With the toolbar Elements you can add or subtract the value of the element or set it on a specific
value. The current value of the data-element will be shown in column Contents in the debugger-
window. You can also follow the consequences of your manipulation directly at the object in the
visualization.
If you want to test further elements, repeat the procedure in the next line. It is also possible to
visualize the contents of objects, which are not visible in the visualization.
If you want to repeat the test., save the debugger document before you exit the runtime or the
debugger.
See also
How to work with the Debugger
352
Synchronization
Important
The local data directory is only used by runtime programs.
To ensure a central project administration, editors do always work with the global data directory.
The functionality:
Synchronizing of a project
List of synchronized project files
Synchronizing of programs
List of synchronized program files
Logging
Directories
Further Information:
Set global and local data directory
AMS Asset Graphics directory structure
353
Manual AMS Asset Graphics 5.4
Synchronizing a project
By means of the project synchronization, project files of a (global) source drive will be copied into a (local)
disk drive.
Prerequisite for the project synchronization is a successful access on the directories. Moreover, the write
authority for the local directories must be available.
Operation
Start the program SyncTool (Sync32.exe).
Synchronizing a project will be started with menu item Synchronization --> Project....
After the Selection of a project the progress of the synchronization is shown in the Status dialog.
In the List of synchronized project files the files to be synchronized are documented.
Further Information:
Set global and local data directory
Used file names in projects
Logging
Synchronization of programs
With the program SyncTool (AMS Asset Graphics) program files of a (global) source drive will be copied to a
(local) disk drive.
Prerequisite for the program synchronization is a successful access on the directories. Moreover, the write
authority for the local directories must be available. AMS Asset Graphics programs must not be started from
local program directories.
Using
Start the program SyncTool (Sync32.exe).
The program synchronization will be started via menu command Synchronize | Program.
After the Selection of the directory the progress of the synchronization will be shown in the Status dialog.
In the List of synchronized program files the files to be synchronized are documented.
Further Information:
Set global and local data directory
List of program names and EXE-modules
Logging
354
Synchronization
Logging
SyncTool logs the action carried out in the local data directory in a text file with name
‟Sync_JJJJ_MM_TT.LOG‟ (J=year, M=month, t=day).
If the log-file does not yet exist, it will be generated.
Every log-line starts with the indications Date and time
Used directories
SyncTool opens 2 new subdirectories in the local data directory:
Temp
In this directory, the files to be copied will be stored temporarily, until all files are read from the source.
Having finished copying into the target directory, the files in the Temp-directory will be deleted again.
Sync
In this directory, SyncTool will be started if the program was called up 'manually' (see Synchronizing a
project: Start by the runtime program.
Thus it is possible, that also SyncTool itself can be synchronized at the program synchronization.
In this directory there is also stored file Sync32.ini in which the configuration settings are contained.
Dialogs in Synctool
Info about
This dialog contains general information on the program.
Directory selection
In this dialog the local and global program directories can be defined. The respective data directories will be
used as standard.
If the options Use Global/Local data directory are unmarked, the desired program directory can be
selected freely.
After activation of button OK, it will be checked, whether also AMS Asset Graphics programs are stored in
the global program directory. After that, the program synchronisation will be started.
Further information:
Set global and local data directory
355
Manual AMS Asset Graphics 5.4
Project selection
In this dialog you select a project to be synchronized.
There are only local projects for choice, which are already available. Having made the choice for a project,
the project synchronization will be started automatically.
Note If you want to synchronize a project, that is not stored in the local data directory, you have to create a
subdirectory with the project name in directory Project and start the project synchronization anew.
The synchronization procedure can be interrupted by means of button Cancel. However, copying files from
the temporary directory into the target directory cannot be interrupted.
Note At problems with the network connection, the interruption procedure may take some time.
See also
AMS Asset Graphics directory structure
356
Synchronization
See also
AMS Asset Graphics Directory structure
357
System-elements
Numeric system-elements
With the help of numeric system-elements, the following scope of functions can be covered:
Initialization
Switching off single tasks
Bring to the foreground
System
Visualization
Operation
Eventjournal
Network
Time-dependent system-elements
Textual system-elements
System-elements of type TXT cannot be used as trigger. They may contain texts or control actions,
depending on their contents.
Directory paths
WinExec
WinHelp
Other system-elements
Num-element Description
_Language / With _Language you define the current active language used in the runtime. If
_SystemLanguage _Language has e.g. the value 1, all runtime programs will use the English language.
With _SystemLanguage the system language (texts in menus and dialogs and for
error messages) can be configured independently from _Language. For example,
the runtime language is Chinese (_Language has value 13) and as system language
English is used (_SystemLanguage is set on 1).
_LicenceError With this element, problems at license requests can be recognized. If the license was
recognized correctly, the element has the value 0. _LicenceError changes on 1, if
the dongle was not read correctly for the last 3 hours.
_UserPassword With this system-element, password functions can be started. The element has
notification and control functions.
1 One user is logged in.
0 No user is logged in.
-1 The user will be logged off.
-2 The dialog for the user login is displayed.
-3 A dialog is displayed for the user to change the password.
-4 The list with all users is shown. This function call should be password protected!
359
Manual AMS Asset Graphics 5.4
Num-element Description
_UserExtern The system-element _UserExtern permits to determine a user by means of an
external control (e.g. a key switch). With the value of the element, the user in the
related line of the user table will be logged in, without the need of a special password
request.
Example
If _UserExtern has the value 3, the user will be logged in, whose name is in the 3rd
line of the user tablet.
Text-element Description
_Sound With this system-element a WAV-file, e.g. a particular alarm sound can be played.
With this element, the name of a WAV-file is indicated. After the playing of the sound
was started, the contents will be reset again.
If no explicit directory was indicated, the WAV-file must be stored in the current
project directory.
_UserName This system-element contains the name of the currently logged-in operator (user).
Initialization
The following system-elements will be set during the initialization of runtime programs.
The respective element is set on 1 at the start of the program.
When the program was started successfully and has initialized its data, the element will be set on 0. In an
error case, the program will be terminated and the element is set on -1.
Element Program
_InitBP Operation Log
_InitDBG Debugger
_InitDBT DB-Transfer
_InitDDE DDE
_InitDS Data Storage
_InitEJ Eventjournal
_InitEJDataManager Eventjournal Data Manager
_InitEJViewer Event Viewer
_InitIH Maintenance
_InitLOG Activity Log Viewer
_InitMP Network (Master/Station)
_InitOD ODBC
_InitOPC OPC Client
_InitPZ Process Assignment
_InitRZ Recipe
_InitVI Visualization
360
System-elements
Element Program
_SuspendBP Operating Log
_SuspendDS Data Storage
_SuspendEJ Eventjournal
_SuspendIH Maintenance
_SuspendMP Network connection
_SuspendPZ Process assignment
An active telegram still is finished, after that no new telegram is started.
_SuspendVI Visualization
_SetTopBP_OpenView
The text-element _SetTopBP_OpenView is used to activate the Operation Log Runtime and additionally
open a view.
The text-element is evaluated as follows:
Type; ReportName; Date
In place of type one can use day, week, month or year. ReportName is a substitute for the name of the
definition file (without file extension). The date is optionally and can be used to open a special day, week,
month or year. If no date is attached the current system date is used. After the text element is evaluated, the
contents from the text element is deleted.
_SetTopEJViewer_OpenView
The text-element _SetTopEJViewer_OpenView is used to activate the Event Viewer and additionally open
a view.
The text-element is evaluated as follows:
Type;Name
In place of Type one can use ONLINE or HISTORY. Name is a substitute for the name of the definition file
(without file extension).
361
Manual AMS Asset Graphics 5.4
_SetTopIH_OpenView
The text-element _SetTopIH_OpenView is used to activate the Maintenance Runtime and additionally open
a view.
The text-element is evaluated as follows:
Type
In place of Type one can use MAINTENANCE, HISTORY or INFO.
See also
Calling the Eventjournal Runtime
Change automatically into the Eventjournal in case of an alarm
System
Element Description
_SystemCounter Will be incremented at every program run (default: 500 ms).
_SystemStart Notification-trigger for the program start. When starting the runtime, _SystemStart will
be set on 1. After all programs were started, _SystemStart will be set on 2 as indication,
that all programs are started.
_SystemStop Control-trigger for program end. If _SystemStop has a value unequal to 0, all runtime
programs will be terminated.
See also
Closing the runtime
Visualization
Num-element Description
_Hardcopy If this element is toggled, a hardcopy will be printed on the standard printer. During
the printout, the element has the value –1. When the printout is completed, it will be
reset on 0.
_PrePic Control-trigger, which causes the change to the previous picture.
_PicPosX, Indicates the upper-left position of the drawing area of the visualization window in
_PicPosY screen coordinates.
_PicSizeX, Indicates the width and height in pixel of the current drawing area.
_PicSizeY
_ScreenSizeX, Indicates the size in pixel of the current screen resolution.
_ScreenSizeY
_ViDynFontFactor With this element you can set a global factor for the height of dynamically calculated
fonts.
This applies to the objects Button, Text and Number, if they don't use project fonts.
Sample: Set the element on 0.8 for a height of 80%.
_ViFontset Defines the current font. Possible values are 0 (default value) and 1...4 for the font
sets 1 to 4.
362
System-elements
Text- Description
element
_ActPic Contains the name of the currently displayed picture.
_NewPic Controls the switch from one picture in another. For example, buttons can be configured that
way, that they set _NewPic with the name of the desired picture and therefore effect a
picture switch.
See also
Changing to another picture
Operation
Element Description
_F1 - _F12 The system-elements _F1 to _F12 will be toggled, if the corresponding function key was
pressed. This applies also, if the function key was pressed in combination with a control key
(CTRL, ALT, SHIFT).
_Input Will be changed, if e.g. data-element are changed by the Data input, a function key, a text-
button or a graphic button.
_InputActive Will be 1, if the data input is active, and 0, if the data input is inactive.
_InputStart, By toggling this num-elements, the data input will be started or stopped (same function as
_InputStop the configured data input key combination for start / stop).
Eventjournal
Num-element Description
_AlarmChanged This element does always change its state, when an event is coming or going.
_AlarmCome Will be set on 1, if an event occurs and will be reset on 0 by calling up the Eventjournal
(notification-trigger).
_AlarmExist Will be set on 1 at every coming alarm.
Note The element will not be set again on 0 by the system, this can be defined
by the user itself e.g. in a script. _AlarmExist offers the option to recognize
new alarms and to start actions with that.
_AlarmGone Will be set on 1, if an event disappears and will be reset on 0 , when the Eventjournal
Runtime gets the input focus.
_AlarmListFilling Indicates the current filling rate of the Eventjournal in % (at 52 entries in the
Eventjournal and with a maximum number of 1000 entries, _AlrmListFilling has the
value 5,2).
Text-element
_AlarmText Contains the message of the event at last entered in the Eventjournal.
See also
Display an event in one line of the visualization window
363
Manual AMS Asset Graphics 5.4
Only relevant for 'old' projects, if they are storing historical event data in MDB files:
Num-element Description
_AlarmHistoryError If an error occurs upon writing of historical alarms, the error value will be set in
this element. When the value is 0, no error is existent. When starting the
program, the Eventjournal will set this element on 0. During runtime, the
element will only be set at the appearance of an error. Thus it always contains
the last Error. System errors have an offset of 100.000.
_AlarmHistoryJoinStart Control-trigger, which starts the summary of the daily databases to one
common database.
_AlarmHistoryJoinReady Notification-trigger, which indicates a successful summary of the daily
databases.
_AlarmHistoryJoinDays Number of days, which data shall be included in the summary (max 731 days).
_AlarmHistoryJoinError Error element for the error analysis.
The element will be set on 0 at the beginning of the summary. At a faultless
execution of the summary, the element will keep value 0.
In case of an error, the element will be set on one of the following values:
23001 Number of days in Element _AlarmHistoryJoinDays is 0
23002 Old database could not be deleted. (Possibly the database is opened
externally)
23003 Error when opening the database
23004 Error when opening the current daily database
23005 Error when opening the database
23006 Error at opening the table
23007 Error at opening a daily database
System errors will be displayed with an offset of 100.000.
Text-element
_AlarmHistoryErrorText Contains the error text (if available) of the last error in the Eventjournal when
writing historical alarms. Will be set with an empty string at the moment of
starting the journal.
See also
Historical alarms
Network
Num-element Description
_MPStation This element is set on the current station number, thereby the 0 indicates
the network master.
The following num-elements provide information on the network status in the redundancy mode:
_RddIsPrimaryMaster The primary master sets the element on 1, otherwise the element has the
value 0.
_RddIsSecondaryMaster The secondary master sets the element on 1, otherwise the element has the
value 0.
364
System-elements
Num-element Description
_RddPrimaryMasterState Provides information on the status of the primary master:
0 Status unknown (master does not run).
1 master runs in standby-mode (is ready, but not active).
2 Master is active.
3 and 4 these states appear during a change of the active master.
_RddSecondaryMasterState Provides information on the status of the secondary master. Status values
such as _RddPrimaryMasterState.
_RddConnectedStatNr Contains the current number of connected stations.
_RddMasterCheckTime Shows the time difference to the last valid communication with the partner-
master. (5 indicates e.g., that since 5 seconds no communication with the
partner-master has taken place).
Text-element
_MPStationName This element will be set on that station name, which was defined in the
Network Editor.
With the system-element _RddSetMaster the active master can be changed manually:
1: The primary master shall become active master.
2: The secondary master shall become active master.
After a switch over to another master, the element will again be set on 0.
The master switch over can be made on every computer (also by the master in the standby-modus).
Time-dependent system-elements
There are different system-elements available, which (when used as control-trigger) can start periodic
actions. They differ by the time period between the changes.
Num-element Description
_Ms500 Current 500ms-value, i.e. the value changes every 500 millisecond. Range 0..119
_Sec01 Current second, i.e. the value changes every second. Range 0..59
_Sec02 Current second divided by 2, i.e. the value changes every 2 seconds. Range 0..29
_Sec03 Current second divided by 3, i.e. the value changes every 3 seconds. Range 0..19
_Sec04 Current second divided by 4, i.e. the value changes every 4 seconds. Range 0..14
_Sec05 Current second divided by 5, i.e. the value changes every 5 seconds. Range 0..11
_Sec10 Current second divided by 10, i.e. the value changes every 10 seconds. Range 0..5
_Sec15 Current second divided by 15, i.e. the value changes every 15 seconds. Range 0..3
_Sec30 Current second divided by 30, i.e. the value changes every 30 seconds. Range 0..1
_Min01 Current minute, i.e. the value changes every minute. Range 0..59
_Min02 Current minute divided by 2, i.e. the value changes every 2 minutes. Range 0..29
_Min03 Current minute divided by 3, i.e. the value changes every 3 minutes. Range 0..19
_Min04 Current minute divided by 4, i.e. the value changes every 4 minutes. Range 0..14
_Min05 Current minute divided by 5, i.e. the value changes every 5 minutes. Range 0..11
_Min10 Current minute divided by 10, i.e. the value changes every 10 minutes. Range 0..5
_Min15 Current minute divided by 15, i.e. the value changes every 15 minutes. Range 0..3
365
Manual AMS Asset Graphics 5.4
Num-element Description
_Min30 Current minute divided by 30, i.e. the value changes every 30 minutes. Range 0..1
_Hour01 Current hour, i.e. the value changes every hour. Range 0..23.
_Hour02 Current hour divided by 2, i.e. the value changes every 2 hours. Range 0..11
_Hour03 Current hour divided by 3, i.e. the value changes every 3 hours. Range 0..7
_Hour04 Current hour divided by 4, i.e. the value changes every 4 hours. Range 0..5
_Hour06 Current hour divided by 6, i.e. the value changes every 6 hours. Range 0..3
_Hour08 Current hour divided by 8, i.e. the value changes every 8 hours. Range 0..2
_Hour12 Current hour divided by 12, i.e. the value changes every 12 hours. Range 0..1
_Day Current day, i.e. the value changes once per day (at the change of the day).
_DayOfWeek Current day of the week, i.e. the value changes from Monday to Sunday from 1 to 7.
_Week Current week, i.e. the value changes once per week (at the change of the week).
_Month Current month, i.e. the value changes once per month (at the change of the month).
Range 1..12
_Year Current year, i.e. the value changes every year (at the change of the year). Sample:
2006
_SecOfDate Contains the number of seconds since the 1.1.1980 for 00:00:00h of the current day.
_SecOfDateTime Contains the number of seconds since the 1.1.1980.
_SecOfDay Contains the number of seconds since 00:00:00h of the current day. Range 0..86399
The format of the following text-elements depends on the regional options for date and time (configured in
the operation system).
Text-element Description
_DateStr, Contains the current date as text in the format, which is configured as regional option
_DateStrLong Short date, z.B. 03/24/07 (format: US English). Thus the current date can be
shown.
_DateStrLong is accordingly the Long date, e.g. 24.03.2007 (format: German).
_TimeStr Contains the current time.. Thus the current time can be shown.
Sample: 08:44:38 (format: US English)
See also
Displaying the current time
_TimeDateStrLong Contains the current time and the date in the format Time Date. Thus the current
date and time can be shown.
Sample: 08:44:08 02/24/2007 (format: US English).
Directory paths
Text-element Description
_DataStoringPath This element contains the directory, where the data storage files will be stored, e.g.
D:\AMS Asset Graphics\Project\Waterworks\DS.
_ProjectName This element contains the current project names, e.g. Waterworks.
366
System-elements
Text-element Description
_ProjectPath This element contains the current project directory, e.g. D:\AMS Asset
Graphics\Project\Waterworks.
_ProjectPathLocal This element contains the current local project directory. If no local project directory
was defined, the contents is identical with the contents of _ProjectPath.
_RecipePath This element contains the directory, where the recipe groups are created (as sub
directories), e.g. D:\AMS Asset Graphics\Project\Waterworks\RC.
_WinExec
With the text-element _WinExec it is possible to start application programs.
If the file name (incl. directory) contains a blank, the file name (incl. directory) must be enclosed in
apostrophe (see Example 2).
The display options are ‚suggestions‟ at the start of the program, which may also be ignored.
After a successful start, _WinExec will have the content "'Program name' started".
After an unsuccessful start, _WinExec will have the text "'Program name' not started. Error:
number!".
Note It is not checked, whether an instance of the program has already been started.
367
Manual AMS Asset Graphics 5.4
_WinHelp
With the text-element _WinHelp, an Help file can be called. Other text-elements may also be used as
variables in the text.
Principle structure: Help file [Help command] [data]
Example: basis.hlp 1 3
If no command is predefined explicitly, the command HELP_CONTENTS will be used per default.
The following Help commands are supported:
368
VBScript
Introduction VBScript
What is VBScript?
Microsoft® Visual BASIC® Scripting edition, a subset of the programming language Microsoft® Visual
BASIC®, is a fast and small interpreter. It can also be found in World Wide Web-Browsers and other
applications, which use Microsoft® ActiveX®-control elements, automation server as well as Java-applets.
Tab VBScript
Access to data-elements
Standard functions
Using COM objects
VBScript examples
VBScript debugging
Global functions
Note Calling the VBScript functions MsgBox and InputBox is not possible.
Graphic Editor
Dynamic standard properties like position, size and color are configured in dialogs.. Special functionality
can be defined in VBScript.
A picture script is called as long as the picture is used.
The project script is always called periodically.
Modify a graphic object by using a script
Create a script for a picture
Modify the project properties in the Graphic Editor with a script
Process Assignment
Create a script for a driver profile
Create a script for a process assignment table
Debugger
Create a script in the debugger
369
Manual AMS Asset Graphics 5.4
Tab VBScript
In this dialog, Visual BASIC script code (VBScript Code) can be entered.
Central component of the dialog is a text window for editing the script.
VBScript-keywords will be highlighted in colors.
The script will only be accepted (i.e. the dialog can only be terminated), when the syntax of the VBScript is
correct. In case of an error, an error message will be output. After confirmation of the message, the text
pointer is set on the error position.
See also
Context menu when editing VBScript
Dialog Search
With this dialog the text can be searched for specific phrases. When the search string was found, it will be
selected in the text. Otherwise a message will be output that the text could not be found.
In the following table the individual dialog elements are described.
Dialog element Description
Search for Enter here the search string, which you want to search in the text. The pull-down list
contains all text strings, that you already have entered.
Match whole Only those words will be selected, which completely match with the search string.
word only
Match case When set, the searching is case sensitive.
Direction Up / Defines the search direction.
Down
Find next The search operation is started and the dialog be closed.
Cancel The dialog will be closed.
Dialog Replace
With this dialog, the text can be searched for specific text and automatically be replaced. When the search
string was found in the text, it will be replaced. Otherwise a message will be output that the text could not
be found.
In the following table the individual dialog elements are described:
Dialog element Description
Search for Enter here the search string, which you want to search in the text. The pull-down list
contains all text strings, that you already have entered.
Replace with Enter the text, that shall replace the found text strings.
370
VBScript
Dialog Go to
With this dialog it is possible to jump directly on a line in the text. Enter the desired line press OK.
With the right mouse you activate a context menu. The individual commands have the following functions:
Command Function
Num-element / After an element was selected, VBScript source text will be inserted automatically at
Text-element the current position for the declaration of the variables.
Functions By means of functions OnStart, OnRun and OnEnd, source text for this standard-
functions will automatically be inserted at the current text position.
Undo To undo an edit.
Redo To redo an edit.
Cut The highlighted text is removed and inserted into the clipboard.
Copy The highlighted text is copied into the clipboard.
Paste If text is stored in the clipboard, this text will be inserted at the current cursor position.
If a text range is selected, this text will be replaced by the text from the clipboard.
Select all The complete text will be selected.
Find... Open dialog Search.
Find next Repeat last search (in direction End).
Find previous Repeat last search (in direction Start).
Replace... Open dialog Replace
Go to line... Open dialog Go to
Go to last change The cursor will be placed at the position of the last change.
Change case
Upper case All characters of the highlighted range will be replaced by capital letters.
371
Manual AMS Asset Graphics 5.4
Command Function
Lower case All characters of the highlighted range will all be replaced by small letters.
Capitalize At all words of the highlighted range, the first character of each word will be set to
upper case, the other characters of the words will remain in small letters.
Invert case Small characters of the highlighted part will be changed to capital letters, capital
letters will be inverted to small letters.
Auto complete The word, just begun, will be completed automatically. At this, the text will be scanned
for words, that start with the characters, already entered. If there is a word, that starts
with these characters, the started word will be completed.
Match bracket If the cursor is placed next to a bracket ( ), the accompanying bracket for this
command will be searched and the cursor placed there.
Bookmarks
Toggle bookmark For every line, a bookmark can be defined. With this command you can switch on or
off the bookmark for the current line. When leaving tab VBScript, all bookmarks will be
switched off.
Next bookmark The cursor will be placed in the line with the next bookmark. If in the text below there
is no more bookmark, the 1. bookmark will be activated.
Previous The cursor will be placed in the line with the previous bookmark. If in the text above
bookmark there is no more bookmark, the last bookmark will be activated.
Clear all All bookmarks will be cleared.
bookmarks
Access to data-elements
The access to data-elements is made in VBScript (Visual BASIC Script) via the automation interfaces
PMS.NumEle and PMS.TxtEle.
You create an instance (an object of this class) for the PMS.NumEle class with the following instruction.
Set Num1 = CreateObject("PMS.NumEle")
Num1 is now a VBScript-variable for access a data-element. The function SetName defines which data-
element shall address by the VBScript-variable.
Num1.SetName("Num1")
372
VBScript
Property/function Description
IsChanged This function provides the information, whether the data-element has changed since
the last call of this function. In case of a change, this function returns a 1, otherwise
a 0.
After the variable was initialized with function SetName, the first time this function
will always return a 1.
The return value must be evaluated or assigned to a VBScript variable, since
otherwise a runtime error arises in the VBScript Engine.
Example:
Dummy = Num1.IsChanged
Function Description
OnStart This function is called at the beginning. In this function often variables are initialized.
OnRun This function will be called cyclically (once in the update cycle).
OnEnd At the end, this function is called once.
The body for standard functions can be generated comfortably via the Context menu.
Example
The lifetime of a picture lasts as long as it is shown in the runtime. When the picture is displayed the function
OnStart will be called once in the picture script. As long as the picture is shown, the OnRun-function will be
called cyclically. Before changing to another picture, the OnEnd-function is called once.
See also
Examples for standard function
373
Manual AMS Asset Graphics 5.4
Standard functions are called synchronously. However, at some functions of COM-objects, the synchronous
call is disabled. By means of function DoAsyncCall, an asynchronous function call of the subroutine
OnAsyncCall will be made. In subroutine OnAsyncCall the asynchronous function calls can then be
executed.
DoAsyncCall and OnAsyncCall have no arguments.
Example:
In the Example above, a form can be printed with Word. The form is stored in the project directory.
374
VBScript
There are two possibilities to access on COM objects within the Scripts. For the first, VBScript Standard
offers two functions for the generation of COM objects (CreateObject and GetObject). A description to
these functions can be found in the VBScript help file.
The other possibility is function HostCreateObject. This function is an AMS Asset Graphics specific
extension for the VBScript language. Contrary to the VBScript standard, it permits to use also the events of
the COM objects. Events are triggered by the COM objects itself.
Arguments
Server name The name of the application, which provides the object.
Class name The type or the class of the object to be generated.
ObjName With this name, you can address the object. At Event handler functions this name must be
prefixed with a ‟_‟.
In order to evaluate the events of the COM objects, the function must be written at the start of the source
code in the global context (outside of a function or subroutine).
Example
HostCreateObject "InternetExplorer.Application", "IExplorer"
Sub OnStart
IExplorer.visible = 1
IExplorer.navigate "http://www.epro.de/ "
End Sub
Sub OnEnd
IExplorer.Quit
End Sub
In the example above, an Internet Explorer object will be generated and registered under the name
IExplorer.
In the subroutine OnStart the Internet Explorer will be brought into the foreground (visible = 1) and an
internet page is called (navigate "http://www.epro.de").
At every changeover of a page within the explorer, the Event NavigateComplete2 will be triggered. By
means of subroutine IExplorer_NavigateComplete2, the event will be read and evaluated from the Script.
Here, the new URL will be connected to a text-element.
375
Manual AMS Asset Graphics 5.4
IncludeSource
This function includes a VBScript source file into the current script. It is useful to reuse library functions or
classes.
The function is defined as follows:
IncludeSource (SourceFile)
SourceFile File name of the VBScript source file. If there is no path declaration in SourceFile , the file
will be opened in the global project directory.
Example:
IncludeSource "Ini.vbs"
AddLogMessage
This function inserts entries in the activity log.
The function is defined as follows:
AddLogMessage (LogLevel, LogID, LogText)
LogLevel Log level; must be between 0 and 99.
LogID ID of the log message; must be between 1000 and 9999.
LogText Text of the log message.
The function returns a 1, when the log entry could be made, otherwise a 0 will be returned.
Example:
AddLogMessage 21, 1401, "This is a message"
HasActUserTheRight
By means of this function it can be requested, whether the user, actually logged in, has got a specific access
authority.
The function is defined as follows:
HasActUserTheRight (Right)
Right The requested right (password level); must be between 0 and 99.
The function returns a 1, if the user has the requested access right, otherwise a 0 will be returned.
Example:
Function TextValue
if (HasActUserTheRight(10)) then
TextValue = "Der Benutzer hat Sonderrechte!"
else
TextValue = ""
end if
End Function
376
VBScript
PmsFormatDateTime
This functions formats a time string.
The function is defined as follows:
PmsFormatdateTime (Format, Date)
Format Is the format-control string (see Formatting codes for date and time).
Date The date.
The function returns the formatted time string.
Example:
PmsFormatDateTime("%Y-%m-%d %H:%M:%S", Now)
' Output: 2007-01-24 08:14:38
PmsUtcDateTime2Local
This functions transforms a UTC time to a local time.
The function is defined as follows:
PmsUtcDateTime2Local (UtcDate)
UtcDate Time in the UTC format.
The functions returns the local time.
PmsLocalDateTime2Utc
This functions transforms a local time to a UTC time.
The function is defined as follows:
PmsLocalDateTime2Utc (LocalDate)
LocalDate The local time.
The functions returns the UTC time.
Debugging
There are two prerequisites if you want to debug VBScript code.
On the one hand, the debugging function has to be activated in the Project Manager in menu Options.
Moreover, you need a script debugger. Under the address
http://msdn.microsoft.com/scripting/default.htm Microsoft offers a Script debugger free of
charge. However, you may use any other script debugger.
When the script debugger has been installed and the option Debugging active is set in the Project
Manager, you can start debugging as follows:
377
Manual AMS Asset Graphics 5.4
Further information for debugging be found in the help function of the Script debugger.
Now DSF represents a VBScript variable to access a data storage file. The function Open is used to open
a data storage file.
DSF.Open("DSTable1")
Use the AddReadItem function to specify the read elements after opening. The Update function executes
the reading of the data storing file. The same time stamp applies to all read elements.
DSF.AddReadItem("SetPoint")
DSF.AddReadItem("CurrentValue")
DSF.Update
After the Update function is finished the functions GetTimeValues and GetValues return an array for the
date. All read elements of one row refer to the appropriate value in the date array.
Times = DSF.GetTimeValues()
Values = DSF.GetValues("CurrentValue")
378
VBScript
Name Description
Properties
TimeFilterFrom, These properties define the lower and upper range (type Date) of the
TimeFilterTo datasets.
NewestTime, After calling Update, these properties store the time stamp from the
OldestTime newest and oldest dataset in the date storage file.
Count After calling Update, this property stores the number of returned
datasets.
ElementInfo.Count After calling Open, this property stores the number of variables of the
data storage file.
ElementInfo.Name ElementInfo.Name is an array with the variable names of the data
storage file. Index starts with 0 and must be less than
ElementInfo.Count.
ElementInfo.Type ElementInfo.Type is an array with type information to the variables of
the data storage file. Index starts with 0 and must be less than
ElementInfo.Count. Numerical variables return a 0 and text variables
return 1.
Example:
Set DSF = CreateObject("PMS.DataStoringFile")
DSF.Open("DSTable1")
DSF.AddReadItem("SetPoint")
DSF.AddReadItem("CurrentValue")
DSF.TimeFilterTo = Now
DSF.TimeFilterFrom = DSF.TimeFilterTo - 5/1440
DSF.Update
Dim Times
Dim ValArr_1
Dim ValArr_2
Times = DSF.GetTimeValues
ValArr_1 = DSF.GetValues("SetPoint")
ValArr_2 = DSF.GetValues("CurrentValue")
...
Using
VBScript Examples
Access to a num-element
'***********Access to a num-element**********
Dim Num1 'This line is optional
Set Num1 = CreateObject("PMS.NumEle")
Num1.SetName("Num1")
Num1.Value = 5
a = Num1.Value
379
Manual AMS Asset Graphics 5.4
Access to a text-element
'***********Access to a text-element*******************
Dim Txt1 'This line is optional
Set Txt1 = CreateObject("PMS.TxtEle")
Txt1.SetName("Txt1")
Txt1.Value = "Main"
t = Txt1.Value
Sub DoAenderung
If ele1.IsChanged Then
ele2.Toggle
End If
End Sub
' Initialization
Sub OnStart
X_Position.Value = 8
End Sub
380
VBScript
381
Manual AMS Asset Graphics 5.4
The standard function OnStart will be called up once at the beginning of the script. In this function
you have to assign the variable Silo1 another value. In the example, Silo1 will be divided by 100.
382
VBScript
The standard function OnStart will be called once at the beginning of the script. In this function
you have to assign the variable to the initialization values.
383
Manual AMS Asset Graphics 5.4
Function OnSendStart will be called before sending the table. Check in this function, whether the
valves vent_zul_silo1 and vent_zul_silo2 are closed.
384
VBScript
Function OnStart will be called once, when the driver profile is created. In this function you have
to assign the variable to the initialization values.
385
Manual AMS Asset Graphics 5.4
Function OnRun will be called cyclically, independently from the fact, whether the profile is
activated or deactivated. Assign here other values to the variables. In the example, they will be
increased cyclically by 1 and reset to their initial value, when reaching the constant limit value.
Confirm the dialog with OK, close the dialog Driver profiles and save your changes.
386
VBScript
387
inVISU 2.5 to PMS Editor
Introduction
The inVISU 2.5 to PMS Editor (DB-transfer) serves the connection of inVISU 2.5 projects to AMS Asset
Graphics. The DB-transfer coordinates the data items between the two systems. By means of the AMS
Asset Graphics DB-Transfer-Editor, the exchange elements and the inVISU-2.5-project to be coupled can be
defined and stored in an assignment file. The runtime tasks of both systems (TDB32, TDB16) read the
assignment file and arrange an exchange of the configured data items with the respective system clock.
The inVISU 2.5 to AMS Asset Graphics Editor offers a user interface, by means of whose help, an
assignment file will be generated. In this file, the AMS Asset Graphics elements are assigned to inVISU 2.5
elements and vice versa. The choice of the elements will be relieved by choosing the path of inVISU 2.5 and
of the project, to make selections from the Reference lists.
See also
DB-Transfer-Table-window
Runtime
The runtime consists of a 32-bit runtime task for AMS Asset Graphics (TDBT32.EXE), a 16-bit runtime task
for inVISU 2.5 (TDBT16.EXE) and a 32-Bit-coupling-DLL (InvDBT32.DLL).
Program start
For the program start of the DB-transfer, the runtime programs (TDB32 and TDB16) must have been
entered in the respective program list of the projects to be coupled. In addition, the runtime of the inVISU 2.5
project (LZ.EXE) should be included in the AMS Asset Graphics program list.
See also Dialog Runtime configuration in the Project Manager
Attention Take care, that program DB-transfer is started before starting the LZ 2.5.
Program stop
To stop the runtimes of both systems, set the checkbox System stop in the dialog Select projects. If one of
the both system-elements _SystemStop (AMS Asset Graphics) or _PrStop (inVISU 2.5) is set in order to
stop the runtime, it will be transmitted to the other system and both systems will be stopped.
Accompanying system-elements
The Data base-transfer has got several system-elements in both systems.
inVISU 2.5
Element name Description
_DBTErr Indicates, whether the DB-transfer has noticed an error during the last action.
0 no error
1 error
_DBTErCt Counter of the errors that have occurred.
389
Manual AMS Asset Graphics 5.4
Column Description
AMS Asset Enter here the AMS Asset Graphics element. If you click with the right mouse button
Graphics Element on this field, you can select the element name from the AMS Asset Graphics
reference list.
inVISU 2.5 Enter here the inVISU-2.5 element. If you click with the right mouse button on this
Element field, you can select the element name from the inVISU 2.5 reference list.
Description Enter here a description to explain the element, e.g. where it is used, what is the
value range of it etc.
Type Into column Element you can enter num- or text-elements. Click the right mouse
button over this field and select from dialog Select type.
Note You can also mark and change several cells simultaneously. For this, click with
the right mouse button on one of the highlighted cells.
The prefix may be defined differently for AMS Asset Graphics and for inVISU 2.5.
Function Description
Prefix Enter here up to 4 characters. At an element selection from AMS Asset Graphics, these
PMS characters are put in front of the inVISU 2.5 element name.
Prefix 2.5 Enter here up to 8 characters. At an element selection from inVISU 2.5, these characters are
put in front of the AMS Asset Graphics element name.
Note You can only access on the reference list of the inVISU-2.5-project, when the relevant project was
selected previously (see Dialog Select projects).
390
inVISU 2.5 to PMS Editor
Function Description
Path Select here the inVISU-2.5 data directory a. Click button Browse on the right of the entry
field, to select the directory, or enter it manually.
Project After you have entered the data directory, the inVISU-2.5-projects will be shown here.
Select a project, to have access on the inVISU-2.5-reference list when selecting an element.
SystemStop Activate this option, to stop both systems – AMS Asset Graphics and inVISU 2.5 –
simultaneously.
If one of the both system-elements _SystemStop (AMS Asset Graphics) or _PrStop
(inVISU 2.5) is set, in order to stop the runtime, it will be transmitted to the other system and
both systems will be stopped.
Option Description
Data Here you select with data type Num the indication of the reference list for num-elements and
type with data type Text the indication of the reference list for text-elements.
Number The number of data items of the inVISU 2.5 project is shown here.
Select in the left column the desired element name and confirm the dialog with OK.
Function Description
Indicating Enter a num-element, which reports an appearing communication error with value 1. If no
element error occurs, the value of the element is 0.
Counter Enter a num-element, which counts the communication errors here. In case an error is
detected, this counter will be increased by 1.
391
Database interface
See also
Directory structure
Files of the database interface
Connection via C++
Connection via the automation server
393
Manual AMS Asset Graphics 5.4
Automation Server
The file InvDBServer32.tlb is enclosed.
It describes the object, which are provided by the AMS Asset Graphics automation server.
It can be imported by every program, that is capable for automation.
Automation
Possible Problems
When accessing on InvDbServer32 you could possibly get error message 70 "Access denied", depending
on the configuration of the operating system. The problem is caused by an access restriction defined in the
operating system.
To troubleshoot the problem with Windows 2000 you have to proceed as follows:
1. Start program DCOMCNFG.EXE (as Administrator).
2. On page Standard security, click button Edit Default for the Default Access Permissions.
3. If not available you have to add user INTERACTIVE in the following dialog.
4. Enter the access right Access Permission for user INTERACTIVE.
5. After a restart of the operating system the access on InvDbServer32 should now be possible.
To troubleshoot the problem with Windows XP / Server 2003 you have to proceed as follows:
1. Start program DCOMCNFG.EXE (as Administrator).
2. Select menu item Properties with the right mouse button, in the tree view in field Component
Services -> Computer -> My Computer. Click button Edit Default on page Default COM Security for
the Access Permissions.
3. If not available, you have to add user INTERACTIVE in the following dialog.
4. Set the right Access Permission for user INTERACTIVE.
5. After a restart of the operating system the access on InvDbServer32 should now be possible.
See also
Creating an application with the automation server
394
Database interface
Example User_Program_VB
We have added a Visual BASIC 6.0 the User_Program_VB application as example for an application
program with data access via the automation server. In this example the operation principle of the objects
and the methods of the automation server are realized. In addition, the update message of the program is
used to show the current value of data-elements.
Function Timer1
The function processes the cyclical tasks of the program. The timer-function is activated by the update
message and switches off automatically.
' Timer function to make automation calls in the WindowProc function
Private Sub Timer1_Timer()
Timer1.Enabled = False ' Disable the timer
395
Manual AMS Asset Graphics 5.4
Open Database
In a Visual BASIC program the database can be opened in the Form_Load procedure of the dialog.
' Procedure is called when the window started
Private Sub Form_Load()
bOk = InitUserVB.SetName("InitUserVB", True) ' Set the Name of the Object
and make a creation
InitUserVB.SetValue (1) ' Tell the System the User-Program is initialise
InitUserVB.SetValue (0) ' Tell the system the user program is initialized
End Sub
Close Database
In a Visual BASIC program, the database can be closed in the Form_Unload procedure of the dialog.
' Procedure is called when the window is destroyed
Private Sub Form_Unload(Cancel As Integer)
' If Initialization is not ready and your program stops
If (InitUserVB.GetValue() = 1) Then
InitUserVB.SetValue (-1) ' set the data-element to -1 so that the
runtime
' recognizes an error
End If
396
Database interface
397
Manual AMS Asset Graphics 5.4
The following objects can be opened with the database interface after integration of the TLB file.
InvDBServer32.DBConnectServer
With this object the message connection to the database is realized.
Methods
Name Description
Open Registration to the AMS Asset Graphics database. The parameter hWnd must be a valid
(HWND:long) window handle.
Returns true, if the function call was successful.
Close() Disconnects from the database.
Returns true, if the function call was successful.
InvDBServer32.NumEleServer
This object corresponds to a num-element in the database. It can be created, changed or read.
Methods
Name Description
procedure Toggle Increases the object value by 1.
function GetName Returns the name of the object on EleName and as return value.
(EleName:string)
function Returns the length of the name.
GetNameLength
function SetName Sets the name of the element. If Create is true and the element doesn't exist, it
(EleName:string, will be created.
Create:boolean) Returns true, if the function call was successful.
function Exist Returns true, if the object exists in the database.
398
Database interface
Name Description
function IsChanged Returns true, if the object has changed.
(Clear:boolean) Clear defines, if the change flag shall be cleared after the function call.
function SetChange Sets the object as changed. Returns true, if the function call was successful.
function SetValue Sets the value of the object. Returns true, if the function call was successful.
(Value:double)
function GetValue Returns the current value of the object.
InvDBServer32.TxtEleServer
This object corresponds to a text-element in the database. It can be created, changed or read.
Methods
Name Description
function GetName Returns the name of the object on EleName and as return value.
(EleName: string)
function Returns the length of the name.
GetNameLength
function SetName Sets the name of the element. If Create is true and the element doesn't exist, it
(EleName:string, will be created.
Create:boolean) Returns true, if the function call was successful.
function Exist Returns true, if the object exists in the database.
function IsChanged Returns true, if the object has changed.
(Clear:boolean) Clear defines, if the change flag shall be cleared after the function call.
function SetChange Sets the object as changed. Returns true, if the function call was successful.
function SetValue Sets the value of the object. Returns true, if the function call was successful.
(Value:string)
function GetValue Returns the value of the object.
InvDBServer32.TdbInfoServer
This object can read information from the AMS Asset Graphics and can send the update message.
Methods
Name Description
procedure Update Sends an update message in the database to all connected runtime programs.
function IsUpdate Returns true, if the message is the AMS Asset Graphics update message.
(Message:short)
procedure GetInfo Returns information on the database in the parameters:
(RefCount:long, RefCount = Applied database user
MaxNUM:long, MaxNUM = Max. number of num-elements
MaxTXT:long, MaxTXT = Max. Number of text-elements
AktNUM:long, AktNUM = Current number of num-elements
AktTXT:long) AktTXT = Current number of text-elements
function GetNameNUM Returns the name of the num-element at the Index position as string.
(Index:long)
function GetNameTXT Returns the name of the text-element at the Index position as string.
(Index:long)
399
Manual AMS Asset Graphics 5.4
File InvDBServer32.tlb contains the definitions for the automation calls. It can be imported in the individual
development environments. With this, the object can be applied and used.
In InvDBServer32.exe the automation server for AMS Asset Graphics is implemented. It must be started
once on the computer, in order to register the automation interface.
See also
Example
C++
C++ connection
Overview
The database-interface offers the possibility to connect to the AMS Asset Graphics database with the help of
C++.
The database can send a update message cyclically to your program. In addition, the C++ interface offers
you functions to create, read or write data-elements. The functions, necessary for this, are summarized in
classes.
400
Database interface
See also
Provided C++ classes
Exported functions of InvDBUser32.DLL
Writing an application program in C++
CUserDBConnection
With this class the message connection to the database is realized.
Constructors / destructors
Name Description
CUserDBConnection() Default constructor.
~CUserDBConnection() Default destructor.
Functions
Name Description
Open Opens the message connection to the database.
(HWND hWnd)
Close() Closes the message connection to the database.
Members
Name Description
HWND m_hWnd Window handle of the user program.
CUserTdbInfo
Message functions
Name Description
void Update Sends an update message to all connected programs.
(void);
BOOL IsUpdate Returns TRUE, if the received message is a update message.
(UINT Message);
401
Manual AMS Asset Graphics 5.4
Information functions
Name Description
void GetInfo Returns information on the database in the parameters:
(LPDWORD RefCount, RefCount = Applied database user
LPDWORD MaxNUM, MaxNUM = Max. number of num-elements
LPDWORD MaxTXT, MaxTXT = Max. Number of text-elements
LPDWORD AktNUM, LPDWORD AktNUM = Current number of num-elements
AktTXT) AktTXT = Current number of text-elements
BOOL GetNameNUM Retrieves the name of the num-element / text-element in parameter
(LPSTR EleName, EleName at the index position.
DWORD Index) Returns true, if the function call was successful.
BOOL GetNameTXT
(LPSTR EleName,
DWORD Index)
Macros
Name Description
DefUserNum(Name) This macro creates with the specified name a num-element in the database and an
object in the source code.
DefUserTxt(Name) This macro creates with the specified name a text-element in the database and an
object in the source code.
CUserNumEle
With this class num-elements can be created, read or modified.
Constructors
Name Description
CUserNumEle() The default constructor.
CUserNumEle Creates an object with a name and resets immediately the change
(LPCSTR Name, flag.
BOOL bClearChange = FALSE)
CUserNumEle Creates an object with a name and sets InitValue.
(LPCSTR Name, double
InitValue
Operators
Name Description
double operator = (CUserNumEle Name) Sets the object with the value of the named num-element.
void operator =(double NumValue Sets the num-element with a double value.
operator const double() Returns the value as double.
operator const int() Returns the value as integer.
void operator ++(void) Increments the value.
void operator --(void) Decrements the value.
402
Database interface
Functions
Name Description
void Toggle() The object value will be increased by one at every call, until the maximum value is
reached. At the next call of the function, the value will be reset on 0 again.
LPSTR GetName Returns the name of the object in parameter EleName and as return value.
(LPSTR EleName)
LPCSTR GetName() Returns the element name.
int Returns the length of the name.
GetNameLength()
BOOL SetName Sets the name of the object with or without creating the object.
(LPCSTR EleName,
BOOL bCreate =
TRUE)
BOOL Exist() Decides, whether the element does exist in the database. Returns TRUE, if the
element exists.
BOOL IsChanged Returns TRUE if the object has changed.
(BOOL bClear = bClear defines, if the change flag shall be reset after the function call.
TRUE)
BOOL SetChange(); Sets the change flag for the num-element.
Members
The member variables should not be addressed directly. Instead of this, use the corresponding function.
Name Description
char m_Name Name of the currently used element.
DWORD m_Index The position of the element in the database.
DWORD In this variable the last change status is stored. When this member has another
m_OldChange value as that in the database, the element is considered as changed.
CUserTxtEle
Constructors
Name Description
CUserTxtEle() The default constructor.
CUserTxtEle Creates an object with a name and clears immediately the change
(LPCSTR Name, flag.
BOOL bClearChange = FALSE)
CUserTxtEle Creates an object with a name and sets it with InitText.
(LPCSTR Name, LPCSTR
InitText)
403
Manual AMS Asset Graphics 5.4
Operators
Name Description
operator = (CUserTxtEle Name) Compares the object value with the values of the named object.
operator = (LPSTR Text) Set object value with Text.
operator = (LPCSTR Text) Set object value with Text.
operator == (LPSTR Text) Check if object value is equal with Text.
operator != (LPSTR Text) Check if object value is not equal with Text.
operator LPCSTR() Returns the value as LPCSTR-pointer.
Functions
Name Description
LPSTR GetName Returns the name of the object in parameter EleName and as return value.
(LPSTR EleName)
LPCSTR GetName() Returns the name of the object.
int GetNameLength() Returns the length of the name.
BOOL SetName Sets the name of the object with or without creating the object.
(LPCSTR EleName,
BOOL bCreate = TRUE)
BOOL Exist(void) Returns TRUE, if the element exists.
BOOL IsChanged Returns TRUE if the object has changed.
(BOOL bClear = TRUE) bClear defines, if the change flag shall be reset after the function call.
BOOL SetChange(void); Sets the change flag for the text-element.
Members
The member variables should not be addressed directly. Instead of this, use the corresponding function.
Name Description
char m_Name Name of the currently used element.
DWORD m_Index The position of the element in the database.
DWORD In this variable the last change status is stored. When this member has another
m_OldChange value as that in the database, the element is considered as changed.
404
Database interface
See also
Example
Example User_Program_VC
The program User_Program_VC demonstrate the use of the database interface in the language C++.
In addition, the update message of the program is used to show the current values of the data-elements.
405
Manual AMS Asset Graphics 5.4
Function OnTDBUpdate
/////////////////////////////////////////////////////////////////////////////
// CUser_Program_VCDlg
// update message from AMS Asset Graphics
LRESULT CUser_Program_VCDlg::OnTDBUpdate(WPARAM wParam, LPARAM lParam)
{
wParam; lParam;
// Initialization ready?
if ((int) _InitUserVC == 1)
return (0);
// Check if _SystemStop
if ((BOOL) _SystemStop != 0) {
int Result = 0;
EndDialog(Result); // stop the program
}
// Check if program must be on top
if (_SetTopUserVC.IsChanged()) {
if (AfxGetMainWnd()->IsIconic()) // Is the application
iconized?
AfxGetMainWnd()->ShowWindow(SW_RESTORE); // then restore
AfxGetMainWnd()->ActivateTopParent(); // application activate
AfxGetMainWnd()->GetLastActivePopup()->SetFocus(); // set focus to
window
}
406
Database interface
Open Database
In a dialog-based application, the database can be opened in the OnCreate function of the dialog.
/////////////////////////////////////////////////////////////////////////////
// CUser_Program _VCDlg
// window is created
int CUser_Program_VCDlg::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
// set the Init-Element to 1 so that the Runtime recognize Initialisation
startet
_InitUserVC = 1;
if (CDialog::OnCreate(lpCreateStruct) == -1)
return -1;
Close Database
In a dialog-based application, the database can be closed in the OnDestroy function of the dialog.
/////////////////////////////////////////////////////////////////////////////
// CUser_Program_VCDlg
// window is destroyed
void CUser_Program_VCDlg::OnDestroy()
{
CDialog::OnDestroy();
407
Manual AMS Asset Graphics 5.4
Create num-element
This function is called with button Create in the field NUM.
A num-element will be created with the entered name and value.
/////////////////////////////////////////////////////////////////////////////
// CUser_Program_VCDlg
// This function creates a num-element in the AMS Asset Graphics database
void CUser_Program_VCDlg::OnCreateNum()
{
// get the data from the dialog
UpdateData();
Create text-element
This function is called with button Create in the TXT -field. A text-element will be created with the entered
name and value.
/////////////////////////////////////////////////////////////////////////////
// CUser_Program_VCDlg
// This function creates a text-element in the AMS Asset Graphics database
void CUser_Program_VCDlg::OnCreateTxt()
{
// get the data from the dialog
UpdateData();
Read num-element
This function is called with button Read in the field NUM. The function tries to read the entered num-
element.
/////////////////////////////////////////////////////////////////////////////
// CUser_Program_VCDlg
// This function read a num-element from the AMS Asset Graphics database
void CUser_Program_VCDlg::OnReadNum()
{
// find out if the object exist in the AMS Asset Graphics database
if (m_NumEle.Exist()) {
// set the dialog variable with the object-value
m_ValueNum = m_NumEle;
}
else {
// Error message
AfxMessageBox("num-element doesn't exist in AMS Asset Graphics
database");
}
// set the data in dialog
UpdateData(FALSE);
}
408
Database interface
Read text-element
This function is called with button Read in the field TXT. The function tries to read the entered text-element.
/////////////////////////////////////////////////////////////////////////////
// CUser_Program_VCDlg
// This function read a text-element from the AMS Asset Graphics database
void CUser_Program_VCDlg::OnReadTxt()
{
// find out if the object exist in the AMS Asset Graphics database
if (m_TxtEle.Exist()) {
// set the dialog variable with the object-value
m_ValueTxt = m_TxtEle;
}
else {
// Error message
AfxMessageBox("text-element doesn't exist in AMS Asset Graphics
database");
}
// set the data in dialog
UpdateData(FALSE);
}
Write num-element
This function is called with button Write in the field NUM. The function tries to write the entered num-
element.
/////////////////////////////////////////////////////////////////////////////
// CUser_Program_VCDlg
// This function writes in a num-element
void CUser_Program_VCDlg::OnWriteNum()
{
// get the data from the dialog
UpdateData();
409
Manual AMS Asset Graphics 5.4
Write text-element
This function is called with button Write in the field TXT. The function tries to write the entered text-element.
/////////////////////////////////////////////////////////////////////////////
// CUser_Program_VCDlg
// This function writes in a text-element
void CUser_Program_VCDlg::OnWriteTxt()
{
// get the data from the dialog
UpdateData();
Message functions
Name Description
BOOL Opens the database and permits the system to send an update-
TDBUser_OpenDatabase message to your program.
(HWND hWnd)
BOOL Closes the message-connection to the database.
TDBUser_CloseDatabase
(HWND hWnd)
void TDBUser_Update(void) Forces the transmitting of an update-message to all tasks connected to
the database.
BOOL TDBUser_IsUpdate Returns TRUE, if it is a update-message.
(DWORD Message)
410
Database interface
Element functions
Name Description
BOOL TDBUser_CreateNUM Creates a num-element / text-element in the database.
(LPCSTR EleName, LPDWORD Index)
BOOL TDBUser_CreateTXT
(LPCSTR EleName, LPDWORD Index)
BOOL TDBUser_ExistNUM Decides, whether the num-element / text-element does exist in
(LPCSTR EleName, LPDWORD Index) the database or not.
BOOL TDBUser_ExistTXT
(LPCSTR EleName, LPDWORD Index)
double TDBUser_GetNUM Returns the value of the num-element.
(LPCSTR EleName, LPDWORD Index)
BOOL TDBUser_GetTXT Returns the value of the text-element in parameter TextValue.
(LPCSTR EleName, LPSTR TextValue,
LPDWORD Index)
void TDBUser_SetNUM Sets a new value to the num-element / text-element in the
(LPCSTR EleName, double NumValue, database.
LPDWORD Index)
void TDBUser_SetTXT
(LPCSTR EleName, LPCSTR
TxtValue,
LPDWORD Index)
void TDBUser_ToggleNUM Increases the value of the num-element by 1.
(LPCSTR EleName, LPDWORD Index)
BOOL TDBUser_SetChangeNUM Sets the num-element / text-element as changed.
(LPCSTR EleName, LPDWORD Index)
BOOL TDBUser_SetChangeTXT
(LPCSTR EleName, LPDWORD Index)
BOOL TDBUser_IsChangedNUM Returns TRUE, if the num-element / text-element has changed.
(LPCSTR EleName, LPDWORD Index,
LPDWORD OldChange, BOOL
bClearBit)
BOOL TDBUser_IsChangedTXT
(LPCSTR EleName, LPDWORD Index,
LPDWORD OldChange, BOOL
bClearBit)
BOOL Returns the element name of a num-element / text-element at
TDBUser_EleNameOfIndexNUM the index position).
(LPSTR EleName, DWORD Index,
BOOL bSortedPos)
BOOL
TDBUser_EleNameOfIndexTXT
(LPSTR EleName, DWORD Index,
BOOL bSortedPos)
411
Glossary
Alarm picture
For every event an alarm picture can be defined. This picture will be displayed, when the event occurs.
Operator / User
To protect the system against unauthorized access, up to 100 different operators (or users) can be defined
with passwords, which are assigned to different access rights.
Picture change
Change from one process picture to another one.
The change of the pictures can be realized in different ways. Generally, a function key or a button is defined,
by means of which the system-element _NewPic is assigned to the name of the new picture.
An other option for a picture change can be configured in the Eventjournal Editor. A picture can be defined
here, to which the program changes automatically, when an event occurs.
DB-Transfer
Transfer of data types between the systems inVISU 2.5 and AMS Asset Graphics.
DDE
The abbreviation DDE stands for Dynamic Data Exchange. DDE is a mechanism of Windows to permit data
exchange between different applications.
Database replication
The database replication is a technique of the SQL server. With this technique data can be replicated by
different databases. AMS Asset Graphics uses the merge replication, which permits the changing of data at
both databases.
Data input
Input or change of data-elements (e.g. setpoints) during runtime.
413
Manual AMS Asset Graphics 5.4
Data-element
A data-element, also called element, is a variable in AMS Asset Graphics, which contains a numerical value
or a text. The data-element can gets the value either directly from the process, via the data input or from
other actions.
A number of data-element (system-elements) is predefined.
Data storage
With the data storage num- and text-elementst can be stored to definable times (e.g. every 2 seconds) or
depending on events (e.g. a data change). These stored data can be accessed with trend charts or with
external programs for purposes of representation or further processing.
Data types
The following abbreviations are used for the different data types:
Abbreviation Data type
NUM Num-element
TXT Text-element
C-Num Numerical constants in VBScript
C-Txt Text constants in VBScript
Debugger
By means of the Debugger the contents of data-elements can be watched and changed. This permits testing
objects and detecting errors.
Properties
Every object is characterized by its properties. There are static and dynamic properties. The characteristics
of an object (e.g. of a circle which changes its color depending on a data-element) are defined in property
dialogs.
Development
In order to provide the desired design and properties for the runtime programs, they have to be defined
before in the development.
The development programs are the Project Manager for the administration of the projects, the Graphic
Editor to create process pictures. Other components are the process assignment , events, data storage,
trend charts, activity and operation logs, recipes, etc.
Event
An event is triggered, when a data-element is leaving the permissible range. An event that has occurred
(event comes), will be entered into the Eventjournal and can be seen there. An event is regarded as active,
as long as the reason for its triggering is still available.
414
Glossar
Eventjournal
The eventjournal is a runtime list of events.
Event Viewer
The program Event Viewer shows current and historical events.
The events can be printed in configurable reports.
Maintenance Runtime
Maintenance is the routine actions which keep devices in working order (maintenance) or prevent trouble
from arising (preventive maintenance).
The Maintenance Runtime records and calculates the maintenance data automatically.
These data can be viewed and printed in reports.
Runtime
The real process visualization, whose properties were defined in the AMS Asset Graphics development
environment. The individual tasks are executed by different programs. The list of the runtime programs is
defined in the Project Manager.
Activity Log
With the Activity Log, operator inputs during runtime and important actions of individual programs can be
documented.
The Activity Log Viewer displays the data in multiple views.
Log level
Via the log level, the recording of entries into the activity log is controlled over different levels. The activity
log entries can be sorted according to the log level.
An action with the log level 0 is not recorded in the activity log.
Network mode
The network mode permits to visualize and operate an AMS Asset Graphics project via several computers.
At this, one computer operates as master and the other computers as stations.
Notification-trigger
An notification-trigger indicates the completion of an action by the change of its value.
The element will be increased by 1 and reset on 0 when reaching 255.
Num-element
A num-element is a variable and can store floating point numbers in the range from -1.7E+308 to 1.7E+308.
415
Manual AMS Asset Graphics 5.4
ODBC
The ODBC interface (Open Data Base Connectivity) permits applications, to access on data of several
databases via SQL commands, e.g. ORACLE, MS SQL-Server, INFORMIX, PARADOX, dBase or ACCESS.
This interface offers a maximum in portability, one application can access on different databases. This
permits the application designer to develop applications without the need to commit on one definite
database management system (DBMS). Then, the end user can add the so called database drivers, which
realize the connection between the application and the database.
OPC
OLE for Process Control (OPC), is the original name for an open standards specification. The standard
specifies the communication of real-time plant data between control devices from different manufacturers
A client-server architecture subdivides the software components in OPC Server and OPC Clients. An OPC
Server provides data via the OPC interface, for example it collects data via a field bus system and offers
them to other clients. The AMS Asset Graphics program, as OPC Client, has access on measuring points
via so-called OPC-items. The OPC-items have logical names (such as "Filling level" or "Weight") and can be
summarized to a group (item-group). The access for reading and writing will take place on this group level.
Object
Every object forms an independent unit which shows properties like color, form, outline, size and display
position.
The properties are part of its definition. An object can have static and dynamic properties.
Password protection
With the help of the password protection, the operation of the AMS Asset Graphics is protected against
unauthorized access.
Project
A project summarizes all definitions of a task to one name.
With the development programs several projects can be edited and data (e.g. graphics) can be transferred
from one project to another one.
The definitions of an AMS Asset Graphics project are stored in a project directory of the same name.
Process assignment
Definition of the assignment of data-elements with real process values via so called process assignment
tables.
Acknowledgment
Acknowledgment of events is made in the Eventjournal Runtime or in the Event Viewer.
The definition, whether an acknowledgement is required or not, is configured in the Eventjournal Editor.
416
Glossar
Recipe
A recipe is a file, which contains values for a group of data-elements. These values can be transferred from
the file to data-elements (loading a recipe) or saved from the data-elements into the file (saving a recipe).
The values of the data-elements are e.g. setpoints of a machine or ratios of chemical recipe mixtures.
Recipe group
A recipe group is the definition, which data-elements are part of a recipe.
Recipe groups are defined in the Recipe Editor. During runtime, several recipes can be defined for every
recipe group.
Recipe Runtime
With the Recipe Runtime you can load, edit and save recipes during runtime.
Ring buffer
The data of the data storage are saved in one or more ring buffers.
It can freely be defined, how many datasets shall be stored in one ring buffer. If the ring buffer is full, the
oldest dataset will first be overwritten.
Button
A button is a control element that provides the user a simple way to start dedicated functions.
Slider
With help of a slider data-elements are displayed and can be changed.
The value will be displayed via the position of a thumb, which is also used to change its value. The slider
can be divided in sectors with a scale.
Scrollbar
With help of a scrollbar data-elements are displayed and can be changed.
The value will be displayed via the position of a thumb, which is also used to change its value.
Script
A script is a mathematical or logical expression, which can be used for inputs instead of data-elements. An
expression can e.g. be a sum of several elements or other mathematical functions.
Language changeover
The changing of the used language in the runtime is called language changeover.
417
Manual AMS Asset Graphics 5.4
This is useful, e.g. if a machine with a visualization shall be delivered into multilingual countries. The same
visualization software can then be delivered to the different countries with the user texts in the respective
national language.
Control-trigger
If the value of a control-trigger changes, the relevant action will be started.
Symbol
One or several objects can be saved with their properties as a symbol. This symbol can be loaded again and
placed into any graphic. In doing so, it can keep its original size but can also be enlarged or reduced.
System-element
A system-element is a data-element, whose functionality is predefined by the AMS Asset Graphics.
Text-element
A text-element is a variable can store texts with a maximum length of 80 characters.
Toggle
Increasing of a data-element by 1; when reaching 255, the data-element will be reset to 0 again.
Toggling is used to start actions.
Driver
A (communication-) driver is a program which realizes the data exchange to the process.
The drivers to be used, are defined in the Process Assignment Editor.
Driver profile
A driver profile summarizes the settings, which describe the communication parameter to a specified partner
device.
For every driver any number of profiles may be generated. A driver profile can be assigned to any of process
assignment tables.
Trend chart
A trend chart shows stored data of a definite period. This period may be set differently during runtime, thus
the representation of both, online data and historical data is possible.
Trigger
A data-element which controls actions or indicates them.
418
Glossar
Vector graphic
A vector graphic is mathematically be defined as a set of several points, which are connected with each
other by lines. The static and dynamic elements of a vector graphic are called objects. Since every object is
an independent unit, it can be moved any time and its properties can be changed without reducing its quality
and without affecting other objects in the graphic.
UTC
The international abbreviation for "Coordinated Universal Time " is UTC. UTC is assigned to the time zone
defined by the 0 meridian (Greenwich).
The UTC is a basis for dates, because it enables exact international date specifications.
Local time zones are expressed as positive or negative offsets from UTC.
Since the time remains unchanged over the whole year, an hour must be added or removed in addition for
the summertime.
Visualization
Definition of the optical appearance of the process data in the runtime program (i.e. of the static and
dynamic objects).
Also the name for the runtime program, which presents the pictures.
Zooming
With the zooming function, the view area on the process graphic in the Graphic Editor can be enlarged or
reduced.
You can also zoom in trend charts.
419
Appendix
Functionality
The following table gives a general overview on the AMS Asset Graphics functions.
421
Manual AMS Asset Graphics 5.4
Further Information:
List of program names and EXE-modules
422
Appendix
Directory structure
AMS Asset Graphics uses the following directory structures:
423
Manual AMS Asset Graphics 5.4
The root directory for the directories, labeled with * (indicated red in the graphic), can be modified with
program Configuration in tab Directories. This root directory is named Data directory in the
documentation. The default setting for the data directory is the program directory.
The bold typed names are used in the programs, for this reason they must not be changed.
424
Appendix
425
Manual AMS Asset Graphics 5.4
426
Appendix
File versions
When loading documents, all programs are downward compatible. This means that documents, created
with older program versions can be read. Exceptions will be explained explicitly in the relevant program
descriptions.
All documents created by AMS Asset Graphics programs contain version and type informations.
Documents are always stored with the current file version.
Information regarding specific files can be shown with command TYPE filename at the DOS prompt. The file
identification text and the current file version of the document will be shown then.
Example:
i4 Visualization Picture, Version: 0011
After this, the file version will be compared with the current document version.
If both are matching, the document will be loaded.
If the file version is lower than the document version, the editor shows the message window and
the file will be loaded. When storing the file, this will be made in the new version.
Example:
Warning:
Version xxx of file 'File name'
will be converted, when saved,
to version yyy!
If the file version is higher than the document version, a message window appears.
Example:
The version xxx of file
'File name'
is unknown! Continue reading?
427
Manual AMS Asset Graphics 5.4
428
Index
429
A Colors................................................................67
Step-by-step ................................................109
Acknowledgment............................................. 220 Tab Colors ....................................................67
Activity Log Command tables .............................................280
Definition ..................................................... 309
Log level...................................................... 415 Communication logging...................................171
New entry via VBScript ............................... 376 Configuration of network computers................303
Recording operator actions and system Copying objects.................................................52
messages.................................................... 313
Copying project files ..........................................32
Activity Log Viewer.......................................... 309
Commands.................................................. 310 Create archive .................................................253
Filter ............................................................ 310 Cross reference...........................................15, 29
Profile properties ......................................... 310
Sorting ........................................................ 310 D
Alarm picture ................................................... 413 Data exchange tables .....................................279
Definition ..................................................... 413
Data input ..........................................................92
Alarms historical Properties for a picture ..................................92
Old mode .................................................... 236 Testing ..........................................................96
Aligning objects Data storage............................ 253, 254, 256, 258
Position ......................................................... 44 Archiving .....................................................253
Size ............................................................... 44 Create a data storage .................................260
Space between objects ................................. 44 Error codes .................................................258
AMS Asset Graphics Export..........................................................254
Data interface.............................................. 393 Import ..........................................................256
Directory structure....................................... 423 Modifying a data storage .............................263
Functionality ................................................ 421 Data Storage Editor.................................251, 252
Program design........................................... 426 Introduction .................................................251
Program names and EXE-modules............. 425 Properties of a data storage ........................252
Project files ................................................. 426
Data Storage Runtime.....................................260
User interface..................................................9
Welcome .........................................................1 Data storage tables .........................................258
AMS Asset Graphics Report Designer Database .........................................................289
Maintenance ............................................... 345 Database replication
Operation Log ............................................. 333 AMS Asset Graphics database tables ...........39
Archiving data ................................................. 262 Configuring ....................................................37
Requirements ................................................38
Assign printers for the Eventjournal ................ 224
Data-element...............................................3, 414
Automatic filling ........................................... 10, 12
Renaming ......................................................44
Automation interface ....................... 394, 395, 398
DCOM .....................................................213, 416
Example ...................................................... 395
Overview ..................................................... 394 DDE ................................................ 277, 281, 287
Possible problems....................................... 394 DDE-Server .................................................281
TLB file ........................................................ 398 Examples DDE-Server ................................287
Step-by-step ........................................282, 287
Automation server ........................................... 393
DDE Editor ......................................................277
B Command table ...........................................280
Bitmap ............................................................... 60 Data exchange table ...................................279
Properties commands .................................277
Button ............................................................... 60 Properties data exchange ...........................277
C DDE Runtime
DDE client ...................................................281
C++ Connection .............................................. 400 DDE Server .................................................281
Call a help file ................................................. 368 DDE-Client ......................................................281
Central database.................................................3 Debugger ........................................................349
Checkbox .......................................................... 61 Overview .....................................................349
Design ........................................................... 78 Default project ...................................................27
Color selection .................................................. 17 Dialog New project ........................................27
430
Index
431
Manual AMS Asset Graphics 5.4
432
Index
433
Manual AMS Asset Graphics 5.4
434
Index
V X
Variables in texts.................................................4 XY-trend chart .................................................138
Commands ..................................................140
VBScript ... 63, 369, 370, 371, 372, 374, 375, 376,
CSV-file as data source ..............................127
378
Definition .....................................................127
Access to data storage files ........................ 378
Runtime .......................................................138
Access to data-elements ............................. 372
Tracking dialog ............................................139
AddLogMessage ......................................... 376
Asynchronous call of functions.................... 374 Z
Automation .................................................. 375
Bit function .................................................. 372 Zoom
Calling VBScript help .................................. 370 Picture ...........................................................54
Context menu.............................................. 371 Trend chart ..................................................136
Debugging............................................. 28, 377 XY-trend chart .............................................138
Dialog Replace............................................ 370
435