Smart P&ID Example: Mapping New Enumerated List Entries Starting in the SmartPlant Schema - Intergraph Smart P&ID - 10 - Help - Intergraph

Intergraph Smart P&ID Help

Language
English
Product
Intergraph Smart P&ID
Search by Category
Help
Smart P&ID Version
10
Smart Engineering Manager Version
11
SmartSketch Version
10.0(2018)

The following topic provides an example of adding and defining mapping for a new enumerated list called Corrosive and its entries to the hierarchical Fluid System enumerated list starting in the SmartPlant schema.

Before You Extend the Smart P&ID Database

  1. Make a backup of the SmartPlant Foundation site database and any vaults for the site.

  2. Create a backup of Smart P&ID, including a database backup from the plant level with reference data, an application-level data dictionary template (DDT), and a backup of the SPPIDDataMap.xml file located in the SmartPlant resources directory.

Launch Schema Editor and Load the Smart P&ID Tool Map Schema

  1. In the Desktop Client, set your scope for the applicable plant, and then find the CMF file.

  2. Right-click the CMF file, and then select Edit > Check Out to display the Check Out dialog.

  3. Select OK.

  4. In the New Items window, right-click the new version of the CMF file, and select Launch Schema Editor.

  5. On the Set Active Configurations dialog, select the schema version that you want to view.For more options, select Advanced.

  6. Select OK to set the configuration.

  • The CMF file must be checked in to SmartPlant Foundation before users can publish from an authoring tool.

  • By default, changes to the SmartPlant Schema are written to all versions managed by the CMF file. Although you can choose to write changes to only selected versions, we do not recommend doing so.

    • If you choose to view one version of the schema (Specify configurations to display window) but write changes to all versions (Set Configurations for new objects window), an information window appears when you select OK, indicating that you will be prompted with every change to the schema to confirm that you want to write the changes to all versions. Select OK to continue.

  1. In the Schema Editor, select File > SmartPlant > Edit Engineering Tool Options, and select SMARTPLANTPID from the list of authoring tools to load the Smart P&ID tool map schema.

  2. Under Startup options, select the Load map schema and Connect to application schema check boxes, and select OK.

  3. In each row in the Synchronize dialog, the values in the tool database and tool map schema columns indicate actions to correct inconsistencies between the tool metadata and tool map schema. Select the appropriate action in each row, and then select OK.

    • Each row represents a discrepancy between the tool database and the tool map schema.

    • Default actions are blue when the Synchronize dialog displays. However, if you select a different option, it will become blue instead.

    • In many cases, only one operation is supported to synchronize the tool database and tool map schema. For example, if a new property was found in the database, the metadata adapter can add the property to the tool map schema, but it cannot remove the property from the tool database.

Verify that the Corrosive Enumerated List Does Not Already Exist in the Schema

  1. In the Map Environment window, select the Schema tab.

  2. Find the Fluid system enumerated list in the tree view.

  3. Right-click the Fluid system node, and then select View FluidSystems.

  4. In the Edit Enumerated List dialog, review the existing list entries.

    Note that Corrosive does not exist in the Fluid system list.

  5. Next, check to be sure that there are not any fluid code entries with the same meaning as the one you want to add.

Add the New Corrosive List to the SmartPlant Schema

  1. In the Map Environment, return to the Tool tab.

  2. Expand SMARTPLANTPID > Loaded Map Schemas > SmartPlant P&ID Tool Schema.

  3. Expand the Map Enumerated Lists node, and double-click Fluid System.

  4. Select the Publish tab.

  5. In the SmartPlant schema tree view on the right side of the Publish tab, right-click any entry under the Fluid system node, and then select Create New EnumListType on the shortcut menu.

  6. In the New Enumerated List dialog, type Corrosive as the short description of the new list, Corrosive Fluid System as the long description, and 10100 as the number.

    FluidCode

  7. Select New Child Entry, and create a fluid code of KA with a description of (KA) Ammonia, Anhydrous.

  8. Repeat step 7 for each fluid code in the following list, and select OK.

    Fluid Code (Short Description)

    Long Description

    KA

    (KA) Ammonia, Anhydrous

    KC

    (KC) Caustic

    KP

    (KP) Process Chemical

    KW

    (KW) Ammonia, Aqueous

    FluidCode2

