Académique Documents
Professionnel Documents
Culture Documents
handling
The first part of this chapter describes the user interface of Multiprog including all important windows, explains how to
handle the menus, toolbars and icons. Additionally you get information about customizing the interface.
In the second part, you find all procedures dealing with project handling. Starting with the steps how to create a project,
the different ways to save, delete and open projects and templates, down to the steps how to protect a project against
unauthorized use, this chapter provides all necessary step by step procedures.
User interface and project handling
User interface: general description................................................................................................1
Menu bar..............................................................................................................................1
Toolbars...............................................................................................................................3
Keyboard − Default shortcuts...............................................................................................4
Defining keyboard shortcuts with the Shortcut Manager.......................................7
Dialog 'Shortcut Keys'............................................................................................8
Dialog 'Assign Shortcut'.........................................................................................9
Project tree − overview.........................................................................................................9
Icons in the project tree........................................................................................10
Workspace.........................................................................................................................12
Cross reference window.....................................................................................................12
Symbols in the Cross Reference Window............................................................14
How to build the cross references........................................................................15
How to access a worksheet, where a variable entry is used...............................15
How to sort the cross reference list......................................................................16
How to filter the cross reference list − dialog 'Cross Reference Filter'.................16
Message Window...............................................................................................................17
Logic Analyzer....................................................................................................................18
Status bar...........................................................................................................................18
Customizing the user interface − dialog 'Options'..............................................................19
Creating your own toolbar....................................................................................21
Dialog 'New Toolbar'............................................................................................22
Assigning commands to a toolbar........................................................................22
Defining general settings for the user interface...................................................22
Default path settings (directories)........................................................................23
Settings for the text editor....................................................................................23
Setting the text colors..........................................................................................24
Settings for the graphic editor..............................................................................25
Setting the colors in graphical worksheets...........................................................26
Settings for the debug behaviour.........................................................................26
Settings for project backups and the Autosave feature.......................................27
Handling a project..........................................................................................................................28
Creating a new project using the Project Wizard...............................................................28
Dialog 'New Project'.............................................................................................28
Dialog 'Project Wizard (Step 1 of 6)'....................................................................29
Dialog 'Project Wizard (Step 2 of 6)'....................................................................29
Dialog 'Project Wizard (Step 3 of 6)'....................................................................29
Dialog 'Project Wizard (Step 4 of 6)'....................................................................29
Dialog 'Project Wizard (Step 5 of 6)'....................................................................30
Dialog 'Project Wizard (Step 6 of 6)'....................................................................30
Creating a new project using a template............................................................................30
Opening an existing project................................................................................................31
Saving worksheets while/after editing................................................................................32
Dialog 'Save changes'..........................................................................................33
Saving a project with a new name......................................................................................33
Saving a project as template..............................................................................................33
Dialog 'Save As Template'...................................................................................34
Deleting a template............................................................................................................34
Dialog 'Delete Template'......................................................................................34
Protecting a project using a password...............................................................................34
Logging into a protected project...........................................................................35
Steps for protecting a project and changing the settings.....................................35
i
User interface and project handling
Handling a project
Security settings in the various properties dialogs...............................................37
Password dialogs.................................................................................................38
Defining and changing a password......................................................................39
Zipping project files into an archive file..............................................................................40
Dialog 'Save/Zip project as'..................................................................................41
Unzipping an archive file....................................................................................................41
Translating a project...........................................................................................................42
Exporting a project translation file........................................................................43
Importing a project translation file........................................................................43
Switching the project language............................................................................44
Comparing the POUs of two projects.................................................................................44
ii
User interface: general description
The program user interface consists basically of six parts: Menu, toolbars, main screen, message
window, cross reference window and status bar.
The main screen itself is composed of the project tree window and the workspace.
In this topic you also get information about using the keyboard and keyboard shortcuts.
Menu bar
The menu contains a set of submenus with all commands you need to develop your project and to
work with the program. Below you find a short description of these submenus.
A short description of each menu item is displayed in the status bar. The usage of the menu items
are explained in the corresponding procedures.
1
User interface: general description User interface: general description
The menu items of these submenus change according to the program part or editor you are
working with.
File The submenu 'File' can be used to create, save and zip/unzip projects, to save a
project as a template and to delete templates. It also contains commands for
printing, print setup and print preview.
Additionally this submenu contains a menu item for exporting and importing.
Using this menu items it is possible to export a translation file (*.csv) which
contains all comments within the worksheets as well as the contents of the
description worksheets. This csv−file can be translated into any language, e.g by
using a translation software. After (re)importing the translated file you can switch
the project language by selecting the language in the project properties dialog.
Another useful feature accessible via this menu is protecting a project using a
password. For that pupose the menu contains the item 'Enter password...'. For
detailed information please refer to the topic Protecting a project using a
password.
Edit The submenu 'Edit' contains all commands which are necessary for editing such
as marking, choosing different working modes or cutting and pasting.
Additionally it provides functionality for searching and replacing text strings used
to edit textual worksheets (e. g. description worksheets, variables worksheets;
ST worksheets or IL worksheets) and graphical worksheets. Depending on the
active editor the menu contains as well commands for handling objects (e. g.
selecting, moving, enabling branch modes, creating pictures, etc.).
View The submenu 'View' can be used to hide or show the different windows of the
user interface (project tree window, message window, cross reference window,
watch window, Logic Analyzer, Edit Wizard) and the status bar.
Project The submenu 'Project' can be used to insert data type worksheets and POUs
and to announce libraries. It further provides a command to compare the POUs
of the current project with another project and to display the detected differences
in the message window.
Build The submenu 'Build' consists of different commands for starting the compilation
after editing, for displaying the errors detected while compiling and for building
the cross references. Additionally the submenu 'Build' provides the command
'Source conversion' for cross compiling POUs. Detailed information are provided
in the topic Source conversion for IL, FBD and LD.
Objects The submenu 'Objects' is available if you are using an editor. The menu item
'Variable' can be used to insert a new variable into the variable list of the current
POU. When editing a graphical worksheet, the submenu provides additional
menu items to insert and edit graphical objects, such as connectors, jumps,
contacts, coils, etc. Depending on the graphical language you are using, some
items may be grayed (i.e. inactive).
Layout The submenu 'Layout' is available if you are using the graphic editor. It contains
2
User interface: general description Toolbars
several designing utilities. You can display e.g. page borders or a grid for better
organizing the content of your worksheets. Furthermore you can zoom into and
out of the worksheet, modify the worksheet size, the autoscroll speed and the
object size.
Online The submenu 'Online' provides commands for debugging a project, calling the
Resource Control and activating the Powerflow. In addition the command 'Online
Layout' allows to set the appearance of graphical worksheets in online mode and
a second submenu named 'Logic Analyzer' is available, containing the
commands for controlling the Logic Analyzer.
Extras The submenu 'Extras' can be used to call the dialogs 'Shortcut Keys' and
'Options' as well as other optional tools, such as the pagelayout editor. The
dialog 'Shortcut Keys' (also known as Shortcut Manager) allows you to define
your own keyboard shortcuts or customize the default shortcuts. The dialog
'Options' provides the facility to customize the menus, toolbars, text editors and
text colors.
Window The submenu 'Window' can be used to arrange the windows and symbols on
your screen and to close all open windows in one step.
Toolbars
The program provides several toolbars which contain different icons to access often used
operations more rapidly. These operations can also be performed using the menu items or
pre−defined shortcuts.
The toolbars are located below the menu bar. By default all toolbars are visible. To hide or show a
certain toolbar, please use the dialog 'Options'.
If you place the mouse cursor on any icon (without clicking it), a short description text, the so called
tooltip appears. These tooltips contain the name of the current icon. If the tooltips do not appear,
please enable them in the dialog 'Options'.
Additionally the status bar displays the function of the desired icon. The following figure shows an
example:
3
User interface: general description Keyboard − Default shortcuts
If the tooltips are not shown, open the dialog 'Options' by selecting the menu item 'Options' in the
submenu 'Extras'. Activate the checkbox 'Show Tooltips' on the page 'Toolbars' and press 'OK' to
confirm the dialog.
You can detach every toolbar from the other toolbar by double clicking on the gray toolbar
background. The toolbar is then displayed in a window, which can be resized and moved to any
position on your screen. To reinsert the toolbar window, just double click on the blue toolbar
window title bar.
Keyboard shortcuts can be used to perform certain functions by pressing only one key or key
combination. Using shortcuts is the easiest way to execute the most important operations required
for your programming system.
4
User interface: general description Keyboard − Default shortcuts
Default shortcuts are already assigned to the most important operations (i.e. menu items). In
addition the programming system provides a Shortcut Manager, which can be used to add new
shortcuts or to modify existing or default shortcuts.
The following list contains all default shortcuts, assigned to the different menu items by the
software manufacturer. The operations/menu items are listed in alphabetical order.
5
User interface: general description Keyboard − Default shortcuts
6
User interface: general description Defining keyboard shortcuts with the Shortcut Manager
The Shortcut Manager is used to add new shortcuts for a specific menu item or to modify existing
or default shortcuts.
How to proceed:
• Choose the menu item 'Shortcuts' in the submenu 'Extras'. The dialog 'Shortcut Keys'
appears.
Example: Assigning the shortcut <ALT> + <S> to the macro 'Build:Stop Compile'
For the following description it is assumed, that the dialog 'Shortcut Keys' is already opened.
• Double click on the desired macro 'Build:Stop Compile' in the field 'Select a macro'. The
dialog 'Assign Shortcut' appears.
7
User interface: general description Dialog 'Shortcut Keys'
• Press the desired shortcut keys (in our example <ALT> and <S>). They are shown in the
text field. Below the text field the Shortcut Manager shows, whether the desired keys are
already assigned to another macro.
The dialog 'Assign Shortcuts' is closed and the new assigned shortcut is shown in the
dialog 'Shortcut Keys'.
The dialog 'Shortcut Keys' appears if you choose the menu item 'Shortcuts' in the submenu
'Extras'. It is used to define new shortcuts or to modify existing shortcuts.
• To modify an existing shortcut, you have to remove the current shortcut setting and
assign a new shortcut (refer to the following steps).
8
User interface: general description Dialog 'Assign Shortcut'
• To create a new shortcut, select the particular macro in the list 'Select a macro' and press
the button 'Create Shortcut' or double click on an entry in the list. The dialog 'Assign
Shortcut' appears. Press the desired shortcut keys. They are shown in the text field.
Confirm the new shortcut by clicking on 'OK'. The dialog 'Assign Shortcut' is closed and
the new assigned shortcut is shown in the field 'Assigned shortcuts'.
• To remove a certain shortcut, click on the shortcut in the field 'Assigned shortcuts' and
then click on 'Remove'.
• To reset all default shortcuts, click on the button 'Reset All'. Your shortcut settings will be
overwritten by the default settings.
The dialog 'Assign Shortcut' appears if you select a particular macro in the list 'Select a macro' in
the dialog 'Shortcut Keys' and you press the button 'Create Shortcut' or by double clicking on an
entry in the list 'Select a macro'. It is used to enter a shortcut for a particular operation.
• Press the desired shortcut key(s). They are shown in the text field. Below the text field it is
displayed, whether the desired keys are already assigned to another macro. Press 'OK' to
confirm the dialog. The new shortcut is displayed in the dialog 'Shortcut Keys'.
If the desired keys are already assigned to another macro and you confirm your current selection,
the shortcut keys will be reassigned without a warning message.
The project manager is a comfortable and powerful tool for program organization and project
management. It includes the project tree editor and the instance tree.
The project tree editor allows you to edit the structure of your project. You can edit your project
within four subtrees.
• In the subtree 'Data Types' worksheets can be added for editing data types.
• In the subtree 'Logical POUs' new POUs and worksheets can be added for editing
variable and code body worksheets.
• In the subtree 'Physical Hardware' all configuration elements can be inserted, global
variables and network variables can be declared and programs can be associated to
tasks.
It is possible to display the complete project tree or only particular subtrees. For this purpose the
project tree window provides several tabs at it's bottom. They can be used to switch between the
various views. If you place your mouse cursor on a tab (without clicking it) a tooltip appears, which
9
User interface: general description Icons in the project tree
Which tabs are visible at the bottom of the project tree window can be defined by the user. For that
purpose open the submenu 'Extras' and select the menu item 'Options'. In the dialog 'Options' open
the page 'General' and mark the tabs to be displayed in the page area 'Project tree'.
The subtrees 'Data Type' and 'Logical POUs' are combined in the view 'POUs'.
Editing the project structure means basically inserting or deleting POUs or worksheets in the
project structure. By double clicking on these object icons you can call the corresponding editors to
edit the data of these code bodies and variable declarations.
The system provides a feature to protect a project against unauthorized insertion and deletion of
objects (such as POUs or worksheets) in the project tree. Depending on the security settings made
by the "project owner", some operations may be restricted to users, who know the defined project
password. In this case, a key symbol is added to the object icon where the restriction was
defined.
Detailed information can be found in the topic Protecting a project using a password.
The following table shows and explains all icons used in the project tree.
Icon Meaning
Protected object. If the password protection is activated, the key
symbol is added to each object for which security settings have been
made in the related properties dialog.
10
User interface: general description Icons in the project tree
11
User interface: general description Workspace
'Physical Hardware'.
Workspace
In the workspace all worksheets are opened by double clicking on the desired worksheet icon in the
project tree.
When several worksheets are opened only one worksheet is visible. A sheet tab is assigned to
every opened worksheet. You can select (activate) a particular worksheet by clicking on the
corresponding tab or by pressing <CTRL> + <TAB>.
If the worksheet tabs are not visible, open the dialog 'Options' by selecting the menu item 'Options'
in the submenu 'Extras'. Click on the tab 'General' and activate the checkbox 'Workbook style'.
Confirm your selection with 'OK'.
It is also possible to arrange several worksheet windows in a desired combination. This way you
can easily prepare the workspace for different working phases.
• Select one of the menu items 'Cascade' or 'Tile' in the submenu 'Window'.
You can maximize the workspace, which means, that the project tree is not displayed and the
workspace is enlarged to the whole main screen width. This could be useful for displaying large
networks in graphical editors.
Depending on its previous state, the project tree window is now visible or hidden.
The cross reference list contains all variables, function blocks, actions, transitions, steps, jumps,
labels and connectors which are used within the current project. It is a helpful tool for debugging
and fault isolation.
Every POU contains its own local data. That means, if you open a particular worksheet, the local
variables in the cross reference list are updated.
12
User interface: general description Workspace
The cross reference window is a dockable window. 'Dockable' means, that you can detach the
window from the desktop by double clicking on the gray window border. It is then displayed as a
usual window, i.e. you can change the size and move the window to any position on the screen. To
reattach it into the desk, just double click into the blue window title bar.
The program allows to toggle between hidden and visible cross reference window:
If the cross reference window is not visible, click on the icon 'Cross References'.
With the help of the dialog 'Options' you can specify, which columns should be visible in the Cross
Reference window and which columns should be printed. For that purpose open the submenu
'Extras' and select the menu item 'Options...'. In the dialog 'Options' open the page 'Cross
References'. Mark the checkbox of each column which should be displayed/printed.
Variable shows the corresponding symbol and the name of the variable, FB,
step, transition, etc. If a filter is active, this is indicated in the column
heading by the following symbol:
.
The head of this cloumn also indicates whether the cross reference list
is currently up to date or not. This is represented by either a red or
green hand symbol.
The various symbols are described in the topic 'Symbols in the Cross
Reference Window'.
'POU/Worksheet' POU name in which the variable/FB is declared and the particular
worksheet name where it is implemented.
'Command' Command in which the variable is used (only applicable for IL, ST and
LD code body worksheets).
13
User interface: general description Symbols in the Cross Reference Window
'Global Path' Instance path of global variables, consisting of the configuration name
and the resource name, where the global variable is declared.
You can directly access the corresponding worksheet, where a particular variable is used or
declared. Furthermore a variable is marked in the cross reference window, if you mark the variable
in an editor or in the variables worksheet.
It is possible to sort the list entries alphabetically. Each column can be used as sort criterion. The
entries can be sorted in an ascending and descending order.
You can change the order of the columns according to your personal preferences. This can be
done by drag & drop: Click on the head of the column to be moved. Keep the mouse button
pressed while dragging the column head to the desired position. Release the mouse button to drop
the column at this position.
Additionally you can filter the cross reference list, using the dialog 'Filter Cross Reference'.
Using the dialog 'Options' (which is called in the submenu 'Extras') you can display a cross
reference toolbar, which provides icons for accessing the references shown in the cross reference
list:
In the head of the column 'Variable' three symbols are used to show the state of the cross
reference list:
means that the cross references list is currently up to date. No changes have been made and
saved in the worksheets since the cross references were built last.
indicates, that the list is not up to date. Rebuild the cross references.
indicates, that currently a filter is active. The filter settings can be accessed and changed using
the context menu item 'Filter' of the cross reference window.
In order to get a fast overview on the objects which are displayed, each item is shown with a
14
User interface: general description How to build the cross references
symbol representing its type. The following table lists the different items and their corresponding
symbol shown in the column 'Variable':
The symbols and in the head of the column 'Variable' are used to indicate, whether the cross
reference list is up to date or not. Please refer to the topic Symbols in the Cross Reference
Window.
• If the cross reference window is not visible, click on the icon 'Cross References'.
• Click with the right mouse button on the window background to open the context menu.
It is also possible to call the menu item 'Build Cross References' in the submenu 'Build' or in the
editor context menu.
From the cross reference list you can either access the code worksheet where a variable is used or
its declaration in the corresponding variables worksheet.
15
User interface: general description How to sort the cross reference list
There are several possibilities of accessing the code worksheet and mark the variable:
• Right click in the required line in the cross reference window to open the context menu.
Then select the context menu item 'Goto Position'.
• Mark the required line in the cross reference window by a left mouse click and then click
on the icon 'Goto Position' in the cross reference window toolbar:
In a similar way, you have to possibilities of accessing the variables worksheet containing the
declaration of a variable.
• Right click in the required line in the cross reference window to open the context menu.
Then select the context menu item 'Goto Definition'.
• Mark the required line in the cross reference window by a left mouse click and then click
on the icon 'Goto Definition' in the cross reference window toolbar:
If the cross reference toolbar is not visible, open the dialog 'Options' by selecting the menu item
'Options' in the submenu 'Extras'. On the dialog page 'Toolbars' mark the checkbox 'Cross
References'.
In every case the corresponding worksheet is opened automatically and the variable is marked.
It is possible to sort the list entries alphabetically. Each column can be used as sort criterion. The
entries can be sorted in an ascending and descending order.
• Click on the column name, which is intended to be the sort criterion. It is marked by an
arrow, which indicates the sort order:
If you have specified a filter string this button would appear as follows:
• Click once more on the same column name to reverse the sort order.
How to filter the cross reference list − dialog 'Cross Reference Filter'
The dialog 'Cross Reference Filter' appears if you select the menu item 'Filter' in the context menu
of the cross reference window.
The dialog is used to filter the cross reference list, to show only a particular subset of variables,
function blocks, etc.
16
User interface: general description Message Window
• Click with the right mouse button on the window background to open the context menu.
• To filter the list for a specific name, address or access, mark the corresponding checkbox
in order to activate the text field and enter the desired text. For that purpose you can use
wildcards (refer to the note below). Only elements matching this name will be displayed.
• After confirming the dialog the cross reference window contains only elements which
match the filter settings. The column 'Variable' indicates in its column head, that filter
settings are applied. The following symbol is displayed:
Message Window
The message window is located below the main screen. It contains several pages, which are
activated by clicking on the corresponding tab.
The message window is a dockable window. 'Dockable' means, that you can detach the window
from the desktop by double clicking on the gray window border. It is then displayed as a usual
window, i.e. you can change the size and move the window to any position on the screen. To
reattach it into the desk, just double click into the blue window title bar
The message window allows to display different steps during compiling, the compiler errors and
warnings and some other information.
17
User interface: general description Logic Analyzer
Depending on its previous state, the message window is now visible or hidden.
If the message window is closed when starting the compilation it appears automatically.
One of the main benefits of the message window is the possibility of direct accessing the
worksheets in which the compiler detected errors.
• Double click on the corresponding error. The corresponding worksheet appears with the
suspected code body marked.
• Right click on the desired message to open the message window context menu and select
'Help on Message'. The corresponding help topic appears.
If the Bus Configurator and the Connection Tool are part of your programming system, the
message window contains an additional tab, designated as 'Bus Configurator'. This tab shows
errors which are detected by the bus assistant and messages while handling devices in the Bus
Pallet View and the Bus Application View.
Logic Analyzer
The Logic Analyzer is a powerful tool for recording variable values in online mode and representing
them in a graphic. Using the results delivered by the Analyzer you can evaluate, whether your
program runs like intended.
Since the Logic Analyzer must be used in online mode, its operation varies depending on the used
target system.
Status bar
The status bar displays different messages while you are working with the program.
The left part of the status bar provides information about operations you have done or displays
system messages. If your mouse pointer is placed on an icon or a menu item (without selecting it)
the status displays a short description concerning the icon or menu item under the cursor.
The fields on the right show the cursor position in the editor: When using a graphical editor,
x−y−coordinates are shown, in text editors the fields display the current row and column. Beneath
the cursor position the free hard disk space is displayed. If there is not enough disk space
available, this field appears red.
The different states of the programming system are represented in the status bar by colors. The
following colors are used for the different states:
18
User interface: general description Customizing the user interface − dialog 'Options'
• gray: offline
• green: online
• red: timeout.
The submenu 'Extras' provides two commands which can be used to customize your system
corresponding to your requirements and your personal needs.
Using the menu item 'Shortcuts' you can define your own shortcuts. Selecting this menu item you
open the so called Shortcut Manager.
To customize the user interface select the menu item 'Options' in the submenu 'Extras'. The dialog
'Options' appears. This dialog is divided into 14 pages, which can be accessed by clicking on the
corresponding tab.
Beneath the button 'New...' which is used to create user defined toolbars, the
tab provides one further button. Its functionality (and name) depends on the
marked toolbar:
The button 'Delete' is only visible on this tab, if a user defined toolbar is
marked on the left. By clicking the button, the marked self−created toolbar is
deleted.
'Commands' used to display short descriptions for each icon, assign icons to the toolbars
and customize the menu bar.
'General' used to define general settings for the user interface and to specify which
tabs are visible in the project tree window.
19
User interface: general description Customizing the user interface − dialog 'Options'
'Build' used to define settings for building the project. If the upper checkbox on this
page is marked, the code generated by the compilers fulfills all requirements
set by the PLCopen base level for IL and ST. This check box should normally
be activated. Additionally it is possible to define that the text compiler allows
case insensitive keywords, according to IEC 61131. If this checkbox is
marked keywords in textual languages can be typed in lower−case letters
without getting a compiler error.
'Directories' used to define default paths for the project directory, library directory and the
pagelayout directory.
'Pagelayouts' used to define the different default pagelayouts. You can define the
pagelayout for textual worksheets, graphical worksheets and for the paper
output of the Logic Analyzer. Additionally the pagelayout for text and graphic
when using the print mode 'Optimized' can be defined.
Optimized Printing
Using the list box 'Optimized Printing' you can set the pagelayout which is
used when printing the whole project. Optimized printing means, that the
project is printed with less paper as possible. All worksheets are printed one
after the other. A new page is only used, if a new POU or a new step (in SFC)
starts. This setting applies for textual worksheets as well as for graphical
worksheets.
'Text editor' used to define the tab size, the font type and size, the column width in online
worksheets which are used in textual worksheets. Additionally you can define
whether the line numbers should be visible or hidden while editing.
'Text colors' used to define the text color in which the specific information (such as
keywords, reached breakpoints, statements, etc. and the various online
values) appear in the text editor.
'Graphical Editor' used to define the default size of graphical worksheets, the default settings for
the network layout in the graphical editor and to specify, whether FB/Fus
should be inserted with a picture inside.
'Backup' used to set up the automatic backup and the Autosave feature.
'Cross References' used to define, which columns of the Cross Reference window are visible and
which columns are printed with the project. To display/print a particular
column, mark the related checkbox with a left mouse click. Below the two
selection areas another checkbox is provided: If this checkbox is marked, grid
20
User interface: general description Creating your own toolbar
'Variables Grid' used to define, which columns are visible in variables grid worksheets and
which columns are printed. To display/print a particular column, mark the
related checkbox with a left mouse click.
'Logic Analyzer used to specify the colors in which the different curves are displayed in the
Colors' Logic Analyzer window. Since the Logic Analyzer can display the curves of up
to 10 variables at the same time, the usage of customized colors facilitates
the reading of the measured results.
It is possible to create new toolbars and "populate" them with the desired icons. This is useful if
certain operations must be done very often while editing or debugging a project. The feature
provides the possibility to put often used icons together, in order to simplify the execution of a
command sequence.
• Open the submenu 'Extras' and select the menu item 'Options'.
The dialog 'Options' appears.
• Enter the name of the new toolbar and confirm the dialog.
• The new toolbar is inserted on the page 'Toolbars'. It's checkbox is activated by default, i.e
the new toolbar is already visible in the user interface.
• Now you have to populate the new toolbar with the desired icons. For that purpose click
on the tab 'Commands'. The steps how to populate the new toolbar are described in
'Assigning commands to a toolbar'.
• On the tab 'Toolbars' of the 'Options' dialog, mark the user defined toolbar to be renamed.
The dialog field 'Toolbar name' is now active.
• Overwrite the existing name and press the <TAB> key.
• On the tab 'Toolbars' of the 'Options' dialog, mark the user defined toolbar to be deleted.
The button 'Delete' is now visible.
• Click on 'Delete'.
21
User interface: general description Dialog 'New Toolbar'
Default toolbars can not be deleted. They just can be reset to their delivery state (for example after
moving or adding icons).
The dialog is used to create a new toolbar, i.e. to enter the name of a new toolbar.
It is called by clicking on the button 'New' on the page 'Toolbars' in the dialog 'Options'.
With the help of this procedure you can assign commands to any toolbar, i.e. new created toolbars
or already existing toolbars.
• Open the submenu 'Extras' and select the menu item 'Options'.
The dialog 'Options' appears.
• To get a short description about the functionality of an icon, mark the icon with a left
mouse click. The short description is displayed in the dialog area 'Description'.
• To add an icon to a toolbar, click on the icon and keep the left mouse button pressed.
Drag the icon to the desired toolbar and release the mouse button to drop it in the target
toolbar.
To delete an icon from a toolbar open the dialog 'Options', mark the icon to be removed, drag it
outside the toolbar and drop it at any free position on the gray window border.
Using the page 'General' in the dialog 'Options' you can define general settings for the user
interface.
Language Using this list box you can set the language, in which the user
interface is started by default. Note that changes made in this field
are not applied until the program was exited and restarted.
22
User interface: general description Default path settings (directories)
Workbook Style To show the worksheet tabs which are used to activate a particular
worksheets when several worksheets are opened in the workspace,
this checkbox must be activated.
Restore default toolbar If this checkbox is activated the current position and size of the
configuration on program start toolbars and windows is saved when exiting the program. It is
recommended that this checkbox is always activated.
Open last project on program Activating this checkbox means that the last edited project is
start opened automatically after the program is started.
By pressing the button 'Reset Workspace', the arrangement of opened windows, visible menus and
toolbars in the user interface is reset to the delivery state.
In the lower dialog area you can select, which tabs are visible in the project tree window. If a
checkbox is marked, the related tab appears at the bottom of the project tree.
Using the page 'Directories' in the dialog 'Options' you can define default paths for the project
directory, library directory and the pagelayout directory.
To select the desired path, click on the corresponding browse button '...' to open the browse dialog
'Choose folder'. Browse into the desired folder and confirm the dialog.
You can only confirm this page, if the referred directories already exist. Otherwise an error
message appears. In this case enter the correct path settings and confirm the dialog again.
Using the page 'Text Editor' in the dialog 'Options' you can define default settings for textual
worksheets.
Show Tabs
23
User interface: general description Setting the text colors
Insert Spaces If this radio button is activated, pressing the <TAB> key inserts spaces
instead of real tabs.
Keep tabs If this radio button is activated, pressing the <TAB> key inserts real tabs
in stead of spaces.
Font Clicking this button calls a dialog, in which you can define the default
font type, the font size and font attribute.
Online column width determines the default width of the column at the left worksheet side,
when opening a textual worksheet in online mode.
Show line numbers If activated, each line in textual worksheets starts with a line number.
Using the page 'Text Colors' in the dialog 'Options' you can define default settings for text colors
used in the user interface.
Colors This field contains all elements for which the color can be set by the
user. To set a color for a particular element, the corresponding list entry
must be selected.
Use system color If activated, the default system color setting is used for the element
marked in the list 'Colors'. In this case the button 'User definded...'
appears grayed, i.e. inactive.
User defined This button is only active, when the checkbox 'Use system color' is not
marked. Clicking the button calls the standard Windows color palette,
where you can define and select your user defined color for the element
marked in the list 'Colors'.
Reset all colors Clicking this button resets all user defined color settings to the
predefined manufacturer settings.
Use syntax coloring If this checkbox is activated, the current color settings are applied to
code bodies in textual worksheets. This means, that keywords or
specific language elements appear colored. If deactivated the code
body appears in black.
24
User interface: general description Settings for the graphic editor
Using the page 'Graphic Editor' in the dialog 'Options' you can define default settings for graphical
worksheets.
Worksheet height/width specifies the default worksheet size for new graphical worksheets. The
size of already existing worksheets is not affected by changing these
settings.
LD network width specifies the width for LD networks which are going to be inserted in the
graphic editor.
Contact width specifies the width for contacts which are going to be inserted in the
graphic editor.
Grid width defines the width of the grid, which can be activated in order to align new
inserted objects automatically. The radio buttons and fields have the
following meaning:
'Use contact size' – the grid width is adjusted automatically to the set
contact size. If this option is activated, the text fields 'Width' and 'Height'
are grayed, i.e. they cannot be changed.
'User defined' – the grid width is set manually by entering the desired
values into the text fields 'Width' and 'Height'.
Collision delay time sets the delay time, after which the graphic editor automatically corrects
collisions of objects. A collision may occur, if you move an object by
dragging it or if you have inserted a new object (e. g. using the Edit
Wizard).
Bold Font displays text (i.e. variables, identifiers, comments, etc.) with a bold font.
Functions with EN/ENO enables the insertion of functions with the control input EN/ENO. EN/ENO
designates an additional boolean input 'EN' (= enable) and output 'ENO'
(= enable output) for IEC 61131 functions in the programming languages
25
User interface: general description Setting the colors in graphical worksheets
LD and FBD.
Create FB/FUs with specifies whether functions and function blocks should be inserted with a
Pictures picture inside and how the picture should be arranged.
Using the page 'Colors graphical editor' in the dialog 'Options' you can define default colors settings
for graphical worksheets.
Colors This field contains all elements for which the color can be set by the user.
To set a color for a particular element, the corresponding list entry must
be selected.
Use system color If activated, the default system color setting is used for the element
marked in the list 'Colors'. In this case the button 'User definded...'
appears grayed, i.e. inactive.
User defined This button is only active, when the checkbox 'Use system color' is not
marked. Clicking the button calls the standard Windows color palette,
where you can define and select your user defined color for the element
marked in the list 'Colors'.
Reset all colors Clicking this button resets all user defined color settings to the predefined
manufacturer settings.
When using a If this checkbox is marked, a monochrom printer only prints the borders of
monochrom printer, FU/FB symbols. Color printers are not affected by this setting.
print only frames
Using the page 'Debug' in the dialog 'Options' you can define the settings for the debug behaviour
of the system.
Warning in case of This option shows/hides the specific warning message when debugging
multiple POU instances worksheets i.e. calling worksheets in online mode. The warning
message appears if already opened function block code bodies or
program code bodies are instantiated several times and you want to
26
User interface: general description Settings for project backups and the Autosave feature
switch to online mode using the icon 'Debug on/off'. In this case you
have to open the context menu of the affected worksheet in the project
tree and select 'Open Instance...'. In the appearing dialog select the
desired instance.
Warning before execute This option relates to the dialog 'Project control'. If this checkbox is
command marked, a warning message appears each time you have clicked on a
command button (such as 'Download', 'Cold' or 'Reset') informing you,
that the selected command will be executed for all connected
resources. To execute the command confirm the message dialog with
'OK'.
Warning if a command This option relates to the dialog 'Project control'. If this checkbox is
can not be executed for a marked, a warning message appears, if the command you have
selected resource invoked by clicking the appropriate button in the dialog 'Project control'
(e.g. downloading, starting or resetting the PLC) can not be executed
on one of the selected resources.
Execute download for This option relates to the dialog 'Project control'. If this checkbox is
selected resource only if marked, the code to be downloaded is compared with the code which is
different code already stored on each selected resource. If this comparison indicates,
that the code already stored on a target is identical with the code to be
downloaded, the download is not executed for that particular resource.
Using the page 'Backup' in the dialog 'Options' you can define the settings for the backup behavior
of the system and the Autosave feature.
Important: If the automatic backup feature is activated, the system does not overwrite backups
which are created manually by the use of the menu item 'Save project as/Zip project as...' in the
'File' submenu. The system rather creates a backup file which is named project_name_back.zwt.
Backup project Using these radio buttons you can define, in which interval the system
automatically creates a project backup. By default the option 'Never' is
activated. If you leave this setting unchanged, it is recommended to
backup the project manually by the use of the dialog 'Save/Zip project as'.
Autosave all unsaved By activating the radio button 'Every', the text field 'Minutes' is enabled.
worksheets This field is used to define the autosave time interval.
27
Handling a project
If you have called the program without a project you get an empty workspace. In this case you have
to create a new project or open an existing project.
You can either save the contents of edited worksheets or zip all necessary files of your project into
one archive file. It is recommended to copy these archive file regularly to a backup disk to assure
the safety of your data. We recommend to zip a project at least once per day and to safe it on a
floppy disc or on a network.
The easiest way of creating a new project is using the Project Wizard which guides you in 6 steps
through the creation process. You can simply define name and type of the project, the initial POU,
the configuration, the first resource and the first task.
How to proceed:
• Enter the desired information in the different step dialogs and confirm each step dialog by
clicking on the button 'Next'.
Note: For detailed information about the various step dialogs please refer to the topics
listed below.
• By confirming the last step (6 of 6) by clicking on the button 'Finish', the new project is
created automatically and appears in the project tree with the previously entered settings
and identifiers.
The dialog 'New Project' appears if you click on the icon 'New Project' in the toolbar or you choose
the menu item 'New Project' in the submenu 'File'.
It is used to select a predefined PLC specific project structure while creating a new project.
• If you want to create the new project by the use of the Wizard, select the Project Wizard
icon.
Otherwise, i.e. if you want to use a usual template, mark the desired template in the list of
templates.
28
Handling a project Dialog 'Project Wizard (Step 1 of 6)'
Depending on your selection now either the Project Wizard is invoked, guiding you through the
creation process or the chosen template is applied. Both procedures are described in the topics
listed below.
Enter the desired project name into the first input field.
According to the rules for designating projects, the name of the project must not contain any blanks
or special signs. The maximum number of characters is 24.
Choose the project path in the second input field as described below:
Enter the name of the first program POU which is created automatically for the new project into the
input field.
According to the rules for designating POUs, the name of the initial POU must not contain any
blanks or special signs. The maximum number of characters is 24.
Choose the language of the initial POU by activating the related radio button.
Enter the desired configuration name into the input field. A configuration can be compared to a
programmable controller system, e.g. a rack.
According to the rules for designating configurations, the name of the configuration must not
contain any blanks or special signs. The maximum number of characters is 24.
For detailed information about configuration types please refer to your PLC manual.
Enter the desired name of the first resource into the input field.
According to the rules for designating resources, the name of the resource must not contain any
blanks or special signs. The maximum number of characters is 24.
In the list box select the resource type. A resource can be compared to a CPU which can be
inserted in a rack. The list box only offers CPU types which belong to the configuration you have
29
Handling a project Dialog 'Project Wizard (Step 5 of 6)'
defined in step 3. You cannot select a type of resource which does not fit to the selected
configuration type.
Enter the name of the first task into the input field.
The task name must not contain any blanks or special signs. The maximum number of characters
is 7.
In the list box select the task type. There are three different task types:
• Cyclic tasks are activated in a certain time interval and the program is executed
periodically.
• System tasks are called automatically by the PLC operating system if an error or a
change of the operational state of the PLC occurs. They are also known as system
programs or SPGs.
• Event or interrupt tasks are activated if a certain event has happened. For detailed
information please refer to the PLC specific online help.
This dialog shows the project description (i.e. an overview on the settings you have made in step 1
to step 5). If any faulty name was entered the error message 'Invalid name' appears and the button
'Finish' is greyed out. In this case check the spelling of the suspected identifier. To correct an error
browse to the according step by using the button 'Back'. Make sure that the rules for defining
identifiers are observed.
If no error message occurs click on the button 'Finish' to create the new project.
New projects can be either created with a template or by using the Project Wizard. This topic
describes the first method.
A template relates to a specific PLC type and contains predefined POUs, worksheets and
configuration elements which are e.g. necessary for the chosen PLC type.
How to proceed:
• Choose a template.
30
Handling a project Opening an existing project
• Start editing.
The project 'Untitled' includes automatically one POU: the program 'Untitle' (see note below). The
program has 3 worksheets:
• The variables worksheet 'UntitleV' for the declaration of variables and function block
instances.
• The code body worksheet 'Untitle' for the code body definition.
Some properties of this program can be changed. The default language for the first autoinserted
program is IL, thus the language cannot be changed. If a program in another language is required,
you have to insert a new POU.
Depending on the template you have selected in the dialog 'New Project' the name of the first
POU/worksheet may differ. Instead of 'Untitled' for example 'Main' can be used.
To open an existing project you have to use the dialog 'Open/Unzip project'.
Each existing project consists of a *.mwt file and a corresponding folder which contains the various
files relating to the project.
Example: The project folder shown below contains two projects: 'Contain' and 'Example'. Each
project consists of a *.mwt file and a relating subfolder.
In the dialog three different file types can be selected. They are described in the following table:
File Description
*.mwt Project file
*.pwt Project file which was created with an older (16 Bit)
version of the programming system.
You can open project files of this file type, if they are
created with a programming system version younger
than 1.3.6.14. Projects which were created with an
31
Handling a project Saving worksheets while/after editing
How to proceed:
• In the list box 'File type:' select the entry 'Project Files (*.mwt;*.zwt)'.
• Choose the project you want to open by clicking on the desired project file.
While and after editing worksheets in the text editor, the graphic editor and the pagelayout editor
you should save the changes.
It is recommended to save changes regularly while editing. In case of a power failure or other
events you risk loss of data if you do not save your work.
If you close a changed worksheet without having saved it the dialog 'Save changes' appears.
How to proceed:
• Click on the icon 'Save' in the toolbar to save the current worksheet.
Autosave feature
The system provides an Autosave feature for unsaved worksheets. To enable this feature and set
the time interval call the dialog 'Options' and open the page 'Backup'. In the related dialog area
activate the radio button 'Every' and enter a value.
32
Handling a project Dialog 'Save changes'
Related topics:
The dialog 'Save changes' appears if you close a changed worksheet in the text editor, the graphic
editor or pagelayout editor without having saved it.
You can save an existing project with a different file name or in a different path or drive.
If you are saving an existing project using a new name the old version of the project remains on
your hard disk.
How to proceed:
• Choose the menu item 'Save/Zip Project as/Zip Project As' in the submenu 'File'.
The dialog 'Save/Zip project as' appears.
The entire project is now copied to a new project folder and the copied project file is
renamed. After saving the new project, the origin project is closed and the copied project
remains opened with an empty workspace.
You can save an existing project as a template. After saving a project as template, the new
template is contained in the dialog 'New Project'.
How to proceed:
33
Handling a project Dialog 'Save As Template'
The dialog 'Save As Template' appears if you select the menu item 'Save As Template' in the
submenu 'File'. It is used to save an existing project as a template, which can then be selected in
the dialog 'New Project' when creating a new project.
Deleting a template
You can delete an existing template. The deleted template can be either a default template which
was delivered with the programming system or an user template which was created by saving a
project as template.
How to proceed:
The dialog 'Delete Template' appears if you select the menu item 'Delete Template...' in the
submenu 'File'. It is used to delete an existing template.
The system provides the possibility of protecting a project using a project password. Using this
feature you can restrict the access rights on securable objects. Securable objects may be whole
subtrees or single project nodes, such as POUs or the worksheets in a POU. The table in the topic
Security settings... gives you an overview.
These restrictions are handled as so called "negative rights". This means, that as long as no
password is activated, each user has full access on the project.
Using the different properties dialogs of the securable objects in the tree, you can restrict access
rights. This can be done either for whole subtrees or for example single POUs. For example it is
possible to protect the whole subtree 'Logical POUs' against unauthorized inserting of POUs or
worksheets or only the worksheets of one single POU against saving changes.
The protection is enabled after a password is defined and activated. This is done within the dialog
'Project password'. After activating the password a key symbol is displayed beneath each
restricted icon in the project tree.
• each user has to log in using the valid password in order to get full access on the project.
• each user has to log in using the valid password in order to disable the password
34
Handling a project Logging into a protected project
• when closing and re−opening the project, the protection is automatically active.
• Changing the structure of subtrees by inserting and deleting objects within the subtree.
This is done in the dialog 'Project properties'. The dialog contains an own tab for security
settings, concerning only the project structure.
• Access rights for reading and writing worksheets within a subfolder in a subtree. This
includes data type woksheets as well as variables worksheets and code body worksheets
in the subtree 'Logical POUs'. These rights can be set for a whole folder, i.e. all
worksheets of a POU or all data type worksheets.
If a worksheet is write protected, changes can not be saved. If read protection is enabled,
it is not possible to view the worksheet until the valid password has been entered.
Read and write protection is specified on the 'Security' tab of the properties dialog of the
data types folder or a POU subfolder.
• Access rights for reading, writing, downloading and debugging single configurations
and resources in the subtree 'Physical Hardware'.
If the password protection is already enabled for a project (this is indicated by a key symbol
which is displayed beneath restricted icons), you first have to log into the project using the valid
password.
Without this password it is not possible to edit restricted parts of the project, to change access
rights or to cancel restrictions because the related dialog tabs are inactive.
• Select the menu item 'Enter password...' in the submenu 'File'. The dialog 'Project login'
appears instead of the dialog 'Project password'.
Now you have full access on the project. The key symbol is now deleted in the project tree
window.
The steps to be done to protect a project or to change the security settings for an already protected
project are different, because in the second case you additionally have to log in.
• Call the corresponding properties dialog and choose the desired restrictions by marking
the related checkboxes.
35
Handling a project Logging into a protected project
Which dialog you need for which restriction is described in the topic Security settings....
Confirm the security settings.
• Call the dialog 'Project password' using the menu item 'Enter password...' in the submenu
'File'.
In the dialog enter a password and verify it by typing it a second time in the lower field
'Password confirmation'.
• The password protection becomes only valid after activating the defined password. This
means, that is it not enough to define a password; you have to activate it explicitly by
clicking on the button 'Activate password'. After activating the password, a key symbol
is added to each restricted object in the project tree.
If the password protection is already enabled for a project (this is indicated by a key symbol
which is displayed beneath restricted icons), you first have to log into the project as described
above.
• Select the menu item 'Enter password...' in the submenu 'File'. The dialog 'Project login'
appears instead of the dialog 'Project password'.
• Then proceed by calling the corresponding properties dialog and select the desired
restrictions by marking the related checkboxes with the left mouse button.
Which dialog you need for which restriction is described in the topic Security settings....
• Having changed the security settings in each required properties dialog you have to
re−activate the password.
For that purpose select once more the menu item 'Enter password...' in the submenu 'File'.
Now the dialog 'Project password' appears.
Once a password is activated, the protection is automatically enabled, when re−loading the project,
i.e. in order to get full access, you have to log in. To disable the password protection permanently
the password must be removed. For that purpose perform the following steps.
• Open the submenu 'File' and select the menu item 'Enter password...'
• If the dialog 'Project login' appears (i.e. the protection is active) enter the valid password
and then click on the button 'Edit password'.
The dialog 'Project password' appears.
36
Handling a project Security settings in the various properties dialogs
After removing the password each user has full access without logging in.
The security settings are made in the 'Security' tab of the properties dialogs. Depending on the
object, different settings can be selected.
Keep in mind, that you need the password to change the security settings of an already protected
project and that the settings are only valid, if you activate the password afterwards. Further
information are contained in the topic Steps for protecting a project....
37
Handling a project Password dialogs
Password dialogs
Two different password dialogs are used. Both dialogs are called using the menu item 'Enter
password...' in the submenu 'File'.
Which dialog appears depends on the current protection state of the project:
• If no password is yet defined or activated, the dialog 'Project password' appears. See
description below.
• If you have already defined and activated a password, the dialog 'Project login' appears.
See description below.
This dialog appears, if no password is defined or activated and when selecting the menu item
'Enter password...' in the submenu 'File'. It is used to define or change and activate a project
password.
It is not sufficient to define a password only. The password must be activated explicitly using this
dialog. This has to be done each time, when the password protection has to be enabled, i.e. after a
password has newly been defined or after you want to log out of a project after changing the project
or the security settings.
Password text field for entering a password. The entered characters are
displayed as asterisks. A password must consist of at least 5
characters.
Password confirmation When defining/changing a password, you have to confirm the string
entered in the field 'Password' by typing it a second time in this field.
The password can only become active, if the confirmation is identical
with the entry in the upper text field.
Activate password Pressing this button activates the defined password immediately
without reloading the project. If no password was defined or the string
entered in the confirmation field is not identical with the first entry, an
error message appears and you have to fill in the password fields
again. After activating the password, a key symbol is added to
each restricted object icon in the project tree.
Remove password After clicking on this button, the current password is removed from the
project. From this moment, the whole project is accessable without
38
Handling a project Defining and changing a password
OK Clicking this button saves the entered password and closes the dialog
without activating the password immediately. The password becomes
active after opening the project the next time. For activating the
password protection immediately you have to click 'Activate
password' instead of 'OK'.
Cancel After pressing 'Cancel' the password dialog is closed. The password
is neither saved nor activated.
This dialog appears, if a password is already activated and when selecting the menu item 'Enter
password...' in the submenu 'File'.
After logging in, the project is fully accessible. In order to re−activate the password protection you
• either have to re−activate the password using the dialog 'Project password' (menu item
'Enter password' in the submenu 'File')
• or close the project. After reloading a protected project, the protection is automatically
enabled.
Password text field for entering a password. The entered characters are
displayed as asterisks.
Edit password Clicking on this button closes the login dialog and calls the dialog
'Project password' (assumed that you have entered the valid
password) in which you can change, activate or remove the
password.
OK Clicking on 'OK' closes the login dialog (assuming that you have
entered the valid password) and you have full access on the project.
Cancel The login dialog is closed without validating the entered password.
The password protection is not removed.
Note, that you need to know the valid password in order to change this password!
39
Handling a project Zipping project files into an archive file
• If the password protection is already active, the dialog 'Project login' appears.
Here, enter the valid password an press 'Edit password'.
• Enter the new password a second time in the field 'Password confirmation'.
• Press either 'Activate password' to enable the password protection immediately (without
re−loading) the project
or press 'OK' to close the dialog without activating the password.
In this case, the protection becomes active automatically after opening the project the next
time.
You can zip all files of your project into one archive file. This zip archive contains all files which
belong to the project, i. e. the project file 'projectname.mwt' itself, the code body files, variable
declarations and some internal files which are necessary to restore the project from the archive.
Therefore the zip functionality can be used to create project backups.
It is recommended to zip your files regularly, e.g. once a day, and to save your archive on a floppy
disk to make sure that no loss of data occurs.
Zipping a project is performed in the dialog 'Save/Zip Project as'. To activate the available zip
options, you first have to select the entry 'Zipped Project Files (*.zwt)' in the list box 'File type'.
The basic zip operation (without using any of the options described below) zips the following files
into the archive: All POUs, the data type worksheets and all configuration data. The result is a small
archive file.
When zipping a project you can additionally zip libraries, the frontend code and pagelayouts
together with your project files into the same archive. For that purpose, the dialog 'Save/Zip Project
as' provides several options, which can be selected in conjunction with the zip operation. It is
possible to use only one option or several options at the same time.
Zip FW−Libraries all firmware libraries which have After unzipping a project, you have
been announced. to reconnect the project to the
extracted library.
Zip frontend code all files generated during Creates bigger archive file. There
compilation of the project and the is no need to compile the libraries
40
Handling a project Dialog 'Save/Zip project as'
Zip pagelayouts all pagelayouts used in the project bigger archive file.
and all bitmaps used in the
pagelayouts if they are stored in the
default pagelayout directory.
How to proceed:
• Choose the menu item 'Save Project as / Zip Project As' in the submenu 'File'.
The dialog 'Save/Zip project as' appears.
• Open the list box 'File type:' and select the entry 'Zipped Project Files (*.zwt)'. The
checkboxes for selecting the 'Zip Options' become active.
• Enter a name for your zip file in the text field 'File name:'.
Automatic backup
The system provides an automatic backup feature. This means that you can define, whether the
system creates a project backup, each time you close the project or if an user defined time interval
has elapsed. To define these settings, please call the dialog 'Options' and open the page 'Backup'.
Important: If the automatic backup feature is activated, the system does not overwrite backups
which are created manually by the use of the menu item 'Save project as/Zip project as...'. The
system rather creates a backup file which is named project_name_back.zwt.
The dialog 'Save/Zip project as' appears if you choose the menu item 'Save Project As / Zip Project
As...' in the submenu 'File'.
• to save an entire project under a different name and/or with a different path.
• to zip a project in order to create a backup archive. In this case you have to select the
entry 'Zipped Project Files (*.zwt)' in the list box 'File type:'.
How to proceed:
• Choose the menu item 'Open Project/Unzip Project...' in the submenu 'File'.
The dialog 'Open/Unzip project' appears.
41
Handling a project Translating a project
• In the list box 'File type' select the entry 'Zipped Project Files (*.zwt)'.
• Enter the name and the path of the archive file manually or browse for the desired archive
(*.zwt) file.
• A dialog appears asking you, whether you want to overwrite the current project with the
zipped project or to unzip the zipped project into a new project named 'Untitled' or to
cancel the unzip operation.
If the current project is not yet saved (i.e. it is still 'Untitled') you can either overwrite it or
cancel the operation.
Click on the desired option.
• If the archive contains a zipped firmware library which already exists on your computer, a
message window appears, asking you, whether you want to overwrite the currently stored
FW−library with the zipped FW−library or you want to define a new name for the
FW−library to be extracted.
After unzipping a firmware library with the project, you have to reconnect the project with the
extracted library.
Translating a project
Assume that a project was developed in German, i.e. all comments and description worksheets are
written in this language. Assume further that the maintenance staff has to expand or change this
project but is not able to understand German.
Due to the system feature which allows you to translate project comments and descriptions into any
language, situations like the above described are no problem any more.
Basically the translation process is divided into four steps. Each step (except step 2, which is
independent from your programming system) is described in a specific topic.
Step 1: Exporting all translatable text strings into a project translation export file with the file
extension 'txt'. This file then contains all comments and the contents of the description worksheets.
Step 2: Translating the project translation file. The translation can be done manually or by the help
of a specific tool, such as a database supported translation tool.
Step 3: Selecting the new project language and re−importing the translated txt−file into the
programming system.
42
Handling a project Exporting a project translation file
In order to translate a project into another language, you first have to export all translatable texts
into a so called project translation file. Translatable texts are comments and the contents of the
description worksheets. Of course it is not possible to translate text elements which are
programming language specific.
The translation file is a usual ASCII−file with the extension 'txt', i.e. it can be opened and edited with
each ASCII−editor. Therefore it is also possible to use customary translation tools for translating
the file into the target language.
• Open the submenu 'File' and select the menu item 'Export...'.
The dialog 'Import / Export' appears, showing all system add−ins which can be used for
exporting files from the project.
• In the dialog list box mark the entry 'Project translation export' and confirm the dialog.
The browse dialog 'Project translation export' appears.
• In the dialog 'Project translation export' browse to the desired destination directory and
enter the name of the export file into the dialog field 'File name'.
The next step is to open the export file and translate it either manually or with the help of a
translation tool.
When you have translated the project translation file, you first have to select the language of the file
to be imported and then import the file into the project, before you can switch the project language.
• Open the submenu 'File' and select the menu item 'Import...'.
The dialog 'Import / Export' appears, showing all system add−ins which can be used for
importing files into the project.
• In the dialog list box mark the entry 'Project translation import' and confirm the dialog.
The browse dialog 'Project translation import' appears.
• In the dialog 'Project translation import' select the language of the text file to be imported.
For that purpose open the list box 'Language' and choose the desired entry.
Note: The language selected here is then available in the properties dialog of the project,
where you can switch the language.
• Browse to the desired directory and select the desired import file.
43
Handling a project Switching the project language
The language is now available in project, but it is not switched automatically. The next step is to
open the properties dialog and switch the project language.
When you have imported a project translation file, you can switch the project language.
• In the project tree open the context menu of the folder icon 'Project' by clicking with the
right mouse button on it.
Using the command 'Compare POUs' you can easily compare the POUs of two projects. This is
useful, if you for example want to verify, whether the project stored or running on a PLC is still
identical with the version on the harddisk of your PC.
For comparing POUs of two projects, the IEC intermediate code of both projects must be available.
This means, that both versions to be compared must have been compiled before, using the
command 'Make' or 'Rebuild Project'. Changes which have been made after generating the IEC
code are not detected by the comparison.
• any differences in code body worksheets and variable worksheets in those POUs which
exist in both projects.
Execption: Different text comments are not considered as differences.
• any differences in the structure of the subtree 'Logical POUs'. This means that additional
POUs or code body worksheets in the current project are detected.
Execption: New description worksheets are not considered as differences.
For comparing the POUs of two projects perform the following steps:
• Open the project which you want to compare with another project.
44
Handling a project Switching the project language
• Make sure, that the current project has been compiled without errors and the IEC
intermediate code is available.
• Open the submenu 'Project' and select the menu item 'Compare POUs'. The dialog 'Select
Project' appears.
• Browse for the project to be compared with the current project. Mark the desired project
file and mark the checkbox 'Open as read−only' if desired.
Then click 'OK'.
• The dialog is closed and the comparison is started automatically. The results of the
comparison are displayed in the 'Info' tab of the message window, as shown in the
following figure:
By double clicking on an entry in the message window, the corresponding worksheet is opened in
the workspace.
45