Vijeo Citect Customization and Design Study Guide

Transcription

1 Vijeo Citect Customization and Design Study Guide Version 7.30 Schneider-Electric Pty (Australia) Ltd 78 Waterloo Road Macquarie Park NSW 2113 Australia

2 DISCLAIMER Schneider Electric makes no representations or warranties with respect to this manual and, to the maximum extent permitted by law, expressly limits its liability for breach of any warranty that may be implied to the replacement of this manual with another. Furthermore, Schneider Electric reserves the right to revise this publication at any time without incurring an obligation to notify any person of the revision. The information provided in this documentation contains general descriptions and/or technical characteristics of the performance of the products contained herein. This documentation is not intended as a substitute for and is not to be used for determining suitability or reliability of these products for specific user applications. It is the duty of any such user or integrator to perform the appropriate and complete risk analysis, evaluation and testing of the products with respect to the relevant specific application or use thereof. Neither Schneider Electric nor any of its affiliates or subsidiaries shall be responsible or liable for misuse of the information that is contained herein. If you have any suggestions for improvements or amendments or have found errors in this publication, please notify us. All pertinent state, regional, and local safety regulations must be observed when installing and using this product. For reasons of safety and to help ensure compliance with documented system data, only the manufacturer should perform repairs to components. When devices are used for applications with technical safety requirements, the relevant instructions must be followed. Failure to use Schneider Electric software or approved software with our hardware products may result in injury, harm, or improper operating results. Failure to observe this information can result in injury or equipment damage Schneider Electric. All rights reserved. Schneider Electric Vijeo Citect Customization and Design Study Guide INTRODUCTION AND LEGAL NOTICE Your purchase of this official Vijeo Citect Upgrade Training Manual entitles you to undertake the Vijeo Citect Upgrade training course. Satisfactory completion of the course evaluation is mandatory for you to obtain a Schneider Electric certificate of completion of the training course. The contents of this manual are proprietary to Schneider Electric and all rights, including copyright, are reserved by Schneider Electric. No part of this document may be reproduced in any form or by any means, electronic or mechanical, including photocopying, without express written permission of Schneider Electric. Schneider Electric will not accept any liability for action taken in reliance on this training manual. TRADEMARKS Schneider Electric has made every effort to supply trademark information about company names, products and services mentioned in this manual. Trademarks shown below were derived from various sources. Vijeo Citect, CitectSCADA, Cicode, Vijeo Historian, CitectHistorian, and Ampla are trademarks owned by Schneider Electric Industry SAS or its affiliated companies. All other trademarks are the property of their respective owners. ActiveX, Excel, Internet Explorer, Microsoft.NET, SQL Server, Windows, Windows Server, Windows XP, Windows Vista and Windows 7 are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. SafeNet Sentinel is a trademark of Sentinel, Inc. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. PI is a registered trademark of OSIsoft, Inc. General Notice: Some product names used in this manual are used for identification purposes only and may be trademarks of their respective companies. Validity Note The present documentation is intended for qualified technical personnel responsible for the implementation, operation and maintenance of the products described. It contains information necessary for the proper use of the products. Electrical equipment should be installed, operated, serviced, and maintained only by qualified personnel. No responsibility is assumed by Schneider Electric for any consequences arising out of the use of this material. A qualified person is one who has skills and knowledge related to the construction and operation of the electrical equipment and installations and has received safety training to recognize and avoid the hazards involved. May 2013 Edition for v7.30 Manual Release 1 ii Version 7.30 May 2013

3 Contents CHAPTER 1: V7.30 CUSTOMIZATION AND DESIGN EXAM TOPICS OVERVIEW Custom Templates Smart Genies Smart Popups and Metadata Forms SQL Interface CitectSCADA and Other Applications Miscellaneous Customization and Design Exam Manual Release 1 iii

4

5 Chapter 1: v7.30 Customization and Design Exam Topics Overview Introduction You can configure a Vijeo Citect monitoring and control system to suit any industrial application. Because Vijeo Citect has been designed with flexibility in mind, you can design a system to suit your exact requirements. Vijeo Citect suits both small and large applications. Because it is flexible, Vijeo Citect will keep pace with your plant and information requirements as they change and expand. Vijeo Citect is easy to learn and use. Programming techniques may be used to customise your application to suit your requirements. Features such as templates, genies, forms and wizards reduce the time and effort required to configure your Vijeo Citect system, as well as maximising performance. This Chapter Covers These Topics: Custom Templates 1-2 Smart Genies 1-3 Smart Popups and Metadata 1-5 Forms 1-8 SQL Interface 1-9 Vijeo Citect and Other Applications 1-10 Miscellaneous 1-11 Customization and Design Exam Manual Release 1 1-1

