Customizing and Extending PowerDesigner PowerDesigner® 15.2 Windows DOCUMENT ID: DC38628-01-1520-01 LAST REVISED: February 2010 Copyright © 2010 by Sybase, Inc. All rights reserved. This publication pertains to Sybase software and to any subsequent release until otherwise indicated in new editions or technical notes. Information in this document is subject to change without notice. The software described herein is furnished under a license agreement, and it may be used or copied only in accordance with the terms of that agreement. To order additional documents, U.S. and Canadian customers should call Customer Fulfillment at (800) 685-8225, fax (617) 229-9845. Customers in other countries with a U.S. license agreement may contact Customer Fulfillment via the above fax number. All other international customers should contact their Sybase subsidiary or local distributor. Upgrades are provided only at regularly scheduled software release dates. No part of this publication may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, optical, or otherwise, without the prior written permission of Sybase, Inc. Sybase trademarks can be viewed at the Sybase trademarks page at http://www.sybase.com/detail?id=1011207. Sybase and the marks listed are trademarks of Sybase, Inc. A ® indicates registration in the United States of America. Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Unicode and the Unicode Logo are registered trademarks of Unicode, Inc. All other company and product names used herein may be trademarks or registered trademarks of the respective companies with which they are associated. Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS 52.227-7013 for the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies. Sybase, Inc., One Sybase Drive, Dublin, CA 94568 Contents CHAPTER 1: Resource Files and the Public Metamodel ...................................................1 Working with PowerDesigner Resource Files .................1 Lists of Resource Files ........................................1 Working with the Resource Editor ..........................2 Resource Editor Navigation Tools ....................3 Opening Resource Files ......................................4 Opening a Resource File from a Resource File List ......4 "Not Certified" Resource Files ........................4 Sharing and Copying Resource Files .................5 Saving Changes .........................................5 Editing Resource Files ........................................5 Category and Entry Properties ..............................6 Searching in Resource Files .................................6 Copying Resource Files .......................................7 Comparing Resource Files ...................................7 Merging Resource Files .......................................8 Resource File Reference ..........................................9 Resource File Properties ....................................10 Settings Category ............................................11 Settings Category: Object Language ..............11 Settings Category: Process Language ..............13 Settings Category: XML Language ..................14 Generation Category ........................................14 Example: Adding a Generation Command and Task ..................................................15 Example 2: Adding a Generation Option ..........18 Profile Category .............................................19 Generated Files Category ...........................19 Templates Category ..................................23 Customizing and Extending PowerDesigner iii Contents Shared/Extended Attribute Types Category ......25 Extended Model Definitions ....................................26 Attaching Extensions to a Model ..........................26 Creating an Extended Model Definition ..................27 Creating a Generic Extended Model Definition .......................................................27 Creating an Extended Model Definition for a Specific Model .....................................28 Exporting an Extended Model Definition .................29 Extended Model Definition Properties ...................29 Extending Code Generation with Extended Model Definitions .................................................30 Creating Separate Generation Targets with Extended Model Definitions .........................................31 The PowerDesigner Public Metamodel .......................33 Metamodel Concepts ........................................34 Navigating in the Metamodel ..............................36 Accessing the Metamodel with VB Script ................37 Using the Metamodel with GTL ...........................38 Calculated Attributes ................................38 Calculated Collections ...............................39 The PowerDesigner XML Model File Format .................40 PowerDesigner XML Model File Markup ..................40 XML and the PowerDesigner Metamodel .................41 Example: Simple OOM XML File ...........................42 Modifying an XML File .......................................45 CHAPTER 2: DBMS Resource File Reference ............47 Opening your Target DBMS Definition File in the Target Editor ............................................................47 DBMS Definition File Structure ............................48 DBMS Property Page ..................................49 Triggers Templates, Trigger Template Items, and Procedure Templates ........................49 iv PowerDesigner Contents Managing Generation and Reverse Engineering .............49 Script Category ..............................................50 ODBC Category ...............................................51 Script Generation ...........................................51 Script Reverse Engineering .................................54 Live Database Generation ..................................55 Live Database Reverse Engineering .......................55 Query Structure .......................................56 Extension Mechanism for Live Database Reverse Engineering Queries ...............................58 Live Database Reverse Engineering Physical Options ..............................................60 Live Database Reverse Engineering Function- based Index ........................................61 Live Database Reverse Engineering Qualifiers ...63 Generating and Reverse Engineering Extended Objects ....................................................64 Creating an Extended Object .......................64 Defining Generation and Reverse Engineering Scripts for an Extended Object .................64 Adding Scripts Before or After Generation and Reverse Engineering .....................................65 General Category ................................................. 66 Script/Sql Category ...............................................67 Syntax Category .............................................67 Format Category .............................................68 Date and Time Format ...............................69 File Category .................................................70 Keywords Category ..........................................72 Script/Objects Category .........................................74 Commands for All Objects .................................74 MaxConstLen – Defining a Maximum Constraint Name Length .......................................74 EnableOption – Enabling Physical Options ........74 Customizing and Extending PowerDesigner v Contents GenerationOrder – Customizing the Order in Which Objects Are Generated ...................74 Common Object Items ......................................76 Table ..........................................................80 Column .......................................................84 Working with Null Values ............................91 Index ..........................................................93 Pkey ..........................................................96 Key ............................................................97 Reference ....................................................99 View ......................................................... 102 Tablespace ................................................. 104 Storage ......................................................104 Database ....................................................105 Domain ......................................................106 Abstract Data Type ........................................107 Abstract Data Type Attribute ............................109 User ......................................................... 110 Rule ......................................................... 110 Procedure .................................................. 113 Trigger ...................................................... 114 DBMS Trigger................................................ 117 Join Index ................................................... 118 Qualifier .................................................... 118 Sequence ................................................... 119 Synonym .................................................... 120 Group ....................................................... 120 Role ......................................................... 121 DB Package ..................................................122 DB Package Sub-objects