OpenPlant PowerPID How to Add Service Key-in that Drives Component Template at November 21, 2012
Trademarks Bentley, the B Bentley logo, MicroStation, ProjectWise and AutoPLANT are registered trademarks of Bentley Systems, Inc or Bentley Software, Inc. Microsoft, Windows and SQL Server are registered trademarks of Microsoft Corporation. AutoCAD is a registered trademark of Autodesk, Inc. Oracle 11g, 10g and Oracle 9i are registered trademarks of Oracle Corporation. Other brands and product names are the trademarks of their respective owners. Copyrights 2010 Bentley Systems, Incorporated No part of this document may be reproduced, translated, or transmitted in any form or by an means, electronic or mechanical, for any purpose without the express written permission of Bentley Systems, Inc, and then only on the condition that this notice is included in any such reproduction. No information as to the contents of this document may be communicated to any third party without the prior written consent of Bentley Systems, Inc. Information in this document is subject to change without notice and does not represent a commitment on the part of Bentley Systems, Inc. Bentley Systems, Inc. is not liable for errors contained in this document or for incidental or consequential damages in connection with furnishing or use of this material. Including software, file formats, and audiovisual displays; may only be used pursuant to applicable software license agreement contains confidential and proprietary information of Bentley Systems, Inc. and/or third parties which is protected by copyright and trade secret law and may not be provided otherwise made available without proper authorization. RESTRICTED RIGHTS LEGENDS Use, duplication, or disclosure by the government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Right in Technical Data and Computer Software clause in DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of the Commercial Computer Software Restricted Rights in 48 CFR 52.227-19 as applicable. Unpublished rights reserved under the Copyright Laws of the United States and International treaties. Downloaded files from Bentley-related Internet websites and files included on MySELECT CDs are subject to the legal terms, conditions, policies and usage restrictions posted on the website(s), which may significantly alter the rights granted in the license agreement included with these materials. November 21, 2012 Page 2 of 15 Do Not Duplicate
Document Version History Version Date Author Comments 1.0 02/01/2012 Tony DeRosa Initial Release 2.0 11/21/2012 Tony DeRosa Updated for OpenPlant PowerPID SELECT series 5 Reviewed By Date Approved By Date Software Versions Application Name OpenPlant PowerPID Bentley Class Editor Version 08.11.09.26 (SS4 and higher) From PowerPID install November 21, 2012 Page 3 of 15 Do Not Duplicate
Table of Contents Assumptions prior to starting... 5 OpenPlant Power PID and Schema Editing... 5 Class and Project Information... 5 Objective... 5 General Overview of Required Administrative Task... 5 OpenPlant PowerPID Schemas... 5 Verifying the default BMF schema... 6 Setting the EQUIPMENT and NOZZLE classes to use the Value Key-in... 7 Modify the Existing SERVICE Property... 8 Modifying the SERVICE property on the EQUIPMENT class... 8 Modifying the SERVICE property on the NOZZLE class... 9 Creating the New Templates in the DGNLib file.... 10 Creating the New Templates for Nozzles... 10 Creating the New Templates for Equipment... 11 Testing the Results... 13 Notes... 15 November 21, 2012 Page 4 of 15 Do Not Duplicate
Assumptions prior to starting OpenPlant Power PID and Schema Editing Class and Project Information A general understanding and use of the Class Editor. Note: A good understanding of OpenPlant PowerPID schemas is also assumed. Objective This session will cover the process of using an existing Associated Item (In this case SERVICE) to use a specific MicroStation template from a DGNLib file. This will allow the user to select SERVICE and set the value as desired and have the piece of equipment adopt a specific template that controls color, line weight and line style of that equipment. It will also allow this value to automatically be passed to related nozzles so they adopt the same template. Additionally if the user changes the value for SERVICE the equipment and related nozzles will update accordingly. This will only work with an ASSOCIATED PROPERTY and not a standard common property such as Description. Note: This procedure is for EQUIPMENT only and a separate slightly different approach is required for Pipe Lines/Runs and related in line components. General Overview of Required Administrative Task OpenPlant PowerPID Schemas Verify the BMF default schema. Set the class for equipment and nozzle to use the Value Key-ins. Modify the existing SERVICE property. Modify the template DGNLib file and add the new templates. November 21, 2012 Page 5 of 15 Do Not Duplicate
Verifying the default BMF schema Load the Class Editor From within the Class Editor load the bmf.01.02.ecschema.xml schema Expand the Classes node tree in the left hand pane and verify that the class names shown below are present in the schema. These will be there in SS4 and higher but depending on previous customizations you may not be working with an SS4 version of the schema. November 21, 2012 Page 6 of 15 Do Not Duplicate
Setting the EQUIPMENT and NOZZLE classes to use the Value Key-in Load the Class Editor From within the Class Editor load the OpenPlant_PID.01.02.ecschema.xml file located in the project schemas folder to be modified. Once loaded right click on the schema and from the context menu select Supplement Schema and pick the OpenPlant_PID_Supplemental_Imperial.01.02.ecschema.xml file. Expand the tree in the left hand pane and pick on the EQUIPMENT class. Alternatively you can use the search tool to locate the class. Right click on the EQUIPMENT node in the left hand panel and from the context menu select Custom Attributes Add/Remove Add the Value Property Template attribute and fill it in as shown below. Repeat this process for the NOZZLE class as shown below. Save the schemas. November 21, 2012 Page 7 of 15 Do Not Duplicate
Modify the Existing SERVICE Property Modifying the SERVICE property on the EQUIPMENT class Continuing in the Class Editor Select the EQUIPMENT class in the left hand panel, in the right hand panel pick on the Properties tab. Navigate to the Service property and modify it as shown below adding the Value keyin attribute and MAKE SURE TO ADD the custom attribute to the Supplemental schema. You may also have to add the BMF Notify Related Component of Property Value Change custom attribute if it does not already exist. Save the schema November 21, 2012 Page 8 of 15 Do Not Duplicate
Modifying the SERVICE property on the NOZZLE class Continuing in the Class Editor Select the NOZZLE class in the left hand panel. In the right hand panel pick on the Properties tab. Navigate to the Service property, if the property is greyed out use the Override button to localize the property. Modify it as shown below adding the Value keyin attribute, Set the active associated item and Property Custom Attribute (The last two are BMF prefixed custom attributes). MAKE SURE TO ADD the custom attributes to the Supplemental schema. Save the schemas. November 21, 2012 Page 9 of 15 Do Not Duplicate
Creating the New Templates in the DGNLib file. Creating the New Templates for Nozzles Load OpenPlant PowerPID. From the startup dialog change the file type to DGN Libraries. Navigate to the project specific dgnlibs folder and load the PIDProjectTemplates.dgnlib file. From the menu select Element > Element Templates. In the Element Templates dialog expand the PIDProject Templates dgnlib node. Pick on the node and then pick on the New Template Group tool and add a new group named Nozzles. (NOTE THIS NAME IS CRITICAL as it matches the current key-in values set in the schemas.) Now that the Nozzles group is created pick on the Nozzles node and pick the New Template icon. Name the new template New. Repeat this process two more times and add the Future and Existing templates. November 21, 2012 Page 10 of 15 Do Not Duplicate
For the sake of making them different select each template and set the Colors property to be different for each one. Save the DGNLib file. Creating the New Templates for Equipment Continuing in OpenPlant PowerPID. From the startup dialog change the file type to DGN Libraries. Navigate to the project specific dgnlibs folder and load the PIDProjectTemplates.dgnlib file. From the menu select Element > Element Templates. In the Element Templates dialog expand the PIDProject Templates dgnlib node. November 21, 2012 Page 11 of 15 Do Not Duplicate
Right click on the Equip Template Group and from the context menu select New Template Group. Name the new group Service. Right click on the newly created Service group and from the context menu select New Template. Create the new template as shown below. Repeat this process for the other two service templates as shown below. Exit the DGNLib file. November 21, 2012 Page 12 of 15 Do Not Duplicate
Testing the Results Launch OpenPlant PowerPID. Create a new PID file. Add three new services to the file. Add New, Future and Existing. Insert a Vessel. Place the vessel and from the Tag Dialog set the Service to Future. o Notice the tank inserts based on the template settings as defined in the schema. In this case it shows in yellow. Add a Nozzle to the vessel. o Note the Nozzle adopts the same template as the vessel and displays in the yellow color. November 21, 2012 Page 13 of 15 Do Not Duplicate
Now edit the vessel and change the Service to New. o Note the vessel and the nozzle update to the correct template settings. In this case the vessel and the nozzle colors are set to red. November 21, 2012 Page 14 of 15 Do Not Duplicate
Notes How to Add Service Key-in that Drives Component Template at November 21, 2012 Page 15 of 15 Do Not Duplicate