Add the New Corrosive List to the Smart P&ID Tool Map Schema and Map

  1. In the authoring tool map schema tree view on the left side of the Publish tab, right-click any entry under the Fluid system node, and then select Create New SPMapEnumDef.

  2. In the New SPMapEnumDef dialog, type Corrosive in the Name field.

  3. Type Corrosive Fluid System in the Description box, and then select OK.

  4. The new list appears in the Unmapped application enumerations table.

  5. In the Unmapped application enumerations list, select Corrosive.

  6. In the Unmapped SmartPlant enumerations list, select Corrosive.

  7. Select Map .

  8. Select OK.

Add Entries to the Fluid Code List and Map

  1. In the Map Environment, double-select Fluid Code under the Map Enumerated Lists node.

  2. On the Edit Map Enumerated List Definition dialog, select the Publish tab.

  3. Above Unmapped SmartPlant enumerations on the right side of the dialog, select New Application Enumeration on the toolbar.

  4. In the New SPMapEnumDef dialog, create a fluid code of KA with a description of (KA) Ammonia, Anhydrous.

  5. Repeat steps 3 and 4 for each fluid code in the following list:

    Fluid Code (Short Description)

    Long Description

    KA

    (KA) Ammonia, Anhydrous

    KC

    (KC) Caustic

    KP

    (KP) Process Chemical

    KW

    (KW) Ammonia, Aqueous

  6. Select the Advanced tab.

  7. Under Map enumerated list definition, browse to fluid code KA.

  8. In the Constrained by box, select Browse, and select Corrosive as the dependent fluid code enum entry. This value is saved in the tool map schema and ensures that the Corrosive fluid system enum entry is defined as the Dependent value of the selected fluid code in the Data Dictionary.

  9. Repeat step 8 for each of the fluid code enum entries KC, KP, and KW.

  10. Select the Publish tab.

  11. In the Unmapped application enumerations table, select a fluid code that you defined.

  12. In the Unmapped SmartPlant enumerations table, select the corresponding fluid code from the SmartPlant schema.

  13. Select Map .

  14. Repeat steps 5-7 for each enumerated entry in the Fluid Code list.

Save the Tool Map Schema and SmartPlant Schema Changes

  • Select File > Save All Modified Files to save the SmartPlant schema changes (CMF file) and the tool map schema.

  • When you close the Schema Editor, the software prompts you to save your connection information, user interface options, and loaded tool map schemas to a session file. Select Yes in the message box to save the session file so that you can use it to return to this working environment. However, you should not open a session file after launching the CMF file from the Desktop Client.

  • If you save changes to the CMF file or a tool map schema but did not validate the changes before exiting, the software displays an information message to remind you that the file contains changes that have not been validated. Select OK to dismiss the message.

  • If you make changes to the SmartPlant schema, you must load the changes into the SmartPlant Foundation database.

  • Additionally, if you made changes to the SmartPlant schema, you should regenerate the component schemas for the site before testing any publish or retrieve mapping relationships.

Review New Corrosive List in Data Dictionary Manager

  1. Select Start > All Programs > Intergraph Smart Admin > Data Dictionary Manager.

  2. Connect to the appropriate plant server for Smart P&ID.

  3. Select Select Entry.

  4. In the Selected list box, select Fluid System, and review the new Corrosive entry in the table.

  5. In the Selected list box, select Fluid Code, and in the Dependent Value column for each of the new fluid codes, select Corrosive as the fluid system value.

  6. Review the entries that you added in the table.

    ConfirmFluidCodes