6 Custom Templates Common Objects on all Pages If the pages in your project contain items that are common to all pages such as toolbars and status bars you can create your own 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 the location of a common object, or to add a new common object, you do not have to change each page - you can change the template. Vijeo Citect automatically updates all pages based on the template. Suggested Exercises Further Reading Use these suggested exercises to increase your understanding of the topic. Create a custom template in the Example project. Change various pages in the project to use the custom template Make a change to the template then Update Pages. Check the pages. Create an Alarm Template. Use the function AlarmDsp() to populate the page with the current alarms. Use the following references to assist your understanding of the topic. Vijeo Citect Help Topic Reserved ANs. Knowledge Base Article Q2365: Animation Numbers in V5.XX. Knowledge Base Article Q1416: Templates based on templates. 1-2 Version 7.30 May 2013

7 Smart Genies IFDEF Macro One of the key benefits of using genies is that they are reusable. However, sometimes you may wish to use a genie that has been configured for multiple tags but you do not need to use all of the tags. This creates a problem when adding the tags and compiling. The IFDEF macro allows you to define two possible outcomes based on whether or not a specified tag exists within a project at the time of compiling. The macro can be implemented anywhere a simple expression is used, including fields within relevant Vijeo Citect dialogs. By allowing a "0" or "1" to be generated within the Hidden When field of a genie s properties, elements could simply be hidden if a required tag was missing, allowing the genie to still be pasted onto a graphics page. The macro accepts three arguments: the first specifies the tag that requires confirmation, the second defines the outcome if the tag exists and the third defines the outcome if it does not exist. In the case of a genie being pasted on a graphics page, the IFDEF function would be configured as follows in the Hidden When field of the object properties dialog: IFDEF("Tag1_PV",0,1) If the tag "Tag1_PV" is defined in the tag database, the value in the Hidden When field will be 0. If Tag1_PV is undefined, the value will be 1. Since the object is hidden when the value is TRUE (1), the object will be hidden when Tag1_PV is undefined. See the topic Hiding Graphics Objects for more information. Beyond this purpose, the IFDEF macro can be broadly used as a conditional variable. The [<value if defined>] and <value if not defined> arguments can support any variable, expression, or constant. The [<value if defined>] argument is optional if you leave it blank it will return the tag value of the first argument if that argument exists in the project at compile time. For example IFDEF( Bit_1,, ) will return the tag value of Bit_1 if the tag is defined in the project at compile time. You can also use nested IFDEF macros. Suggested Exercises Use these suggested exercises to increase your understanding of the topic. Create Genies using the IfDef() Macro. Create a Genie form to filter tags of a certain type in a drop down list Customization and Design Exam Manual Release 1 1-3

8 Smart Genies (cont.) Further Reading Use the following references to assist your understanding of the topic. Vijeo Citect Help Topic -Understanding Genies. Vijeo Citect Help Topic -Using Genies and Super Genies. Vijeo Citect Help Topic -Hiding Graphics Objects. Vijeo Citect Help Topic -Using structured tag names. Vijeo Citect Help Topic -Using structured tag names with Genies and Super Genies. Knowledge Base Article Q1416: Templates based on templates. Knowledge Base Article Q1764: Writing Genie Form Files. Knowledge Base Article Q2706: Demystifying why windows display where they do. Knowledge Base Article Q2541: Default values for Genie substitutions. 1-4 Version 7.30 May 2013

9 Smart Popups and Metadata Numbered Associations With a numbered association, number is the position of the tag name in the list provided in the function that was called to open the Popup page. It is not strictly necessary to use type in the substitution syntax. However, if the type is used for further clarity it is the data type in the variable tag ( eg. string, int, real or digital ). Example In the example of the function AssPopUp(), AssPopUp( poppage, Tag1, Tag2, Tag3 ) if the tags are a string, integer and digital respectively, then they could be referenced anywhere in the popup page as:?string 1? Strings must have the type defined?int 2? or?2??digital 3? or?3? Named Associations In a named association instance, a separate function must be used to link a variable tag (or other data source, such as a constant or local variable) to a local name defined within the popup window. As is true for numbered associations, the datatype is optional for numeric variables and mandatory for strings. Example Firstly, a connection must be made between the data source and the popup's internal variable. In this instance, the popup contains the variable?valve? and it will be linked to the variable tag "Valve_tag." Ass(-2, "Valve", "Valve_tag",0) The next step is to launch the popup window. All pending tag associations will be drawn into the popup as it is launched. WinNewAt("popPage", 250, 250, ) Customization and Design Exam Manual Release 1 1-5

