OpenPlant PowerPID How to Add Service Key-in that Drives Component Template at Placement and Post Placement Version 1.0 February 27, 2012 How to Add Service Key-in that Drives Component Template at Placement and Post Placement 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. Version 1.0 February 27, 2012 Page 2 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement Document Version History Version Date Author Comments 1.0 Tony DeRosa Initial Release 02/01/2012 Reviewed By Date Approved By Date Software Versions Application Name Version OpenPlant PowerPID 08.11.09.26 (SS4 and higher) Bentley Class Editor From PowerPID install Version 1.0 February 27, 2012 Page 3 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement 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 Adding the New SERVICE_NAME Property to Class.....................................................................................................11 Adding the SERVICE_NAME property on the EQUIPMENT class .............................................................................11 Adding the SERVICE_NAME property on the NOZZLE class .....................................................................................11 Setting the Nozzle Dialog to Display at the Time of Placement ..................................................................................13 Creating the New Template in the DGNLib file............................................................................................................14 Testing the Results.......................................................................................................................................................16 Notes ...........................................................................................................................................................................18 Version 1.0 February 27, 2012 Page 4 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement Assumptions prior to starting OpenPlant Power PID and Schema Editing Class and Project Information Note: A general understanding and use of the Class Editor. 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 linestyle 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. Add the new SERVICE_NAME property. Set the Nozzle dialog to display at time of placement. Modify the template DGNLib file and add the new templates. Version 1.0 February 27, 2012 Page 5 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement 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. Version 1.0 February 27, 2012 Page 6 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement 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. Version 1.0 February 27, 2012 Page 7 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement 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 the Set the active associated item (This is a BMF prefixed custom attribute). MAKE SURE TO ADD both of the custom attributes 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 Version 1.0 February 27, 2012 Page 8 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement 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 and modify it as shown below adding the Value keyin attribute and the Set the active associated item (This is a BMF prefixed custom attribute). MAKE SURE TO ADD both of the custom attributes to the Supplemental schema. Version 1.0 February 27, 2012 Page 9 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement Save the schemas Version 1.0 February 27, 2012 Page 10 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement Adding the New SERVICE_NAME Property to Class Adding the SERVICE_NAME 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. From the properties tab pick the Add… button and add a new property named SERVICE_NAME. To this new property add the Value key-in attribute and Notify Related Component of Property Value Change custom attributes as shown below. Save the schema. Adding the SERVICE_NAME 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. From the properties tab pick the Add… button and add a new property named SERVICE_NAME. To this new property add the Value key-in attribute as shown below. Version 1.0 February 27, 2012 Page 11 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement Save the schema. Version 1.0 February 27, 2012 Page 12 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement Setting the Nozzle Dialog to Display at the Time of Placement Continuing in the Class Editor In the left hand panel select the NOZZLE class. Make sure the Class tab is active in the right hand panel. Locate the Tag Display Prompt Custom attribute and edit so that SyncWithTagDisplayVariable is set to TRUE as shown below. Save the schemas. Version 1.0 February 27, 2012 Page 13 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement Creating the New Template in the DGNLib file. 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 States. (NOTE THIS NAME IS CRITICAL as it matches the current key-in values set in the schemas.) Now that the States group is created pick on the States node and pick the New Template icon. Name the new template New. Repeat this process two more times and add the Existing and Future templates. For the sake of making them different select each template and set the Colors property to be different for each one. Version 1.0 February 27, 2012 Page 14 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement Exit the DGNLib file. Version 1.0 February 27, 2012 Page 15 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement Testing the Results Launch OpenPlant PowerPID. Create a new PID file. Add three new services to the file. Add “New”, “Existing” and “Future”. 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 c a s e i t s h o w s i n g r e e n Add a Nozzle to the vessel. o Note the Nozzle adopts the same template as the vessel and displays in the green color. Version 1.0 February 27, 2012 Page 16 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement 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. Version 1.0 February 27, 2012 Page 17 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate How to Add Service Key-in that Drives Component Template at Placement and Post Placement Notes Version 1.0 February 27, 2012 Page 18 of 18 Copyright © 2010 Bentley Systems, Inc. Do Not Duplicate
© Copyright 2024