Académique Documents
Professionnel Documents
Culture Documents
Disclaimer
Information of a technical nature, and particulars of the product and its use, is given by AVEVA Solutions Ltd and its subsidiaries without warranty. AVEVA Solutions Ltd and its subsidiaries disclaim any and all warranties and conditions, expressed or implied, to the fullest extent permitted by law. Neither the author nor AVEVA Solutions Ltd, or any of its subsidiaries, shall be liable to any person or entity for any actions, claims, loss or damage arising from the use or possession of any information, particulars, or errors in this publication, or any incorrect use of the product, whatsoever.
Copyright
Copyright and all other intellectual property rights in this manual and the associated software, and every part of it (including source code, object code, any data contained in it, the manual and any other documentation supplied with it) belongs to AVEVA Solutions Ltd or its subsidiaries. All other rights are reserved to AVEVA Solutions Ltd and its subsidiaries. The information contained in this document is commercially sensitive, and shall not be copied, reproduced, stored in a retrieval system, or transmitted without the prior written permission of AVEVA Solutions Ltd Where such permission is granted, it expressly requires that this Disclaimer and Copyright notice is prominently displayed at the beginning of every copy that is made. The manual and associated documentation may not be adapted, reproduced, or copied, in any material or electronic form, without the prior written permission of AVEVA Solutions Ltd. The user may also not reverse engineer, decompile, copy, or adapt the associated software. Neither the whole, nor part of the product described in this publication may be incorporated into any third-party software, product, machine, or system without the prior written permission of AVEVA Solutions Ltd, save as permitted by law. Any such unauthorised action is strictly prohibited, and may give rise to civil liabilities and criminal prosecution. The AVEVA products described in this guide are to be installed and operated strictly in accordance with the terms and conditions of the respective licence agreements, and in accordance with the relevant User Documentation. Unauthorised or unlicensed use of the product is strictly prohibited. First published November 2007. This revision published February 2008. AVEVA Solutions Ltd, and its subsidiaries 2008. AVEVA Solutions Ltd, High Cross, Madingley Road, Cambridge, CB3 0HB, United Kingdom.
Trademarks
AVEVA and Tribon are registered trademarks of AVEVA Solutions Ltd or its subsidiaries. Unauthorised use of the AVEVA or Tribon trademarks is strictly forbidden. AVEVA product names are trademarks or registered trademarks of AVEVA Solutions Ltd or its subsidiaries, registered in the UK, Europe and other countries (worldwide). The copyright, trade mark rights, or other intellectual property rights in any other product, its name or logo belongs to its respective owner.
Contents
Page
PID Manager
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1
AVEVA P&ID Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1 Accessing P&ID Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1:1
Pre-configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:3
Post Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:3
Module definition configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:3 Database configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:3 UDA creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2:3
12.0
12.0
Viewing Element Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating, Viewing and Deleting Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting other Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Renaming Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Moving Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Releasing and Unreleasing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Saving Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
12.0
12.0
1
1.1
Introduction
AVEVA P&ID Manager
AVEVA P&ID Manager is an add-in to PDMS 12.0 and is used to import P&ID data into PDMS Schematic databases. The P&ID data is imported from an XML file, the content of which complies with ISO 15926. The ISO 15926 XML file may be exported from AVEVA P&ID Designer, AVEVA VPE P&ID and from other supported P&ID Systems. AVEVA are committed to the use of open standards for the interchange of plant data between AVEVA and 3rd party products. ISO 15926 is an open standard for the representation of process plant life-cycle information. This representation is specified by a generic, conceptual data model designed to be used in conjunction with reference data: standard instances that represent information common to a number of users, process plants, or both. For further information and for details of what P&ID systems can feed data into the PDMS Schematic model through AVEVA P&ID Manager, contact your local AVEVA sales office. Once imported, P&ID data in the schematic database can be viewed and managed via a hierarchical data explorer (P&ID Manager Explorer). This explorer includes facilities for releasing selected schematic elements to the AVEVA P&ID 3D Integrator, for integration with the 3D Design Model database. Facilities are also provided to view P&IDs, both before and after import, using the Adobe SVG Viewer (Version 3.0.2). A set of standard PDMS report templates which report against the schematic database are also included
1.2
The P&ID Manager menu consists of four main options: The File sub-menu is used to view previews of the P&IDs available to be imported, and to carry out imports. See Section 4 Previewing Diagrams before Import and Section 5 Importing Diagrams.
12.0
The Options sub-menu is used to set options which control how P&ID Manager operates. See Section 3 P&ID Manager Options. For pre-configuration details, i.e. details of procedures that should be completed before starting to use P&ID Manager, see Section 2 Pre-configuration. The Display sub-menu is used to view imported data in a hierarchical data Explorer, and to view imported P&IDs. See Section 6 P&ID Manager Explorer and Section 7 Viewing Imported Diagrams.
A number of reports can be run on the Schematic Database. For further details, see Section 8 P&ID Manager Reports.
12.0
2
2.1
2.1.1
Pre-configuration
Post Installation Tasks
Module definition configuration
In order to use P&ID Manager it must be possible to write to the Schematic databases from within the Design module. This can be configured by changing the module definition within the PDMS Admin module as follows :1. Open the Admin module. 2. Select Module definitions from the Project menu. 3. Select the Design module and then click on Advanced Settings 4. Set the Schematic database mode to Read/Write. 5. Click on Apply, close the dialog and select Save Work from the Admin menu.
2.1.2
Database configuration
P&ID Manager requires at least one Schematic database in the MDB being used. To make full use of the features available in P&ID Manager it is also recommended that a Dictionary database is created for the definition of the default P&ID Manager UDAs.
2.1.3
UDA creation
P&ID Manager makes use of UDAs to store additional attribution from the source ISO15926 files. Of particular importance are the UDAs used to store information about page connectivity and source system persistent identities. The UDAs should be added to the MDB as follows: 1. Create a Dictionary database and ensure it is part of the MDB in use. 2. Open the Lexicon Module. 3. At the command prompt type: $M/<pdms install dir>/PIDManagerCreateUDAs.mac savework compile finish ....substituting pdms install dir for your PDMS installation directory. When up-grading from a previous version of P&ID Manager you should run the UDA creation script provided with the new version. This is to ensure that your schematic database contains any new UDA's required by P&ID Manager.
12.0
2.2
Mapping Set-Up
AVEVA P&ID Manager includes a default set of ISO15926 and attribute mappings. These are intended to give a reasonable starting point for the use of P&ID Manager, but will need to be assessed for each project, and amended or added to where appropriate. P&ID Manager provides tools which help in this task. See Section 3.4 The Import Tab in Chapter P&ID Manager Options.
2.2.1
ISO15926 Mapping
The default ISO15926 mappings map a commonly used set of ISO15926 classifications to their corresponding GTYPE and SCSTYPE in the AVEVA P&ID schematic database. The ISO15926 mappings can be configured before importing any data, either manually or by analysis of a set of source files, or may be configured after importing the data by analysing the database(s). Once the mappings have been edited any data in the schematic databases may have the mappings reapplied in order to update their attribution. Please see Section 3.4.1 Viewing/Editing ISO 15926 Mappings in Chapter P&ID Manager Options.
2.2.2
Attribute Mapping
Attribute mappings should be configured before loading data as any changes to the mappings will require the data to be updated (re-imported) in order for them to take effect. Attribute mappings are crucial to the page matching process and must be correctly configured for diagrams to be matched and merged. There are currently no utilities to help in the analysis of the source data for creating attribute mappings. If using the default UDAs then all of the core attributes from the source data should already be populated, but system specific attributes stored within the GenericAttributes elements in the import files will not be present. To configure your attribute mappings: 1. Analyse the source data to determine which XML elements to load from within the GenericAttributes elements. 2. Choose which core attributes or UDAs to store them in, in the database. Note: To avoid conflicting with existing mappings it is recommended that additional data is loaded into your own UDAs. 3. Add the necessary entry in the AttributeMapping dialog. For example if the source data had the following:
<PipingNetworkSegment ID="XMP_13" Tag="100-O-90004-AAB3" ComponentClass="PrimaryLineSegment" > <Extent> <Min X="989" Y="155" Z="0" /> <Max X="533" Y="562" Z="0" /> </Extent> <Position> <Location X="761" Y="358.5" Z="0" /> <Axis X="0" Y="0" Z="1" /> <Reference X="0.67" Y="-0.75" Z="0" /> </Position> <PersistentID Identifier="3407/0" Context="IPE-905675" /> <GenericAttributes Set="PrimaryLineSegment" Number="26">
12.0
<Destination Format="string" Value="E-9001 VSP2" /> <BranchId Format="string" Value="190" /> <Connected_Handle_From Format="string" Value="2399" /> <Number Format="string" Value="90004" /> <Connected_PDMS_Type_To Format="string" Value="NOZZLE" /> <Connected_PDMS_Type_From Format="string" Value="NOZZLE" /> <Source Format="string" Value="J-9002B N2" /> <Connected_Handle_To Format="string" Value="1019" /> <OwnerId Format="string" Value="0" /> <Size Format="string" Value="100" /> <Specification Format="string" Value="AAB3" /> <Fluid Format="string" Value="O" /> </GenericAttributes>
Then the Specification attribute, in bold, may be mapped to a database attribute as below:
The source data may use system specific attributes in order to specify how segments are connected across diagrams. In order to ensure that cross page connections can be connected during import do the following: 1. Choose a sample of the source files 2. For each file find the values of the CrossPageConnection/@AttributeName For example:
3. Determine whether the referenced attributes are inside GenericAttributes elements in the source file. 4. For those that are inside GenericAttributes elements use the AttributeMapping dialog to load the source attributes identified into the database. (See above for PipeId mapping)
12.0
Notes The UDA :Pmgdfltmatch is defined for this purpose, if more than one attribute is identified then more UDAs may need to be defined. PipeId is used in the VPE and P&ID Designer exports for matching page connections and is provided pre-configured for page matching to operate from these source tools.
Please see Section Viewing/Editing Attribute Mapping in Chapter P&ID Manager Options for further information.
2.2.3
Page Matching
If you encounter issues with on and off page connectors not being correctly associated then consult Section Attribute Mapping.
12.0
12.0
The Options dialog consists of six tabs, as described below. To save changes to the options and exit the dialog, select the OK button. To exit the dialog without saving, select the Cancel button.
3.1
Some elements in the schematic database may be accessed by AVEVA P&ID 3D Integrator, for integration into the PDMS design database. Access to such elements by AVEVA P&ID 3D Integrator is controlled by the schematic database release status of these elements. The Element Release tab is used to specify: The element release status related actions carried out during the import of an ISO15926 file into the schematic database. If the Release Comment dialogue box is displayed during release related activities, either initiated during an import, or from the P&ID Manager user interface.
3.1.1
12.0
The effects of selecting each of these options on the release status of elements is shown in the following table: Release status after import of... New Elements (not imported before)
Not Released
Selected Option Error if currently released Release on Import Recall released items on Import Retain release status on Import
(see note)
Released Not Released Released Not Released Released Not Released
Not Released
Released
Not Released
Note: If the Error if currently released option is selected, an error message will be displayed when items that are already present in the database and are released, are re-imported. The import of such elements will be aborted.
3.1.2
12.0
3.2
The File Locations tab is used to specify the default folders for data imports and exports.
3.2.1
10
12.0
Browse for the required folder and press the OK button. The new location is then displayed in the Default Location field.
3.2.2
11
12.0
3.3
The General tab is used to: Copy Options settings from another project associated with the same PDMS instance/ Installation. Import Options settings from files exported from another PDMS installation. Export Options settings to files for importing into other PDMS installation. Reset the project to the default installation settings.
3.3.1
12
12.0
The dialog lists all of the projects on the current PDMS installation for which P&ID Manager options have been saved. Press the OK button. The options are then copied from the selected project. A message is displayed when the copy is complete.
3.3.2
13
12.0
The options specified for the current database are then exported to that location into a file with the default name of <Project>_Options.zip. A message is displayed when the export is complete.
3.3.3
3.3.4
14
12.0
3.4
The Import tab is used to: set up mappings between ISO15926 designations and GTYPES/SCSTYPES map system/project specific attributes from the source files to schematic or user defined database attributes set default SCGROUP database elements to import diagrams, off-line instruments, offline equipment and pipelines into set the default coordinates of equipment and off-line instruments specify whether or not missing attribute values are to be replaced by default attribute values on import
3.4.1
15
12.0
Note that not all schematic items have equivalents in the 3D database. Such items do not need to have mappings set up against their ISO15926 designations. To view or edit the mappings between ISO15926 designations and corresponding GTYPE/ SCSTYPE combinations, press the View/Edit ISO 15926 Mapping button. The ISO15926 Mapping dialog is then displayed.
The grid displays any mappings that have already been set up. A limited set of default mappings are supplied with P&ID Manager. To add a new mapping, click on the blank row at the bottom of the grid enter the designation of the schematic item type in the ISO 15926 Designation field.
16
12.0
Note: Lists of designations can be imported into these fields from a file, or from another database (see below). Complete the mapping by selecting a GTYPE, and if applicable, entering an SCSTYPE. Note that mappings can be automatically completed in accordance with user-defined rules (see below). To delete existing mappings, select the rows containing the mappings and press the Delete Selected Row(s) button. To delete all mappings, press the Delete All button. To close the dialog and save any changes, press the OK button. To close the dialog without saving changes, press the Cancel button.
Browse for the XML file that contains the designations. Once the file is selected, press the Open button. This button will not be active until an XML file has been selected.
17
12.0
The designations in the file are then copied into the ISO 15926 Designation fields. Note that designations already listed in these fields are not imported, and therefore existing mappings will not be overwritten. If the selected file does not contain any valid designations, an error message is displayed.
To set up a rule: 1. In the Rule field enter a Regular Expression that is used to select which designators are to be mapped using the rule. For example, if the rule is to map Control Valves, enter CONTROL VALVE. If the rule is to be used to map different sorts of valve, enter VALVE. All designators containing "VALVE" would be mapped using this rule.
18
12.0
For guidance on using Regular Expressions see Section 9 Appendix: Regular Expressions. 2. In the GTYPE field, select the GTYPE that designators selected by the rule expression are to be mapped to. 3. In the SCSTYPE field, if required, enter the SCSTYPE that designators are to be mapped to. 4. The order in which rules are listed is the order in which they are processed. To change the position of a rule in the list of rules, select the row containing the rule and press the up or down arrow button as required. Once a rule has been applied to an ISO15926 designator, the mapping it applies cannot be overwritten during that process by another rule. If the Overwrite existing values checkbox is checked, existing mappings are overwritten when rules are applied. If the checkbox is unchecked, existing mappings, either entered by the user or set by a previous Auto Complete process, are not overwritten. To delete existing rules, select the rows containing the rules and press the Delete Selected Row(s) button. To delete all rules, press the Delete All button. To close the dialog and save any changes, press the OK button. To close the dialog without saving changes, press the Cancel button.
19
12.0
The Auto Complete button is pressed. The mapping for the CHECK VALVE and CLOSED GENERAL VALVE designators are automatically completed (they are mapped to the VALV GTYPE):
20
12.0
The dialog lists all the Schematic databases in the Master database (MDB). To select the database(s) to import designations from, check the appropriate Apply checkboxes. Once the required selections have been made, press the OK button. The import then takes place. Press the Cancel button to close the dialog without proceeding with the import. The designations in the selected databases are then copied into the ISO 15926 Designation fields. Note that designations already listed in these fields are not imported, and therefore existing mappings will not be overwritten.
21
12.0
The dialog lists all the Schematic databases on the MDB. Select the required databases as described above, and press the OK button.
22
12.0
3.4.2
Proceed as follows for each mapping to be set up or edited. Enter new mappings in the blank row beneath the completed rows: 1. The Type field displays the SCTYPEs to which the mapping is to be applied. To select the SCTYPEs, press the ... button at the end of the field. The Select Values dialog is then displayed.
23
12.0
2. The Select Values dialog consists of two lists. The Available Values list lists the SCTYPEs which are available for selection. The Selected Values list lists the SCTYPEs that have been selected. To select an SCTYPE, select it in the Available Values list and press the > button to transfer it to the Selected Values list. To de-select an SCTYPE, select it in the Selected Values list and press the < button to transfer it back to the Available Values list. Use the >> button to move all SCTYPEs to the Selected Values list. Use the << button to move all SCTYPEs to the Available Values list. Press the OK button once the required SCTYPEs have been selected. The selected SCTYPEs are then displayed in the Type field. Press the Cancel button to close the dialog without saving any selections that have been made. 3. In the Database Attribute Name field, select from the drop-down list the attribute to which the source file attribute is to be mapped to. The list of attributes available will consists of those of the selected SCTYPEs. 4. Enter the name of the source file attribute in the Source Attribute Name field. 5. In the Unit field, if applicable select the type of unit (e.g. weight, volume) associated with the user defined attribute from the drop-down list. On import, the type of unit will be converted to the unit of measure (e.g. kilogram, cubic metres) specified on the Units tab of the Options dialog. 6. In the Source File Format field select the import source file format associated with the source file attribute from the drop-down list. Select * for all formats. 7. The Versions field displays the versions of the source file format associated with the source file attribute. To select the versions, press the ... button at the end of the field. The Select Values dialog is then displayed. See step 2 for details.
Select * for all versions. Once all required mappings have been set up, press the OK button. Press the Cancel button to close the dialog without saving any changes that have been made.
24
12.0
3.4.3
To view or edit the groups into which diagrams, off-line equipment, equipment and pipelines are imported into, select the View/Edit Import Destination Groups button. The Import Destination Groups dialog is then displayed.
The Database field displays the name of the current Schematic database. To view/change the import destination groups of another database, select it from the drop-down list. The list consists of every Schematic database in the MDB.
25
12.0
The grid beneath the Database field lists the four element types and the names of the groups into which they are imported. To select a different group for an element type, select the ... button at the end of the row. The Select Group dialog is then displayed:
Browse for the required group and select the OK button. Press the Cancel button to close the dialog without making any changes. Repeat as required for each of the four element types. Press the OK button to close the Import Destination Groups dialog and save the changes that have been made. Press the Cancel button to close the dialog without saving changes.
3.4.4
26
12.0
The default position is entered in the Off Line Equipment and Instrument Default Position field. For example:
For details of the format in which the coordinates must be entered, refer to PDMS 12.0 documentation.
3.4.5
If the checkbox on the Import dialog is checked, then attribute values not present in imported files will be replaced by default values, which will overwrite the existing values of those attributes in the database. If the checkbox is unchecked, existing values of attributes in the database will be retained when imported files do not include values for these attributes.
27
12.0
3.5
Different diagrams may include measurements in different units of measure. For example, on one diagram weight may be measured in Kilograms, on another it may be measured in Pounds. On import, all such measurements are converted into the units of measure used in the schematic database. The Units tab is used to select the units of measure that measurements are to be converted into. For example, the tab can be used to specify that all weight attributes values are to be converted into Kilograms and all Volume attribute values are to be converted into Cubic Metres. In the Angle, Area, Pressure, Temperature, Volume and Weight fields, select the unit of measure to be applied to values measured in these unit types. Note that the value in the Distance field cannot be changed because all distances are stored in millimetres in the database. The default units of measure are as follows: Unit Type Angle Area Distance Pressure Temperature Default Units of Measure Degrees Square Metres Millimetres Bar Degree Celsius
28
12.0
Changing the unit of measure for a unit type will not update the units of measure for instances of this unit type that have already been imported. Previously imported data must be re-imported for the change to take effect. The P&ID Manager default UDAs include attributes on the SCDIAG elements that store the units of measure used when a diagram is loaded. If you need to determine the units for an attribute value determine which diagram the element was last loaded from and view the appropriate :Pmgunts attribute for the diagram.
29
12.0
3.6
The maximum number of diagrams that can be open at the same time in the P&ID Manager Diagram Viewer is specified on this tab. Enter the required number in Maximum number of diagrams which may be viewed concurrently field. The minimum number is 1. The maximum number is 20.
30
12.0
4
4.1
31
12.0
Browse for and select the XML file or files of the diagrams to be previewed (each file contains data for a single P&ID), and press the Open button. The default import file location is specified on the File System tab of the Options dialog (see Section 3 P&ID Manager Options). Note that there is a limit to the number of diagrams that can be viewed at the same time. This is set on the View tab of the Options dialog (see Section 3 P&ID Manager Options). An error message is displayed if more files than this number are selected. If all of the selected files are invalid, an error message is displayed, listing the invalid files. No diagrams are displayed. If some of the selected files are invalid, a warning message is displayed, listing the invalid files. The message gives the user the option of continuing or cancelling. If the user chooses to continue with the procedure, only diagrams associated with valid files are displayed.
4.2
The viewer displays the selected diagrams. Each diagram is displayed on a tab, labelled with diagram file name. Hover the mouse cursor over a tab to display the file name and location of the diagram file.
32
12.0
If multiple diagrams are being displayed, their tabs may not all fit in the viewer window. If this is the case, forward > and back < buttons will be displayed in the bottom-right hand corner of the window to enable these tabs to be displayed.
4.2.1
It consists of the following buttons: Zoom In Zoom Out Zoom to Window - zooms out so that the entire diagram is visible Set Bookmark - saves the current view - saved views are known as bookmarks Previous Bookmark - sets the view to the bookmark that was set before the current bookmark Next Bookmark - sets the view to the bookmark that was set after the current bookmark Delete Bookmark - deletes the current bookmark Clear All Bookmarks - deletes all bookmarks Note: Bookmarks are not saved when the Diagram Viewer is closed.
4.2.2
Keyboard Commands
Useful keyboard commands include: To zoom into an area of a diagram, press Ctrl and left click on that area. Press Ctrl+Shift to zoom out. To pan, hold down Alt and the left mouse button and drag the cursor in the required direction.
33
12.0
4.2.3
To close all diagrams, select the Close All Tabs option. To close the viewer, select the X button in the top-right-corner of the window.
34
12.0
5
5.1
Importing Diagrams
Selecting Diagrams for Import
From the P&ID Manager menu, select File > Import.
35
12.0
Browse for and select the XML file or files of the diagrams required for import into the Schematic database, and press the Open button. The default import file location is specified on the File System tab of the Options dialog (see Section 3 P&ID Manager Options). The files contain engineering item and graphical data. This data is exported from AutoCAD P&ID drawings using the AVEVA P&ID Designer, from AVEVA VPE P&ID, and other supported P&ID systems. Contact your AVEVA Sales office for details. If all of the selected files are invalid, an error message is displayed, listing the invalid files. The file selection is cancelled. If some of the selected files are invalid, a warning message is displayed, listing the invalid files. The message gives the user the option of continuing with the import or cancelling. If the user chooses to continue with the import, only the valid files are imported. Note: The diagram name attribute in the schematic database has a maximum length of 50 characters. Diagram names in the schematic database begin with a / character. If a diagram name in an import file does not begin with a / character, then P&ID Manager adds one to the beginning of the diagram name on import. Diagram names in import files may therefore be no more than 50 characters, if the diagram name begins with a / character, or no more than 49 characters if the diagram name does not begin with a / character. If these lengths are exceeded then the import of that file will fail. A message indicating the reason for the import failure will be included in the import summary. The Import Dialog is then displayed.
5.2
Import Dialog
The Import dialog displays details of the diagram data files selected for import (see Section 5.1 Selecting Diagrams for Import). Each of these files contains data for a single diagram.
The dialog is used to select import options, and to carry out the import. The selected files are displayed in two grids: The New Diagrams grid lists files containing details of diagrams that are not present in the database.
36
12.0
The Updates to Existing Diagrams grid lists files containing details of diagrams that are already present in the database.
If the name of the diagram in a file matches the name of a diagram that has been imported before, the system adds the file to the Updates to Existing Diagrams grid. Otherwise the file is added to the New Diagrams grid. If required, diagrams can be moved from one grid to another (see below). To select additional files for import, select the Add Diagrams button. The Open dialog is then displayed. Select files as described in Section 5.1 Selecting Diagrams for Import. To delete a file, either right-click on it and select the Remove Row option from the menu that is then displayed, or press the Delete key. To exit the Import dialog without completing the import, press the Cancel button.
5.2.1
To move a file or files from the New Diagrams grid to the Updates to Existing Diagrams grid, select it/them in the New Diagrams grid and either double-click on it, or press this button:
Multiple files can be selected as follows: To select a range of files, hold down the Shift key and left-click on the first file in the range. Still holding down the Shift key, left-click on the last file in the range. Both of these files, and every file listed in between them, is then selected. To select multiple files that are not in a contiguous range, hold down the Ctrl key and left-click on each of the required files.
To move all files from the New Diagrams grid to the Updates to Existing Diagrams grid, press this button:
To move a file or files from the Updates to Existing Diagrams grid to the New Diagrams grid, select it/them in the Updates to Existing Diagrams grid and either double-click on it, or press this button:
To move all files from the Updates to Existing Diagrams grid to the New Diagrams grid, press this button:
37
12.0
5.2.2
The Destination SCGROUP fields are used to select database locations for new diagrams, i.e. where they will be located in the database after the import has taken place. The field defaults to the default location specified in the P&ID Manager options (see Section 3 P&ID Manager Options). Default destination groups will be created on first use of the P&D Manager if they do not already exist in the schematic database.
Selecting a SCGROU
To select a different location for a diagram, press the button at the end of the field:
38
12.0
Browse for the required group and press the OK button. The selected group is then displayed in the Destination SCGROUP field for the diagram. Once the required destination group for each diagram has been selected, they are ready to be imported (see Section 5.2.6 Starting the Import).
39
12.0
5.2.3
The Matched DB Diagram Name fields display the diagram name of the diagrams in the database that the listed diagrams will updated when the import takes place. Where a diagram was placed in this grid by the system, the Matched DB Diagram Name field will be the same as the entry in the Diagram name. A different diagram can be selected if required (see below). If the diagram was transferred into this grid by the user from the New Diagrams grid, the field will be blank. If must be completed before the import can take place.
40
12.0
Browse for the required diagram and press the OK button. The selected diagram name is then displayed in the Matched DB Diagram Name field for the diagram. Once a matching diagram name has been selected for each diagram has been selected, they are ready to be imported (see Section 5.2.6 Starting the Import).
41
12.0
5.2.4
5.2.5
Import Options
Release behaviour on import, including comment entry dialogue display, is specified on the Element Release tab of the Options dialog. To review or change the import settings, such as the ISO15926 or attribute mappings, before an import, press the Options button. The Options dialog is then displayed. Refer to Section 3 P&ID Manager Options for details.
5.2.6
42
12.0
5.3
The grid displays the file name and diagram name of each diagram selected for import. The Import Status fields display the import progress of each diagram, i.e. whether they are waiting to be processed, currently being imported, successfully imported, imported but with errors, or failed to be imported. Each diagram is processed in turn. Once this has been completed, P&ID Manager attempts to match any off-page connections in the imported diagrams with those of diagrams already in the Schematic database. Beneath the grid, the overall progress of the above processes, and status of the import is displayed. To close the dialog after the import is completed, press the Close button.
43
12.0
5.3.1
The dialog is divided into two grids. The Import Diagrams grid lists the imported diagrams and their file names. The Import Diagram Errors displays the error messages associated with the diagram selected in the Import Diagrams grid. To close the Import Errors Report dialog, press the Close button.
44
12.0
5.3.2
The dialog presents a summary of the imported data including any encountered error messages. To copy the summary to a text file, press the Write to File button. In the Save As dialog that is then displayed, select the name and location of the text file. To close the dialog, press the Close button.
45
12.0
5.4
46
12.0
6.1
47
12.0
6.2
48
12.0
Schematic WORL *: The topmost level of the Schematic database hierarchy within which all other elements exist. Cannot be moved, renamed or deleted. SCGROU: Administrative elements containing groups of elements. By default, groups for Diagrams, Instruments, Equipment and Pipelines are created automatically when these elements are imported into the database. Other groups are created as required by users (see Section Creating Groups). The default groups can be changed using the Options dialog (see Chapter P&ID Manager Options). Note: Groups may also contain other groups, which may in turn contain any of the elements a higher level SCGROU may contain. SCDIAG: Diagram elements. Diagrams elements are either imported, or created by the user (see Section Creating Diagrams).
SCEQUI: Equipment.
SCNOZZ: Equipment nozzles. SCSUBE: Sub-equipment. TEXT: Text used to store information about the identity of items. This is provided for use by the system and should not be deleted or renamed by users.
49
12.0
SCPLIN: Pipelines.
SCBRAN: Pipe branches. SCSEG: Page/pipe segments. SCFITT: Fittings. SCINST: Process Instruments.
50
12.0
SCOPCI: Off-page connection (in). SCOPCO: Off-page connection (out). SCTUB: Tubes. SCVALV: Valves. Note: The following schematic element types are not supported by P&ID Manager in the current release: SCHVAC SCPDES SCDUCT SCHVFI SCELCO SCCAB SCCORE SCTEMP SCSTEN
51
12.0
6.3
6.3.1
Group menu:
52
12.0
Diagram menu:
53
12.0
6.3.2
Applying a Filter
The displayed elements can be filtered so that only diagram elements and elements above diagrams in the hierarchy are displayed. To apply the filter, check the Filter checkbox.
54
12.0
6.3.3
All data displayed on the form is read-only. The form automatically changes to display the attributes of the element currently selected (the curent element or CE).
6.3.4
Creating Groups
To create a group, right-click on either the Schematic WORL * element, or on an existing SCGROU element. Select the Create > SCGROU option from the menu.
55
12.0
Enter the name of the new group. The following characters are not permitted in the name of an element:
$ @ * ' '
A name may be a maxiumum of 50 characters, and must be unique within the schamatic database. Press the OK button. The group is then created beneath the selected element.
56
12.0
6.3.5
Enter the name, description, title and number of pages of the new diagram. See Section Creating Groups for element naming rules. Press the OK button. The new diagram is then added to the Explorer.
Diagrams created in this way (rather then added to the database via the import facility) can act as placeholders until associated data can be imported.
57
12.0
Viewing Diagrams
To view a diagram, select the diagram element, right-click, and select the Show Diagram option from the menu. The diagram is then displayed in the P&ID Manager Diagram Viewer. See Viewing Imported Diagrams for details.
Deleting Diagrams
To delete a diagram, select the diagram element, right-click, and select the Delete option from the menu. The Delete Diagram dialog is then displayed.
The name of the selected diagram is displayed in the title bar of the dialog. To delete only the diagram, leaving those elements associated with it (i.e. the items on the diagram) in the database, select the Diagram Only option. To delete both the diagram and associated elements, select the With Contents option. Note that elements that are also associated with other diagrams are not deleted. Press the OK button to complete the deletion.
6.3.6
Note: If an element is deleted, all elements beneath it in the element hierarchy are also deleted.
58
12.0
6.3.7
Renaming Elements
To rename an element, select the element, right-click, and select the Rename option from the menu. The Rename Element dialog is displayed.
Enter the new name of the element. See Section Creating Groups for element naming rules. Press the OK button. It is not recommended that SCDIAG elements are renamed once loaded as it will affect the ability of P&ID Manager to maintain the data associated with the diagram. Rather than rename a diagram, it may be better to delete the diagram element and its related elements from the database and reimport the diagram with the new name.
6.3.8
Moving Elements
Elements can be moved to different locations in the element hierarchy. To move an element, select it, and use the mouse to drag and drop it to the required location. Alternatively, right-click on the element and select the Cut option from the menu. Select the element in the hierarchy beneath which the element is to be placed, right-click, and select the Paste option from the menu. The element is then moved to the selected location. Note: The selected location must be valid for the element type in the hierarchy. For example, a diagram element can be placed beneath a group element, but not the other way round.
6.3.9
59
12.0
When an element is released, all its child elements (i.e. the elements beneath it in the database, such as the nozzles of an equipment item) are released as well. Such elements cannot be released independently of their parent elements. When a diagram element is released, all elements that appear on that diagram are also released. To release an element and its child elements, right-click on it and select the Release to 3D Status ON option from the menu. To release all the elements in a group that are eligible for release, right-click on the SCGROU element in question and select the Release to 3D Status ON option from the menu. To release all elements in the database that are eligible for release, right-click on the WORL* element and select the Release to 3D Status ON option from the menu. The Comment dialog may then be displayed.
Whether or not this dialog is displayed is specified on the Element Release tab of the Options dialog. See P&ID Manager Options. Enter comments as required, and press the OK button to complete the release.
Unreleasing Data
To Unrelease an element, so that it is no longer available to the P&ID 3D Integrator, rightclick on the element and select the Release to 3D Status OFF option from the menu. The Comment dialog may then be displayed as described above. Enter comments as required, and press the OK button The element and all its child elements are no longer accessible by the P&ID 3D Integrator.
6.3.10
Saving Changes
To save changes to the Schematic database, either select the Save Work toolbar button or select the Save Work option from the Design menu. ,
60
12.0
Note: Changes made in the explorer are not saved into the database until a Save Work takes place.
61
12.0
62
12.0
7
7.1
or select a diagram or diagrams in the P&ID Manager Explorer, and select Display > Diagram Viewer from the P&ID Manager menu.
Note: If the viewer was used earlier in the session and then closed, those diagrams that were being displayed when the viewer was closed will automatically be displayed again the next time it is opened during that session.
63
12.0
7.2
The viewer displays the selected P&IDs. Each P&ID is displayed on a tab, labelled with diagram name. Hover the mouse cursor over a tab to display the status and name of the diagram.
For further details of the viewer functionality, refer to Section 4.2 P&ID Manager Diagram Viewer.
64
12.0
Report Content Equipment List Instrument Index Line List Items which have not been released All Off Page Connectors (including unconnected) Items which have been released Unconnected Off Page Connectors Valve List
To run a report Select Utilities > Reports > Run from the main menu. To view or modify a template Select Utilities > Modify > Report. To create a new template Select Utilities > Reports > Create. For further details Refer to the Reporting Using PDMS manual.
65
12.0
66
12.0
9.1
Alternation
A vertical bar is used to separates alternatives. For example, CHECK|CHK will match both CHECK and CHK.
9.2
Grouping
Parentheses are used to define the scope and precedence of the operators. For example: analog|analogue and analo(g|(gue)) These are equivalent, and would return positive matches on both analog and analogue. Parentheses have other uses in Regular Expression construction which are beyond the scope of this guide.
9.3
67
12.0
? The question mark indicates there is zero or one of the preceding element. For example, too? matches both to and too. * The asterisk indicates there are zero or more of the preceding element. For example, ab*c matches ac, abc, abbc, abbbc, and so on. + The plus sign indicates that there is one or more of the preceding element. For example, ab+c matches abc, abbc, abbbc, and so on, but not ac.
The following table contains explanations of the meaning of some commonly used Regular Expression metacharacters, and provides some simple examples of their use, to define how P&ID Manager may automatically determine the GTYPE and optionally the SCSTYPE that should be applied to an ISO15926 component class on import. Metacharacter Description Example Example: (3.*(WAY VALVE)) Matches any character except a newline. If used inside square brackets then the dot is treated as a literal. What this expression means: Matches any component class which contains with any two characters (including space) followed by "WAY VALVE" Example matches using expression:
3 WAY VALVE
Example: ((BLI..).(SP...)) What this expression means: Groups a series of pattern Matches any component class which elements to a single contains BLI followed by any 2 characters followed by any 1 character followed by element SP followed by any three characters. Example matches using expression: BLIND SPADE Example: (CLOSED.4+) What this expression means: Matches the preceding Matches any component class name pattern element one or which contains CLOSED followed by any more times. character followed by 4. Example matches using expression: CLOSED 4 WAY VALVE
( )
68
12.0
Metacharacter
Description
What this expression means: Matches the preceding Matches any component class name pattern element zero or which contains CLOSED followed by any character and optionally followed by 4. one times. Example matches using expression: CLOSED 4 WAY VALVE CLOSED VALVE Example: (4.*WAY VALVE) What this expression means: Matches the preceding Matches any component class name pattern element zero or which contains 4 followed by zero or one characters followed by WAY VALVE more times. Example matches using expression: 4WAY VALVE 4 WAY VALVE Example: X{1,1}
{M,N}
Denotes the minimum M What this expression means: and the maximum N match Matches any component class name which contains one and only one X count. Example matches using expression: FLEXIBLE HOSE Example: [123] What this expression means: Matches any component class name Denotes a set of possible which contains 1,2 or 3 character matches. Example matches using expression: 1 WAY VALVE 2 WAY VALVE DIAPHRAGM ACTUATED 3 WAY BALL VALVE
[...]
69
12.0
Metacharacter
Description Example: [1-3] Matches a range of characters (alpha and numeric), where n1 is the start of the range and n2 the end.
Example
[n1-n2]
What this expression means: Matches any component class name which contains a character within the range 1 to 3 Example matches using expression: 1 WAY VALVE 2 WAY VALVE DIAPHRAGM ACTUATED 3 WAY BALL VALVE Example: (SELF ACTING|AUTOMATIC) What this expression means: Matches any component class name which contains SELF ACTING or AUTOMATIC Example matches using expression: SELF ACTING GLOBE VALVE AUTOMATIC GLOBE VALVE Example: (AP)\b What this expression means: Matches any component class name which contains a word ending in AP Example matches using expression: FLAME TRAP END CAP Example: \W What this expression means: Matches any component class name which contains a non alphanumeric character such as a space Example matches using expression: Any component class name which contains a non alpha numeric character
\b
\W
70
12.0
Metacharacter
Example
\s
What this expression means: Matches any component class name Matches a whitespace which contains a 3 followed by a character (space, tab, whitespace character newline, form feed) Example matches using expression: 3 WAY VALVE DIAPHRAGM ACTUATED 3 WAY VALVE Example: 2\S What this expression means: Matches any component class name Matches anything BUT a which contains a 2 followed by any non whitespace. whitespace character Example matches using expression: 2WAYVALVE CLOSED2WAYVALVE Example: \d What this expression means: Matches a digit, same as Matches any component class name which contains a single digit [0-9]. Example matches using expression: PISTON ACTUATED 4 WAY VALVE CLOSED 3 WAY VALVE
\S
\d
\D
Matches a non-digit.
What this expression means: Matches any component class name which contains a non digit Example: ^(PISTON)
What this expression means: Matches any component class name Matches the beginning of a which begins with PISTON line or string. Example matches using expression: PISTON ACTUATED 4 WAY VALVE PISTON ACTUATED GENERAL VALVE
71
12.0
Metacharacter
Example
What this expression means: Matches the end of a line Matches any component class name which ends with FILTER or string. Example matches using expression: INLINE BASKET FILTER INLINE FILTER
\A
Matches the beginning of a For the purposes of component class string (but not an internal mapping this is equivalent to ^ line). Matches the end of a string For the purposes of component class (but not an internal line). mapping this is equivalent to $ Matches every character What this expression means: except the ones inside Allows a component class to be selected brackets. based on a list of excluded characters.
\Z
[^...]
9.4
9.4.1
72
12.0
9.4.2
Matching
To match a group of characters, surround the characters with parenthesis. For example: (PINCH VALVE) Will find a match wherever PINCH VALVE appears in a Component Class, such as: PISTON ACTUATED PINCH VALVE PINCH VALVE To exactly match a literal in a regular expression ensure that the expression begins with the ^ character and ends with the $ character. For example: ^(PINCH VALVE)$ This will match PINCH VALVE but will not match PISTON ACTUATED PINCH VALVE.
9.4.3
Escape Sequence
An escape sequence is a way of using a metacharacter as part of the search criteria of a regular expression. This is done by placing the \ (backslash) character in front of the quantifier. For example the regular expression \* will find the * character in the component class name BAG*FILTER.
73
12.0
74
12.0