This task shows you how to create or modify setup data that is needed to use your migrated V4 models. | ||
Data that you migrate
from V4 into V5 will usually be stored in directories that are separate
from the directories in which V5 generated data is stored. Sample
directories are included with this application for storing migrated data.
The default location is: intel_a\startup\EquipmentandSystems\MigrationDirectory\XXX
where XXX is a discipline like Tubing or Piping.
You need to create the following setup data in the directory that you use to store your resources, and which is referenced in the project resource management file. If you continue to use the sample directories the changes should be made there, if you choose to create a new location, that is where the setup data should be added. In the instructions below it is assumed that you have created a new location. If you continue to use the sample directories then you should adjust the instructions accordingly. |
||
|
1. |
Discrete Values You will need a set of discrete value text files as a default set of possible values for piping attributes. You can copy these from the sample migrated piping discipline (\intel_a\startup\EquipmentAndSystems\MigrationDirectory\DiscreteValues) into your own \DiscreteValues directory. You can throw away what you do not want, and edit what you want so you are satisfied with your set of text files. Also, if you had user-defined attributes defined in your V4 Project Registration Model containing a discrete list of values, then you will need to create a discrete values text file in your \DiscreteValues directory containing the name of your mapped V5 attribute name and the values you want available in V5 for your user-defined attribute. |
2. |
Design Rules \intel_a\startup\EquipmentAndSystems\MigrationDirectory\PipingSystems\V5_Migrated_Tables contains a directory called DesignRules. Move this directory to your \Piping directory. Copy the design rules catalog from the sample piping discipline into your \Piping\DesignRules directory. Borrow additional design rule resources as desired from the sample piping disciplines, and rename and edit them as desired. When you are satisfied you have all of the design rule data you want, you are ready to edit the design rules catalog. Rename the design rules catalog you copied, as desired. Bring up the application again and edit your design rules catalog as needed. Change the links to reference your own text files. Take out previous entries ("Remove description") and add your own entries. Refer to the section Standards and Design Rules for more information. |
|
3. |
Standards Under your \Piping directory create a directory called Standards. Your migrated standard data in \intel_a\startup\EquipmentAndSystems\MigrationDirectory\PipingSystems\V5_Migrated_Tables is separated in different directories for each standard. Move these standard directories to your \Piping\Standards directory. Copy the piping standards catalog from the sample piping discipline into your \Piping\Standards directory. Borrow additional standard resources as desired from the sample piping disciplines, and rename and edit them as desired. When you are satisfied you have all of the standard data you want, you are ready to edit the standards catalog. Rename the standards catalog you copied, as desired. Bring up the application again and edit your standards catalog as needed. Take out previous entries ("Remove description") and add your own entries. Refer to Standards and Design Rules for more information. |
|
4. |
Specifications Under your \Piping directory create a directory called Specification. Your migrated spec data in \intel_a\startup\EquipmentAndSystems\MigrationDirectory\PipingSystems\V5_Migrated_Tables is separated in different directories for each specification. Move these specification directories to your \Piping\Specification directory. Copy the piping specification catalog from the sample piping discipline into your \Piping\Specification directory, or copy a sample empty specifications catalog from \intel_a\startup\EquipmentAndSystems\MigrationDirectory\PipingSystems\V5_Catalog. Or create a new material specifications catalog by following the instructions in Creating a Specifications Catalog. Borrow additional specification resources as desired from the sample piping disciplines, and rename and edit them as desired. When you are satisfied you have all of the specification data you want, you are ready to edit the specifications catalog. Rename the specifications catalog you copied, as desired. Bring up the application again and edit your specifications catalog as needed. Take out previous entries ("Remove description") and add your own entries. You will notice that the specifications catalog has two logical sections under each specification - you see a list of tables and then a list of parts. At this time, you are only editing the table entries. After you have built your parts catalog, you will come back to this specifications catalog and edit and add entries for your parts. Refer to Creating a Specifications Catalog for more information. |
|
5. |
Parts Catalog Under your \Piping directory create a directory structure called \PipingDesign\ComponentCatalogs\CatalogXXX, where XXX is your catalog number. See the sample migrated piping discipline for an example. In the \CatalogXXX directory you will place your migrated catalog parts and your parts catalog. You will probably not want to borrow and edit an existing piping parts catalog because of the number of part entries you would have to delete. You can copy the empty sample catalog in \intel_a\startup\EquipmentAndSystems\MigrationDirectory\PipingSystems\V5_Catalog, and rename it. Bring up the application and add all of your parts to it. Refer to Modifying a Catalog for more information. You can use the Create/Modify catalog button to add your parts to the catalog. |
|
6. |
PRM File Edit the project resource management (PRM) file because the final two steps need to reference your standard data. In \intel_a\startup\EquipmentAndSystems\ProjectData\Project.xml, you can define a new discipline in that PRM file, or copy it and rename it (e.g., ProjectABC.xml), and then edit the Migration section to reference your new discipline resources. Before bringing up the application during the next steps, you need to set the CATDisciplinePath variable. In Windows: set CATDisciplinePath=XXX\startup\EquipmentAndSystems\ProjectData In UNIX: export CATDisciplinePath=XXX\startup\EquipmentAndSystems\ProjectData Where XXX is your installation path. When you bring up the application and open a piping document, you must go to Tools + Project Management and choose your discipline to make it active. |
|
7. |
Specifications Catalog Now that you have built your parts catalog, you can edit the parts sections of your piping specifications catalog. You need to define part queries in your specifications catalog. To aid you in defining these queries, you will need to reference your V4 class catalog definitions. In V4, go to the PIPSETUP function and to the menu Catalog + Options, set your catalog number, then go to Catalog + Pipe Spc + Generate. Select All, and then Export. The file CLSEXxxx, where xxx is your catalog number, will be created in setup/PRO/catlg. You will need to reference this file as you define your class queries in your V5 specifications catalog. The first row of your CLSEXxxx file contains "/*". The fifth row contains "*/". Rows 2, 3, and 4 begin with PSPEC. You can consider row 4 as containing the column headings of attribute names. The rows that follow, starting with row 6, each contain a "part class query", with encoded values for certain attributes. An asterisk ("*") beside a value indicates that this is a value for a "generic attribute", whose encoded value will be used in the part number of a fully resolved piping part. You will see that the fourth part entry, row 9, has a pipe specification of CS150R, a pipe standard of ASTL, a part category of Valve, a part function of Gate Valve, a size range from .5 to .75, a (generic) material category of CS (carbon steel), a (generic) material code of A105, a rating1 of 800, a wall thickness1 of .0000, an end style1 of SW (socket weld), an end style2 of TH (threaded), and other (2/3/4) wall thickness values of .0000. See Creating a Specification Catalog to learn how to create an attribute filter file and use it to define all your part queries. CREATING A V5 ATTRIBUTE FILTER FILE You can edit the V4 CLSEXxxx file and turn it into a V5 attribute file by following these instructions:
|
|
8. |
Piping Lines After performing the task Exporting V4 Piping Lines, you will have an Import file that you can use in V5 to create your V4 piping lines in V5. Before performing the Import step of that task, you had to set up your piping discipline and PRM file. You will likely want to copy the V4 migrated piping lines and catalog from \intel_a\startup\EquipmentAndSystems\MigrationDirectory\Piping\SampleData\PipingLines to your own piping lines directory (\Piping\SampleData\PipingLines). This will be the piping lines catalog your PRM file should reference and which your Import Line IDs operation will update. |