Teamcenter_NX-CAM Integration ( PDFDrive )
Teamcenter_NX-CAM Integration ( PDFDrive )
Teamcenter/NX-CAM
Integration
Configuration Manual
OVERVIEW:
This document is divided into three major sections: Section 1 contains detailed information on how to
configure both Teamcenter and NX CAM to work in a mixed-managed mode, while Section 2 explains
how to install and configure IS&V, and Section 3 covers how to create custom IS&V Setup Parts in
Teamcenter.
The current Teamcenter/NX CAM configuration at XYZ is what is referred to as a mixed-managed mode.
In this mode, the CAM data (MENCMachining objects), the part files (Items), CAM template parts, ISV
simulation models, ISV setup files and posted output files are managed by Teamcenter, while the tooling
libraries and post processors reside on the operating system.
NOTE: Tooling libraries can only be managed in Teamcenter via the MRL (Manufacturing Resource
Library) module.
2
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
INTRODUCTION:
SPECIAL NOTE: The OOTB installation of Teamcenter does include CAM templates, but these happen to
be from NX2. As such, these template parts must be updated to the current version of NX being used by
the customer, which is done by running the tcin_cam_template_setup.bat script.
Although this document refers to NX7.5, these installation steps are valid for any version of NX from 7.5
onward.
3
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
A. SETTING UP ENVIRONMENTAL VARIABLES ON THE TEAMCENTER SERVER
Before running the script for importing the NX CAM templates, you must verify/set the following
environment variables on the TC (Teamcenter) server - the TC server must be able to resolve these
paths:
FMS_HOME
UGII_BASE_DIR
UGII_ROOT_DIR
UGII_TMP_DIR
i. Make sure that UGII_BASE_DIR resolves to the correct path of the current NX installation
(e.g., C:\Program Files\Siemens\NX75).
ii. Make sure that UGII_ROOT_DIR resolves to the correct path of the current NX installation
(e.g., C:\Program Files\Siemens\NX75\UGII\ ).
iii. As UGII_TMP_DIR is not a standard NX variable, you will have to create this folder
somewhere that the TC server can resolve to (i.e., reach or see) and then set this variable on the
server.
NOTE:
If the path name of the UGII_BASE_DIR contains a space, you will need to convert it to 8.3 format.
(This has been fixed in NX8 - reference PR6474808).
You can get the 8.3 format in a Command Prompt by cd'ing to the directory above the folder that has the
space and entering: dir/x
So if the path is U:\CAM apps\UGS\NX 7.5\UGII change the directory to U:\CAM apps\UGS
and then in the Command Prompt type: dir/x and it will return with: NX7~1.5
This is the syntax you will need to use when defining the UGII_BASE_DIR and UGII_ROOT_DIR
variables. This needs to be done for each folder that has a space in the path name for each of these
variables.
4
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
B. IMPORTING CURRENT NX CAM TEMPLATES INTO TEAMCENTER
File: tcin_cam_template_setup.bat
Location: <NX Installation folder>\UGII\templates\sample
The latest version of the NX CAM template files need to be imported into Teamcenter. This is done
using the tcin_cam_template_setup.bat utility.
Please note that this utility must be run on the Teamcenter server.
This script imports the CAM templates found in the following directories into the Teamcenter database:
UGII_BASE_DIR\MACH\resource\template_part\english\
UGII_BASE_DIR\MACH\resource\template_part\metric\
The item ID of an imported template consists of the name of the template suffixed with _inch_NX? or
_metric_NX?, where ? is the release version of the NX installation. For example, the NX7.5 metric
template MillTurn_Express.prt receives the item ID of MillTurn_Express_metric_NX75 when
you import it into Teamcenter.
Teamcenter imports the templates into a folder called NX? CAMSetup Templates, where ?
indicates the NX release. For example, NX 7.5 templates would be organized under a folder called NX75
CAM Setup Templates:
5
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
B. IMPORTING CURRENT NX CAM TEMPLATES INTO TEAMCENTER
Launch Teamcenter and select Edit Options Search TC_Allow_Longer_ID_Name and set
this to true:
6
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
B. IMPORTING CURRENT NX CAM TEMPLATES INTO TEAMCENTER
Once you have set the necessary variables and created a folder for UGII_TMP_DIR, run the script from a
Teamcenter command prompt using the following parameters:
The script first creates cloning log files in the UGII_TMP_DIR. It then executes the clone log files and
imports the CAM template parts into Teamcenter. As the script is running, you will see messages
echoed back, such as:
ug_clone Starting
If the clone import is successful, you will see a new folder in Teamcenter containing all of the current
CAM templates:
7
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
B. IMPORTING CURRENT NX CAM TEMPLATES INTO TEAMCENTER
SPECIAL NOTES:
If you do not have TC_Allow_Longer_ID_Name set to true, so that the datasets can have longer
names, you will get an error message similar to this:
Additionally, if you have naming rules in Teamcenter that block the CAM template naming convention,
you may receive the following error on the first template part being imported:
ERROR <920007> - Teamcenter Error: Invalid Tag NULLTAG <in isValid <2>> - the requested object does not exist
While performing import.
This error occurred while operating on the part <current part name>
You should check the state of the output part for problems before trying this operation again.
e.g.
8
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
C. EDIT THE ugii_env_ug.dat FILE
File: ugii_env_ug.dat
Location: <NX Installation folder>\UGII
UGII_CAM_CONFIG=${UGII_CAM_CONFIG_DIR}cam_general.dat
or
UGII_CAM_CONFIG=${UGII_CAM_CONFIG_DIR}cam_part_planner_library.dat
This NX environmental variable determines which mode NX will use when running under Teamcenter.
For a mixed-managed mode, change this line to read:
UGII_CAM_CONFIG=${UGII_CAM_CONFIG_DIR}cam_part_planner_library_mixed.dat
9
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
D. COPY THE nxdm_ugs_manufacturing_templates.pax FILE
File: nxdm_ugs_manufacturing_templates.pax
Location: <NX Installation folder>\UGII\templates
This file controls the dialog options that the user sees when creating a new MENCMachining object:
NOTE:
If you do not want to use (or see) the default NX "Manufacturing" tab when creating a new CAM setup,
rename the original file by changing its extension to something like:
nxdm_ugs_manufacturing_templates_mixed.pax_ORIG
10
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
E. EDIT THE nxdm_ugs_manufacturing_templates_mixed.pax FILE
cam_part_planner_library.dat to cam_part_planner_library_mixed.dat
This edit should result in two lines being changed (original lines are highlighted in green, and the
resulting changes are highlighted in yellow):
ORIGINAL TEXT:
<PaletteEntry id="d1">
<References/>
<Presentation name="General Setup" description="NX CAM General Setup">
<PreviewImage type="UGPart" location="${UGII_CAM_TEMPLATE_PART_ENGLISH_DIR}mill_planar_assy.jpg"/>
</Presentation>
<ObjectData class="CamTemplate">
<Filename>@DB/mill_planar_assy_inch/A</Filename>
<Configuration>${UGII_CAM_CONFIG_DIR}cam_part_planner_library.dat</Configuration>
<LibraryClassPath>SETUP_TEMPLATE;GENERAL</LibraryClassPath>
<Units>English</Units>
<UsesMasterModel>Yes</UsesMasterModel>
<ItemType>MENCMachining</ItemType>
<RelationType>master</RelationType>
</ObjectData>
</PaletteEntry>
<PaletteEntry id="d2">
<References/>
<Presentation name="General Setup" description="NX CAM General Setup">
<PreviewImage type="UGPart" location="${UGII_CAM_TEMPLATE_PART_METRIC_DIR}mill_planar_assy.jpg"/>
</Presentation>
<ObjectData class="CamTemplate">
<Filename>@DB/mill_planar_assy_metric/A</Filename>
<Configuration>${UGII_CAM_CONFIG_DIR}cam_part_planner_library.dat</Configuration>
<LibraryClassPath>SETUP_TEMPLATE;GENERAL</LibraryClassPath>
<Units>Metric</Units>
<UsesMasterModel>Yes</UsesMasterModel>
<ItemType>MENCMachining</ItemType>
<RelationType>master</RelationType>
</ObjectData>
</PaletteEntry>
CHANGED TEXT:
<PaletteEntry id="d1">
<References/>
<Presentation name="General Setup" description="NX CAM General Setup">
<PreviewImage type="UGPart" location="${UGII_CAM_TEMPLATE_PART_ENGLISH_DIR}mill_planar_assy.jpg"/>
</Presentation>
<ObjectData class="CamTemplate">
<Filename>@DB/mill_planar_assy_inch/A</Filename>
<Configuration>${UGII_CAM_CONFIG_DIR}cam_part_planner_library_mixed.dat</Configuration>
<LibraryClassPath>SETUP_TEMPLATE;GENERAL</LibraryClassPath>
<Units>English</Units>
<UsesMasterModel>Yes</UsesMasterModel>
<ItemType>MENCMachining</ItemType>
<RelationType>master</RelationType>
</ObjectData>
</PaletteEntry>
11
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
E. EDIT THE nxdm_ugs_manufacturing_templates_mixed.pax FILE
<PaletteEntry id="d2">
<References/>
<Presentation name="General Setup" description="NX CAM General Setup">
<PreviewImage type="UGPart" location="${UGII_CAM_TEMPLATE_PART_METRIC_DIR}mill_planar_assy.jpg"/>
</Presentation>
<ObjectData class="CamTemplate">
<Filename>@DB/mill_planar_assy_metric/A</Filename>
<Configuration>${UGII_CAM_CONFIG_DIR}cam_part_planner_library_mixed.dat</Configuration>
<LibraryClassPath>SETUP_TEMPLATE;GENERAL</LibraryClassPath>
<Units>Metric</Units>
<UsesMasterModel>Yes</UsesMasterModel>
<ItemType>MENCMachining</ItemType>
<RelationType>master</RelationType>
</ObjectData>
</PaletteEntry>
Next, you must change the default template parts being referenced by these two entries to point to the
newly imported NX 7.5 versions. To do this, change the template reference in palette d1 from:
mill_planar_assy_inch to mill_planar_assy_inch_NX75
mill_planar_assy_metric to mill_planar_assy_metric_NX75
Once again, the lines to be changed are highlighted in green, and the changed lines are highlighted in
yellow:
ORIGINAL TEXT:
<PaletteEntry id="d1">
<References/>
<Presentation name="General Setup" description="NX CAM General Setup">
<PreviewImage type="UGPart" location="${UGII_CAM_TEMPLATE_PART_ENGLISH_DIR}mill_planar_assy.jpg"/>
</Presentation>
<ObjectData class="CamTemplate">
<Filename>@DB/mill_planar_assy_inch/A</Filename>
<Configuration>${UGII_CAM_CONFIG_DIR}cam_part_planner_library_mixed.dat</Configuration>
<LibraryClassPath>SETUP_TEMPLATE;GENERAL</LibraryClassPath>
<Units>English</Units>
<UsesMasterModel>Yes</UsesMasterModel>
<ItemType>MENCMachining</ItemType>
<RelationType>master</RelationType>
</ObjectData>
</PaletteEntry>
<PaletteEntry id="d2">
<References/>
<Presentation name="General Setup" description="NX CAM General Setup">
<PreviewImage type="UGPart" location="${UGII_CAM_TEMPLATE_PART_METRIC_DIR}mill_planar_assy.jpg"/>
</Presentation>
<ObjectData class="CamTemplate">
<Filename>@DB/mill_planar_assy_metric/A</Filename>
<Configuration>${UGII_CAM_CONFIG_DIR}cam_part_planner_library_mixed.dat</Configuration>
<LibraryClassPath>SETUP_TEMPLATE;GENERAL</LibraryClassPath>
<Units>Metric</Units>
<UsesMasterModel>Yes</UsesMasterModel>
<ItemType>MENCMachining</ItemType>
<RelationType>master</RelationType>
</ObjectData>
</PaletteEntry>
12
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
E. EDIT THE nxdm_ugs_manufacturing_templates_mixed.pax FILE
CHANGED TEXT:
<PaletteEntry id="d1">
<References/>
<Presentation name="General Setup" description="NX CAM General Setup">
<PreviewImage type="UGPart" location="${UGII_CAM_TEMPLATE_PART_ENGLISH_DIR}mill_planar_assy.jpg"/>
</Presentation>
<ObjectData class="CamTemplate">
<Filename>@DB/mill_planar_assy_inch_NX75/A</Filename>
<Configuration>${UGII_CAM_CONFIG_DIR}cam_part_planner_library_mixed.dat</Configuration>
<LibraryClassPath>SETUP_TEMPLATE;GENERAL</LibraryClassPath>
<Units>English</Units>
<UsesMasterModel>Yes</UsesMasterModel>
<ItemType>MENCMachining</ItemType>
<RelationType>master</RelationType>
</ObjectData>
</PaletteEntry>
<PaletteEntry id="d2">
<References/>
<Presentation name="General Setup" description="NX CAM General Setup">
<PreviewImage type="UGPart" location="${UGII_CAM_TEMPLATE_PART_METRIC_DIR}mill_planar_assy.jpg"/>
</Presentation>
<ObjectData class="CamTemplate">
<Filename>@DB/mill_planar_assy_metric_NX75/A</Filename>
<Configuration>${UGII_CAM_CONFIG_DIR}cam_part_planner_library_mixed.dat</Configuration>
<LibraryClassPath>SETUP_TEMPLATE;GENERAL</LibraryClassPath>
<Units>Metric</Units>
<UsesMasterModel>Yes</UsesMasterModel>
<ItemType>MENCMachining</ItemType>
<RelationType>master</RelationType>
</ObjectData>
</PaletteEntry>
13
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
E. EDIT THE nxdm_ugs_manufacturing_templates_mixed.pax FILE
ADDITIONAL NOTES:
There are a number of options presented by this pax file that are probably not used by XYZ, and can be
deleted from this file.
These are all of the palette entries starting from <PaletteEntry id="d3"> through to
<PaletteEntry id="d12">.
I have included a sample pax file with this document called nxdm_ugs_manufacturing_templates_
mixed_XYZ.pax where I have removed these extraneous entries, as well as customized the name of the
manufacturing tab so that the resulting dialog looks like this:
14
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
E. EDIT THE nxdm_ugs_manufacturing_templates_mixed.pax FILE
ADDITIONAL NOTES:
To use my customized pax file, simply copy it to the <NX Installation folder>\UGII\templates folder.
In this case I changed the original entry for FileNewTab= from "Manufacturing" to "XYZ (Mixed)
CAM" - this is what created the new tab option.
Additionally, lines 10 and 27 were changed from the default value of:
<Presentation name="General Setup" description="NX CAM General Setup">
to
<Presentation name="XYZ General Setup" description="XYZ Mixed-Mode
Manufacturing Setup">
This controls the name of the setup file as well as its description.
15
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
F. COPY THE cam_part_planner_library.dat FILE
File: cam_part_planner_library.dat
Location: <NX Installation folder>\MACH\resource\configuration
This file determines which external CAM templates will be available to the user (after creating a new
CAM setup) as well as controlling the different CAM-specific files that are used by NX.
16
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
G. EDIT THE cam_part_planner_library_mixed.dat FILE
TEMPLATE_OPERATION,${UGII_CAM_TEMPLATE_SET_DIR}cam_teamcenter_general.opt
to
TEMPLATE_OPERATION,${UGII_CAM_TEMPLATE_SET_DIR}cam_teamcenter_general_mixed.opt
Change this line from (please note that this is one single line):
LIBRARY_TOOL,${UGII_CAM_LIBRARY_TOOL_INCLASS_DIR}dbc_inclass_tlas.def,${UGII_
CAM_LIBRARY_TOOL_INCLASS_DIR}dbc_inclass_tlas.tcl
to
LIBRARY_TOOL,${UGII_CAM_LIBRARY_TOOL_ASCII_DIR}dbc_tool_ascii.def,${UGII_CAM_
LIBRARY_TOOL_ASCII_DIR}dbc_tool_ascii.tcl
NOTE: The original entry for the LIBRARY_TOOL definition references the "old" Genius tooling library,
and if not changed as shown above, will cause errors whenever the user tries to create or get a tool from
the library. The change I have you make causes NX to use the standard, OS-based tooling library.
17
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
H. COPY THE cam_teamcenter_general.opt FILE
File: cam_teamcenter_general.opt
Location: <NX Installation folder>\MACH\resource\template_set
This file determines what internal CAM templates will be listed/available whenever a user creates a new
operation:
This file is referenced by the changes we made to the cam_part_planner_library_mixed.dat file in part G.
18
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
I. EDIT THE cam_teamcenter_general_mixed.opt FILE
Edit this new file (i.e., cam_teamcenter_general_mixed.opt) - its OOTB contents should look
something like this:
@DB/mill_planar_inch/A
@DB/mill_contour_inch/A
@DB/drill_inch/A
@DB/turning_inch/A
@DB/solid_tool_inch/A
@DB/machining_knowledge_inch/A
@DB/mill_planar_metric/A
@DB/mill_contour_metric/A
@DB/drill_metric/A
@DB/turning_metric/A
@DB/solid_tool_metric/A
@DB/machining_knowledge_metric/A
This file is referencing the "old" templates that were originally installed in Teamcenter.
You will now have to change these to reflect the names of the newly imported CAM templates (you will
also see that this file references fewer templates than those installed). Shown here are all the necessary
entries for the new NX7.5 CAM templates:
@DB/mill_planar_inch_NX75/A
@DB/mill_contour_inch_NX75/A
@DB/mill_multi-axis_inch_NX75/A
@DB/mill_multi_blade_inch_NX75/A
@DB/drill_inch_NX75/A
@DB/hole_making_inch_NX75/A
@DB/turning_inch_NX75/A
@DB/wire_edm_inch_NX75/A
@DB/probing_inch_NX75/A
@DB/solid_tool_inch_NX75/A
@DB/machining_knowledge_inch_NX75/A
##
@DB/mill_planar_metric_NX75/A
@DB/mill_contour_metric_NX75/A
@DB/mill_multi-axis_metric_NX75/A
@DB/mill_multi_blade_metric_NX75/A
@DB/drill_metric_NX75/A
@DB/hole_making_metric_NX75/A
@DB/turning_metric_NX75/A
@DB/wire_edm_metric_NX75/A
@DB/probing_metric_NX75/A
@DB/solid_tool_metric_NX75/A
@DB/machining_knowledge_metric_NX75/A
19
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
I. EDIT THE cam_teamcenter_general_mixed.opt FILE
You can choose to simply copy the sample cam_teamcenter_general_mixed.opt file that I
included with this document to the <NX Installation folder>\MACH\resource\template_set
folder, and then remove any extraneous entries from it.
Additionally, you will have to add any custom templates that you may have created to this file (check the
NX75 CAM Setup Templates folder in Teamcenter for the exact names of these templates).
20
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
J. REGISTERING THE NEW CAM TEMPLATES IN TEAMCENTER
Object: UGCAMTemplateData
Location: CAM Setup Templates folder inside of Teamcenter
References: template_part_planner.dat
This file determines which CAM templates are available when a user starts manufacturing directly from
an open part file.
Note:
The files we have configured so far control what happens when a user creates a manufacturing setup
using File New.
Our next step is to configure NX so that the new CAM templates are available when a user starts
manufacturing directly from an open part file - this is called registering the templates.
21
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
J. REGISTERING THE NEW CAM TEMPLATES IN TEAMCENTER
The CAM template files displayed by the Library Class Selection dialog are controlled by
UGCAMTemplateData, which is a Teamcenter object. This object can be found in Teamcenter in a
folder called CAM Setup Templates. In turn, UGCAMTemplateData references a text file called
template_part_planner.dat:
To edit this file, double-click on the UGCAMTemplateData object - this will automatically edit the
referenced template_part_planner.dat file using Notepad:
22
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
J. REGISTERING THE NEW CAM TEMPLATES IN TEAMCENTER
Each row of data consists of seven fields, separated by a vertical bar or pipe symbol (e.g., | ). The syntax
of each field is as follows:
LIBREF: 2nd field - three digit integer with leading zeros - must be a unique value for each
row of data, typically incremented by one for each consecutive row.
TMPL_CLASS: 3rd field - this is the template class, which is a four digit integer, with leading zeros,
that tells the system which library class a template part belongs to (and hence, will
be displayed under). The OOTB numeric class assignments are as follows:
SETUP_TEMP: 4th field - this is name of the CAM template that is initialized when this particular
setup is selected.
TYPE_TEMP: 5th field - a list of additional template names, delimited by spaces, that will be
available to the user during the CAM session.
23
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
J. REGISTERING THE NEW CAM TEMPLATES IN TEAMCENTER
ATT2: 7th field - unit descriptor for this setup - set to either "Inch" or "Metric"
24
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
J. REGISTERING THE NEW CAM TEMPLATES IN TEAMCENTER
Where:
25
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
J. REGISTERING THE NEW CAM TEMPLATES IN TEAMCENTER
Here is a visual reference of the library classes that the 4-digit template-class integer is associated with:
0100 to 0199
0200 to 0299
0201
0202
0203
0300 to 0399
0301
0302
0400 to 0499
0500 to 0599
0600 to 0699
0601
0602
0800 to 0899
0900 to 0999
1000 to 1099
1100 to 1199
1200 to 1299
26
SECTION 1: HOW TO SETUP FOR MIXED-MANAGED MODE
J. REGISTERING THE NEW CAM TEMPLATES IN TEAMCENTER
27