<!DOCTYPE html
  PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<!--
Copyright (c) 2006 UGS Corp.

All Rights Reserved.

This software and related documentation are proprietary to UGS Corp.
-->
<html>
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <title>Change Component Part References in an Assembly</title>
      <script language="javaScript">
        abridged="false";
        displayConditions=new Array();
      </script>
      <link type="text/css" href="../css/main_styles.css" rel="stylesheet">
   </head>
   <body class="bodydocs" onload="top.pageLoader()" bgcolor="#FFFFFF">
      <div class="title_topic2" id="xps10_pagetitle">Change Component Part References in an Assembly</div>
      <hr noshade="true">
      <p class="para_topic">UG_EDIT_PART_NAMES provides facilities to change component part references inside an assembly part. It does so without loading the part, which increases speed. It is also NX version-independent (from V10 and after). </p>
      <p class="para_topic">After renaming a component, you can change its referenced name. Also, after you move a component, you can change its previous directory reference to its new one. You can also change the character case used to reference components. This can be useful when moving parts from one operating system to another, such as UNIX to Windows which handles case comparisons differently.</p>
      <p class="para_topic">Frequently, sites will want to gather an assembly from a user's directory and move it to a pre-release or a release directory. Once you move the assembly, you may want to change the assemblies' structure so that retrieving it &quot;as-saved&quot; will find the parts in their new location. You could accomplish this with the REFILE_PART utility, but it would be slow because it would have to retrieve and refile every part in the assembly. UG_EDIT_PART_NAMES can accomplish this operation quickly. </p>
      <div class="title_division">Before You Begin</div>
      <p class="para_division">As with most powerful tools, it must be used with care. For example, if not careful, you could create a cyclic assembly structure or point two different sub-assemblies to the same component, when they previously referred to different components. For this reason, we strongly recommend THAT YOU MAKE COPIES OF YOUR PARTS BEFORE YOU EDIT THEM. Before you discard the original parts, test the changes you made by loading the assemblies in NX to make sure they retrieve as expected. </p>
      <div class="title_division">Deciding Where to Change a Reference</div>
      <p class="para_division">When deciding where to change a reference using this utility, you should understand the structure of an NX assembly. Even though higher level parents make references to children lower than their immediate children, the immediate parent of a component makes the definitive reference. When deciding where to change a reference, the general rule is: Change all parts that have a reference to the component being modified. This will mean that the next time you load the assembly into NX, it will not have to perform an update. However, for V12 and subsequent releases, you can simply rename the references from the immediate parents of the component. The update capabilty of Unigraphics NX will make all necessary modifications. </p>
      <div class="title_division">Use with UGPC</div>
      <p class="para_division">To determine what assembly structures you have in the parts you are changing, use UG_EDIT_PART_NAMES in conjunction with UGPC. To ensure that UGPC prints the directories &quot;as-saved&quot;, use the &quot;-a&quot; option. </p>
      <div class="title_division">Switches</div>
      <p class="para_division">To display help text for all options, enter:</p>
      <p class="para_division">UG_EDIT_PART_NAMES -help</p>
      <p class="para_division">The following table describes these options.</p>
      <table cellspacing="3" width="100%" align="center">
         <tr>
            <th bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_th">Switch</p>
            </th>
            <th bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_th">Description</p>
            </th>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">&lt;input part name&gt;</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Required argument</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-intro</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Describes this utility</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-examples</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Describes example calls</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-help</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Displays help information</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-list</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Outputs the references contained in the part that can be changed using this program</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-o &lt;output part name&gt;</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">If making edits to the input part, this argument is required. The output part can be the same as the input part. In this case, the part will be edited in place.</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-change_name &lt;current component part name&gt; &lt;new component part name&gt;</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Changes the name of a referenced component from the current name to the new name</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-change_dir &lt;current directory&gt; &lt;new directory&gt;</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Replaces all references to the current directory to the specified new directory. Useful when moving an assembly to a new location, such as a release directory</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-change_comp_dir &lt;current component part name&gt; &lt;new component directory&gt;</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Replaces the directory used by the current component part to the specified new directory</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-lower_name</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Forces all part names to lower case</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-upper_name</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Forces all part names to upper case</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-lower_dir</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Forces all directory names to lower case</p>
            </td>
         </tr>
         <tr>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">-remove_dirs</p>
            </td>
            <td bgcolor="#f4f4f4" colspan="1" rowspan="1" valign="top">
               <p class="para_td">Removes all directory information</p>
            </td>
         </tr>
      </table><br></body>
</html>