Applies To
Product(s):	OpenPlant Modeler
Version(s):	08.11.09.XXX (SS5) | 08.11.11.XXX (SS6)
Environment:	Windows 7/8.1/10 (64 bit)
Area:	Component
Subarea:	Graphics
Original Author:	Rahul Kumar, Bentley Global Technical Support Group

In OpenPlant Modeler, to create custom component for Multiport Valve.

Background

 As per project requirement Custom valves needed to add in OpenPlant Modeler. Below steps illustrates how to add a multi-port Valves in Schema. User need to add a new class in schema, under the Valve class which exhibits same property. This can be Inline Valve/Multi Way Valve/Multi Stage Valve etc. Below illustration has been shown using inline valve. Further by placing it in OpenPlant Modeler, through ‘Create New Custom Component’ option from piping task pane, it will inherit the same property like other valve class and deliver the same results like default existing one. 

Steps to Accomplish

This will execute in 3 steps:

A. Add Custom Component Attributes for a Class.

B. Creation of Custom Component.

C. Creation of Spec.

A.  Add Custom Component Attributes for a Class. 

1. Launch the Bentley Class Editor and open below schemas:
   
   
   1. OpenPlant_3D.01.04.ecschema.xml  (%ProjectRoot%...\WorkSpace\Projects\OPModeler_Metric\DataSet\Schemas\).
   2. Supplement it with, OpenPlant_3D_Supplemental_Modeling.01.04.ecschema.xml  & OpenPlant_3D_Supplemental_Information_3DComponent. 01.04.ecschema.xml (%ProjectRoot%...\WorkSpace\Projects\OPModeler_Metric\DataSet\Schemas\)
      
      
2. In the OpenPlant3D.01.04 schema, navigate to Classes\Plant Base Object\Named Item\Device\Piping Component\Fluid Regulator\Inline Valve.
   
   
3. Right click on Inline Valve and click on ‘Add Derived Class’ to add a new class under it.
   
   
4. Create a New class, say MULTI_PORT_VALVE. Navigate to ‘Inline Valve’ Class. Add a new class ‘MULTI_PORT_VALVE’ under it. See image below. 
   
   
   
   Note: Above Class has been taken as Inline Valve, which is for reference use only. User could select MULTI_WAY_VALVE Class and copy the existing class under it for their use. Here they can get default Custom Attribute with 4 ports under FOUR_WAY_VALVE class.
   
   
   
   
5. Expand the Classes node right-click on the desired class.
   
   
6. Select Custom Attributes > Add/Remove from the popup menu.
   
   
   
   
7. In the ensuing dialog, select the USE_CLASS_AS_CUSTOM_COMPONENT attribute from the Available Custom Attributes list.
   
   
8. Click the arrow button to add to the Applied Custom Attributes pane.
   
   
9. Click OK to add the attribute.
   
   
10. In the Use Class as Custom Components attribute, set the Enable value to True. It should appear as follows.
    
    
    
    Note: As a short way, user can copy the custom attribute from existing class, say Multi Way Valve.
    
    
11. Next, using the OpenPlant_3D_Supplemental_Information_3DComponent.01.04.ecschema.xml schema, follow steps 5-10 above to add the Component_Ports_Information attribute if it is not already defined.
    
    
12. Similarly add Custom attribute OpenPlant_Physical_Catalogue_Class_Map.
    
    
    
    Note: Class name could be mapped as per user’s requirement. This has been shown for reference purpose only.
    
    
13. Save settings. Launch OpenPlant Modeler. Now when user open Custom Piping Component Builder dialog, the new component class will display in the Component Type list.

B.  Creation of Custom Component. 

1. Place Solid element through Equipment tab as Valve component.  See image below:
   
   
   
   
2. Select created component.
   
   
3. From Piping Tab, under B-5, Click on ‘Create New Custom Component’ option.
   
   
4. Select CUSTOM_VALVE class from the drop down list. See image below.
   
   
   
   
5. Based on multiple ports created, user need to define origin and connect points on each port end.
   
   
   
   
6. Enter the data required. Make sure the data should matches with the available mating components. See image below. 
   
   
   
   
7. To get the Butt Weld end connection, user needs to define the End preparation on desired ports to get it enabled in model. See below image where Butt Weld connection has been assigned on Main_Port and Run_Port End. 
   
   
   
   
8. After defining each connection points, User can copy and paste custom component to make an assembly. See below image showing Butt Weld connection end between two adjacent Valves. 
   
   
   
   
9. On defining each connection point as Butt Weld, user could be able to connect all valves as Butt Weld. 
   
   
   
   
10. The Assembly after placing valves adjacent to each other and with 45 degree rotation should looks like as below:
    
    
    
    Note: - To use spec data, user needs to add MULTI_PORT_VALVE class in Catalog Editor and then create spec with available information. This will enable user to use ‘Use Spec Data’ option. Below mentioned steps illustrates adding information in spec and to use it in Custom Piping Component Builder.
    
    
11. After defining ports, click on ‘Create Component’ option. Soon after clicking, it will launch modify component dialog box to define and rename the tags if required. See image below: 
    
    
    
    
12. Multi-Port valves gets the end connection defined. Place a flange and verify results. See image below.
    
    
    

C.  Creation of Spec 

To enable Use spec data, user needs to update catalog editor and define the new class. This will fetch the data    from spec and allow user to inherit its properties automatically. This includes creation of catalog, creation of specs and entering the data for Multi-port valve. Below steps illustrates the issue. 

1. Launch Bentley OpenPlant Specification generator.
   
   
2. Select Project Unit as default Metric.
   
   
   
   
3. Open Catalog Editor using File Menu option.
   
   
   
   
4. Select New to create a new catalog. Name it as MPV. 
   
   
   
   
   
   
5. Click on ‘Add new Table’ and select VALVFL. Click OK.
   
   
6. One quickest way is to import existing catalog which contains VALVFL entries. Refer below image.
   
   
   
   
7. Select VALVFL and also pick Import Structure and Data for reference.
   
   
   
   
8. Enter the data for table VALVFL like shown below. See image for reference only.
   
   
   
   
9. Close Catalog editor. From Edit menu, select Add catalog to enter data for Multi-Port Valve.
   
   
   
   
10. Select Section Name as Valve. Enter the data as required.
    
    
    
    
    
    
11. Save Spec and close the Specification generator.
    
    
    
    
12. Launch OpenPlant Modeler. 
    
    
13. Create a custom component like explained above under Creation of Custom Component.
    
    
14. Select Class MULTI_PORT_VALVE and Check on ‘Use Spec Data’. It will read all the information automatically. See image below: 
    
    
    
    
15. Multi-Port valves gets the end connection defined. Place a flange and verify results.
    
    

See Also

See Help Menu for 'Add Custom Attributes for a Class' for more details.

communities.bentley.com/.../how-to-configure-welded-relief-valve

communities.bentley.com/.../how-to-add-custom-valves-in-schema

communities.bentley.com/.../how-to-create-custom-components-from-cell

Comments or Corrections?

Bentley's Global Technical Support group requests that you please confine any comments you have on this Wiki entry to Forum section? section. THANK YOU!