View
67
Download
1
Category
Tags:
Preview:
DESCRIPTION
runtime manual winlog
Citation preview
© 2009 Sielco Sistemi Srl
Runtime Guide
Runtime Guide
by Sielco Sistemi Srl
Simple and flexible, Winlog Pro is a real time SCADA/HMIsoftware package for the supervision of industrial and civilplants. An integrated development environment providesdifferent tools (Gate Builder, Template Builder, Code Builder)for the easy and intuitive creation of multilanguageapplications.An extensive library of drivers and an OPC Clientinterface allow communication with most electronic devicessuch as PLCs, controllers, motor drives, i/o modules; specialfunctions can be integrated directly by the developer; standardformat of history files (DBF, CSV) and ODBC (SQL) supportensure interface with most Windows applications (Excel,Access, etc.). Winlog Pro makes it possible to set up adistributed Client/Server architecture with TCP/IP protocol onIntranet/Internet network or to create web applicationsaccessible from standard browsers; both fix and mobile (GSM)telephone network can be used to communicate with remotedevices or to send SMS.
3Contents
© 2009 Sielco Sistemi Srl
Table of Contents
Foreword 0
Part I Introduction 6
Part II Runtime 8
Part III Recipes 11
................................................................................................................................... 111 Recipe Introduction
................................................................................................................................... 122 Recipe Models
................................................................................................................................... 133 Recipes Management
Part IV Supervision 17
................................................................................................................................... 171 Introduction
................................................................................................................................... 172 Template
................................................................................................................................... 193 Events status
................................................................................................................................... 204 Alarms Status
................................................................................................................................... 215 Gates Status
................................................................................................................................... 226 System status
................................................................................................................................... 247 Devices Status
................................................................................................................................... 248 Events Historical DB
................................................................................................................................... 259 Alarms Historical DB
................................................................................................................................... 2510 Operator Interventions
................................................................................................................................... 2511 Charts
......................................................................................................................................................... 25Introduction
......................................................................................................................................................... 26Groups
......................................................................................................................................................... 27Change of a Group
......................................................................................................................................................... 28Time Axis
......................................................................................................................................................... 28Aspect
Part V Reports 31
................................................................................................................................... 311 Introduction
................................................................................................................................... 312 How to Draw up a Report
................................................................................................................................... 313 How to Show a Historical Report
Part VI Macros 35
................................................................................................................................... 351 Introduction
................................................................................................................................... 352 Execution of a macro
Part VII User’s codes 37
................................................................................................................................... 371 Introduction
Runtime Guide4
© 2009 Sielco Sistemi Srl
................................................................................................................................... 372 Insertion of the Access Code
................................................................................................................................... 373 Definition of the Operator’s Codes
................................................................................................................................... 384 Definition of Names and Groups
................................................................................................................................... 395 Definition of the Access rights to Pages
Part VIII Windows Management 41
................................................................................................................................... 411 Introduction
................................................................................................................................... 412 Management
Part IX Multilanguage 43
................................................................................................................................... 431 Introduction
................................................................................................................................... 432 Building multilanguage apps
................................................................................................................................... 443 Adding a new language
................................................................................................................................... 454 Changing Language at runtime
Index 47
Part
I
6 Runtime Guide
© 2009 Sielco Sistemi Srl
1 Introduction
The RunTime section allows the control and supervision of a project. To execute a project you cancall up directly RunTime (in this way the default project will be executed) or select the itemExecute of a project from Project Manager.
Part
II
8 Runtime Guide
© 2009 Sielco Sistemi Srl
2 RuntimeThe figure below shows the main window with all its parts. At the top there is the title of the project(application) during the supervision phase. The main menu allows you to access all the RunTimeparts; there are two ways to access the menus while you are working: by selecting with a click ofthe mouse the single items, or with the ALT key in combination with the underlined letter of themenu.
The quickstart buttons allow to access directly the desired pages with a simple click. The meaningof the icons is the following:
printer setup: allows to specify the printer to use
print: print the page currently shown
recipe: opens the page for the recipe management
system status: shows the system status
device status: shows the devices status
gate status: shows the gates status
alarms status: shows the status of the alarms
events status: shows the status of the events
9Runtime
© 2009 Sielco Sistemi Srl
historical alarms: shows the page with the history of the alarms
historical events: shows the page with the history of the events
user changes: shows the page with the operations done by users
chart: shows the page for the chart management
multilanguage: allows to change the language of the application
make report: allows to create a report
view report: allows to open a report
password: allows to change user
A red exclamation mark beside the icon indicates an anomaly.
The alarms bar shows the message of the last activated alarm. To eliminate these messages youhave to confirm active or awaiting confirmation alarms, by opening the corresponding window.
At the bottom right there are the present date and time, and the name of the last logged operator(present operator). All the operations involving some changes in the status of the supervisedprocess, will be recorded with this name.
The middle part (dark grey) contains windows that the operator calls up from the menu. RunTimeallows to open as many as 8 windows simultaneously. All the open pages are continuouslyupdated according to the present status of the plant, so, at all times, the present situation isdisplayed.
Part
III
11Recipes
© 2009 Sielco Sistemi Srl
3 Recipes
3.1 Recipe Introduction
One of the main functions of RunTime is the recipes management.
The recipes are a set of process variables (Gates); therefore they can represent a type ofproduction or a particular configuration of the supervised process.
The first step to build a recipe is the creation of a Model. It represents all the variables necessaryfor the recipe.
Once you have defined the models needed to manage the process, you can create variousrecipes for each model, so as to have different types of process functioning.
Select the item Recipe Managment... under the Recipe menu to see the window above.
In this window you can see recipe models (the yellow folders in the left side), recipes of theselected model (cyan icons in the right side) and a search bar on the upside.
Under menus there are common operations (creation, deletion, copy, etc...) that can be applyed torecipe models and to recipes too; these operations, except creation, can be indiferrently applyedto models or recipes, the actions is performed on the currently selected (blued) recipe or model.
12 Runtime Guide
© 2009 Sielco Sistemi Srl
The same actions are available if some elements are selected and then the right button of themouse is pressed.
The double click of the left mouse button over an element (model or recipe) is another way toedit the element.
3.2 Recipe Models
A model is a set of system variables (called Gates) organized in groups. In the upper part of thewindow it is possible to browse the various gates defined in the running project. A gate can besearched by its name or by its description using the buttons in the upper part of the window. Oncethe desired gate is selected, you can add it to the recipe model simply pressing the Add gatebutton: the gate will be added into the group of gates shown at the bottom of the window.
It is possible to organize the gates of a recipe model in different groups. Putting in the same groupthe gates that are in some way correlated, the compilation of the recipe with the desired valueswill be easier.
It is possible to assign a description to the recipe model using the Comment button. Using theWarning button you can see any eventual message that informs you about problems in thecomposition of the model.
13Recipes
© 2009 Sielco Sistemi Srl
The OK button allows to exit the window saving the changes made; the Cancel button closes thewindow without saving changes.
A model name can be maximum 255 characters and cannot contain special characters such as: \* : . , ; + “ etc.
3.3 Recipes Management
Once a recipe model is created, it is possible to generate from this all the desired recipes. Toperform the operations on the recipes press the button Recipe or press the right mouse buttonover the name of a recipe. There are several options.
14 Runtime Guide
© 2009 Sielco Sistemi Srl
There are many ways to do the same thing in the recipe manager.The possbility to create a recipe is available under the file menu and also in the popup menushown when right mouse button is clicked in the right area (the one that contains recipes).In this way, a default name (new recipe) recipe is created and its name can be immediatelychanged.The structure of the recipe created is inherited from the parent model and cannot be modifed.In the example in figure above the parent model of the New recipe is Produzione.Before the creation of a new recipe it is always necessary to select a parent model to inherit from.
After the creation of the new recipe, it can be edited by the double click of the left mouse button orthe edit item of file menu (recipe must be selected); the edit choice is also available in the popupmenu that appears after the right click of right mouse button.The only editable features of a recipe are the values (values can be imported or manually edited)and the text description.
15Recipes
© 2009 Sielco Sistemi Srl
The recipe edit window is very similar to the model one, it differs in the denied possibility of modifythe structure (gates and groups) and the availability of buttons to import or export recipe values.Gates values (fourth column) can be manually inserted in a wise way, double click the fourthcolumn cell to edit the value contained.As it is shown in figure above, after the double click, value contained in the cell will be edited.Description column is another column that can be edited in the same way of the values one.
A window is shown during the importation (exportation too) of a recipe, it shows the liveimportation gate by gate. It is possible to stop the operation with the stop button.
Part
IV
17Supervision
© 2009 Sielco Sistemi Srl
4 Supervision
4.1 Introduction
The supervision section allows to monitor the present status of the process, change some of itsvariables and analyse its historical data.
4.2 Template
It is possible to call up the configured supervision pages by selecting, from the menu Supervision |Template, the corresponding Template. Every object on the page is updated in real time. All ofthem have a contextual menu called up selecting the object with the mouse right button. Thismenu varies according to the type of object it is referring to. For more details see TemplateBuilder.
Labels
They can represent a static text (a title or an indication) or the value of a variable (e.g. Gate TR1).
The contextual menu allows to visualize the properties of the object, or, if the label refers to avariable, to access the dialog box showing the present status of the gate.
Images
Usually they indicate the functioning status of the corresponding parts of the template (e.g.:normal functioning, stopped, anomaly); they are represented by bitmaps or metafiles. Everyimage, can have a certain number of states and to each of them is associated a different image.Moreover, if planned, it is possible to access the higher level Templates with a click or doubleclick.
The contextual menu allows to show the properties of the object or to open the expectedTemplates.
Buttons
They can have different functions depending on their configuration:
· They open a Template
· They execute a function
· They stop the execution of a function
· They Apply a series of changes in the present status without closing the Template
· They undo a series of changes carried out closing the Template
· They apply a series of modifications carried out closing the Template
Standard Controls
The Templates can also have Windows standard controls (Edit, Combobox, Checkbox, RadioButton, Etc.). The utilization of this controls is completely intuitive (see the Windows guide formore details). Usually, they allow the operator to modify the process status. The carried outmodification can change the value of a gate:
1. Directly, the operator carries out a change whose result is immediately transferred to thegate
18 Runtime Guide
© 2009 Sielco Sistemi Srl
2. On confirmation, the result of the change is transferred to the gate only if the commandApply or OK is used (see Buttons)
Examples
As first example here is a template of an extruder.
The Template contains:
· Images indicating the functioning status of the corresponding parts (normal functioning,stopped, anomaly). The contextual menu allows to show the properties of the objects or toopen the accessible Templates, anyway they can be opened with a click or a double click (if itis possible).
· Labels showing the value of a variable (e.g. 100 °C, value of the gate TR1). The contextualmenu allows to show the properties of the object, or, if the label refers to a variable, to accessa dialog box showing the present status of the gate.
· Two keys (Zones Status, Startup Sequence) that, if pressed, open the correspondingTemplate.
The second example shows a configuration page of the R1-50 device.
In this case all the controls have been configured so as to affect changes to the value of the gatesonly if the operator press the Apply or the OK button.
19Supervision
© 2009 Sielco Sistemi Srl
4.3 Events status
This page shows the list of the active events, to be confirmed or excluded.
The presence of active events is indicated by a red exclamation mark on the status icon of the
events on the bottom left of the screen ( ) that, if pressed, opens directly the page of the eventsstatus, shown in figure below.
Each row of the list represents an event; the columns have the following meaning:
1. Active: an X indicates that the event is still active
2. Conf.: an X indicates that the event has been confirmed by the operator
3. Message: shows the message defined by the event
4. Date and Time: relating to the event activation
5. Class 1 and 2: defined by the event
6. Acknowledge: an X indicates if the event needs to be confirmed in order to be removedfrom the list
7. Excluded: an X indicates if the event has been excluded by the operator. The excludedevents remain in the list until they are enabled. This characteristic is lost when you exit thepresent session of RunTime. Each row has a color:
1. Red: the event is still active
2. Blue: the event is no longer active but confirmation is needed
Black: the event has been excluded
20 Runtime Guide
© 2009 Sielco Sistemi Srl
Sort
Press this button to show the window in figure below. In it, you can choose a criterion determininghow to sort the events list.
The possible criteria are: Date & Time, Class 1, Class 2 and Message
Confirmation
To confirm an event you just need to select it and press the Ack button or, more simply, doubleclick on the corresponding row.
4.4 Alarms Status
This page is the same as the events one.
The presence of active alarms is indicated by a red exclamation mark on the status icon of the
alarms on the bottom left ( ). Moreover, the messages of the active or not confirmed alarms, arehighlighted by a red line at the bottom.
21Supervision
© 2009 Sielco Sistemi Srl
4.5 Gates Status
By selecting this item it is possible to show the status of the gates. It will be shown the window infigure.
The dialog box allows to select: the type of gates to show, the channel and the device. Thesampling status is indicated by the icon OK or KO beside every gate. To have more details on thestatus and properties of every single gate you just need to select the corresponding row andpress the Gate Property button or double click on the row of the gate: it will be shown the windowin next figure.
22 Runtime Guide
© 2009 Sielco Sistemi Srl
The presence of some anomalies is indicated by a red exclamation mark on the status icon of the
gates on the bottom left ( ).
4.6 System status
23Supervision
© 2009 Sielco Sistemi Srl
In this window are shown some general information about the application; more in details:
Station - Name : name associated to the computer.
Station IP address: IP address associated to the computer.
Common status - Address : if it is KO means that there is almost a numeric,digital or stringsampled gate with a wrong address (not congruent with the communication protocol selected).
Common status - Total : total number of numeric,digital,string,event or compound gates.
Common status - Sampled : total number of numeric,digital,string sampled gates.
Licence - Type : Name of the software licence
Licence - Validity : if it is KO means that the application it is not enabled to run with the currentlicence type.
Total sampled gates : total number sampled gates in the application.
Total devices: total number of devices in the application.
Channel - Protocol : show the configuration parameters of the communication protocol selected.
Channel - Gates sampling : if it is KO means that no sampling is active on that channel. it canbe due to the fact that there are some sampled gates with wrong address, or the application it isnot congruent with the current licence type.
Channel - Channel status : if it is KO means that communication channel it it not opened.Usually it is due to the fact that the hardware is not ready or is already in use from anotherapplication.
Channel - Writing errors : number of writing errors on the selected channel.
Channel - Reading errors: number of reading errors on the selected channel.
Channel - Detail : additional details about errors (available only for particulars protocols).
Channel - Reset: reset writing and reading errors on the selected channel.
Historical files - Numeric gates : if it is KO means that can't open the numeric gates historicalfile.
Historical files - Digital gates : if it is KO means that can't open the digital gates historical file.
Historical files - String gates : if it is KO means that can't open the string gates historical file.
Historical files - Event gates : if it is KO means that can't open the event gates historical file.
Historical files - User changes : if it is KO means that can't open the user changes historical file.
Historical files - Disk space : if it is KO means that is active the Disk full alarm.
The presence of some anomalies is indicated by a red exclamation mark on the System status
icon on the bottom left ( ).
24 Runtime Guide
© 2009 Sielco Sistemi Srl
4.7 Devices Status
RunTime allows to show the communication status of every device, in fact, any writing or readingerrors by everyone of them are shown. When the device is not answering any demand, its statusis considered KO and the corresponding row will be displayed in red. It is also possible to resetany errors.
The presence of some anomalies is indicated by a red exclamation mark on the status icon of the
devices on the bottom left ( ).
4.8 Events Historical DB
It is possible to trace back the historical situation of the events recorded on DB. In figure it isshown the window that appears if you press the key for the events history.
By pressing the Config button it is possible to set the time range window, defining the start dateand time, along with the required time interval.
25Supervision
© 2009 Sielco Sistemi Srl
4.9 Alarms Historical DB
This page is the same as the events one.
4.10 Operator Interventions
Every operation carried out by the operator is recorded on a historical DB.
The dialog box in figure shows the type of recorded operation (Code), the name of the operator,the date and time, and a message describing the carried out operation. By pressing the Configbutton it is possible to define the time range window.
4.11 Charts
4.11.1 Introduction
They are used to show graphically the trends of the gates values. The display is both historicaland realtime, and it can also be simultaneous (there is no distinction between the two modes; itdepends only on the time range used).
26 Runtime Guide
© 2009 Sielco Sistemi Srl
The legend on the top left, shows the color and the name of the gate of each trend. By doubleclicking on the legend it is possible to modify the current group (N.B.: this change is not saved). Atthe chart sides it is possible to display any two scales simultaneously. The position of the mousepointer is shown in the window on the bottom left. It is possible to enlarge part of the diagram bypressing continuously the mouse left button and moving the pointer so as to define the Zoomarea; the pointer can even exit the chart area and so display hidden parts of it. The Reset Zoombutton allows to go back to the initial scale. The buttons <<, <, >, >> at the bottom allow to movethe times axis.
4.11.2 Groups
It is possible to show groups of gates (numerical, digital and composed even in the same group)with a maximum of ten variables per group; for every gate of the group a color and a scale can bedefined. Every group can be registered with a long name (max 255 characters) so that it ispossible to call it up later on.
27Supervision
© 2009 Sielco Sistemi Srl
The red icon indicates the current group, that is to say the one that is shown.
4.11.3 Change of a Group
The dialog box for modifying a group (shown in next figure), allows to add or remove the gates,choose the trend color and the minimum and maximum values of the vertical axis, and make thegroup the current one.
To simplify the choice of the gates it is possible to show a window that list and describe them.The display changes depending on the type of gate, on the channel and the device to which itbelongs.
28 Runtime Guide
© 2009 Sielco Sistemi Srl
4.11.4 Time Axis
Through the window in figure, it is possible to indicate the start date and time, and the timeinterval (minimum 6 seconds) that will form the times axis in the chart.
4.11.5 Aspect
Through the window in figure, you can display a grid, highlight the sampled dots, change thethickness of the stroke and the type of interpolation between sampled dots:
· None: only the sampled dots are shown
· Stair: the dots are connected by a vertical and a horizontal line
· Point to point: the dots are connected by an oblique line
Combined: the dots are connected by one or more lines, bearing in mind the sampling time of thegate.
29Supervision
© 2009 Sielco Sistemi Srl
Part
V
31Reports
© 2009 Sielco Sistemi Srl
5 Reports
5.1 Introduction
RunTime allows to draw up, display and print reports configured with Project Manager. Every timethere is a need for a new report, RunTime interprets the basic file and creates a new filecontaining the assessment of all the expressions in the report.
5.2 How to Draw up a Report
The operator can create a report whenever he wants by simply selecting his name and pressingthe Ok button.
RunTime, according to the current status, creates a new file, displays it and automatically prints it,if the configuration contemplates for this.
5.3 How to Show a Historical Report
Every type of report can have a certain number of historical files defined in the configuration(See: Project Manager). It is possible to save particular reports in order to keep them, avoiding theoverwriting from new generated reports.
There are two possible windows to show generated reports:
32 Runtime Guide
© 2009 Sielco Sistemi Srl
In this first type, reports are organized in a table where for each report is specified its name, thecreation time and the type of report.
In this second type, reports are organized in a three window that shows report type (on the left)and a table where for each report is specified its name and the creation time.
To simplify the search, it is possible to sort the table according to one of the properties of a report:just click on the corresponding column header. Name and type sorting are increasing, while thetime sort is decreasing, so the last created report will be in the first line.
In the first column are shown the name of the reports: the names that have an extension such as.001, .002, … are reports belonging to the circular list of the historical. When a new report iscreated, this will be named with the extension .001, the others will shift of one position and the lastreport (the older one) will be lost. To avoid the loss of a report with the creation of new reports, itis possible to rename it: the report will be kept also when the report list is full. To rename a reportjust select it and use the button. By pressing the Delete button it is possible to delete the desiredreports.
By pressing the Report button, will be shown the selected report.
33Reports
© 2009 Sielco Sistemi Srl
Using the button Template, the template with the name equal to the type of the report selected inthe table will be shown (if exists). If the report has in the first two lines a date and time of start anda date and time of end (e.g. to be meant as a start and end of a production lot), just before thetemplate opens, automatically, will be called up the functions ChartSetTimeRange andHistViewSetTimeRange (see). Doing so it is possible to show in the template the graph variablesand the alarms' historical both related to the temporal window defined in the report.
The format of the date and time of start and end of the report is (they must be in the first two linesof the report):
gg/mm/aaaa – hh:mm:ss date and time of start
gg/mm/aaaa – hh:mm:ss date and time of end
For the two lines, after the specification of the seconds, it is possible to write whatever you like,e.g.:
15/02/2000 – 08:42:10 Start lot
15/02/2000 – 10:12:22 End lot
To easily write dates and times, it is possible to use the function ReportLotTime (see).
Part
VI
35Macros
© 2009 Sielco Sistemi Srl
6 Macros
6.1 Introduction
A macro is a special command defined by a language function. They can be used, for example, tosimplify or speed up long or complex procedures.
As an example here is a macro allowing to create and import a new production recipe. When theoperator selects the macro, he will simply have to insert a name and press OK.
The macro code is the following:
Function Void New_Recipe()
#Macro
String name = InputDialog("Insert the Name ","Create Recipe","");
if (name!="") then
if (RecipeCreate("Production Recipes",name,true)) then
RecipeImport("Production Recipes",name,true);
end
end
End
6.2 Execution of a macro
If in the project code there are functions defined by the directive #Macro, then their name is in themenu. To execute the macros you just need to select the corresponding item; you can't executethe same macro simultaneously. For more details on the creation of macros refer to thedocumentation concerning the language.
Part
VII
37User’s codes
© 2009 Sielco Sistemi Srl
7 User’s codes
7.1 Introduction
RunTime allows to limit the access and the changes in the pages to the authorized operators only,thanks to its own protection system. In fact, it's possible to associate with each operator a name, apassword, and give to him a certain set of authorizations (groups); so you can define the groupsthat can access and modify the RunTime pages.
7.2 Insertion of the Access Code
By selecting the item Insertion... from the Password menu you can insert the user's name and hispassword. This way all the rights concerning the use of supervisor software will be available.
To reset the authorizations (operator “Nobody”) you just need to access the insertion page andpress the button OK without inserting any user's name or password.
7.3 Definition of the Operator’s Codes
It is possible to define an unlimited number of operators, all identified by a password and somegroups. To do this, use the dialog box in figure. You just need to insert in the correspondingfields: the name of the operator, his personal password, and, by pressing the Groups button,select the groups to which he belongs.
Once you have entered these data, press the Add button and the operator will be registered as aRunTime operator. As far as the name and the password are concerned, there's no differencebetween capitals and small letters ("Smith" is equivalent to "SMITH"), moreover, the same namecan be associated with only one operator.
On the left part of the window there are all the registered operators. It is possible to delete anoperator by selecting his name and pressing the Remove button.
To modify the properties of an operator you have to double click on his name; at this point you canmodify his properties on the left part of the window. To confirm the changes press the Add buttonso as to be able to overwrite the old properties.
38 Runtime Guide
© 2009 Sielco Sistemi Srl
7.4 Definition of Names and Groups
Using the dialog box in figure you can personalize the groups by giving them some names(maximum12 characters). This way their management will be easier and more intuitive.
For example, it is possible to give the groups a geographic or functional meaning of thesupervised process, indicate whether the various operators can or cannot access only the partsthey are skilled in, award the groups a professional figure such as: Engineer, Technologist,Operator etc., each of them with different change and access rights.
Press the OK button to save your choices; Cancel, on the contrary, closes the dialog box withoutupdating it with the changes.
39User’s codes
© 2009 Sielco Sistemi Srl
7.5 Definition of the Access rights to Pages
With the window in figure you can give the various groups the opportunity to access and/ormodify the RunTime pages.
On the left part of the screen there are the menu items corresponding to the RunTime pages. Ifyou select an item, on the right of the screen the change and access groups, authorized or not,will appear. If on the page there aren't any selected groups, everybody can access or change it..
To close the window and save the changes press the OK button. If you don't want to save thechanges, press Cancel.
Part
VIII
41Windows Management
© 2009 Sielco Sistemi Srl
8 Windows Management
8.1 Introduction
In RunTime phase it is possible to open as many as eight different windows at a time. Eachwindow can be maximized, minimized and closed like any other Windows window. The pages withinformation on the status of the supervised process are updated in real time.
8.2 Management
You can arrange the windows automatically using the commands in the Window menu. This menucontains also the list of all the open windows so as to make their activation easier (e.g. windows inthe background that can't be seen).
Cascade
It arranges the windows one on top of another with a certain offset starting from the upper leftside; this allows to see the titles of all the windows open at that moment.
Tile
It arranges the windows one beside another resizing them, if possible, suitably.
Arrange Icons
It neatly arranges all the icons of the minimized windows on the bottom left.
Part
IX
43Multilanguage
© 2009 Sielco Sistemi Srl
9 Multilanguage
9.1 Introduction
MLEditor help you in developing multi language applictions.
You can also develop mono language applications, and so you don't need to use it.
9.2 Building multilanguage apps
To develop a multilanguage application follow these steps:
· Create the application with Template Builder· Execute the application and be sure to have seen (shown) all the templates created in the previous
step· Update the multilanguage database using the Multi Language Editor (MLEditor).
It's very important to show templates at run time (step 2) so languages database is correctlymade,after db creation you can edit it with MLEditor.
Strings used to build database are:application name,tamplate captions,template object descriptions, some object labels (label, button, groupbox, checkbox, radiobutton, tabsheet,combobox)gates descriptions,event and alarm messages.
Each time the application is executed the language database is updated, new strings that haven'tbeen found in the
44 Runtime Guide
© 2009 Sielco Sistemi Srl
db are inserted.
Strings comparison is case sensitive, it means that db can contain both 'Gate' and 'GATE' If you change an application it's necessary to execute the app. before handling multi languagestuffs.
<NOT-FOUND> is the string apperaing when you change the current language of the applicationand a label isn't found in the database, so its translation is <NOT-FOUND>This can happen when you add a new template component (containing a label for example), youexecute the application and change its language.
9.3 Adding a new language
When language database is created (see Building ml apps) the first column is the sourcelanguage (defined as language0), the language you write your application, then another column isadded for a secondary language (defined as language1)
Each column is a language and rows are words of the language.It's really important that language of the built application is in the first column.
Yellow cells contain language's names, names that are shown at Runtime when you choose tochange current application language.
45Multilanguage
© 2009 Sielco Sistemi Srl
Once you change first cell of first column, multilanguage will be available at execution time.Clicking on the first cell show you a dialog that let you modify the cell content.
Only changing Language0 (first cell first column) with another string will activate themultilanguage feature .
9.4 Changing Language at runtime
After the creation, the visualization of templates built and manipulation of db of languages, themulti language feature will be available at run time.Under menu Supervision there is the item Language...
If application is correctly configured the next dialog will appear:
46 Runtime Guide
© 2009 Sielco Sistemi Srl
By this you can change the current language of the application through choices available.If you haven't configured or wrongly configured the multilanguage stuffs, you won't changeapplication language anda messagebox will advise you of this circumstance.
Index 47
© 2009 Sielco Sistemi Srl
Index
- A -Alarms Historical DB 25
Alarms Status 20
- C -Charts Aspect 28
Charts Change of a Group 27
Charts Groups 26
Charts Introduction 25
- D -Devices Status 24
- E -Event Status 19
Events Historical DB 24
- G -Gates Status 21
- I -Introduction 6
- M -Macros Execution 35
Macros Introduction 35
Multilanguage Adding a new language 44
Multilanguage Building apps 43
Multilanguage Changing language at runtime 45
Multilanguage Introduction 43
- O -Operator Interventions 25
- R -Recipe Introduction 11
Recipe Management 13
Recipe Models 12
Reports How to Draw up 31
Reports How to Show a Historical Report 31
Reports Introduction 31
- S -Supervicion System status 22
Supervision Alarms Historical DB 25
Supervision Alarms Status 20
Supervision Charts Aspect 28
Supervision Charts Change of a Group 27
Supervision Charts Groups 26
Supervision Charts Introduction 25
Supervision Charts Time Axis 28
Supervision Devices Status 24
Supervision Events Historical DB 24
Supervision Gates Status 21
Supervision Introduction 17
Supervision Operator Interventions 25
Supervision Template 17
System status 22
- T -Template 17
Time Axis 28
- U -User’s codes Introduction 37
User's codes Definition of Names and Groups 38
User's codes Definition of the Access rights to Pages 39
User's codes Definition of the Operator’s Codes 37
User's codes Insertion of the Access Code 37
- W -Window Management Handling 41
Window Managment Introduction 41
Endnotes 2... (after index)
48 Runtime Guide
© 2009 Sielco Sistemi Srl
Recommended