Lifecycle - Visualization - Integration
Lifecycle - Visualization - Integration
Lifecycle
Visualization
Integration
PLM00131 - 13.0
Contents
Getting started
Integration overview ─────────────────────────────────── 1-1
Before you begin ────────────────────────────────────── 1-1
Lifecycle Visualization viewers ───────────────────────────── 1-2
Basic concepts ─────────────────────────────────────── 1-9
Basic tasks ────────────────────────────────────────── 1-9
The Lifecycle Visualization integration with Teamcenter enables you to work with managed visualization
data in the external stand-alone application viewer or in the Lifecycle Viewer perspective in the rich
client. The stand-alone application viewer is a separate application from Teamcenter. It expands upon
Teamcenter's embedded visualization components with support for optional software modules such as
Concept Showroom, Visualization Illustration, and Variation Analysis. The Lifecycle Viewer is an
embedded visualization application within the rich client. It provides nearly all of the visualization tools
offered by the stand-alone viewer, many of which are not available for Teamcenter applications such as
My Teamcenter or Structure Manager.
This guide provides information on configuring and using the Lifecycle Visualization integration with
Teamcenter. More information on using the visualization products is located in the Visualizing Products
section of the Teamcenter help.
Enable the Lifecycle The Lifecycle Visualization integration with Teamcenter is part of the standard
Visualization Teamcenter deployment architecture. Teamcenter is installed using
integration Teamcenter Environment Manager (TEM) .
Configure the Teamcenter is installed and initially configured using Teamcenter Environment
Lifecycle Manager (TEM). After Teamcenter is installed, a number of configuration
Visualization options exist that you can use to customize the Lifecycle Visualization
integration integration.
Start the Lifecycle If you are using the rich client, you can send visualization data into the stand-
Visualization alone application viewer or the Lifecycle Viewer.
integration
• To send visualization data to the stand-alone application viewer, select the
item revision, and click Start/Open in Lifecycle Visualization on the
toolbar.
Stand-alone viewer
The stand-alone viewer, which runs outside of Teamcenter and is a separate installation, expands upon
Teamcenter's embedded visualization components with support for optional software modules such as
Concept, Visualization Illustration, Quality Producer, and Variation Analysis. Stand-alone Lifecycle
Visualization is integrated with Teamcenter, so you can send data from Teamcenter applications into the
stand-alone viewer, perform analysis, and then save your work back to the database.
• Base
The Base product configuration enables you to view and mark up 2D images and perform basic 3D
analysis operations such as measurements and cross sections.
• Standard
The Standard product configuration provides many additional features, such as advanced navigation
capabilities, markup tools, and support for precise 3D measurements.
• Professional
The Professional product configuration adds analysis functionality such as 3D comparisons, as well as
the ability to manipulate and transform 3D models, create outline captures, and play motion files that
illustrate assembly sequences. You can optionally use add-on modules such as Animation, Concept,
and Visualization Illustration.
• Mockup
The Mockup product configuration provides all of the functionality from the other product
configurations and also includes advanced features such as 3D clearance analysis, geometry
simplification, part groups, 3D filters, and movie captures. You can optionally use all of the available
add-on modules, including Quality Producer, Variation Analysis, Jack, and Path Planning.
Lifecycle Viewer
The Lifecycle Viewer is a full-fledged visualization client within Teamcenter. It provides nearly all of the
visualization tools offered by the stand-alone viewer, many of which are not available in the embedded
viewers within Teamcenter applications such as My Teamcenter.
The Lifecycle Viewer is available in the same product configurations as the stand-alone viewer, Base,
Standard, Professional, and Mockup. Features available vary depending upon the licensing level. The
Base configuration is automatically installed with the rich client.
• Work within a comprehensive user interface that provides access to many of the options previously
available only with the stand-alone products, including menus and views (the equivalent of Project
Workspace windows such as the Assembly).
• Author visualization data such as motion files, swept volumes, and .vfz collaboration files.
The Viewer view in My Teamcenter displays content dependent on the type of object selected in the
current component view or in the Details view. Support for visualization data includes:
• If an item or item revision is selected, the viewer displays the associated image, printed circuit board,
schematic, or JT data.
• If an image, ECAD PCB, ECAD Schematic, or JT dataset is selected, the viewer displays the image,
printed circuit board, schematic, or model.
• View and markup of parts, printed circuit boards, schematics, drawings and images, without having to
launch the stand-alone viewer or the Lifecycle Viewer.
• 2D Markup
Create 2D markups.
• 2D Multipage
Navigate among pages in multiple-page 2D images or documents.
• 2D Viewing
Pan, zoom, rotate, and flip 2D images.
• 3D Markup
Create 3D markups.
• 3D Measurement
Perform 3D measurements.
• 3D Navigation
Pan, rotate, and zoom 3D models.
• 3D PMI
View and manipulate PMI in your model.
• 3D Section
Create 3D cross sections.
• 3D Selection
Select parts and pick part features.
• 3D Standard Views
Examine your model from preset viewing angles.
• ECAD Base
Manipulate the view of ECAD document layers, control layer color and visibility, search, and create
reports.
• ECAD Markup
Create ECAD markups.
• ECAD Multipage
Navigate among pages in multiple-page schematic documents.
• ECAD Viewing
Pan, zoom, rotate, and flip image.
• Print
Print documents.
The viewer embedded in Structure Manager is available within the Viewer tab of the data pane. The
viewer allows you to view JT files attached to assemblies and components in the structure tree when
you are viewing and editing a product structure.
• 3D Alignment
Align parts with other parts in the viewing window.
• 3D Appearance
Change the appearance of 3D models.
• 3D Clearance
Check the clearance of parts in 3D models.
• 3D Comparison
Compare the geometry of two sets of parts.
• 3D Coordinate System
Create and align parts to local coordinate systems.
• 3D GDT Markup
Create 3D GD&T markups.
• 3D Manipulators
Transform 3D models.
• 3D Markup
Create 3D markups.
• 3D Measurement
Perform 3D measurements.
• 3D Movie Capture
• 3D Navigation
Pan, rotate, and zoom 3D models.
• 3D PMI
View and manipulate PMI in your model.
• 3D Section
Create 3D cross sections.
• 3D Selection
Select parts and pick part features.
• 3D Standard Views
Examine your model from preset viewing angles.
• 3D Thrustline Editor
Create and manipulate thrustlines.
• 3D Visibility
Hide obscuring parts and clip areas of your model.
The viewer embedded in Multi-Structure Manager is available within the Object View tab of the data
panel. The viewer allows you to view associated 2D images and 3D models when you are viewing and
editing a product or process structure.
• 2D Markup
Create 2D markups.
• 2D Multipage
Navigate among pages in multiple-page 2D images or documents.
• 2D Viewing
Pan, zoom, rotate, and flip 2D images.
• 3D Markup
Create 3D markups.
• 3D Measurement
Perform 3D measurements.
• 3D Navigation
Pan, rotate, and zoom 3D models.
• 3D PMI
View and manipulate PMI in your model.
• 3D Section
Create 3D cross sections.
• 3D Selection
Select parts and pick part features.
• 3D Standard Views
Examine your model from preset viewing angles.
The viewer embedded in Manufacturing Process Planner is available within the Object View tab of the
data panel. The viewer allows you to view associated 2D images and 3D models when you are viewing
and editing a process structure.
• 2D Markup
Create 2D markups.
• 2D Multipage
• 2D Viewing
Pan, zoom, rotate, and flip 2D images.
• 3D Markup
Create 3D markups.
• 3D Measurement
Perform 3D measurements.
• 3D Navigation
Pan, rotate, and zoom 3D models.
• 3D PMI
View and manipulate PMI in your model.
• 3D Section
Create 3D cross sections.
• 3D Selection
Select parts and pick part features.
• 3D Standard Views
Examine your model from preset viewing angles.
JT Preview view
The JT Preview view enables you to examine .jt parts associated with items, item revisions, and
datasets. When you select a compatible object, the .jt part is displayed in the view.
• 3D Navigation
Pan, rotate, and zoom 3D models.
The Image Preview view enables you to examine 2D raster images associated with items, item
revisions, and datasets. When you select a compatible object, the image is displayed in the view.
• None
Basic concepts
Primary and secondary visualization documents
Visualization files in Teamcenter are always either primary or secondary documents. You can open
primary documents independently from other documents, while secondary documents are dependent
upon primary documents. For example, a JT file is a primary document, which you can view on its own
without any other file having to be open; a markup layer (VPL file), in contrast, cannot be viewed on its
own, and must be opened in the context of a primary document, such as a JT file.
Product structure from Teamcenter can be either static or configured, depending upon how you save
and then subsequently re-open the session. When you initially send product structure into the Lifecycle
Viewer or the stand-alone application viewer, the structure matches the currently active configuration
settings from Teamcenter applications such as Structure Manager (revision rules, effectivity, variant
rules, active assembly arrangements, and other settings).
Session files save the state of the viewer so you can resume your work later. Saving your work as a
session file enables you to preserve viewer elements such as open files, snapshots, part visibility, and
part transformations.
Note:
By default, in a four-tier environment, when you launch stand-alone Lifecycle Visualization from
the Teamcenter rich client, the viewer and the rich client share the same tcserver session. When
you perform stand-alone viewer operations, such as saving a session file, the rich client may
appear to lock up until the viewer operation is finished. If this is a problem, you can configure
Teamcenter to create a separate tcsever session for the stand-alone viewer.
Basic tasks
An understanding of how to complete the following tasks is helpful when first beginning to use the
Lifecycle Visualization integration with Teamcenter:
• Turn on the UI options in the rich client to send visualization data to the stand-alone application
viewer.
• Use the Teamcenter Integration Preferences to specify the default behavior of visualization datasets
in Lifecycle Visualization.
• Open visualization files from Teamcenter in the stand-alone application viewer or the Lifecycle
Viewer.
• Insert or merge visualization files with an active session in the stand-alone application viewer or the
Lifecycle Viewer.
Lifecycle Visualization viewers from releases earlier than version 8 are not supported by and cannot
communicate with Teamcenter 8 or later servers. However, the version 8 or later stand-alone viewers
can communicate with DIS-enabled servers from previous Teamcenter releases.
The Teamcenter client communication system (TCCS) manages communication and file transfers
between Teamcenter clients and servers. TCCS contains the Teamcenter Server Proxy (TSP) application
which manages HTTP/S communication with a Teamcenter server and provides support for forward
proxy, reverse proxy, and Kerberos authentication. TCCS also contains the FMS client cache (FCC), which
uploads files from your workstation to a Teamcenter volume and also downloads requested files from
the volume to your workstation. The Teamcenter lifecycle visualization integration with Teamcenter
requires an FCC to transfer volume data between Teamcenter and the viewer.
TCCS is normally installed with the Teamcenter rich client. If the Teamcenter rich client is installed on
your machine, most likely no additional installation steps are necessary.
Note:
An FCC is required for Teamcenter 8 onwards. Although an FCC is not required for Teamcenter
2007, it is recommended.
For information on installing TCCS with the Teamcenter rich client, refer to Windows Clients Installation
or Linux Clients Installation within the Teamcenter documentation.
If you do not have the Teamcenter rich client installed, but you need to transfer volume data between
Teamcenter and the viewer, you can you can download the TCCS installer from the Siemens Support
Center site http://www.support.siemens.com. For more information, see the Lifecycle Visualization
Installation guide.
A configuration file is required on UNIX platforms to enable interoperation between the Teamcenter rich
client, Lifecycle Visualization, and other Siemens Digital Industries Software products. During
installation, the installed_programs.dat file is created (or updated) in the /ugs directory. The file lists
installed external applications that interoperate with the Teamcenter rich client.
"<application_name>"="<path/executable>"
"<application_name>"="<path/executable>"
There should be an entry for each instance of Mockup and Professional installed. (Standard and Base do
not support interoperation.) The following is a example of the file:
Note:
• You must be logged in as root during installation to create the /ugs directory. If you already have
a /ugs directory, you do not need to be root to create or update the installed_programs.dat file.
• By default, Teamcenter looks for the installed_programs.dat file in /ugs directory, but you can
set an UGII_INTEROP_PROGRAMS environment variable to use a different file.
• Teamcenter uses the last entry in the installed_programs.dat file with “Vis” in the name. If you
have multiple versions of Teamcenter Visualization installed, make sure the one you want to
use is the last entry in the file.
The Teamcenter rich client and the Lifecycle Visualization embedded viewer must share the same major
and minor release. For minor releases and patches, the viewer must be the same version as the rich
client, or newer.
When using a version of the viewer that is newer than your rich client, new viewer features may not be
available if they require rich client or server support. In addition, if a newer version of the viewer is
installed, you must copy the SingleEmbeddedViewer.jar file from the <viewer_install_location>
\Program folder to the <rac_install_location>\rac\plugins folder, overwriting the older version of the file.
If you plan to view data from multiple Teamcenter servers such as Teamcenter, Teamcenter engineering
process management, and Teamcenter Enterprise, the various databases may not be coordinated with
the viewer. You can only connect to one server at a time with only one FMS.
You must install either the rich clients for these servers or the FCC. Contact your Teamcenter
administrator to obtain these client products. You must also modify the fcc.xml file by doing the
following:
1. Contact your Teamcenter administrator for the following information about each server for each
Teamcenter product you want to view visualization data from:
Example:
d:\tc\10\tccs\bin
4. Navigate to teamcenter-product-installation-directory\tccs.
6. Search in the file for the following string: external site access definition.
7. After the line containing this string, add the following lines:
<site id=”site number” overridable=”true”>
<parentfsc address=”URL” priority=”1”/>
</site>
Example:
<site id=”101010101” overridable=”true”>
<parentfsc address=”http://tcentserver:4444/” priority=”1”/>
</site>
8. (If you have multiple Teamcenter product servers and you want to view visualization data from all
of them) Repeat the previous step for each server.
Note:
• For each additional <site> entry you add to the fcc.xml file, in the <parentfsc> tag,
increment the value of the priority attribute, so that each entry has a different priority.
If you plan to view data from multiple Teamcenter products, such as Teamcenter, Teamcenter
engineering process management, and Teamcenter Enterprise, you may have installed multiple File
Management System (FMS) client caches (FCCs). If your machine has multiple FCCs and you want to
view visualization data from a particular product, your machine's FMS_HOME environment variable
must point to the location of the product's FMS.
To check or change the value of the FMS_HOME environment variable, do the following:
Note:
A TCCS/FCC stop is required before changing FMS_HOME.
Windows
4. On the Environment Variables page, in the User variables section, find FMS_HOME and verify
that its path refers to the installation path of the product from which you want to load visualization
data.
Example:
d:\tc\13.0\tccs
Linux
1. In the shell window from which the software product was launched, type echo $FMS_HOME.
A path to the installation of that product is displayed.
2. Check the path to verify that the FMS_HOME environment variable is pointing to the right product.
Example:
.../tc/13.0/tccs
When working in a Multi-Site Collaboration environment, Teamcenter lifecycle visualization session files
referencing dynamic 3D documents may not update correctly. This issue can appear under the following
conditions:
• The session file and all referenced data are replicated on another site in the network.
• The session file is loaded into Teamcenter Visualization from the replica site.
To prevent session update failures in Teamcenter Visualization, update the File Locate preferences as
follows:
2. In the AutoFile Search Preferences dialog box, click the Document Search Order tab.
4. Click Move Up to position Relative File Directory Set above Original File Directory Set in the list.
6. Click OK.
If you save a session locally in a 2-tier Teamcenter environment and then load the session into a 4-tier
environment when 2-tier is not running, the authentication data is automatically loaded.
If you want a dialog box to appear to confirm the loading of data, add the
WEB_default_url_autoconfirm preference, and set it to false.
Because the files used to configure Teamcenter are cached, if you update client_specific.properties or
tcviewer.properties, your changes may not take effect in the viewers because the rich client is still
referencing the cached files. If your changes do not appear, do the following:
• To clear the cache, add the –clean argument to the command line in the shortcut you use to start the
rich client. Once your changes appear, you can remove the argument from the command line.
• If you update a JAR file in the ../rac/plugins directory, make sure to replace the original JAR file with
the updated version. Do not leave the original version of the JAR file in the directory.
To work with Visualization in Teamcenter you must have the appropriate license. You specify the
licensing for the Lifecycle Viewer and the Teamcenter embedded viewers. The Visualization service level
license is specified in the Teamcenter Organization application. Licensing for additional optional
applications is specified in the client_specific.properties file.
Caution:
These settings must match the licensing configuration available from your Teamcenter license
server. They are set automatically during the client installation and in most cases should not be
modified.
When you create or modify a user in Organization, for the Visualization Licensing Level, choose the
appropriate license for the user: Base, Standard, Professional, or Mockup.
1. Open the client_specific.properties file in a text editor. The file is located in the
<RAC_install_location>\plugins\configuration_<version>\ directory on client machines.
2. If the PortalViewer_Optional_licenses line does not exist, add the following line to the
client_specific.properties file, including the names of applicable functionality options.
Example:
PortalViewer_Optional_Licenses=ECAD,Analysis,Path_Planning
• ECAD
• Analysis
• Path_Planning
• Collaboration
The options to send Teamcenter-managed visualization data to the stand-alone application viewer may
not be shown by default on the user interface of the rich client. For these options to be displayed, you
must enable them using the TC_show_open_in_vmu_button preference.
4. Click OK.
In the rich client, the Start/Open in Lifecycle Visualization toolbar button and the File→Open
in Lifecycle Visualization menu command are displayed.
By default, the following system-defined search schemas are used when searches are performed from
the file dialogs within the stand-alone viewers and the Lifecycle Viewer:
• Dataset
• Item
• Item revision
• Part
Using background file loading for large JT models may improve the performance of subsequent analysis
operations, for example creating a cross section of a vehicle engine. Background file loading uses
secondary processing when the system is idle. Initial file rendering caches JT file fragments that support
displaying the model in the viewer. Once the initial rendering is complete, background file loading uses
secondary processes to begin streaming complete files that you selected. During this process your users
can view, rotate, and interact with the model; however, they might interrupt background loading or
defer it to a later time because the primary viewer rendering takes higher priority. For example cutting a
cross-sectioning may defer the background loading to a later time.
Consider the following when you configure FCC to support background file loading:
• Load your JT data from Teamcenter. This feature only supports working with managed data and FMS.
• The FCC must be configured to be large enough to load all the JT files required for visualizing during a
RAC session. If the FCC cache is too small, not all the JT files will be available during a viewing session
with unpredictable results. For example, the geometry for a part may not be visible, or a
LoadPartException may be thrown.
Example:
If the largest model is 2 GBs, set the segment cache to 4 GBs, that is, set the cache to twice
the size of the largest model.
• Set whole file cache to twice the size of the largest model.
• Review and set MinimumReadCacheAgeMinutes longer than end users will be away from the
active viewing session. For example, if your users can normally be interrupted for two hours during
an active viewer session, set this option to three hours.
Note:
The initial file rendering performance is not significantly influenced by selecting background file
loading.
For detailed information about installing and configuring FMS and FCC, see the following:
• For more information about installing FCC in Teamcenter lifecycle visualization, see the Installation
Guide.
• For more information about Teamcenter FMS, see How FMS works in the Teamcenter System
Administration Guide.
• For more information about configuring FCC using fccdefaults, see FCC cache parameters in the FMS
client configure file in the FMS files section of the System Administration Guide.
For steps to select background loading, see Load JT files using background processing.
Cache purging
Cache purging is a process that removes the oldest files in the FCC whole file cache to make disk space
for newer cache files. Minimum values for cache purging include the size of the segment and whole file
caches, and minimum cache file age. To prevent the application from deleting (purging) model files
from your FCC cache, the fccdefaults options must be set to optimize how you work in your
environment.
Example:
• In this example, a model is 8 GBs, but available local disk space is 7 GBs.
Your users can expect poor performance because the entire model cannot be loaded in the
whole file cache. As a result, data is downloaded using segment cache until it writes more than
the allocated data. It is important to note that data is loaded in Teamcenter lifecycle
visualization, but additional time is needed to render all parts.
• In this example, a large model is 2 GBs, and both the whole file and segment cache are set to 1
GB.
The data is downloaded using segment cache. The segment cache automatically purges the
oldest files whenever you access an object, which reduces performance. To resolve the
performance problem, the system administrator should set the both the whole file and segment
cache size to 4 GBs.
Note:
If the option, MinimumReadCacheAgeMinutes, has not been exceeded, the cache
increases to support loading the 2 GB model. That is, the cache expands so the 2GB model
is loaded or until the age exceeds its configured value (the default value is four hours).
• In this example, the cache size grows larger than the segment cache and
MinimumReadCacheAgeMinutes is exceeded.
The default for the MinimumReadCacheAgeMinutes option is four hours. Files in your model
have been downloaded and they are stored in your cache. If a file has not been accessed after
four hours, and you need to access and work with new data, the cache policy is configured to
purge the older files to make room for newer ones.
If you receive server time-out issues when trying to view large BOM lines in stand-alone visualization,
you may need to adjust the executionTimeout and maxRequestLength values in the Web.config file of
the Teamcenter web server.
4. Restart the IIS server, the Teamcenter server, and the Teamcenter rich client.
By default, in a four-tier environment, when you launch stand-alone Lifecycle Visualization from the
Teamcenter rich client, the viewer and the rich client share the same tcserver session. If you perform a
time consuming stand-alone viewer operation, the rich client may appear to lock up until the viewer
operation is finished. If this is a problem, you can configure Teamcenter to create a separate tcsever
session for the stand-alone viewer.
########################################################################
########
########################################################################
########
#viewerShareSession=true
#viewerShareSession=true
To:
viewerShareSession=false
When you launch the stand-alone viewer from the rich client, the viewer will have its own tcserver
session.
Note:
Embedded viewers in the rich client are not affected by this property. They will continue to share
the tcserver session with the rich client.
The embedded viewer launches in the locale of the operating system. For the embedded viewer to work
properly, the operating system locale and the rich client runtime locale must match.
The -nl argument overrides the Java locale and can cause incorrect behavior in the embedded viewer.
Therefore, if you use the Lifecycle Visualization embedded viewer, do not use the -nl argument when
you launch the rich client.
Note:
You must have administrative permission to perform this task.
After installing Lifecycle Visualization, check for the existence of a PostScript Printer entry in the
Printers section of the Control Panel. If a PostScript Printer entry does not exist, run the
InstallPrinter.bat file from the following location:
install-path\Visualization\VVCP\Driver
This batch file assumes the c:\temp directory exists. If this directory does not exist, create the directory
before running the batch file, or modify the PORTNAME value near the top of the batch file to place the
psout.ps file in a directory writable by all potential users of the Lifecycle Visualization installation. The
modified PORTNAME value must be less than 40 characters in length.
If the Windows can't verify the publisher of this driver software message is
displayed, click Install this driver software anyway.
Note:
For information about installing a PostScript printer on Windows 8 or Windows Server, see the
stand-alone Lifecycle Visualization Installation Guide.
Multifield keys are identifiers assigned to objects to ensure their uniqueness in the database. For
example, if the item business object type is configured to use multifield keys, it is possible to have two
item objects with the same item ID.
Most visualization features support multifield key data without requiring any additional configuration,
with the following exceptions:
• ClearanceDB
The managed product name must include the __PLM_ITEMREV_UID value for the item revision, and
the clearance.cfgproduct file must include the multifield key properties for the item containing the
product.
• MDS stamping
The MetaDataStamp_template preference must specify the values of the multifield key properties
associated with the item containing the MDS_default_styles_template dataset.
Note:
Active Workspace Application Connect is available only when using Active Workspace 4.3 or later
and Lifecycle Visualization 12.3 or later.
Active Workspace Application Connect enables users to use the Active Workspace Open in Visualization
command to open their data in a new browser tab and send data to the Lifecycle Visualization
application. Like hosting, this connectivity option allows the user to see their work synchronized
between Active Workspace and Lifecycle Visualization. Unlike hosting, Active Workspace Application
Connect allows the user to open multiple documents—either in the same browser tab or in separate
browser tabs—and retain connectivity for all opened documents. Active Workspace Application Connect
also has improved cross-selection performance.
To enable a user to establish a connection between Active Workspace and Lifecycle Visualization, set the
following preferences:
• AWV0UseAWAppConnect
Causes a new tab to open in the default browser, which enables the Active Workspace session to
interoperate with Lifecycle Visualization. If the value of this preference is True, Active Workspace
Application Connect is enabled. If it is False but the AWV0HostAWInVisUponLaunch preference is
set to True, then connection between Active Workspace and Lifecycle Visualization is completed
through hosting and not Active Workspace Application Connect.
The URL of the Active Workspace Application Connect browser tab will begin with http://
<your_aw_deployment>?ah=true&room=TcVis_.
• AWV0HostAWInVisUponLaunch
Enables an Active Workspace session in Lifecycle Visualization when you open a model in
visualization. If the value of this preference is True the Active Workspace session is enabled. If it is
False, only the visualization session is enabled. This preference must be set for both Active Workspace
Application Connect and for hosting.
To Do
You can host Active Workspace in the browser embedded in stand-alone Lifecycle Visualization. Hosting
is especially useful because if you use the Active Workspace Open in Visualization command to send
data to the Lifecycle Visualization application, then selecting a part in either the hosted Active
Workspace structure or in the viewing window applies the same selection status in both locations. This
behavior is referred to as "cross-selection."
Configure the local computer to host Active Workspace in stand-alone application viewer
Configure the local computer to host Active Workspace in stand-alone application viewer
Note:
Prerequisites for this procedure:
• The Teamcenter administrator has installed the Active Workspace server extension for
visualization.
• The stand-alone application viewer software is installed on the local computer.
• A File Management System client cache (FCC) for the Active Workspace Teamcenter database is
configured on the local computer.
1. In the stand-alone viewer, from the Application toolbar, choose Menu→Web→Edit Links.
4. Select the link and then, in the Link URL box, type the Active Workspace address.
?ah=true
http://<your_aw_deployment>?ah=true
Adding the ?ah=true suffix selects and disables the Display in Info Browser checkbox.
6. Click OK.
7. In the Windows registry, create the following browser emulation DWORD entries.
HKEY_CURRENT_USER
SOFTWARE
Microsoft
Internet Explorer
Main
FeatureControl
FEATURE_BROWSER_EMULATION
visview.exe = (DWORD) 00011000
visview_ng.exe = (DWORD) 00011000
Make sure the 11000 DWORD values are in decimal. The equivalent value in hexadecimal is 2AF8.
b. Press Alt to display the Menu bar (or right-click the Address bar and then select Menu bar).
1. As needed, configure the local computer to host Active Workspace in stand-alone application
viewer.
3. Type your user name and password, and click Sign in.
4. (Optional, but likely desired) In the hosted Active Workspace browser, send visualization data to the
stand-alone viewer.
3DMarkup_relation_primary
DESCRIPTION
Indicates the list of valid primary object types for the 3Dmarkup relation. These are the dataset types
that you can mark up with the 3D markup tools. The format is relation-name_relation_primary=List of
valid primary object types. This preference is applicable for the stand-alone viewer and the Lifecycle
Viewer.
Note:
All <relation_business_object>_relation_primary preferences are obsolete and are replaced by
relation properties. Use the Business Modeler IDE to create and manage relation properties.
VALID VALUES
One or more strings as values; each string must be a valid Teamcenter dataset type.
DEFAULT VALUES
DirectModel
DirectModelAssembly
Site preference.
DMI_markup_relation_primary
DESCRIPTION
Indicates the list of valid primary object types for the DMI_markup relation. These are the dataset types
that you can mark up with the 2D markup tools. The format is relation-name_relation_primary=List of
valid primary object types. This preference is applicable for the stand-alone viewer and the Lifecycle
Viewer.
Note:
All <relation_business_object>_relation_primary preferences are obsolete and are replaced by
relation properties. Use the Business Modeler IDE to create and manage relation properties.
VALID VALUES
One or more strings as values; each string must be a valid Teamcenter dataset type.
DEFAULT VALUES
DirectModel
DrawingSheet
Image
Site preference.
INTEROP_ExtraPLMXMLInstanceAttributes
DESCRIPTION
Determines the mapping of Structure Manager BOM line attributes to Lifecycle Visualization attributes.
Note:
• This preference is applicable only for PLM XML generated by the BOMWriter. For the SOA-based
Teamcenter integration with Lifecycle Visualization 8 and later, use the Interop_Vis_Attributes
and Interop_Vis_Attributes_Admin_Filter preferences.
• This preference works only with stand-alone Lifecycle Visualization and the Lifecycle Viewer.
VALID VALUES
Accepts multiple string pairs as values. Each group of strings must be in the following format:
target:root/part/instance/occurrence
key:Lifecycle Visualization attribute name
prop:BOM line property
|propuid:bomline property tag value converted to UID
|literal: literal string
|attr:attribute name
target:root writes user attributes to the ProductRevisionView element of the top BOM line item
revision in the generated PLM XML file.
target:part writes user attributes to all ProductRevisionView elements in the generated PLM XML file.
target:instance writes user attributes to all Instance elements in the generated PLM XML file.
target:occurrence writes user attributes to all Occurrence elements in the generated PLM XML file.
target:Occurrence
key:USER_DATA_1
prop:bl_ItemRevision Master_user_data_1
target:Instance
key:COMMENTS
prop:bl_ItemRevision Master_item_comment
key:CATEGORY
literal:CRITICALPART
target:Part
key:BOM_VIEW_TAG
propuid:bl_bomview
Maps the user_data_1 attribute from the child Item Revision Master form to the USER_DATA_1
Lifecycle Visualization attribute. This mapping is written on all Occurrence elements.
Maps the comments attribute from the child Item Revision Master form to the COMMENTS Lifecycle
Visualization attribute. This mapping is written on all Instance elements.
Maps the CRITICALPART (literal string) to the CATEGORY Lifecycle Visualization attribute. This mapping
is written on all Instance elements.
Maps the bl_bomview (UID value) to the BOM_VIEW_TAG Lifecycle Visualization attribute. This
mapping is written on all ProductRevisionView elements.
DEFAULT VALUES
None.
Site preference.
Interop_Vis_Attributes
DESCRIPTION
Indicates which Teamcenter attributes are available when an assembly is displayed in Lifecycle
Visualization. The Lifecycle Visualization Teamcenter Integration Preferences dialog box
(File→Preferences→Teamcenter Integration→Attributes) provides a convenient user interface for
managing this preference.
The Interop_Vis_Attributes preference corresponds to the right column in the Teamcenter Integration
Preferences dialog box as shown.
VALID VALUES
DEFAULT VALUES
None.
User preference.
Interop_Vis_Attributes_Admin_Filter
DESCRIPTION
Indicates which Teamcenter attributes are presented to users when assemblies are viewed in Lifecycle
Visualization Teamcenter Integration Preferences dialog box (File→Preferences→Teamcenter
Integration→Attributes). Those presented are the ones that users can then display (see the
Interop_Vis_Attributes preference description).
If there is no setting for the Interop_Vis_Attributes_Admin_Filter preference, the left column lists all
BOM line attributes as candidates for users to select display (that is, candidates to move to right
column).
VALID VALUES
DEFAULT VALUES
None.
User preference.
ItemRevision_DirectModel3DMarkup_default_relation
DESCRIPTION
Specifies the relation that has to be created when a DirectModel3DMarkup dataset is pasted under an
item revision. The relation specified for this preference is the default relation that is created between the
DirectModel3DMarkup dataset and the target item revision. This preference is applicable for the stand-
alone viewer and the Lifecycle Viewer.
Warning:
This preference is set automatically by the application and must not be modified.
VALID VALUES
DEFAULT VALUES
VisMarkup
Site preference.
ItemRevision_Vis_Session_default_relation
DESCRIPTION
Specifies the relation that has to be created when a Vis_Session dataset is pasted under an item
revision. The relation specified for this preference is the default relation that is created between the
Vis_Session dataset and the target item revision. This preference is applicable for the stand-alone
viewer and the Lifecycle Viewer.
Warning:
This preference is set automatically by the application and must not be modified.
VALID VALUES
DEFAULT VALUES
VisSession
Site preference.
JT_File_Use_Monolithic_Icon
DESCRIPTION
Specifies whether a monolithic icon is displayed to indicate the presence of structure in a JT file in the
BOM tree of the Structure Manager and Manufacturing Process Planner applications.
VALID VALUES
true The monolithic icon is displayed when a monolithic JT file containing structure is loaded in
the viewer.
false The monolithic icon is not displayed unless the node is affected by the
JT_File_OverrideChildren_Refsets preference.
DEFAULT VALUES
true
User preference.
ManagedIssueList
DESCRIPTION
Specifies the URL of your Teamcenter visual issues list. This preference is applicable for the stand-alone
viewer only. When you use the View existing issues command in the stand-alone viewer, the browser
displays the specified list.
Note:
By default, the visual issues list includes all IssueReport Revisions. To display only visual issues that
match predefined search criteria, you must also set the ManagedIssueListQuery preference.
VALID VALUES
Example:
http://10.200.30.400:7001/awc?TC_file=search/issuelist.html
DEFAULT VALUES
None.
Site preference.
ManagedIssueListQuery
DESCRIPTION
Specifies the name of a saved search to use when working with visual issues in the stand-alone viewer.
By default, when you use the View existing issues command, the browser displays a list of all existing
IssueReport Revisions. If you have created a custom search to find IssueReport Revisions according to
criteria such as Owning Group and Issue Category, you can specify to use that search instead of the
default.
VALID VALUES
DEFAULT VALUES
None.
User preference.
ManagedIssueServer
DESCRIPTION
Specifies to use the legacy visual issues feature, which interfaces with Teamcenter community
collaboration, or the Teamcenter visual issues system. This preference is applicable for the stand-alone
viewer only.
VALID VALUES
True or False. Type True to use the Teamcenter visual issues system in the stand-alone viewer, or False
to use the legacy visual issues feature.
DEFAULT VALUES
True
Site preference.
PLM_End_Item_Key
DESCRIPTION
Indicates which Teamcenter occurrence note (BOM line attribute key/name) is used to identify an
occurrence as an end item. If the identified occurrence note exists on an occurrence and has a value of
True, that occurrence is treated as an end item by the viewer.
VALID VALUES
DEFAULT VALUES
None.
User preference.
SecondaryVMUDatasets
DESCRIPTION
Defines the dataset types, connected using a secondary relationship, used to search for files in
ambiguous conditions. Ambiguous conditions result from performing file operations on objects or
datasets.
These are the non-VMU dataset types that can contain VMU datasets. VMU datasets are datasets that
can be directly launched from the rich client into the Lifecycle Viewer or a stand-alone viewer.
VALID VALUES
DEFAULT VALUES
UGMASTER
UGPART
UGALTREP
Site preference.
TC_DIS_2D_named_ref
DESCRIPTION
Defines the possible reference names of 2D file types that are capable of 2D markups. This preference is
applicable for the Lifecycle Viewer and the viewers embedded in Teamcenter applications such as My
Teamcenter and Structure Manager.
VALID VALUES
One or more strings as values; each string must be a valid Teamcenter reference name.
DEFAULT VALUES
Quickshade-Image
PLT
BMP
CAL
TIFF
Graphics-Interface
Sheet
PDF_Reference
JPEG
TIF
Site preference.
TC_DIS_3D_named_ref
DESCRIPTION
Defines the possible reference names of 3D file types that are capable of 3D markups. This preference is
applicable for the Lifecycle Viewer and the viewers embedded in Teamcenter applications such as My
Teamcenter and Structure Manager.
VALID VALUES
One or more strings as values; each string must be a valid Teamcenter reference name.
DEFAULT VALUES
ConfiguredAssembly
UGPART
IMAGE
Site preference.
TC_DIS_Search
DESCRIPTION
The search schemas used when searches are performed from the file dialogs within the stand-alone
viewers and the Lifecycle Viewer.
VALID VALUES
One or more strings as values; each string must be an existing Teamcenter search schema.
DEFAULT VALUES
Dataset…
Item…
Item Revision…
Part
User preference.
TC_ENABLE_REPOSITION_DIALOG
DESCRIPTION
Specifies whether to use the Reposition or the Transformation dialog boxes to transform parts in the
rich client embedded viewers.
VALID VALUES
• The Reposition – Exploded View dialog box appears when you choose
Graphics→Reposition→Temporary Position.
• The Reposition – BOM Line Edit dialog box appears when you choose
Graphics→Reposition→Persistent Position.
false Specifies the following:
DEFAULT VALUES
false
User preference.
TC_Generate_Markup_Name
DESCRIPTION
Indicates whether user-created 2D and 3D markup dataset names are hard-coded or generated. If set to
true, names are generated. The generated name format is: <user ID> <current date timestamp> <user
display name>.
Example:
msmith 2017-05-22 (SmithMary)
VALID VALUES
True
False
DEFAULT VALUES
False
Site preference.
TC_Schematic_BOMView_Types
DESCRIPTION
Determines whether Lifecycle Visualization is used in schematic mode or 3D mode. If left unset,
Lifecycle Visualization is used in 3D mode.
VALID VALUES
Takes multiple strings as values. Each value must be a set of BOM View types. It is intended that the
types represent logical BOMs. For example:
DEFAULT VALUES
None.
Site preference.
TC_show_open_in_vmu_button
DESCRIPTION
Specifies whether the Start/Open in Lifecycle Visualization button is displayed in the rich client.
VALID VALUES
DEFAULT VALUES
false
User preference.
TCVIS_reposition_all_arrangements
DESCRIPTION
Controls the extent of persistent transformations in arrangements. If undefined or set to True, persistent
transformations made using the Graphics→Transformation→Persistent Transformation menu
command are applied to all arrangements in the structure; if set to False, persistent transformations are
applied only to the active arrangement.
VALID VALUES
DEFAULT VALUES
True
User preference.
Vis_Doc_OpenOption
DESCRIPTION
Specifies the behavior for opening a document in the embedded or stand-alone Lifecycle Visualization
viewer when the same document is already open in that viewer.
VALID VALUES
DEFAULT VALUES
ActivateExistingDocument
User preference.
VIS_expand_below_batch_size
DESCRIPTION
Defines the batch size of BOM lines to expand for all assembly expand operations in the Lifecycle Viewer
and the stand-alone application viewer. BOM lines are expanded in each assembly level in batches, the
size of which is defined by this preference.
Note:
Use the RAC_expand_below_batch_size preference to specify the batch size of expand
operations in the Structure Manager viewer.
VALID VALUES
Accepts a single integer as a value. A positive integer defines the number of lines processed per batch.
Use -1 to indicate no maximum batch size, in which case all lines in a single level are processed in a
single batch.
DEFAULT VALUES
50
User preference.
VIS_mmvindexgen_admin_group
DESCRIPTION
Specifies what user group has the authority to run the mmvindexgen harvester.
Note:
Create the MmvIndexGenAdmin user group and add those users with the authority to run the
mmvindexgen harvester, or change the default value of this preference to the name of an
existing user group.
VALID VALUES
DEFAULT VALUES
MmvIndexGenAdmin
Site preference.
VIS_multi_file_datasettypes
DESCRIPTION
Specifies the visualization dataset types that can contain more than one named reference. Users can
view the selected named reference in the My Teamcenter embedded viewer.
VALID VALUES
One or more strings as values; each string must be a valid Teamcenter dataset type.
DEFAULT VALUES
DirectModel
DrawingSheet
Site preference.
VIS_Persistent_Transform_To_Part_Level
DESCRIPTION
VALID VALUES
DEFAULT VALUES
false
Site preference.
Vis_PV_BlockingViewToggles
DESCRIPTION
Defines the list of the view toggles states that can affect how product views are created.
For more details about blocking view toggles, see the Vis_PV_InvalidConfigWarnLevel preference.
VALID VALUES
DEFAULT VALUES
Site preference.
Vis_PV_HowTo_Configure_BOM
DESCRIPTION
Indicates how the BOM window is to be configured before a product view is applied to it. This
configuration is captured in the product view with the use of the VisStructureContext object. This
object records the Revision Rule, Variant Rule, Assembly Arrangement and Occurrence Effectivity.
VALID VALUES
• UseCurrent – the product view is applied without modifying the configuration of the BOM window.
The current configuration is used.
• UsePV – the BOM recipe that is recorded in the product view is used to configure the BOM window.
DEFAULT VALUES
UseCurrent
User preference.
Vis_PV_InvalidConfigWarnLevel
DESCRIPTION
Defines the intervention level when you capture a product view containing an active view toggle state.
VALID VALUES
Warning – A warning message is displayed to the user alerting the presence of active view toggles on
the BOM window.
Prevent – User shall not be allowed to proceed with creation of the product view.
DEFAULT VALUES
Warning
Site preference.
Vis_PV_ImageCapture
DESCRIPTION
Indicates whether an Image Capture should be added when a product view is created. It also is used to
determine how the Image Capture options are configured.
VALID VALUES
• CaptureUsingPrefs – an Image Capture is generated using Teamcenter preferences that affect Image
Capture generation.
• CaptureUsingDialog – an Image Capture is generated and the application uses the Image Export
dialog option to configure the Image Capture.
DEFAULT VALUES
NoImageCapture
User preference.
Vis_PV_Play_Motion
DESCRIPTION
Indicates whether the motion file (if one exists) should be played automatically using the current view
when the product view is applied.
VALID VALUES
True
False
DEFAULT VALUES
True
User preference.
NOTE
Vis_PV_Show_Name_Dialog
DESCRIPTION
Indicates whether the application displays the name of a product view when it was created. If set to
false, the product view name is generated automatically.
VALID VALUES
True
False
DEFAULT VALUES
True
User preference.
Vis_PV_Geometry_Asset
DESCRIPTION
Indicates whether the application captures a 3D Geometry Asset when a product view is created. This
preference also specifies if an outline capture should be captured with the 3D Geometry Asset.
VALID VALUES
DEFAULT VALUES
NoGeoAsset
User preference.
NOTE
This preference replaces the previously existing Business Modeler IDE business object constant named
Fnd0VisPVGeoAsset. This change is made to allow greater flexibility to the administrators in controlling
how this information is set.
Vis_PV_capture3DGeomAssetAsOutline
DESCRIPTION
Activates the creation of outline capture when you save a product view in Lifecycle Visualization.
Note:
This preference is only used if 3D Geometry Asset Capture is enabled for product view save with
no menus.
VALID VALUES
True
False
DEFAULT VALUES
False
Site preference.
Vis_PV_ImageCaptureHeight
DESCRIPTION
Defines the height in pixels of the preview image created when saving a product view from Lifecycle
Visualization.
Note:
This preference is only used if Image Capture is selected for product views, and if you clear Use
Image Export Dialog.
VALID VALUES
Note:
When you select a value of 0 for either width or height, both values are calculated automatically.
DEFAULT VALUES
400
Site preference.
Vis_PV_ImageCaptureResolution
DESCRIPTION
Defines the resolution of the preview image created when saving a product view from Lifecycle
Visualization.
VALID VALUES
DEFAULT VALUES
250
Site preference.
Vis_PV_ImageCaptureType
DESCRIPTION
Defines the format of the preview image created when saving a product view from Lifecycle
Visualization.
Note:
This preference is only used if Image Capture is selected for product views, and if you clear Use
Image Export Dialog.
VALID VALUES
BMP 24bit
BMP 8bit
BMP BW
JPEG 24bit
PNG 24bit
PNG 8bit
PNG BW
TIFF 24bit
TIFF 8bit
TIFF BW
DEFAULT VALUES
JPEG 24bit
Site preference.
Vis_PV_ImageCaptureWidth
DESCRIPTION
Defines the width in pixels of the preview image created when saving a product view from Lifecycle
Visualization.
Note:
This preference is only used if Image Capture is selected for product views, and if you clear Use
Image Export Dialog.
VALID VALUES
Note:
When you select a value of 0 for either width or height, both values are calculated automatically.
DEFAULT VALUES
600
Site preference.
Vis_PV_ThumbnailHeight
DESCRIPTION
VALID VALUES
DEFAULT VALUES
80
Site preference.
Vis_PV_ThumbnailQuality
DESCRIPTION
VALID VALUES
DEFAULT VALUES
100
Site preference.
Vis_PV_ThumbnailWidth
DESCRIPTION
Defines the width in pixels of thumbnails created when saving a Product View from Lifecycle
Visualization.
VALID VALUES
DEFAULT VALUES
80
Site preference.
VisMarkup_relation_primary
DESCRIPTION
Indicates the valid primary object type for the Visualization 3DMarkup relation. The format is relation-
name_relation_primary=valid primary object type. This preference is applicable for the stand-alone
viewers and the Lifecycle Viewer.
Warning:
This preference is set automatically by the application and must not be modified.
Note:
All <relation_business_object>_relation_primary preferences are obsolete and are replaced by
relation properties. Use the Business Modeler IDE to create and manage relation properties.
VALID VALUES
DEFAULT VALUES
ItemRevision
Site preference.
VisualReport_Use_Classification
DESCRIPTION
Specifies that you want to use the Classification application when you work with visual reports.
VALID VALUES
DEFAULT VALUE
False
User preference.
VisSession_relation_primary
DESCRIPTION
Indicates the valid primary object type for the Visualization Session relation. The format is relation-
name_relation_primary=valid primary object type. This preference is applicable for the stand-alone
viewers and the Lifecycle Viewer.
Warning:
This preference is set automatically by the application and must not be modified.
Note:
All <relation_business_object>_relation_primary preferences are obsolete and are replaced by
relation properties. Use the Business Modeler IDE to create and manage relation properties.
VALID VALUES
DEFAULT VALUES
ItemRevision
Site preference.
VMU_Datasets
DESCRIPTION
Determines the datasets that can be directly launched in Teamcenter lifecycle visualization using the
File→Open in VMU command in the rich client. To open files such as .tiff files and PDF files, the dataset
types used to manage these files must be appended to the existing values for this preference. You must
also add the custom reference names within these custom dataset types to the VMU_FileSearchOrder
preference.
VALID VALUES
One or more strings as values; each string must be a valid Teamcenter dataset type.
DEFAULT VALUES
ClearanceDBConnection
ClearanceDBReport
ClearanceResults
ClearanceResultsFilter
DirectModel
DirectModel3DMarkup
DirectModelAnimation
DirectModelAssembly
DirectModelFlowChart
DirectModelIllustrationBook
DirectModelIllustrationSheet
DirectModelMarkup
DirectModelMotion
DirectModelSession
DrawingSheet
ECADDFX
Image
JtSimplification
Markup
Nastran
PADImage
PADReport
PCBFATF
PCBMarkup
SCHFATF
SnapShotViewData
Text
VisJackEnvironment
VisJackFigure
VisJackPosture
VisJackPsurf
VisMovieCapture
VisPublishGeometryAsset
VisPublishTechnicalIllustration
VisPublishTechnicalPortfolio
VisPublishVisioStencil
VisPublishVisioTemplate
VisQualityCluster
Vis_Session
VSAProcessDoc
VSAMeasurementDoc
Zone
Site preference.
VMU_FileSearchOrder
DESCRIPTION
Defines the order that reference names are used to search for files in ambiguous conditions. Ambiguous
conditions result from performing file operations on objects or datasets. Add your custom dataset types
to the VMU_Datasets preference to launch them in Teamcenter lifecycle visualization. You must also
add the custom reference names within these custom dataset types to the VMU_FileSearchOrder
preference.
VALID VALUES
One or more strings as a values; each string must be a named reference that exists within datasets that
can be loaded in Teamcenter lifecycle visualization mockup.
DEFAULT VALUES
Markup
Image
JTPART
JTSESSION
Package
ConfiguredAssembly
3DModel
Quickshade-Image
PLT
BMP
CAL
TIFF
Graphics-Interface
Sheet
Process
Measurement
FlowChart
Animation
Motion
IllustrationBook
IllustrationSheet
Site preference.
VMU_RelationSearchOrder
DESCRIPTION
Defines the ordered list of relations used for searching relations between visualization datasets and
items or item revisions. New relations must be added to the list.
VALID VALUES
DEFAULT VALUES
IMAN_Rendering
IMAN_specification
IMAN_MOTION
IMAN_3D_snap_shot
IMAN_manifestation
TC_Attaches
Site preference.
Use the Teamcenter Integration Preferences to specify the default behavior of visualization datasets in
Lifecycle Visualization. In the stand-alone viewer or the Lifecycle Viewer, choose
File→Preferences→Teamcenter Integration to adjust any of the following preferences:
Use the Teamcenter integration 3D loader preferences to specify the unit of length for product structure
data sent as a new document to the Lifecycle Viewer or stand-alone application viewer. You can also
specify how to load 3D documents containing both static and configured structure.
3. In the Document Units section, from the Document Units list, select a unit of measurement.
Note:
• The default unit of length for product structure data sent to the Lifecycle Viewer or the
stand-alone application viewer is meters.
• Changes to the Document Units preference do not apply to documents that are open in
the session. After modifying the preference, close and reopen your documents for the
change to take effect.
• The Document Units preference is not applicable for structure that is inserted or merged
into an existing document.
• The Document Units preference has no effect on static structure that is opened in the
Lifecycle Viewer or the stand-alone application viewer. The document unit of length for
static data is specified using the PLMXML units setting in PLMXML Preferences.
To Do this
Open configured structure according to its Click Configure an updated structure.
current state in Teamcenter. The most recent
structure configuration is loaded.
For 4GD subsets, replay the subset recipe a. Click Configure an updated structure.
before opening the data.
b. From the Update subset on load list,
select one of the following:
• No Update
• Replay Recipe
When both configured and static product Click Load static structure (structure at time
structure are available, open the structure of session save).
according to its state at the time the session
was saved.
When both configured and static product Click Ask at load time.
structure are available, choose how to load the
structure when you attempt to open it.
5. In the Partitions section, select the Show empty partitions check box if, when viewing partition
hierarchies in the assembly tree, you want to show partitions that have no design element
members. When this option is not selected, empty partitions do not appear.
Use the Teamcenter Integration Session preferences to control how sessions are saved.
To Do this
Save session files with the base document. Click Attach to base document.
Save session files in a new location. Click Alternate location.
Use the Teamcenter Integration Markup preferences to control how new markups are named and to
display messages during batch modifications.
Note:
The Teamcenter site preference TC_Generate_Markup_Name determines whether dataset names
are hard-coded or generated. This controls the markup name only in Teamcenter. In standalone
Lifecycle Visualization, the generated markup name is always used.
To Do this
Name new markup datasets as you create them Select the Show New Dataset selection dialog
check box.
Display warning messages during batch Select the Show warnings during batch
operations modifications check box.
Display errors that occur during batch Select the Show partial errors during batch
operations modifications check box.
Use the Teamcenter Integration Check Out Preferences to specify the default behavior when attempting
to load checked out objects.
• Cancel load
• Cancel load
• Show warnings
When you have already opened the documents In the Same User / Same Application section,
in the viewer choose from the following options
• Cancel load
• Show warnings
Use the Teamcenter Integration Attributes Preferences to control the display of Teamcenter and NX
attributes present in visualization datasets.
Note:
This preference is applicable for assemblies only. It has no effect on individual JT datasets.
3. In the Teamcenter Attributes tab, select the attributes that you want to display.
Tip:
To select multiple adjacent attributes, click the first attribute, press Shift, and then click the
last attribute. To select multiple nonadjacent attributes, hold Ctrl as you click each item.
4. Click Add.
The selected attributes move to the Displayed Attributes section.
Note:
• You can also set the attributes to display within Teamcenter. Choose Edit→Options→Index,
and then search for Interop_Vis_Attributes.
• To display attributes that are longer than a single line, your system administrator must have
grouped them into a single, multiline attribute.
Use the Teamcenter Integration Snapshot Preferences to control how 2D and 3D snapshots are saved to
Teamcenter.
To Do this
Enter form data on 2D Select the Show attributes form on save check box.
snapshots
Note:
You can enter data for any custom form fields. Revision and Page
information is entered automatically.
To Do this
Add or update 3D a. Select the Add or Update 3D Geometry Asset check box.
geometry asset for
product views b. (Optional) Select the Draw Outline check box to generate an
outline of the 3D geometry asset.
Note:
If you do not see the Add or Update 3D Geometry Asset
check box, contact your administrator.
Note:
If you do not see the Image Capture check box, contact your
administrator.
Rename the product a. Select the Show Snapshot Name Dialog check box to display the
view before saving it New Teamcenter Product View Dataset dialog box.
Note:
• Use 3D Product View preferences to modify how Teamcenter product views are processed.
• When you do not send Teamcenter data to Lifecycle Viewer. That is, you must have an active
connection to a Teamcenter server.
• When the Teamcenter protection scope of the preferences is higher than your permission
scope. For example, if your administrator set the preference protection scope to SITE, and
your protection scope is set to USER, the 3D Product View options are unavailable.
• If you have permissions, when you change a product view preference in Lifecycle Viewer you
also change the corresponding Teamcenter preference on the server.
Use the Teamcenter Integration Visual Issue Preferences to control the default behavior of visual issue
creation.
To Do this
Specify a visual report template From the Issue Type list, select a template.
Note:
Issue Report is the default issue type.
Your organization may also allow you to
choose from additional issue types.
Specify the issue relation to use for snapshots In the Issue Relation for Snapshots section,
choose one of the following:
• Session File
Enter options for visual issue creation each time Select the Ask at the time the Issue is created
an issue is created check box.
Use the Teamcenter Integration 3D Save Preferences to specify how to save 3D documents that contain
both configured and static product structure.
To Do this
Specify to save configured structure only Select Save only configured structure.
Specify to save both configured and static Select Save configured and static
representations of the current structure representations of the current structure.
Note:
The options to send Teamcenter managed visualization data to the stand-alone viewer may not be
shown by default on the user interface of the rich client. For these options to be displayed, you
must enable them using the Lifecycle Visualization options in the rich client or the
TC_show_open_in_vmu_button preference.
To Do this
Send any of the following to the stand-alone Select the object and do one of the following:
viewer:
• On the My Teamcenter toolbar, click Start/
• An item or item revision that includes Open In Lifecycle Visualization .
visualization data
• Choose File→Open in Lifecycle
• A BOM view
Visualization.
• 4GD worksets
To Do this
• An item or item revision that includes
visualization data
• A BOM view
• 4GD worksets
To send product structure to the visualization client, select the product structure within the Structure
Manager and then do one of the following:
• Click Start/Open In Lifecycle Visualization to send the product structure to a stand-alone viewer.
• Right-click the product structure and choose Send To→Lifecycle Viewer to send the product
structure to the Lifecycle Viewer.
To send a full product structure to the visualization client, select the root or top line of the product
structure. To send a partial product structure, select any child nodes within the root product structure
hierarchy. Partial product structure consists of the lines representing the unique paths down to the
selected structure.
Note:
When working with partial product structures, the following limitations apply:
• You can expand only the child hierarchy of the launched lines.
• All viewer operations, such as filters and clearance analysis, are applicable only for the launched
lines.
Note:
Teamcenter applications such as Structure Manager include view toggles that enable you to see
BOM lines that are configured out because of effectivity or variants. The view toggle Show
Suppressed Occurrences enables you to see BOM lines that are suppressed in the current
assembly arrangement. If you send an assembly to the stand-alone application viewer or the
Lifecycle Viewer when this view toggle is on, the suppressed structure elements are grayed out. If
you open a product view that captured suppressed occurrences, an inactive structure warning is
displayed. To avoid this problem, set the Product View Creation Preferences to prevent the
creation of product views when the Show Suppressed Occurrences view toggle is enabled.
The steps required to insert or merge files vary slightly depending upon the applications involved. When
working with local data in the stand-alone viewer, you must use the Application toolbar
Menu→File→Insert or File→Merge commands. When working with Teamcenter managed data, you
send the data you want to insert or merge into the stand-alone viewer or the Lifecycle Viewer, and then
specify how you want to open the data in the Load Option Preferences dialog box.
2. In the Assembly view, right-click the product structure or parts and choose Send to My
Teamcenter.
-or-
In the Viewing window, right-click the geometry and choose Send to My Teamcenter.
The associated item revision is opened in My Teamcenter.
Tip:
If you have directories containing hundreds or thousands of files, it may take a while for the
complete list of files to appear. You can press Ctrl-Break (Windows) or Esc (Linux) to stop the
file listing at any point.
2. In the Open dialog box, browse to a location that you want to add to your User Areas.
5. To access a User Area, click User Areas in the shortcuts panel on the left side of the file dialog box.
• Open
• Insert
• Merge
3. Double-click the server you want to search to access it, and then choose Tools→Search Server.
4. In the Select Search section of the Server Search Dialog dialog box, select a search object.
Choose from the following types of searches:
• Dataset
• Item Revision
• Item
• Part
The Enter Search Criteria section is populated with the available search variations.
5. In the Enter Search Criteria section, select a search criteria, type an appropriate search keyword,
and click Search.
The server is searched using the criteria you specified. When the search is completed, the Search
Results dialog box appears.
2. In the Load Option Preferences dialog box, choose from the following preferences:
• On the 3D tab:
In this
section Select this To
Product Open document Do one of the following:
Structure
• Open the document in a new window.
Note:
You can merge product structure only if
the data being sent is compatible with
the contents of the active Viewing
window. For structure to merge, the
data being sent to the visualization
In this
section Select this To
client and the data in the active Viewing
window must share the following
structure configuration properties:
• Revision rule
Ask at load time Select your options each time you open a file.
Markups Open with markups Open markups associated with the data.
Ask at load time Select your options each time you open a file.
• On the 2D tab:
Select this To
Open document Do one of the following:
Select this To
Open document Do one of the following:
Select this To
• Open the document in a new window.
Note:
• Selections are persisted each time the dialog box opens.
• The default settings for the Load Option Preferences dialog box are Ask at load time and
Merge document into active window.
• For 3D, for If merge is not possible the default is Open document.
• If you choose Ask at load time, you can use the load option preference to change how
you want to open files.
2. In the File Open Preferences dialog box, choose one of the following for each file type:
• 2D
• 3D
• Prompt
Note:
• This functionality is supported in Standard service levels and above. For Base service levels,
these files always open as 2D file types.
2. In the PLMXML Preferences dialog box, on the Load page, choose from the following preferences:
Select this To
PLMXML Units Define the unit of measurement. By default, the unit of
measurement for PLM XML and Parasolid files is meters.
You can use the PLMXML Units setting to specify
another unit of measurement.
Note:
• The PLM XML Units setting is saved in session
files. If you change and save the model units
setting with a VF file, the specified model units
of the session file override the current PLMXML
Units setting.
Apply the default product view on Load the default product view when the PLM XML file is
load loaded. If this option is not selected, the default product
view is not loaded but is added as a snapshot, which
(if unchecked, it will be added as a
reduces load time.
snapshot)
Note:
To use sessions, your system administrator must define ACL (access control list) rules for
Vis_Session using Access Manager. For details, see Configure Teamcenter Lifecycle Visualization
sessions in Teamcenter Application Administration.
• Open files
• Snapshot information
• 3D preferences
• Cross sections
• 3D Measurements
• 3D layers
• Teamcenter revision rules, effectivity, variant rules, active assembly arrangements, and other
configuration settings.
Example:
You are working with model1.jt, model2.jt, and image.tif. You have created snapshots, changed
background colors, and created markup layers. You then save your work as a .vf session file.
When you re-open the session file, the three files open, and the snapshots, background colors, and
markup layers appear as they were when you saved the session.
Session files reference primary and secondary documents. A session file can preserve the state of
multiple primary documents, and each primary document may be associated with multiple secondary
documents.
In terms of session files, product structure is considered to be either static or configured. Static product
structure is a unique version of the document that is created at the time the session is saved. This type
of data ensures that loading the session at a later time will result in the same product structure that was
loaded when the session was first saved. Configured product structure is dynamic and references
Teamcenter configuration settings. This type of data can be thought of as a recipe which can be used
later to get different document revisions.
You have a number of options for saving session data to different locations, depending upon whether
the session consists of local data only or includes data from Teamcenter.
If the session includes only data loaded from your local machine, you can save the session to a location
on your local machine or network.
If the session includes Teamcenter-managed data, you can save the session to the Teamcenter server in
the following ways:
• Attach to Base Document - Save the session within the item revision of the primary document.
• Attach to Selected Bomline - Save the session within the item revision of the selected BOM line in
the 3D assembly tree.
• Alternate Location - Save the session to a different location. Click Browse, and then specify the
folder, item, or item revision within which you want to save the session.
Note:
You can use the Teamcenter Integration Session preferences to specify default session save
options.
A primary document:
• Consists of data that has been translated from some master source data such as a CAD file.
• Consists of one file (for example, a 2D image) or a logical set of files (for example, assembly and part
files).
• May have secondary types of documents that depend on it, but may not be aware of these secondary
files.
A secondary document:
• May contain many types of data which may serve different purposes (for example, a snapshot consists
of layer data, view data, motion data, thumbnail data, and so forth).
Configured structure
• From My Teamcenter, launch a BOM view or BOM view revision (or any object that includes a BOM
view or BOM view revision, such as an item or item revision) into the stand-alone viewer or the
Lifecycle Viewer. The structure is configured in the viewer according to your default revision rule.
• From the stand-alone viewer, open a BOM view or BOM view revision (or any object that includes a
BOM view or BOM view revision, such as an item or item revision). The structure is configured in the
viewer according to your default revision rule.
• From Structure Manager, Multi-Structure Manager, or Manufacturing Process Planner in the rich client,
launch one or more BOM lines into the stand-alone viewer or the Lifecycle Viewer. The structure is
configured in the viewer according to whatever configuration is currently active in the launching
application.
Static structure
• Perform any process that results in opening a PLM XML file in the stand-alone viewer or the Lifecycle
Viewer. For example, launching a QL file or a DirectModelAssembly dataset results in the loading of a
PLM XML file into the viewer. The viewer treats these data types as static structure, since a session file
authored in the viewer references the static PLM XML.
• Open a VF session file that points to static PLM XML. This occurs under the following conditions:
• The Capture Static Structure check box is selected when the session file is authored.
• The structure in the viewer is saved as PLM XML (File→Save As) before the session is authored.
Opening a session dataset can result in the loading of a static structure or a configured structure,
depending upon the data and the conditions under which the session authored.
When you save a session referencing configured structure, the session preserves the product structure
configuration active in the viewer. However, if you select the Capture Static Structure check box in the
Session Save As dialog box, the viewer also saves the exact product structure you have open at the time
you save the session. When you load the session later, the viewer detects if this static structure is
available and asks you how you want to open it: as a static structure (the exact product structure that
was active in the viewer at the time the session was saved) or a configured structure (according to the
configuration settings in effect at the time the session was saved). Note that if the Capture Static
Structure check box is not selected when you initially save the session, when you open the session later
the structure is loaded dynamically based on the configuration in effect at the time the session was
saved.
You can set a Teamcenter Integration Preference to automatically handle this when loading a session.
You can choose to:
• Always load the configured structure (the latest version of the structure according to the
configuration settings in effect at the time the session was saved)
Under certain conditions, warning messages display when saving legacy session files (release 12.4 and
earlier). To avoid overwriting the legacy session file, which will cause issues with legacy viewers, on the
warning dialog click Save as and choose a different file location to create a new session file.
Note:
If you want updated layers to be saved as external files, save the layers first using Save All Layers
or Save Selected Layers. If you don't save modified layers before saving the session, the layers
become part of the session file and cannot be loaded independently.
3. To rename the session file or any secondary documents that you have created during your work
session and not yet saved, such as markup layers, double-click the default name of the document
and type a new name.
Note:
You cannot use any non-ASCII character (including 8 bit accented Western European and
multi-byte characters) for a file name.
4. Click Save.
The session file is saved. Any new or unsaved secondary documents are also saved with the session
file to their specified locations.
Note:
• If you have unsaved clearance results, the Save Clearance Results As dialog box appears.
You must save to a .txt file to reference the results in a session file.
• If late loading product views are enabled, and the Vis_PV_LateLoadSaveOp preference is
set to Ask, a dialog box appears in which you must choose how to handle saving partially
loaded product views.
If the sessions can be merged, the Merge Sessions dialog box appears.
3. Click Merge.
The saved session is merged with the contents of the active session.
2. In the Session Preferences dialog box, change any of the following settings:
In this
section Use this preference To
Session Reuse existing When opening a session while another session is active,
Merge windows if possible merge the sessions in the active Viewing window.
Note:
If this option is not turned on, the sessions are
opened in separate Viewing windows.
3. Click OK.
• 2D snapshots
Used to capture the state of the 2D Viewing window when working with 2D images. You can create
and view 2D snapshots in the stand-alone viewer, the Lifecycle Viewer, Manufacturing Process
Planner, and Multi-Structure Manager. When created in the stand-alone viewer or the Lifecycle
Viewer, 2D snapshots are persisted in session files and PLM XML, or saved to the Teamcenter server as
Vis_Snapshot_2D_View_Data datasets. When created in Manufacturing Process Planner or Multi-
Structure Manager, 2D snapshots are saved as Vis_Snapshot_2D_View_Data datasets.
• 3D snapshots
Used to capture the state of the 3D Viewing window when working with 3D models. You can create
and view 3D snapshots in the stand-alone viewer and the Lifecycle Viewer. 3D snapshots are persisted
in session files and PLM XML only.
• Product views
Used to capture the state of a 3D scene in Teamcenter. You can create product views in the Lifecycle
Viewer, the stand-alone application viewer, Manufacturing Process Planner, Multi-Structure Manager,
and Structure Manager. You can open product views in all these viewers. When you create product
views, you save them as a SnapShotViewData dataset.
When you send a product view to the Lifecycle Viewer or open it in the integrated viewer, you can
then modify the product view (modify the existing product view, add a new one, or update the
existing product view) and save it as a dataset in Teamcenter.
Teamcenter supports opening and modifying product views in Lifecycle Viewer or in the integrated
stand-alone application viewer. You can also save product views to Teamcenter. Product views include
views of the assembly or part that may include markups, updates to part color, part repositioning, and
motion 3D snapshots (created using NX).
You can create, modify, and save Teamcenter product views in the following Teamcenter applications:
These include Manufacturing Process Planner, Multi-Structure Manager, and Structure Manager.
• My Teamcenter
For Teamcenter applications that support the Product View Gallery, you can send the product view to
the Lifecycle Viewer or to the integrated stand-alone application viewer. You are given a choice to open
the product view as a static structure or live structure. You can then manage the product view, for
example by adding markups, changing the view, adding new product views, and updating the product
view. You can also right-click in the Snapshot page and select Save as Teamcenter Product View to
create a new snapshot in Teamcenter.
The Product View Gallery is supported by Structure Manager, Multi-Structure Manager, and
Manufacturing Process Planner.
When you work with product views in the Product View Gallery, you can:
• Send one product view from the Product View Gallery to the Lifecycle Viewer or to the integrated
stand-alone application viewer.
• Send several product views to the Lifecycle Viewer or to the integrated stand-alone application
viewer, once you have configured the Enable Multiple Select in Product View Gallery.
• Merge them into the active document or open them in a new viewing window from either the
Teamcenter Attachment panel or the Product View Gallery.
Note:
You can only merge the product views that share the same base structure.
You can open, update, and save an existing product view from My Teamcenter in the Lifecycle Viewer or
in the integrated stand-alone application viewer.
If you save a session, the open product views are converted to 3D snapshots, and saved in the session
without reference to the Teamcenter product view datasets.
When product views are saved, they capture the following minimum information:
• The configuration that was applied to the structure at the time the product view was captured.
• The view state data (for example, markups, cross sections, repositioned component transforms, and
so forth).
You can control how the structure is opened and configured before you apply the viewing data.
You can load and apply product views with three different behaviors:
• As static structure.
When you open the static structure, you open the static capture of the visible product structure at the
time it was saved. The structure is pruned to show only the visible lines at the time of capture. You
can use this product view option when you need to be sure the exact captured 3D scene is
reproduced. You open a product view in a static structure by opening it in the My Teamcenter view
panel, or by sending a product view from My Teamcenter to the Lifecycle Viewer or to the integrated
stand-alone application viewer and selecting the static structure load option.
Note:
Parts may appear in incorrect positions when product views authored in the Lifecycle Viewer or
the stand-alone application viewer are restored in certain Teamcenter embedded viewers. This
problem occurs when the motion system records part transformations on subassembly nodes, and
the transformations are subsequently captured by the product view. These assembly-level
transformations generated by the motion system are not applied correctly when the product view
is restored in Structure Manager, Multi-Structure Manager, and Manufacturing Process Planner.
You can avoid this limitation by keeping 3D part transformations at the part level when working
with motion in the Lifecycle Viewer or the stand-alone application viewer. Rather than
transforming an entire assembly or subassembly, expand the structure and select all of the
individual parts and move them instead.
You can change several product view and product view related characteristics using Teamcenter product
view preferences. You can access product view preferences by navigating to the Teamcenter Options
menu; choose Edit→Options→Visualization→Product View.
Product view preferences are now centralized and changes to these characteristics can also be made by
using Teamcenter preferences. Your site administrator can also set preference protection scope for
product view preferences to USER (the default), GROUP, or SITE.
Note:
If the protection scope is set to GROUP or SITE, preferences are displayed but you may not have
permission to change them.
For more details about setting product view preferences using the Options menu, see Option
reference in Teamcenter Basics.
For more details about working with product views in Teamcenter, see Working with product
views in Structure Manager Guide.
Using Teamcenter, you can set product view options to show or hide unconfigured objects by selecting
or clearing view toggle states. When you send the product view to the viewer, these unconfigured
objects are shown or hidden as they were shown or hidden when the product view was captured. You
can set view toggle state preferences in Teamcenter by navigating to Edit→Options→Product View.
The captured product views may result in active view toggles that generate non-buildable assembly
configurations. To control the creation of non-buildable product views, your administrator may prevent
generating product views when certain unconfigured objects exist. In addition to preventing the
creation of toggle view states, the administrator can also choose to warn or process product views which
contain unconfigured data.
If you choose to update the configuration from the product view when you reopen it, the saved view
selections are retrieved; if you choose to use the current configuration, the saved view selections are
ignored.
The administrator can set preferences to determine how product views are created when unconfigured
objects are shown. The administrators options include the following:
• Off
• Warning
Note:
In the Invalid assembly state dialog box that appears, a message indicates that active view
toggle states were detected. You can then choose to proceed with product view creation or
modification or you can cancel the task.
• Prevent
Note:
In the Invalid assembly state dialog box that appears, a message indicates that active view
toggles were detected. You are asked to turn off active toggles in order to proceed with product
view creation or modification.
Caution:
You use the view toggle Show Suppressed Occurrences to see BOM lines that are suppressed in
the current assembly arrangement in Structure Manager. If you send an assembly to the stand-
alone application viewer or the Lifecycle Viewer when this view toggle is on, the suppressed
structure elements are grayed out. An inactive structure warning appears when you open a
product view that contains suppressed occurrences. This can be avoided if you choose the
appropriate View Toggle Warning Level for product view creation and then select Show
Suppressed Occurrences from Edit→Options→Product View.
For more details about working with view toggle states in Teamcenter, see Manage unconfigured data
in a product view in Manufacturing Process Planner Guide.
You can enable late loading of Teamcenter product views, by using the Vis_PV_AllowLateLoading
preference. Late loading is useful to reduce the time it takes to load a large number of product views at
once in stand-alone Lifecycle Visualization. A late loaded product view appears as a thumbnail on the 3D
Snapshots page, but the entire product view is not loaded until you fully open the product view by
applying the 3D snapshot.
When late loading is enabled, you can set how partially loaded product views are handled when you
save a session file or a PLMXML file. You do this by setting the Vis_PV_LateLoadSaveOp preference with
one of these values:
• Abort
When late loaded product views are detected, the save operation is aborted.
• Ignore
The file is saved, but partially loaded product views are not included.
• LoadAll (default)
All partially loaded product views are loaded and saved.
• Ask
When you save a session file or a PLMXML file and late loaded product views are present, a dialog box
appears and provides these options:
• Load all partially loaded product views and save the file.
You create product views in Teamcenter using the Product View Gallery. Product views can then be
sent to the Lifecycle Viewer or to the integrated stand-alone application viewer.
Note:
Product and manufacturing information (PMI) may not appear in a viewer if the model was saved
in a Teamcenter product view and then the dimension of the object was changed in a CAD
program in a way that changed the PMI. When this occurs, the caption PMI Missing appears for
any PMI that cannot be restored. (The text of this caption may differ depending on how the
caption is defined on the Snapshots tab in the PMI Preferences dialog box.) Also, you may need
to zoom out to see the caption.
You can:
• Open product views from the Product View Gallery or Attachment panel. The current
configuration of the structure in the launching program is loaded in the viewer when you apply the
product view.
• Open product views from My Teamcenter. You are given the option to open the product view as a
static structure or dynamic structure.
• If you elect to open the product view as a static structure, the exact structure that was saved with
the product view is reloaded and applied.
• If you select to open the product view as a dynamic structure, the as-saved configuration of the
structure when last saved is applied when the product view is applied.
• Open an NX motion product view. In this case, you open a product view that contains motion and
that was authored by NX.
Note:
You can enable late loading of product views, by using the Vis_PV_AllowLateLoading preference.
Late loading is useful to reduce the time it takes to load a large number of product views at once
in stand-alone Lifecycle Visualization. A late loaded product view appears as a thumbnail on the
3D Snapshots page, but the entire product view is not loaded until you fully open the product view
by applying the 3D snapshot.
Open product views from the Product View Gallery or Attachment panel
You can open product views from a Teamcenter application that supports the Product View Gallery and
open them in the Lifecycle Viewer or in the integrated stand-alone application viewer. You can also open
product views from the Teamcenter Attachment panel.
You are given a choice to open the product view in a live structure (dynamic) or in an as-saved
configuration (static).
Teamcenter applications that support the Product View Gallery include Structure Manager, Multi-
Structure Manager, or Manufacturing Process Planner.
1. From Structure Manager, Multi-Structure Manager, or Manufacturing Process Planner, do one of the
following:
3. If Create 3D Product Views toolbar is not visible, right-click in the viewer menu bar and choose
Create Markup.
Teamcenter displays the Product View Gallery window, which contains thumbnails of any
previously saved product views that are associated with the selected object.
5. Right-click any product view thumbnail and select one of the following:
6. To configure the software to open more than one product view at a time, do the following:
Right-click in the lower portion of the Product View Gallery dialog box, for example near Cancel.
Press Ctrl and click each product view you want to open in the viewer.
In the 3D Load Options dialog box that appears, select Open in a new window or Merge into
active window.
Note:
• The option to merge is only available if the new 3D product view shares a base
structure with the document that is already open.
• If you selected Merge into active window, you are asked once again to confirm the
merge. Additional product structure occurrences automatically open in the active
window.
• If you open product views from the same assembly one at a time, the 3D Load
Options dialog box appears giving you the choice to open each product view in a
new window or to merge it into the active window.
You can send existing product view datasets from My Teamcenter to the Lifecycle Viewer and the
integrated stand-alone application viewer.
To Do this
Send the product view to the Right-click the product view and select Send To→Lifecycle
Lifecycle Viewer Viewer.
Send the product view to the Highlight the product view and do one of the following:
integrated stand-alone
application viewer • Choose File→Open In Lifecycle Visualization.
3. If the Product Structure dialog box appears, select one of the following:
You use NX to create product views that contain motion. After you save the motion product view into
Teamcenter, you can open the product view in the Lifecycle Viewer or in the integrated stand-alone
application viewer. You can play motion files forward or backward, jump to a specific frame, fast
forward, rewind, and repeat the animation.
Note:
You cannot save a motion product view to Teamcenter from the Lifecycle Viewer or in the
integrated stand-alone application viewer. You cannot update a product view that was saved by
NX to preserve the interoperability with NX. You can, however, create a new product view after
you open a motion product view.
1. From a Teamcenter application that supports the Product View Gallery, create a view you want to
capture in the Viewer window.
Teamcenter displays the Product View Gallery window, which contains thumbnails of any
previously saved product views that are associated with the selected object.
You can create a product view on a structure that you opened in the Lifecycle Viewer or in the integrated
stand-alone application viewer. You can also update or create a new product view from an existing
product view as long as you opened it as a dynamic structure.
1. Send a dynamic structure to the Lifecycle Viewer or the integrated stand-alone application viewer,
or send a product view and open it with dynamic structure.
2. From the viewer, adjust the orientation, add a markup, or make changes to the view of the model.
You can update or replace an existing product view that you have opened in the Lifecycle Viewer or in
the integrated stand-alone application viewer.
There are situations where product views cannot be updated or replaced, including the following:
• NX-generated Teamcenter product views, including all product views with motion.
• Non NX-generated Teamcenter product views where a 3D document has been inserted into the
resulting view.
• Teamcenter product views that are checked out by another application or user.
• Teamcenter product views that are already opened by this viewer (e.g. load the same snapshot a
second time by either merging it into the same view or opening it in a new view in the same viewer).
1. Send an existing product view to the Lifecycle Viewer or in the integrated stand-alone application
viewer and open it as a dynamic structure.
2. From the viewer, adjust the orientation, add a markup, or make changes to the view of the model.
3. In the Snapshots page, right-click the product view and select Update or Replace.
Note:
Using Replace is similar to deleting and recapturing a snapshot. The 3D elements captured in
the snapshot reflect the current Snapshot Preferences.
Using Replace also recaptures the thumbnail image displayed in the Snapshots view. The
name of the snapshot is retained.
Note:
Using Update recaptures the 3D elements that are present in the snapshot. For 3D content to
be updated, the appropriate preferences must be active in the Snapshot Preferences. Only
preexisting 3D elements within the snapshot are modified. 3D elements not enabled in the
preferences when the snapshot was initially generated are not created.
Using Update also recaptures the thumbnail image displayed in the Project Workspace
window Snapshots view.
You can update or save new dynamic product views to Teamcenter. The product view is saved as a
SnapshotViewData dataset. You select the BOM line in the product structure for the location to attach
the saved product view to. If you do not select a BOM line, the top node in the product structure is
automatically used.
There are situations where product views cannot be created so the Save as Teamcenter Product View
and Send View to Structure Manager options are disabled. You cannot create a product view in the
following situations.
• Load dynamic assembly from Teamcenter and insert another unrelated assembly or part.
• 2D
Note:
Saving a product view from Lifecycle Visualization to Teamcenter when the product is displayed in
Massive Model Visualization (MMV) mode may take additional time to complete. This is due to the
potential need to expand portions of the product structure. When product structure is loaded in
MMV mode, the occurrence paths of the visible parts are not fully expanded. Due to the data
model used by Teamcenter product views, the application must expand the occurrence path to all
visible parts.
2. Create a new product view, add an additional product view, or update an existing product view.
3. On the Snapshots page, right-click and select Save as Teamcenter Product View.
4. Do one of the following in the New Teamcenter Product View Dataset dialog box:
• Accept the system name for the product view by clicking OK.
• Type in a name in Enter name for new Product View dataset and then click OK.
You create several different product views and you want to save them back to Teamcenter in the exact
viewing state they were created in. Use the following steps to save several product views.
3. On the Snapshots page, highlight the first product view, then double-click.
4. On the Snapshots page, right-click and select Save as Teamcenter Product View.
5. Repeat Step 4 for each product view that you want to save in the initial viewing state.
Example:
You open data and create three product views. The first is a circle, the second is a square, and the
third is a triangle.
If you highlight the first product view, right-click and select Save as Teamcenter Product View,
you will save the product view with the triangle (the current view) when you expected to save the
product view with the circle.
If you highlight the first product view, double-click, and then right-click and select Save as
Teamcenter Product View, you save the product view with the circle.
Highlight the product view with the square, double-click, and then right-click and select Save as
Teamcenter Product View, you save the product view with the square.
You may find it useful to capture an image of your product view when working with various issues
encountered in the design and manufacturing process. For publishing, creating 3D geometry assets of
the product view may be beneficial. A 3D geometry asset is data that is included in illustrations and
publishing. You must have Visio in order to work with 3D geometry assets.
The appearance of the captured image and 3D geometry assets is determined by you and by your site
administrator. Your site administrator controls whether or not these options are available.
If these features are made available by the administrator, you can set preferences for them using the
Snapshot tab of the Teamcenter Integration Preferences dialog box.
You can save 3D geometry assets in the Teamcenter product view dataset if 3D geometry assets are
available in your environment.
Note:
Creating 3D geometry assets is only supported on Windows.
2. From the Snapshot tab of the Teamcenter Integration Preferences dialog box, select the Add or
Update 3D Geometry Asset check box.
3. (Optional) Select the Draw Outline check box if you also want to save an outline capture in the
Teamcenter product view dataset.
Tip:
One way to verify the saved 3D geometry asset is to use the Teamcenter Named References
dialog box.
a. Highlight the saved product view in My Teamcenter, right-click and select Named
References.
b. Highlight 3DGeoAsset and click Download. Choose the name and location on your local file
system to save the file.
You can save captured images in the Teamcenter dataset If image capture is available in your
environment.
2. From the Snapshot tab of the Teamcenter Integration Preferences dialog box, select the Image
Capture check box.
3. (Optional) Select the Use Image Export Dialog check box if you want the Export Image dialog box
to appear. You can use this dialog box to change the resolution, file type, or color mode of the
image capture.
Tip:
One way to verify the saved image capture is to use the Teamcenter Named References dialog
box.
a. Highlight the saved product view in My Teamcenter, right-click and select Named
References.
b. Highlight Image and click Download. Choose the name and location on your local file system
to save the file.
You or your site administrator can use system constraints and site preferences to control the appearance
and behavior of thumbnails, image captures, and 3D geometry assets.
Thumbnail • Vis_PV_ThumbnailWidth
• Vis_PV_ThumbnailHeight
• Vis_PV_thumbnailQuality
Image Capture • Vis_PV_ImageCaptureWidth
• Vis_PV_ImageCaptureHeight
• Vis_PV_ImageCaptureType
• Vis_PV_ImageCaptureResolution
3D Geometry Asset • Vis_PV_capture3DGeomAssetAsOuline
Thumbnail • Vis_PV_ThumbnailWidth
• Vis_PV_ThumbnailHeight
• Vis_PV_thumbnailQuality
Image Capture • Vis_PV_ImageCaptureWidth
• Vis_PV_ImageCaptureHeight
• Vis_PV_ImageCaptureType
• Vis_PV_ImageCaptureResolution
3D Geometry Asset • Vis_PV_capture3DGeomAssetAsOuline
• OffNoMenus
• OnNoMenus
• OnWithMenus
3D Geometry Asset The Fnd0VisPVGeoAsset constraint determines if saving 3D geometry
assets is available. The values for it are:
• OffNoMenus
• OnNoMenus
• OnWithMenus
Teamcenter supports creating and saving several 2D snapshots over time so you can track and review
changes that have been made. For example, you may want to compare various components of a design
today with changes made during the manufacturing lifecycle. Teamcenter supports tracking these
changes with the 2D Compare option, which is a tool supported by several Teamcenter applications
including Manufacturing Process Planner and Multi-Structure Manager. These applications also support
the Snapshot Gallery, and snapshots must be stored in this gallery before you can use 2D Compare.
You can send either an item revision (base document) or a previously saved snapshot (derived data)
from Teamcenter to the Lifecycle Viewer. You can also open an item revision or previously saved
snapshot in the Lifecycle Visualization viewer when it is integrated with Teamcenter. If the matching
base document is not open, the viewer opens the base document and inserts the snapshot. The viewer
immediately applies the snapshot layer to the view. When the base document is open, you may be
prompted to open this document in a new window or insert it into the existing view. Teamcenter
supports sending item revision and snapshot data from My Teamcenter or from the Snapshot Gallery.
Once the Teamcenter item revision or previously saved snapshot is displayed in the viewer, you add
markups and then create a snapshot of a specific area of the image. You save the snapshot in
Teamcenter, and it is associated with the Teamcenter item revision.
While you can send 2D snapshot item revisions from Teamcenter applications such as My Teamcenter,
Manufacturing Process Planner, and Multi-Structure Manager, snapshots must be in the Snapshot
Gallery to use 2D Compare tools.
The viewer opens. If Ask at load time is turned on in the 2D Load Options, the Load Option
dialog box is displayed.
Note:
If the Load Option dialog box is not displayed, the dataset is loaded according to the current
Load Options settings.
2. (If the 2D Load Options dialog box is displayed) Click one of the following options:
Note:
Markup layers appear in the 2D assembly
as snapshot layers. The snapshot layer is
locked so you can review changes to
future snapshots.
Don't show this dialog again Always use the current settings without
displaying the 2D Load Options dialog box.
3. Zoom into the image or pan the image and do one of the following:
Note:
The snapshot or snapshots that you created support features associated with standard 2D
snapshot options. For example, these options include adding, inserting, deleting, and
naming snapshots.
When you save the image as a Teamcenter snapshot, the snapshot is locked and cannot be
edited.
1. Display the item revision that includes a base image in a viewer and add both a markup and
snapshot.
The snapshot is displayed in the Snapshots view.
2. Right-click anywhere in the Snapshots view and select Save as Teamcenter Snapshot.
The snapshot is saved to your Teamcenter server. The border is now wider than a non-Teamcenter
snapshot and the snapshot is automatically named.
Note:
• The Teamcenter snapshot cannot be edited and all shortcut menu options are unavailable
except for Add.
• Because the snapshot is locked, you can create future snapshots to display changes to the
design.
3. (Optional) If prompted, complete the revision, page, and custom attribute values in the Form Data
dialog box.
The Revision and Page values are auto-filled. Add appropriate custom data, as needed.
Note:
Optionally, you can save the Teamcenter item revision and snapshot as a session. The session
contains all data associated with this session and saves it as one file. When you open the session
later, your work is restored.
In the following example, the 2D image of a garage door assembly is used. The image is shipped with
Teamcenter and is saved in the 2D example folder.
Note:
• This example describes how you create and save a Teamcenter snapshot, and it includes
opening the item revision in Lifecycle Visualization, adding a markup, and adding a snapshot of
the image. The final step is to save the snapshot back to Teamcenter.
• To realize the full benefit of comparing snapshots, use Teamcenter applications such as
Manufacturing Process Planner and Multi-Structure Manager because these applications
include storing snapshots in the Snapshot Gallery. When snapshots are stored in the Snapshot
Gallery, the 2D Compare feature is available.
3. Create a 2D markup.
4. Zoom and pan the image until you are satisfied with the section for your snapshot.
In this example, the area of focus is the part displayed in the following graphic.
Note:
Because the snapshot layer locks the image, the image cannot be modified. Future snapshots
can then be compared to this image.
6. From the Snapshots view, right-click and choose Save as a Teamcenter Snapshot.
When the snapshot is saved to Teamcenter, the snapshot border is wider than non-Teamcenter
snapshots. This feature makes it easier to identify both Teamcenter and non-Teamcenter
snapshots. Also, the snapshot is automatically given a name. You can view the name by moving
your cursor over the snapshot.
Note:
• Before you save the snapshot to Teamcenter, notice that all shortcut menu options are
available.
• When you save the snapshot to Teamcenter, all shortcut menu options are unavailable
except for Add and the name of the snapshot.
You can display visualization data associated with 4GD worksets as a flat list of design components or in
the context of their hierarchy.
Subsets may have an active/viewed partition scheme, which logically organizes sets of design
components into a hierarchy. When you view 4GD worksets, you can interactively set the partition
scheme to view per subset.
Note:
Lifecycle Visualization supports viewing configured worksets only. You cannot open other 4GD
objects, such as individual design components or subsets.
Note:
You can specify to open 4GD worksets as new documents or to insert worksets into the active
Viewing window as a new model in the assembly tree. You cannot merge 4GD worksets in
Lifecycle Visualization.
3. To send 4GD worksets into stand-alone Lifecycle Visualization from My Teamcenter or 4GD
Designer, do any of the following:
• On the 4GD Designer Content Explorer toolbar, click Start/Open In Lifecycle Visualization .
Note:
By default, these options are hidden, but you can show the user interface for sending data
into the stand-alone application viewer.
4. To send 4GD worksets into the Lifecycle Viewer from My Teamcenter or 4GD Designer, right-click a
workset, point to Send To, and select Lifecycle Viewer.
2. On the 3D Loader tab of the Teamcenter Integration Preferences dialog box, in the Product
Structure section, select Configure an updated structure.
3. From the Update Subset on load list, select one of the following:
• No Update
Use this option if you want to load subsets without replaying the subset recipes.
• Replay Recipe
Use this option if you want to replay subset recipes before loading the data. This ensures that
you obtain the latest data.
4. Click OK.
Note:
When you update this preference, the changes are applicable only for data subsequently
launched into Lifecycle Visualization. There is no effect on worksets currently open in the
viewer.
1. In the stand-alone application viewer or the Lifecycle Viewer, open and display a 4GD workset
containing visualization data.
b. In the Assembly Preferences dialog box, select the Show subset structure check box.
c. Click OK.
b. Right-click the subset(s) for which you want to display presented parents.
3. In the assembly tree, expand the presented parents to reveal nodes for the subset’s design
component members. Presented parents that are not members of the subset are represented by a
icon, while presented parents that are members of the subset are represented by a icon.
4GD data displayed with presented parents that are not also members of the subset
Worksets usually consist of one or more subsets, and subsets may contain partitions, which logically
organize sets of design components into a hierarchy. Partition schemes contain attributes that specify
the characteristics of a collection of partitions. When you view 4GD worksets, you can choose the
partition schemes to apply per subset.
When you open and display a 4GD workset in the stand-alone application viewer or the Lifecycle Viewer,
partitions display in the assembly tree per each subset's active partition scheme.
Partitions are optional organizational containers for design components and may be empty. Design
components may be members of one or more partitions or no partition.
• You highlight partitions to select all the design components they contain.
Partitions are not selectable occurrences that define the position of design components. When you
click a partition line in the assembly tree, the partition line is highlighted (light blue) but not selected.
However, all the child design components the partition contains are selected (dark blue).
By default, empty partitions are not shown in the assembly tree. You can set a preference to show
empty partitions, which is effective for all for subsequently loaded documents. If shown, empty
partitions are identified in the assembly tree with a gray filled visibility control check box, as they
contain nothing to display.
3. In the Partitions section, select the Show empty partitions check box.
Display the properties of a partition to view information that is included in the file about the attributes
of the partition.
• Right-click the partition node in the assembly tree, and choose Properties.
Partition schemes contain attributes that specify the characteristics of a collection of partitions. When
you view 4GD worksets, you can choose the partition schemes to apply for each subset. You set the
partition scheme to be applied to all subsets, and you can apply partition schemes to individual subsets.
You can set a preference to apply active partition schemes to all subsets, for the opened document
and any subsequently loaded documents. Active partition schemes are the default schemes set on
subsets in the Subset Defaults attribute group under Viewed Partition Scheme in Teamcenter. For
subsets that do not have an active partition scheme defined, no partitions are shown when the
subsets are loaded.
Note:
If you select this preference, the partition scheme setting for all subsets is overwritten. Any
partition schemes you have selected on individual subsets are cleared and the subset reverts to
showing its active/default partition scheme, or no partition scheme if an active partition scheme
is not defined for a subset.
2. In the Assembly Preferences dialog box, select Show active partition scheme.
3. Click OK.
2. Right-click the subset(s) for which you want to set the partition scheme.
3. Choose 4GD Subset→Partition Scheme, and choose the partition scheme from the list. The
currently active/viewed partition scheme is disabled in the list. To apply no partition scheme,
choose None.
2. In the Session Save As dialog box, in the Session Storage Location section, select one of the
following options:
Note:
The Attach to Selected Bomline option is unavailable for 4GD subsets and design
components.
• Alternate Location
Save the session to a different location. Click Browse, and then specify a save location.
3. Select the Capture static structure check box to capture the current state of the document
structure as a PLM XML file.
Note:
To load the PLM XML file and restore the capture document state when you open the session,
you must specify Load static structure (structure at time of save) in the Teamcenter
integration preferences.
4. Click Save.
2. In the Session Save As dialog box, in the Session Storage Location section, select Alternate
Location.
3. Click Browse and select the folder where you want to save the file.
In the Files section, the Package column appears with a check box for each document in the
session.
5. For each document that you want to include in the session package, ensure the check box is
selected.
6. Select the Capture static structure check box to capture the current state of the document
structure as a PLM XML file.
Note:
To load the PLM XML file and restore the capture document state when you open the session,
you must specify Load static structure (structure at time of save) in the Teamcenter
integration preferences.
7. Click Save.
• You can open full worksets only. Other 4GD objects are not supported, including design components
outside of the context of a workset and product designs.
• Exporting to and importing from a PLM XML file does not support partition related information.
• Active/viewed partition schemes applied to individual subsets are not included in snapshot data.
• Opening individual design components or subsets within a workset are not supported.
• You cannot attach a session file to a selected subset or design component structure line.
• You can create 3D markups when visualizing 4GD worksets, but you must use session files to save the
markups in Teamcenter. Individual VPL datasets are not supported in the context of worksets.
• Cacheless searches are not supported with 4GD workset data. This includes Teamcenter Scoping for
visual reports and the Teamcenter filtering option available on various filter types.
• Visualization of the following advanced NX assembly operations in the context of a workset is not
supported:
• Assembly arrangements
• Promoted geometry
• Overrides (geometry, position, attributes) on reused design components within a product design
Visual issues consist of an issue report and an issue report revision, along with an automatically
generated product view, 2D snapshot, or session file. When reviewers send an issue report revision to
the stand-alone viewer or the Lifecycle Viewer, the visualization data associated with the issue is
displayed in the same state it was in when the issue was created.
Use the following Teamcenter preferences to configure the stand-alone viewer to work with Teamcenter
visual issues:
You must use the Teamcenter ManagedIssueList preference to specify the URL where the issues list will
display. When you choose Review tab→Issues group→View Issues List in the stand-alone viewer,
the browser launches and displays the default list of visual issues.
Example:
http://10.200.30.400:7001/awc?TC_file=search/issuelist.html
6. Click Modify.
The preference is saved.
8. In Teamcenter, select an item revision that includes visualization data, and choose File→Open in
Lifecycle Visualization.
Teamcenter sends the visualization data to the stand-alone viewer.
Note:
The default visual issues list includes all of the issue report revisions that have been created.
Alternatively, you can use a Teamcenter saved search to display only visual issues that
match predefined search criteria.
You can use a Teamcenter saved search to filter the visual issues list according to your specified criteria.
3. In the Change Search dialog box, expand System Defined Searches, and then select IssueReport
Revision.
4. Click OK.
The issue report revision search options are displayed.
5. Construct your search by specifying criteria such as Issue Category and Issue Assignee.
6. At the top of the Search view, click Add Search to My Saved Searches .
7. In the Add Search to My Saved Searches dialog box, type a name for the search, and then click
OK.
The search is saved.
8. Choose Edit→Options.
Teamcenter issue reports are used to capture and manage design problems. When you create a visual
issue in the Lifecycle Viewer or the stand-alone viewer, the state of the viewer is captured by a 2D
snapshot, product view, or session file, which is automatically attached to the issue. When reviewers
open the issue in the viewer, the associated visualization data is displayed for evaluation.
• Understand the conditions under which different types of visualization datasets (2D snapshots,
product views, or session files) are generated and attached to visual issues.
• Create a single visual issue in the Lifecycle Viewer or the stand-alone viewer.
When you create a visual issue in the Lifecycle Viewer or the stand-alone viewer, the state of the viewer
is captured by a 2D snapshot, product view, or session file, which is automatically attached to the issue.
The type of visualization dataset generated and associated with the visual issue varies depending upon
these factors:
If any of these conditions are not met, a session file is created instead of a product
view.
Session file A 2D image or 3D model is the active document in the viewer.
You can create Teamcenter visual issues in the Lifecycle Viewer or the stand-alone viewer.
1. From Teamcenter, send an item revision that includes visualization data to the Lifecycle Viewer or
the stand-alone viewer.
Tip:
Any changes you make to the state of the Viewing window are preserved by the visual issue,
including markups, measurements, and part or layer visibility.
Note:
Issue Report is the default issue type. Your organization may also allow you to choose from
additional issue types.
6. In the Data Type for state information section, choose how you want to capture the state of the
viewer:
• Session File
7. Click OK.
The Issue Attribute Dialog appears, displaying the available attributes.
c. Double-click any of the other attributes to add information relevant to the issue.
d. Click OK.
Note:
Depending upon the Teamcenter Integration Snapshot Preferences, you may need to
specify other information for a 2D snapshot or provide a name for a product view.
The viewer creates an issue report and an issue report revision, along with a 2D snapshot,
product view, or session file.
B. In the dialog box that asks you if you want to create a session file, click Yes.
A session file is created and attached to the visual issue.
You can create Teamcenter visual issues from 2D or 3D snapshots. If you have multiple snapshots, a
separate issue report is created for each selected snapshot.
1. From Teamcenter, send an item revision that includes visualization data to the Lifecycle Viewer or
the stand-alone viewer.
3. Select each snapshot from which you want to create a visual issue. For multiple selections, hold Ctrl
as you click each snapshot.
Tip:
Selected snapshots have a green border.
Note:
Issue Report is the default issue type. Your organization may also allow you to choose from
additional issue types.
7. In the Data Type for state information section, choose how you want to capture the state of the
viewer:
• Session File
8. Click OK.
The Issue Attribute Dialog appears, displaying the available attributes.
c. Double-click any of the other attributes to add information relevant to the issue.
d. Click OK.
e. If you selected multiple snapshots, the Issue Attribute Dialog appears for each snapshot. Add
information relevant to the issue, and click OK.
You can create Teamcenter visual issues from clearance results. A separate issue is created for each
specified result.
1. From Teamcenter, open a 3D model in the Lifecycle Viewer or the stand-alone viewer.
3. In the Results list, select one or more clearance results. For multiple selections, hold Ctrl as you
click each issue.
Note:
Issue Report is the default issue type. Your organization may also allow you to choose from
additional issue types.
7. In the Data Type for state information section, choose how you want to capture the state of the
viewer:
• Session File
8. Click OK.
The Issue Attribute Dialog appears, displaying the available attributes.
c. Double-click any of the other attributes to add information relevant to the issue.
d. Click OK.
The Save As dialog box appears.
e. Type a name for the clearance results file, and click Save.
The clearance results file is saved to the database.
f. If you are posting multiple clearance results, the Visual Issue and Issue Attribute Dialog
dialog boxes are displayed again. Complete the steps described above for each issue.
A new visual issue is created for each clearance issue selected in the Results list.
You can manually attach 2D snapshots or product views to issue report revisions.
4. In the Paste Special dialog box, choose one of the following relations:
5. Click OK.
The dataset is attached to the visual issue.
Note:
When an issue report revision is launched into the Lifecycle Viewer or the stand-alone viewer,
only 2D snapshots or product views in the Snapshot Before Fix and Snapshot After Fix
folders, or session files in the Reference Items folder, are automatically opened in the
viewer. All other pasted visualization data must be manually opened.
When a Teamcenter visual issue is created in the Lifecycle Viewer or the stand-alone viewer, an issue
report revision is added to the database, along with an associated 2D snapshot, product view, or session
file. Issue report revisions are typically accessed using issue lists in Issue Manager. You can configure
issue lists to include only visual issues that match search criteria such as Issue Category and Issue
Assignee.
To access your issues, you can launch Issue Manager from within the Lifecycle Viewer. You can also
choose to display a list of issues from within the stand-alone viewer.
When you open a visual issue in the Lifecycle Viewer or the stand-alone viewer, the visualization dataset
associated with the issue is automatically opened and displayed. You can also expand the issue report
revision object from an issue list, manually select a visualization dataset, and send it to a supported
viewer. You can open 2D snapshots, product views, and session files in the stand-alone viewer or the
Lifecycle Viewer. You can also open product views in Structure Manager.
After opening a visual issue in the viewer, you can choose to update the associated visualization dataset
or delete the issue report revision object from the database.
To access visual issues in Issue Manager, you must use an issue list. You can configure your issue list to
include only issues that match specific search criteria.
1. In Issue Manager, in the Issue Home view, click Manage Issue Lists .
The Manage Issue Lists dialog box appears.
2. Click Add.
A new issue list is displayed.
7. Click Configure.
The Configure Search dialog box is displayed.
9. Click OK.
The Manage Issue Lists dialog box closes. In the Issue Home view, the new issue list is displayed.
Expand the issue list to access the issues matching your search criteria.
You can choose to display a list of visual issues from within the Lifecycle Viewer or the stand-alone
viewer.
In the stand-alone viewer, the configured browser displays the default list of visual issues. In the
Lifecycle Viewer, the Issue Manager opens.
Note:
By default, the visual issues list displayed in the browser includes all issue report revisions. You can
also specify to display a list of visual issues that match predefined search criteria.
You can create and save custom search queries to access visual issues in My Teamcenter.
3. In the Change Search dialog box, expand the System Defined Searches folder, and select
IssueReport Revision.
4. Click OK.
The IssueReport Revision search options are displayed.
Example:
In Issue ID, type IR* to display a list of every issue. To narrow the scope of the search, specify
additional search options such as Issue Category and Issue Assignee.
6. At the top of the Search view, click Add Search to My Saved Searches .
7. In the Add Search to My Saved Searches dialog box, type a name for the search.
The search is saved and listed in your My Saved Searches folder.
2. In the Change Search dialog box, expand the My Saved Searches folder, and select a saved
search.
3. Click OK.
The search is performed. If IssueReport Revisions matching your search query are found, they are
displayed in the Search Results view.
You can send an issue report revision, along with an associated visualization dataset, to the stand-alone
viewer and the Lifecycle Viewer.
• To send a visual issue to the stand-alone viewer, select the issue report revision, and choose
File→Open in Lifecycle Visualization.
• To send a visual issue to the Lifecycle Viewer, right-click the issue report revision, and choose Send
To→Lifecycle Viewer.
The visual issue opens in the viewer and the data is displayed in exactly the same state as it was in
when the issue was created or last updated. All 2D snapshots and product views with the Snapshot
Before Fix and Snapshot After Fix relations are displayed on the Snapshots tab of the Product
Workspace window (stand-alone viewer) or the Snapshots view (Lifecycle Viewer). A dashed border
around the thumbnail image indicates that a product view or 2D snapshot is associated with a visual
issue.
2D snapshot thumbnail in the stand-alone viewer Product view thumbnail in the Lifecycle Viewer
You can open Teamcenter visual issue attachments, including 2D snapshots, product views, and session
files, in the stand-alone viewer or the Lifecycle Viewer. You can also open product views in Structure
Manager.
Note:
For an overview of the visual issue folder structure, see Teamcenter visual issue
attachments.
• To send a visualization dataset to the stand-alone viewer, select the dataset, and choose
File→Open in Lifecycle Visualization.
• To send a visualization dataset to the Lifecycle Viewer, right-click the dataset, and choose Send
To→Lifecycle Viewer.
• To send a product view dataset to the Structure Manager, right-click the dataset, and choose
Send To→Structure Manager.
Depending upon your data and the Teamcenter Integration Visual Issue Preferences in the viewer, the
following types of visualization data may be generated automatically when Teamcenter visual issues are
created.
In the Lifecycle Viewer or the stand-alone viewer, you can save new snapshots to an existing Teamcenter
visual issue or delete existing snapshots from the issue. You can also update a single snapshot.
1. Open the visual issue in the stand-alone viewer or the Lifecycle Viewer.
3. In the Snapshots view (Lifecycle Viewer) or on the Snapshots tab (stand-alone viewer), do one of
the following:
• To save new 2D snapshots or product views to the visual issue, select the new snapshots.
• To delete 2D snapshots or product views from the visual issue, right-click the snapshots that you
want to delete, and choose Delete.
• To update a single 2D snapshot or product view, select the snapshot associated with the visual
issue.
Tip:
A snapshot associated with a visual issue has a dashed border.
You can delete Teamcenter visual issues directly in the stand-alone viewer or the Lifecycle Viewer.
1. Open the visual issue in the stand-alone viewer or the Lifecycle Viewer.
JtSimplification datasets are created using the Simpgen translator, which is included with the
Teamcenter Dispatcher system. Administrators can schedule JtSimplification production from the My
Teamcenter Translation menu.
JtSimplification data is used automatically when you send the assembly into the viewer and turn on the
root node. Since the geometry from a standard JT subassembly and a simplified subassembly looks the
same in the viewing window, a gray icon is used to represent subassemblies that consist of simplified
geometry.
Note:
• JtSimplification data requires an additional license and is supported only in the stand-alone
viewers and the Lifecycle Viewer within the Teamcenter Rich Client. If you do not have a license
for the JtSimplification functionality or if you load a JtSimplification dataset in an unsupported
viewer, the full model loads as standard JT data.
• You can use the TCVIS_ALSG_ENABLED environment variable to disable support for the
viewing of JtSimplification datasets in the Lifecycle Viewer and the stand-alone viewers. By
default, this variable is not set and JtSimplification is automatically enabled in properly licensed
viewers. Set this variable to False if you want to disable the functionality.
Tip:
To avoid any of the limitations described below, resolve the simplified data to fully load the
assembly information and geometry.
Tip:
You can apply a snapshot that captured simplified geometry even after the
geometry is resolved.
Session save When you save a session file with the Capture static structure check box
selected in the Session Save As dialog box, all of the JtSimplification geometry
is resolved as part of the saved session. Otherwise, the state of unresolved
simplified geometry is maintained.
Part or assembly When you right-click a part or assembly and select Properties, the
properties JtSimplification data is not resolved and the displayed geometric properties are
computed from the simplified geometry.
3D measurement When you perform 3D measurements on JtSimplification datasets, the simplified
geometry is not automatically resolved.
Clearance When you perform clearance analysis with JtSimplification datasets, the
simplified geometry is not automatically resolved.
Part Edit If you perform any Part Edit operation, all JtSimplification geometry is
automatically resolved and all of the parts are loaded.
To Do this
Resolve all of the simplified • In the assembly tree, right-click the root node of the model and
data within the model select Resolve All.
Resolve the next level of • In the assembly tree, click the plus sign to the left of the
simplified data within a subassembly node .
single subassembly -or-
In the assembly tree, right-click the subassembly node and select
Resolve.
-or-
In the Viewing window, right-click geometry within the
subassembly and select Resolve.
Resolve all levels of • In the assembly tree, right-click the subassembly node and select
simplified data within a Resolve All.
single subassembly -or-
To Do this
In the Viewing window, right-click geometry within the
subassembly and select Resolve All.
Resolve a part in the • Press Shift and then, in the Viewing window, click the part.
Viewing window The viewer automatically determines the minimum set of
JtSimplification data to resolve in order to fully load the part.
• Perform a single clearance variant analysis that excludes all non-buildable part pairs from a 150%
BOM line.
• Work with Design Context to identify a series of target parts and then quickly find other relevant data
within a given proximity to those parts.
You can evaluate ClearanceDB results in stand-alone Mockup, the Teamcenter Lifecycle Viewer,
Structure Manager, and Design Context. However, ClearanceDB results based on 4GD worksets can be
evaluated only in stand-alone Mockup.
• A properly configured and functioning ClearanceDB software environment, including the ClearanceDB
Server, Proxy, and Client tiers.
• A Mockup license in the rich client to view results in the Lifecycle Viewer or Structure Manager, or
Design Context with the Repeatable Digital Validation (RDV) component.
• Product data in the JT or PLM XML format within an item revision on the Teamcenter server.
1. Ensure that your environment meets the requirements for performing ClearanceDB analysis on
data from Teamcenter.
2. Create a ClearanceDB product, following the procedures located in the ClearanceDB Administration
Guide. This includes the following:
Note:
In a managed environment, ClearanceDB is configured by Teamcenter revision rules, so
ClearanceDB configuration names are Teamcenter revision rule names.
Note:
The name of the product must be the same as the top-level node in the assembly. Send the
item revision containing the product data to Structure Manager to obtain the name of the top
level assembly node, which is displayed in the BOM Line column.
If you are working within a Teamcenter multifield key environment, see Configuring
ClearanceDB for multifield key data.
3. Update the global configuration options for working with Teamcenter data.
5. Specify the item and revision IDs for the top level assembly of your product.
7. If you want to perform analysis using Teamcenter variant conditions, enable variant analysis for
clearance.
8. If you want to cache the product data on your local machine to improve the performance of the
analysis, adjust the load_fcccache options.
9. Use the analyze_managed_product.pl script to perform analysis on the managed product and
merge the results with the database.
You must update the Clearance.cfgglobal file to match your Teamcenter environment.
2. Change any of the following settings in the Section 1: Teamcenter Configuration section of the file
to configure ClearanceDB to work with Teamcenter:
TC_ROOT
Specifies the Teamcenter root directory.
TC_DATA
Specifies the Teamcenter TC_DATA directory.
ObjectType or ItemRevisionType (Optional)
Specifies to perform analysis of 4GD worksets. If ObjectType=Workset, then item, rev, and
rev_rule arguments are interpreted as those of a workset. If
ObjectType=ClearanceCalculationSubset, then ModelId, ClearanceCalculationName, and
Example:
ModelId=JCB-Fastrac_id ClearanceCalculationName=CC_JCB-Fastrac
PartitionSchemes=
"Ptn0SchemePhysicalForJCB-Fastrac;Ptn0SchemeFunctionalForJCB-Fastrac"
If no Partition schemes are specified, no 4GD partition data will be exported.
TeamcenterUserId
Specifies a Teamcenter user name with Teamcenter system administration privileges. If no user
name is provided, ClearanceDB uses the operating system user name.
Note:
This is the same option as the bomwriter -u= command line argument.
TeamcenterUserPassword
This setting is deprecated. The Teamcenter user password is now stored in a separate file, and
the path to the file is specified with the TeamcenterUserPasswordFile setting. Now if the
password is specified with TeamcenterUserPassword, it is written to an unencrypted file in
the user’s home directory with a randomly generated name beginning with CLDB.
TeamcenterUserPasswordFile
Specifies the path to a file containing the Teamcenter user password.
Note:
This is the same option as the bomwriter -pf= command line argument.
TeamcenterUserGroupId
Specifies the Teamcenter group ID. If no group ID is provided, ClearanceDB uses the default
group of the specified Teamcenter user.
Note:
This is the same option as the bomwriter -g= command line argument.
RevisionRule
Specifies the revision rule for the product's top level product structure node, or the revision
rule of a workset when ItemRevisionType=Workset.
Note:
This is the same option as the bomwriter -revision_rule= command line argument, or
the plmxml_export -rev_rule when ItemRevisionType=Workset.
SavedVariantRule
Specifies the saved variant configuration to pass to the bomwriter. The setting is not active
when ItemRevisionType=Workset.
LexicographicalVariantAnalysis
Defines the mode of the evaluation of variant condition relational expressions. Choose one of
the following:
No — If undeterminable variant conditions exist, the affected variant inferences are asked
from the server. This is the default.
Note:
Variant conditions that cannot be evaluated based on textual representations are
undeterminable.
VariantAnalysisClientTraceFile
Specifies the name for the log file of the variant analysis. By default, this is not set, and a log
file is not generated.
Example:
VariantAnalysisClientTraceFile=cldb_variant_analysis.log
VariantAnalysisClientTraceFlags
Specified the content of the log file of the variant analysis. The trace flags are additive,
concatenated with the plus (+) character.
Example:
VariantAnalysisClientTraceFlags=CONFIGURATION+STATISTICS
Caution:
Enabling the EXCUDEDUIDPAIRS and EXCLUDEDNGIDPAIRS trace flags may result in
extremely large log files.
VariantLogicalExpression
Defines the variant condition UserValue title and BOM line property pair in the PLM XML file.
This has the form of:
“Variant Condition”:bl_variant_condition
“Variant Formula”:bl_formula
Example:
VariantLogicalExpression="VC:bl_variant_condition"
Note:
This must match the content of the BomWriterUserAttributes setting.
RunLevel
Specifies the actions of the analyze_managed_product.pl script. Use a value from 1 to 6.
1 — In the product directory, a.vvi file is created, which is used by the bomwriter to
generate a .plmxml file referencing the managed data.
2 — Using the .vvi and .plmxml files in the product directory, the Clearance Calculator
performs analysis upon the managed product data and generates a results file.
3 — The results file is uploaded to the ClearanceDB database.
4 — Both the RunLevel 1 and 2 actions are performed.
5 — Both the RunLevel 2 and 3 actions are performed.
6 — All of the RunLevel actions are performed, 1, 2, and 3.
BomWriterUserAttributes
Specifies the variant conditions for the bomwriter to include in the generated .plmxml file.
Type these according to the following syntax:
Note:
This is the same option as the bomwriter -ua= command line argument.
Example:
Use this option to include variant model related BOM line properties in the
generated .plmxml file. For example:
BomWriterUserAttributes=target:Instance,key: VC,prop: bl_variant_condition
TeamcenterWebServerPath
Specifies the Teamcenter web server path, including the protocol, host name, and port
number. Type this according to the following syntax:
TeamcenterWebServerPath=http://machine_name:port
Example:
TeamcenterWebServerPath=http://tcserver:80/tc8_2008/
JtDataStagingProcess
Specifies to use the Teamcenter load_fcccache utility to download the model data from the
Teamcenter server to the local system for clearance analysis. Enabling this option pre-
populates the FMS client cache (FCC), which leads to faster and more reliable analysis.
FILECOPY_FAILED
INVALID_DAKID_FORMAT
FCC_OPENFILE_FAILED
FCC_DOWNLOAD_FAILED
GET_READ_TICKET_FAILED
DATASET_READ_FAILED
PLMXML_MISSING_JT
CHMOD_FAILED
COPYOUT_CLEANUP_FAILED
You can specify a numerical value for each error code. By default, the error codes are given
values that correspond to the severity of the problem, with the lowest value representing the
most severe failure. If a value is not specified for the JtDataStagingProcessErrorLimit setting,
the script stops whenever an error occurs during the staging process.
Note:
The default values are recommended for the JtDataStagingProcessErrorLimit setting
and the related error codes. Essentially, with these defaults the clearance analysis will
abort when any of these errors occur, and you can use the reported error message to
troubleshoot the problem.
FILECOPY_FAILED
Specifies the error code that indicates a copy operation to the output directory has failed.
The default location is the product directory in the ClearanceDB Work Area.
Note:
Do not use special characters in folder names.
BucketCount
Specifies how many directories to use for the cached files. Spreading the files over multiple
directories can lead to better performance.
BucketPrefix
Specifies a prefix to add to the names of directories created to hold the cached files.
Note:
This option requires the FilenamePrefix option to be set since it uses the prefix as
validation of ownership to prevent the accidental removal of files.
LifetimeCheck
Specifies to scan the StagingProcessDownloads directory for files older than the
CopyOutLifetime value.
Specifies the type of logging to be reported. The following are valid log types:
NONE
ERROR
WARNING
INFORMATION
DEBUG
PERFORMANCE
ALL
Note:
Use the + sign to use multiple log types. For example, ERROR+WARNING.
For ClearanceDB to work with data from Teamcenter, an absolute occurrence ID is required for each
product structure node of the BOM line to be analyzed.
1. Enable absolute occurrence IDs in the global configuration options (specified in the
Clearance.cfgglobal file) by removing the number sign symbol (#) that precedes the
Attribute=__PLM_ABSOCC_UID,Part and Parents (Part First) line.
2. Add the following entry to the process configuration (specified in the configuration.csvcldb file) for
each product:
"000092/A;1-cottonpicker (View)",EAICL_RELEVANT_PART_ATTRIBUTE,__PLM_ABSOCC_UID
For the Clearance Calculator to analyze Teamcenter managed data, you must specify the item ID and
revision of the top level assembly of your product. If your Teamcenter data is configured with multifield
key data, you must specify the item key.
1. Use a text editor, open the Clearance.cfgproduct file for the product and provide the following
information:
ItemKey
Specifies the Teamcenter values of the multifield key properties for the item containing your
product.
Note:
This setting is applicable only to Teamcenter products configured with multifield key
data. It corresponds to the –key argument for the Teamcenter bomwriter utility.
You can obtain the necessary multifield key strings with the Teamcenter get_key_string
utility.
ItemId
Specifies the Teamcenter item ID of the top level assembly of your product.
ItemRevision
Specifies the Teamcenter revision of the top level assembly of your product.
You can use the Teamcenter install utility to encrypt the Teamcenter user password. The encrypted
password is stored in an external file.
Example:
install –encryptpwf –f=C:\ClearanceDB_Work_Area\account_key
7. To specify for ClearanceDB to obtain the Teamcenter user password from the encrypted password
file, locate the TeamcenterUserPasswordFile setting, and type the full path and file name for the
password file.
Example:
TeamcenterUserPasswordFile=C:\ClearanceDB_Work_Area\account_key
Multifield keys are identifiers assigned to objects to ensure their uniqueness in the database. For
example, if the item business object type is configured to use multifield keys, it is possible to have two
item objects with the same item ID.
For ClearanceDB to analyze Teamcenter data configured with multifield key data, you must do the
following:
• When running the create_product.pl script to create the product in the ClearanceDB database, append
the __PLM_ITEMREV_UID for the item revision to the product name.
To find the UID for an item revision, open the item revision in Structure Manager, and view the
bl_rev_fnd0objectId property. Include this value within brackets after the (View) suffix, enclosing the
entire product name in quotation marks, as shown below:
Example:
“000092/A;1-cottonpicker (View) [4BYKHklYy$_loP]”
• When configuring the clearance.cfgproduct file for the product, populate the ItemKey parameter
with the multifield key properties of the item. This setting corresponds to the –key argument for the
Teamcenter bomwriter utility.
To obtain the key information, use the Teamcenter get_key_string utility.
Example:
ItemKey=item_id=000092,MFK_strkey1=val1
When you export 4GD data to PLM XML, you can export design element properties that are in addition
to the properties that are exported by default. To do this, you must add the properties to the PLM XML
transfer mode. You may also customize the titles of the properties for the PLM XML file.
To include the additional property, you must edit the transfer mode used for exporting data from
Teamcenter by adding the property derived from the 4GD root business object Cpd0DesignElement.
1. In Teamcenter, start the PLM XML/TC XML Export Import Administration application.
Note:
More information on the PLM XML/TC XML Export Import Administration application is
located in the Teamcenter help.
2. Select the 4GDPIEDataExportTcVisClearanceDB transfer mode from the PLMXML Import Export
Modes tree.
The TransferMode pane appears, with the options for the selected transfer mode.
a. Click the Add clause button located to the right of the clause table.
When the property is added to the property set, it is exported to the PLMXML with its name as
object_name. You can change this to a more specific name.
2. Under the Cpd0DesignElement business object, in the ProductRevisionView section, add the
ProductRevisionView/UserData rule as shown in this example, where DesignElementName is the
new name you want to create for the property.
#########################################
# Cpd0DesignElement
#########################################
Cpd0DesignElement|ProductInstance
Cpd0DesignElement.object_name|ProductInstance.name
Cpd0DesignElement<fnd0affectedObject.Mdl0VariantExprBlock.fnd0express
ions>
Cfg0ApplicationVariantExp.fnd0formula|ProductInstance/UserData|
add_user_value($TARGET_END_OBJECT
Cpd0DesignElement.owning_user>User.user_name|ProductInstance/
UserData|
add_user_value($TARGET_END_OBJECT
Cpd0DesignElement.owning_group>Group.name|ProductInstance/UserData|
add_user_value($TARGET_END_OBJECT
Cpd0DesignElement|ProductInstance.partRef>ProductRevisionView
Cpd0DesignElement|Occurrence
Cpd0DesignElement.puid|Occurrence/UserData|
add_user_value($TARGET_END_OBJECT
Cpd0DesignElement|Occurrence.instanceRefs>ProductInstance
Cpd0DesignElement<cpd0presented_parent.Cpd0DesignElement|
Occurrence.occurrenceRefs>Occurrence
Cpd0DesignElement|Occurrence.partRef>ProductRevisionView
Cpd0DesignElement.cpd0UG_ENTITY_HANDLE|Occurrence/UserData|
add_user_value($TARGET_END_OBJECT
Cpd0DesignElement|ProductRevisionView
Cpd0DesignElement.object_name|ProductRevisionView.name
Cpd0DesignElement.object_name|ProductRevisionView/UserData|add_user_value
($TARGET_END_OBJECT, 'DesignElementName', '',$SOURCE_VALUES, false, false)
Cpd0DesignElement.cpd0source_object>ItemRevision.items_tag>Item.fnd0i
s_
monolithic|ProductRevisionView/UserData|
add_user_value($TARGET_END_OBJECT
Cpd0DesignElement<cpd0presented_parent.Cpd0DesignElement|
ProductRevisionView.
instanceRefs>ProductInstance
Cpd0DesignElement<mdl0positioned_object.Mdl0DefaultGeometry|
ProductRevisionView/Representation
Cpd0DesignElement<mdl0positioned_object.Mdl0DefaultGeometry.
mdl0direct_model_data>Dataset.object_type|ProductRevisionView/
Representation.format|lookup_table( DSFormatList
3. Near the beginning of the file, add the ProductRevisionView rule as shown in this example.
!source_hierarchy Cpd0WorksetLine\BOMLine
!source_hierarchy Cpd0SubsetLine\BOMLine
!source_hierarchy Cpd0WorksetRevision\ItemRevision
!target_graph_definition UserValue.title
!target_graph_definition UserValue.value
!target_id_reference InstanceGraph.rootRefs|*.id
!target_id_reference ProductRevisionView.instanceRefs|*.id
!target_id_reference ProductView.rootRefs|*.id
|ProductView/ApplicationRef.application| 'NX'|
@ProductView.usage == 'modelView'
|InstanceGraph.$CHILD_ELEMENT|concat(@@InstanceGraph.$CHILD_ELEMENT>
$MAPPED
|InstanceGraph.$CHILD_ELEMENT|concat(@@InstanceGraph.$CHILD_ELEMENT>
$MAPPED
|ProductView.$CHILD_ELEMENT|concat(@@ProductView.$CHILD_ELEMENT>
$MAPPED
|ProductRevisionView/UserData/UserValue| remove_object($SOURCE_VALUE)|
@UserValue.title == 'object_name'
#########################################
# BOMWindow
#########################################
Clearance variant analysis is based on product variant information stored in Teamcenter. Analysis is
performed on a 150% BOM structure, which is the union of all of the structure of a product without
respect to buildable combinations. Non-buildable combinations of product structure are detected and
excluded from the clearance analysis.
The benefits of removing non-buildable occurrence relationships from ClearanceDB analysis include the
following:
Using variant analysis, a single 150% BOM can contain all buildable product combinations. This enables
you to perform a single clearance analysis, which excludes all non-buildable part pairs.
With the E=V6 variant, nodes 1, 2, 3, and 4 are analyzed (6 part pairs).
Nodes 5 and 6 are excluded (9 part pairs).
With the E=V8 variant, nodes 1, 2, 5, and 6 are analyzed (6 part pairs).
Nodes 3 and 4 are excluded (9 part pairs).
Without using variant analysis, you must create and manage separate 100% BOMs to represent each
buildable product combination. You must evaluate each BOM with a separate clearance analysis.
For the analysis of the V6 Engine, without variant conditions, nodes 1, 2, 3, and 4
are analyzed (6 part pairs).
No nodes are excluded.
For the analysis of the V8 Engine, without variant conditions, nodes 1, 2, 5, and 6
are analyzed (6 part pairs).
No nodes are excluded.
For more information about working with Teamcenter variant conditions, see Getting Started with
Product Structure in the Teamcenter help.
You must enable the option to evaluate ClearanceDB products according to Teamcenter variant
conditions.
1. Using a text editor, open Clearance.cfgglobal and adjust the following settings:
Note:
You can also specify these options in the Clearance.cfgproduct file for the product.
LexicographicalVariantAnalysis
Defines the mode of the evaluation of variant condition relational expressions. Choose one of
the following:
No — If undeterminable variant conditions exist, the affected variant inferences are asked
from the server. This is the default.
Note:
Variant conditions that cannot be evaluated based on textual representations are
undeterminable.
VariantAnalysisClientTraceFile
Specifies the name for the log file of the variant analysis. By default, this is not set, and a log
file is not generated.
Example:
VariantAnalysisClientTraceFile=cldb_variant_analysis.log
VariantAnalysisClientTraceFlags
Specified the content of the log file of the variant analysis. The trace flags are additive,
concatenated with the plus (+) character.
Example:
VariantAnalysisClientTraceFlags=CONFIGURATION+STATISTICS
Caution:
Enabling the EXCUDEDUIDPAIRS and EXCLUDEDNGIDPAIRS trace flags may result in
extremely large log files.
VariantLogicalExpression
Define the variant condition UserValue title and BOM line property pair in the PLM XML file.
This has the form of:
“Variant Condition”:bl_variant_condition
“Variant Formula”:bl_formula
Example:
VariantLogicalExpression="VC-V6:bl_variant_condition"
Note:
This must match the content of the BomWriterUserAttributes setting.
BomWriterUserAttributes
Specify the variant conditions for the bomwriter to include in the generated .plmxml file. Type
these according to the following syntax:
Note:
This is the same option as the bomwriter -ua= command line argument.
Example:
Use this option to include variant model related BOM line properties in the
generated .plmxml file. For example:
BomWriterUserAttributes=target:Instance,key: VC-V6,prop: bl_variant_condition
Specify to perform analysis using Teamcenter variant conditions. To enable this option, remove
the number sign symbol (#) that precedes the RulesObject = Variant Analysis line.
You can configure ClearanceDB to use the load_fcccache utility to download and cache model data
from the Teamcenter server to your local machine, improving both the reliability and performance of the
analysis. Options to control the load_fcccache utility are located in the Clearance.cfgglobal file.
Note:
For most of these settings the default values are recommended and they should not be modified
unless you understand how the changes will affect the data staging process. Exceptions include
• JtDataStagingProcess — By default the load_fcccache option is disabled and you must change
this setting to enable it.
• CopyOutLocation — This setting specifies where to copy the files cached from Teamcenter.
For more information on the Teamcenter File Management System (FMS), see the System
Administration Guide in the Teamcenter documentation.
1. Using a text editor, open Clearance.cfgglobal and adjust the following settings:
JtDataStagingProcess
Specifies to use the Teamcenter load_fcccache utility to download the model data from the
Teamcenter server to the local system for clearance analysis. Enabling this option pre-
populates the FMS client cache (FCC), which leads to faster and more reliable analysis.
FILECOPY_FAILED
INVALID_DAKID_FORMAT
FCC_OPENFILE_FAILED
FCC_DOWNLOAD_FAILED
GET_READ_TICKET_FAILED
DATASET_READ_FAILED
PLMXML_MISSING_JT
CHMOD_FAILED
COPYOUT_CLEANUP_FAILED
You can specify a numerical value for each error code. By default, the error codes are given
values that correspond to the severity of the problem, with the lowest value representing the
most severe failure. If a value is not specified for the JtDataStagingProcessErrorLimit setting,
the script stops whenever an error occurs during the staging process.
Note:
The default values are recommended for the JtDataStagingProcessErrorLimit setting
and the related error codes. Essentially, with these defaults the clearance analysis will
abort when any of these errors occur, and you can use the reported error message to
troubleshoot the problem.
FILECOPY_FAILED
Specifies the error code that indicates a copy operation to the output directory has failed.
Specifies the error code that indicates a missing JT file reference in the .plmxml file.
The default location is the product directory in the ClearanceDB Work Area.
Note:
Do not use special characters in folder names.
BucketCount
Specifies how many directories to use for the cached files. Spreading the files over multiple
directories can lead to better performance.
Note:
This option requires the FilenamePrefix option to be set since it uses the prefix as
validation of ownership to prevent the accidental removal of files.
LifetimeCheck
Specifies to scan the StagingProcessDownloads directory for files older than the
CopyOutLifetime value.
LogTypes
Specifies the type of logging to be reported. The following are valid log types:
NONE
ERROR
WARNING
INFORMATION
DEBUG
PERFORMANCE
ALL
Note:
Use the + sign to use multiple log types. For example, ERROR+WARNING.
1. The bomwriter utility generates a .plmxml file referencing the Teamcenter product data.
2. The load_fcccache utility downloads the product data to your local machine. A second .plmxml file
referencing the cached data is generated.
3. The Clearance Calculator analyzes the cached data according to a ClearanceDB product
configuration (defined in the configuration.csvcldb file, together with any specified rules,
conditions, and zones). ClearanceDB results are generated and uploaded to the ClearanceDB
database.
Take the following steps to perform a ClearanceDB analysis upon a Teamcenter managed product.
1. Configure the Clearance Calculator, as described in the Configure clearance analysis section of the
ClearanceDB Administration Guide.
Example:
analyze_managed_product.pl flux_capacitor
Depending upon how you set the RunLevel parameter in the Clearance.cfgglobal file, one or
more of the following actions are performed:
The analysis runs, and when it is complete the clearance results file,
ClearanceResultsDbUpload.csvcldb, appears in the product directory.
The command line output below is from a successful ClearanceDB analysis of a Teamcenter managed
product.
C:\ClearanceDB_Work_Area\Products
\141-f10002_A_1-Front_Suspension__view_>analyze_managed_product.pl
#-----------------------------------------
# analyze_managed_product.pl
# Tue Feb 9 14:01:45 2010
#-----------------------------------------
#-----------------------------------------
# Teamcenter Configuration:
# TC_ROOT=Y:\
# TC_DATA=Z:\
# TeamcenterUserId=tcuser
# RevisionRule=Latest Working
# RunLevel=6
# JtDataStagingProcess=1
#-----------------------------------------
#-----------------------------------------
# Step 1a of 3: Run Bomwriter.exe
#-----------------------------------------
Running:
Y:\\bin\bomwriter -u=tcuser -p=xxxxxxxx -g= -item="141-f10002" -rev=A -format=plmxml
+type=
AbsoluteOccurrences+ua=target:Root,key:Configuration,literal:"Latest Working"
-revision_rule="Latest
Working" -output_file="C:/ClearanceDB_Work_Area/Products/
141-f10002_A_1-Front_Suspension__view_/
141-f10002_A_1-Front_Suspension__view_.plmxml"
platform=MSWin32
C:/ClearanceDB_Work_Area/Products/141-f10002_A_1-Front_Suspension__view_/
bomwriter_exec.bat
C:\ClearanceDB_Work_Area\Products\141-f10002_A_1-Front_Suspension__view_>set TC_ROOT=Y:\
C:\ClearanceDB_Work_Area\Products\141-f10002_A_1-Front_Suspension__view_>set TC_DATA=Z:\
C:\ClearanceDB_Work_Area\Products\141-f10002_A_1-Front_Suspension__view_>call Z:\
\tc_profilevars
#-----------------------------------------
# Bomwriter.exe execution SUCCEEDED
# Execution time = 00:15:03
#-----------------------------------------
#-----------------------------------------
# Step 1b of 3: Run Load_fcccache.exe
#-----------------------------------------
Running:
Y:\\bin\load_fcccache -u=tcuser -p=xxxxxxxx -config=C:/ClearanceDB_Work_Area/
Clearance.cfgglobal
-f=load -plmxml=C:/ClearanceDB_Work_Area/Products/141-f10002_A_1-Front_Suspension__view_/
141-f10002_A_1-Front_Suspension__view__orig.plmxml -output_plmxml=C:/
ClearanceDB_Work_Area/
Products/141-f10002_A_1-Front_Suspension__view_/
141-f10002_A_1-Front_Suspension__view_.plmxml
-copy_out=C:/ClearanceDB_Work_Area/Products/141-f10002_A_1-Front_Suspension__view_/
StagingProcessDownloads -log_filename=C:/ClearanceDB_Work_Area/Products/
141-f10002_A_1-Front_Suspension__view_/JtDataStagingProcess.log
platform=MSWin32
C:/ClearanceDB_Work_Area/Products/141-f10002_A_1-Front_Suspension__view_/stage_exec.bat
C:\ClearanceDB_Work_Area\Products\141-f10002_A_1-Front_Suspension__view_>set TC_ROOT=Y:\
C:\ClearanceDB_Work_Area\Products\141-f10002_A_1-Front_Suspension__view_>set TC_DATA=Z:\
C:\ClearanceDB_Work_Area\Products\141-f10002_A_1-Front_Suspension__view_>call Z:\
\tc_profilevars
DEBUG 2010-02-09T19:21:16.462Z: Setting logTypes to: -1
DEBUG 2010-02-09T19:21:16.462Z: Setting minor error: FILECOPY_FAILED, error code: 20
DEBUG 2010-02-09T19:21:16.478Z: Setting minor error: INVALID_DAKID_FORMAT, error code: 21
DEBUG 2010-02-09T19:21:16.478Z: Setting minor error: FCC_OPENFILE_FAILED, error code: 22
DEBUG 2010-02-09T19:21:16.478Z: Setting minor error: FCC_DOWNLOAD_FAILED, error code: 23
DEBUG 2010-02-09T19:21:16.478Z: Setting minor error: GET_READ_TICKET_FAILED, error code:
24
DEBUG 2010-02-09T19:21:16.493Z: Setting minor error: DATASET_READ_FAILED, error code: 25
DEBUG 2010-02-09T19:21:16.493Z: Setting minor error: PLMXML_MISSING_JT, error code: 26
DEBUG 2010-02-09T19:21:16.493Z: Setting minor error: CHMOD_FAILED, error code: 27
DEBUG 2010-02-09T19:21:16.493Z: Setting minor error: COPYOUT_CLEANUP_FAILED, error code:
28
DEBUG 2010-02-09T19:21:16.509Z: Setting BucketCount to: 30
DEBUG 2010-02-09T19:21:16.509Z: Setting UseAbsoluteLocation to: No
DEBUG 2010-02-09T19:21:16.603Z: Setting DirAccessMode to: 0750 (488)
DEBUG 2010-02-09T19:21:16.618Z: Setting FileAccessMode to: 0640 (416)
DEBUG 2010-02-09T19:21:16.618Z: Setting BucketPrefix to: RW
DEBUG 2010-02-09T19:21:16.618Z: Setting FilenamePrefix to: fmsr_
DEBUG 2010-02-09T19:21:16.618Z: Setting CopyOutLifetime to: 1209600
DEBUG 2010-02-09T19:21:16.618Z: Setting LifetimeCheck to: 0
DEBUG 2010-02-09T19:21:16.618Z: Setting the LifetimeCheckInterval to: 10
DEBUG 2010-02-09T19:21:16.634Z: Setting the LifetimeProcessLimit to: 300
FCC Interface Implementation fms.8.2.0.20091029.01(fms.8.2.0.20091029.01) initialized.
#-----------------------------------------
# Load_fcccache.exe execution SUCCEEDED
# Execution time = 00:13:05
#-----------------------------------------
#-----------------------------------------
# Step 2 of 3: Run Clearance.exe
#-----------------------------------------
Running:
C:/ClearanceDB_Work_Area/Products/141-f10002_A_1-Front_Suspension__view_/
clearance_exec.bat
C:\ClearanceDB_Work_Area\Products\141-f10002_A_1-Front_Suspension__view_>set
VP_AUTO_TESTING=True
C:\ClearanceDB_Work_Area\Products\141-f10002_A_1-Front_Suspension__view_>set
EAI_CL_DATASOURCE=
cldbmachine:7206
C:\ClearanceDB_Work_Area\Products\141-f10002_A_1-Front_Suspension__view_>set
EAI_CL_CONNECT_DATA=
CLDB_PROXY_CONNECT
C:\ClearanceDB_Work_Area\Products\141-f10002_A_1-Front_Suspension__view_>set PATH=C:\Perl
\bin;
C:\WINDOWS;C:\WINDOWS\System32;C:\vis\Products\Mockup\ClearanceDB
C:\ClearanceDB_Work_Area\Products\141-f10002_A_1-Front_Suspension__view_>C:\vis\Products
\Mockup\
clearance.exe -d 5 -c C:/ClearanceDB_Work_Area/Products/
141-f10002_A_1-Front_Suspension__view_/
141-f10002_A_1-Front_Suspension__view_.vvi
#-----------------------------------------
# Clearance.exe execution SUCCEEDED
# Execution time = 00:01:12
#-----------------------------------------
#-----------------------------------------
# Step 3 of 3: Run Update_product.pl
#-----------------------------------------
Running:
C:\vis\Products\Mockup\ClearanceDB\update_product.pl -ud
#-----------------------------------------
# Update_product.pl execution SUCCEEDED
# Execution time = 00:00:08
#-----------------------------------------
#--------------------------------------------------------------------
# analyze_managed_product.pl complete
# Tue Feb 9 14:31:17 2010
#
# Step 1a: Bomwriter.exe. Result = SUCCEEDED. Time=00:15:03
# Step 1b: Load_fcccache.exe. Result = SUCCEEDED. Time=00:13:05
# Step 2: Clearance.exe. Result = SUCCEEDED. Time=00:01:12
# Step 3: Update_product.pl. Result = SUCCEEDED. Time=00:00:08
# Total Time = 00:29:31
#---------------------------------------------------------------------
Completed: Tue Feb 9 14:31:17 2010
C:\ClearanceDB_Work_Area\Products\141-f10002_A_1-Front_Suspension__view_>
1. In My Teamcenter, right-click the item revision containing your product data and choose Send
To→Lifecycle Viewer.
The dataset opens in the Lifecycle Viewer.
3. In the Requirement Rule Components dialog box, select the Requirement Rules from
ClearanceDB Server check box, and then click OK.
5. In the Load Clearance Results dialog box, from the Files of Type list, choose ClearanceDB
DataBase Connection (*.dbc).
1. In My Teamcenter, right-click the item revision containing your product data and choose Send
To→Structure Manager.
The Structure Manager opens and displays the product structure.
4. Choose Graphics→Clearance→Preferences→Clearance→Requirements.
5. In the Requirement Rule Components dialog box, select the Requirement Rules from
ClearanceDB Server check box, and then click OK.
8. In the Load Clearance Results dialog box, from the Files of Type list, choose ClearanceDB
DataBase Connection (*.dbc).
ClearanceDB accepts any pruned or full product structure provided it is represented by a JT file in the
Teamcenter database. Any parts for which JT data is not available are not included in the clearance
analysis. The product structure also should be searchable in Design Context.
• Real-time mode
In real-time mode, the rich client user selects target and background Bill of Materials (BOM) lines in
Design Context, and then invokes a clearance analysis that is performed in real time. Typically, this
option is used to make on-the-fly clearance calculations after design changes or prior to releasing a
part. Teamcenter runs these calculations in the background, allowing the end user to continue with
other work while waiting for the results. Results are displayed in the Design Context Issues panes.
A SCO (Structure Context Object) containing the clearance results can also be created in the Newstuff
folder, provided the RDVCreateSCOForClearance preference is set to true. The SCO can be opened
in a subsequent session to retrieve the selected product structure lines and analysis results.
Note:
For more information on using Design Context, see the Design Context Guide in the Teamcenter
documentation.
The ClearanceDB administrator configures the scope of the analysis and the Design Context end user
can only view the results. The end user can use the Design Context search engine capabilities to focus
upon particular parts.
• Target-Target Issues
Shows clearance issues among all the appearances in the Design Context target appearances table in
the third window. The specific issue between each pair of parts is listed.
• Target-Background Issues
Shows clearance issues among target parts against all the appearances in the Design Context
background appearances table in the third window. The specific issue between each pair of parts is
listed.
• Target-Other Issues
Teamcenter displays each pair of parts that violate one of the defined clearance rules. All violations are
shown in the context of the selected target part appearance or appearances. For each violation, the
following information is listed:
• Type
The clearance violation type.
• Result
The calculated violation with respect to the requirement.
• Requirement
The required clearance.
• Location
The x,y,z coordinates of the violation.
Note:
You can also view additional results information such as issue Status, Priority, and Date First
Found. To update the selection of columns shown in the Issues panes, modify the
ClearanceDBShownColumns preference in the rich client.
Real-time mode
Real-time clearance analysis is a two step process. The first step is to create search criteria for the
clearance calculation. The second step is to send the search criteria to Design Context to see the
clearance analysis results.
To perform real-time clearance analysis, the end user manually selects BOM lines of interest in Design
Context. BOM lines involved in the analysis process are Design Context target parts. The user selects
these parts from the target and background BOM lines that are configured in the Design Context third
window. Global background parts cannot be included in a real-time clearance analysis. If particular BOM
lines are not selected, all BOM lines in the target appearances are considered target parts.
Teamcenter analyzes the BOM lines selected as Design Context target parts against all other BOM lines
in the Design Context third window. It presents the issues in the following categories:
• Target parts against all the appearances in the Design Context target appearances table in the third
window.
• Target parts against all the appearances in the Design Context background appearances table in the
third window.
Optionally, Teamcenter may create an SCO (Structure Context Object) in the Newstuff folder containing
information about the session. The SCO can be opened in a subsequent session to retrieve the selected
product structure lines and analysis results.
Note:
Creation of an SCO is optional and occurs only if the RDVCreateSCOForClearance preference is
set to true in the rich client.
For Design Context to connect with the ClearanceDB database, you must use the Teamcenter
RDVClearanceProxyServers preference to specify the ClearanceDB connection information.
Note:
You must have Teamcenter administrator rights to modify the RDVClearanceProxyServers
preference.
2. Choose Edit→Options.
4. In the Search On Keywords box, type RDVClearanceProxyServers, and then click the
magnifying glass icon to search for the preference.
6. In the Current Values box, type your connection information according to the following syntax:
<machine_name>:<port>:<connection_name>
where
Note:
The RDVClearanceProxyServers preference can consist of multiple ClearanceDB
connections. For each additional connection that you want to establish, type the required
connection information as described above and then click the + sign to the right of the
Current Values box to update the preference.
8. Click Modify.
Set the RDVCreateSCOForClearance preference to true if you want to create an SCO (Structure
Context Object) after performing real-time analysis.
Note:
You must have Teamcenter administrator rights to modify the RDVCreateSCOForClearance
preference.
2. Choose Edit→Options.
4. In the Search On Keywords box, type RDVCreateSCOForClearance, and then click the
magnifying glass icon to search for the preference.
7. Click Modify.
Note:
You must have Teamcenter administrator rights to modify the ClearanceDBShownColumns
preference.
2. Choose Edit→Options.
4. In the Search On Keywords box, type ClearanceDBShownColumns, and then click the
magnifying glass icon to search for the preference.
6. In the Current Values box, type the names of the ClearanceDB results columns that you want to
display.
7. Click Modify.
2. In the Clearance Analysis dialog box, select Query the database for existing results.
4. To view the associated parts in the embedded viewer, select one or more issues and click the
Communicate to Design Context button.
Teamcenter opens the relevant BOM lines in Design Context, allowing you to examine the
clearance details in the embedded viewer.
Alternatively, you can also view the parts associated with one or more selected issues in standalone
Teamcenter lifecycle visualization mockup if you click the Start/Open In TcVis button.
1. Select the product structure lines of interest in the third Design Context window. If you do not
select any lines, Teamcenter includes all appearances in the third Design Context window in the
analysis.
3. In the Clearance Analysis dialog box, select Perform Real-Time Clearance Analysis.
Note:
Real-time analysis results are not stored in the ClearanceDB database. If you want to preserve
them, you must create an SCO (Structure Context Object) object. You can open the SCO in a
subsequent session to retrieve the selected product structure lines and analysis results. The
RDVCreateSCOForClearance preference must be set to true for an SCO to be created.
1. In your Newstuff folder, right-click the SCO containing your results and choose Send To→Design
Context.
Teamcenter opens the results in the first Design Context window.
2. Click Finish.
Teamcenter opens the third Design Context window.
Note:
Click Yes on any confirmation dialog boxes that are displayed.
4. Select Display Cached Results from SCO and then click Start Analysis.
After a delay that depends on the quantity of stored data, Teamcenter displays the retrieved
clearance issues in one of the Issues panes.
Asia-Pacific
Americas Suites 4301-4302, 43/F
Granite Park One AIA Kowloon Tower, Landmark East
5800 Granite Parkway 100 How Ming Street
Suite 600 Kwun Tong, Kowloon
Plano, TX 75024 Hong Kong
USA +852 2230 3308
+1 314 264 8499