&, Customisation and Design Training Manual Version 7.0DISCLAIMER (iter Pty, Lid kes no representations or warantes with respect to this manual and, to the maximum extent petite by la, expres te its iby fr breach of any waranty that maybe nip to the releremient of ‘his manaa! wih another, Furthermore, Citct Py, Lid. reserve the right to rege this publication any me vith erring ss obligation noi any person of he revision Citect Pty Lid ABN 88 001 158 854 (“Citect”) Customisation and Design Training Manual INTRODUCTION AND LEGAL NOTICE ‘Your purchase ofthis official Customisation and Design Training Manat entitles you to unde Customization and Design taining oouree, The number llcatod o you oh purchase ofthe mana yourkey to complete the cause evalustion * ‘Sntisfactory completion of this evaluation is mandetory for you to obiain a Citect cetificate of completion ofthe ‘exning nurse. The contents of this anual are popstar to Cites Pty. Li and al sights, including soph, are reserved by Get Pry. Ld. Yu stn copy ary pr ofthe ancl in had or leconi formar bake ay apaion 07 ‘other commer use of it witha ites peor writen consent, copyrichT |© Copyright 2007 Citect Pry. Li. All sights reserved TRADEMARKS i, Cie Py. hs ma evry ono say dena ign allcorpany nes ph nd ‘services meminet in thi manual Trademarks shown Melon ‘hom various sours, CCleetSCADA, CieetHMI, Neva cicuSEinp Reports and Amp ae essere waders of Cites Py. Li Windows, Windows NT, Windows 2000, Window 3, MSSQL Server and Comporti, ec piggies ov nd Nata ae esr oF Noy ne radomarks of Microso8 ‘Orme isa episod trademk oF O ABASEin statenar of Bi, General Novice ‘Some product namics uae this peml are wsed for deniction purposes only and may be wademss of thet Release 1 writ bound in Australi CitectHMWSCADA Version 7.0 September 2007Table of Contents & CHAPTER I: INTRODUCTION TO CUSTOMISATION AND DESIGN oe Overview Slee Before You Begin Course Overview Conventions Used in this Manual ‘CHAPTER 2: CusTOM TEMPLATES Overview see CiteetHMI/SCADA Templates. Creating Your Own Templates... Adapting Tempiates Displaying Alarms Navigation... Custom Menus Animation Points. Applying Templates. Templates within Templates nn. CHAPTER3: — SMART GENIES Overview Genies ~ Revision .... Genies inside Genies.... Structured Tag Names... : Using Structured Tag Names with Genii. ‘Smart Genes .... Genie Forms CHAPTER SMART Popups AND SUPERGENTES 44 Overview... gyn ee eee Popup Pages and Supergeniesin.. 42 ‘Smart Popup Pages and Supergeniés... ae eee 47 CHAPTERS: — FORMS 5 Overview. Cicode Forms... CHAPTER 6: ue E COLOR Overview Bas eserennuninninnnnnnnnasntnase Cho ing Custom Colours. 1g Custom Colours i pot ig Colour Values “ustom Font and Colour Labels.... “Adjtist, Colours...... Flashing Colours. Flashing Images.. Manual Release 1 iwCHAPTER 7: — GRAPHICS BUILDER AUTOMATION INTERFACE Overview. Pe eee tte . va Automation Placing Symbols on a Page... Adding Properties to Objects Using Genies.. Drawing Objects on Pages. CHAPTERS: — CITECISCADA AND OTHER APPLICATIONS Overview... CitectSCADA an Data Source Names... How CitectH MV/SCADA Uses ODBC Database Exchange ActiveX Control. Configuring the ActiveX Control Editing the Database from CitectSCADA Runtime. Updating CiteetSCADA Tags. ActiveX and Citect.. ActiveX Objects Using Cicode... Using ActiveX Methods... Events... DBC... CHAPTER 9: KERNEL AND DEBUGGING Overview... The Citect Kernel Security and the Kernel... Foreground and Background Tasks Page Table Cicode Probe Command Page Table Stats o.oo The TaskNew() Funetion Thread Window . : Global Variable Window Stack Window... CHarTER 10: PROCESS ANALYST Properties of the Pi Toolbats aren ak Pages Ant@lyst Ter i the Bkocess Analyst Configuring Penss, ising *Poolbars.. Cursor Labels. v9 CitectHMUSCADA Version 7.0 September 2007CHAPTER I: ALARMS AND TRENDS. Overview. Alarm Filterin, Table Maths. Cuarter 12: Course SUMMARY Course Evaluation Further Training Citect Examinations e < @ XQ ‘No: 0287 002790 isation and Design Manual Release 1 vChapter 1: Overview Introduction tents, Introduction to Customisation and Design You can configure a CitectHMUSCADA monitoring.arid:controf System to suit any industrial application. Because CitegfMUSCADA has been designed with flexibility in mind, you can design a system to suit your exact requirements. CitectHMUSCADA suits both small and large appligations:Because it is flexible, CitectHMUSCADA will keep pace with your plant and information requirements as they change and expand. CitectHIMI/SCADA is easy to learn and uge. Programming techniques may be used to customise your application to suit’ your requirements. such as templates, genies, forms and wizards required to configure your CitectHMUSCADA $ performance. Features dice the time and effort fem, as well as maximising This chapter contains the follo ‘Topic &, = ‘See Page > Before You Begin = 1-2 > Course Overview 13 > ConventiongLsed in this Manual 15Before You Begin 4, Sia 2 Your Instructor Please write the name of your Instructor here = Defining the Scope of this ‘Training Manual ‘Your Instructor will be spending the next three days with you, and will guide you through this training course. Your Instructor 18” ait. experienced CitectHMI/SCADA user so please feel free to ask questions. ‘This training manual is a supplement to Citect Certified, Training“ In order to make full use of the software you should also reference thé’@nline Help and CitectSCADA Knowledge Base. The graphics displaying screen shots have beén taken using the Windows XP operating system using Classic mode display properties. If you are running a different version of Windows then your setae ‘may differ slightly from the ones shown in the training manual. CitectHMlISCADA Version 7.0 ‘September 2007Course Overview Course By the completion of this training course you will: Objectives > Understand how to create and use Custom Templates, Create and use Smart Genies and Smart Popups’ Write Forms and Genie Forms g Leamn about True Color and the new Color Tod Use VBA to use the Graphics Builder Automation Tnterfae > Connect CitectSCADA to other Applications vv v Learn to use the Process Analyst, Use Alarm Filtering and Table Math: Course Please take a few moments to hae a Joélithrough your Training Pack. In Material addition to this manual, you will find the following items: v Citect Compendium Citeet Mouse P: vv Pen Notepad Memory Stiek 4 v Continued on next page 0287 002 jmisation and Design Manual Release 1 13Course Overview, Continued Course The training course will take three days to complete, ‘The following proiéam Program outlines the topics that will be covered on each day: 2 Day | Topies 1 | > Custom Templates > Smart Genies > Smart Popups and Super Genies | Vv Forms v True Color g 3 a = E e > z é g 5 3 E v CitectSCADA and Other Applic: Kernel and Debugging 7 Process Analyst Alarms and Trends vy 14 CitectHIMISCADA Version 7.0 ‘September 2007Conventions Used in this Manual Objectives Objectives Contents Exercises Exercise 6-1 Hints and Tips ‘These are the skills you will achieve by the end of each chapter. An ovetiiew providing a brief synopsis of the topic begins each section. @fien, examples are given to illustrate the conceptual overview. Example - The Unity Pro configuration environment consists of several toolbars, browser windows and programming editors. This chapter introduces the user to the configuration environment using an example project with pre-defined elements. This chapter contains the following topics: Topic zy See Page > Topic A ap > Topic B > Topic C After a concept is efplained you will Bé given exercises that practise the skills you just learned. These ises begin by explaining the general concept of each exercise and then step-by-step procedures are listed to guide you through each procedure. Example - Paste a geniditomiaeurary fh the Include project onto test page called Uti. Run the Milk_Upgrade i. Use the Project then trigger and view some alarms. Ag template settings: This heading will provide you with useful or helpful information that will fake cofifiguring your project easier of “Hints & Tips: P| Z Continued on next paxe Customisation and Design Manual Release 1 15Conventions Used in tl Note Menus and Vertical Tal See Also Manual, Continued 4 A note will refer to a feature which may not be obvious at first gianc ut something that you should always keep in mind Example - Note: Text separated by the pipe symbol “»” indicates that you are to go to a menu Menu Options Example ile » New... : Go to a menu “! Horizontal and Text written this way ‘uleaes the Ho”zontal then the (Vertical) tab you are to bs choose. Example Appearance (General) Whenever you-are required to type information into a field or dialog box it will be written in this font *i_ | For further information about Templates, see CitectSCADA Help - Using Page Se) Templates. CitectHMUSCADA Version 7.0 September 2007Chapter 2: | Custom Templates &, Overview Introduction _If the pages in your project contain items that are common,to all pages such as toolbars and status bars you can create your oy template(containing all common objects) to use as a base for the pages’ You can then create the pages based on the template, and add individual objects to each page If you subsequently decide to delete or change theMocation Of a common object, or to add a new common object, you do not have to change each page ~ you can change the template. CitectHMI/SCADA automatically updates all pages based on the template. Contents This chapter contains the following topiest Topic z See Page > CitecthIMI/SCADA Templates... 22 > Creating Your Own ‘Templates eae 24 > Adapting Templates “a 27 > Displaying Alaris, 2-12 > Navigation * 2-16 > Custom Menus 2-20 > Animation Béints 2.22 > 224 > 2.25CitectHMI/SCADA Templates “look and feel” that is required. The simplest page is based template, which is simply a blank window. The de objects and functionality to the window and develops project pages. For a developer with a short development schedule ors CitectHMUSCADA, there are a number of pre-designed the user to quickly create pages. The standard templates i are designed to reliably perform all of the basic functions required in a project. The Normal page from the Include ps ooks like this, Continued on next page NO: 0287 002790 CitectHIMUSCADA Version 7.0, September 2007Cite CSV Templates SUED ctHMI/SCADA Templates, Continued The CSV_include Project is a preconfigured project that is installed with CitectHMI/SCADA Version 5.5 or later. Designed to reducé?the amount of time required to configure a new project, it includes.a:set.of templates and pages styled for the Windows XP environment. When a new CitectSCADA project is created, the CSV_Include project is, automatically incorporated as an included project. [his means that all of the project's templates and associated content are available, for. implementation when ereating your graphics pages in the Citect Graphics Builder. The project created using these templates will have a This is the Normal page from the CSV_include, stration t6ols page, a file page for displaying text and Rich Text Bormstagjles, and a selection of popup windows. All feature common favigation’and alarm menus for consistent functionality and appearance “across an entire project. The project even supports multi monitor display, allowing a number of graphics pages to be simultaneously displayed across ‘several Computer screens. Custémisation and Design Manuat Release 1 23Creating Your Own Templates Overview How to Most projects create templates that are designed specifically for the si templates that we will be creating in this chapter will be based op the standard” templates, > To create a new template: Double click on the Create a new template button in Gitect Explorer, : or click on the New Suton in the Citect Graphics Builder, ct Graphics Builder ‘Continued on next page CitectHMUSCADA Version 7.0 September 2007Creating Your Own Templates, Continued Exercise 2-1 Step | Action 1 ereate 2 new Normal template for the pages i in your Mile Project. |. Create a now Template in your Advanced Mik project ~ use the following template settings: Siyle standard ye | [Linked Sunticked> Title Bar Sunticked= | | Resolution [XGA aaa | [Template Blank" Untick the Title Bar box, Click OK it, When youlick OK Yau wil 596 this error message appear iv. In the dialog provided create a new style called lick OK to create the style. Vv. Click OK to save the template. Continued on next page Customisation and Design Manual Release 1 28Creating Your Own Templates, Continued Exercise 2-1 (continued) Step | Action vi, You will see this warning message. CickOK es Tm j Somme ono angie, vii, Select File » Properties from the menu ‘Open the ‘Appearance tab and choose & Background Colour for your template. vill. Click OK and save your template. CitectHMUSCADA Version 7.0 September 2007Adapting Templates Standard ‘Templates There are many features in the standard templates that you! may Wish to incorporate into your own templates. The standard templates:in the included projects are provided so that you have examples to,use_withit:your own projects. You can copy these features from the inghided ‘ettplates ffto your, new designs. Exercise 2-2 Step | Action 1_| Add a Title Bar to your template, i. Add a filed rectangle to the gor ‘your page to form your title bar: . z Use some of the features from one of the XP_Style templates ‘on your new Normal template. Choose File » Opeff trom.thesmenu and choose the normal xp_style templaté fromthe csy_include project 00k at the top right hand corner of the template. Select the objects on the middle toolbar and copy them onto the top of your new template underneath your Title Bar, They are the text object =Userinfo(1), the rectangle behind the text object and the page wide toolbar. This will foren your Utility Toolbar. ate) Select these Re Sse-4fo] thtee objects CCustiimisation and Design ‘Continued on next page Manual Release 1 aTAdapting Templates, Continued Exercise 2-2 (continued) Step_[ Action 2 | iii, Double click the Utility Toolbar rectangiete openihe (cont. properties of the object. Remove the Fill property from the 11n 10 tHe CSV_Include Normal template and copy the red a 1 EL. You may need to ungroup the title bar jects before you can select the Close button Paste.the close button onto the top right hand corner of your gh “Pouble click the button to remove the properties inherited from the CSV_Include project. Add this expression to the button Input (Touch) ‘Access (General) Up command Tool tip: ShutdownForm (} Close ‘Continued on next page CitectHMVSCADA Version 7.0 ‘September 2007Adapting Templates, Continued & Exercise 2-2 (continued) Step _| Action 2 vil. Look at the bottom right hand cornen.ef the CSVainclude: (cont.) Normal tompiate. Soloct tho two text objects and the background toolbar. Copy and paste those three objects onto your template . <———— Toolbar <—___ Tet Objects Vil Replace te standard CReetSGADA symbo with ee GCES_Logo symbol from your Ieons ibrary onto the page above the two text objecis 0) tinued on next page Customisation and Design Manual Release 1 28Adapting Templates, Continued é Exercise 2-2 (continued) ‘Action a | Add the standard items to the Utility Toolbar! |. Move animation points 1 and 2 to the'top toolbar. These animation points (ANs) display the Keyboard Echo and the Prompt, Choose Tools » Goto Object from the ment Er Tenet aire Neral XEA ‘rap ANSE Tensise onan ‘ Recongeie } Recurgineltt TeAane Recerge ats Recargeenits Annan Pot 2 ‘Seiten Pane at ii” Bouble click Animation Point AN1. This will open a dialog Showing the properties of ANA. Continued on next page CitectHIMUSCADA Version 7.0, Septomber 2007Adapting Templates, co: Exereise 2-2 (continued) 2 Step_[ Action 2 : iii. When this dialog opens change the Xiand Y Cootdinates to 400. This will allow you to find the animation numbers. Repeat this step to find ANZ, 2 ~ # iv. Move both of the ANs to the Utility toslbar. You might like to add rectangles behind them to assist with their visibility Customisation and Design ‘Manual Release 1 attDisplaying Alarms é Overview You may decide to display the most recent alarms on all pages. Phe fumétion AlarmDsp() displays an alarm list, starting at a specified AN,and then of subsequent ANs, This functionality has been used on the standard pages provided in the CSV_Include project. Cicode Object You specify the number of alarms to display and the type of alarms, for example, active hardware alarms or disabled nén-hardware alarms. Before you call this function, you must first add ‘aitimation points to the graphics page for each alarm to be displayed..Bach of théanimation points must be consecutive numbers, You can check the AN@mumber by opening the Access (General) tab of the Cicode Object. The.AN number below is 17. Continued on next page CitectHMISCADA Version 7.0 ‘September 2007Displaying Alarms, Continued Exercise 2-3 Step _| Action 1 [Greate a toolbar to display the most recat alarma_ i. Draw a black rectangle on the bottdin toolbar that you placed fon your page in the previous exercise. | 4. Pico tee cieode Object lon she nanaide or ne rectangle. Ensure that the AN numbers af@/eéfleecutive. Ai fod 4) il, Open the propertiegof thesfifst Cicode Object. Go to the Cicode General tati and.add the AlarmDsp function. The first argument @bihis funétion is the AN number of the Cicode object. Checkeyour own ANeumber. The second argument is the number of afatms to display. The third argument is the type. in this case welll be displaying all active alarms so the modewitibe 0, Continued on next page Customisation and Design Manual Release 1 213Displaying Alarms, Continued é Exercise 2-3 (continued) Step_| Action - i iv. Adda command to enable the operatopte acknowledge the alarm by clicking the alarm. This command will nded to be placed into all three Cicode Objects. “Use these settings Input (Keyboard Commands) |“LBUTLON_CMD_UP” Key Sequence command LBUTTON_CMD_UP AlarmAck (0, 0) 2 [Add symbols to your Normal template to ipdicate active alarms. i. Uso Windows Explorer to copy, the file ¢sv_icons.etl trom the CSV_Include project into your Milk project ji, Add two Symbol Sets'to the,top. left hand corner of the Utility Toolbar. this 's the toolbar where you previously placed AN1 ‘and AN2. You may need to resize the toolbar to fit the symbol sets. j | ava gqise these settings: ‘Symbol Set | Current Alarms Hardware Alarms ‘Appeariiice PRlarwActive GG) | Alara&ccive (é) (General) Anintaite whet | Input (Toweh) PageAlarm() PageHardware |} commant | csv_icons.aalarm_01_ | esv_icons.halarm_01_ | xp xp | ‘sv icons.aalarm_02_ | esv_icons.halarm_02_ xp xp | esv_icons.aalarm_01_ | esv_icons.halarm_03_ xp xp 7 Continued on next page CitectHMVSCADA Version 7.0 ‘September 2007Displaying Alarms, Continued &é Exercise 2-3 (continued) Step | Action 2 || v Hints & Tips: (cont.) The functions PageAlarm(), PageHardware() and PageSummary() are set by default to open pages named Alarm, Hardware.and ‘Summary respectively. If you wish to use different names for the alarm pages you may enter custom names for these pages in the Citect inifile. Set the INI parameters [Page] AlarmPage. HardwarePage and SummaryPage to the custom names for your pages. : iv. Save the template, CuSlGnsation and Design Manua Release 1 248Navigation Overview Side Toolbars Large CitectHMI/SCADA projects can often contain a significant number of pages. It is common to have side toolbar and drop down menus that take the user to other pages, or groups of pages in the project. In this section we will add side tootbars to the template, . Side toolbars have been used in CitectSCADA projects for many years. ‘Typically these toolbars have a flyout that contains Titiks to a related group of pages. ‘Continued on next page CitectHMVSCADA Version 7.0 September 2007Navigation, Continued Exercise 24 ‘ Step | Action “8 1 | Create a popup page that will contain navigation buttons to the production pages in your project. i. Open the Citect Graphics Builder ate create anew age based on the Blank template, Ii, Add these properties to thf butions. Appearane J input (Fou) HAecese (Genera) g Genera Up ome ‘ool Tip icons.cow | WinFree() WinGoto (0) ; Pasteurisation PageDisplay("gerPast") | Page icons.carton War eigg igi (0) Recipe Page PageDi sp’ Recipe") icons.silog.| winFree () ;WinGoto (0); Silo Page geDisplay ("gr_Silos") esy_icons.d.| wisigge () ;WinGoto (0); File » Properties from the menu. Change the View “aréa of the page so that only the buttons are visible, S “Bission ana Design Manual Release 1 anNavigation, Continued Exercise 2-4 (continued) Step_| Action 2 [Create a popup page that will contain navigation buttonsito the alarm pages in your project. i, Change the buttons to use these seitings. ’ {Appearance (General) | Input (Touch) [Access (General) | Symbol Up Command __| ‘Foo! Tip | esv_iconsAAlarm O1_xp | winFree(); current Alarns WinGoto (0); | PageAlarm() esv_icons.SAlam Ol xp | winfree(j; |, Summary Alarms winGoto (0) ; Pagesummary() ‘esv_icons.HAlarm _Ol_xp| wingzée(); WT sacauare WinGoro(oFy Alarms PageHatdware () v_icons.disabled_01_xpuinrreegg WHAGOtO (0) ; ii, Save théipage as \AlagmnMonu 3 | Greate @ popup pagthatlwill contain navigation buttons to the miscellaneous pages in your project. i. “8Save your !ProdMenu page as !UtilityMenu. il, Chanige.the buttons to use these settings Triput (Touch) — ‘Access Up Command (General) Tool Tip Appearance WinFree(); Forms Page WinGoto (0); PageDisplay (*gr_Forms") winFree(); WinGoto(0) ; PageDisplay(" ") winFree() ; WinGoto(0) ; PageDisplay(" "} [Ev jeons.disabled lwinFvee (0? _O1_xp WinGoto (0) ; iii, Save the page. Continued on next page CitectHMIISCADA Version 7.0 September 2007Navigation, Continued Exercise 2-4 (continued) Step_[ Action wi ‘4 _ | Add the side toolbar buttons to your page Return to your Normal template, 4 Place four buttons on the page in the top left hand ebrner of the page. Use ge settings in he buttons ‘Appearance. Tnput (Touch) ‘Access (General) Up Command (General) Symbol Tool Tip icons.milk, finNewAt ("!ProaNenu", Production @ 48,72, 1484164128) Menu csv_iedis.AMMar PWinnewat("!Alaravenu", | Alarm Menu 48,120, 1484164128) csyiidons.tools'@ |winnewa:("iutilityMenu", | Utility Menu p 48,168, 1+8416+128) PageLast () Tast Page Note: ‘You will need to substitute the X and Y coordinates for the WinNewAt() function that are correct for your template. Save the template, Manual Release 1 249Custom Menus é Overview Drop-down menus are capable of calling a Cicode function or navigating to, specific page. This allows the user to have point and click: 4 etonal menus ‘The fimetion DspPopupMenud) creates a popup menu consisting ofa number of menu items. Multiple calls to this function enable you to add new items and create sub menus, building a system of linked, Witidows-style menus. Menu items can be displayed as checked and/or disabled. You can also specify a bitmap to display as a menu icon. ‘The first call to this function builds the mei it Example - ‘The expression, DepPopuptenu (0, ° 66m, builds a menu with thtee items: > > ‘tem2! will be shown as disabled, > "Ttem3' will be’shown as checked. “Ex serect ion = DspPopupMenu(-1, " ", 20, 40); rays tet iena at positon (20, 40) and retums te mumber ofthe selected See CitectHMUSCADA Version 7.0 September 2007Custom Menus, Continued Exercise 2-5 Step_[ Action 1 [Add a title to your page. 1. Open the Cicode Editor and open a hew file. Save the file as Menu.ci. > ii, Create 2 new function called PageTitle(). This funétion will return the title of the current page as-a:String..° STRING FUNCTION PageTitle(i STRING sTitle; sTitle € TURN END “ee iil, Satféthe file. Ss Z iv. Place 6 txt object fet will run your new funetion on the title bar of your rapt Manual Release 1 anAnimation Points Overview Reserved ANs & Each point on a graphics page where an object is displayed is calledian animation point. When you add an object (text, symbols, pipes ete.) to your page, CitectHMI/SCADA automatically allocates a number.(termed:an AN) to the animation point. The number of objects that you can usésis limited by the performance of your computer, though this would rarely be a pioblem, A good rule of thumb is to try and keep the number of objects (and hence ANs) less than 3000. CitectHMI/SCADA uses the first 2 ANs fofautomatically displaying system information such as messages, alarm information and page details. In some applications, such as trend pages, some other Ns are reserved. When you create your own template$ a good:practice is to reserve your own animation points for later use. This practice allows for the possibility of adding new objects to your templates at a later stage. When an object is added to a page based on one oF Your templates it will use the next available AN number. ba If at some lafer stage yoiiidecide to make changes to your template any object you place on the femplafe wll use the next animation point Wb you then update your template the two AN numbers will conflict. In ‘order to prevent this from happening reserve animation numbers in your “stetiiplate, If at some later stage you decide to add more objects delete one of your reserved animation numbers first. Continued on next page CitectHIMISCADA Version 7.0 September 2007Animation Points, Continued Exercise 2-6 Step | 1 Action ‘Reserve twenty animation points to your normal template, |. eturn to your Normal template ii, Choose Tools » Options from the menu : lil, Select the option Show version 3.xxid.xx tools. iv, Select the Animatign Point toot. x Points to your page. A good place to add of the page. Customisation and Design Manual Release 1 223Applying Templates Exercise 2-7 ‘Action Step 1 ‘Apply the completed template to your pages: i, Open the page gr_Past. s zg il, Choose File » Properties from the menu, Open the Appearance tab and change the Style to training Ghangg the Template Style of all your pages to the training le. CitectHMUSCADA Version 7.0 ‘September 2007Templates within Templates Exercise 2-8 Once you have created your basic template you can use that template a§:the basis for your other templates. This way if you need to make changes to all of the templates you only need to make the change on. the. originalstemplate. When the templates are updated the templates based! on the ofiginal will also change ; Step_| Action 7 | Create Alarm templates based on your new Normal template i. Return to the Citect Graphics.uilder and create a new Template based on the Normal training template. ‘Add a black rectangle to the page to create a background for he farms. Place a Cicode object in the top left hand comer of the ectangle er Continued on next page Customisation and Design Manual Release 1 205Templates within Templates, Continued Exercise 2-8 (continued) Step_| Action 1 iv. Rd These SBtngS to te Code objets ee on (cont.) Cicode (General) Input (Keyboard ur Command Commands) 7 Key Sequence Marmbsp (21,25,0) BBUTTON_CHD_UP qian Note: The first argument of the AlarmDsp() function is the AN number of the Cicode object itself, The second argument is the number @falarms to be displayed on the page. You will neeéfo check Your own Cicode object and apply the appropriatévalues for your page. v. Add Seroit Scroll Deyn asbuttons to the right side of the page so that you éan scrofl to another page of alarms. Use the functions ‘AlatmDepNext(24) and AlarmDspPrev(21). Again chock that the some the same AN number as your first Cicode object. vi, Save the template agAtarm ‘Continued on next page CitectH¥MISCADA Version 7.0 September 2007Templates within Templates, Continued Exercise 2-8 (continued) Step _[ Action 2 | Greate a Summary alarm template Save the Alarm tempinte as Summary ii Change the Cicode (General) Command in the first Cicode object so that the Type argument i540. This will display all Summary alarms. emer ii, {Save the Summary template. Repeat this procedure to create a Hardware alarm template. © VMarduware is Type 5. Create alarm pages for your project. i. Create a page for current alarms, a summary alarm page and lop, a hardwore alarm page. Name the pages Alarm, Summary * and Hardware. Run your project to test your new pages. 221 Manual Release 1 Customisation and DesignChapter 3: Smart Genies Overview Introduction Usually each graphical object on a graphics page is configured iridividually. With a genie, you can combine several related objects into a group and store the group in & genic library (similar to a symbol library). ‘The genie can then be used as if it was a single object (pasted, moved, resized, gp) and toe elements of the genie are then configured collectively. ‘Simple Genies were covered in the Citect Configuration Course. This chapter will take genies several steps further Contents This chapter contains the following topii Topic g See Page ® Genies ~ Revision 32 > Genies inside Genies “ 36 > Structured Tag Names 3-12 > Using Strung Names wi Genes 314 >» Smart Genies ip. ri 3-19Genies — Revision Exercise 3-1 The Citect Configuration Training course explains how to cteate si genies. The first part of this chapter will revise simple genies. Step _[ Action = Create a new genie with a numeric object that will display the value of a milk level tag and a command to change th - ; lick on the New Lal button on the todibar. The folowing Glog mil be csplayod ae 1 chekthe Genie button, A biank page wil be displayed, with a epic Locator Point ~ (this is reference point when the 9 ems pasten ono a rani pag) Glick on the Numeric too! M4 and click near the Genie x, Hegator Point to place a numeric object Continued on next page a CitectHIMISCADA Version 7.0 September 2007Genies — Revision, Continued Exercise 3-1 (continued) Step 7 “Few cro [| [erageoarqvabar Seu 1 Sane wea a bist Comentaes [Aleem x] Pie 1 See plage oie Fee al Tag’ = Argvaluel pe eee es | Customisation and Design Manual Retease 1 Continued on next page 33Genies — Revision, Continued é Exercise 3-1 (continued) [Step Action 1 (cont.) Note: This is a level indicator notj# controller. dn a real situation you would not need an Input command. This is for the purpose of the training-course only 36 that you can change the values in your DisPLC. vi. Glick on OK. vii, Draw a filled rectangle object behind the numeric object for display purposes. Saye the Nw genie with the name Silo_Level_t into the ing library, Continued on next page CitectHMSCADA Version 7.0 September 2007Genies — Revision, Continued é Exereise 3-1 (continued) % Step | Action 2 | Paste the Genie on to a graphics page. 1, Open the page called Genies. | : ll, Use the Paste Genie too! Sil to paste the Silo_Level_1 genie onto your Genies page under the heading Simple Genies. Spocity the tag Silo_TI_1_PV in the TAG field Iii, Your page should look like this. Simple Genies gr fe ‘Customisation and Design Manual Release 1 35Genies inside Genies @ Overview A genie may be wed to combine several objects together and paste them 6p a page as one object. Genies are also reusable. A little known bonus is that Genies can be used insid¢ genies! # Example - - Valve_Simple is a genie with a simple valve symbol se %Valve% sini: Continued on next page CitectHIMSCADA Version 7.0 ‘September 2007Genies inside Genies, Continued Overview ‘You would like to create a new genie that displays the value of an imegetiag (continued) that is related to a valve object. A new genie may be created that uses the oviginal genie, When the numeric object is pasted onto,the page itwould be configured normally. When the Valve Simple genie is added its syntax will need to be passed through the new genie