10 Smart Popups and Metadata (cont.) TagGetProperty Function The functionality of these pages may be extended in the same way as genies by using Smart Pages. A popup page may be used with other objects but sometimes there may be a tag association that is not used. If this happens the #ASS (association) error is displayed on the page. The TagGetProperty() function will enable the popup pages to ignore assignment errors and increase the usability of the popup pages. The Use of Metadata, as an attribute of any object on a graphics page, may be used as a source Metadata of substitution information for named associations on a popup page. There are a variety of Cicode functions available to manage the use of Metadata. Suggested Exercises Further Reading Use these suggested exercises to increase your understanding of the topic. Create a button with metadata and use that data to populate a popup page's substitutions. Use the AssGetProperty and TagGetProperty functions to manage the presence or absence of tags linked to popup pages. Use the following references to assist your understanding of the topic. Vijeo Citect Help Topic -Using structured tag names. Vijeo Citect Help Topic -Using structured tag names with Genies and Super Genies. Vijeo Citect Help Topic -Using Metadata. Knowledge Base Article Q1724: SuperGenies on Pages and Templates. Knowledge Base Article Q2706: Demystifying why windows display where they do. Knowledge Base Article Q1589: #ASS displays in my Super Genie. 1-6 Version 7.30 May 2013

11 Customization and Design Exam Manual Release 1 1-7

12 Forms Reading and Writing Data Suggested Exercises Further Reading Forms may be used to read and write values into variable tags, send and receive information from databases and pass data into functions. Standard forms are provided with Vijeo Citect to enter information into the Vijeo Citect databases but you also have the facility to create your own custom forms. Use these suggested exercises to increase your understanding of the topic. Create a form that will display the value of a tag when it is called and allow you to input a value into a tag. Use the following references to assist your understanding of the topic. Vijeo Citect Help Topic - Form Functions. 1-8 Version 7.30 May 2013

13 SQL Interface ActiveX Data Objects Suggested Exercises Further Reading Vijeo Citect v7.30 introduces the use of the ADO.NET library of SQL functions, which provides a modern approach to data access, can be programmed using any of.net managed languages, and is supported and further developed by its manufacturer. Further, the new ADO.NET approach enables you to have multiple recordsets per connection, and multiple queries per recordset. Earlier versions of Vijeo Citect were restricted to 1 recordset and 1 query per connection. More importantly, the new implementation uses separate application threads for connections, disconnections and query executions, meaning that the SQL queries need no longer be blocking actions. Use these suggested exercises to increase your understanding of the topic. Create a DSN and connect to a database using ADO SQL functions. Use the following references to assist your understanding of the topic. Vijeo Citect Help Topic ActiveX Data Objects Vijeo Citect Help Topic Using External Databases Vijeo Citect Help Topic - SQL Functions. Customization and Design Exam Manual Release 1 1-9

14 Vijeo Citect and Other Applications Transferring Data Suggested Exercises You can transfer data between Vijeo Citect and a wide range of software applications for storage, analysis, and post processing, or to control and tune your Vijeo Citect system. In this chapter we will discuss methods for exchanging data with Vijeo Citect and other applications. Use these suggested exercises to increase your understanding of the topic. Create a Data Source Name (DSN) that will connect to a recipe in dbase format. Use the Database Exchange control to: o o o view the recipes edit the recipes upload the values into Vijeo Citect tags Further Reading Use the following references to assist your understanding of the topic. Vijeo Citect Help Topic - ActiveX Functions. Vijeo Citect Help Topic - Using ODBC drivers. Vijeo Citect Help Topic - SQL Functions Version 7.30 May 2013

15 Miscellaneous Real-world Scenarios This section of the exam is based upon the collected experience of the Exam Development Team and will cover a variety of aspects of Vijeo Citect in realworld situations. No further information is offered for this section. Customization and Design Exam Manual Release