Modifying the Object Naming Rules

atarget.gif (1372 bytes) This task shows you how to modify or define the object naming rules. See also Understanding Project Resource Management, and the resource entries for Unique reference file name options and Unique reference part number options. Also see Add Computed Attribute to Object Name if you want to add a computed attribute.
Examples from the Piping Design product are used in this task. The procedure is the same for all products that have this function - substitute the appropriate file or object when using another product.

Every object that you create (except a run), or part that you place, in your design document can be given a unique identifier. This identifier usually consists of a prefix that identifies the type of object or part it is, followed by a unique number. This enables users, for instance, to maintain a history of each part - when it was serviced, or repaired or replaced - and schedule servicing and replacement dates. When you create an object or place a part in your document the application will suggest a name for it - the default name. (In many cases you have the option of rejecting this name and entering a different name, or renaming it.) The default name is based on certain rules. A set of default rules is included with this application, but most users will want to modify these rules to suit their own requirements. You can modify or define the naming rules in the following way:

ascenari.gif (1364 bytes) 1. Open the Feature Dictionary Editor. From the main menu, click Start - Infrastructure - Feature Dictionary Editor.
2. Click the  Open User Dictionary  button .  The Open User Dictionary dialog box displays.

3. Navigate to the directory where your .CATfct files are stored. The default is .. intel_a\resources\graphic. The CATfct files contain a list of all the object classes. Select and open the file associated with the product you are working with, i.e. Piping or Tubing, etc. All the classes in the file are displayed in the Feature Dictionary.

4. Select a class in the specifications tree and click the Define ID Schema button . The Define ID Schema dialog box will display.

If the class does not have object naming rules defined then the Inherited From field will indicate the parent from which they are derived. If the class has rules defined then the same class name will display, as in the image above. If no rules exist for this class then they will be created when you take the following steps.

5. You have two options In the ID usage field, Instance and Reference, and you usually have to define naming rules for each object using both options. The naming rules you define under the Instance option are used by the application when you are placing a part in a document. 

The naming rules you define using the Reference option are used by the application when you build a component for placing in a catalog. Most users will define naming rules for an object using both options. Depending on your needs,  you can choose to simplify the procedure by defining rules for the parent function, which is Piping Part Function in the example above, and these rules will be inherited by all the objects under it. 

Select Yes or No for Sequence number. Yes or No cannot be selected if you have Reference as the ID usage. Minimum length refers to the number of digits in the numbering scheme. For instance, 3 means the number will show up as 001.

6. Click the Define/modify ID schema button . The Define/modify ID schema dialog box will display.

7. In this dialog box you can define what you want to appear in the name of an object, in this case the object being Piping Part Function. The dialog box has a window in the lower half which displays the current naming scheme. You can delete one or more of the fields using the Delete field/Delete all fields buttons

Click Add after entering or selecting a value in a field. You can choose to have more than one attribute value displayed in a name, for instance when you want to add a Separator at more than one place. Click Add after selecting each one. 

You can select the order in which the values will appear in a name by using the Up or Down arrows or the buttons in the Insert mode field.

If you want to use computed attributes in the object name then see Add Computed Attribute to Object Name.

8. Select one of the attributes from the drop down list in the Attribute name field . If you select Nominal size, for instance, the object name will display the nominal size of the object. These attributes are for the Piping Part class only - other classes will have different attributes displayed. You can display more than one attribute in the name.
9. Enter any value you want displayed in the Constant field. If you enter PP (for Piping Part), all piping part names will display this value. You can add a constant to a name anywhere you require it. For instance, you may begin a name with PP, and end it with WR for a project name.
10. The Program field is used to execute a program that will then add a value to the name. You can create your own programs, but some sample programs are provided with the application and are listed below. Enter a program name in this field if you want it to be executed. For instance, if you enter CATPspEncSchedule in the field, then the short value of  the Encoded Schedule attribute will be added to the name (the short value of Extra Strong is XS.). These programs are Standards-based and will execute based on the standard you have defined in your Options. The default standard is ASTL.

The following list shows the programs provided with the application as a sample, and the attributes they refer to:

  • CATPspEncRating - Encoded Rating
  • CATPspEncRating2 - Encoded Rating2
  • CATPspEncRating3 - Encoded Rating3
  • CATPspEncRating4 - Encoded Rating4
  • CATPspEncNominalSize - Encoded Nominal Size
  • CATPspEncNominalSize2 - Encoded Nominal Size2
  • CATPspEncNominalSize3 - Encoded Nominal Size3
  • CATPspEncNominalSize4 - Encoded Nominal Size4
  • CATPspEncSchedule - Encoded Schedule
  • CATPspEncMaterialCategory - Encoded MaterialCategory
  • CATPspEncMaterialCode - Encoded MaterialCode
  • CATPspEncKeyStationType - Encoded HangerKeyStationType
11. The Domain program field is used to execute a program that will add the name of the domain to which the object belongs. Domain in this case refers to an object to which the object to be named is connected. For instance, when naming a nozzle it is preferable to add the name of the equipment to which it is connected. The sample domain programs provided with the application are:

PspConnectedEquip - Provides the functionality explained above.

CATPspDeckName - Intended for use with the hanger types rack and cable penetration. When this is selected the deck to which the hanger belongs will be used as the domain for naming purposes. The value of the attribute "deck" will be used. If the attribute does not exist then an error will be generated.

CATPspZoneName - Intended for use with the hanger types rack and cable penetration. When this is selected the zone to which the hanger belongs will be used as the domain for naming purposes. The value of the attribute "zone" will be used. If the attribute does not exist then an error will be generated.

12. The Separator field is used to add separators, such as a hyphen or semi colon, after the domain field.
13. Use the buttons in the Insert mode field to organize the name. Append field to list will move a field to the end of the name. The other buttons are used when you are adding a field, to position it in the name.
  14.

FOR HVAC DUCTS

If you want to place 'heavy' HVAC ducts then you need to change the file that defines the object naming rules. (You do not need to make any change if you are placing 'light' parts.) If you are placing heavy parts then navigate to the directory ...intel_a\startup\EquipmentAndSystems\HVAC\DataDictionary. The default files are named sch-CATHvaHVACXXXXDuct1.xml where XXXX represents a shape like FlatOval. Rename this file so that the application does not recognize it - you can add a SAVE at the end, for instance. You need to use the corresponding file that has the _HV at the end of the file name. This file is in the same directory, and normally directly beneath the file for light parts. To use this file simply remove the _HV. As an example:

  • Rename sch-CATHvaHVACXXXXDuct1.xml to sch-CATHvaHVACFlatOvalDuct1_SAVE.xml
  • Remove the _HV from the file sch-CATHvaHVACFlatOvalDuct1_HV.xml

aendtask.gif (1477 bytes)