Structure Manager
Structure Manager
Publication Number
PLM00048 J
Proprietary and restricted rights notice
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Index-1
Figures
Start Structure
Manager Click Structure Manager in the navigation pane.
• Open Items
Provides a list of currently open BOM windows or structures. Click an entry in
the list to select and make it active.
• History
Provides a list of BOM windows or structures that you have recently opened.
Click an entry in the list to select and make it active.
File menu
Command Description
New→Item Creates a new item, functionality, or document.
Command Description
New→BOM View Revision Creates a new BOM view revision for the selected
line.
New→Workflow Process Creates a new change process for the selected
structure.
New→Part Creates a new part.
New→Design Creates a new design, that is, a CAD representation
of a part or assembly.
New→Snapshot Creates a new snapshot of the selected structure.
New→Item Element Creates a new item element (GDE) and associates
it with the selected line.
New→Connection Creates a new revisable connection (for example,
connection or datum point) or nonrevisable (Tc Link)
connection. To associate the connection with the
connected objects, select the connection and objects,
and then choose Edit→Connect.
New→Manufacturing Creates a new manufacturing feature, for example, a
Feature weld point.
New→Interface Definition Creates a new interface (for example, connection or
network port) and associates it with the selected line.
New→Process Variable Creates a new process variable.
New→Signal Creates a new electrical signal.
New→Item From Template Creates a new item or item revision from a predefined
template.
New→Folder Creates a graphical representation of an aggregation
of objects.
New→Dataset Creates a Teamcenter data object used to manage
data files created by other software applications.
Each dataset can manage multiple operating system
files, and each dataset references a dataset tool object
and a dataset business object.
New→Form Creates a data object used to display product
information (properties) in a predefined template.
Forms can be used to create an electronic facsimile
of a hardcopy form.
New→URL Creates a data object used to access a Web resource.
The URL (uniform resource locator) is an address
that is used as a link to access a Web resource within
Teamcenter or in a separate browser.
New→Data Requirement Allows you to create a data requirement item (DRI) if
Item you are working with contract data.
Command Description
New→Parameter Allow you to use the Calibration and Configuration
Management→Parameter Data Management (CCDM) solution to create
Definition and manage embedded software calibration and
configuration parameter data. CCDM is a separately
New→Parameter licensed solution that must be installed to expose
Management→Parameter these commands.
Definition Group
For detailed information about CCDM, see the
New→Software Design Embedded Software Solutions Guide.
Component
Open (Ctrl+O) Opens the selected structure.
Open in NX Sends PLM XML data representing the geometry of
the selected assembly to NX.
Open in Lifecycle Loads DirectModel datasets for the selected
Visualization lines and displays them in standalone Lifecycle
Visualization.
Save (Ctrl+S) Saves changes made in Structure Manager. For
example, you must explicitly save any new BOM
lines or variants.
If there are unsaved changes, the title pane of the
Structure Manager window and the tooltip for any
open pane are shown in bold with an asterisk *
appended to the name. When you save the changes,
the bold highlight and the asterisk are removed.
Save As→Item (Revision) Depending on the currently selected line, creates a
new item or new item revision from the selected line.
Save As→BOMView If a view is currently selected, creates a new structure
(Revision) view of an item from the view in the selected line.
If an item is currently selected, creates a new BOM
view revision of the selected item.
For detailed information, see Using Save As to save a
BOM view revision.
Save Session Saves the current Teamcenter session, including the
top-level item revision, the effective revision rules,
and the state of the viewer pane.
Note By default, this menu entry is hidden.
To make it visible, you must set the
enableSessionFile entry in your
customer.properties file to true. If this file
does not already exist, you must create it.
Open Session Opens a previously saved Teamcenter session.
Revise Revises the selected item.
Command Description
Duplicate Clones the selected structure or assembly. The
selected line and everything below it will be copied
into the new (cloned) structure. Datasets and
attachments may be copied to the new (cloned)
structure, depending on Business Modeler IDE
deep copy rules. CAD-specific attachments and
relationships may be copied depending on options
you selected and the closure rules configured for the
CAD integration. For example, part family members
may be replicated in the new (cloned) structure.
For detailed information, see Cloning a structure.
Note This command is unavailable if you select
an architecture object type or subtype, for
example, architecture breakdown element
(ABE). However, you can duplicate any
custom object types that your administrator
creates.
Close Closes the currently displayed structure.
Print Views, prints, or saves information about the
currently selected structure.
Print... Views, prints or saves properties, textual information,
graphics or information associated with the selected
item.
Exit Ends your Structure Manager session.
Edit menu
Command Description
Cut (Ctrl+X) Marks the selected lines for removal and copy their
contents to the clipboard. Cut lines are only removed once
they are pasted elsewhere in the product structure.
Copy (Ctrl+C) Copies the selected lines to the clipboard.
Paste (Ctrl+V) Pastes item revisions from the clipboard as components
of the selected lines.
Paste Substitute Pastes item revisions from the clipboard as substitutes for
the selected (assembly) lines.
Command Description
Paste Special Pastes components on the clipboard to the selected
assembly (line).
Depending on the contents of the clipboard, this command
may move a cut and pending line or lines to another
location in the product structure. You can also move lines
by drag-and-drop methods or with the Windows shortcut
commands.
Add Adds components to the selected assembly (line) by typing
in an item identifier.
Revert Edit Cancels any pending additions or removals of the selected
lines. It also cancels any pending property edits.
Note Certain edits are committed immediately to the
database and cannot be reverted. Such edits are
not displayed in red strike-through text.
Command Description
User Setting Changes your group, role, or volume assignments and your
application logging and journalling options.
Options Changes your user interface settings that affect all
applications, not only Structure Manager.
Guided Component Searches for matching components within an assembly.
Search This search allows you to choose from a list of only
those classified workspace objects that fit into the first
component of your search. You must first configure it in the
Classification Administration application.
Variant Condition Creates a variant condition on the selected line.
Toggle Changes the precision of the selected assembly (line).
Precise/Imprecise
Show/Hide Shows or hides all revisions in the selected structure
Superseded that are superseded by a later revision. This command
Revisions is applicable only if the BOM view revision and current
revision rule are precise.
Select Below→All Selects all lines below the currently selected line.
Lines
Select Selects only the lowest lines below the currently selected
Below→Lowest line.
Lines
Toggle in Context Enables or disables editing in context mode, allowing
Mode creation of absolute occurrences for the selected assembly.
Remove Design from Removes a CAD design from an installation assembly
Product attached to an architecture breakdown element. This
command is used when your site utilizes Platform Designer.
Replace Design in Removes a CAD design in an installation assembly
Product attached to an architecture breakdown element with
another CAD design. This command is used when your site
utilizes Platform Designer.
Replace Part in Replaces a part (an ERP part) in an architecture breakdown
Product element. This command is used when your site utilizes
Platform Designer.
View menu
Command Description
Refresh Window Synchronizes the currently displayed product structure
with the database. The displayed structure refreshes with
changes that have been made in other sessions and saved
since you loaded the currently displayed product structure.
Command Description
Embedded Software Allows you to view binary software information in the same
Explorer way as you view data about hard parts.
For more information about these commands, see the
Embedded Software Solutions Guide.
Note The Embedded Software Solutions (ESS) menu
commands must be exposed using Command
Suppression.
Signal Explorer Allows you to view signals in an electromechanical
structure. You can view the source, target, transmitter,
process variable, signal of process variable, redundant
signal, transmitted signal, and received signal associated
with the selected lines, as applicable.
Show Connected Shows or hides all lines that are connected by the selected
Lines connection.
Implemented Shows all lines that implement the selected line.
By→Show
Implemented By
Implemented Shows all lines that the selected line implements.
By→Show
Implements
Realized By→Show Shows all lines that realize the selected line.
Realized By
Realized By→Show Shows all lines that the selected line realizes.
Realizes
Expand Expands the substructure immediately below the selected
lines.
Expand Below Expands the complete substructure below the selected
lines.
Expand Below... Expands the substructure below the selected lines to a
user-selected level. You can also collapse an expanded
substructure when you choose this command (hide certain
child lines).
Collapse Below Collapses the complete substructure below the selected
lines (hide all child lines).
Pack Packs the selected lines so that all lines with the same item
revision and find number are displayed as a single line.
The actual quantity of lines is appended to the node.
Unpack Unpacks the selected packed lines so that they are
displayed as separate lines, one for each occurrence.
Pack All Packs all packable lines in the displayed structure.
Unpack All Unpacks all lines in the displayed structure.
Command Description
Show Unconfigured Shows or hides unconfigured
Variants variant components. Disabled if the
PSEEnableFilteringUnconfigdDueToClassicVariantsPref
preference is set to True.
Show Unconfigured Shows or hides components that are not configured when
By Occurrence using occurrence effectivity.
Effectivity
Show Unconfigured Shows or hides unconfigured incremental changes.
Changes
Show Part Solutions Shows or hides part solutions. Part solutions are available
if your site uses Platform Designer.
Show Suppressed Shows or hides suppressed occurrences.
Occurrences
Enable Classic Hides or shows components that are not configured
Variant Configure by the selected variant rule. Enabled if the
to Load PSEEnableFilteringUnconfigdDueToClassicVariantsPref
preference is set to True.
Properties Allows you to view all properties of the selected line. You
can edit those properties to which you have permission.
Notes Allows you to view, and edit if permitted, all occurrence
notes for the selected line.
Audit→View Audit Shows the audit file for the selected structure or assembly.
Logs
This menu command is seen when the
TC_audit_manager preference value is ON and
the TC_audit_manager_version preference value is 2.
Show/Hide Data Shows or hides the data pane containing, for example,
Panel variant data, Referencers information, or the embedded
viewer.
Show/Hide Search Shows or hides the Structure Manager search pane.
Panel
Show/Hide Search Shows or hides the Structure Manager search results pane.
Result Panel
Show/Hide Shows or hides the supersedure revisions of the selected
Superseded part or assembly.
Revisions
Show GCS Shows or hides all connection points defined for guided
Connection Points component searches (GCSs). GCSs are defined in the
Classification Administration application.
Tools menu
Command Description
Check-In/Out→Check Out Checks a selected component out of the database.
Check-In/Out→Check In Checks a selected component into the database.
Command Description
Check-In/Out→Cancel Cancels a request checkout action.
Checkout
Check-In/Out→Transfer Transfers a selected, checked-out component to
Checkout another user.
Check-In/Out→Notification Allows you to view or edit the list of users who are
List informed if the selected component is checked in or
checked out.
Check-In/Out→Check Out Allows you to view the history of checkout actions for
History the selected component.
ID Display Rule→View/Set Allows you to view the ID display rule currently
Current applied to the selected structure or set a different ID
display rule.
ID Display Rule→Modify Modifies the ID display rule currently applied to the
Current selected structure.
ID Display Creates a new ID display rule or modify an existing
Rule→Create/Edit ID rule.
Process and Change Attaches the selected structure to a Workflow process
Selector or change.
Embedded Software Allows you to manage binary software in the same
Manager way as you manage hard parts.
For more information about these commands, see the
Embedded Software Solutions Guide.
Note The ESS menu commands must be exposed
using Command Suppression.
Signal Allows you to associate a signal line in an
Manager→Associate electromechanical structure to another line as a
Signal To source, target, transmitter, process variable, or
redundant signal.
Signal Manager→Remove Removes the association between the selected signal
Signal Association line in an electromechanical structure and another
line.
Connection Connects two selected lines with a revisable or
Manager→Connect nonrevisable connection.
Connection Disconnects the currently selected line with a
Manager→Disconnect revisable or nonrevisable connection to another line.
Implemented By→Create Creates Implemented By relationships between the
Implemented By selected line and another line.
Implemented By→Remove Removes Implemented By relationships between
Implemented By the selected line and another line.
Realized By→Create Creates Realized By relationships between the
Realized By selected line and another line.
Realized By→Remove Removes Realized By relationships between the
Realized By selected line and another line.
Command Description
Fix In-Structure Allows you to identify and remove any invalid
Associations→Current associations that were created when the structure
Level was manually edited. This command fixes all invalid
associations with the selected line.
Fix In-Structure Allows you to identify and remove any invalid
Associations→All Levels associations that were created when the structure
was manually edited. This command fixes all invalid
associations with the selected line and all lines below
it.
Project→Assign Assigns the selected structure to a predefined project.
Project→Remove Removes the selected structure from a project to
which it is assigned.
License→Attach Attaches an ADA license to the selected workspace
object.
License→Detach Detaches the ADA license from the selected
workspace object.
View/Set Closure Rule for Allows you to view the available closure rules and
Expansion select a rule to limit structure expansions.
For more information, see Set or unset a closure rule.
Trace Link→Traceability Generates a traceability report for the selected
structure.
Revision Rule→View/Set Allows you to view or set the revision rule for the
Current currently displayed structure.
Revision Rule→Set Sets the date, unit number, or end item to configure
Date/Unit/End Item the structure, if the current rule allows.
Revision Rule→Set Sets an override folder to override item revisions that
Override Folder would otherwise be selected by other criteria.
Revision Rule→Modify Modifies the current revision rule and apply the
Current modified rule to the current structure. You can save
the change if you have write access to the original
rule.
Revision Creates or edits a revision rule.
Rule→Create/Edit
Effectivity→Occurrence Allows you to view, edit, or create occurrence date
Effectivity→View, Edit and effectivity data for the occurrence of the selected line.
Create You must have the appropriate permissions to create
or edit effectivity data.
Effectivity→Occurrence Allows you to create occurrence date effectivity
Effectivity→Create on data on multiple BOM lines. You must have the
Multiple BOM Lines appropriate permissions to create or edit effectivity
data.
Command Description
Effectivity→Revision Allows you to view, edit, create, or copy effectivity
Effectivity data for the item revision of the selected line. You
must have the appropriate permissions to create or
edit effectivity data.
Effectivity→Effectivity Allows you to view, edit, create, or copy effectivity
Mapping mapping for an end item. Effectivity mappings are
needed if you implement nested effectivity.
Variants→Configure Allows you to configure or edit a variant structure for
Variants the selected top-level module.
Variants→Only Configure Allows you to set to on to only display options for
Root the top-level module, regardless of the line selected.
Set to off to configure the structure for a lower level
module.
Variants→Search... Searches for an existing variant item.
Variants→Count Modules Counts the modules defined for the selected variant
structure.
Variants→Unlink Variant Unlinks a variant item from the generic module item
Item to make changes.
Variants→Update Variant If you make structural changes to a generic item
Item and create a new item revision, Teamcenter does
not automatically propagate such changes to each
associated variant item. Choose this option to make
such changes manually.
Set/Unset Global Option Allows you to identify the selected item or item
Item revision as a product item with which global options
are associated.
Incremental Allows you to create an new incremental change.
Change→Create Context
Note This command is visible only
if your administrator sets the
MoveICCreationToMenu preference
to True. If it is not visible, use the Create IC
Object button on the incremental change
toolbar to create a new incremental change.
Incremental Change→Add Retrospectively creates an add change and attaches it
to the active incremental change.
Incremental Retrospectively creates a remove change and attaches
Change→Remove it to the active incremental change.
Incremental Establishes a delete change to the attachment.
Change→Delete on Object
Incremental Establishes a create change to the attachment.
Change→Create on Object
Incremental Removes (undoes) changes on the active incremental
Change→Remove Change change.
Command Description
Incremental Revises the parent assembly to create an incremental
Change→Incremental change baseline.
Change Baseline
Incremental Change→Split Splits some of the changes from the active incremental
change into another existing incremental change.
Incremental Allows you to create a new intent for which the
Change→Intent incremental change is valid. An intent represents an
alternate solution.
Incremental Customizes how incremental change icons are
Change→Display icons displayed and the contexts in which you want to see
icons.
Arrangements→View/Set Allows you to view and set the current NX
arrangements.
Unattached Lines→Clear Allows you to clear all the unattached lines in the
All results of an appearances search.
Unattached Lines→Clear Allows you to clear the currently selected unattached
Selected lines in the results of an appearances search.
Unattached Lines→Show Allows you to find the parent of an unattached line in
Parent the results of an appearances search.
Unattached Lines→Attach Allows you to reattach unattached lines in the results
of an appearances search.
All History Lines→Clear Clears all history lines in the results of an
All appearances search.
All History Lines→Clear Clears selected history lines in the results of an
Selected appearances search.
Validation→Run Validates attributes of a selected item revision,
Validations using third-party software applications, according to
criteria set by the system administrator.
Validation→View Results Allows you to view the results of previous validations.
Import→Remote Imports a structure from a remote site in a Multi-Site
Collaboration environment.
Import→Software Allows you to import software parameter data in
Parameters PLM XML format.
Export→Objects Allows you to export the selected workspace objects
through a predefined application interface (AI).
Command Description
Export→To PLMXML Export the selected structure and its attachments in
PLM XML format to a selected export directory. You
must choose the appropriate transfer mode for the
destination system and selected structure.
For details of how to specify a structure export in
PLM XML format, see the PLM XML/TC XML
Export Import Administration Guide.
If you export a structure in which substitute
components are defined, the substitutes are also
exported.
For details of how to export structure changes tracked
by incremental changes in PLM XML format, see
Exporting and importing incremental change data.
For details of how to specify a suitable closure
rule, see the PLM XML/TC XML Export Import
Administration Guide.
Export→To Briefcase Allows you to export a configured product structure
in TC XML format. You must choose the appropriate
transfer mode for the destination system and selected
structure.
If you track changes with incremental changes, you
can optionally export only changes to the configured
assembly. Only those objects directly or indirectly
affected by incremental changes configured on the
structure are exported in full, and other objects are
exported as stubs.
For details of how to export structure changes tracked
by incremental changes in TC XML format, see
Exporting and importing incremental change data.
Export→Objects to Excel Exports the selected structure lines to an Excel
spreadsheet.
Export→Objects to Word Exports the selected structure lines to a Microsoft
Word document.
Export→Configured NX Exports a product structure that is configured with
Assembly revision rules and variants to NX in native format.
This command is visible only if your administrator
sets the TC_ExportConfigUGNXAssembly
preference to TRUE and NX is installed on the client
machine.
Export→Software Allows you to export software parameter data in PLM
Parameters XML format.
Stock Selection Rule Allows you to choose the rule that selects stock
material. Typically used in aerospace and defense
environments.
Command Description
Send Data To Sends selected data to another application or external
program. Your Teamcenter administrator uses the
Business Modeler IDE application to create new
application interface types associated with a specific
application. Each of these types are available in the
Send Data To dialog box.
Send Additional Data To Sends additional data to a running session of the
application launched using the Send Data To menu
command.
Vendor Part Selection Rule Allows you to apply a predefined vendor parts
selection rule to the structure.
BOM Grading→Run Allows you to grade or validate the product structure
or subassemblies against predefined criteria.
For more information, see Grading structures.
BOM Grading→Show Allows you to view grading results for the select
Results product structure or subassembly.
Request Substance Allows you to request a material substance
Compliance Check declaration (MSD) from the supplier of vendor parts
for the selected line and its children.
Initiate Substance Runs a compliance check of the selected part or
Compliance Check assembly against selected regulations.
Apply Exemptions Allows you to approve the exemption of a part from a
selected regulation.
Initiate Compliance Allows you to invalidate all substance compliance
Results Validation results that are qualified for invalidation because of
expired exemptions.
Baseline Copies work in progress (WIP) item revisions. During
the development of a product design, you may need to
share such copies of your working design with other
users at the same or different sites. You can also save
your design for future reference.
For more information, see Using baselines.
Validate Occurrences Allows you to validate that a selected line and
(optionally) any child lines meet the business rules
defined by your administrator for structure edits.
For information, see Performing on-demand
validation.
Manage Global Alternates Allows you to define global alternates and a preferred
alternate for the selected component.
Compare... Compares two product structures (or different
revisions of the same structure) in separate windows.
Clear Compare Clears the results of comparing two product
structures.
Command Description
Graphical BOM Compare Compares two revisions of a part or assembly and
examine the difference in the Viewer pane. You
cannot use this command to compare multilevel
structures.
Intermediate Data Capture Saves the current structure configuration in PLM
XML format on your system for later retrieval or
transfer.
For information about creating intermediate data
captures, see Using intermediate data captures.
Markup→Markup Mode Turns markup mode on or off.
Markup→Show Markup If the selected line has an associated markup, allows
View you to view its properties.
Markup→Delete Markup Deletes the active markup for the selected line.
(this level)
Markup→Apply Markup Applies uncommitted changes in the markup
(this level) associated with the current line. Any markups
associated with lines below the current selection are
not committed.
Markup→Apply Markup Applies uncommitted changes in the markup to the
(all levels) structure, starting from the top line.
Markup→Validate Access Identifies if you have the necessary write access to
to Apply Markups (all the BOM view revision (BVR) to commit changes in a
levels) markup associated with any line below the structure’s
top line.
Site Check In/Out→Check If you are working with Multi-Site Collaboration,
Out to Site allows you to check out the selected object to a chosen
site.
Site Check In/Out→Check If you are working with Multi-Site Collaboration,
in from Site allows you to check in the selected object from a
chosen site.
Roll up Report→Create Allows you to create a rollup report.
For more information, see Creating structure
properties rollup reports.
Roll up Report→View Allows you to view a rollup report.
For more information, see Creating structure
properties rollup reports.
Roll up Report→Templates Allows you to manage templates for rollup reports.
For more information, see Creating structure
properties rollup reports.
Note You may see additional commands in this menu if optional features are
installed at your site. For example, if you install Teamcenter Integration
for NX, an Export NX Assembly command is available. Similarly, some
commands are hidden unless a preference setting is changed. For
information about any additional commands, see the documentation for the
optional feature or contact your Teamcenter administrator.
Graphics menu
Note The Graphics menu appears when you click the Graphics tab.
Command Description
Selection→Select All Selects all the objects displayed in the viewer.
Selection→Select Unselects any objects currently selected in the viewer.
None
Selection→Reverse Selects all objects not selected in the viewer, while
Selection simultaneously unselecting any objects currently selected
in the viewer.
Selection→Expand Expands the assembly tree until the part selected in the
to Selected viewer is displayed in the tree.
Visibility→View Blanks and unblanks objects loaded in the viewer.
Selected
Note The term loaded refers to an object whose JT file
has been loaded in the viewer. A loaded object may
or may not be visible, depending on whether it has
been blanked or unblanked.
Visibility→Blank Makes any objects selected in the viewer invisible.
Selected
Visibility→Blank All Makes all objects in the viewer invisible.
Visibility→Unblank Makes all objects loaded in the viewer visible.
All
Visibility→Reverse Makes any currently visible objects invisible, while
Blank All simultaneously making visible any loaded objects which
are currently invisible.
Visibility→Unload Unloads any objects selected in the viewer.
Selected
Edit Modifies the color, transparency, and shine of selected
Color/Translucency objects in the viewer. These settings only apply to the
currently loaded objects. The next time the edited object
is loaded, the settings revert to the default color and
translucency.
Insert Allows you to insert JT, stereolithography (.stl) and VRML
(.wrl) files as reference graphics.
Insert→Insert from Inserts a reference graphic from the operating system,
File using the Open by Name dialog box.
Command Description
Insert→Insert from Inserts a reference graphics object from the clipboard.
Clipboard
Note Only item revisions (not items) can be displayed as
reference graphics.
Views→Views Creates, edits and displays standard views, using the
Control... Rotate and Standard Views dialog boxes.
Draw Children Displays the components of a subassembly. You can also
access this command if you right-click in the product
structure.
Show Breaks down solids in the corresponding monolithic JT files
Subcomponents and make the subcomponents independently controllable.
This function is only available for only leaf and unpacked
structure line nodes.
Hide Removes all merged subcomponents and the one-level tree
Subcomponents from the tree. You can load or unload the monolithic JT file
related to this structure line node in the normal way.
Export 3D File Exports the current visible objects to a STEP or VRML file.
Transformation→ Generates an exploded view for use in technical
Temporary illustrations.
Transformation
Transformation→ Modifies the physical location of a part (or set of parts) in
Persistent an owning assembly.
Transformation
Replace JT File Replaces the JT file that represents an item revision. You
can choose a replacement file from one of the JT files
associated with the current structure line item.
Clearance→ Allows you to set the clearance calculator, define the
Preferences parameters of the clearance calculation, and indicate how
the results should be displayed.
Clearance→Toggle Allows you to change the clearance results that are
Results Window displayed.
Performance... Sets rendering, culling and general performance
preferences.
Preferences... Sets clearance analysis and general viewer preferences.
Command Description
Open BOM View Displays a list of other BOM views in which you can open
the selected data. If the line has no BOM views, this
command appears as No BOM View to open.
Command Description
Guided Component Searches for matching components within an assembly.
Search This search allows you to choose from a list of only
those classified workspace objects that fit into the first
component of your search. You must first configure it in the
Classification Administration application.
Properties on Allows you to edit the properties of the object represented
Relation by the selected line.
Cut Cuts the selected lines from the structure and places them
on the clipboard.
Copy Copies the selected lines in the structure and places them
on the clipboard.
Paste Pastes the components from the clipboard as children of
the currently selected (assembly) line in the structure or
into NX.
Revert Edit Undoes the last manual edit of the selected line.
Paste Property Allows you to paste a property value from the clipboard
into one or more structure lines.
Set In Context Allows you to edit the properties of an occurrence in the
context of a selected line, that is, to create an absolute
occurrence.
Remove In Context Removes override data from an absolute occurrence
Override without entering replacement data.
Show/Hide In Shows or hides the line that is the context of a particular in
Context BOM line context edit.
Expand Expands the substructure immediately below the selected
lines.
Expand Below Expands the complete substructure below the selected
lines.
Expand Below... Expands the substructure below the selected lines to a
user-selected level. You can also collapse an expanded
substructure when you choose this option (hide certain
child lines).
Expand to Type Expands the complete substructure below the selected lines
until a specified type is encountered.
Unload Below Unloads all lines below the selected line to free memory.
Collapse Below Collapses the complete substructure below the selected
lines (hide all child lines).
Generate Report Generates a report on the selected object. You can choose
the reporting tool and formatting options.
Send an Instant Allows you to initiate communication with the user who
Message to Owning owns the item or item revision represented by the selected
User line. The Microsoft Office Communicator integration must
be installed on your system.
Open With Opens selected data in a rich client view.
Command Description
Send To Sends selected data to another application or an
external program. Your Teamcenter administrator uses the
Business Modeler IDE application to create new application
interface types associated with a specific application. Each
of these types are available in the Send Data To dialog box.
Check In/Out Checks out the object represented by the selected line if it is
not already checked out or checks in the object represented
by the selected line if it is checked out.
Refresh Synchronizes the currently displayed product structure
with the database. The displayed structure refreshes with
changes that have been made in other sessions and saved
since you loaded the currently displayed product structure.
Properties Allows you to view all properties of the selected line. You
can edit those properties to which you have permission.
Access Shows any Access Manager restrictions on the selected line.
Project®Assign Assigns the selected structure to a predefined project.
Project®Remove Removes the selected structure from a project to which it
is assigned.
License®Attach Attaches an ADA license to the selected workspace object.
License®Detach Detaches the ADA license from the selected workspace
object.
Multi-site Allows you to synchronize a selected object, component or
Synchronization assembly with the remote site in a Multi-Site Collaboration
environment. It is only necessary to synchronize structures
if the Sync State property shows the structure or a
component is superseded or out of date.
Add To Favorites Allows you to add the selected structure to your list of
frequently used objects.
Update Suppressed Updates any suppressed occurrences attached to the
current line.
Remove Design from Removes the selected design from the product structure. It
Product is used when your site utilizes Platform Designer.
Search Reference Allows you to search for reference designator values; this
Designators search allows you to specify wildcards.
Show Markup View If the selected line has an associated markup, allows you
to view its properties.
Delete Markup (this Deletes the active markup for the selected line.
level)
Apply Markup (this Applies uncommitted changes in the markup associated
level) with the current line. Any markups associated with line
below the current selection are not committed.
Disconnect Disconnects the currently selected line with a revisable or
nonrevisable connection to another line.
Command Description
Connect Connects the currently selected line to another line with a
revisable or nonrevisable connection.
Button Purpose
These standard buttons are located on the main toolbar at the top of the product
structure pane.
Soft abort If enabled, allows you to terminate the current
operation without closing Structure Manager
or losing data.
Cut Cuts the selected lines from the structure and
places them on the clipboard.
Copy Copies the selected lines in the structure and
places them on the clipboard.
Paste Pastes the components from the clipboard as
children of the currently selected (assembly)
line in the structure or into NX.
Delete Deletes the selected lines from the structure
and does not place them on the clipboard.
Save Saves changes you made to the structure since
it was last saved.
Split occurrence Splits a line that represents several
occurrences into two branches. The new
branch and the original (changed) branch
initially have the same notes, variant
conditions, and other data, but you can
subsequently modify them independently
Open Opens the selected structure line in a new
window.
Button Purpose
Signal Creates a new message or signal.
For more information about creating signals,
see the Embedded Software Solutions Guide or
the Systems Engineering Guide.
Remove Removes the selected lines from the structure
completely and does not place them on the
clipboard.
Revert marked Cancels any pending additions or removals of
pending edits the selected lines. It also cancels any pending
property edits.
Note This button is visible only if you select
the Display Markups for pending
edits option on the Product Structure
tab of the Options pane, and then
restart Structure Manager. To
display the Options pane, choose the
Edit→Options command.
Certain edits are committed
immediately to the database and
cannot be reverted. Such edits are not
displayed in red strike-through text.
Revert all Cancels all pending additions or removals of
lines anywhere in the structure. It also cancels
any pending property edits.
Note This button is visible only if you select
the Display Markups for pending
edits option on the Product Structure
tab of the Options pane, and then
restart Structure Manager. To
display the Options pane, choose the
Edit→Options command.
Certain edits are committed
immediately to the database and
cannot be reverted. Such edits are not
displayed in red strike-through text.
Remove design Removes the selected design from the product
from product structure. This command is used when your
site utilizes Platform Designer.
Replace design in Replaces the selected design in the product
product structure with another design. This command
is used when your site utilizes Platform
Designer.
Replace part in Replaces the selected part in the product
product structure with another part. This command is
used when your site utilizes Platform Designer.
Button Purpose
Edit the variant Allows you to view or edit the variant condition
condition on the selected lines.
Change to replace Changes separate deletion and addition
actions to a single replacement action.
Pack selected line Packs the selected lines so that all lines with
the same item revision and find number are
displayed as a single line. The actual quantity
of lines appended to the node.
Unpack selected Unpacks the selected packed lines so that they
line are displayed as separate lines, one for each
occurrence.
View properties Shows the properties of the selected line.
Button Purpose
Move to first Jumps to the earliest revision of the selected
revision component or subassembly.
Move to previous Jumps to the preceding revision of the selected
revision component or subassembly.
Move to next Jumps to the succeeding revision of the
revision selected component or subassembly.
Move to last Jumps to the final revision of the selected
revision component or subassembly.
Markup mode Enables or disables markup mode.
Button Purpose
List substitute Adds or removes substitute components or set
components the preferred substitute.
This button is enabled if the selected line may
have substitutes; otherwise, it is disabled.
Manage global Shows a list of the global alternates available
alternates for the selected line. You can add alternates
and select a preferred alternate. The preferred
global alternate is indicated by a check mark.
Quick add Adds a new component to the selected
assembly by entering the item identifier of the
new component.
The following symbols are displayed at the bottom right corner of the product
structure pane and show the current status of the selected line.
Shows if you have write access permissions for
the selected line.
Shows if you have delete access permissions
for the selected line.
Shows if you have access permissions to change
the selected line.
Shows if the item revision represented by the
line is currently in a workflow process.
Shows if the item revision represented by the
line is currently checked in or checked out.
Shows if the item revision represented by the
line is currently released.
Shows if the item represented by the line is
currently published.
Shows if the item or revision represented by
the line is currently classified.
Shows if the item or revision represented by
the line is currently archived.
Click , or choose View→Show/Hide Data Panel to display the data pane which
contains these tabs.
Tab Description
Attachments Allows you to select and view attachments to the selected
line, for example, a dataset or form.
The visibility of this tab is controlled by the setting of the
BOM_Display_Attachments_Panel preference.
Tab Description
Graphics Displays an image of the selected line or lines, if a
DirectModel dataset is available.
Incremental Change Allows you to add, edit, or remove incremental changes
Info for the selected line.
The visibility of this tab is controlled by the setting of the
Incremental_Change_Management preference.
For more information, see Managing incremental changes.
Referencers Allows you to perform a where-used or where-referenced
search for the selected item revision.
The visibility of this tab is controlled by the setting of the
BOM_Display_Referencer_Panel preference.
Roll Up Report Allows you to view or create rollup reports for the selected
line. You can also create and manage rollup report
templates.
Supersedure Displays supersedure information for the selected item
revision.
The visibility of this tab is controlled by the
ECM_SET_GENEOLOGY preference.
Variability Allows you to assign variability to a product context for use
in Platform Designer.
The visibility of this tab is controlled by the
PSM_global_option_item_ids preference.
Variants Displays variant data such as options, option defaults,
and rule checks. Variant conditions are displayed in the
Properties pane.
The visibility of this tab is controlled by the
BOM_Display_Variant_Super_Panel preference.
Vendor Parts Allows you to view and select from the vendor
parts associated with the selected item revision.
This tab is available only if the optional vendor
management solution is installed; consequently, the
VendorManagement_feature_installed preference is
set.
Image Meaning
Item
Image Meaning
Item revision (structure line or BOM line)
Form
Dataset
BOM view
Part
Design
Alternate ID
Document
Document revision
DirectModel dataset
UGMaster dataset
UGPart dataset
UGScenario
Variant item
Image Meaning
Absolute occurrence created
Added structure line
Process
Process revision
Process variable
Snapshot
PS connection
PS connection revision
PS signal
PS signal revision
Allocation
Allocation map
Image Meaning
Tracelink
If your site has online help installed, you can access application and view help from
the rich client Help menu or by pressing F1.
For more information about rich client perspectives and views, see the Rich Client
Interface Guide.
Basic concepts
Before creating or modifying product structure, you should read Getting Started with
Product Structure, which describes the basic concepts behind product structure and
includes advanced information on how to use and administer it.
Engineers group parts into assemblies to allow reuse of the same assemblies
elsewhere in the product or in other products. An assembly can contain components
that are piece parts or assemblies. In this way, you can model a complete product
structure as a hierarchy of single-level assemblies.
Teamcenter supports two methods of modelling parts. You can create an item that
represents the part and CAD design simultaneously, which is the method familiar
to former users of Teamcenter Engineering Process Management. You can also
create parts and designs separately, then link (publish) parts and designs when
they are ready to release.
You can view previously created graphics that represent all or part of the structure,
allowing easy visual identification of a component in the structure.
Structure Manager allows you to create assemblies that are one of the following:
• Precise
A precise assembly references a specific revision of each component.
• Imprecise
In an imprecise assembly, the revision configured in the Structure Manager
window is determined by the revision rule currently in force.
You can define sophisticated revision rules to configure the structure in different
ways. For example, you can use revision configuration based on the release status
of each item revision. This allows you to configure the structure according to its
effective date or unit number, or the date released.
For more information about revision rules and their use, see Using item revision
configuration.
To take full advantage of Structure Manager, you should be familiar with the
Teamcenter elements that are used to define and present product structure, the
basic process of creating product structure, and how item revisions relate to how you
manage default and multiple product views.
Element Purpose
Aggregate occurrence A single occurrence representing multiple usages of the
same component item by setting the quantity attribute.
Use an aggregate occurrence where separate occurrences
are not required to distinguish individual usages (for
example, rivets).
Assembly A single-level assembly with no hierarchy, as distinct from
a multilevel product structure. Assembly data is stored in
a BOM view revision.
BOM view revision A workspace object that stores the single-level assembly
structure of an item revision, that is, occurrences. Access
may be controlled on the structure (BOM view revision)
independently of other data. BOM view revisions are only
meaningful in the context of the item revisions for which
they are created.
Element Purpose
Component A node in a structure—a child in a single-level parent-child
relationship. When you add components, you create an
occurrence for each component added.
Contrast with instance—a child in a multilevel parent-child
relationship.
Note Do not confuse a component in Teamcenter with a
component in NX. In Teamcenter, a component is a
single-level assembly-child relationship (a relative
occurrence).
Configuration rule A rule that configures the structure. There are two kinds of
configuration rules: revision rules and variant rules.
Custom note Provides additional information about an item or item
revision. A custom note contains unique information about
the part or document. Compare with standard note.
DirectModel dataset A dataset containing a JT (visualization) file. Files of this
format can be generated by NX and other applications.
Default view type Teamcenter applies a default global view type where
possible, for example, when opening an item revision. Use
of a default view type avoids the need for a user to choose
between multiple views. The default view type is set by the
PSE_default_view_type preference.
Design The CAD design solution that implements a business
part. Each part may be implemented by one or more
CAD designs. Likewise, a CAD design may implement
more than one part. Certain parts do not require a design
solution, for example, paint and glue.
Find number A number that identifies individual occurrences (or groups
of occurrences) within a single-level assembly. Components
are ordered by find number within an assembly.
Note By default, occurrences are populated with numeric
find numbers. However, they may contain any text
string. Teamcenter ignores nonnumeric values
when ordering components in the assembly.
Line A line in the product structure and all the attributes
associated with it. A line represents a single occurrence
in the structure. When you click a line, you select all
the properties associated with the line, including both
occurrence and item properties.
Note In Structure Manager, you can edit appropriate
properties of the selected line, for example, the
item revision or note.
Note (occurrence Assembly related textual data that is associated with an
note) occurrence. Contrast with standard note and custom note.
Element Purpose
Note type (occurrence The system administrator creates different occurrence note
note) types. Users can then specify values for the different note
types where required.
Occurrence (Sometimes called relative occurrence.) A hierarchical
structure relationship between the immediate parent
assembly and its child component item (in an imprecise
assembly) or item revision (in a precise assembly). You
can use a find number to identify an occurrence, but this
number may not be unique. Data can be stored on the
occurrence, including occurrence notes and transforms.
Part A business object that is represented by an item in the
product structure. Each part may have one or more CAD
designs associated with it. The part is managed by the
company’s part releasing system; it is typically revised and
releases separately from the associated design.
Piece part A part with no structure (no associated BOM view revision).
This is sometimes referred to as a detail part.
Product structure The whole multilevel product structure, as distinct from a
single-level assembly (which is sometimes referred to as a
BOM view revision or BVR).
Standard note Provides additional information about an item or item
revision. A standard note typically contains information
provided by a standards organization and can be attached
to multiple parts or documents. Compare with custom note.
Substitute A particular occurrence may have substitute components
that are interchangeable for that specific occurrence. One
is the preferred substitute, and Teamcenter shows it
in the structure. If these substitute parts are intended
as manufacturing substitutes, you can manufacture an
assembly using any of the substitutes.
View type An attribute of a BOM view revision that specifies its
intended usage, for example, design or manufacture. The
administrator may define any number of view types.
A chain of BOM view revisions of the same type are
anchored by a BOM view of the corresponding view type.
An item revision may contain only one BOM view revision
for each view type. The view type distinguishes one BOM
view revision from another BOM view revision of the same
item revision.
allows you to interpret the relationship between the assemblies and piece parts. An
assembly has structure of its own; a piece part has no structure.
In My Teamcenter, you can attach CAD files, specification documents or other
information to the top-level assembly (the product itself), or to any of the assemblies
or piece parts.
You can also attach item elements (sometimes called general design elements or
GDEs) to items in the product structure. They represent features that are not parts
of the physical structure but are associated with it or implemented by it, for example,
weld points or ports for connectors. They are stored as occurrence relations.
You can build, view, and manipulate the product structure in Teamcenter, or you can
import it from an MCAD system such as NX.
You can include 3D visualization data as Direct Model dataset objects within
an item revision. Users can then view these images in the embedded viewer in
Structure Manager.
Understanding items
The term item generically describes all types of items that exist in Teamcenter. To
effectively manage many types of item, you should create specific types of item
appropriate to your business.
You should also distinguish between the item and its associated item revisions,
as follows:
• Item
An item commonly represents manufactured product such as parts, assemblies,
end items, and tools. It is an abstract container that holds item revisions
and general documents that apply to the product, rather than to a particular
revision. You cannot build or test an item.
• Item revision
An item revision represents a physical entity and is a unique, specific revision
of a previously created item. It may have associated CAD models, drawings or
specifications that are applicable only to this revision. You can release an item
revision with a workflow or through change management. This action applies
a Released status to the item revision, preventing further edits and allowing
Teamcenter to maintain product history.
Users can search for an item if they do not know the applicable item revision;
all available item revisions are grouped below the item. When the relevant item
revision is identified, you can retrieve CAD files and other file representations of
part data including 2D or 3D images of drawings or models. If you search for an
assembly, you can also view the structure of the product.
Each item has at least one item revision, as described in Understanding items.
Each item has a label containing two pieces of information:
• Item identifier
An identifier for the item. No two items can have the same item ID. An item ID
may be the part number or the document number of the object it represents.
In a standard environment, each item has a single, unique identifier. However, in
a multifield keys environment, the administrator may combine a domain name
(business object type) and one or more of the object’s properties to construct the
identifier. For example, in the Part{item_id} key, Part is the domain. In this
environment, the item ID may not be unique and the system may present you
with a list of possible items if you specify a nonunique item ID.
• Item name
A short description that is usually a logical name such as Bolt, Bracket, or
the title of a document.
Where used
A where used search allows you to find all parent assemblies in which a part is used,
navigating up the structure. You can set the search depth as follows:
• One level
Reports immediate parent assemblies only.
• All levels
Reports all assemblies up to the top-level product.
• Top level
Reports final products only.
Compare
You can compare two structures to view and reconcile the differences between
structures. The comparison is performed on the as-expanded structure and you can
choose the areas of the structure to compare. You can set the revision rule and
variant rule separately for each structure, allowing different configurations to be
compared. The comparison identifies quantity and revision differences in three
modes:
• Single level
Compares only the first levels of the product structures.
• Multilevel
Performs a single-level comparison at the top level, and then invokes further
single level comparisons on any subassemblies that match between the two
product structures. This process is repeated successively down the product
structure.
The results are displayed in a dialog box that steps you through each difference. You
can also print the results to a report.
You can also perform the comparison graphically in the embedded viewer, which is a
useful tool for designers. In this case, the components present in one structure but
not the other are highlighted in separate colors and can be isolated from the other
common parts, allowing easy visualization of the changes. You can also perform this
comparison on different revisions of piece parts to highlight geometry changes.
The Multi-Structure Manager application allow you to compare two views of the
same product structure to identify differences. For example, you may want to
compare two revisions of the same structure or the design and manufacturing views
of the same structure. Any anomalies found during the comparison are reported,
although an imbalance between the two structures may not necessarily indicate a
problem with either of the structures. The following anomalies are reported:
• Lines in the source structure that are not consumed in the target.
You can run an analysis manually or in batch mode. You can also run it with or
without variant options applied.
Find in structure
You can search for components in the structure by any of their properties, for
example, item ID, name, attributes on the item revision master form, and occurrence
note attributes. You can build a query with as many expressions as necessary, giving
a flexible way to find components in large structures. This search works on the
expanded state of the structure.
Nonspatial searches
You can search a structure by organizational attributes, rather than performing
spatial searches. Searches can be made against one or more such attributes, for
example, partition identifier, logical position, usage address, and absolute occurrence
identifier. You do not need to configure appearances to run this type of search.
Fast searches
Teamcenter provides a quick spatial search mechanism that allows you to query a
given configuration of the product structure to locate parts in a particular area of
the product. Spatial searches are primarily useful for large products containing
thousands of structure lines.
You can specify the area to search by entering spatial coordinates in the search
dialog window or by dragging a search box on the viewer pane. The search results
are displayed as a list of items or item revisions in the specified area. Spatial
searches may be combined with Classification searches, saved queries, and filters to
refine the search results.
The quick spatial search does not require you to maintain data caches. However,
Teamcenter supports appearance searches and quick part locator (QPL) searches if
you maintain secondary data caches for use with those mechanisms.
For more information about spatial searches, see Making spatial and attribute
searches.
o If there are several view types available and Teamcenter cannot determine
the appropriate selection, it prompts the user to select a view types.
Consider setting the default view type in Role preference files, for example, so that
the preference file for the Designer role has the default view type of Design, and
the preference file for the Manufacturing Engineer role has the default view
type of Manufacture. You can set the default view type option in any of the other
preference files—User, Group, or Site.
component to a new revision, you must manually update the assembly by removing
the old revision of the component and adding the new revision.
You configure the precise references with a revision rule containing a precise rule
entry. However, you can dynamically configure a precise assembly (treated it as
imprecise) by applying a revision rule that does not contain the precise rule entry,
or has the entry at a lower precedence. Precise assemblies are useful in situations
where you must control the configuration very carefully, for example, in aerospace
environments.
When the parent assemblies are released and can no longer be modified, any change
may result in significant revision ripple. If you incorporate new revisions of piece
parts, every parent assembly to the top of the structure must also be revised.
However, you can group changes into batches to minimize this effect.
A100/A
View Type
BOMView Manufacturing
Design Revision View
View
P10 A40 P10
Multiple views
You can also use multiple views if the different structures do not reference the same
set of piece parts, for example, to model a spares structure that is derived from a
design structure.
You can also create multiple views to exchange data with ERP systems, particularly
if are several manufacturing sites.
The structures in the different view types are independent of each other—changes
in one view type do not affect any others. If you intend to keep multiple views
synchronized, you must do this manually using data generated by the Compare
feature. You can apply access rights separately to each view type.
Similarly, you can be submit each view separately to a release procedure. Typically,
you employ a formal release process (for example, a change management procedure)
to approve multiple views as consistent and valid before they are released and
locked against change.
Note Teamcenter does not attach any semantic significance to specific view types.
However, it is good practice for the name of each view type to reflect its
function or purpose.
example, design). This may be useful if the structures differ at a high level, but
share the same structure at a lower level.
Basic tasks
Task Overview
Browse product You can view the assembly structure of a product, navigate
structure around the structure, and find components in the structure.
From any point in the structure, you can access the
associated data, for example, datasets.
Visualize product You can display a graphical representation of the product,
structure if the relevant DirectModel dataset image is associated
with the product structure. Selecting a component in the
viewer highlights the component in the product structure
and vice versa.
Build and edit You can create and modify product structure using Cut,
structure Copy, Paste, and Remove commands. You can specify
related information, such as torque settings, for any
component.
Make where-used A where-used search reports all assemblies in which a part
searches is used. Perform this search in the Referencers pane.
Compare product You can compare two Structure Manager structures, each
structures configured as required, to highlight any changes.
Use item revision You can set a revision rule that determines the revision of
configuration each component that Teamcenter configures. This allows
you to configure a structure as it was or will be on a
particular date, for example, by utilizing effectivity data on
each item revision (release status).
Configure variant You can set a variant rule to determine which variant
products and components are configured in the structure. Teamcenter
Configure modular references variant data you create on the structure to
variant products determine the appropriate variant components.
Open a structure in You can load a complete product structure or selected
NX or Teamcenter components from the structure, into NX directly from
lifecycle visualization Structure Manager, if you have installed Teamcenter
Integration for NX.
Teamcenter Integration for NX allows you to make changes
to the assembly structure in NX and synchronizes the
changes into the Teamcenter database.
Note You can also manage product structures created
in other CAD packages, if you have installed the
appropriate integration software.
For more information, contact your Siemens PLM
Software representative.
Setting the viewer memory allocation and Java heap size . . . . . . . . . . . . . . . . 2-6
You may explicitly change how a particular set of item revisions are packed or
unpacked by choosing the View→Pack and View→Unpack menu commands. This
selection applies only for the duration of the session.
• Corresponding preference name: PSEAutoPackPref. Accepts a logical 0 or
1 as a value.
Enabling markups
This option allows you to mark proposed changes on the product structure or an
assembly, and then save the markup as a persistent workspace object. The default
setting is off.
• Default setting: 1
• Default setting: 1
2. Choose Edit→Options.
Teamcenter displays the Options dialog box.
4. From the BOM Line Title format for Items of type list, choose the item type for
which you are defining the structure (BOM) line title format.
5. Enter a combination of fixed text and other structure line properties in the text
field, for example:
$bl_item_item_id, with name $bl_item_object_name of type $bl_item_object_type
and find number $bl_find_no
The $string entries are structure line property names that act as substitution
points when populating the cells in the Structure Manager columns. Property
names are listed in the bom_attr.h file.
6. Click OK.
Teamcenter closes the Options dialog box.
7. Refresh the Structure Manager window to apply the title format change.
• Default setting: 1
The release status rule controls who has write access to the release status and
consequently can attach effectivity objects to it. This also determines who can
initially create effectivity. Similarly, the effectivity rule controls who can edit an
existing effectivity object.
For more information and examples, see the Security Administration Guide.
• PUBLISH_AlignableSourceTypes preference
Determines the types that can be used as the source of a publish link. A publish
link connects occurrences and can be used to copy information from a source
occurrence to a target occurrence. For example, it allows Teamcenter to copy
transform data from a design occurrence to a part occurrence.
• PUBLISH_AlignableTargetTypes preference
Determines the types that can be used as the target of a publish link.
Setting Description
New Every item is given a new find number within the current
BOM view, starting with 10 and increasing by increments
of 10.
Existing If an item with the same identifier already exists in the
BOM view, Teamcenter assigns the inserted item the same
find number. If not, the item is assigned a new find number
according to the default sequence.
Setting Description
None No find number is allocated to items inserted into a BOM
view; users can add their own find number later.
o Item revision
If no configured revision is found in a precise structure, Teamcenter displays
??? for the revision. If this is an assembly, it cannot be expanded.
o Item type
o Quantity
This is the total quantity represented by the line, which is greater than one if
the line is packed or represents an aggregate occurrence. If any of the values
are As Required, the quantity is shown as A/R.
o Other properties configured for your site or you have added to the display.
For more information about adding properties, see Displaying properties.
By default, the first level of the structure does not automatically expand when
opened, as this may cause a performance problem with very large and very flat
structures. To expand the structure automatically, your administrator sets the
PSE_expand_on_open preference to 1 or undefined.
If lower levels of the structure are initially hidden, the hidden lines are represented
by a … symbol and you can click this symbol to reveal them.
Teamcenter also colors certain lines in the product structure to indicate a particular
status, as follows:
• Imprecise assemblies
The structure line appears in gray.
• Precise assemblies
The structure line appears in green.
• Substitute occurrence
The structure line appears in blue.
Note All colors are defaults and may be changed by editing the relevant
preference. For more information, see the Preferences and Environment
Variables Reference.
You can attach datasets, documents or forms to a line in the structure. To view
the contents of any attachment, select the line and click the Attachments pane.
Attachments made in a specific context are visible only when you select the relevant
absolute occurrence. You can use incremental changes to track edits to forms or
documents.
The information center at the bottom right corner of the application window contains
symbols that indicate Where Used, Where Referenced, Child Count, Object
Access, and Object State. You can turn off these functions by right-clicking with
the cursor over the information center. Turning off these functions improves display
performance when expanding an assembly or selecting a line.
Note Once you have expanded the structure under the top line, you cannot set
a new top line in the same window. Open the new top line in a separate
window before expanding it.
• Occurrence properties
The use of an item revision in the context of its parent assembly.
• Display properties
Properties calculated to show the state of some other property.
2. Choose Insert Column from the shortcut menu and Teamcenter displays the
Change Columns dialog box.
3. In the Change Columns dialog box, highlight the required properties and click
the Add button to transfer these properties to the right-hand pane.
Note The dialog box only shows columns that are not already included in the
structure tree.
To remove a column, right-click on the column and choose Remove this column
from the shortcut menu.
• Depending on your CAD environment, each find number may map to a callout
number or a line number in the CAD design. If the find number is linked to the
callout, changes of quantity made in the CAD design may directly update the
quantity shown in the product structure.
• If appropriate, you can rearrange the structure in find numbers by clicking the
Find Number column header. This rearrangement persists for future Structure
Manager sessions, until you make another selection.
By default, when you pack the product structure, Teamcenter packs by find number,
item ID, and variant condition. This allows you to pack two or more occurrences of
the same item, if each occurrence is has the same find number, item ID, and variant
condition. To pack structure lines, they must all have the same occurrence effectivity
object or objects; that is, they must have shared effectivity; it is not sufficient for the
lines to only have the same effectivity ranges.
You can define if occurrences are packed on your workstation by changing the
PSEAutoPackPref preference. Your site may also customize Teamcenter behavior
so that the structure is packed by criteria other than find number. For more
information, see Pack structure lines.
Your Teamcenter administrator can configure find number processing.
• Change the way find numbers are assigned to BOM views and BOM view
revisions by setting the PS_new_seqno_mode preference.
• Disable updating of duplicate find numbers of the same item, by setting the
PS_Duplicate_FindNo_Update preference to disabled.
Open a structure
You can open a structure by any of the following methods:
o Enter strings for the ID or the name of the items you want to open.
This button opens any of the last four top-level structures you opened. This
list is saved across sessions, and is an easy way to reopen structures you were
previously working on. Click the item revision you want to open.
Note You can configure the number of entries shown in the MRU list by
right-clicking the button and moving the slider to the desired number.
1. Copy the items or item revisions to the clipboard in the other application,
then go to Structure Manager.
2. Click the Clipboard button to display the copied objects and choose the
items or item revisions you want to open in Structure Manager.
3. Repeat the previous step as necessary. You can only open one item or item
revision at a time.
2. Right-click the object to display the structure line shortcut menu and choose
Send To.
Teamcenter displays a list of the destination applications (for example,
Multi-Structure Manager and My Teamcenter).
If the object is an item or BOM view, Teamcenter typically uses the default
revision rule to determine the revision opened, as follows.
Drag the line representing the structure from another application such as My
Teamcenter and drop it into the empty navigation tree pane.
• Click a link
Click a link in the Open Items, History, or Favorites sections of the navigation
pane.
If the current Structure Manager window already contains an opened structure, all
of these methods create a new Structure Manager window.
To reduce the amount of time-consuming database interaction required to view a
product structure, the components of an assembly are not loaded from the database
until you expand the assembly. The first expansion may be slow, but subsequent
expansion and contractions do not require data from the database and are therefore
faster.
• If the item revision has exactly one BOM view revision, it opens the BOM view
revision.
• If the item revision has a BOM view revision of your default view type, it opens
that BOM view revision.
If none of the rules match, Teamcenter uses the default view type.
Expand an assembly
• Choose View→Expand Below... to expand all nodes below the currently selected
node or nodes. Teamcenter displays the Expand to level dialog box, allowing you
to enter the desired number of levels to which you want to expand the structure.
The structure expands to the piece parts, where appropriate. Teamcenter loads
any necessary components from the database.
Note If you try to expand the structure by fewer levels than the existing
expansion, the display does not change unless you select the Collapse to
level check box in the dialog box.
If you try to expand a large assembly, Structure Manager displays an
Expanding the tree may take a long time. Do you want to continue?
message. Click Yes to continue with the expansion.
If expansion of selected BOM line types is restricted by a closure rule,
Structure Manager displays a Cannot expand BOM line message.
For more information about restricting expansions with closure rules, see
Set or unset a closure rule.
Collapse an assembly
Collapse an expanded assembly in one of two ways:
• Select the expanded node and choose View→Collapse Below.
Or
1. Select the expanded node and choose View→Expand Below.... Teamcenter
displays the Expand to level dialog box.
2. Enter the level to which you want to collapse the assembly, select the Collapse
lower level check box and click OK.
For example, if the assembly is expanded to five levels and you enter 3,
Teamcenter collapses the assembly to three levels.
Unload lines
If you encounter memory problems when expanding a structure, you can unload
selected lines to free memory manually.
1. Right-click the line below which you want to unload lines (for example, a
subassembly) and choose Unload Below.
Teamcenter displays the Unload Below dialog box.
Teamcenter displays the View/Set Closure Rule for Expansion dialog box.
2. Select the required closure rule in the Rules list, and then enter any filter
attributes necessary for the selected rule. In the example shown, you must
specify at least one project identifier.
Note In a conditional clause, evaluation of the left-hand expression must
give primitive data types such as string or integer. If the related
property is a typed reference, untyped reference, relation, or external
references, the left-hand expression must evaluate to a primitive data
type that uses the property of the object. You must use the property of
the object, rather than the object itself. For example, instead of using
PRIMARY.bl_uom==”kg” in a condition clause, you should traverse
from BOMLine to UnitOfMeasure using bl_uom and then use a
symbol property of UnitOfMeasure.
Primary Secondary
object Primary object Secondary Relation Related Action Conditional
class object class object type property type clause
CLASS BOMLine CLASS UnitOfMeasure Property bl_uom Skip SECONDARY.
symbol
==$var
Note Line breaks are not supported in closure rules with variables.
3. After you enter the attributes, click OK to set the closure rule.
Teamcenter applies the closure rule to all future structure expansions until you
unset it or set another rule.
Note You can set the SkipClosureRuleEquivalent user preference to
determine whether the closure rule is re-evaluated if you reapply it in
the same session and the referenced property has changed.
To unset the closure rule, select it in the Rules list and then click Unset Rule.
Tip You can see the name of the current closure rule in the title bar of the
structure window. It is shown after the revision rule and variant rule names,
if any. Unsetting the closure rule clears the closure rule name from the
title bar.
If the action type in the closure rule is SKIP, lines meeting the criteria do not
appear. If the action type is PROCESS, qualified lines appear but are not
expanded (they show a + symbol). To expand such a line, unset the closure
rule from the window and then repeat the expansion of the subassembly.
Note If the properties you want to sort by are not available, you can insert the
necessary columns in the table. For example, you may want to sort by item
master form attributes, item revision form attributes and mapped attributes
for appearances. To add a column, right-click the column header, choose
Insert Column and choose the appropriate property from the selection list.
o Initial setup of one view from an existing view, for example, setting up a
manufacturing view from the design view. This allows you to reference the
same components but with different intermediate levels of structure.
• All Lines
Allows you to take a snapshot of the structure by copying references to each
revision in that structure to an override folder. You can attach this folder to and
release it with the top level assembly. You can use this folder as an override
list to reload the exact configuration of all component revisions in the product
when it was released.
Note You can automate this functionality using the snapshots feature.
• None have variant conditions or they all have the same variant condition.
• If any of the packed lines have notes, the notes are replaced by the text Packed
Notes. If none of the packed lines has notes, the notes are blank. In both cases,
you cannot edit the notes.
• Item and item revision attributes such as part name, weight, and cost remain
visible and can be edited if you have the appropriate permissions.
• You can modify the find number. Any such modification applies to each line in
the structure and is visible if the structure is unpacked.
• If any of the packed lines has a substitute, the packed line shows Packed
Substitute in the Substitute column. The pack count includes the substitutes.
You can set the Packed by Default preferences so that occurrences are displayed
packed when you initially expand the assembly (but not when they are first added).
For more information, see Setting Local Preferences.
You can also unpack packed lines that include concatenated reference designators.
Each unpacked line shows a single reference designator, for example, C1.
Teamcenter validates the correct reference designator format. All reference
designators must be in the format prefix number, where prefix is a string of one or more
uppercase letters and number is an integer. To validate the format and uniqueness of
reference designators, set the PS_Reference_Designator_Validation preference
to on. This setting also prevents users from editing packed lines. By default, this
preference is set to off and no validation is performed.
You can search for reference designator values. As with other product structures
searches, this is a wildcard search; if you search for C1, the system actually searches
for *C1*. You can also include reference designators in structure comparisons.
You can disable updating of duplicate find numbers of the same item. To do this, set
the PS_Duplicate_FindNo_Update preference to disabled.
The BOMExcludeFromPackCheck preference allows you to exclude sequence
numbers from structure line packing checks. You can set this preference to seqno
and structure lines with distinct sequence numbers can be packed or none to exclude
them.
• Edit the Quantity attribute in place. You cannot do this if the line in the
structure is packed.
2. Click the Find component(s) in display button at the lower left of the
Structure Manager window.
Teamcenter displays the Find in Display dialog box.
Note The search starts at the top-level item in the structure, not at the
currently selected line. You do not select an assembly in which to look
for the component. If you want to restrict the search to a particular
assembly, open the subassembly in a new Structure Manager window by
selecting it and choosing File→Open. Alternatively, you can collapse all
other assemblies except the one you want to search.
4. Double-click the Property Name text box to select a property from the list of
available columns.
Tip You can use the following relational operators to define property
searches:
The operators <, <= ,>, >= apply to numeric properties only.
6. Click the Searching Value text box and type the value you want to search for.
Note Partial matches are selected for string properties. Wildcards are not
supported, and the search is not case sensitive.
7. Add further clauses to the search condition by clicking again. You can also
double-click AND to change it to OR.
10. Click Find next one and Find previous one to step through the
matching lines one at a time. Alternatively, you can click Load All to select
all matching lines at once.
For more information about configuring the guided component search, see the
Classification Administration Guide.
The guided component search uses the following criteria to determine if a component
matches another:
• If the connection type of each component is the same.
• If components fit into each other. All components in the GCS are assigned
a physical shape—plug, socket, or neutral. For the search to find a match,
the matching component must always have the opposite shape to the initial
component. In other words, a plug component requires a socket component and
vice versa, or a neutral component requires another neutral component.
• The attribute values of the components must fulfil the matching criteria set in
the Classification Administration application.
• You have a component with multiple connection points and want to fulfil these
simultaneously.
To perform this type of search, all connection points must have the same shape,
same connection type, and same parent component.
1. Select the desired connection point of the component in the assembly structure
for which you want to find a matching component.
For more information about searching, see the Resource Manager Guide.
Removing a component
When you remove a component that satisfies one more multiple connection points
from a resource assembly using the Cut or Remove a line command, Teamcenter
updates the previously satisfied connection points and removes the connection
information from the connection points.
• For smaller products, you can make nonspatial searches for components using
item attributes, Classification parameters, reference designators, or occurrence
notes.
2. To include any custom form properties in the report, create a custom transfer
mode and add it to the Excel template. The transfer mode comprises a custom
closure rule and a custom property set.
a. In the PLM XML/TC XML Export Import Administration application, create
a custom closure rule to export the item revision master form. For example:
Primary Related
object Primary Secondary Secondary Relation property or
class object object class object type object Action type
Class * * Item PROPERTY IMAN_master_ PROCESS +
Version form_rev TRAVERSE
Master
b. Create a custom property set that defines the custom form properties
you want to export. The property set should contain a line similar to the
following example for each custom property you want to export.
3. Before configuring the Excel template, test the custom transfer mode works by
performing a PLM XML export.
a. In Structure Manager, select an item revision that includes your custom
form properties.
c. Verify the output file holds the values of the custom properties.
4. Configure the Excel template by adding the necessary columns for the custom
properties. logos, and hyperlinks. Refer to the sample files for examples.
5. By default, every level in the Excel template is displayed in a different row in the
final result. To merge values for a single revision into one row, you must apply
packing to the ExcelTemplate item type.
a. Check out the item.
b. Select the apply_packing value for the Excel Template Rules property and
modify it as necessary.
Teamcenter Rapid Start also allows you to print a watermark on your output. A
watermark is text or an image that appears in the background of each page of your
printed document.
The following table describes the printing options and the expected output for each
option based on the selected object type.
Note To select multiple objects, press the Ctrl key as you click.
• To send the selected files to the printer without specifying print options, click
the Print button in the toolbar or right-click and choose Print from the
shortcut menu.
a. Choose File→Print....
b. Select Client Printer or Server Printer and then choose the printer name
from the list.
o To print watermark text, select Watermark Text and then enter the
text in the corresponding text field.
Note To adjust the location of the watermark, you can edit the
TC_ROOT\tcvis\VVCP\vvcp.ini file. In addition, you can
optionally specify the path to an MDS (metadata stamping)
file that contains predefined watermark text. You can use
MDS stamp commands to change, customize, and improve file
stamping. MDS stamp commands are preferences used to create
more detailed stamps to apply to your files.
d. Click Print.
• Print Table allows you to print product structure information in tabular format.
Click the Format button at the top right of the dialog box to print or hide the
title text and revision rule label.
Click Print . If you select text format, print output is sent to the default printer.
If you select HTML format, the output is displayed in your default Web browser.
Alternatively, you can click Save to open a dialog box in which you can specify a
directory and name for the output text or HTML file.
• Contents
• Application (HTML/Text)
• Application (Graphics)
If you select text format, click to specify a delimiter string to separate the
property name and value. Select the Column Alignment check box to pad the text
with spaces and line up the entries up in vertical columns.
You can also click Format at the top right of the dialog box to print or hide
the title text.
Click Print . If you select text format, print output is sent to the default printer.
If you select HTML format, the output is displayed in your default Web browser.
Alternatively, you can click Save to open a dialog box in which you can specify a
directory and name for the output text or HTML file.
Print contents
• To print the contents of the structure, choose the Contents command and click
OK. The print format is the same as obtained with the Print command.
If you select text format, click Format and Teamcenter allows you to do the
following:
• Turn Column Alignment on or off. When it is turned on, each property value is
padded with spaces. The output is formatted in columns whose width reflects
that set for the corresponding columns in the structure tree.
• Turn Auto Indent on or off. When it is turned on, the printed format uses leading
spaces to reproduce the indentation of successive levels of structure.
• Turn Show +/– on or off. When it is turned on, appropriate lines are prefixed with
+ and – characters to identify collapsed and expanded assemblies, respectively.
You can also click Format at the top right of the dialog box to turn on or off
the title text.
Click Print . If you select text format, print output is sent to the default printer.
If you select HTML format, the output is displayed in your default Web browser.
Alternatively, you can click Save to open a dialog box in which you can specify a
directory and name for the output text or HTML file.
Note If you turn off Column Alignment, Auto Indent, and Show +/– and set the
delimiter to a comma (,). Teamcenter generates a comma-separated output
file that can be opened in a spreadsheet application.
Print table
To print structure information in tabular format, right-click the column headings
in the product structure display. Teamcenter displays a shortcut menu including
a Print Table command and HTML/Text and Graphics commands. These menu
commands provide an alternate to the Print application (HTML/text) information
and Print application (graphics) information procedures, respectively.
• Custom note
Contains information that is unique to an individual part or document. It is
not stored in a library. Create custom notes in the Business Modeler IDE, as
described in the Business Modeler IDE Guide.
Note Do not confuse standard notes and custom notes attached to items or item
revisions with occurrence notes.
For information about occurrence notes, see Displaying occurrence notes.
View note
1. Select a product structure line that represents an item or item revision.
For detailed information about how to manage standard notes and create and or
custom notes, see Creating and editing notes.
Open a structure in NX
You can load the structure into NX to work on the design in one of two ways:
• Push the structure from Structure Manager into NX. You can load (push) as
many structures as necessary from Structure Manager into a single existing
NX session.
Note This menu command is visible only if your administrator sets the
TC_ExportConfigUGNXAssembly preference to TRUE and NX is
installed on the client machine.
The administrator must also enable the NxClone translator, as described in
the Dispatcher Server Translators Reference Guide.
You can also push or pull variant structures between Structure Manager and NX.
When a variant rule is in force, you may display a subset of the product structure
in Structure Manager, for example, when the View→Show Unconfigured Variants
option is set to off. To ensure you see only the configured components in NX:
Note If you select the top-level assembly and click Open in NX, all components
are loaded, not just the configured ones. This applies to any assemblies
lower down the structure that are not expanded.
By default, the Open in NX button and menu command are not
visible in Structure Manager. Your administrator must set the
TC_show_open_in_NX_button preference to on to make them visible.
3. In NX, click Open on the toolbar or choose File→Open. Browse to the required
structure.
Adding components in NX
When variant rules are not set in NX, you can add components in NX by pasting it
into the product structure; the component has no variant data and thus is always
configured. You can later define a variant condition for the added components in
Structure Manager. You cannot add components to a configured structure, you must
first unset any variant rules applied.
Note If you select the top-level assembly and click Open in Lifecycle
Visualization, the graphics of all components are loaded, not only the
configured ones. This applies to any assemblies lower down the structure
that are not expanded.
By default, the Open in Lifecycle Visualization button and menu
command are not visible in Structure Manager. Your administrator
must set the TC_show_open_in_vmu_button preference to on to
make them visible.
You can view and change the transformation associated with a component in the
Absolute Transformation Matrix property columns, as described in Displaying
properties. In particular, you can add one or more of the following property columns
to view transformations:
• bl_plmxml_occ_xform
Shows the PLM XML transformation matrix value assigned to a part occurrence
in the product structure.
• bl_plmxml_abs_xform
Shows a run-time, rolled-up PLM XML transformation matrix value assigned
to a part occurrence in the product structure. The rolled-up transformation
value is calculated by adding the relative transformation matrices of all the
occurrence parent parts in the product structure. This property can also override
a transformation matrix value if you are making in-context edits.
• bl_occ_xform_matrix
Shows the non-PLM XML transformation matrix value assigned to a part
occurrence in the product structure.
• bl_abs_xform_matrix
Shows a run-time, rolled-up non-PLM XML transformation matrix value
assigned to a part occurrence in the product structure. The rolled-up
transformation value is calculated by adding the relative transformation
matrices of all the occurrence parent parts in the product structure. This
property can also override a transformation matrix value if you are making
in-context edits.
The following example shows a structure that has just relative transformation
matrices assigned to it. Structure Manager fills the absolute transformation matrix
fields when it rolls up the relative transformation matrices of the structure. In this
example, 000010/A;1-n1 does not have a relative transformation matrix assigned
to it. If Structure Manager encounters an unassigned matrix, it inserts an identity
matrix in the Absolute Transformation Matrix column when rolling the matrix
values.
• PS_allow_plmxml_transforms_with_no_legacy_factor
Configures whether Teamcenter converts legacy transform data.
• PS_assume_old_transform_format
Determines how Teamcenter interprets the format of legacy transform data.
• PS_assume_legacy_transform_units
Determines how Teamcenter interprets the unit of measure for legacy transform
data.
• PS_convert_legacy_transform_to_plmxml
Enables the display of legacy transforms in a PLM XML format.
• If the Import Distributed Components option is not set and the master site of
the assembly does not own the part family members, the members are imported.
Teamcenter imports the part family replica and not the master copy. The master
part family members must exist at the owning site.
• If the Import Distributed Components option is set and a site owns and contains
the part family members locally, the members are imported. Teamcenter imports
the master part family members present at the owning site.
• If the Import Distributed Components option is set and if the part family
members do not exist locally at a site that owns them, the members are imported.
Teamcenter imports the part family member replica and not the master copy.
o Blank
The replica object is up-to-date.
o Up to date per hub
The replica is up to date according to hub data.
o Out of date
The last modified date of the master is later than the last modified date of
the replica.
o Replica has later date
The last modified date of the object at your site is later than the last modified
date of the object at the master. This occurs if you check out the object.
o Not configured revision
The configured revision of your replica is not configured at the owning site.
For example, the latest revision is superseded at the owning site, but this is
not replicated at your site.
o Unknown
The owning site is unavailable.
• Multi-Site Synchronization→Component
Choose this command to determine the synchronization state of a selected
component revision and all objects associated with it, including BVRs and
attachments. This check identifies if the component has been replicated at your
site and also if the replica is up-to-date. If the replica is outdated, you can request
synchronization and visually verify if the synchronization process succeeded.
Teamcenter displays the Synchronization dialog box, which allows you to set the
following options to configure the synchronization process.
o Sync Options
Choose Perform Sync or Perform Sync In Background to immediately
initiate the synchronization process. Teamcenter sends a request to the site
owning the selected component to determine the revision to synchronize,
based on your revision rule selection. It determines the outdated objects and
Choose the Report Only option to display a results folder containing the
component and associated objects. The properties of each object are shown
from the viewpoint of your site. To ascertain the status of each object, view
the Sync State box, which contains one of the following values:
Blank
The object is up-to-date.
Up to date per hub
The replica is up to date according to hub data.
Out of date
The last modified date of the master is later than the last modified
date of the replica.
Replica has later date
The last modified date of the object at your site is later than the last
modified date of the object at the master. This occurs if you check out
the object.
Not replicated by local site
There is no replica of the object at your site.
No configured revision
The owning site has a different configured revision of the object to the
revision at your site.
Not replicated
A new attachment is added at the owning site, but it is not replicated
at your site.
Unknown
The owning site is unavailable.
You can synchronize a single object by selecting it in the report and choosing
Tools→Import→Remote. Teamcenter displays the Import/Export dialog
box, allowing you to set the parameters of the remote import action. When
synchronization is complete, Teamcenter refreshes the report with the latest
status.
o Revision Rule
Select the required revision rule from the list of revision rules available at
your site. If you select an item revision, the list displays Selected Revision
and the configured item revision is synchronized; you cannot set another
revision rule.
Note Your administrator can set the TC_sync_revision_rules preference
to permit you to select only certain revision rules, not all rules
available at the site.
o Session Options
Choose Generate Failure Report to write a failures report if you choose
the Perform Sync or Perform Sync In Background option. This option is
disabled if you choose the Report-Only synchronization option.
• Multi-Site Synchronization→Assembly
Choose this command to determine the synchronization state of an entire
assembly. If it is outdated, you can request synchronization of individual
components or the entire assembly, and visually verify if the synchronization
process succeeded. This check identifies if the component has been replicated at
your site and also if the replica is up-to-date.
Teamcenter displays the Synchronization dialog box, which allows you to set the
following options to configure the synchronization process.
o Sync Options
Choose Perform Sync or Perform Sync In Background to immediately
initiate the synchronization process. Teamcenter sends a request to the
site owning the selected assembly to determine the revision to synchronize,
based on your revision rule selection. It determines the outdated objects and
initiates a remote import of modified versions, depending on your settings in
the Import/Export Preferences dialog box.
Note Bulk data files are always included in the synchronization and the
latest dataset version is imported.
Choose the Report Only option to display a results folder containing the
assembly expanded to the maximum level. The report shows components up
to the highest level that is outdated within a branch. Consequently, branches
may be expanded to different levels. To determine this status, Teamcenter
compares the dates of the last modification of the master and the replica.
To ascertain the status of each component, view the Sync State box, which
contains one of the following values:
Blank
The component is up-to-date.
Up to date per hub
The replica is up to date according to hub data.
Out of date
The last modified date of the master is later than the last modified
date of the replica.
Replica has later date
The last modified date of the component at your site is later than the last
modified date of the component at the master. This occurs if you check
out the component.
Not replicated by local site
There is no replica of the component at your site.
No configured revision
The owning site has a different configured revision of the component
to the revision at your site.
Not replicated
A new attachment is added at the owning site, but it is not replicated
at your site.
Unknown. The owning site is unavailable.
o Revision Rule
Select the required revision rule from the list of revision rules available at
your site. If you select an item revision, the list displays Selected Revision
and the configured item revision is synchronized; you cannot set another
revision rule.
Note Your administrator can set the TC_sync_revision_rules preference
to permit you to select only certain revision rules, not all rules
available at the site.
o Session Options
Choose Generate Failure Report to write a failures report if you choose
the Perform Sync or Perform Sync In Background option. This option is
disabled if you choose the Report-Only synchronization option.
o Assembly Options
By default, the Include Entire BOM option is automatically chosen. If you
only want to synchronize some of the structure to reduce synchronization
time, uncheck this option.
Choose a value in the Maximum Level list that represents the maximum
depth in the assembly that Teamcenter traverses when you choose the
Show connections
You can display the objects connected by the Connected_To relationship to:
• View the names of the connected objects directly from the structure line.
View the objects connected by a given connection in one of the following ways:
• Select and right-click the connection and Teamcenter displays a shortcut menu.
Choose the Show Connected Lines menu command to highlight the connected
objects.
• Select the connection and click the button to highlight the connected objects.
Use the Attachments tab in Structure Manager to view the feature form that lists
the attributes of welds or datum points.
You check out an item revision to make changes and check it in again when the
changes are complete. You may also cancel the checkout of an item revision, even
if it is open in a structure editor. This action causes the changes made to the item
revision and to its first-level structure to be lost. If the item revision is open in a
structure editor window, you must refresh the full window refresh to restore absolute
occurrence data for any lines edited in context of the item revision.
Caution Siemens PLM Software recommends you do not use the Cancel Checkout
command on item revisions that contain changes tracked by incremental
change. This action causes permanent loss of incremental changes that
are tracking structure edits.
Cloning a structure
You can clone (duplicate) an existing product structure to create a new structure.
You can clone the entire product structure from the top level down or a selected
subassembly. It is not necessary to open the CAD tool when creating the new
(cloned) assembly.
The cloning operation uses Business Modeler IDE deep copy rules to determine
how datasets and attachments are copied. It also uses the Business Modeler IDE
StructureCloneTransferModes global constant to determine how CAD-specific
attachments and relationships are copied.
When you open the new (cloned) structure, you can edit or update any of the items,
item revisions, datasets, and attachments without affecting the original structure.
The cloning process does not support occurrence effectivity and any configuration of
the structure with occurrence effectivity does not carry forward to the clone.
The user who performs the cloning action owns the copy. Any elements of the original
structure that were referenced, rather than copied, remained owned by their original
owner. Access rights and ACL rules on structure lines are not carried forward from
the original structure to the new (cloned) structure.
If you do not have access rights to a substructure in the original structure, you
cannot duplicate that substructure and Teamcenter instead references the existing
substructure.
If the original structure was shared by Multi-Site Collaboration, the new (cloned)
structure does not inherit its permissions. It is a new structure and is therefore
owned by the site where it was created.
3. Select the top line of the structure or a subassembly in the structure. The selected
line and everything below it will be copied into the new (cloned) structure.
4. Choose File→Duplicate.
Structure Manager displays the Duplicate dialog box. You can use the + and -
buttons to expand or collapse the structure tree that is displayed in the dialog
box.
5. Select or clear the check box at the left-hand end of each line in the structure to
copy or reference that line in the new (cloned) structure.
6. Select one or more of the check boxes on the left-hand side of the Duplicate
dialog box to determine how the clone should be created:
Note If you try to define a naming pattern that does not conform with the
naming rules defined in Business Modeler IDE, Teamcenter displays an
error message.
3. To create the new item from a template, click the Choose Template tab, enter
the name of the structure top line to clone in the Template ID box. Alternatively,
you can browse to the template structure you require or to another product
structure to clone.
In the lower pane of the tab, Teamcenter populates the item identifier, revision
and name of the new item. The item identifier is assigned sequentially and
you cannot change the displayed value.
4. Click the Configuration tab and select the cloning rule to apply from the Cloning
Rule list. If required, you can also change the revision rule on this tab.
5. Click OK or Apply to create the new product from the template you choose. The
new top level is not loaded into the window and, if you want to verify that it was
created correctly, you must search for it.
• If the item revision is at the top-level of the structure, the precision is set
according to your default BOM view precision option.
• If there is only one view type not used by the existing BOM view revisions of the
item revision, it uses the undefined view type.
• If your default view type is not used by the existing BOM view revisions of the
item revision, it uses your default view type.
If Teamcenter cannot determine the view type, you must enter a value manually.
Note If the new structure is similar to an existing one, consider choosing the Save
As→BOMView Revision menu command to make a copy of the BOM view
revision and edit the copy structure.
When you save a structure with a different name using the Save As
command, the workspace objects it comprises are renamed, including the
item identifier, the revision identifier, and any variant rule.
Note Teamcenter derives the names of BOM views and BOM view revisions
from the identifiers of the owning item or item revision with the view type
appending.
Create a new BOM view revision from an existing BOM view revision
1. Select the line containing the BOM view revision in the product structure tree.
3. Specify a view type that is not already been created for the item. You select the
view type from a list of values defined by the administrator.
The precision of the BOM view revision is the same as the BOM view
revision you copied. If you want to change the precision, choose Edit→Toggle
Precise/Imprecise.
To add a similar structure to another item revision, choose the File→Save As→BOM
View Revision menu command to create a new BOM view revision in a different item.
Specify the target item identifier and revision in the Item and Revision boxes of the
dialog box. This action copies the occurrence attributes, including the find number,
notes, quantity, substitutes, and variant conditions into the new BOM view revision.
Note Variant conditions are copied if you use modular variants but not if you
use classic variants.
You can open multiple windows by using the split window button.
• If you make structure changes, only those changes made in the window where
you choose the Save command are saved. If you create additional windows and
open structures in those windows, changes made in the other windows are not
saved.
• If you want to save changes made in other windows, you must explicitly choose
the Save command in the window in which the structure changes were made.
Window 1 B C Window 2 D
K F J L J M L
M E F Z E T
Z E T
• In window 1, save the product structure. This action saves changes to assembly
M but not D.
Note Changes are saved, regardless of where they are made. Therefore, the
changes made in window 2 to M are also saved. The save action in
window 1 thus causes a partial save of the changes made in window 2,
on those assemblies that are also seen in window 1.
• In window 2, save the product structure. This action saves changes to assembly
D.
• Click Cancel to return to the Structure Manager session without saving changes.
Allows you to add new components by typing in the item, part, and design
identifiers.
If you manage parts and CAD designs separately, you must publish links between
them as an appropriate time. For details of how to do this, see the Multi-Structure
Manager Guide.
If another user is editing a single level assembly within the product structure,
Teamcenter prevents you making changes until the other user has saved their
changes. A warning message identifies the other user working on the assembly. This
safeguard does not prevent you making changes to other assemblies that are not
being worked on.
Optionally, Teamcenter can validate the structure by verifying that you add only
appropriate child items and item elements (GDEs). If you attempt to make an invalid
addition, Teamcenter displays an error message stating that you cannot add the
selected child item to the current parent item. To enable validation, your Teamcenter
administrator sets the TCEnforceSingleType and TCAllowedChildTypes_Item
Type/GDE Type preferences, as described in the Preferences and Environment
Variables Reference.
Note If you try to add an incompatible part type to the product structure,
Teamcenter displays an error message. For example, you cannot add a
manufacturer part to the product structure in Structure Manager.
If the component you are adding to the structure contains unsatisfied connection
points, Teamcenter checks if any of the other components in the structure also
contain unsatisfied connection points and offers to connect them.
For more information, see Adding components using the guided component search.
2. In Structure Manager, select the assembly into which you want to add the
component.
Pasting does not remove the object from the clipboard. Therefore, you can click Paste
again to add another line of the same item revision to the assembly. Another
Copy operation replaces the previous clipboard contents with the new object.
Caution After creating an architecture breakdown structure in Platform Designer
and sending it to Structure Manager, do not copy and paste or drag and
drop architecture elements in the same window. It can lead to data
corruption in Platform Designer. If you inadvertently perform one of
these actions, delete the resulting line using the Remove Design from
Product button.
• Choose the Paste command to paste the contents of the clipboard as components
of the line. This is the same action as pressing the Ctrl+V shortcut keys, choosing
Edit→Paste, or clicking Paste on the toolbar.
• Choose the Properties command to view the properties of the line. This is the
same action as choosing View→Properties or clicking Properties on the
toolbar.
Note You do not need to explicitly select the line before right-clicking it.
• If the component has an associated substitute list, this is also copied and pasted.
If you paste the component into My Teamcenter, rather than Structure Manager,
Teamcenter pastes the lines as individual item revisions.
Note You cannot view occurrence attributes such as quantity or notes in My
Teamcenter.
Teamcenter does not copy variant conditions with components. You must copy
variant conditions separately, as described in Copy variant conditions to other
occurrences.
2. Click the text box in the lower left of the Structure Manager application window.
You can only use Quick Add for adding existing items. To create a new item and add
it to the structure, choose File→New→Item.
o If the parent assembly BOM view revision is precise, you are creating
a precise occurrence. The Revision box is enabled and you can specify
a revision.
• Set the view type if there are multiple views of the component; you do not
want the default view type. You can select another view type from the list
of views created for the component.
If the item has a unit of measure defined, the units are displayed next
to the Quantity per Occurrence box and you can enter a fractional
value (for example, 1.5). If the units are displayed as Each, the box
shows the number of parts and you must enter a whole number.
If the quantity box is blank, the default value is 1 for items that
have no unit of measure or 0 for items with a unit of measure. These
values are used in quantity rollups, for example, when lines in the
structure are packed.
Note You can enter the string A/R or a to specify a quantity value
of As Required.
o Find Number
Edit the find number if necessary.
Note Find numbers are automatically generated according to the
scheme defined for your site with the PS_new_seqno_mode
preference. The default scheme increments the find number by
10 as each new component is added.
Paste a component
You can specify additional data about the use of a component as you add it to the
structure, for example, a quantity or find number.
• Choose the Paste Special command to insert an existing component that
you copied to the clipboard into the structure. Unlike Add..., Teamcenter
prepopulates the Component ID (Revision) and Name boxes of the Paste Special
dialog box with item or item revision information from the clipboard.
• If no view type is copied, Teamcenter displays a list of all the available view
types for that item.
Use the Paste Special or Add... menu command or the Replace command when
copying an item revision with multiple views. This allows you to specify the required
view type manually. If you paste the item revision directly and none of the items
view types match the default view type, Teamcenter displays an error message but
attempts to complete the paste operation.
If you copy a line from the structure in Structure Manager that represents a specific
BOM view revision and paste it into another structure in Structure Manager, the
new occurrence references the same BOM view revision as you copied.
3. Enter the necessary parameters in the dialog box and click OK.
Teamcenter creates the new item or part (or its revision) and adds it as a
component of the selected assembly.
Note If you add parts or part assemblies to an assembly, you can subsequently
publish links to the associated CAD designs, as described in the
Multi-Structure Manager Guide. This step is not necessary if you add items
or item revisions, as you can attach CAD designs directly.
• Property edits are associated with a relative occurrence and are marked as
pending until they are saved to the database.
• Property edits are highlighted only if you use the column editor. If you use other
methods of changing properties (for example, the Properties dialog box), these
edits are not visually highlighted in the properties table. However, Teamcenter
still retains the details of such edits until you save or revert them.
• If any note in the list of notes is edited, the All Notes field shows a … symbol
with a red strike-through. It does not show the exact original value.
• By default, if you cut or copy a line and then paste it to a new location,
incremental change elements (ICEs) are not copied. This may necessitate
significant manual recreation of data if you are cutting or copying many lines
together. To automatically copy ICEs, the administrator must set two Business
Modeler IDE constants:
o Fnd0EnableIceCarryOver business object constant
When moving, copying, or assigning a line from one location to another,
this constant determines if the ICEs are carried forward. You must set
this constant to true on both the source location’s parent and the target
location’s parent.
Defines the occurrence attributes that Teamcenter does not copy to the
target location for occurrence attribute changes.
• Moving a line to a new location (for example, cut and paste actions)
• Splitting an occurrence
Only the last two actions make copies of the absolute occurrence data; the
other actions share the existing absolute occurrence data.
In certain cases, restructuring may cause valid reports of broken links, as shown in
the following examples:
Example Example 1:
A
+-----------B
+-----------C (APN1 in context of A)
+-------------D
2. Enter the item identifier and other attributes of the new item. If the inserted
item is new, you must insert it with a quantity of 1.
Note You can only insert a level if the line represents a standard business object
type. If the line represents a custom type, copy it to the clipboard and choose
Paste Special. Teamcenter pastes it as a new level above the currently
selected line.
2. (Optional) Select Keep subtree to reattach the children of the removed level
to the next higher level parent line.
3. Click Yes to confirm removal of the line. The total number of instances is
preserved at the end of this action. Any options of the removed lines are moved
up and variant conditions are merged.
If you try to remove a level that would result in option definitions becoming
inconsistent (for example, options that are referenced by a parent line), Teamcenter
displays an error message.
Caution If you select a line for removal and edit tracking is enabled, the line is
displayed in red with a strike-through until you commit the edits. Do not
attempt to edit or work with this line, or you may obtain unpredictable
results. If you want to edit or work with a line that is marked for removal,
revert the removal of the line by choosing Edit→Revert Edit first.
Similarly, do not edit or work with a marked line in another structure
editor such as Multi-Structure Manager. Always complete and save
your work on the structure in Structure Manager before you open it
in another structure editor.
If you remove one of the lines that is the context of a Mechatronics
relation between primary and secondary lines, the relation itself is also
removed.
• Cut and paste using the Ctrl+X and Ctrl+V shortcut keys.
Caution Do not try to move a node by dragging the line to its new position.
Teamcenter performs a copy action when you drag a line.
• Specify the number of occurrences, quantity per occurrence, and find number.
Replace a node
You can replace an item representing a node in the structure with another item. All
data associated with the original node is preserved.
Note Your system administrator sets the PS_replace_with_substructure
preference to determine if any substructure below the node is replaced. If
this preference is true, the node and its entire substructure (if any) are
replaced without prompting. If it is false, Teamcenter displays an error
message and does not complete the replacement action.
2. Enter the item identifier and other attributes of the item that replaces the
existing item.
3. Click OK or Apply.
Teamcenter replaces the existing item.
If you have edit highlighting turned on, the number of the original part is shown
in red, strike-through text.
Note In most cases, associations between objects (such as Connected To
relations) are correctly maintained or are reassociated. However, after
editing a Mechatronics structure, you should always choose the Fix
In-Structure Associations command to identify any invalid associations.
For more information, see Fix in-structure associations.
If the child of the copied item includes RealizedBy, ImplementedBy, or
RedundantSignal as the primary association, the corresponding child in
the replaced assembly points to the secondary association of the original
(copied) assembly.
You can replace a line that represents a generic design element (GDE) with
another GDE line but not with a line that represents another object.
You can replace Mechatronics items with any type of item. However, Siemens
PLM Software recommends you use the same item type as the replaced
item or one of its subtypes for the replacement item. Use of incompatible
types may result in invalid relationships between occurrences in the product
structure. The following table lists possible Mechatronics items for replace
operations.
Split an occurrence
You can split a line that represents several occurrences into two branches. The new
branch and the original (changed) branch initially have the same notes, variant
conditions, and other data, but you can subsequently modify them independently.
The quantity on the original line before the split must be greater than 1.
1. Select the occurrence line and choose Edit→Split Occurrence.
Teamcenter displays the Split Occurrence dialog box.
2. Enter the quantity for the new line that results from the split and click OK
or Apply.
Note You cannot split an occurrence if the line represents a logical object, for
example, Connection, Signal, or Software. You can split interfaces
and other Mechatronics objects, for example, HRN_GeneralWire and
Processor.
In most cases, associations between objects (such as Connected To
relations) are correctly maintained or are reassociated. However, after
editing a Mechatronics structure, you should always choose the Fix
In-Structure Associations command to identify any invalid associations.
For more information, see Fix in-structure associations.
If you split an occurrence line that represents a GDE, Teamcenter increments
the GDE number. The quantity of a GDE line must always be an integer.
If the child of the original occurrence includes RealizedBy,
ImplementedBy, or RedundantSignal as the primary association, the
corresponding child occurrence of the split occurrence points to the secondary
association of the original occurrence.
3. Repeat the previous step for each of the other invalid associations in turn.
Note Any associations that you do not remove manually remain in the
structure.
• Properties of the parent or child object must satisfy specified values or be NULL.
For allowable substitutes in a given BOM line, the same restrictions that apply to
the primary part occurrence are applied to the substitute.
Validations are provided for the following operations:
• Creating a new occurrence
When you save edits, Teamcenter validates that they do not violate the defined
business rules and, if they do, displays an error message and does not save the
changes.
Optionally, you can perform an on-demand validation of property updates at any
time by right-clicking a top line with substructure and choosing Tools®Validate
Occurrences. If no issues are found, Teamcenter displays a confirmation and saves
a validation log. If issues are found, it displays a list of errors.
Note The administrator uses the Business Modeler IDE to define these business
rules on explicitly stated classes. Any subclasses or subtypes of these classes
inherit the same rules.
For more information, see the Business Modeler IDE Guide.
You must also create and set the following preferences:
• PS_Default_Rev_For_Occ_Cond_Validation
Defines the default revision rule when a child item is used for validation.
• PS_Bypass_Occurrence_Condition
Configures the system to bypass occurrence condition validation for
defined actions or operations.
If necessary, you can override this preference setting locally for your current session
by selecting the Display Markups for pending edits command.
Highlighting edits feature is available only in Structure Manager, not other
structure editor applications.
Note This feature is not compatible with the BOM markup feature described
in Marking up the product structure, and you cannot use the two features
together.
Ensure you select this feature when you want to edit the BOM directly, not
when you want to create markups (propose changes).
You cannot convert pending BOM edits into markups.
Tip Enable highlighting only when you want to specifically track edits you are
making; otherwise, the display may become difficult to interpret.
Close all Structure Manager windows before changing this option to avoid
having open windows where edits are not highlighted. (Changing this option
does not affect existing windows.)
• Removals
Displayed in red with a strike-through line.
• Property edits
Displayed with the original values in red with a strike-through line.
If you have pending edits to the structure, you can do any of the following:
• Click Revert to undo all pending edits to the selected line.
All edit marks are removed from the line.
Note You cannot compare structures with pending edits with the BOM Compare
command. However, you can expand the structure manually to view the
effect of pending edits.
Likewise, you cannot highlight pending edits if you enable incremental
changes.
Note You cannot create new associations (for example, a Connected To,
Implemented By or Embeds relation) to a line that is displayed in red
with a strike-through line.
When you save pending edits, any associations to deleted lines are also
deleted. If you revert pending edits, all associations are maintained.
• Route the assembly with its markup object for review, and apply the proposed
changes.
The markup is related to the BOM view revision (BVR) of the structure. The BVR
may have multiple markups associated with it, but only one markup may be active;
once a markup is applied, it ceases to be active.
A markup change represents a single proposed change to the BVR or one of its child
lines. A markup change always references a markup, and a markup may include
multiple markup changes. The author and the date and time of each markup change
is tracked.
The following proposed changes to the structure can be included in a markup:
• Addition or removal of an occurrence.
• Change to the value of certain occurrence properties, for example, name, notes,
quantity, sequence number, unit of measure, reference designator, and variant
condition. The properties that are tracked in markups are defined in the
Fnd0BOMMarkupSupportedProperties global constant in the Business
Modeler IDE. You can add properties to this global constant, but you cannot
delete the default entries.
To allow users to work with markups, the administrator must set the
Fnd0BOMMarkupAllowed global constant to true in the Business Modeler IDE.
Set the following preferences to specify how markup actions are displayed:
• BOM_MARKUP_ADD_FONT_STYLE
Specifies the font style in which added line markups are displayed. For example,
if this preference is set to 2, additions are shown in italic.
• BOM_MARKUP_ADD_FOREGROUND
Specifies the color in which added line markups are displayed. For example, if
this preference is set to 0,255,0, additions are shown in green.
• BOM_MARKUP_STRIKE_FOREGROUND
Specifies the color in which removed line and property markups are displayed.
For example, if this preference is set to 255,0,0, removals and changes are
shown in red.
Note Many editing actions are not supported in markup mode and the
corresponding menu commands are disabled.
The markup commands are not available if Teamcenter is tracking pending
edits to the structure in the active pane. Save or cancel any pending changes
before inserting the markup. Editing a structure with markups may obsolete
or remove impacted markups.
You cannot mark up changes to absolute occurrences; that is, if in-context
editing is turned on, the markup commands are not available.
You cannot propose changes to an existing markup change. You should
create a general markup with your comments or delete the existing markup
change and create a new one.
Changes to properties are limited to 160 bytes.
2. Select the structure line where you want to add the general markup.
4. Click the Add General Comment button next to the Show changes for
this line pane.
Teamcenter adds a new line in the pane.
o Dependent?
Contains Y if there are dependent markup changes; otherwise it is blank.
o Markup Description
Displays the description of the markup that was entered by the user who
created it.
o Status
Shows the current status of the markup, for example, Working or Obsolete.
o Note
2. In Show markup for this level, type a text comment in the Comments box.
Teamcenter saves the comment to the markup object.
Note The BOM Markup pane shows markup information for the selected BOM
line. It shows only active markups and active markup changes, not obsolete
changes.
For an ADD change, it shows only the ADD BOM line markup change and
does not display the dependent property markup changes. Consequently,
the BOM Markup view corresponds exactly with the redlining shown in the
BOM panel.
The dependent markup changes are not redlined as property changes, but
are displayed as part of the ADD redlining. The dependent markup changes
are deleted as part of an ADD markup change deletion.
Apply markup
You can save (commit to the database) all changes recorded in the markup that
are related to the current line.
This does not affect any changes recorded in markup objects related to the child lines
below it. To save changes in markups related to child lines, see Apply all markups.
1. Select the line with the relevant markup and choose Tools→Markup→Apply
Markup (this level).
Alternatively, you can right-click the line and choose Apply Markup (this level).
Teamcenter displays a confirmation dialog box.
2. Click OK and Teamcenter applies the changes in the markup to the structure.
Once a markup is applied, it ceases to be active and any future markups are
captured in a new markup object.
A markup cannot be applied more than once, although the results of an applied
markup are visible in the structure.
Note If you do not have write privileges to the selected line, Teamcenter displays a
dialog box asking if you want to create a new BVR. Click OK and Teamcenter
creates the necessary BVR.
If the apply action causes full or partial errors, Teamcenter displays a dialog box that
lists the errors and the failed components. You must evaluate the error descriptions
and decide how to fix them.
For example, if the error results from access restrictions, you can ask another
user with suitable access rights to apply the markup or revise the item revision to
obtain access.
2. Click OK and Teamcenter applies the changes in the markups to the structure.
Once a markup is applied, it ceases to be active and any future markups are
captured in a new markup object.
A markup cannot be applied more than once, although an applied markup
remains visible in the structure.
Note If you do not have write privileges to any of the child lines below the selected
line, Teamcenter displays a dialog box asking if you want to create new
BVRs. Click OK and Teamcenter creates the necessary BVR.
If the apply action causes full or partial errors, Teamcenter displays a dialog box that
lists the errors and the failed components. You must evaluate the error descriptions
and decide how to fix them. For example, if the error results from access restrictions,
you can ask another user with suitable access rights to apply the markup or revise
the item revision to obtain access.
• Cloning.
Markups are not copied, because closure rules do not apply to a structure clone.
• Sequencing.
Markups are not copied.
Delete markup
1. Select the line with the markup you want to delete and choose
Tools→Markup→Delete Markup (this level). Alternatively, right-click the line
and choose Delete Markup (this level).
Teamcenter displays a confirmation dialog box.
2. Click OK and Teamcenter deletes the active markup related to the selected line.
When a markup is deleted, all of its markup changes are also deleted.
2. Review the details of the markup, then choose Delete markup (this level).
Teamcenter deletes the active markup related to the selected line.
• Sample 2
Use this sample when there are multiple markup objects related to a BVR and
one object is active. The workflow selects the active markup object and routes it
for review. A user can copy and paste the active markup as a specific target in
the workflow process.
• Sample 3
Use this sample when there are multiple markup objects related to a BVR and
one object is active. The workflow filters the active markup object and routes
it for review. A revise operation on a BVR with multiple markup objects only
carries forward the active markup object.
• Sample 4
Use this sample when there are multiple markup objects related to a BVR and
one object is active. The workflow process filters the active markup and routes it
for review. The workflow also applies an approved status to the active markup
object.
This sample includes three processes and they must be invoked in the order
listed:
1. BOMMarkup_Review
Sends an item revision or BVR to a review task. After approval, it starts the
BOMMarkup_SplitTarget process.
The review task is a manual operation. The reviewer or approver must send
the workflow target (the item revision or BVR) to Structure Manager to
view the product structure. Markup mode must be switched on to see the
proposed changes.
2. BOMMarkup_SplitTargets
Adds the markup objects as targets. As there may be multiple
markup objects, the workflow sends each of them individually to the
BOMMarkup_AddStatus object to identify the active markup.
3. BOMMarkup_AddStatus
o Always has a single target object because the parent
BOMMarkup_SplitTargets process always spawns a new
BOMMarkup_AddStatus subprocess for each new target object.
For information about how to create the necessary processes, see the Workflow
Designer Guide.
Note You can also use these samples as the basis of a workflow that applies
markups or permits a user to apply markup changes manually.
Sample 1
Use this sample if one markup object is related to a BVR and it is the active markup
object.
1. Use Workflow Designer to create the following workflow.
2. Open the Handlers dialog box and select the Start task.
This action adds the markup object as a target. You can send an item revision or
BVR to this workflow.
Sample 2
Use this sample if more than one markup object is related to a BVR and only one is
the active markup object.
1. Use Workflow Designer to create the following workflow.
2. Copy the active markup and paste it as a specific target of the workflow process.
Sample 3
Use this sample if more than one markup object is related to a BVR and only one is
the active markup object. If you revise the item revision, Teamcenter only carries
forward the active markup and you can submit the new revision to the workflow
process. For example, the following BVR is related to multiple markup objects, but
only one markup object is active.
1. Use Workflow Designer to create the same workflow as described for sample 1.
Sample 4
Use this sample if more than one markup object is related to a BVR and only one
is the active markup object. It provides a sample workflow process that accepts an
item revision or BVR with multiple markup objects for review, but only adds a BOM
Markup Approved status to the active markup object.
If you select the item revision as the initial target, Teamcenter adds BOM Markup
Approved status to the item revision, BVR, and the active markup objects. If you
select the BVR as the initial target, Teamcenter adds BOM Markup Approved
status to the BVR, and the active markup objects.
Note A BVR may contain several markup objects, but only one of these objects can
be active, as shown in the following example.
BOMMarkup_Review process
1. Use Workflow Designer to create a new BOMMarkup_Review process. Place a
review task and a generic task between the Start and Finish tasks, as follows.
2. Select the Start task and click the Task Handlers button .
Teamcenter displays the Handlers dialog box.
4. Select the Sub-process task and click the Task Handlers button .
Teamcenter displays the Handlers dialog box.
6. Make the template available for use by selecting the Set stage to available
check box.
BOMMarkup_SplitTargets process
2. Select the Start task and click the Task Handlers button .
Teamcenter displays the Handlers dialog box.
4. Create a Has Multiple Targets? condition task that counts the number of
workflow target objects and determines if there is more than one. Create this
condition task with workflow handlers and a query object, as follows:
a. In Query Builder, create the following query to check the value of the task
result.
e. Select BM-Has Multiple Targets? and Query Against - Task as shown, and
then click Assign to assign the query.
g. Click Display Settings and ensure the Attributes dialog box shows the
following settings.
i. Ensure the Has Multiple Targets? condition task is still selected and click
the Task Handlers button .
Teamcenter displays the Handlers dialog box.
9. Make the template available for use by selecting the Set stage to available
check box.
BOMMarkup_AddStatus process
1. Use Workflow Designer to create a new BOMMarkup_AddStatus task. Add
two condition tasks, two OR tasks, and an Add Status task between the Start
and Finish tasks, as follows.
2. Select the Start task and click the Task Handlers button .
Teamcenter displays the Handlers dialog box.
4. Create a BM – Is Markup Object? condition task that checks if the target object
is a markup object. (The process expects only one target object.) It does this by
checking the object_type property value of the markup object with a query that
you create as follows.
a. In Query Builder, create the following query.
e. Select BM-Is Markup Object? and Query Against - Task as shown, and then
click Assign to assign the query.
g. Click Display Settings and ensure the Attributes dialog box shows the
following settings.
j. Verify that the EPM-set-condition handler is defined under the Start folder
as follows.
5. The BM – Is Markup Active? condition task checks if the markup object is active.
It does this by querying the fnd0active property value of the markup object.
a. In Query Builder, create the query as follows.
g. Click Display Settings and ensure the Attributes dialog box shows the
following settings.
i. Ensure the Is Markup Object? condition task is still selected and click the
Task Handlers button .
Teamcenter displays the Handlers dialog box.
j. Verify that the EPM-set-condition handler is defined under the Start folder
as follows.
c. Ensure the Add BOMMarkup Approved Status status is still selected and
click the Task Handlers button .
Teamcenter displays the Handlers dialog box.
d. Verify that the EPM-create-status handler is defined under the Start folder
as follows.
7. (Optional) In Access Manager, create a write operation in the rule tree for
status=BOMMarkup Approved. This setting allows you to apply markups to
the product structure after the review and approval process.
8. Make the template available for use by selecting the Set stage to available
check box.
For more information about adding units of measure to Structure Manager, see the
Business Modeler IDE Guide.
2. Type the required value in the Quantity box and select a UOM from the Unit
Of Measure list.
Teamcenter converts the value you entered to the default item UOM and
displays it for verification. For example, if the default item UOM is grams, when
you enter a quantity of 2 and select a UOM of lb (pound), it displays 907 grams.
3. Click OK to save the quantity in the database. The quantity is stored in the
database in the item UOM, not the user-selected UOM.
Is NOT a Global
Alternate of
Part B
Is a Global
Alternate of
Is NOT a Global
Alternate of
Part A Part C
Is a Global
Alternate of
Is NOT a Global
Alternate of
Part D
Is a Global
Alternate of
Is NOT a Global
Is NOT a Global Alternate of
Alternate of Part E
Part A Is a Global
Is a Global Alternate of
Alternate of
Part B
Is NOT a Global
Alternate of
Part F
Is a Global
Alternate of
Is NOT a Global
Alternate of
Part B
Is a Global
Alternate of
Is NOT a Global
Alternate of
Part C
Is a Global
Alternate of
Is NOT a Global
Alternate of
3. Search for the item that you want to define as a global alternate of the selected
item.
4. If you want to define more than one global alternate of the selected item, repeat
the previous step for each global alternate.
Note You cannot add the same item as the global alternate more than once.
Teamcenter displays a Cannot create duplicate alternates of same item
message if you attempt this action.
2. In the Global Alternate dialog box, select one or more global alternates to remove
and click Remove.
Teamcenter removes the selected global alternates from the list.
Note If you remove all the global alternates from an item, the corresponding line
in the product structure no longer shows the symbol.
2. In the Manage Global Alternates dialog box, select a global alternate and click
Prefer.
Teamcenter designates the selected global alternate as preferred and places a
check mark next to it in the list.
To remove the preferred designation from a global alternate, select it and click Prefer
again. Teamcenter removes the check mark next to it in the list of global alternates.
Changing components
Any modification you make to the product structure changes the BOM view revision
in the parent assembly. Modifications that change the BOM view include adding,
deleting, or substituting components; adding a substitute component; or changing
any of the occurrence attributes, for example, a note or find number.
You must have write access to the BOM view revision to make such modifications.
You may not have write access for one of several reasons, including:
• Another user is modifying the BOM view revision and the changes are not
yet saved. In this case, Teamcenter displays an error message, stating who is
currently modifying the BOM view revision.
• The BOM view revision is protected against write access, for example, because
it is released.
When you choose File→Save As for a selected item revision, Teamcenter creates a
physical copy of the BOM view revision.
Remove components
1. Select the component or group of components to remove from the product
structure tree.
2. Click Cut on the toolbar, choose Edit→Cut, or press Ctrl+X to place the
selected components on the clipboard. Teamcenter grays out the affected
component lines.
Replacing a component
You can make the following replacements in a product structure:
• Replace a component without losing the occurrence data.
You can change an item revision in an assembly by cutting out the old item
revision and pasting in the new item revision. However, this method breaks
the occurrence link to the old component, so you lose any occurrence attributes
including notes and the find number of the old component. A replacement
retains the occurrence data.
You cannot replace one component with two or more components. However, you can
select multiple components and replace each with a single component.
Note Teamcenter does not verify if the replacement request is valid for your
business data. If necessary, check the validity of the replacement action
with the Teamcenter administrator.
Replace a component
1. Select the component to replace in the product structure.
3. Choose Edit→Replace....
Teamcenter displays the Replace dialog box. The lower pane of the dialog box
contains details of the selected component to replace.
4. In the upper pane of the dialog box, enter the item identifier of the replacement
component. If you copied the replacement component to the clipboard, the item
ID and revision boxes are already populated with those of the copied component.
You can change the identifier if required, but not the item name; the item name
is derived from the item identifier you enter.
Note If you specify an item identifier that is shared by multiple objects,
Teamcenter displays the Select Unique Item dialog box allowing you to
select the object you require.
• If the BOM view revision of the parent assembly is precise, you can specify
a revision. In this situation, you can use the replace command to replace
one component item revision with another item revision or to replace the
component with a revision of a different item. If an item is taken from the
clipboard, Teamcenter determines the revision by the revision rule.
• If the BOM view revision of the parent assembly is imprecise, you cannot
specify the revision. In this situation, you use the replace command to
replace one component item with another item.
If there is not a revision that satisfies the revision rule when you add the
component to the structure, Teamcenter displays the revision as ???.
5. Optionally, use the bottom section of the Replace Component dialog box to
change the scope of the replacement by clicking one of the following:
• Single Component
Replaces only the selected component.
If the component to replace has multiple views, Teamcenter uses the default view
type. If no default is defined, Teamcenter displays an error message and you must
specify a view type in the Replace... dialog box.
Alternatively, to replace one or more items (parts) or item elements for another:
1. Select one or more source lines that represent items or item elements, and
choose Edit→Copy.
2. Select target lines that represents the same types of item or item element and
choose Edit→Paste. If you copied more than one source line to the clipboard, but
only selected a single target line, Teamcenter displays the Select Object for
Replace dialog box. Otherwise, it replaces the targets with the sources and
updates the find numbers, as appropriate. If you attempt to replace an item or
item element with a line of another type, Teamcenter displays an error message
and does not replace any of the selected lines.
3. If Teamcenter displays the Select Object for Replace dialog box, select the
required source from those listed and click Replace.
2. Select the deleted and added parts and choose Edit→Change To Replace.
Teamcenter converts the individual delete and add operations into a replacement
operation, replacing the occurrence thread of the added part with the occurrence
thread of the deleted part to keep the same occurrence thread.
When a primary part has one or more substitutes, you can display all the substitute
parts as siblings of the preferred structure line directly below the primary part.
You can then easily compare, edit, or remove the substitutes. You can enable the
display of substitutes on separate lines by setting the PSEShowSubstitutesPref
preference.
Note If you are working in NX and perform a rollup calculation (for example, cost
or weight), the calculation uses the preferred substitute.
If you add a substitute, you modify the BOM view revision and you consequently
must have write access to the BOM view revision. You can change the preferred
substitute any time during a session (for example, to view the change in NX), but
you can only save the change if you have write access to the BOM view revision.
Substitutes of one occurrence all share the same occurrence attributes, for example,
find number, quantity, and notes, as specified for the substituted part.
Substitute components are item revisions in a precise assembly and items for an
imprecise assembly. In an imprecise assembly, the revision rule selects the correct
revision of a substitute component.
If you drag and drop BOM lines and there are substitutes in the selection, the drop
operation ignores the substitutes and only copies the primary BOM lines.
When you pack BOM lines with substitutes, the substitute lines associated with the
pack master are displayed as its siblings. A group of BOM lines can be packed only if
they have the same set of substitutes. The pack count for the preferred BOM line
includes the substitutes. For example, if a packed BOM line contains three BOM
lines and each of the BOM lines has one substitute part, the pack count is shown as
six. If the primary BOM lines do not have the same substitutes, you cannot pack
those BOM lines.
When a BOM line is packed, adding a substitute to the packed line recursively add
the same substitutes to all of the occurrences. Likewise, removing a substitute from
the packed line recursively removes the substitute from all of the occurrences.
You cannot add substitute BOM lines to substitute groups.
BOM rollup report calculations exclude substitute lines.
When BOM markup is enabled, added or removed substitute lines are marked.
2. Load the structure that has substitutes defined for primary items.
Teamcenter displays substitutes as separate lines at the same level as the
corresponding primary items. For example:
2. Select the line in the product structure in Structure Manager for which you want
to define this item revision as a substitute.
You can also add a substitute to more than one line in a single operation by
selecting all the necessary line. If the lines are packed, unpack them before
you select them.
3. Choose Edit→Paste Substitute to paste the substitute directly. You can also
choose Edit→Paste Special and click As Substitute of Selected Line in the
resulting dialog box.
You can also type in the item identifier of the substitute directly, by selecting the
line in the structure, choosing Edit→Add..., and clicking As Substitute of Selected
Line in the resulting dialog box.
2. Select the substitute you want to edit, and make your modification in the data
pane.
Teamcenter saves the edited properties.
Note You must have necessary permissions to edit substitute parts.
For substitutes, there are no occurrence properties. You can only edit
properties for items, item revisions, and master forms.
You cannot make in-context edits or create incremental change data for
substitute lines.
Compare substitutes
If you display substitutes as separate lines, follow this procedure:
1. Load the product structures with substitutes that you want to compare in two
separate BOM windows.
2. Choose Tools®Compare.
The BOM Compare dialog box appears.
3. Select the desired report options and the Single level (with substitutes) mode,
and then click Apply.
Teamcenter generates a BOM Compare report that compares the substitute
parts as well as the primary parts.
Note You can only compare substitute parts with other substitute parts, not
with primary parts.
If you choose any other comparison mode, the results may be incorrect.
• Notifies owners of the parent BVRs of all related parts by Teamcenter e-mail.
• Removes the selected substitute part from the substitute part list.
3. Select the substitute component you want to remove and click (Remove) or
choose Edit→Remove.
You can also press Shift+Ctrl to select more than one substitute in the list for
removal. If you remove all listed substitutes, the line in the product structure is
no longer marked as having substitutes.
3. Click Yes.
This action only removes the substitute from the substitute list of the primary part.
It does not delete the underlying part.
4. If you have write access to the BOM view revision, you can save this change
to the structure. If you do not have write access, Teamcenter warns that you
cannot save the preferred substitute but you can make a temporary change. The
ability to make a temporary change is useful if you want to visualize one of the
nonpreferred substitutes in the structure.
2. Verify the parent lines and selected substitute items are those you want to relate.
You can also click the Preview button to check the relation to be created.
3. When you are satisfied that the correct relationship is selected, click the Create
button to confirm the selection.
Teamcenter creates the relationship between the proposed substitutes and saves
it in the database; it is not necessary to explicitly save changes to the product
structure. If you create an incorrect relationship, click the Reset button to reset
the changes.
Note The Related Substitutes menu command is only visible if your site
administrator sets the PSE_enable_related_substitutes preference to
True.
When you save a product structure that includes related substitute parts as
a new structure, all substitute part relations are carried forward.
2. Click the Create button to commit the relation. In the previous example,
Teamcenter relates substitute A for the lower bearing, substitute A for the upper
bearing and substitute A for the fuel pipe.
3. Select the relation to edit and click the Cut button to remove it, or click the
Modify button to change the relation.
Note To modify substitute part relationships, you must have write access to
the parent BOM view revisions of the selected lines. If you do not have
permission to modify either of the parents, you cannot modify the substitute
part relationships.
2. To add an optional part, select the structure line, click the Add button and
Teamcenter displays the Add Optional Part dialog box. You can then enter or
browse for the item identifier and name of the component to add as an optional
part. To remove an optional part, select the line and click the Remove button.
If Data Exchange is installed at your site, you can export a configured product
structure to a Briefcase file to share with a partner or supplier.
You can export:
• Product structures that are configured by a revision rule, variant rule, and
incremental change.
• Product structures that are partially configured by only a revision rule and
a variant rule is not applied.
1. Select the top line of the product structure to export and choose
Tools→Export→To Briefcase.
Teamcenter displays the Export To Briefcase Via Global Services dialog box.
3. Select the check box corresponding to each of the export options you want to
use and then click OK.
Teamcenter closes the TIE Export Configured Export Default dialog box.
4. In the Export To Briefcase Via Global Services dialog box, enter all the required
information including Reason, Target Sites, Option Set, Briefcase Package
Name, Revision Rule, and Variant Rule, and then click OK.
Teamcenter displays a Remote Export Options Setting confirmation dialog box.
5. Click Yes.
Teamcenter starts the export of the product structure using the options you
entered.
2. Select the structure line representing the assembly in the product structure.
To export without structure information, open the item or item revision. When
you choose an item, Teamcenter identifies the item revision from the default
revision rule.
3. Choose Tools→BOM→Export.
Teamcenter displays the Export to Connection dialog box.
Note The Export to Connection menu command is available in Structure
Manager only if at least one application is registered to which you can
export data.
Option Description
• Select an A root directory is shown according to the preset
existing preference for the root directory location. You
connection must define a unique connection name. Choose the
Select an existing connection command to use a
• Create a new previously-defined connection or choose the Create a
connection new connection to define a new connection.
Export Rule: • Add
Adds the primary file of the dataset to the
connection.
• Resend
Reexports the selected file and all secondary
files with attribute information to the connection
directory. Any existing files are overwritten. Only
use Resend if you made an error in modifying the
files and you want your export data identical to that
in Teamcenter.
• Refresh
Checks if the selected file is modified in Teamcenter
since the export to connection. If so, Teamcenter
exports the selected file and sends the latest
attribute information. It then ensures all the
components of the selected files are in the connection
by invoking Add for each component file.
Dataset Type Lists all the dataset types that are registered and can
be exported, if they appear in the assembly structure.
You can:
• Select a single dataset type to export.
Once you make the necessary selections, the top structure line appears. It can be
configured and expanded, if necessary.
5. Check the appropriate boxes in the dialog box and click OK to initiate the export
operation:
Skip Select none of the boxes. Teamcenter exports the selected
datasets under this line.
Export Select only the Export box. Teamcenter exports the
selected datasets under this line but does not check them
out (makes a read only copy).
Export+CO Select the Export and CO boxes. Teamcenter exports the
selected datasets under this line and checks them out
(makes a read/write copy).
Note A checkout can be performed only if you have write
access to the dataset.
Add parts to NX
You can add parts from the product structure and paste them into an assembly
in NX, as follows:
1. Find the parts to add to NX. These may be individual parts outside the context
of any assembly (items or item revisions) or parts in the context of an owning
assembly (structure lines).
To find individual parts, such as brackets or seals, and send then items or item
revisions to NX without any assembly context information:
b. Select the required items or item revisions and copy them to the clipboard.
2. Copy the items, item revisions or structure lines from the Teamcenter clipboard
to the NX clipboard by right-clicking the clipboard symbol in the lower right
corner of the Structure Manager window and choosing Send clipboard contents
to NX.
The item revisions and/or lines on the rich client clipboard are then transferred
to the NX clipboard.
Note Only item revisions, not items, are sent to NX. If the clipboard contains
any items, Teamcenter identifies the latest working item revision
corresponding to each item and sends them to NX instead.
3. Once you transfer the parts to the NX clipboard, add them to an assembly
in NX using one of the NX paste options. The parts become components at
the currently selected level in the NX assembly. Because a structure line has
positioning information, the corresponding new components are positioned
according to the spatial information stored in Teamcenter and, consequently, the
parts are positioned correctly regardless of the currently selected level in the NX
Assembly A Assembly E
Sub Assy B
Assembly A
2. Choose Edit→Remove.
Teamcenter displays the Removing Lines dialog box.
2. Select one or more (item elements) target lines in the structure and choose
Edit→Paste.
If you copied more than one source line to the clipboard, but only selected a
single target line, Teamcenter displays the Select Object for Replace dialog box.
Otherwise, it replaces the target item elements with the source item elements
and updates the instance numbers, as appropriate. If you attempt to replace a
target item element with a source item element of another type, Teamcenter
replaces only those lines where the source is a subtype of the target type.
Otherwise, it displays an error message and does not replaces any lines.
3. If Teamcenter displays the Select Object for Replace dialog box, select the
required source item element from those listed and click Replace.
Create a connection
To create a connection between lines with a PSConnection relationship:
1. Choose File→New→Connection→Revisable to create a revisable connection.
Teamcenter displays the New Connection wizard.
2. Choose the connection type and its options, then click Finish.
Teamcenter creates the connection as an item element.
3. Select the lines in the product structure you want to connect and the connection,
then choose Tools→Connection Manager→Connect.
Note You can also right-click the lines and choose Connect.
Create a link
To create a link between lines with a GDELinkLine relationship:
1. Choose File→New→Connection→Non-Revisable to create a non- revisable
connection (link).
Teamcenter displays the New Link wizard.
3. Select the lines in the product structure you want to link and the link, then
choose Tools→Connection Manager→Connect.
Note You can also right-click the selected lines and choose Connect.
• Custom note
Contains information that is unique to an individual part or document. It is
not stored in a library. A custom help can only be attached to a single item
or item revision.
Note Do not confuse standard notes and custom notes attached to items or item
revisions with occurrence notes.
For information about occurrence notes, see Displaying occurrence notes.
For detailed information about how to view standard notes or custom notes, see
Define or edit custom note text.
4. Select the line that represents the note you want to define or edit.
If the note is saved in rich text (RTF), it opens in Microsoft Word; otherwise,
it is displayed as editable text fields.
5. For a standard note, make the necessary changes, then click Apply to save them.
For a custom note in text format, edit the Note Text field, then click File→Save
in Teamcenter.
For a custom note in RTF format, edit the content with Microsoft Word and save
the changes with Word’s Save command.
Deleting items
You can delete a single selected item or you can recursively delete all items below
a selected line. You must have read-write permissions to the item to successfully
delete it.
Note Deleting an item occurs in two steps–removal of the line from the parent
in Structure Manager and then deletion of the item from the database. If
the deletion fails, the line is removed from the parent, but the item is not
deleted from the database. (Deletions typically fail because the user does
not have the necessary permissions.) You can search for the item, then copy
and paste it back into the structure.
3. Click OK to confirm and remove the item from the product structure.
Note This action permanently removes the item from the Teamcenter database
if you have read-write permissions to the item.
• The item and its revisions are not referenced by any other occurrences outside
the structure.
• You have delete permission for the item and all its revisions.
• Neither the item or any of its revisions is checked out or otherwise locked.
Caution Only use recursive deletions on product structures that do not contain
CAD data. CAD integrations, including the Teamcenter Integration for
NX, may track dependencies at the dataset level, as well as at the item
or item revision level. Such dependencies cause the recursive deletion to
fail because of referential integrity violations. For structures containing
CAD data, manually delete datasets and items from the top down in a
hierarchical fashion when necessary.
1. Select the line in the product structure below which you want to delete all items
and assemblies, then choose Edit→Delete or click the Delete button.
3. Select any associated objects to delete (for example, datasets) in the Explore
dialog box and click OK.
Teamcenter displays the dialog box listing items and any associated objects
selected for deletion. The list of items includes both items that can be deleted
and items that cannot be deleted. If Teamcenter determines that an item cannot
be deleted, it displays the reason.
If you set suitable types or relations with the Type or Relation buttons,
Teamcenter automatically checks all these objects for deletion in the dialog box.
Alternatively, you can click the Select All button to select all objects for deletion.
4. Click Yes in the Delete dialog box to begin deleting all applicable items and
the selected associated objects.
Teamcenter shows the status of the deletion process in the status bar.
You can pause deletion process by clicking the Stop button at any time. You can
terminate the deletion process by clicking the Abort button.
When the deletion process is complete, Teamcenter displays an updated Explore
dialog box. This contains a flattened list of all the items in the substructure of
the originally selected item. Any duplicates are removed and any items that
Teamcenter could not remove are indicated.
Grading structures
Teamcenter allows you validate that the design represented by the product structure
contains only approved parts. This process is sometimes called BOM grading. Parts
approved for use in one project or locale may not be approved for another project or
locale. For example, a part may comply with a European standard but not a U.S.
standard. Tracking such approvals manually is time-consuming, and this feature
automates much of the effort.
Grading results are stored in a structure context associated with the validated
product or assembly, and may be retrieved when required.
The grading process checks that each part (item revision) is valid under all
conditions under the selected checker. If the structure contains subassemblies, it
checks each part in the context of each subassembly. It also checks generic design
elements (GDEs) if any are included in the structure.
For example, if you want to check that a product is valid for the U.S. market or
the Asia market, the administrator may create the checkAsiaComplianceRule,
checkUSComplianceRule, and CheckPartIsApproved conditions and assign
them to business objects using verification rules. These conditions may be included
in two separate checkers, as follows:
• Asia checker
checkAsiaComplianceRule and CheckPartIsApproved conditions
• U.S. checker
checkUSComplianceRule and CheckPartIsApproved conditions
Run grading
1. Configure the product structure and select the line that represents the context
in which you perform grading. This may be the top line of the product or a
subassembly line.
3. Select the agent revision and desired checker, click , and then click OK to
begin grading.
On completion, Teamcenter displays the BOM grading viewer. The BOM
Result box shows the result for the complete structure, based on the results for
individual parts.
Teamcenter updates the BOM grading viewer with the relevant validation
results.
Tip You can filter the validation results with the Checker, Target Type, and
Condition lists.
Examine the Validation Name and Condition Name property columns to
identify the validation agent and condition used for validation.
2. Examine the Result property column to determine the validation status of each
part, as follows:
Symbol Description
Pass.
Fail.
Unknown or no data. If you modify the
structure after running grading, the status
of the affected parts is shown as unknown.
This status may also indicate that the selected
checker does not contain any condition that
tested the part.
The Detail Information pane shows information about the cause of any failures.
3. (Optional) Filter the structure display by clicking one of the following buttons.
4. (Optional) Click to rerun the validation at and below the selected level,
rather than on the entire structure.
2. Choose the override type (for example, Temporary or Permanent), the requested
Override State (for example, Passed), the Override Category, the Override
Reason, and the Detailed Reason.
You must also choose the Override Decision User (any user with an Override
Approver role) and then click OK.
Teamcenter updates the Override To State column in the tree with the requested
state. It also sends a Teamcenter mail to the selected override decision user.
3. The designated override decision user receives the mail, right-clicks the folder in
the mail, and then chooses Send To→BOM Grading Viewer.
Teamcenter opens the structure and highlights the line for which a result has
an override request pending.
5. Choose Approve or Reject, type any optional comments in the Override Decision
Comments box, and then click OK.
Teamcenter sends a mail containing the decision to the requesting user and
updates the structure status. Similarly, if the override decision user updates or
deletes the override request, Teamcenter also sends a mail message.
6. Repeat the previous steps for each additional part for which you want to override
the grading status. You must request an override for one part at a time.
2. Select one or more of the predefined regulations listed in the dialog box, and
then click OK.
Teamcenter starts the compliance check process and sends the request to the
configured compliance checker.
2. Select one of the regulations listed in the dialog box, and then click OK.
Teamcenter starts the exemption workflow and adds a new task to the
compliance officer’s worklist.
3. In the workflow viewer, the compliance officer selects one or more exemption
with its expiry date, enters the reason for the exemption in the Comments box,
and then clicks Save to complete the exemption workflow.
2. The compliance officer receives and completes a workflow task to review the
vendor parts.
Teamcenter sends the selected vendors an e-mail with two Microsoft Office Excel
spreadsheets attached. One spreadsheet contains vendor part information and
the other a list of materials and substance information.
Note Sending the Excel spreadsheets with list of materials and
substance information is optional and is controlled by the
SUBSCMPL_send_materials_list preference. If this preference is set
to true, Teamcenter exports a list of all material revision instances,
together with the material substance declaration request.
3. The vendor reviews and completes the spreadsheets, and then e-mails them
back to the compliance officer.
• Updating the change record while opening the Supersedure dialog box as
described below.
To create structure changes records for an affected assembly sent to Structure
Manager, click the toolbar button to open the Supersedure Definition dialog
box; the assembly must be under change control. Teamcenter displays a dialog
box asking if you want to update the change records. You can then create or
update the existing changes, or leave them unchanged.
Link requirements
Use trace links to associate requirements with items, item revisions, and absolute
occurrences that satisfy the requirements. To create, view, or delete trace links, and
generate a traceability report, you must enable the trace link features.
For more information about requirements, trace links, and traceability reports, see
the Systems Engineering Guide.
Note This procedure sets the Tracelink_Edit_enabled preference to true. That
setting also enables the trace link features in other Teamcenter applications
such as My Teamcenter, Systems Engineering, and Multi-Structure Manager.
1. Choose Edit→Options.
Teamcenter displays the Options dialog box.
2. Choose Tools→Trace Link→Start Trace Link, click the Start Trace Link
Creation button on the toolbar, or right-click the selection and choose Trace
Link→Start Trace Link.
You can also choose Edit→Copy, click the Copy button on the toolbar, or
right-click the selection and choose Copy.
3. Select one or more target objects, for example, an item, item revision, or absolute
occurrence.
4. Specify the trace link subtype and name by doing one of the following:
• To accept the default subtype and name, choose Tools→Trace Link→End
Trace Link, click the End Trace Link Creation button on the toolbar, or
right-click the selection and choose Trace Link→Trace Link→End Trace Link.
b. In the list of subtypes on the left, select the subtype to assign to each
trace link.
c. In the Name box, type the name to assign to each trace link.
In the Description box, you can type plain text as additional information.
A trace link symbol is shown for each defining and complying object. To view
a defining or complying path, generate a traceability report.
1. In the structure pane, select the object for which you want to generate the report.
• For an interactive live Excel file that is connected to Teamcenter, click Live
integration with Excel (Interactive).
• For a live Excel file that is not connected to Teamcenter, click Live integration
with Excel (Bulk Mode).
You can accumulate changes and later connect the file to Teamcenter.
• To export the data to an Excel file that also contains import processing
information on a separate sheet, click Work Offline and Import.
• To check out objects while exporting to live Excel, select Check out objects
before export.
Note The checkout applies to all objects being exported. Use this option
carefully if you are exporting a large set of objects or perhaps an
entire product structure.
For information about managing and creating Excel export templates, see the
Systems Engineering Guide.
Note • Copy URL is unavailable if you select more than one object to export.
Excel opens a temporary file. You can create a permanent file by choosing File→Save
As in Excel to display the Save As dialog box.
If you save a live Excel file, you can open it later in My Teamcenter to reconnect
it to the database.
Note Values that you cannot change in Teamcenter are unavailable in the cells
of the live Excel file.
Note When deleting a trace link on an occurrence object, you must consider the
context of the occurrence.
Tip You can use the following procedure to delete trace links from one or more
workspace or occurrence objects at a time.
2. Click the Delete Trace Link button at the bottom of the traceability report or
Traceability view or press the Delete key.
Teamcenter displays the symbol in front of the line and colors the line green
to show that the item is the context for the creation of absolute occurrences.
In addition, Teamcenter grays out all siblings of the selected context and you
cannot create absolute occurrences for these lines. The in-context item is also
identified in the title bar of the structure tree.
3. Select the source line, or select multiple objects by using the standard Windows
functions.
b. In the list of subtypes on the left, select the subtype to assign to each
trace link.
c. In the Name box, type the name to assign to each trace link.
You can view trace links in the Traceability view of Systems Engineering or by
creating a traceability report.
• Create signals in structures and associate them with interfaces and connections.
2. Navigate through the search results, collecting objects of interest in the selection
box at the right of the pane.
• You do not know the ID but would like to search within a specific group or class.
For this, you must know how to select a class. From within this class, you can
either search all objects in the class or search for objects matching specific
criteria.
• You do not know the ID but know that the library object should possess specific
attribute values. Use the attribute value search to perform this search. You
can narrow this search by first selecting a class, or specifying all or part of an
object ID.
Note There are two search buttons in the Properties pane:
• Click the search button to the right of the Object ID box to search
the entire classification hierarchy. You can narrow down this search
by entering a search type.
• Click the search button at the bottom of the Search pane to search
within a selected class.
This type of search can include any search refining features, such as
object ID, attribute value, or search by type.
Additionally, there is another search button below the hierarchy tree. This
is the quick search button.
For more information, see Use the quick search feature.
Search by object ID
If you know at least a portion of the object ID of a library object, you can use the
object ID search feature. An object ID search encompasses the entire classification
hierarchy and cannot be limited to the contents of a particular class or subclass.
1. Click the Search pane located to the right of the hierarchy tree.
2. Type the exact object ID or partial object ID and wildcard characters in the
Object ID box, located at the top of the Search pane.
4. (Optional) Click the revision rule hyperlink on the title bar to apply a revision
rule for the search. If you enter a specific revision in the Object ID box, the
search ignores the revision rule. If a revision rule is already set, it is displayed
in the revision rule link.
For more information about configuring revision rules in the Data Dictionary
Search Dialog, see Apply a revision rule.
For a complete discussion of revision rules, see Using item revision configuration.
5. Press Enter or click the Search button to the right of the Object ID box.
The object ID search returns the objects found in alphabetical/numeric order
by object ID. The first object found is displayed in the Properties pane. When
navigating through the objects, the class and subclass to which the object belongs
are highlighted in the classification tree. The total number of objects found is
displayed in the Search Results box.
Search by type
You can search the classification hierarchy for library objects classifying specific
workspace object types:
1. In the classification tree, expand the desired class and select it by either:
• Double-clicking if it is a leaf node.
Click To
Search among all classification instances. This is the default search
method.
Search among all classification instances that classify a workspace
object.
Search among all classification instances that do not classify a
workspace object.
Search among all classification instances that classify an item.
Search among all classification instances that classify an item
revision.
Search among all classification instances that classify a process.
Click To
Search among all classification instances that classify a process
revision.
4. Select a type of workspace object to narrow your search. Only library objects
classifying this type of workspace object are found in the search.
5. (Optional) Click the revision rule hyperlink on the title bar to apply a revision
rule to the search. If you search by a type that excludes revisions (for example,
item or process), the search ignores the revision rule. If a revision rule is already
set, it is displayed in the revision rule link.
For more information about configuring revision rules in the Data Dictionary
Search Dialog, see Apply a revision rule.
For more information about revision rules, see Using item revision configuration.
6. Click the Search button at the bottom of the Search pane to list all matching
instances within the class.
The total number of instances that match the search criteria is displayed at
the bottom of the Search pane.
Note The Search pane displays no values upon completion of the search. You
must switch to the Properties or Table pane to navigate through the
results and display the values for a specific instance.
• In the Properties pane, use the navigation arrows at the bottom of the pane
to browse forward and back through the list of items that matched your
search criteria. As different objects are selected, the classification hierarchy
is updated to show the class of the selected object.
Two modes are used for updating the classification hierarchy when
displaying the search results:
o Click the View in class stored button to display the class in which the
item is stored.
o Click the View in class searched button to display the class that you
selected as a basis for the search.
As you view your search results, also use the Viewer pane to display any image
associated with the current item. If you select multiple objects in the table and
switch to the Viewer pane, only these objects are available in the viewer.
Selecting a class
The first step in searching the classification hierarchy is to find a class in which to
search. There are three methods to select a group or class:
• Navigate through the classification hierarchy manually, clicking the groups and
classes until you find your desired class.
You can search for a class using any of the alias names shown in the class tooltip.
4. Right-click the class in the hierarchy tree within which you want to search.
5. Choose Select.
The Search pane displays the attributes associated with the selected class, and
the images appear in the class image window.
Note If the class or subclass you select is a leaf node (lowest level node) in the
hierarchy, you can double-click the node to display it in the Search pane,
rather than use the right mouse button.
1. Click the Find Class button located beneath the hierarchy tree.
The Search Class dialog box is displayed at the bottom of your window. To
move the dialog box, double-click the title bar and drag it to another location
on your desktop.
4. To start the search, either click the magnifying glass button located in the
upper-right corner of the dialog box or press Enter.
Teamcenter displays the results of the search in the message area of the dialog
box, sorted in the same order as the hierarchy tree display.
5. To display an object in the tree, double-click the entry in the results list.
The hierarchy tree expands to display the selected group, class, or subclass. The
path to the object is indicated in bold text.
6. Click the left and right arrow keys beneath the class hierarchy tree to
move through the search results to locate the desired class or group.
7. Right-click the class in the hierarchy tree within which you want to search.
8. Choose Select.
The Search pane displays the attributes associated with the selected class, and
the images appear in the graphics window.
Note If the class or subclass you select is a leaf node (lowest level node) in the
hierarchy, you can double-click the node to display it in the Search pane,
rather than use the right mouse button.
2. (Optional) Click the revision rule hyperlink on the title bar to apply a revision
rule to the search. If you search by a type that excludes revisions (for example,
item or process), the search ignores the revision rule. If a revision rule is already
set, it is displayed in the revision rule link.
For more information about configuring revision rules in the Data Dictionary
Search Dialog, see Apply a revision rule.
For more information about revision rules, see Using item revision configuration.
3. Determine the scope of the search by clicking the Search Scope button. By
default, the scope is set to Hierarchy.
• Click Hierarchy to search within the selected class and all related child
classes.
5. Click one of the following at the bottom of the pane to narrow down the search.
Click To
Search only in metric classes.
Search only in nonmetric classes.
Search in both metric or nonmetric classes.
Caution If you are searching in a different unit of measurement than the one
that you use to enter the attribute value, be sure to enter enough
digits after the decimal point to avoid rounding errors.
For more information, see the Classification Guide.
6. Click the Search button at the bottom of the Search pane to list all search
matches within the class.
The total number of objects that match the search criteria is displayed at the
bottom of the Search and Properties pane.
Note The Search pane displays no values upon completion of the search. You
must switch to the Properties or Table pane to navigate through the
results and display the values for a specific instance.
2. Type values, including relational operators and wildcard characters, in the boxes
corresponding to the attributes by which you want to search.
You can:
• Change the displayed unit of the value by clicking it or typing the unit in
the dialog box along with the value.
Teamcenter changes the unit for you automatically.
Note If the attribute or attribute value by which you want to search is not
available for searching, one of the following reasons may apply:
• It is a reference attribute.
For more information about assigning reference attributes, see the
Classification Administration Guide.
3. (Optional) Click the revision rule hyperlink on the title bar to apply a revision
rule to the search. If you search by a type that excludes revisions (for example,
item or process), the search ignores the revision rule. If a revision rule is already
set, it is displayed in the revision rule link.
For more information about configuring revision rules in the Data Dictionary
Search Dialog, see Apply a revision rule.
For a complete discussion of revision rules, see Using item revision configuration.
4. Determine the scope of the search by clicking the Search Scope button. By
default, the scope is set to Hierarchy.
• Click Hierarchy to search within the selected class and all related child
classes.
7. Click the Search button at the bottom of the Search pane to list all search
matches within the class.
The total number of objects that match the search criteria is displayed at the
bottom of the Search and Properties pane.
Note The Search pane displays no values upon completion of the search. You
must switch to the Properties or Table pane to navigate through the
results and display the values for a specific instance.
10. (Optional) Perform subsequent searches within the same class or subclass by
clicking in the Search pane and repeating the process.
• ICS_search_use_revision_rule
Enables or disables revision rules for classification searches.
For a complete discussion of revision rules, see Using item revision configuration.
For more information about revision rules, see Using item revision configuration.
Relational
operator Definition For example, if you type
= Equal to =3.0 in the Corner Radius attribute box of the Taper
Shank End Cutter subclass, all library objects
within the subclass with a corner radius equal to 3.0
are found. You can achieve the same behavior by
typing a number. If no value is given after the equal
sign, the system searches for all instances where no
value is set for the attribute.
> Greater >3.0 in the Corner Radius attribute box of the Taper
than Shank End Cutter subclass, all library objects
within the subclass with a corner radius greater than
3.0 are found.
< Less than <3.0 in the Corner Radius attribute box of the Taper
Shank End Cutter subclass, all library objects
within the subclass with a corner radius less than
3.0 are found.
>= Greater >=3.0 in the Corner Radius attribute box of the Taper
than or Shank End Cutter subclass, all library objects
equal to within the subclass with a corner radius greater than
or equal to 3.0 are found.
<= Less than or <=3.0 in the Corner Radius attribute box of the
equal to Taper Shank End Cutter subclass, all library
objects within the subclass with a corner radius less
than or equal to 3.0 are found.
!= Not equal to !=15.00 in the Diameter attribute box, all library
objects with a diameter not equal to 15.00 are found.
If no value is given after the equal sign, the system
searches for all instances where any value is set for
the attribute.
Relational
operator Definition For example, if you type
– Range 10.00 – 20.00 in the Diameter attribute box, all
library objects with a diameter within the range of
10.00 to 20.00 (including the values 10.00 and 20.00)
are found. A blank space must precede and follow
the hyphen.
| OR Walter | Kennametal in the Vendor attribute box
of the Taper Shank End Cutter class, all library
objects within the class with a vendor of Walter or
Kennametal are found.
You can use the wildcard character (*) in this type of
statement.
“” Exact string “blue or green”, Teamcenter searches for the string
blue or green. If you type “4 – 10”, Teamcenter
searches for the string 4 – 10, not the range 4–10.
• Click the View in class searched button to display the class that you selected
as a basis for the search.
You can see the active unit of measurement in the attribute values title bar in the
Properties pane using the following symbols.
Symbol Description
The library object is currently displayed and stored in a metric
system of measurement.
Symbol Description
The library object is currently displayed and stored in a nonmetric
system of measurement.
The library object is currently displayed in metric, but was
originally stored in a nonmetric measurement system.
The library object is currently displayed in a nonmetric
measurement system, but was originally stored in a metric system.
2. Use the scroll bars to move through the found library objects.
3. (Optional) Sort the table data; double-click the column header corresponding to
the property to switch between ascending, descending, and natural sort order.
Teamcenter can display different units of measurement in the same column. The
displayed unit depends on the optimized unit for each of the attribute values.
Teamcenter sorts these columns based on the attribute values in the storage unit.
For more information about optimizing attribute values, see the Classification
Administration Guide.
4. (Optional) Select a line in the Tree pane and click to view its properties.
Note If the object does not have an item attached, or if the item does not contain
a graphic, no image appears in the Viewer pane.
3. (Optional) With library objects selected in one of the panes, click to add them
to the selection box on the right.
4. When you finish adding objects to the selection box, select the objects in the
selection box that you want to add to the structure and click OK.
The item or item revision classified by the library object is displayed in Structure
Manager. If a library object has no item or item revision attached, the system
creates one so that it can open that item in Structure Manager.
If you open multiple library objects at once by selecting several library objects
in the Data Dictionary Search Dialog, they are all transferred to Structure
Manager. The selected objects appear in the structure you are building in the
order in which they appear in the Data Dictionary Search Dialog table.
Releasing structures
You can release any complete product or subassembly structure using a Workflow
process defined for your site. You can release any of the following:
• Item revision with assembly
• Change revision
Release a structure
1. Select the appropriate top line in the navigation tree and choose Tools→Process
and Change Selector.
Teamcenter displays the Process and Change Selector dialog box. This dialog
box contains:
• An input tree in the top left of the box. This allows you to refine the selection
of the structure to release.
• A process tree in the bottom left of the box. This allows you to select the
required Workflow process, its targets and its references.
• A search pane in the top right of the box. This allows you to search for
objects to release.
• A result pane in the bottom right of the box, showing the results of the last
search.
• Revision Rule.
Lists all available revision rules.
You can also check one or both of the following check boxes to refine the search
results:
• Unreleased.
4. If appropriate, you can start a separate process with selected result lines as
the target:
a. Ensure the correct process is selected in the process tree.
b. Select one or more lines in the results pane and click the Attach To Process
button.
Teamcenter displays the New Process dialog box with the selected lines
as the target attachments.
c. Click the Process Template tab, select the appropriate process template
and click OK.
Teamcenter creates the new process and updates the result pane in the
Process and Change Selector dialog box with the new status of the objects.
5. If your search criteria included structure lines, you can attach selected child
lines to a BVR process as follows:
a. Select one or more lines in the results pane and click the Copy button.
b. Select the appropriate Targets folder in the process tree and click the Attach
To Process button to paste the lines as targets of the process.
6. If you are using change management, you can include changes to items elements
(for example, GDEs, connections and signals) in controlled changes to the parent
assembly. Use the ECM-attach-components-to-change action handler to
identify all unreleased child revisions and GDEs at the first level of the affected
assembly to the change folder specified in the action handler. You can only use
this action handler in a process where the primary target is a change revision.
If you do not specify a revision rule, Teamcenter uses the default revision rule
specified in the TC_config_rule_name preference.
To do this, you must select a change revision in the navigation tree before
choosing Tools→Process and Change Selector. If you do this, the change
revision is highlighted in the input tree of the Process and Change Selector
dialog box. To attach the change revision to a change process:
a. Select one or more lines in the results pane and click the Copy button.
b. Select the appropriate change process Targets folder in the process tree
and click the Attach To Change button to paste the lines as targets of the
change process.
7. If you want to control new parts in a structure with a separate change process
(that is, parts that are not yet change controlled), select the relevant lines in the
result pane and click the Attach To Change button. (Do not select a process in
the process tree.)
Teamcenter displays a dialog box that allows you to search for the relevant
change revision. After you locate the change revision, you can copy the objects
to attach from the left-hand pane into the appropriate change folder in the
right-hand pane.
• Teamcenter recovers the BOM session to a usable status, but not necessarily the
exact state before failure or time-out occurred. For example, if you expanded
multiple levels of the structure, Teamcenter recovers only the first-level
expansion of the structure.
• Unsaved changes are lost. For example, if you made changes in normal editing
or pending edit mode, but did not save them, the changes are lost.
• If you were performing a complex action when the server terminated, Teamcenter
may not recover to the same step. For example, if you started to insert a level in
the structure, after recovery Teamcenter does not resume at the same step in the
wizard. Incomplete actions do not execute correctly; you should cancel them if
they do not terminate automatically.
• All dynamic (run-time objects) such as BOM windows and BOM lines are invalid
after reconnection even though the Structure Manager user interface may be
recovered to the previous state.
• If you copied BOM lines to the clipboard before the server terminated,
Teamcenter removes them.
• If the server terminated after encountering bad data during expansion, the
recovery process may expand the same structure and encounter the same bad
data. You must resolve these data issues in the database manually.
• If the server terminated due to memory shortage when expanding the first
level of the structure, the recovery process may expand the same structure and
encounter the same memory shortage. You must resolve such memory issues
separately.
• If the data pane was open, Teamcenter closes it after recovery and it may no
longer function correctly.
Once Structure Manager is running in the recovered session, you should perform
any necessary cleanup tasks, and then continue working.
• bl_is_suppressed
This read-only, runtime property indicates if a line is suppressed. A line
is considered suppressed if the variant state is suppressed, the line is
not configured, or the occurrence is explicitly suppressed by setting the
bl_occ_is_suppressed property. If any of these conditions is true, the
bl_is_suppressed property is true, otherwise it is false. The value of
the bl_is_suppressed property is not affected by the Show Suppressed
Occurrences or Show Unconfigured commands.
Occurrence elements
The following table lists elements of the product structure that are relevant to
occurrences, absolute occurrences, and managed occurrences.
Element Purpose
Absolute occurrence A relationship between a parent assembly and an item
one or more levels lower in the structure. The parent
assembly is the context in which the absolute occurrence
exists. You can define data on the absolute occurrence
that overrides the data stored on the item when you
select the context assembly and view the structure. Both
relative occurrence data (notes and transforms) and
attachments can be overridden with data on absolute
occurrences.
Each absolute occurrence can have one or more unique
attribute values that distinguish it from the other
absolute occurrences derived from the same single
occurrence.
Occurrence (relative) (Sometimes called relative occurrence.) A hierarchical
structure relationship between the immediate parent
assembly and its child component item (in an imprecise
assembly) or item revision (in a precise assembly). You
can use a find number to identify for an occurrence, but
this number may not be unique. Data can be stored on the
occurrence, including occurrence notes and transforms.
• If the BOM view revision parent assembly is imprecise, the occurrence references
an item for the component. The revision is determined by the revision rule.
Note If you try to paste an item revision with an imprecise BOM view revision
into an item revision that has a precise BOM view revision, Teamcenter may
display a warning message. If you paste an imprecise assembly into a precise
structure, it displays a warning. If you paste a precise assembly, Teamcenter
applies the precision of the parent assembly and does not display a warning.
particular BOM view revision, you can define a subset of BOM line properties that
other users can edit in the context of the BVR. You can also allow users to attach
forms or datasets in context, by configuring business rules that define the types of
primary and secondary objects for the relationships.
When a user enters in-context values or attachments, Teamcenter overrides certain
structural data associated with a relative occurrence in the context of a specific
higher level assembly. Data you can override includes:
• Occurrence notes
• Occurrence type
• Quantity
• Absolute transform
• Find number
• Variant condition
A BOM line represents an absolute occurrence with respect to the current top line
in the product structure. You can set occurrence attribute values on such a BOM
line, without those values appearing in the product structure everywhere the BOM
line’s parent appears. There are cases where a user needs to store values specific to
the BOM line with respect to the top line or some intermediate assembly between
the BOM line’s parent and the top line. Absolute occurrences are always created
in the context of a selected top line; the same absolute occurrence may not be in
context for another top line.
The following figure shows an example where two vehicles are built on the same
chassis. The chassis contains two occurrences of a suspension system, one for the
front of the vehicle and one for the rear; these occurrences are positioned relative to
the chassis by transforms T3 and T4, respectively. The suspension assembly contains
two occurrences of a wheel assembly, one for the left side of the suspension system
and the other for the right side of the suspension system. The wheel assembly
occurrences are positioned relative to the suspension assembly by transforms T1 and
T2, respectively. The wheel assembly is composed of a wheel, tire, and valve stem.
The occurrence of the tire is annotated with a recommended tire pressure of 30 PSI.
Vehicle-X Vehicle-Y
Vehicle-X/A Vehicle-Y/A
Chassis
Chassis/A
front rear
Z Z
= T3 = T4
X X
Y Suspension Y
Suspension/A
Axle
Axle/A
left right
Z Z
= T1 = T2
X X
Y Y
Wheel Assy
Wheel Assy/A
P=30psi
Vehicle-X Vehicle-Y
Vehicle-X/A Vehicle-Y/A
Chassis
Chassis/A
front rear
left rear tire left-front
Z Z wheel assy
P=33psi = T3 = T4
X X Z
Y Y = T5
X
Y
right rear tire Suspension
P=33psi
Suspension/A right-front
wheel assy
Z
= T6
X
Axle Y
Axle/A
left right
Z Z
= T1 = T2
X X
Y Y
Wheel Assy
Wheel Assy/A
P=30psi
they override positioning information and recommended tire pressure. The context
of the override and the value is shown in the label on each dashed line.
Specifically, in the context of the vehicle-X, the front tires have a recommended tire
pressure of 30 PSI; this is derived from the relative occurrence of the tire in the
wheel assembly. However, the two rear tires have a recommended tire pressure of 33
PSI; this is explicitly set on the absolute occurrence in the context of the vehicle. The
value of 33 PSI on the absolute occurrence overrides the value of 30 PSI that appears
on the relative occurrence of the tire in the wheel assembly. Vehicle-Y, however, has
a recommended tire pressure of 30 PSI for all four tires.
Positioning information is derived in a similar way. The values specified on the
absolute occurrence override the values that are otherwise derived by catenation
of the transforms from the relative occurrences. That is, in the second figure, T5
overrides the value that would otherwise be derived from the multiplication of T3
and T1. Because this example specifies the transform overrides in the context of the
chassis, both vehicle-X and vehicle-Y use T5.
If you release an intermediate BOM line that represents a subassembly, the line is
locked and you do not have write access to it. However, you can still make changes
to its absolute occurrences in the context of a parent assembly whose BOM view
revision is also released, for example, to attach a dataset with associated JT files.
Released
Unit 20-Up PSE Configured
for Unit 22
IC - 2
+ +
Z
Released A100/A
X
Unit 10-Up Y Note 1=15
T2
IC - 1
Z
+ X
Note 1=12
Y
T1
left right
Released Z Z
Unit 20-Up X X
IC - 3 A200 Y Y A200
T0 T4
Key
(Relative) Occurrence
(PSOccurrence)
Absolute Occurrence
Release PSE Note
Status
IC - 1 Form
Incremental
Change Transform
There is no Remove change on the occurrence data, for example, for the transform
or note 1. You simply define a new value that overrides the value on the normal
relative occurrence. For example, the new value may define an end unit for an
incremental change.
For detailed information about incremental changes, see Managing incremental
changes.
A component or subassembly that appears in more than one product structure can
have the same absolute occurrence in each structure.
You cannot create absolute occurrences directly, only by converting a relative
occurrence and editing its properties. Similarly, you cannot delete absolute
occurrences directly. You cannot create absolute occurrences on substitutes.
An absolute occurrence may appear more than once in the structure, depending
on the context in which you created it.
Note If you use absolute occurrences with product structures
that are not created in NX, see the description of the
PS_allow_plmxml_transforms_with_no_legacy_factor
preference in the Preferences and Environment Variables Reference. To avoid
conversion errors, set this preference to yes if you are configuring structures
for the first time and have no legacy data.
Line Purpose
20487187/C (view) The immediate parent that is in context for
absolute occurrence edits.
The line is also color-coded in the structure
and in the title bar of the pane where the
current context is shown. The color is green
in this example but may be changed by your
administrator.
Lines that are not in the current context are
grayed out. Similarly, the out-of-context parts
corresponding to the grayed out lines may also
be grayed-out in the viewer. You cannot create
absolute occurrences from grayed-out lines in the
current context and you cannot edit an existing
property value on such lines.
Line Purpose
By default, the assembly viewer highlights only those items in the assembly that are
in scope in the selected context; items that are not in context are shown grayed out.
The administrator may optionally change this behavior so that all items are shown.
The structure contains symbols that indicate the status of the structure lines as
follows:
Symbol Indicates
A line containing this symbol is the context for the
creation of certain absolute occurrences. The line is also
color-coded in the structure and in the title bar of the pane
where the current context is shown.
A line that contains this symbol has one or more of
the absolute occurrences edited in a context but not
necessarily the current context.
A property cell containing this symbol is already edited in
a context; the current absolute occurrence data is shown
in the cell. Each cell that contains data for a specific
absolute occurrence includes this symbol.
A line that contains this symbol before its name is a target
for editing data in the current context. Look for a
symbol in one or more properties cells of the same line to
identify if the necessary edits are already made.
Note This symbol identifies a target in the current
context. It may not appear in the same line if you
select a different context.
A line that contains this symbol has an in-context edit
made by an incremental change. The edit may be an add,
remove, or both.
Symbol Indicates
A cell that contains this symbol has an in-context edit
removed by an incremental change.
A cell that contains this symbol has an in-context edit
added by an incremental change.
A cell that contains this symbol has in-context edits added
and removed by an incremental change.
2. Select the top line that is the context of this edit and choose Edit→Toggle
In-Context Mode. You can also right-click the line and choose Set In-Context,
or click the button on the toolbar.
• You cannot enable in-context editing mode for a line that has no children.
3. Click the cell in the lower line containing the property you want to enter or edit.
You must select one of the following supported properties:
• Suppressed
• Position constrained
• Suppression constrained
• Any GRM relation impacted by preferences
• Any occurrence note
• Quantity
• Find number
• Occurrence type
• Variant conditions
• Variant formula
• Absolute transformation matrix
• Unit of measure
• Is designed in place
• Requires positioned design
Caution Ensure you have selected in-context editing mode. If this mode is not
selected, the change is made to every instance of the selected item
anywhere in the assembly.
4. Type the required new value and press the Enter key. A symbol on the line
indicates one of its property cells has an absolute occurrence override.
Note If you create an absolute occurrence override of a property and the same
property is already overridden at a lower level in the structure, the new,
higher level value replaces the existing value. Conversely, you cannot edit
an individual property value if the same property is overridden at a higher
level in the structure.
You can assign identifiers to absolute occurrences and these identifiers are displayed
in two columns in the property table, as follows:
• ID In Context (Top Level)
Shows only the identifier assigned to the line in the context of the loaded
top-level line. You can add or edit an identifier by double-clicking in this cell and
typing the necessary value.
Note Any absolute occurrence identifiers defined at a lower level than the
currently selected top-level line are not visible.
If in-context editing mode is disabled, the top-level line is always
considered the in-context line.
• Transformations
• Quantity
• Viewer information
• Name and ID
• Instance number
• Find number
• Occurrence suppressed
For example, you may want to attach a different occurrence note to each absolute
occurrence to specify additional assembly work instructions.
The level of the absolute occurrence in the structure determines the precedence of
data you attach to it. Data attached at a high or mid-level in the structure override
the corresponding data at lower levels; data attached to an absolute occurrence at
the lowest level does not override data elsewhere.
2. Select the line containing the absolute occurrence with which you want to
associate a new instance-specific dataset or form, then click the Attachments
tab in the data pane.
2. Select the line containing the absolute occurrence for which you want to change
the transformation.
4. Change the position of the affected component and save the changes.
2. Select the line containing the absolute occurrence with which you want to
associate an occurrence note.
2. Select the line containing the absolute occurrence with which you want to
associate a variant condition.
4. Add a new variant condition to the absolute occurrence or edit the existing
variant condition.
The Associated to Absolute Occ? column also shows if the data item is attached
to absolute occurrence.
Data precedence
You can associate data with an item revision or absolute occurrence. You can create
the absolute occurrence in the context of a top-level item.
The following figure shows how visualization (JT) files may be attached to items.
Displaying properties
The following table lists some of the columns available in the properties view of the
product structure and provides a description of their functions.
BOM line properties have display names or system names, and the system names
are in the format bl_xxx. Add or edit a display name for a system name using
Business Modeler IDE, as described in Creating and editing display names.
You can add or remove property columns in the table tree by right-clicking the BOM
window and choosing Insert Columns in the shortcut menu. By default, Teamcenter
displays selection lists of all available properties to add or remove that may contain
a large number of system and custom properties. To make the selection list more
manageable, the administrator can restrict the properties that are displayed by
group or role. You can also freeze commonly used columns so that they are always
visible.
You can save property column configurations at a user, site, or group level. The same
columns are then available for every session and for multiple users.
You can update the values of all the displayed properties in the BOM window by
pressing the F5 key. This feature may be useful if more than one user is working on
the structure and you want to synchronize to the latest information, for example, a
changed value or modified occurrence note.
Note If you make a change to a persistent object (for example, an item, item
revision, item master, item revision master, GDE, or BOM view revision) in
My Teamcenter or a data pane, the BOM line that references the updated
property may not refresh automatically.
For more information about saving property column configurations and freezing
columns, see Managing column configurations.
You specify custom item or item revision classes to add as derived BOM line
properties. To configure the list of available properties of custom item or
item revision classes available to the end user, the administrator sets the
Fnd0BOMLineItemConfigProps and Fnd0BOMLineRevConfigProps Business
Modeler IDE constants and the BOM_Properties_For_Column_Selection
preference.
For more information about adding custom properties to columns, see the Business
Modeler IDE Guide.
In addition to the default and custom properties, your administrator may also create
customized note types.
Note You cannot edit or mark up the first property column (Quantity).
Tip You can use some of additional properties not listed in the table to determine
why a particular line is configured or hidden, for example:
• bl_is_occ_configured
Shows if the line is configured by the current occurrence effectivity.
• bl_ic_state
Shows if the line is configured by the current incremental change.
• bl_variant_state
Shows if the line is configured by the active variant.
2. Select the property whose display name you want to create and scroll to the
Localization section.
3. Click Add.
The Business Modeler IDE displays the Add or Modify Localization dialog box.
4. Enter the display name in the Value Localization box, select the locale, and
set the status to Approved.
For more information on working with display names in the Business Modeler IDE,
see the Business Modeler IDE Guide.
• A group administrator can only save configurations with the scope set as User
and Group.
• If a site has multiple levels of groups, users can access the site configurations
and configurations for all groups to which they belong.
4. Click Save.
Teamcenter creates a column configuration and saves it for the chosen scope.
2. Select the column configuration name you want to apply to the tree table and
click Apply.
Teamcenter applies the column configuration to the tree table and adjusts
the columns in the Structure Manager window according to the applied
configuration.
3. Close Structure Manager and then reopen it again to verify that the correct
column configuration is applied.
Note If you are a site administrator, select the site column configuration
name. If you are a group administrator, select the group column
configuration name. If you are not an administrator, select the user
column configuration name.
Freeze columns
You can freeze selected columns on the left of the pane, so they are always visible
when you scroll horizontally, for example, making the item name and number visible
while you browse other properties.
1. Set the BOM_Frozen_Column_Count preference to a positive integer–n
corresponding to the number of columns you want to freeze.
View properties
• To view the properties of a selected line in the product structure, click Properties
on the toolbar or choose View→Properties.
Teamcenter displays the Properties dialog box containing the properties of the
selected line.
Note If you select a single structure line, Teamcenter displays the Properties
dialog box containing the properties of the selected line.
In the example, the Absolute Transformation, Item Description, and Item Type
properties are common and can be modified. The other properties are unique to
each line and cannot be modified here; however, you can modify them in place,
as described in Editing a single property in place.
It is not necessary to check out the source object if you want to modify properties.
2. Click the BOM Lines tab in the dialog box. This tab shows the common
modifiable properties of the items corresponding to the selected lines. Select the
property you want to change and enter its new value in the text box.
In the example, the Item Description property is selected and is modified to
the value of Test.
When the correct replacement value is shown in the text box, click the
button to complete the change. Alternatively, you can click the button to
clear (delete) the current value.
Click the button to display the Find/Replace dialog box that allows you to
search for any property value.
3. Click the Item Revisions tab in the dialog box. This tab shows the common
modifiable properties of the item revisions corresponding to the selected lines.
Repeat the process given in the previous step to update the values of common
modifiable properties of item revisions.
4. Click OK or Apply to update the properties of the selected items and item
revisions.
Note The pending edit markup option highlights some occurrence property edits,
including edits to the occurrence name, find number, reference designator,
quantity, unit of measure, notes, variant conditions, and occurrence type.
However, absolute occurrence (in-context) edits are not highlighted.
For more information, see Highlighting edits to the structure.
Note If you select multiple lines, Teamcenter displays the common properties of
the selected objects. If you edit any of the common properties and then click
OK or Apply, Teamcenter saves the property changes to the database but
does not update the dialog box. To display the property changes, choose
View®Refresh window.
Tip If you want to modify a common property for several but not all lines, copy the
required value, right-click each line in turn, and then choose Paste Property.
If you have a large number of property columns to modify, it may be easier to
export the structure lines to Microsoft live Excel, make the necessary edits,
and then import the modified data back to Structure Manager.
For more information about editing structure data with live Excel, see the
Extensions for Microsoft Office Guide.
Tip If you want to modify a common property for several, but not all lines, copy
the required value, right-click each line in turn, and then choose Paste
Property.
they are not reordered until you collapse and expand the particular structure or
open it in a new window.
If you change the find number of packed lines, this action changes the find number
of all the packed lines.
Edit quantities
If you edit a quantity, Teamcenter enforces the following restrictions:
• If the quantity is a property of an item that has no unit of measure defined or
has a unit of measure of Each, the value must be a whole number.
• If the quantity is a property of an item that has a unit of measure defined, you
can enter a whole number. You can also enter an A/R string (case insensitive) to
indicate as-required; you can abbreviate this entry to a.
• By default, you can specify quantities to two decimal places. However, your
administrator can edit the Displayed_Decimals_for_Qty preference to change
this restriction.
• BOMLineRevConfiguredProperties
Adds the properties from the revision form type to the BOM line. This
configuration point was provided by the PSE_add_props_of_rev_form_types
preference in previous versions.
For more information about setting global constants, see the Business Modeler IDE
Guide.
If either constant is set, all the form properties from the form type are added to the
BOM line. By default, the foundation template sets the values of the constants to
the item master and item revision master, respectively.
You can then add the attribute to display as a column, as described in Displaying
properties. The attribute name is shown in fully qualified format, for example,
if your item master attribute name is A_SPLM, the column name is shown as
bl_Item_Master_A_SPLM.
You can optionally change the displayed column name by
editing the system_property_names_locale.xml file in the
$TC_ROOT\lang\textserver\en directory. Add an entry for the display name in
the following format:
<key id=”bl_Item Master_A_SPLM”>A_SPLM_description</key>
Tip Use the Input Accuracy column to determine if the properties of the line
being rolled up are used as-is or calculated from the rolled-up values of its
children (asserted). This column supports NX, but you can use it with any
other system that permits you to choose between asserted values at an
assembly level or values derived from the values of its children. NX allows
you to assert static mass property values on its parts.
If you do this, the accuracy property on the UGPartMassPropsForm
form that is attached to the UGMASTER dataset in Teamcenter is set
to -1.0. The value of the accuracy property determines whether the
rollup process calculates the values of specific assembly levels. To do this,
create a compound property that represents the accuracy property on the
UGPartMassPropsForm form and then apply that compound property to
the Input Accuracy column.
The Input Accuracy column is available on the Summation, Center of Mass,
and Inertia calculation tabs of the Roll up Report Templates dialog box.
• Group templates
You can create, edit, or delete group templates if you are a member of the group.
• User templates
You can create, edit, or delete your own user templates.
Note A member of the DBA group can create, edit, or delete group or user
templates if bypass is turned on
2. Optionally, select an existing template in the Templates list to use as the basis
of the new template. You can only select from templates that your group has
permission to modify.
3. Enter the template name or change the name of the preloaded template. The
template name must be unique within the group.
4. Enter a template description, which Teamcenter uses as the name of the rollup
dataset, for example, <Item_ID> <Rev_ID> <RT_name> <RT_date> <RT_Mass
Total>.
5. Check one of the Scope options to indicate users who have access to the
template—Site, Group, or User.
6. Enter the delimiter to use between data fields if this report is exported to a
text file. The default character is a tab.
Note To export rollup reports and open them in Microsoft Excel, change the
default delimiter character to a comma (,). If you leave the default
delimiter as a tab, the data columns do not display correctly in Excel.
8. Add or delete any other properties to include in the rollup report in the
Reference box. Referenced properties are not included in rollup calculations.
3. Enter the name of the generated report in the Name box. By default, the name is
generated from that of the root item revision.
4. Optionally, edit the description of the report in the Description box. The
description is generated from the report template and typically is not changed.
5. Enter the delimiter to use if this report is exported to a text file. The default
character is a tab character.
Note If you intend to open the report in Microsoft Excel, change the default
delimiter character to a comma (,). If you leave the default delimiter as a
tab, the data columns do not display correctly in Excel.
6. Choose the name of the report template to use from the Template list.
7. Optionally, select the name of the destination directory for the report in the
Output Folder box. By default, this is blank.
o Details
Shows the detailed content of the selected report.
To create a new report based on the information in the current report, click
Create.
Note The new Variant Formula property is available only if you enable the new
data model.
You can edit the new Variant Formula BOM line property in the usual way, by
double-clicking the cell to display the Edit Variant Condition dialog window.
When you do this, Teamcenter converts the variant expression into the old data
model; however, the performance impact is more limited as only data for the selected
BOM line is converted.
The differences between the old and new BOM line properties are shown in the
following table.
If a component only has one note, the All Notes column shows the text of the note,
preceded by the name of the note type and a colon. If the component has several
notes, the column shows a comma-separated list of the note types.
You can edit an occurrence note in the same way as any other property, except for
the All Notes property.
3. In the Notes editor, choose the Existing Notes List of Values option and select
an existing note to view or edit. Alternatively, choose the Create List of Values
option to add a new note type.
If the note has a list of values (LOV), select the appropriate value from the list.
A default value may initially be selected in the LOV. The default value is not
set on the note until you actually create the note.
To change the default value of a note:
c. In the Notes dialog box, set a value manually or choose from the LOV.
Remove a note
• Click Remove if you want to delete the currently displayed note.
Copy a note
1. Select the line with the note text you want to copy. You can select any point on
the line, not necessarily the note type cell itself.
2. Right-click the selected line over the cell containing the note you want to copy.
Teamcenter displays the structure line shortcut menu.
3. From the shortcut menu, choose Copy to copy the contents of the occurrence to
the clipboard. You can also use the Ctrl+C shortcut keys.
4. Right-click the cell of the note type of the target line where you want to copy
the occurrence.
Teamcenter displays the structure line shortcut menu.
5. From the shortcut menu, choose Paste Property to complete copying the
occurrence.
Note There is no shortcut for the paste action; you cannot use Ctrl+V.
Lifecycle Visualization is integrated with the rich client and enables you to view 2D
formats, such as GIF, JPEG, CGM, and PNG files, as well as 3D formats, such as
JT files.
JT file translators are required to generate 3D-format JT files. For example, the
ugtopv translators shipped with the NX software translate UGMASTER datasets
and create JT files in the database.
You can view the following 3D format or 2D format files:
• DirectModel
Imported JT files or JT files created by the translators
• DirectModelMotion
Imported VisMovieCapture files.
• DirectModelMarkup
Captured image of a DirectModel dataset
• Image
Imported files in formats such as TIFF, GIF, and JPEG.
For more information about using stand-alone Lifecycle Visualization, see the
Lifecycle Visualization online help.
• 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
Capture your actions in the 3D viewing window as movie files.
• 3D Navigation
Pan, rotate, and zoom 3D models.
• 3D PMI
View and manipulate PMI in your model.
Note PMI functionality is available only when PMI is enabled on your system.
If PMI is enabled, you can right-click a part and choose one of the
following commands:
o Show PMI
Shows all effective PMI on the selected part or subassembly and
its children.
• 3D Section
• 3D Selection
Select parts and pick part entities.
• 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.
• Select the check boxes only on those lines for which you want to load the
graphics, that is, view a selected part of the structure.
• Select the check box on the line for a piece part to view only the part.
• Select the check box on a line representing an assembly to load the graphics
and view the assembly.
• Clear the check boxes to blank the graphics to hide the entire structure.
Note If you applied a variant rule to the structure and unconfigured components
are hidden, the graphics for the unconfigured lines are not loaded when you
select the check box for the top-level item or an assembly.
When you edit the structure in the tree (for example, adding, removing, or
substituting a part or assembly), the view is updated to reflect the changes. When
you remove, replace, or substitute a part or assembly, Teamcenter unloads the
selected item from the viewer if it is loaded. When you add a part or assembly to the
structure, Teamcenter does not automatically display the selected item in the viewer,
but adds to the structure tree, allowing you to load it manually.
If a part occurrence has more than one design representation associated with it, the
primary published design is shown in the viewer.
• To refresh the geometry associated with the entire structure tree, choose
View→Refresh Window.
If the current view is exploded, Teamcenter displays a confirmation dialog box,
allowing you to save changes. Otherwise, it updates the scene to reflect changed
parts, properties and referenced objects.
Symbol Indicates
The part or assembly is fully loaded and visible.
The part or assembly is loaded but not visible.
The part or assembly is not loaded.
Some parts are loaded and visible (assembly
only).
The assembly is loaded and some parts are
visible (assembly only).
No geometry is associated with the part.
New. This symbol may appear when you compare
the current assembly with an assembly that you
saved in a session file.
Symbol Indicates
Deleted. This symbol may appear when you
compare the current assembly with an assembly
that you saved in a session file.
Select the check boxes next to the components in the tree that you want to display. If
you select the root item, the entire structure is displayed, for example:
When you open 3D model files, two types of information are available: a textual
representation of the model assembly and a visual representation of the geometry.
The assembly structure appears in the tree and the geometry appears in the viewer.
When you open a DirectModel (JT) assembly file that consists of more than one
part, the model assembly is loaded, but the geometry is not automatically displayed
in the viewer. This is because assemblies often consist of hundreds or even thousands
of parts, and it often takes a long time to load the geometry of such complex models.
Because only the assembly is initially displayed, you can turn on only the parts you
want to view, and preserve system resources. When you open a model that contains
a single part, the part is loaded and displayed immediately.
2. In the Image Capture dialog box, select the type of 2D image file you want to
generate and click Apply or OK. Teamcenter calculates the 2D outline image and
an outline progress meter displays the current status during this process.
To create a hidden line image, select the Outline type from the File Type list,
enter a name for the dataset under which the outline image is stored, and
optionally enter an description of the dataset.
2. In the Image Capture dialog box, click the HLR Prefs button and Teamcenter
displays Outline Capture Preferences dialog box. This button is disabled unless
the file type is set to Outline.
3. In the Outline Capture Preferences dialog box, set the commands as listed in
the following table.
Manipulate graphics
Lifecycle Visualization provides a set of graphical manipulation tools that allow
you to repositioning parts or assemblies in the structure, including translation,
rotation and scaling.
You can perform two types of repositioning:
The differences between creating an exploded view and editing the structure are
listed in the following table.
To save a session file, choose File→Save Session. Teamcenter displays the Save
Session dialog box. You can specify the name and location of the new session file.
Session files are stored in the file system with an extension of .pses.
Note By default, you cannot save a session file. To enable saving of sessions, set
the enableSessionFile entry in your customer.properties file to true. If
this file does not already exist, you should create it.
To open a saved session file, choose File→Open Session. Teamcenter displays the
Open Session dialog box and an MRU (most recently used) list. Enter the name
of the session file to open and Teamcenter displays the structure in a new viewer
window that is configured in the same way as when the session file was originally
saved.
• Structure contexts
• Configuration contexts
Each product view is stored in a dataset containing a thumbnail image file, a PLM
XML session file, 3D markup layers, and the top-level item of the view.
You can configure the structure with revision rules, effectivity, variant rules, and
similar techniques. If appropriate, you can use several Show Unconfigured menu
commands to hide unconfigured objects in the structure and in the viewer. When
product views are captured, these view selections are taken into account; otherwise,
potentially unbuildable combinations of parts may be displayed when the view is
restored. You can retrieve the original state of the menu commands and consequently
the original state of the view.
For more information about working with unconfigured objects in product views, see
Manage unconfigured data in a product view.
If the product view is attached to a structure and the structure is cloned, the product
view functions correctly in the new (clone) structure. Likewise, product views may
be attached to a structure that is shared with Multi-Site Collaboration.
You can also update product views in the Lifecycle Viewer or stand-alone Lifecycle
Visualization. You send a dynamic product view to one of these applications, and then
create a new product view or update and replace the existing one. When you send the
updated product view back to Teamcenter, you can open it in the assembly viewer.
Your Teamcenter administrator sets the size and presentation of the product
views with system properties and preferences, as described in the Preferences and
Environment Variables Reference.
Note In Teamcenter 8.0, the file format of 3D product views changed. If you open
a file that was created in an earlier Teamcenter version, it is automatically
converted to the new format.
3. If necessary, right-click in the viewer menu bar and choose Create Markup.
Teamcenter displays the Create Markup toolbar.
4. Click the Create 3D Product Views button on the Create Markup toolbar in
the assembly viewer.
Teamcenter displays the Product View Gallery dialog box, which contains
thumbnails of any previously saved product views that are associated with the
selected object.
You are prompted to enter a name for the product view if the
Vis_PV_Show_Name_Dialog preference is set to True. If it set to False,
Teamcenter generates a name automatically.
Teamcenter saves the product view and its configuration in a dataset. It also
adds a thumbnail of the view to the Product Views dialog box.
Note Thumbnails of all product views are not visible at all times, only for
those items related to the selected end item (the top entry in the
structure window).
Preference Description
Geometry Asset Determines whether a geometry asset file is
added when a product view is created. This
file is required if you want to export a PLM
XML file of the product view. This option is
equivalent to the Vis_PV_Geometry_Asset
preference.
Show Product View name If selected, you are prompted for a name
dialog each time you create a product view. If not
selected, Teamcenter generates the name
automatically. This option is equivalent to the
Vis_PV_Show_Name_Dialog preference.
View Toggle Warning Level If selected, Teamcenter displays a warning
or prevents you from continuing if you try to
create a product view when one or more of the
View menu commands to show unconfigured
data is selected. This option is equivalent
to the Vis_PV_InvalidConfigWarnLevel
preference.
Preference Description
View Toggles to consider Select the View menu commands to show
unconfigured data that are considered if
the View Toggle Warning Level option is
selected. This option is equivalent to the
VisPVBlockingViewToggles preference.
Image Capture Determines if Teamcenter saves a preview
image of the 3D product view when it
is created. If you choose Perform Image
Capture (Using Image Export Dialog), you are
prompted for the settings to use. If you choose,
Perform Image Capture (with preferences),
it uses values set in preferences. This option
is equivalent to the Vis_PV_ImageCapture
preference.
Image Format Depending on the setting of the Image Capture
option, these options may determine the file
Image Resolution format, resolution, and size of the preview
Width of image image. If Perform Image Capture (Using
Image Export Dialog) is set, these options
Height of image are disabled. These options are equivalent
to the Vis_PV_ImageCaptureType,
Vis_PV_ImageCaptureResolution,
Vis_PV_ImageCaptureWidth, and
Vis_PV_ImageCaptureHeight preferences,
respectively.
Thumbnail: Determine the size and resolution of
the thumbnail image created for each
Width product view. These options are equivalent
Height to the Vis_PV_ThumbnailWidth,
Vis_PV_ThumbnailHeight, and
Quality Vis_PV_ThumbnailQuality preferences,
respectively.
Play motion in current view If selected, any motion (VFM) file in the
current product view plays when the view
is selected. This option is equivalent to the
Vis_PV_Play_Motion preference.
Configuration rule to use Offers you two choices:
• Use configuration from the current BOM
ignores stored rules and preserves the
configuration that was active before you
applied the product view.
Preference Description
Command Description
New Tab Creates a new tab for the element currently
selected in the structure. This tab is
unavailable if no element is selected in the
structure base view window.
Refresh Tab Refreshes the currently selected tab in the
product view gallery to reflect structure
configuration changes.
Remove Tab Removes the current tab from the dialog box.
Refresh All Tabs Refreshes all the tabs in the product view
gallery to reflect structure configuration
changes.
Remove All Tabs Removes all tabs from the dialog box.
Add Creates a new product view from the current
contents of the viewer.
Apply Applies the configuration of the selected
product view to the viewer.
Delete Deletes the selected product view.
Command Description
Rename Displays a dialog box that allows you to change
the name and description of the selected
product view. A product view name appears
below each button; the description appears
when the cursor is placed over the button.
If you rename a product view, the order in
which thumbnails are displayed in the Product
View Gallery dialog box changes. Teamcenter
generates the default name of a view from the
date and time it was initially created. It lists
available views in alphanumeric order. You
can choose an appropriate new name to move
the view up or down the list.
Enable Multiple Selection Allows you to select more than one product
view.
Options Displays the Product View Creation
Preferences pane.
Note If you right-click any part of the Product View Gallery dialog box (except
one of the buttons) and no product view is selected, the menu commands
to apply, update, rename, and delete the product view are unavailable.
• Vis_PV_ImageCaptureHeight
Defines the height, in pixels, of the preview image created when you
save a product view. Teamcenter only uses this preference if the
Vis_PV_ImageCapture preference is set to CaptureUsingPrefs. The valid
values are positive integers from 1 to 1040, with a default value of 400.
• Vis_PV_ImageCaptureType
Defines the format of the preview image created when you save a product view.
Teamcenter only uses this preference if the Vis_PV_ImageCapture preference
is set to CaptureUsingPrefs. Valid values are BMP 24bit, BMP 8bit, BMP
BW, JPEG 24bit (default), PNG 24bit, PNG 8bit, PNG BW, TIFF 24bit,
TIFF 8bit, and TIFF BW.
• Vis_PV_ImageCaptureResolution
Defines the resolution of the preview image created when you save a product
view. Teamcenter only uses this preference if the Vis_PV_ImageCapture
preference is set to CaptureUsingPrefs. The valid values are positive integers
from 1 (lowest resolution) to 1040 (highest resolution), with a default value of
250.
Note The width and height you specify must be the same as the source image,
or you can increase or decrease both values by the same proportion.
Teamcenter always preserves the aspect ratio of the graphics window to
prevent distortion. Consequently, the resulting image dimensions may not
exactly match the height and width values set in the properties file.
You can create high-quality images in any of the following file formats and
resolutions:
• BMP 24-bit, 8-bit, or black and white
• JPEG 24-bit
1. Right-click a product view or the Product View Gallery tab and select Image
Capture.
3. Change the size and file format of the image if necessary, then click OK.
Teamcenter creates the product view using the parameters you entered.
When product views are captured and restored, these view selections are preserved;
otherwise, potentially unbuildable combinations of parts may be displayed when the
view is restored. 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 the following preferences to determine how the system
creates a product view when unconfigured objects are shown:
• Vis_PV_InvalidConfigWarnLevel
If set to Warning, Teamcenter displays a warning message if any of the options
specified in the Vis_PV_BlockingViewToggles preference are on, but you can
still create or update a product view. If set to Prevent, Teamcenter prevents
you creating or updating a product view if any of the view configuration options
specified in the Vis_PV_BlockingViewToggles preference are on. If set to
Off, the state of the menu commands does not affect whether product views
are created or updated.
You can also set this preference with the Product View Creation
Preferences®View Toggle Warning Level option.
• Vis_PV_BlockingViewToggles
Specifies the view states that are evaluated when the
Vis_PV_InvalidConfigWarnLevel preference is set to show a warning or
prevent the creation of a product view.
You can also set this preference with the Product View Creation
Preferences®View Toggles to consider option.
3. Right-click below the image area in the Product View Gallery dialog box and
select the configuration that you want to use for the product view.
Command Description
Options→Configuration rule Applies the product structure configuration
to use→Use configuration that is currently set to the product view
from Current BOM that you are loading.
Options→Configuration rule Adopts the configuration that was set at
to use→Use configuration the time the product view being loaded was
from product view created.
o Select the thumbnail of the product view you want to open and click OK.
Teamcenter opens the product view as before and closes the dialog box
immediately.
• Right-click the product view gallery and choose Refresh All Tabs to update the
3D snapshots in all tabs to reflect any structure configuration changes.
• Right-click the product view and click the refresh product view button, which is
the center graphical button in the middle row of buttons.
Note You can also select multiple product views in the product view gallery and
send them to the Lifecycle Viewer or stand-alone Lifecycle Visualization.
The product views open one at a time and any configuration of the original
structure is retained.
2. Select the thumbnail of the product view you want to delete and click the delete
product view button, which is the right graphical button in the middle row of
buttons. Alternatively, you can right-click in the window and choose Delete.
Teamcenter deletes the product view and its associated dataset.
Manipulating subcomponents
An assembly imported into Teamcenter as a single part file without CAD models
may represent an assembly of individual solid objects. Teamcenter treats such an
assembly as a single line in the structure and, by default, you cannot expand it to
visualize the individual components. For example, if you import an assembly from a
non-NX CAD system, Teamcenter creates a single part file without the associated
CAD model within the structure.
Note In this instance, parts files are not necessarily devoid of CAD models and
structure. They may have NX or other CAD application models. However,
these files may have more than one solid or subcomponent within them. A
typical part file only has one subcomponent or solid in it.
To view the individual visualization components, you must specifically select the
affected and unpacked structure line and choose Show Subcomponents. You can
subsequently hide the subcomponents when you have viewed the assembly.
Teamcenter expands the part file to show the structure of the subcomponents.
You can display selected subcomponents in the viewer by selecting the
corresponding check boxes.
Teamcenter expands the node. If the node has a monolithic JT file, you can see
the structure of the subcomponents.
Check boxes appear in the tree for each node.
3. Select or clear the check boxes in the tree to show or hide the subcomponents
in the viewer.
You can control the solids independently, select them in the viewer or the
structure tree, and use transformation tools to reposition them.
After breaking down the solids, you cannot reload the monolithic JT file for
the line node.
Merge subcomponents
After manipulating the individual subcomponents, you can merge them back into
the subassembly.
1. In the structure, select the leaf node or assembly node part file.
You can select multiple nodes.
Teamcenter unifies the subcomponents within the parent part and removes the
tree from the structure. The subassembly behaves like a single part in the viewer.
Perform a where-used search with the print wizard and obtain a printable
result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ........ . . 8-5
Open HTML files in a Web browser . . . . . . . . . . . . . . . . . . . ........ . . 8-6
Print a text or HTML file . . . . . . . . . . . . . . . . . . . . . . . . . . ........ . . 8-6
Save output to an HTML or text file . . . . . . . . . . . . . . . . . . ........ . . 8-7
There are two methods of performing where-used searches. The first method
produces a graphical representation of the assembly or assemblies in which the item
or item revision is used. The second method uses the Referencers print wizard and
produces a report of the where-used results.
The results of where-used searches can be viewed in the Referencers pane. If the
ReferencersPane_Shown preference is set to off, this pane is hidden.
By default, the search results include all parent item revision objects, regardless of
whether they are themselves configured by the revision rule. With this setting, you
can (for example) make a where-used query on Part1–A to identify every occurrence
where Part1 is used with A as its configured revision. You obtain the same results
whether you query one level at a time or all levels simultaneously, including with
mixed precise and imprecise structures.
With precise or mixed structures that have a large number of item revisions, the
standard mode may return many results that can be difficult to interpret. In this
case, you can configure the results to omit parent item revision objects that are
not themselves configured by the revision rule. That is, this mode reports all
intermediate items or item revisions that configure the target.
Note This alternative mode is an enhancement of the behavior in Teamcenter
Engineering 9.1 and earlier releases. It is no longer necessary to expand all
levels to obtain a valid result.
3. Select an item or item revision in the tree or properties table, and drag or copy
and paste it to the Referencers pane.
• Select a rule from the Where-Used Rule list. This rule provides parameters
to locate the assemblies in which the item or item revision is used. For
example, if you select the Any Status; Working rule, only the latest
released revision of the assembly is retrieved if one exists; if not, the latest
working revision is retrieved.
If you modify the current revision rule in Structure Manager, you can also
select the modified rule as the basis of the search. To do this, select From
Structure Manager from the Where-Used Rule list.
Note In the Referencers pane in Structure Manager, the rule defaults to
the current revision rule in the Structure Manager window.
• Choose one of the following options in the Depth list located in the
bottom-right corner of the pane:
o One Level to report immediate parent assemblies only
5. Double-click the item or item revision in the Referencers pane to start the
search.
If the item or item revision is not part of an assembly that matches the selected
revision rule, Teamcenter displays a message to that effect. If the item or item
revision is part of a configured assembly, the structure is displayed in graphical
format in the Referencers pane. The results can be used as a basis for another
where-used or where-referenced search or they can be formatted and printed.
You can change the item revision properties that are shown in the results by
selecting the required properties from the Display list. Teamcenter remembers
your selection for future sessions.
You can also filter the results to show only selected item types. To do this, select
the Filter by Item Type check box and select the required item type and filter
level from the lists. You can also select the Include Subtypes check box to
include both item revisions whose item is of the specified type and any subtype of
that type. You can further refine the selection by showing the results only for the
top level of the structure or for all levels below the selected top level. To rerun
the where-used search with changed criteria, double-click the target node.
3. Select an item or item revision in the tree or properties table, and drag or copy
and paste it to the Referencers pane.
6. (Wizard step 2) Select one of the following Depth options and click Next:
• One Level to report immediate parent assemblies only
7. (Wizard step 3) Select a Where-Used Rule revision rule and click Next. This rule
provides parameters to locate the assemblies in which the item or item revision
is used. For example, if you select the Latest Working rule, only the latest
working revision of the assembly is retrieved. Released assemblies and earlier
versions of the assembly is not retrieved when this rule is selected.
If you modify the current revision rule in Structure Manager, you can also select
the modified rule as the basis of the search. To do this, select From Structure
Manager from the Where-Used Rule list.
8. (Wizard step 4) Select the item or item revision properties to include in the
report and click Next.
Note The preselected properties are those used when you last ran the wizard.
You can change them as necessary.
9. (Wizard step 5) Select an item type to filter the search results by and click Next.
You can also select the required filter level, either Top Level Only or All Levels.
Teamcenter displays the item or item revision and selected revision rule that
will be the basis of the search, together with report generation options.
10. Confirm that the required items, item revisions and revision rule are shown
correctly, then choose one of the following report generation options:
• Generate the HTML/Text report
Presents the where-used results in HTML format in the Print dialog box.
From this dialog box, you can format the report and either print it or save it
to a file.
• Optionally, change the print format to Text or HTML Table. HTML is the
default print format; HTML table format allows easier interpretation of
large lists of property values.
d. Close the Print Format dialog box. Teamcenter activates the Print dialog
box.
3. Return to the Teamcenter window and click the Close button to dismiss the
dialog box.
1. Click the Print button located in the lower-right corner of the Print dialog box.
Teamcenter displays the system Print dialog box.
2. Define the printer to which the file will be sent. You can accept the default printer
that is displayed in the Name box or select a different printer from the list.
1. Click the Save button located in the lower-right corner of the Print dialog
box and the Save dialog box appears.
Teamcenter displays the system Save dialog box.
2. Navigate to the directory location where you want to save the file.
3. Enter the name of the file, including the .htm, .html, or .txt extension, in the
File name box.
4. Click Save to save the file and dismiss the dialog box.
If the results contain packed lines, the relevant lines are unpacked and displayed.
The remaining lines remain packed and are shown as a pack master with a corrected
total of lines or with pruned siblings.
You can refine spatial searches with other attributes as follows:
• Scope
You can select an assembly as the scope of the search, rather than searching
the entire product.
• Classification data
If the items are classified, you can refine the search with classification attributes.
This is called a classification ad hoc search. You can search through classified
data and find objects contained within a class you specify and containing
attribute values that you specify.
• Occurrence notes
You can refine the search with values for occurrence attributes (occurrence
notes).
• Attributes of forms
You can refine the search with the attributes of forms that are attached to an
item, item revision, or their subclasses.
You can save search criteria for future use, if you perform the same search frequently.
You can also create and save searches using the Query Builder application.
• If you have not already done so, install Dispatcher translation services with
Teamcenter Environment Manager (TEM), including the Spatial Search Indexer
and Spatial Search Translator features. If you are creating JT files on the same
system as Teamcenter is installed on, ensure you install these services before
creating JT files to search.
• If you search against TruShape files that Teamcenter creates from CAD data,
you must also set the QS_TRUSHAPE_GENERATION_ENABLED preference
to True. This enables the generation of the TruShape data required for spatial
searches; the generation process may take an appreciable time when first
enabled. Set this preference to False if you use the Teamcenter Integration for
NX, as TruShape files are automatically saved in the NX datasets. (NX must
also be configured to save TruShape data.)
• If you search against existing JT files, you must also set the
QS_BBOX_GENERATION_ENABLED preference to True. This enables the
generation of the bounding box data required for spatial searches; the generation
process may take an appreciable time when first enabled. Set this preference
to False if you use the Teamcenter Integration for NX, as bounding boxes are
automatically generated. However, set this preference to True if you use non-NX
CAD integrations or several CAD tools.
• If you want to perform spatial searches from target part selections, set the
RDV_set_default_use_selections_from_tree to true to use selections from
the tree or false to use selections from the table.
For more information, see Use target parts.
Perform a search
1. Open the product structure and select the top line against which you want to
search.
3. If appropriate, click the Clear All button to reset any previously specified
criteria.
4. Use the Search pane to specify one or more of the following search criteria:
• Scope
You can search an assembly, rather than the entire product, to obtain results
more quickly. To set an assembly as the scope of the search, click the ...
button next to the Search Scope box and browse to the desired assembly.
Teamcenter displays the name of the selected assembly in the Search Scope
box.
• Item identifier
Tip You can search for items whose identifiers, names, attributes or
types match a specific pattern. For example, you can type 57h* into
the Item ID box to find all items whose ID start with 57h. Select the
appropriate arithmetic function in the leftmost box to obtain the
desired results, for example, = to obtain an exact match.
• Occurrence notes
For more information about specifying occurrence note search values, see
Enter occurrence note search criteria.
• Form attributes
For more information about specifying form attribute values, see Filter
search with form attributes.
To specify search criteria, click the ... button to the right of each box and enter
information in the resulting dialog box. All the criteria you enter are combined
so that you can, for example, search for all bolts whose name starts with bo and
are within 3 centimeters of another part.
For more information about entering specific search criteria, see Enter search
criteria.
You can hide the Search pane when it is no longer needed by clicking the Search
button in the toolbar again.
• Search scope
• Occurrence notes
• Target parts
5. In the Property Name column, click the cell containing the name of the class.
Teamcenter displays a list of all the attributes within the class.
6. Select the class and attribute with which you want to search.
8. In the Searching Value column, select the cell and type a value for the attribute
for which you want to search.
If you select a single Classification class, you can further refine the search criteria
to include specific attribute values. For example, if you select the Bolt class, you
can then:
1. Click the Bolt line in the Family Attributes dialog box to define classification
attribute criteria.
2. Click Add to specify additional attribute criteria. For example, you can set two
classification attribute criteria—thread=.25 and Lock_Wire=1.
If your site has not configured Classification, you cannot search by classification
attributes criteria.
2. (Optional) Select the Use selections from table check box above the Target Parts
table if you want to search against specified target parts.
For more information about searching against target parts, see Use target parts.
3. Use the Proximity and 3D box radio buttons in the Spatial Criteria dialog box to
select a search type, and then click OK to save the selections.
• Proximity
Limits the search to parts within a specified proximity distance, for example,
all parts within 10 centimeters of part X.
For more information about specifying proximity search criteria, see Define a
proximity filter.
• 3D box
Allows you to define a three dimensional box in the embedded viewer and
search for parts completely inside, completely outside or intersecting the
box. Use the Spatial Criteria dialog box to define the coordinates and size of
the box.
For more information about specifying 3D box search criteria, see Define a
spatial filter with a 3D box.
Note If you are making appearance searches, you can only search inside
and intersecting the box when TruShape filtering is selected.
Note You can use altreps (alternative representations) to define different physical
configurations or shapes of a flexible part such as a tube or hose. Spatial
searching takes into account an alternate geometric shape of a flexible
part by searching the dataset that corresponds to the altrep defined on the
occurrence object.
2. (Optional) Select Valid overlays only and Teamcenter loads otherwise physically
mutually exclusive parts, filtering out those known to never coexist in any
possible variant combination with any one of the target parts. It determines the
minimum number of variant rules that cover all product variants in which the
target components can exist. This selection requires that classic variants are
configured at your site.
3. (Optional) Select True Shape filtering if you want to test items with intersecting
bounding boxes to identify if they have TruShape volumes that intersect
the TruShape volumes of the selected objects. Depending on the TruShape
parameters configured, Teamcenter displays the geometry of each object as
regular cubes (voxels) to provide a simplified representation of the actual shape.
TruShape searches return more accurate results but may take longer to complete.
4. Define a proximity value in the Distance box in the Spatial Criteria dialog box
and click OK.
Teamcenter limits the search to those parts within the defined proximity of the parts
selected in the viewer or structure tree. A part is considered within the proximity
if any portion of it is within the specified distance; the part may not be completely
within the specified distance.
2. (Optional) Select True Shape Filtering if you want to test items with intersecting
bounding boxes to identify if they have TruShape volumes that intersect
the TruShape volumes of the selected objects. Depending on the TruShape
parameters configured, Teamcenter displays the geometry of each object as
regular cubes (voxels) to provide a simplified representation of the actual shape.
TruShape searches return more accurate results but may take longer to complete.
3. Make the following selections to define the location and size of the 3D box:
• Slider increment
Specifies the actual distance equivalent to one increment of the Maximum
and Minimum sliders and spinners.
• Extents
Determines how Teamcenter constructs the bounding box from the values
you specify, as follows:
• Find Parts
Allows you to specify if parts returned by the search are fully contained
inside or fully outside the bounding box.
• Enable 3D manipulators
If checked, drag handles are displayed on the bounding box, allowing you
to move and resize it manually. You can then drag the 3D manipulator to
resize or reposition the bounding box.
4. (Optional) Do any of the following to move and resize the bounding box with
the manipulators:
To Do this
Move the manipulator parallel to a
Drag the face of the manipulator.
face.
Move the manipulator perpendicular
Press Ctrl as you drag the face.
to a face.
Constrain the move to one axis. Press Shift as you drag a face.
Resize the manipulator uniformly. Drag a corner of the manipulator.
Press Ctrl as you drag a corner of the
Resize the manipulator along one axis.
manipulator.
5. (Optional) Click Build from selections to construct a bounding box containing all
target parts specified in the Target Parts table, or selected in the tree or viewer.
Note You can visualize mixed unit assemblies in the Spatial Search dialog box,
that is, assemblies composed of parts defined in both Imperial (English) and
metric units. The dialog box uses the appropriate units when you type in
dimensional values, for example, spatial distance in the Spatial Criteria
dialog box.
Note The target parts table is not available if you are making appearance-based
searches.
1. By default, the target parts table is hidden. If necessary, show the target parts
table by setting the RDV_show_targets_on_spatial_dialog preference to true.
3. Select target parts in the structure tree or viewer, and then click the + button to
add them to the Target Parts table.
To remove a target part, select it in the table and click the – button.
To clear the table of all entries, click .
4. Once all the required target parts are listed to the table, click OK. Alternatively,
if you are defined a 3D box search, click Build from selections.
Teamcenter draws a bounding box enclosing all the target parts in the viewer.
6. (Optional) Select the Show targets table check box to display a list of the target
parts of the search.
7. (Optional) Select one or more BOM lines in the list of target parts or select
Select all targets, and then do one of the following:
• Click Display to show the target parts in the tree and viewer in the same
window.
• Click Display in New Window to open a new window to show the target
parts in the tree and viewer.
2. Enter the form attributes for the search, including any mathematical operators.
Teamcenter displays the form type and search values as a string in the format
similar to the following example:
“ItemRev:BVRSyncInfo:last_struct_mod=value1 AND ItemRev:BVRSyncInfo:last_Sync_date=value2”
• Customize the columns that are displayed by right-clicking in the column header
and Teamcenter displays the Insert Columns dialog box. You can click the +
button to add a column (for example, In Validity) to the search results or click the
– button to remove unwanted columns.
• Save the list to a file or print it by right clicking in the column header. When
saving the results list to a file, you can specify whether to use HTML or text
format. The text file contains comma-separated values (CSVs), and you can
import data in this format into Microsoft Excel or similar applications.
• Click Display or Display in New Window to open the currently selected lines in a
separate Structure Manager window for examination.
• Click Copy to copy the currently selected lines for subsequent pasting into
another Structure Manager window.
lines, Teamcenter lists only the first five and you can click the Display button in the
Search Results pane to add the next group of five to the list.
The information label in the title bar of the Search Results pane identifies the end
item, view, or effective revision rule in effect.
You can view the search results in a new window, if required, by clicking the Display
in New Window button. You can then perform another search in that window to
refine the results.
Your first search results are listed in a tab named Result 1 by default. Any
subsequent search results are added to the current tab. This allows you to merge
the results of separate searches. For example, if you want to find all brackets that
are on the interior of the product or within 2 cm of part X, you could perform two
searches and merge them.
Alternatively, you can lock the results tab causing the next search results to create a
new tab—Result 2.
To lock a results tab, right-click the tab and choose Lock/Unlock from the shortcut
menu. You can lock any number of tabs.
If the configuration of the end item changed since the last search, Teamcenter
automatically adds a new tab rather than merging the next set of search results into
the current tab. For example, if you changed the revision rule since the previous
search, the next search results create a new tab. This ensures that all lines in a
given tab correspond to the same configuration of the end item.
• Copy
Copies to the clipboard all lines that are selected in the search results list.
You can also select the Select All check box to select all lines in the search results list.
You can right-click one of the lines in the search results list and Teamcenter displays
a shortcut menu. You can choose any of the following commands:
• Display
Displays the line.
• Copy
Copies the line to the clipboard.
• Send To
Sends the line to another application.
• Properties
Lists properties of the selected line.
• The remaining lines are displayed in the tree and pruned as described previously.
This assumes that the revision rules associated with the search results match the
revision rules in effect in the structure. If not, Teamcenter evaluates each line in the
search result to see if it is valid in the context of the currently configured end item.
If it is valid, the line is displayed as before. Otherwise, it is displayed in a separate
section of the tree called Unconfigured Objects.
If you do not have read access to an item that satisfies the search criteria, the
corresponding line is not listed in the search results table. If this occurs, the count
of lines in the search results is reduced to exclude any lines to which you do not
have read access.
You may only be interested in the immediate components that have changed in a
single-level assembly. Conversely, you may want to identify the differences between
all the piece parts in the complete product structures (for example, between related
multiple views or different variants of the product).
Teamcenter allows you to compare structures in two ways.
• You can compare two product structures (BOMs) in separate Structure Manager
windows.
The differences are highlighted in the product structure trees.
You can optionally compare product structures that are controlled by change
management, as described in Select comparison information.
• Connections
• Signals
• Reference designators
• Find numbers
• Lowest level mode compares only the lowest level items of the product structures,
ignoring all intermediate assemblies.
• Every level mode compares each line of every level of the product structure.
• Quantity changes
• Revision changes
If included in the comparison, find number changes result in a new item and the
comparison reports such changes as additions.
If included in the comparison, reference designator changes result in a new item and
the comparison reports such changes as additions.
If included in the comparison, substitute part changes result in a new item and the
comparison reports such changes as additions.
• Quantity changes
• Revision changes
If included in the comparison, find number changes result in a new item and the
comparison reports such changes as additions.
If included in the comparison, reference designator changes result in a new item and
so the comparison reports such changes as additions.
Use this mode to find differences between two configurations of the same product,
for example, when variants are applied.
The extended multilevel comparison mode continues until it finds a difference in
item or find number. It reports differences in quantity or revision but continues
with the comparison.
• Quantity changes
• Revision changes
Use this mode to compare multiple views, such as a design view that may have a
different structure to a manufacturing view, while maintaining the same set of
piece parts.
For more information, see Multilevel mode comparisons.
• Source, target, and transmitter lists for signals and process variables
a. Select the BOM view revision and click the Open By Name button . You
can also double-click the BOM view revision or use your MRU list to open
the required structure.
Teamcenter opens the Open By Name dialog box.
b. In the ID box of the Open By Name dialog box, type the identifier of the item
you want to compare and click Find.
Alternatively, you can right-click an item, item revision, or BOM view revision,
and then choose Send To→Structure Manager to open it.
3. Select the second pane and repeat step 1 to open the second structure.
4. Select the correct top-level line in each structure to use for the comparison.
5. Configure the structures by setting the revision rule and variant rule in each
window.
6. Expand and collapse assemblies to define the scope of the comparison. You can
compare only the visible structures displayed in the windows.
2. In the dialog box, select the mode of operation for the comparison from the Mode
list. These modes are described in Choose a comparison mode.
3. Check the Report check box if you want to display the report pane summarizing
the differences between the structures. The report pane is described in Example
result of a structure comparison.
• As a report
Teamcenter displays an additional pane at the bottom of the window, listing the
differences. You can select a line in the report to highlight the corresponding
changed lines in the two Structure Manager panes. This helps you locate where
in the structures the changes took place.
The pane indicates the type of change: Added for additions, Qty for quantity
changes, and Rev for revision changes. A comma-separated list appears if more
than one change occurs on the same line.
o In single-level mode and lowest level mode, the reports are flat lists of
differences.
The following figure shows the result of a single-level comparison between two
revisions of the same structure.
Notice that a single item (000124/A) is added to the target view in the right-hand
pane and this addition is highlighted in a different color. The difference is also
listed in the report pane.
• Supersedures.
If you compare two assemblies under change management (where one assembly
is a problem item and the other is an affected item of an engineering change
object), Teamcenter displays a list of supersedures.
Note You must implement change management if you want to define and use
supersedures. For more information, see Comparing structures under
change management.
2. Choose Edit→Options.
Teamcenter displays the Options dialog box.
3. In the Options dialog box, expand the Change Management folder and click the
BOM Tracking entry.
Teamcenter displays the colors representing the different structure change types.
4. Double-click the type of comparison whose color you want to change and
Teamcenter displays the Color Chooser dialog box.
5. Choose a new color with the Swatches, HSB, or RGB color selector and click OK.
Teamcenter uses the new color to identify the selected type of comparison
everywhere structure changes are displayed in the rich client, including the
Structure Manager Supersedure pane. For information about how to change the
default colors and positions of the sliders, see Define structure change colors,
slider colors, and position.
Tools→Graphical BOM Compare or click the button (if you added this button
to the toolbar).
Teamcenter displays the Graphical BOM Compare dialog box, allowing you to
manipulate the results.
After running the comparison, Teamcenter highlights the following differences
between the two windows in the viewer:
• Adds
Objects that are in the target window but not the source.
• Cancels
Objects that are in the source window but not in the target.
• Moves
Objects that are in different positions in the source and target windows (the
transformation matrix has changed).
• Reshapes
Objects that have an alternative representation between the source and target
windows, as identified by an UGALTREP note.
You can use the comparison sliders in the Graphical BOM Compare dialog box to
dynamically view the changes. Parts that are added, canceled, moved, or reshaped
from one revision to another move across the window as the respective slider is slid
from one revision to another.
Also, the parts are color-coded, depending on whether they are added, canceled,
moved, or reshaped.
For information about changing the color associated with each type of change, see
Change comparison results colors.
After you create the graphical history, you can capture it to export or print.
When required, you can display the common parts to more easily see the changes
in context of the larger assembly. To show common parts when required, select the
Show Common Parts check box.
Note You can only use common parts if you compare two revisions of the same
assembly, not different assemblies. Do not use this option if one assembly is
a subassembly of the other assembly in the comparison.
2. In the dialog box, expand the Change Management folder and click Graphical
History.
Teamcenter displays the Graphical History Settings pane.
3. In the Graphical History Settings pane, select the Show Common Parts check
box.
Teamcenter now displays common parts during the initial loading of graphical
history. If required, you can hide common parts by clearing the box after the history
is loaded.
2. In the dialog box, select the desired revision rule from the list on the left-hand
side and click OK or Apply.
Teamcenter sets the selected revision rule for the structure pane. It recalculates
the graphical comparison result and resets all the sliders and buttons in the
control pane to their default positions.
If you want to change the revision rule for the both structure windows, repeat these
steps in the other window.
adds and cancels when you save the changes or later. Change management also
allows you to display the genealogy of a component in the assembly.
Supersedure relationships are always created manually in Change Manager. You
copy the old item revision to the Impacted Items folder and the new item revision to
the Solution Items folder to establish the relationship.
• Progression pane
The Progression pane displays all the revisions of the parent structure
in a vertical multibranched tree. The tree displays one of the two
following relationships between child and parent objects, depending on the
CM_progression_tree relation preference setting.
The Graphical Compare dialog box includes the following controls and boxes:
Component Description
Progression and Revision Choose the required mode of the revision list. By
buttons default, the revision list includes all revisions in
a color-coded format. If a revision has change
associated, it is displayed in pink; otherwise, it is
black.
If you click the Progression button, revisions are
displayed sequentially.
Compare With combination Selects the revision with which you want to compare
box the selected revision in the left side tree. By
default, the problem revision is selected if a change
object created the selected revision. Otherwise (for
users not using Change Management), the Based
On revision is automatically selected.
View Type combination box Chooses a particular BOM view type in case the
selected revision has multiple BOM view revisions
associated. Your default BOM view type is selected
automatically. If you are not using multiple BOM
view types, the correct type is automatically shown.
Set Revision Rule button Chooses the revision rule to configure the selected
change revision.
Change button Opens the associated change revision in Change
Manager.
Effectivity Data table Displays the effectivity data attached to the selected
revision. If no effectivity is attached, the table is
blank. If the revision is effective for multiple end
items, all end item effectivity entries are displayed.
If you want to compare the selected revision with a
Paste button
revision of another item, you can copy the revision
from another application and paste it into the
Compare With box.
Status pane The status pane at the bottom of the dialog box
gives status information (for example, loading
parts).
When you select a revision and click the Graphical Compare tab, the graphical
configuration is displayed with five slider controls. Use these comparison sliders
to dynamically view the changes between the selected revisions. Parts that are
added, canceled, moved, or reshaped from one revision to the other move across
the screen as you move the slider is slid from one revision to the other. The parts
are color-coded according to their status.
Use the sliders to view the histories of the following modifications:
Note
You can modify the comparison colors by clicking Icons/Colors Legend
to view and change the currently defined color for each type of comparison.
The All comparison slider moves all the comparison slider bars simultaneously. In
the far left position of the slider, the assembly is the problem assembly before any
parts were modified.
• Moving the Cancels slider from Revision A to Revision B causes Part A (colored
red) to pull out of the assembly and move out of the window.
• Moving the Reshapes slider from Revision A to Revision B causes the curve in
Part D (colored light blue) to start 9 millimeters higher on the part.
Moving the All slider causes all of these changes to occur simultaneously.
After you create the comparison, you can capture the image to export or print.
You can use the following controls on the Graphical Compare tab to manage the
comparison process of change-managed structures:
Function Description
Show Common Parts Use this check box to control if Teamcenter displays
common components between the two assemblies.
Show Supersedure link Use this check box to control if Teamcenter displays
supersedure links between added and canceled
components.
Show These buttons allow you to display other
configurations, without returning to the revisions
tab and selecting another revision. Use the three
buttons provided to display one of the following
configurations:
• Previous revision as configured by creation date
When you show supersedure links, Teamcenter draws a white band between added
and canceled components. When supersedures contain several added or canceled
components, Teamcenter draws a polygon connecting the center points of all
concerned parts. If you move the All comparison slider to the maximum left or right
position, the bands disappear automatically and the Show Supersedure Link check
box is not selected.
If the affected assembly was not created under a change order, the Supersedure
pane and the Supersedure Link check box are hidden.
2. Enter the unit number or end item values and click OK in both structure
panel.
Teamcenter configures the structures and displays the comparison results
in the viewer.
When you load a new revision rule, Teamcenter recalculates the comparison
results and the control sliders return to their default positions.
2. Enter the required variant rule and click OK in both structure panels.
Teamcenter hides the nonconfigured components in the graphical display
and the structure tree.
When you load a new variant rule, Teamcenter recalculates the comparison
results and the control sliders return to their default positions.
To do this, select a supersedure from the trail and click Change History . The
Change History dialog box opens with the changed components shown in their
respective colors. Teamcenter hides the following Show Common Parts and Show
Supersedure Link controls and tabs.
You can use the comparison sliders to view the revision changes.
Note The PV_Viewer_PSE property determines the availability of this
functionality. By default, this property is set to False and Teamcenter does
not display the button in the toolbar. Set this preference to True in the
rich client user.properties file to enable this functionality.
2. On the Graphical Compare pane, select the Show Supersedure Link check box.
5. In the Supersedure pane, select the supersedure whose link you want to view.
Teamcenter shows a single supersedure link in the viewer, corresponding to the
selected supersedure.
2. In the Options dialog box, select the desired color for any structure change type.
3. In the Options dialog box, modify the initial location of the slider. (The default
initial slider position is 100.)
Note For instructions about viewing a graphical comparison of two revisions that
do not belong to the same assembly, see Create disparate revision histories.
1. Select an assembly line in the structure tree and click the Graphical History
button.
Teamcenter displays the History dialog box.
3. On the Revision pane, choose two assemblies to compare. Click Revision List
to show all the revisions associated with the parent assembly in a tree-format
structure. Click Progression for a tree-format display of associated revisions.
5. From the Compare With list, select the second revision. This list includes all the
revisions associated with the selected parent assembly.
By default, Teamcenter populates the Compare With box with the problem
revision if the revision you selected in step 3 is in a change process.
6. If the parent assembly has multiple BOM view revisions associated with it,
select a view from the View Type list.
8. Review the effectivity data table for any effectivity data defined for the selected
revision. If no effectivity data is defined, the table is blank. If multiple
effectivities are defined for the revision, Teamcenter displays all end item
effectivity entries.
10. Check Show Common Parts to load all the parts common to the two assemblies
in the viewer.
11. View the history of adds, cancels, moves or reshapes by moving the appropriate
slider. To see all changes simultaneously, move the All slider.
12. To compare the histories of other revisions without returning to the Revisions
tab and choosing another set of revisions to compare, click one of the following
buttons:
• Click Previous to display the previous revision based on creation date.
• Click Latest Working to display the latest working revision, based on your
site’s definition.
13. To view the comparison information in tree format, click the Structures tab
at the bottom of the dialog box. The comparison controls are replaced by two
structure tree diagrams, indicating the modifications (adds, cancels, moves,
reshapes) to each revision by icons and color coding.
Click the Icons/Colors Legend to view the meanings of the icons and colors. In
this view, you can also set options for variant rules, view current revision rules and
set the current rule and set effectivity information.
1. Select an assembly line in the structure tree and click Graphical History .
Teamcenter displays the History dialog box.
3. In the Revision List view, select the revision you want to compare with a revision
not related to this assembly.
4. Locate the other revision from your Home folder or by searching for the revision
in the database. Copy it to the clipboard.
5. Paste this second revision into the Compare With box. This list always includes
all the revisions associated with the selected parent assembly. It now lists all the
associated revisions plus the disparate revision you inserted.
1. Select the concerned part in the structure tree and click Graphical History .
Teamcenter displays the History dialog box containing similar information as for
assemblies, except that the configuration switches (BOM view type and revision
rule) are not available.
2. From the Compare With list, select a different revision of the same part or
a different part.
3. Click the Graphical Compare tab to view the differences between the two part
revisions.
Only one control slider is provided and you can use it to move between the
affected and problem revision of the detail part.
Viewing supersedure
Supersedure allows you to view a graphical representation of the replacement
history of a given occurrence in the product structure.
Parts and assemblies are often added to and deleted from a product structure during
its construction or modification. Some of these additions and deletions can be
grouped together as a replacement action. For example, two added parts may replace
the form and functionality of one canceled component, making a replacement.
To view and manage the supersedure of the selected line, click the Show/hide data
pane button , and then click the Supersedure tab.
The supersedure tree shows the history of such replacements graphically, starting
from the selected part.
Note Before you can view the supersedure of a component, you must create a
supersedure that defines the replacement. You cannot create a supersedure
in Structure Manager.
For information about how to create a supersedure, see the Change Manager
Guide.
Managing supersedure
The supersedure tree starts from a selected part and shows the visual path of the
subsequent superseded parts. The supersedure tree also shows related product
information.
Navigate through the supersedure tree by double-clicking component nodes. Clicking
a node expands it to show the next supersedure in the sequence.
You can use the supersedure tree to:
• Browse the supersedure of the selected part.
Browse supersedure
The supersedure tree graphically displays the replacement history of the selected
part or assembly using rectangular and oval elements to represent components
and changes.
Only part numbers are displayed in supersedure, not revision numbers. You cannot
create supersedures for revisions; they are assumed to be interchangeable in form,
fit, and function.
To view the supersedure of a part or assembly:
1. In the product structure. select a line that represents a part or assembly that
has an associated supersedure.
4. Optionally, place the cursor over a change to show a tool tip that lists the parent
assembly item revision and effectivity of the selected change.
Note A part may be used in more than one assembly and each assembly has its
own supersedures. Thus, a part may have more than one supersedure trail.
2. Perform a where-used search in the search pane below the supersedure display.
For information on performing where-used searches, see Making where-used
searches.
3. Select the required different parent assembly in the graphical display of the
A part or assembly may be used in more than one top-level product. Such a part or
assembly may eventually be removed from one or more of the top-level products as
the products move through their life cycles. When you define the deletion of a part
or assembly in a supersedure, the Supersedure pane shows the component in red
with a line through the label. The red line indicates the part or assembly is no
longer used anywhere in the selected top-level product.
If you select a new top-level product from the product list, Teamcenter creates a new
supersedure of the selected part or assembly with respect to the newly selected
product.
Note By default, the capability to show redlined items
is disabled. To display redlined relations, go to the
java\com\teamcenter\rac\pse\genealogy\genealogy_user.properties
file and set useProductList.FLAG=true.
1. Select the part or assembly whose inclusion in various top-level products you
want to view.
b. Select the desired subassembly item revision from the Affected Item folder.
c. Right-click the item revision, choose Send To, and send the item revision
to Structure Manager.
Note There must be at least two item revisions in the Affected Item
folder, and one item revision must belong to a subassembly of the
other.
f. Click Save.
g. Structure Manager saves the assembly, then displays the supersedures view.
• The left pane displays the contents of the Affected Item folder.
• The right pane displays the contents of the problem items folder.
• The file name and revision rule of each item revision are displayed at the
top of the respective panes.
• Items that are deleted from the affected item revision display in red in
the right pane. In other words, components of the problem item revision
(displayed in the right pane) that are deleted from the solution item
revision display in red.
b. In Structure Manager, select the level of the assembly where you want the
component added.
c. Select the component you want to add and click Copy. You can select this
item revision from My Teamcenter.
e. Click Save.
Structure Manager displays the split window. The left pane displays the
contents of the Affected Item folder. Items that are added to the affected
item revision display in blue in the left pane.
g. Click Transfer.
A transfer supersedure is created.
Description Image
Regular supersedure
Description Image
Quantity supersedure, from 1
to 2
Description Image
Add supersedure plus pure
cancel
Quantity supersedure
3. View the supersedure of the same affected item with a different problem item by
selecting a different problem item from the list below the right pane. This list
displays any other problem items that have been used to create a supersedure
with the selected affected item revision.
4. A new supersedure appears, displaying the additions and deletions of the new
supersedure.
Change management compares the selected affected item with the associated
problem item in the change by displaying two panes. The left pane displays
modifications to the affected item assembly, the right pane displays modifications
from the problem item assembly.
By default, additions are blue, deletions are red, moves are green, reshapes are
light blue, quantity changes are orange, and so forth. Click Icons/Colors Legend
to view the currently defined color for each type of comparison. You can select
the comparison colors by choosing Edit→Options→Change Management→Bom
Tracking and changing the colors.
If the change contains more than one problem item, change management applies the
following rules to select the appropriate problem item:
1. Choose the item revision with the same ID as the selected affected item.
2. If there is no item revision with the same ID, or if there are multiple revisions
of the item revision, you are prompted to select one from those listed in the
Problem Items folder.
Note If the selected assembly is a new part, or else not an affected item (for
example, you are only making structure change modifications, not creating a
supersedure), choose No Problem Item at the prompt. BOM Change objects
of the type Add are created for every component.
In the example, the left pane displays the additions to Assy100/B, and the right pane
displays the deletions from Assy100/A, as shown.
Use the following information to complete the form fields in step 2 of the New
Form wizard:
Note It is important that the form fields are defined exactly as shown in the
table. If the definitions are altered the dynamic revision rules will not work
correctly, and once the forms are created, they are not easily revised.
2. From Change Manager, select the item revision under the Affected Item folder
and send it to Structure Manager, using the Send To command.
e. Click OK.
g. Select the same item revision and send it to Structure Manager again, using
the Send To command.
The Quantity column is displayed.
5. In Structure Manager, select the component for which the quantity needs to
be changed.
6. Click the quantity in the selected structure line; the Quantity cell is outlined.
8. Click Save. A split window displays the item(s) whose quantities have been
changed in orange.
The quantity for item revisions can also be viewed from the Properties information
dialog box.
The item revision is displayed in the Revision tree of the BOM Changes tab.
5. Click Create.
The form type specified in the ECM_bomchange_formtype preference displays
in the Form pane.
7. Click OK.
The information is saved to the database and the form is associated with the
structure change.
8. After the form has been associated with the structure change, click Display at
any time to display the form and its contents.
3. Type the new Revision ID sequence. In the previous example, change the
existing sequence of Assy100 to 3382.
5. Click OK.
6. Click Apply to save the changes to the database and leave the dialog box open
for additional changes.
3. Set the value of the supercedureFormType property to the name of the form
type to use as the supersedure form.
The custom form button now appears in the vertical toolbar of the
Supersedure pane. When a user completes the form, it is saved and associated
with the selected supersedure by the ECM_supercedure_to_form_reln
relation.
Note If you later need to determine the form that is associated with a
supersedure, query the value of the untyped reference run-time property
custom_form_tag for the Supersedure type.
1. Open the data pane by clicking the Show/Hide Data Panel button on the
toolbar.
• Create and set unit number and end item revision effectivity.
Both unit number and date ranges can be closed or open-ended. For open-ended
ranges, UP and SO (stock out) values can be specified. Ranges can be discontinuous,
for example, unit numbers 1, 5, 10–UP.
A privileged user (typically, the system administrator) creates the revision rules that
are then made available to other users. Consequently, nontechnical users do not
have to understand the full complexity of revision configuration but simply apply
the appropriate revision rule.
Before creating or implementing item revision configuration, see Getting Started
with Product Structure, which includes additional information.
• Optionally specifies the effectivity against which the revisions are configured.
Effectivity may be specified by date or unit number.
Note Do not confuse the effectivity in the revision rule with the actual effectivity
data visible on item revisions.
For more information, see Displaying and editing revision effectivity.
You define each of these criteria with a revision rule entry. A revision rule may
contain any number of rule entries, each of which attempts to select a revision
according to the specified criteria, for example, the status that the revision should
have or the user or group that owns the revision.
Teamcenter evaluates rule entries in order of precedence until a revision is
successfully configured. You can include some entries more than once to define an
order of precedence, for example, Status:
Working (Owning Group = Project Y)
Has Status (Production, Effective Date)
Has Status (Pre-Production, Effective Date)
You can modify the order of the rule entries to change the precedence Teamcenter
uses when evaluating the revision rule. Certain rule entries can also be grouped so
they are evaluated with equal precedence.
For more information, see Defining grouped entries.
Teamcenter always enforces a revision rule when you open a structure in a Structure
Manager window.
• Status
• Latest Revision
• Override
You can include more than one of these entries in the same revision rule to find
accessible item revisions.
This behavior applies only to imprecise structures and does not affect the evaluation
of precise structures. Similarly, there is no effect if you configure a structure by
unit number or date effectivity.
• If a revision is configured by any other (imprecise) revision rule entry that is not
accessible to the user, and the PSE_check_read_access_for_Rev_Rule_entry
preference is not present or is FALSE, Structure Manager displays
<UNREADABLE>. If the preference is TRUE, Structure Manager continues to
evaluate the next matching readable revision.
For example:
• You have an item called Part1 with two revisions, Part1/A is Working and
Part1/B is also Working.
A precise assembly Asm is created containing Part1/B. That is:
Asm
|--Part1/B
If User2 is denied read access to Part1/B and opens Asm in Structure Manager
with an AnyStatus;Working revision rule, the system performs the following
evaluation:
1. The AnyStatus entry does not configure any revisions.
2. The Working entry configures in Part1/B but access rules make this revision
<UNREADABLE>.
If User2 then changes the revision rule to Latest by Alpha Revision Order,
the system performs the following evaluation:
1. The Latest by Alpha Revision entry configures in Part1/B but access rules
make this revision <UNREADABLE>.
• You have an item called Part1 with three revisions, Part1/A is released with a
TcReleased status, Part1/B is released with a TcBaseline status, and Part1/C
is released with a TcReleased status.
A precise assembly Asm is created with Part1/C. That is:
Asm
|--Part1/C
If User2 is denied read access for the TcReleased status and opens Asm in
Structure Manager with a AnyStatus;Working revision rule, the system
performs the following evaluation:
1. The AnyStatus entry configures in Part1/C but access rules make this
revision <UNREADABLE>.
• You have an item called Part1 with two revisions, Part1/A is released with a
TcReleased status and Part1/B is working.
A precise assembly Asm is created with Part1/A. That is:
Asm
|--Part1/A
If User2 is denied read access for status TcReleased and opens Asm in
Structure Manager with a AnyStatus;Working revision rule, the system
performs the following evaluation:
1. The AnyStatus entry configures in Part1/A but access rules make this
revision <UNREADABLE>.
If User2 changes the revision rule to Latest Working, the system performs the
following evaluation:
2. Because access rules make Part1/A unreadable for User2, the final result
is <UNREADABLE>.
Element Purpose
Baseline A copy of the currently configured structure at the
time the baseline was created. Baselining configures a
completely released structure and thereby guarantees
that the models are always the same as when the baseline
was created.
End item A product, system, or module with respect to which you
can configure the structure by effectivity. For example,
you can configure the structure of unit number 110 in
product X400, where X400 is the end item.
For more information about end items, see Displaying
and editing revision effectivity.
End item revision The configured revision for the selected end item.
Imprecise assembly A single-level assembly that has items (not item
revisions) as the components. Teamcenter determines the
applicable revision from the revision rule settings.
Override list A mechanism that allows a user to override the revision
that would normally be loaded by the revision rule. The
user places item revisions in a workspace folder, and the
revision rule is overridden by the rule specified in the
override list.
The folder provided for the override list may contain
multiple nested folders. The item revision in the topmost
folder is configured.
Precise assembly A single-level assembly that has specific item revisions as
the components. When Teamcenter applies the revision
rule, the precisely specified item revision is configured by
a precise entry in a revision rule.
Release status An object assigned to an item revision after it is
successfully released. Item revisions can be configured
according to their status. The status may optionally
contain effectivity data for revision configuration (not
occurrence effectivity configuration).
Revision rule The parameters set by a user that determine which
revision of an item at a particular time. You can also save
a revision rule as a workspace object.
Rule entry A revision rule comprises an ordered list of rule entries.
Each type of rule entry is concerned with a particular
type of configuration.
Element Purpose
Snapshot You can save a configured product structure as a
snapshot. The snapshot folder contains all revisions of
the structure, and you can use it to redisplay a saved
structure at any time.
Working revision An unreleased version of the structure. Any user
with write privileges can freely change this revision.
Teamcenter maintains no record of intermediate states
of a working revision.
Both dialog boxes contain the Revision Rule Editor, which comprises two main panes.
• The upper pane lists all the entries in the rule, with buttons you can use to
manipulate the entries.
• The lower pane allows you to create or edit an entry, and add it into the rule.
2. Enter values into the boxes and click one of the following buttons:
• Click Append to add your entry at the end of the list of rule entries.
Syntax for revision rule entries is given in Defining revision rule entries.
2. Click Copy. Teamcenter copies the entry into the editing area and displays
the appropriate entry type and boxes.
3. Edit the values of the entry and click Replace with the original entry still
selected. Teamcenter replaces the old entry with the new entry.
Syntax for revision rule entries is given in Defining revision rule entries.
• Owning group
If you specify an owning group within a working entry, Teamcenter configures
the latest revision owned by the specified group, if there is such a revision. You
can also set the owning group to Current, and Teamcenter configures the latest
revision owned by the current user’s group.
Tip There may be more than one working entry within a revision rule. For
example, a rule may configure the current user’s working revision and, if
none is found, configure the current group’s working revision instead. If a
user changes group, it is necessary to reapply the revision rule to configure
the appropriate revisions for the new group.
However, in many circumstances, it is good practice to limit the number of
working revisions, typically to a single revision. Do this in Business Modeler
IDE, as follows:
1. Right-click the item revision business object on which you want to limit
the working revisions and choose Open.
2. Click the Operations tab, open the Operations folder, scroll down to the
bottom of the Operations folder, and open the Legacy Operations folder.
Assume you configure the following two items with this rule:
Part1/A : Status = Production
Part1/B : Working, Owning User = John, Owning Group = Project Y
Part1/C : Working, Owning User = Jane, Owning Group = Project X
Part2/A : Status = Production
Part2/B : Working, Owning User = Jane, Owning Group = Project X
This rule configures a revision that depends on the identity of the user logged
into Teamcenter.
• If Jane is logged in, Teamcenter configures Revision D.
Assume you use the following rule to configure the same item:
Working( Owning Group = Current )
The revision configured by this rule is dependent on which group the user is logged
into Teamcenter.
This rule configures a revision that depends on the group in which the user logged
into Teamcenter.
• If the user is logged into Group Project X, Teamcenter configures Revision C.
• Selected status
Teamcenter configures the latest item revision with a selected status type. This
setting allows you to configure a structure that contains only item revisions
with a specified status.
For details about configuring release statuses for your site, see the Business
Modeler IDE Guide.
• Released date
Teamcenter selects the latest item revision according to the date the revision
was released (that is, the date the particular status was added).
• Effective date
Teamcenter selects the latest item revision according to effectivity dates defined
on the release status. Privileged users define effective dates as described in
Displaying and editing revision effectivity.
Assume you configure the following three items with this rule (dates are release
dates):
Part1/A : Status = Pre-Production [1-Apr-2007]
Part1/B : Status = Production [1-Jun-2007]
Part1/C : Status = Production [1-Aug-2007]
Part1/D : Working
Part2/A : Status = Pre-Production [1-May-2007]
Part2/B : Status = Production [1-Jul-2007]
Part2/C : Status = Pre-Production [1-Sep-2007}
Part3/A : Status = Pre-Production [1-Aug-2007]
Part3/B : Working
Assume you configure the following item with this rule (dates are effective date
ranges):
Part1/A : Status = Production [1-Apr-2007 to ... ]
Part1/B : Status = Production [1-Aug-2007 to ... ]
Part1/C : Status = Production [1-Nov-2008 to ... ]
• Alphanumeric revision ID
Teamcenter selects the latest item revision in alphanumeric order by revision
ID. It selects any numeric revision IDs in numeric order by their first digit,
for example, 1, 10, 2, 21, and so on. It selects any alphabetic revision IDs in
alphabetic order, for example, a, aa, b, and z.
• Numeric revision ID
Teamcenter selects the latest item revision in numeric order by revision ID. It
does not configure revisions with nonnumeric IDs.
The following example shows a revision rule that configures with the latest by
creation date:
Latest( Creation Date )
If you configure the following item with this rule (dates are creation dates):
Part1/A : Status = Production [1-Apr-2006]
Part1/B : Working [1-Jun-2006]
You can set the date in a date entry to Today, and Teamcenter evaluates the
configuration criteria against the current date and time.
You cannot configure working revisions against a date in the past. Teamcenter
does not maintain information about the revisions that were in a working state at
a particular time in the past.
Note If no date entry is present in a revision rule, Teamcenter evaluates the date
by default to today’s date.
You can qualify date effectivity with an end item entry.
different end item are excluded. If the rule does not specify an end item, Teamcenter
only considers revisions with date effectivity and no end item qualification.
•
Has Status ( TCM Released ), Configured By EffectiveDate
Has Status ( Pending ), Configured by ReleaseDate
Assume you configure the following three items with this rule (dates are release
dates)
Part1/A : Status = Pre-Production [1-Apr-2007]
Part1/B : Status = Production [1-Jun-2007]
Part1/C : Status = Production [1-Aug-2007]
Part1/D : Working
Part2/A : Status = Pre-Production [1-May-2007]
Part2/B : Status = Production [1-Jul-2007]
Part2/C : Status = Pre-Production [1-Sep-2007}
Part3/A : Status = Pre-Production [1-Aug-2007]
Part3/B : Working
structure that has item revisions of different item types, you can create revision
rules that selectively apply the revision rule entries according to the given item type.
For example, you may use an item to manage parts and equipment, but need to
distinguish between a production part and the equipment used to manufacture the
part. Each of these item types may have the same status but can be configured in a
different way, for example, by unit or date released. To achieve this, you can define a
revision rule with a clause that restricts some of the entries to certain item types.
<Entry 1>
<Entry 2>
etc.}
For example:
Has Item Type (Part) }
Has status (Approved, Configured with Released Date) }
Has status (Production, Configured with Unit Number)
In this example, the Has status ( Approved, Configured with Released Date)
revision rule entry configures the product structure only if the item type is Part. For
all other item types in the product structure, Teamcenter applies the Has status
(Production, Configured with Unit Number) revision rule entry. If neither of
these entries applies, the part is not configured by this revision rule.
• Multiple revision rule entries grouped for item type without equal precedence:
Has Item Type ( Prototype ) {
entry 1
entry 2 }
entry3
• Multiple revision rule entries grouped for item type with and without equal
precedence:
This example shows how you can use the same status type in both situations,
but configured differently—in this case, by date for parts, but by unit number
and incremental change for modules.
You can only group Working and Status entries with equal precedence.
3. In the dialog box, define and select the entries of the same type you want to
group and click the Group button.
Teamcenter displays the Group Entries dialog box.
4. In the dialog box, click the Group Entries by Equal Precedence button.
Click OK and Teamcenter updates the Revision Rule dialog box with the newly
grouped revision rule entries.
Note When grouping by equal precedence, you should only group Working
entries with other Working entries and Status entries with other
Status entries. Do not group other combinations of entries.
5. In the Revision Rule dialog box, complete the definition of the revision rule
and click OK.
Note To remove an equal precedence entry from a revision rule, you must
highlight all the lines of the entry in the dialog box.
You can also group revision rule entries using engineering change types.
3. In the dialog box, define and select the entries you want to group and click the
Group button.
Teamcenter displays the Group Entries dialog box.
4. In the dialog box, click the Group Entries by Item Types button, and then select
the item types you want to group in the Available Item Types list. You can
transfer the selected item types to the Configure By→Has Item Type box in the
dialog box or remove them by clicking the + or – buttons, respectively.
Click OK to update the selected item types in the Configure By→Has Item Type
box of the dialog box, with a partially created Has Item Type revision rule
entry. It also updates the Revision Rule dialog box with the newly grouped
revision rule entries.
5. In the New Revision Rule dialog box, complete the definition of the revision
rule and click OK.
2. In the dialog box, select one or more revision rule entries and click the Group
button.
Teamcenter displays the Group Entries dialog box.
3. In the dialog box, click the Group Entries by Item Types button or the Group
Entries by Equal Precedence button, then select the item types you want to
group in the Available Item Types list. You can transfer the selected item types
to the Configure By→Has Item Type box in the dialog box or remove them by
clicking the + or – buttons respectively. Click OK when you have grouped the
entries.
Teamcenter updates the selected item types in the Configure By→Has Item Type
box of the dialog box, with a partially created Has Item Type revision rule entry.
Note You can only group Working and Status entries with equal precedence.
2. In the dialog box, select one or more Has Item Type revision rule entries that
are grouped by item type, and click the Ungroup button.
Teamcenter removes the selected entries and updates the dialog box.
Modify the item types in existing revision rule entries grouped by item type
2. In the dialog box, select one or more Has Item Type revision rule entries and
click the Edit button or double-click a single line.
Teamcenter displays the Group Entries Item Type Edit dialog box, similar to
the following example.
3. The item types that are currently grouped in the selected revision rule entry are
displayed in the Configure By-Has Item Type list. To add a selected item type
from the Available Item Types list, click the + button. To remove a item type,
select it in the Configure By-Has Item Type list and click the – button. When the
list of item types is shown correctly, click OK to update the revision rule.
Note You must check at least one item type; otherwise, Teamcenter displays
an error message.
rule and applies it to the window. This is the rule to which you make the unit
number change.
If any date, unit number, or end item has been explicitly set in the current rule,
you cannot change the value in this dialog box and the relevant boxes are grayed
out.
Tip You can add a button to the toolbar to initiate the Tools→Revision
Rule→Set Date/Unit/End Item command, by right-clicking the toolbar,
choosing Customize, and selecting the required button.
Note If you specify an end item identifier that is shared by multiple objects,
Teamcenter displays the Select Unique Item dialog box, allowing you to
select the object you require.
You can create or modify a revision rule in applications other than
Structure Manager, for example, in 4G Designer. Structure Manager
does display such revision rules and their entries, and you can use them
to configure the structure based on the displayed entries. However, a
product structure in Structure Manager and a collaborative design in 4G
Designer may have different data conditions. If so, the configurations in
the applications are different, even if you use the same revision rule.
• The search results box. Double-click the folder you want to set.
• A Folder box that displays the folder currently used as the override folder in
the revision rule.
Note • The first time you make a change (such as setting an override) to a saved
revision rule, Teamcenter creates a modified copy of the rule and applies
it to the window. This is the rule to which you then make the override
change.
o Unit No.( 4 )
The unit number specified in the revision rule.
• Precise
This appears if the occurrence is precise and is configured as such.
• Latest ( ... )
This appears if the item revision is configured by a Latest entry in a revision
rule. The method of latest configuration can be Creation Date, Rev ID Numeric,
or Rev ID Alphanumeric.
• Not Found
This is shown if no revision meets the revision rule criteria. Teamcenter displays
??? to represent the revision.
1. In the Revision Effectivity dialog box, select the appropriate revision effectivity
line and click Edit, or double-click the line.
Teamcenter displays the Edit Revision Effectivity dialog box.
Note You can also edit revision effectivity in My Teamcenter. Double-click the
item status and change the displayed value.
2. In the Create or Edit Effectivity dialog box, choose Units or Dates effectivity, as
appropriate, and define the effectivity data.
If defining unit effectivity, type the desired effectivity range in the Units box.
Use the - character within a continuous range, and the , character to separate
discontinuous ranges. For example, the unit range 1-5,7-9 defines effectivity for
units 1 through 5, and 7 through 9 (but not effective for unit 6).
If defining date effectivity, select a cell in the From or To column, select a date
from the calendar (and optionally enter a time), and click Set Date to place that
date in the selected cell. Click the Clear Date button to remove the date from the
currently selected cell. Repeat these steps for additional date ranges until you
have entered all the desired date ranges.
• Click the SO button to add the stock out condition to the end of the unit or
date effectivity range.
• Select the Apply Access Manager effectivity protection check box to apply
the predefined Access Manager rules to this effectivity.
Note Teamcenter interprets UP and SO conditions as open-ended for revision
configuration purposes. The revision is considered effective for any value
greater than or equal to the unit or date value immediately preceding
the UP or SO. Stock out indicates that existing stocks of a component
revision should be used up before the next revision.
3. Optionally, for date effectivity, use the Edit Revision Effectivity dialog box to
define an end item to qualify the effectivity range. You must use this with
unit effectivity to specify a product, module, or subsystem that carries the
unit number to which this effectivity refers. You can select an end item in one
of the following ways:
• Clicking Find adjacent to the End Item box and searching for an item
by identifier and/or name.
To support reuse of the same components in different products, you can define
multiple effectivities on the same status of an item revision, if each effectivity
specifies a different end item. To create an additional effectivity on a status that
already has effectivity:
1. In the Revision Effectivity dialog box, select the appropriate line and click
Create. Teamcenter displays the Edit Revision Effectivity dialog boxes, with
blank effectivity ranges.
2. Define the new effectivity, as described in steps 2 and 3 of the previous procedure.
You can create a mapping table to define the ranges of dates or unit numbers in the
top-level product that configure a particular unit number or effective date in the
lower level assembly. When you expand the product structure and apply a revision
rule, the unit number or date set at the top level is converted to the scheme defined
in the mapping specified for the assembly.
For more information about nested effectivity, see Getting Started with Product
Structure.
2. Click the Operation Descriptor tab and select the CreateInput tab.
For more information about using the Operation Descriptor tab to make
properties visible on creation wizards, see the Business Modeler IDE Guide.
If you apply the following revision rule, the structure is configured as shown in
the following figure:
Status = Released, Configured by Effective Date
Working
Nested Effectivity
EI = NE-A5000
Date = 27 July 2006
Nested effectivity 1
Conversely, if you apply the following revision rule with no nested effectivity entry,
the structure is configured as shown in the following figure:
Status = Released, Configured by Effective Date
Working
EI = NE-A5000
Date = 16 July 2005
Nested effectivity 2
Teamcenter ignores the mappings, so the end item does not switch from A5000
to NE-A2000/NE-A3100 at the configuration items. Consequently, none of the
components below the configuration items are configured, as the end item on the
effectivity is not NE-A5000.
If you apply the following revision rule, Teamcenter applies effectivity mapping due
to the Nested Effectivity entry and the structure is configured as shown in the
following figure. However, some of the components are not effective on 23 July and
have no configured revision; Teamcenter marks these components as ???.
Status = Released, Configured by Effective Date
Working
Nested Effectivity
EI = NE-A5000
Date = 23 July 2005
Nested effectivity 3
2. Optionally, select the Use Shared Effectivity check box to use an effectivity
map and share it with another end item. You can also select the Create New
check box to create a new effectivity map and make it available to share with
other end items.
Note You can share any effectivity type, not just effectivity maps.
To create a new effectivity map, select an item revision in the Effectivity Mapping
dialog box and click the Create button. Teamcenter displays the Create Effectivity
Mapping dialog box, allowing you to define the parent product effectivity and the
subeffectivity of the item revision.
Similarly, to edit an existing effectivity map, select an item revision in the Effectivity
Mapping dialog box and click the Edit button. Teamcenter displays the Edit
Effectivity Mapping dialog box, allowing you to modify the parent product effectivity
and the subeffectivity of the item revision.
Engine/A (CI) Status: alpha, effective for 2005_MY from 1 Feb 2004 onwards
EndItem = Generation2
Gearbox/A Status: alpha, effective for Generation2 from 1 Feb 2004 onwards
Product generations
The effectivity map of this structure is as follows:
End
item/revision Effectivity range Subeffectivity
2005_MY Gen2
2006_MY Gen3
002585–Truck Jan 2007 – Apr 2007 Jan 2007
002997–Truck May-2007 – Onward Gen2, Apr 2007
In this example, the 2005_MY parent end item configures the Gen2 end item when
you enter the Engine/A assembly. Similarly, 2006_MY configures Gen3.
The final line of the example shows how you can transform multiple parameters
(End Item and Date) in a single mapping.
that defines an end item revision and Teamcenter encounters an object that has
effectivity based on the end item (not the revision), it successfully matches if the end
item revision is a revision of the end item.
You can also pack or collapse all effectivity entries that share the same release status
and unit or date range into a single line by selecting the Packed check box in the
Effectivity dialog box.
12 Capturing configurations
12 Capturing configurations
Capturing configurations
Teamcenter provides the following formats for persistently capturing the
configuration of a structure:
• Snapshots containing only the configured product structure (item revisions), not
the associated data. Consequently they require relatively little disk space.
You can redisplay the saved structure at any time by sending the snapshot folder
to Structure Manager. However, any item revisions that are not released are
subject to change, including the associated data and CAD models.
Note If the Baseline_create_snapshot_folder preference is set to 1, when
you create a baseline of a structure, Teamcenter creates a snapshot
folder under the baselined revision.
• Baselines containing a copy of the complete working data for the structure.
Baselines occupy a significant amount of disk space, as you create a copy of the
structure each time you baseline it. Many new revisions might be created and
(with them) copies of the associated data and CAD designs.
• Intermediate data capture (IDCs). IDCs are similar in purpose, but save the
configuration in PLM XML format. You can create IDCs in Structure Manager
and view them in the Multi-Structure Manager application.
• Product view. When you click the floppy disk button on the Viewer menu bar,
Teamcenter saves a PLM XML file that contains a visual representation of your
current viewer session. The session file may subsequently be reopened to show
the saved product view.
Using snapshots
A snapshot captures all the item revisions contained in a configured product
structure. You can use the snapshot to redisplay the structure as saved.
When you create a baseline, you can configure Teamcenter to also create a snapshot
folder by:
• Setting the Baseline_create_snapshot_folder preference to 1.
Tip Snapshots and baselines are separate features that are normally used for
different purposes.
You cannot create snapshot folders for precise baselines, only imprecise baselines.
The Baseline_create_snapshot_folder preference is ignored if you create a
precise baseline.
When you create a baseline of an imprecise structure, Teamcenter:
• Creates the baseline item revision.
• Creates a snapshot folder with the baseline job name under the baselined item
revision.
• Populates the snapshot folder with references to the item revisions included in
the structure when you created the baseline.
Create a snapshot
1. Configure the structure you want to save by applying the appropriate revision
rule.
2. Choose File→New→Snapshot.
Teamcenter displays the Create Snapshot dialog box.
3. In the dialog box, type a name for the snapshot and (optionally) a description.
To track snapshots and what they refer to, name them carefully. Use the Name
and Description boxes to do this. You may want to record the name of the
revision rule used to construct the snapshot in the Description box.
4. Click OK.
Teamcenter create the snapshot and folder, persisting the root item information
in the folder.
This action performs a full expansion of the structure, which may take some time
for a large structure.
2. Drag-and-drop the snapshot folder into the Structure Manager application. The
structure is displayed as you saved it in the snapshot.
The ad hoc revision rule applied in this Structure Manager window uses the
snapshot folder as an override list. It also configures precise references.
View a snapshot
• You can view the item revisions stored in a snapshot by expanding the snapshot
folder in My Teamcenter.
Note You should protect snapshots against modification of their contents using
the Access Manager rule tree as described in Controlling access to snapshots.
Using baselines
During the development of a product design, you may want to share your working
design with other users. You may also want to save an interim version of your design
for future reference. To do this, you can create a baseline of the work-in-progress
(WIP) design. When you request a baseline, Teamcenter creates a new revision for
each unreleased revision in the structure and releases it with a predefined status,
for example, TC_Baseline. It also links the new revision with the WIP revision
using an IMAN_baseline relation. This method configures a completely released
structure and thereby guarantees that the models are the same as when the baseline
was created.
When you create a baseline, Teamcenter observes deep copy rules when copying
datasets, forms, and other attachments associated with the item revision. Siemens
PLM Software recommends you use CopyAsObject in deep copy rules as the
baseline process takes a snapshot of objects in their current state.
For more information about defining deep copy rules, see the Business Modeler
IDE Guide.
If the baseline finds an invalid item type or the current user does not have write
access to any of the items, the baseline operation is rolled back. You define invalid
item types in the Baseline_restricted_item_types preference, as described in .
For example, you may not want to baseline engineering changes and documents.
For more information, see the Preferences and Environment Variables Reference.
Before creating a baseline, Siemens PLM Software recommends you first perform
a dry run mode to identify invalid conditions. Set the Baseline_dryrun_always
preference to true to always perform a dry run before creating the baseline.
The baseline process always starts from the top line of the current window, regardless
of the selected line. The baseline operation processes lines that are configured out by
variants or occurrence effectivity. Substitutes and packed lines are always processed.
However, if the structure has suppressed components, you can optionally process
them by selecting Show Suppressed Occurrences. If the structure has incremental
changes, Siemens PLM Software recommends you use incremental change baselines.
To view the completed baseline, load it into Structure Manager after applying the
appropriate revision rule.
Note Before creating baselines, you must configure this feature as follows:
• Use the Business Modeler IDE to create the appropriate baseline naming
rules for your site and attach them to the appropriate item revision
types. You must also create a Baseline status type in the Business
Modeler IDE.
For more information, see Define baseline naming rules.
• If you are working with NX, Teamcenter may synchronize (refile) the
assembly to NX before creating the baseline. This action is optional
and depends on the setting of the Baseline_nxmanager_refile
preference. You may also set the Baseline_refile_required_dstypes
and Baseline_refile_not_required_item_types preferences to refine
the refile operation.
You can also create a baseline of a single item revision in My Teamcenter. In this
case, a new copy of each BVR of the WIP revision is created. The precision of the
new BVR is the same as that of original BVR, irrespective of the setting of the
Baseline_precise_bvr preference.
Use the Business Modeler IDE to create the appropriate baseline naming rules for
your site. The following example shows how to format a naming rule in the Business
Modeler IDE for baselines of items:
Item Rule
A Rev
A.001
A.002
A.003
B Released Rev
B.001
B.002
C Working Rev
2. Create a naming rule called Baseline rev rule (any name can be used) with
the following pattern:
"."NNN
3. Attach the Baseline rev rule naming rule to the baseline suffix property on the
ItemPDR item business object.
For information about using the Business Modeler IDE, see the Business Modeler
IDE Guide.
Create a baseline
1. Ensure you are logged on to an account that has Author privileges.
2. In the product structure tree, display the top line item revision of the structure
you want to capture and choose Tools→Baseline.
Teamcenter displays the Baseline dialog box.
• Description
Type a description that is stored with the baseline.
• Baseline Template
Select a release procedure template from the list. The available
release procedures are defined by the administrator with the
Baseline_release_procedures preference. The list does not show
templates that are in edit mode. The default Workflow process is TC
Default Baseline Process. The workflow process used for baselines must
not include any signoffs.
• Job Name
• Job Description
Enter a description of the baseline job.
4. In the dialog box, select one or more of the following check boxes, and then click
OK to create a baseline or dry run:
• Open on Create
Opens the baseline automatically after it is created.
• Precise Baseline
Selects the type of baseline to create—precise or imprecise. Your site may be
configured to allow only precise baselines, depending on the setting of the
Baseline_precise_bvr preference.
The standard baseline process may be time-consuming and use significant disk space
as it may create many new revisions and (consequently) copies of all the associated
data and CAD designs. To avoid this, you can create a smart baseline, reusing a
baseline revision whose work in progress revision is unmodified since its last baseline
was created. You can only create smart baselines of assemblies. To enable smart
baselines, your administrator sets the ITEM_smart_baseline preference to ON.
If you try to create a smart baseline of an assembly that has not changed since
the previous baseline, a new baseline is not created. No informational message is
displayed in Structure Manager to indicate this.
Note If you make changes to an occurrence property (for example, quantity) the
last modified date of the parent BVR changes and Teamcenter therefore
considers the parent item revision as a candidate for a new baseline.
However, the item revision of the BOM line on which changes were made
does not qualify for the new baseline.
Note You must set the Snapshot relationship on the item revision to make the
snapshot folder visible. Do this by choosing Edit→Options→General→Item
Revision and adding Snapshot to the Available Relation column.
Hide baselines
1. Choose Edit→Options.
The Options dialog box appears.
2. Select Item.
equal to the condition, Pending, and set the limit to the maximum number of
baselines you want to display.
8. Click OK.
The hierarchy tree pane displays the latest baselines up to the limit set.
3. Enter the name and optional description of the intermediate data capture, choose
a transfer mode name from the dropdown list, and then click OK or Apply.
Teamcenter validates the objects in the structure you selected. If any of the
objects cannot be captured, it displays an error message, otherwise it creates
the PLM XML file containing the IDC.
Note Ensure you select a transfer mode that is appropriate for the data you
want to capture, for example, ConfiguredDataExportDefault or
BOMwriterExport. The displayed list shows all transfer modes that
are available in the system.
Note You cannot manage changes to substitute parts with incremental changes.
Element Purpose
Absolute occurrence A relationship between a parent assembly and an item
one or more levels lower in the structure. The parent
assembly is the context in which the absolute occurrence
exists. You can define data on the absolute occurrence
that overrides the data stored on the item when you
select the context assembly and view the structure. Both
relative occurrence data (notes and transforms) and
attachments can be overridden with data on absolute
occurrences.
Each absolute occurrence can have one or more unique
attribute values that distinguish it from the other
absolute occurrence derived from the same single
occurrence.
Attachment A form, dataset, or folder related to an item revision.
Baseline (Incremental change baseline.) A new revision of
the parent assembly that has the occurrences and
attachments as configured in Structure Manager when
the incremental change baseline was created. There are
no incremental changes and all unconfigured occurrences
are removed.
Change An individual change to a component (occurrence) or
attachment. A change may be an add or a remove.
Incremental change A collection object that contains the individual changes.
(IC) An IC is modeled as an item of the EngChange type. You
can release an incremental change and apply effectivity
to it by attaching a release status. Incremental change
(revisions) are configured by the revision rule, as are the
components (occurrences) and attachments associated
with the changes on the incremental change. You can
revise incremental changes if required, in which case the
changes are copied (this is not typically required).
Intent A named object that represents an alternate solution.
You can apply one or more intents to an incremental
change to signify that the incremental change is valid
for those intents. The user sets one or more intents in
the revision rule that configures the incremental changes
with those intents and, consequently, the associated
changes. Intents are only available with incremental
change, not with standard revision configuration.
Occurrence (Sometimes called relative occurrence.) A hierarchical
structure relationship between the immediate parent
assembly and its child component item (in an imprecise
assembly) or item revision (in a precise assembly). You
can use a find number to identify for an occurrence, but
this number may not be unique. Data can be stored on the
occurrence, including occurrence notes and transforms.
In this example, if there is an active incremental change and the operation performed
by the user is tracked by incremental change, the In IC Context rule applies and its
associated named ACL applies to objects affected by the operation. However, if there
is no active incremental change, the subsequent rules apply.
You typically use this rule to relax a restriction, such as only allowing edits to a
released structure for a specific status. For example:
Has Status () → Vault
Has Status (Pre-Released) → () (No ACL)
In IC Context (true) → Incremental Change Access
In addition, the user requires write access to the incremental change itself.
Note There is no mechanism of enforcing that an incremental change is used
when making structure edits.
You can also configure the In IC Context Access Manager rule as follows to allow
write access to released structures at a specified status. This allows incremental
change to track changes at prereleased stages of the structure (BOM view revision).
Has Status () → Vault
Has Status (Pending IC) → Incremental Change Access (or Working)
Has Status (Pre-Released) → () (No ACL)
In IC Context (true) → Incremental Change Access (or Working)
The status defined in the preference must already exist. You must also create an
Access Manager rule that allows write access to objects with this status or you
cannot create changes in the incremental change.
Note The status is applied only to incremental change if the effectivity is supplied
when it is created.
For an example of how the Pre-Released status can be applied to the item revisions
and the IC in Process status to the incremental change revisions, see Getting
Started with Product Structure.
The revision rule needed for that example is as follows:
Has Status = IC in Process, Configured by Unit:
Has Status = Pre-Released, Configured by Unit:
Has Status=Released, Configured by Unit
Has Status = Released, Configured by Release Date
Has Status = Pre-Released, Configured by Release Date
Working
The purpose of each entry in this revision rule is as follows:
Has Status = IC in Process, Configured by Unit:
Has Status = Pre-Released, Configured by Unit:
Allows Teamcenter to configure both the incremental change and the structure
revisions by unit number. Having separate statuses allows Access Manager
to apply different access controls to the item revision and BOM view revision
and to the incremental change.
• Fnd0AttrIcesToExclude
Defines the occurrence attributes which Teamcenter does not copy to the target
location for occurrence attribute changes.
Do not simply revise a structure that has incremental changes on any of the
components because the incremental changes are not copied and the structure is not
configured as expected. You must create the incremental change baseline first.
Ensure the baseline cannot be modified by applying a status to apply vaulting to the
BOM view revision, rather than the item revision. Do not use the status on the item
revision for this purpose because the status is also used for configuration.
You must have access to the incremental changes to create an incremental change
baseline. If Teamcenter determines that you do not have the necessary access, it
rolls back the baseline operation and does not create the new item revision.
Note Do not confuse incremental change baselines with creating standard
baselines of item revisions as described in Using baselines. With standard
baselines, if the item is an assembly, you can automatically create a new
revision of any unreleased components throughout the substructure. With
incremental change, the baseline is applied only to the product structure,
not to the components.
It is good practice to apply unit number effectivity to the assembly item revisions,
even if the components are configured by incremental change. This approach
identifies the effectivity of the new incremental change baseline revision, and also
configure it appropriately. There should be no incremental changes on components
in the new incremental change baseline revision that are effective prior to the unit
number at which the incremental change baseline revision was created.
• IC_baseline_carry_forward_status
Defines a list of status names to consider when carrying forward active
incremental changes. The default value is pending.
When you create the baseline, changes that are past effective are dropped,
irrespective of status. For example, if you create a baseline at unit 25, there may
be changes on an incremental change with effectivity on units 5 to 15. All these
changes are dropped because they are past effective. If you subsequently change the
effectivity of this incremental change to span or cross baseline unit 25, you must
recreate the baseline to take the effectivity change into account.
Teamcenter determines if an effectivity is applicable in the current context. An item
revision under incremental change may have several status objects attached to it,
and the objects may be different types. A revision rule may have several entries
configured by effectivity, and the entries may specify different status and effectivity
types. To determine if an effectivity statement on an incremental change revision
applies to the revision rule, Teamcenter checks that the combination of status type
and effectivity type (date or unit) match an entry in the revision rule.
It copies the affected object to the new item revision. It also connects the new copy of
the affected object by an incremental change element (ICE) to the same incremental
change as the original affected object.
Teamcenter rolls up active changes if the change is currently active and the
qualifying incremental change is released. It copies only the affected object to the
new item revision.
ICEs link affected objects to revisions of incremental changes. As an incremental
change evolves, the affected object may be qualified by several ICEs to multiple
revisions of the same incremental change. If you do not assign explicit out
effectivities, but supersede them with later in points (for example, A: 1–UP, B:
10–UP, C: 20–UP), multiple revisions of the same incremental change may be
considered active. If the baseline effectivity is equal to or more than 20, the latest in
rule determines that C is the currently configured revision. However, as you may
subsequently change any effectivity, Teamcenter carries forward the affected object
with ICE qualification to all of these active incremental change revisions.
Several structure line properties that contain information about incremental change
are not shown by default and you may want to display these properties when you
work with incremental changes, as described in Displaying properties. Consider
displaying some of the following properties:
• Configured ICs
Lists the incremental changes that affect each structure line that is configured
by the current revision rule. + and – symbols in the cells indicate adds and
deletes, if applicable.
• IC Effectivity
Lists the incremental changes that affect each structure line and their
effectivities. + and – symbols in the cells indicate adds and deletes, if applicable.
• IC Release Status
Lists the incremental changes that affect each structure line and their release
statuses. + and – symbols in the cells indicate adds and deletes, if applicable.
• IC Intent
Lists the incremental changes that affect each structure line and their intents. +
and - symbols in the cells indicate adds and deletes, if applicable.
The toolbar is grayed out if no structure is loaded. When you load a structure,
Teamcenter activates the toolbar buttons.
You can drag the incremental change reference from the toolbar and drop it into
an application such as Change Manager or My Teamcenter. For example, you can
do this to release the incremental change or introduce it into a workflow. The
incremental change window includes the following toolbar buttons.
Button Function
Creates a new incremental change.
Displays the MRU list containing the most recently used incremental
changes.
Displays the incremental change Information dialog box.
Clears the active incremental change and turns off incremental change
tracking.
• The Incremental Change Information pane allows you to identify the incremental
changes that affect the selected line. This is useful if there are several changes
(adds or removes) associated with a single line, and each change is attached to a
different incremental change.
You can drag-and-drop incremental changes from the data pane to set
incremental change context.
• The Incremental Change Info pane allows you to undo (remove) individual
changes from the selected line.
• Current Context
• All Contexts
Teamcenter changes the Active IC box to display No Active IC. No edits are
tracked.
Customize buttons
Incremental changes are displayed by symbols at the beginning of a structure line.
When you add or remove a structure line, Teamcenter displays a plus or minus
symbol in front of the respective line.
• Customize when incremental change symbols are displayed by choosing
Tools→Incremental Change→Display Icons and selecting the contexts in which
you want to see the symbols.
2. Click the IC Attributes tab and set the following incremental change attributes:
• Type an ID and revision for the change object. Alternately, click Assign to
let the system assign this information for you.
• Select a change type from the Incremental Change Type list. Note that some
of these types may be for general changes, not incremental changes.
3. Click the Effectivity tab and specify whether to set effectivity for the incremental
change using unit serial numbers or dates by doing one of the following:
• Click Units and specify the range of serial numbers to which the effectivity is
to be applied. You can also click one of the following buttons:
o UP button to define an unlimited effectivity from a starting number. For
example, typing 1-UP means the change is effective from unit 1 upward.
• Click Dates to set effectivity based on calendar dates. Multiple date ranges
can be entered. To set a date:
o Type the start and end dates for the effectivity period into the From Date
and To Date cells in the date table.
o Select a date in the calendar table and click Set Date to specify both the
From Date and the To Date entries.
4. If unit effectivity is set, populate the End Item box on the Effectivity tab using
one of the following methods:
• From the list of most recently used end items
5. Click OK to finish creating a new incremental change and close the dialog box, or
click Cancel to cancel the operation.
Teamcenter creates a copy of the new incremental change in your New Stuff
folder.
• Only those components and attachments that are configured by the current
revision rule.
2. Type either the name or ID of the change object to be displayed. You can use
wildcard search characters, if necessary.
3. Click Find.
All change objects matching your selection criteria are displayed in the dialog
box. Use the navigation buttons at the bottom of the dialog box to navigate
the list.
4. To select an incremental change object for display, double-click the change object
in the dialog box list.
Teamcenter displays the View/edit Change dialog box, which includes the
following tabs:
o IC Attributes shows the change object name, description, and tag type.
o Effectivity allows you to view and edit the effectivity of the change object.
Double-click a specific release status to open a dialog box containing all the
effectivity information for the selected release status.
Note To apply effectivity, your administrator must use Access Manager to
assign you to the appropriate group and role.
o Intents displays the intents for which the incremental change is valid.
You can create a new intent by clicking the Intent button and typing the
appropriate information in the Create Intent dialog box. You can then add
the intent to the incremental change by ensuring it appears in the Intent to
add box and clicking +. You can also search for existing intents and add them
to the incremental change.
Note To make the Intents tab visible, set the EnableIntents preference
to true.
You can also use the symbols on a structure line to identify adds, removes, and
absolute occurrences. For attachments, these symbols are displayed in the
Attachments pane, not the main pane.
• IC Context
Specifies the incremental change objects affecting the structure, listed in the
order they are applied.
• Release Status
Specifies the release status of the incremental change object, for example,
Production.
• Effectivity
Specifies the date or unit number effectivity of the incremental change.
• IC Configured By
Specifies the revision rule that configures the incremental change for this
structure. This allows you to see if an incremental change is configured and, if
so, how it is configured.
For attachment changes, the affected lines and changed relationships are also listed.
For occurrence attribute changes, the affected attributes and changed values are
also listed.
To see more information about an incremental change, double-click the line in this
pane; Teamcenter displays the changes made by the incremental change.
• Click the Most Recently Used button ( ) to display a list of previously used
incremental changes from which you can choose.
3. Select the structure line corresponding to the item revision under which you
want to create the attachment.
• Select the item or attachment that you wanted to track as removed and choose
Tools→Incremental Change→Remove.
you try to edit an incremental change that is not configured by the current revision
rule, Teamcenter displays an error message.
• If the corresponding change is an add and the user has write access to the parent
BVR, Teamcenter deletes the add but not the occurrence. If you want to remove
the occurrence, choose Edit→Remove. If the user does not have write access, the
deletion request fails.
For occurrence attribute changes, if the change to undo is an add and it is the only
change to the attribute, the change and the override value are both deleted. In
other cases, only the change is deleted.
2. Select the change to undo and click Undo Change, depending on the change type
that you want to remove. You can undo multiple changes in a single operation.
3. Select the check box next to each change you want to remove, or click Select All
to remove all changes, then click OK.
Note Occurrence attributes are not displayed in the Remove Incremental
Changes dialog box; you can only undo them from the Incremental Change
Information pane.
• Deleting an attachment
• Modifying an attachment
• Any related changes that are not tracked by an incremental change are not
considered for export.
You can create an incremental baseline for a structure that was already exported.
This action creates a new revision of the structure. As active changes are carried
forward into the new incremental change baseline revision, you may add new
incremental change elements (ICEs) affecting the new structure revision to the
incremental change revision that is the parent of the original active ICEs. (This
incremental change revision may already be exported for the original structure.)
Because the new ICEs do not affect the revision of the structure that was exported
when you perform a TC XML export, they are exported as a stub. The incremental
baseline action has no additional effect on the export of the original structure and
the incremental change revisions that affect it.
For more information, see the PLM XML/TC XML Export Import Administration
Guide and the Data Exchange Guide.
2. Click the Display/Set export options button in the bottom right-hand corner
of the dialog box.
Teamcenter displays the TIE Export Configured Export Default dialog box.
3. Select the check box corresponding to each of the export options you want to
use and then click OK.
Teamcenter closes the TIE Export Configured Export Default dialog box.
4. In the Export To Briefcase Via Global Services dialog box, enter all the required
information including Reason, Target Sites, Option Set, Briefcase Package
Name, Revision Rule, and Variant Rule, and then click OK.
Note Ensure you select the TIEConfiguredExportDefault transfer option set to
export incremental change based deltas.
5. Click Yes.
Teamcenter starts the export of the product structure using the options you
entered.
2. Navigate to or type the path and file name of the briefcase file in the Briefcase
File box. Select TIEConfiguredImportDefault from the Option Set list.
3. Click the Display/Set export options button and select the desired options.
4. (Optional) Select the Site Check-In after import box. If you select this box, all
objects that are checked out to the unmanaged site are checked in during the
import process. Otherwise, you must check them in individually after they are
imported.
2. Enter the required export directory, file name, choose the appropriate IC delta
transfer mode (for example, ConfiguredDataExportDefault), and then click OK.
Teamcenter displays a confirmation message if the export is successfully
completed. It generates the output PLM XML file in directory the location shown
in the PLMXML Export dialog box.
2. Enter the name of the PLM XML file to import, choose the appropriate IC delta
transfer mode (for example, ConfiguredDataImportDefault, select the required
incremental change context, and then click OK.
Teamcenter displays a confirmation message if the import is successfully
completed. It imports only changes to the structure, as captured in the exported
PLM XML file.
14 Configuring structures by
occurrence effectivity
14 Configuring structures by
occurrence effectivity
Each effectivity object has a unique identifier, which is displayed in the ID column of
the structure properties table.
Several occurrences may share an effectivity object. When you edit the effectivity
range on one occurrence, Teamcenter applies the change to all occurrences. (This is
generally the reason for sharing effectivity.)
You can also pack occurrences if they share the same unit or date range and Access
Manager protection status. Packed occurrences are displayed in a similar way to
packed structure lines.
For more information, see Packing or unpacking structure lines.
You cannot import or export structures containing occurrence effectivity. If you
require individual structure nodes to have effectivity, consider the use of incremental
change.
For information about incremental change, see Managing incremental changes.
If an occurrence does not have an associated effectivity object, Teamcenter assumes
it is always effective and it is configured regardless of the date or unit number set
by the revision rule, as shown in the following figure.
No effectivity defined
- that is, always valid
A20 P10 P20 P30
Bike
A10
A20 A25
Hub Dynamo Rim Dynamo
Validating effectivity
You should check that effectivity ranges are consistent within the whole structure,
ensuring that effectivity ranges lower down the structure lie within ranges higher
up. You may not be aware of the constraints higher up the structure when you
initially specify effectivity ranges at lower levels.
Teamcenter does not perform this validation automatically but you can include it
as part of a workflow process that approves the effectivity ranges. In certain cases,
this validation may not be appropriate, for example, when the structure is shared
between different products.
1. Select the line in the structure representing the occurrence with which you
want to associate effectivity.
3. In the Effectivity ID box, type the identifier of the effectivity object you want to
associate with the occurrence, and press the Enter key. Alternatively, you can
search for the effectivity object by clicking Search adjacent to the Effectivity
ID box.
Teamcenter populates the date or unit number table with the ranges from the
effectivity object.
o Unshared
Unshared effectivity has no ID. If you are creating unshared effectivity,
ensure the Use shared effectivity check box is cleared.
1. Select the line in the structure representing the occurrence whose effectivity
you want to modify.
• Click the SO button to add the stock out condition to the end of the unit or
date effectivity range.
• Check the Apply Access Manager effectivity protection check box to apply
the predefined Access Manager rules to this effectivity.
• (Optional) For date effectivity, use the End Item dialog box to define an end
item to qualify the effectivity range. You must use this with unit effectivity
to specify a product, module, or subsystem that carries the unit number
to which this effectivity refers. You can select an end item in one of the
following ways:
o Clicking Open by Name adjacent to the End Item box and searching
for an item by identifier and/or name.
4. Click OK and Teamcenter removes the effectivity object from the selected
occurrence. Any other occurrences sharing this effectivity retain their references
to the effectivity object.
When you copy, cut or paste, Teamcenter does not reproduce any references to
effectivity objects in the copy occurrences.
Note A combination of multiple end items and range of units for each end
item used to configure product structure occurrences is referred to as a
multi-unit configuration. To enable the creation of multi-unit effectivities,
the administrator must set the Fnd0EnableMultiUnitConfiguration
global constant to true at each site with the Business Modeler IDE.
This feature allows you to:
• Specify multi-unit configurations and save them as effectivity groups.
2. Select Effectivity Group, enter the necessary name, description, and identifier,
and then click Finish.
Teamcenter creates the base revision of the new effectivity group. (Effectivity
groups cannot be revised, and you are unable to create further revisions of the
new group.)
Teamcenter displays the View/Edit Multi Unit Configuration dialog box with the
View/Edit Multi Unit Configuration pane visible.
Note The Most Recently Used option is not available in this dialog box. Also,
the Open By Name box is not available on the Effectivity Groups pane
in this dialog box.
Caution This is a modeless dialog box. It allows you to copy items from other
locations, such as your Favorites folder, and paste them into the
dialog box. However, it also allows you to perform other actions,
such as Revise and Close commands in My Teamcenter with the
dialog box open.
If you open this dialog box using View/Edit in the Set Date/Unit/End
Item dialog box (Effectivity Groups tab), the dialog box is modal and
does not allow you to paste between applications.
2. Enter the necessary end item and unit range information, and then click Add,
Edit, Remove, or Undo to update the effectivity group, as follows:
• To add an end item unit range, enter the end item ID and the effective unit
range and click the Add button. You can also search or browse for an end
item to populate the End Item box. You can also copy the end item from
your Favorites folder in My Teamcenter and paste it here. You can specify a
combination of units or unit ranges in comma-separated format.
• To remove an end item unit range, select it in the table and click Remove.
• To edit an end item unit range, select it in the table and the system populates
the End Item ID and Unit Range boxes from the selected entry. After you
make the required changes, click Modify.
• To revert the last change made in the dialog box, click Undo.
Note Undo allows you to go back one level to the previous state in the
dialog box. Thereafter, any subsequent clicks on the Undo button
cause the dialog box to toggle between its current state and previous
state.
Note You can view and edit effectivity groups with certain limitations. Use the
View/Edit button in the Effectivity Groups pane of the Set Date/Unit/End
Item dialog box to add or modify the end items by manually typing the
necessary data. You cannot search for or copy and paste end items here.
2. Enter the effectivity group identifier in the Effectivity Group box, and then click
Replace, Insert, or Append to update the list of groups.
Note To remove an effectivity group from the list, select it and click Remove.
When you apply the configuration, the system matches the occurrence effectivities
configured for each occurrence with the multi-unit configuration set in the effectivity
groups. Any occurrence whose occurrence effectivity is valid for any of the end
item and unit range entries in the effectivity groups is displayed. An occurrence is
loaded only once even if its effectivity matches more than one end item entry in
the effectivity groups set in the session.
Caution You can configure product structures with incremental changes using
effectivity groups. However, only limited support is provided to configure
occurrences with incremental changes using multi-unit configuration
and the following limitations apply.
• You can configure only the addition and deletion of occurrences using
effectivity groups. Other edits in the context of incremental change
cannot be configured.
15 Configuring structures by
classic variants
15 Configuring structures by
classic variants
Element Purpose
Constraint An expression that sets an option value according to the
values of other options, that is, derived defaults.
Derived default A default value that depends on a certain condition
(for example, radio = stereo IF car type = GLX). A
derived default is attached to an item revision but applies
globally to a loaded structure.
Option default A specific default value for an option (for example,
engine = 1200). A fixed default is attached to an item
revision but applies globally to a loaded structure. It can
be used internally to set private from public option values
or to set public option values on the child module.
Option A parameter of variability. Options have a string type
and a name.
Variant (structure) A specific structure that is configured by applying a
variant rule.
Variant condition A condition that an engineering user sets on an
occurrence to specify the option values that configure the
occurrence (for example, Load IF engine = 1200). More
complex condition statements may also be defined.
Variant rule A collection of option values, typically set by a marketing
user, to determine the variant of the structure to
configure (for example, car type = GLS, engine = 1200,
gearbox = manual). A saved variant rule is a persistent
database object.
Variant rule check A condition that specifies any option values or
combinations of values that are not allowed. A variant
rule check is attached to an item revision. Also called an
error check.
The upper part of the Variants pane shows the variant data tree, presenting
any variant data stored on the item revision represented by the structure line
currently selected in the structure. The tree has three branches:
o Options
o Option defaults
o Rule checks
If the item revision has variant data, the branch has a + (plus) symbol and you
can expand the branch to view the data.
The lower part of the pane allows you to create and edit variant data for the
selected data, if you have write access to the item revision. You can also view
further details of specific variant data, for example, the allowed values of an
option.
Tip Use the PSE_show_option_item_prefix preference to show or hide
the owning item ID as a prefix to the option name. For details, see the
Preferences and Environment Variables Reference.
Configure to load
You can eliminate the loading of unconfigured variants and consequently complete
loading of the structure more quickly.
1. Choose View→Enable Filtering Unconfigured due to Classic Variants.
Teamcenter enables configure to load filtering.
4. Select the Filter unconfigured BOM lines due to Classic Variants check box.
When the structure is subsequently loaded, Teamcenter does not load lines that
are unconfigured by the selected variant rule. The title bar of the structure tree
pane is colored green to indicate that filtering is applied.
Note You cannot disable this selection when the structure is loaded and it persists
each time the structure is loaded. To change it, you must follow the previous
steps and clear the Filter unconfigured BOM lines due to Classic Variants
check box.
Enable or disable use of the configure to load feature with the
PSEEnableFilteringUnconfigdDueToClassicVariantsPref preference;
use the ConfigureToLoadEnableDefaultVariantConfig preference to
enable or disable the Do not show this dialog automatically when opening
BOM check box in the variant configuration dialog box.
Changes to variant data are controlled by association with item revisions and BOM
view revisions.
You can save a variant rule in Structure Manager as a persistent workspace object,
then use it in the Multi-Structure Manager application, thin client, or NX client. You
can also send the object to another user.
There are three ways of setting a valid variant rule that configures an allowed
variant of the product. This additional variant data is stored on an item revision.
• Variant rule checks
Variant rule checks prevent the designer from defining option values or
combinations of option values that are not allowed, as shown in the following
figure.
Car
Model G
A01000 Variant Condition
Load IF engine = 1200
Load IF engine = 1600
• Derived defaults
Derived defaults allow one option value to set any number of other related option
values. Options that potentially have derived values are indicated in the variant
rule as potentially derived and must be completed last. In the example in the
following figure, if the option car type is set to GLX, the option radio is set
to stereo by default.
Car
Model G
A01000 Variant Condition
Load IF engine = 1200
Fixed Default Load IF engine = 1600
fog lights = no
Body 1200 1600
Assy Engine Engine
A020 E1200 E1600
• Fixed defaults
Fixed defaults allow an option to be set to a specific value. In the example in
the previous figure, the default value for fog lights is no; unless specified, fog
lights are not fitted. The fog light components are not shown at this level of
the structure.
• Item revision:
• Occurrence:
o Variant conditions
o Controlling changes
Changes to variant data can have a dramatic effect on variant configuration. You
can control changes with techniques such as access control lists (ACLs), locking,
and release procedures.
Any user can set the variant rule to configure a particular variant. Users creating
variant data must ensure that the necessary variant rule checks exist so that only
valid rules can be set. You can use menu entry suppression to hide the variant
rule entry from certain users and groups.
Variant data is owned by a specific revision of an item. As the item evolves, it may
be necessary to change the set of allowed values for a particular option or possibly
to add further options.
Note Option identification names are not unique in the database; they are unique
only to the owning item. You must specify an item when the option is not
unique. Options are generally displayed with their owning item.
• Accessory
Accessories are options for which the user does not have to make a choice. They
are additional components and the user can select none, some, or all of the
accessory options. By default, no accessories are configured. For example, fog
lights may be offered as an accessory option.
Siemens PLM Software recommends the following strategies:
• If the option name is not unique, Teamcenter prompts you to specify an owning
item.
• When you specify defaults, Teamcenter warns if you attempt to specify a default
that would trigger an existing variant rule check.
If the variant rule check is not currently loaded (because the item to which it
is attached is not loaded), Teamcenter prompts you to load the item with the
variant rule check when you expand the structure.
A01000/A A02000/A
Unique options
The arrangement of variant BOMs always depends closely on the product type. The
structure of the BOM also influences your approach to variant management, for
example, the modularity of the structure with respect to the options and structure
reuse in other products.
• You revise the dashboard assembly and to add a new component P25 -
Stereo-Cassette and the appropriate variant condition. You also remove
component P30 - Blank Plate.
• Remove the redundant variant condition from the occurrence of P085 - Wing
With Hole.
• Optionally, modify the variant conditions on the aerials. This modification is not
essential and the audio system still behaves correctly if the change is not made.
Sharing structure
Classic variants supports sharing of variant structures between products.
For example, a dashboard assembly is used in two different products Car Model
G and Car Model H, as shown in the following figure. Because the dashboard
assembly is shared between products, you should place options that control variants
of the assembly (for example, radio) on the assembly item and not higher up the
structure. The radio option must have the entire range of values that are allowed in
all products in which the assembly is used, that is, mono, stereo, stereo-cassette
and stereo-CD.
Teamcenter applies a variant rule check to each product, preventing you from
specifying a variant rule for the radio option that is not allowed within the product,
for example, stereo-cassette for Car Model G and stereo-CD for Car Model H.
You must revise the dashboard assembly item, if the relevant parts are released and
locked to add the extra allowed values to the option. You can change the structure at
the same time to add the new variational components.
Shared Structure Car model H (A02000) is now produced with a different choice
of radios to Car Model G (A01000). A variant rule check is
car type = GLX, GIS, LS put on the owning product to limit the choice of values.
engine = 1200, 1600
gearbox = manual, automatic
fog lights = yes, no
A01000/A A02000/A
Total set of allowed values (across all
products the dashboard assy is used in).
Load IF radio = Stereo-CD
radio = Mono, Stereo, Stereo-Cassette, Stereo-CD
Dashboard
Load IF radio = Stereo-Cassette Assembly
Load IF car type = GLX
A020/C OR car type = GIS
Load IF radio = Stereo
Shared structure
You can construct the following variant condition in the Variant Condition dialog
box to define this requirement:
fog lights = yes
AND car type = GLX
OR car type = GLS
When you have built this basic condition, select the GLX and GLS lines and click the
(..) button. Teamcenter places brackets around the selected clauses, as follows:
fog lights = yes
To remove the brackets, select the range of lines between the opening and the closing
brackets (including the intervening lines) and click (..) again.
Car Model G
A01000/A
Derived Default:
IF car type = GLX, radio = stereo
• If the customer chooses one of the radio options, Teamcenter configures the wing
with the hole (for an aerial), and the standard aerial or the electric aerial.
• If the customer does not specify a particular type of aerial, the standard aerial is
fitted. This is the fixed default.
• If the customer specifies car type GLX, Teamcenter configures a stereo radio.
This is the derived default.
The radio option is stored on the dashboard assembly for later use in another
product, Car Model H.
Derived Default
Options & Allowed Values Derived Default:
IF car type = GLX, radio = stereo
car type = GLX, GLS, LS
engine = 1200, 1600
gearbox = manual, automatic
fog lights = yes, no Variant Rule Checks
Warning: "Incompatible Engine & Gearbox"
IF engine = 1200 AND gearbox = automatic
Fixed Default
fog lights = no
aerial = standard Car Model G
Create options
Define the options of the structure, as follows. The examples refer to the structure of
A01000 - Car Model G, as described in Populating variant data.
1. Choose View→Show/Hide Data Panel or click the Show/Hide Data Panel
button on the toolbar.
Teamcenter opens the data pane.
2. Click the Variants tab and select the line representing the owning item revision
that stores the variant data. Typically this is the top-level item in the structure,
in this example, A01000 - Car Model G.
4. In the Option dialog box, enter the necessary options, for example:
• In the Name box, type engine.
• Type an allowed value (1200) and press Enter or + (plus). Teamcenter now
displays the allowed value 1200 in the list of allowed values.
5. Click Create to create the option. A + (plus) symbol appears against the
Options branch in the variant data tree indicating that Teamcenter created
the options.
6. Repeat steps 4 and 5 to define the other options on the same assembly, for
example:
7. Repeat steps 2 through 6 to define the options on other assemblies, for example,
the following body and dashboard assemblies:
8. Click Save to save the changes. If you forget to do this, Teamcenter prompts
when you select another BOM line. A Y appears in the Has Variant Data (HVD)
column for Car Model G.
2. Click the Variants tab and select the structure line with the item revision that
owns (stores) the option whose values you want to change. If you are unsure of
the owning item, you can identify this from the Variant Rule dialog box.
• Select the value and click – (minus button) to remove an allowed value
from an option.
6. Click Modify and Teamcenter updates the contents of the selected option.
2. Click the Variants tab and select the option to copy in the Options branch of
the variant data tree.
Teamcenter displays the Option dialog box, prepopulated with the values and
name of the original option.
3. In the Option dialog box, type a new name for the option (duplicate names within
an item are not allowed) and modify the values as required.
Rename an option
1. If necessary, choose View→Show/Hide Data Panel or click the Show/Hide Data
Panel button on the toolbar.
Teamcenter opens the data pane.
2. Click the Variants tab and select the option to rename in the Options branch of
the variant data tree.
Remove an option
To remove an option from its owning item revision:
1. If necessary, choose View→Show/Hide Data Panel or click the Show/Hide Data
Panel button on the toolbar.
Teamcenter opens the data pane.
2. Click the Variants tab and select the option to remove in the Options branch of
the variant data tree.
Deleting an option
When you delete (remove) an option, you remove it only from the item revision.
When you remove the option from the last item revision that owns it, you are (in
effect) deleting the option.
• You cannot remove an option from an item revision that is released or to which
you do not have write access.
• You cannot delete an option that is used in a variant condition. If you attempt
to do this, Teamcenter displays an error message that lists all the BOM view
revisions that have occurrences with variant conditions referencing that option.
2. Select the structure line for the option for which you want to create variant
conditions, for example, P060 - Cigar Lighter.
• Replace
• Insert
• Append
• Clear
Note You can type in an option name that is not loaded. If the option name
is not unique, the owning item is not populated. You must populate it
by clicking the list of values in the Item box and selecting the one you
require. If you forget to do this, Teamcenter displays an error message
when you click the list of values when trying to enter a value for the
option.
Note If you use >, > = , <, or < = operators, the values of the associated option
must be numeric and only decimal values are permitted.
Not (!) is higher than AND (&); AND (&) higher than OR (|). That is,
A OR B AND A = A OR (B AND A).
7. Select List of Values to display the allowed values for the radio option and click
the required value.
9. Click OR.
Teamcenter constructs a variant condition from the defined clauses joined by
AND and OR operators.
For more information, see Configuring complex variant conditions.
10. Enter the value of another option, for example, GLX, and click Return or
Append .
Teamcenter displays the second clause in the list in the upper part of the dialog
box.
Note If you are only specify one clause (for example, radio = mono) in a
condition, you can set the AND switch or the OR switch.
2. Select the clause before which you want to insert the new clause.
3. Click Insert .
Teamcenter inserts the new clause above the selected clause.
Replace a clause
Replacing a clause can be very useful with large compound conditions containing
many clauses because this action does not change the order. Preserving clause order
maintains the algebra and makes scanning for occurrences with similar conditions
easier.
1. Specify the replacement clause.
3. Click Replace .
Teamcenter replaces the original clause with the new one.
Copy a clause
1. Select the clause to copy and click Copy . You can also double-click the
clause. This action copies the option name, value, and operator setting to the
boxes and sets the And / Or button in the lower part of the dialog box.
2. Edit the value and/or operator, set the appropriate AND or OR button, and
append the clause.
3. Select an existing clause and click Replace to replace the existing clause.
You can also click Insert to place the clause above the selected clause.
Note You can use Copy in conjunction with Replace, as a convenient way to edit
variant conditions.
Remove a clause
Move a clause
To change the position of a clause within a condition, select the clause and click
Up or Down .
You can move multiple clauses in a single operation by selecting a range of clauses
before clicking the appropriate arrow button.
Group a clause
You can change the grouping of clauses by adding and removing brackets, as follows:
Note Teamcenter supports multiple levels of grouping.
To add brackets around a range of clauses, select the range of clauses and click (…).
To remove brackets from around a range of clauses, select the range of clauses,
including the lines that contain both the opening and closing brackets, and click (…).
2. In the shortcut menu, choose Copy or press the Ctrl+C shortcut keys.
Teamcenter copies the contents of the occurrence to the clipboard.
3. Move the cursor over the Variant Condition cell on the target line to which you
want to copy the variant condition and right-click to display the structure line
shortcut menu.
Note The Variant Condition property is used with the old variant model. This
action is not available with the new variant model.
4. In the shortcut menu, choose Paste Property. (There are no shortcut keys; you
cannot use Ctrl+V.)
8. Select the structure line for the electric aerial and click OK in the Variant Rule
dialog box.
Teamcenter adds the newly defined condition to the occurrence for the electric
aerial.
2. Select all of the clauses in the Variant Condition dialog box and click Delete
to remove all the clauses.
3. Click OK to apply the change to the occurrence (that is, effectively remove the
variant condition).
Teamcenter only sets default values if the item to which the default is attached
is loaded.
Teamcenter clears the value of the option and changes the state of the option
to Unset.
Note If the option has a default value, it returns to that default, allowing you
to easily return to the default value after you have overridden it.
2. Select the gearbox option and set it to automatic. Teamcenter displays the
following error message:
Incompatible engine and gearbox IF engine = 1200 AND gearbox = automatic
Teamcenter displays the Variant Rule dialog box. The dialog box contains the
Load, Reload, Save, and Save As buttons that allow you to store and retrieve
variant rules.
4. Click OK.
Teamcenter displays the name of the variant rule in the title bar of the Variant
Rule dialog box, indicating it is the current variant rule.
• The top of the dialog box includes a box in which you specify the variant rule
to load. It also has an Open by Name button that allows you to search for
any variant rule saved in the database by its name.
• The middle section displays a list of the variant rules attached to the
top-level item revision of the structure open in the current window.
• The lower section displays the details (options and values) of the variant rule
to load (this is the rule specified in the box at the top of the dialog box).
You can use this information to preview the rule and ensure it is the rule
you want to apply.
2. In the dialog box, select the required variant rule in the list, or search for it by
clicking the Open by Name button.
Teamcenter shows the name of the selected variant rule in the box at the top
of the dialog box.
3. Choose how the new variant rule should affect any existing option values that
you have set, as follows:
• Set Override and all options not defined by the loaded rule are unset.
• Set Update and only the values of those options listed in the rule are changes.
All other options remain in the same state as before you loaded the rule. This
allows you to form a complete variant by loading a number of partial rules.
4. Click OK.
Teamcenter displays the name of the loaded variant rule in the Variant Rule
dialog box title bar and sets the options are set accordingly. The State column
in the properties table contains Set by rule-name, allowing you to identify how
these values are set.
3. Select the line representing the owning item revision on which you want to store
the variant data, for example, Car Model G.
5. In the Warning Text box of the dialog box, enter an error message, for example,
Incompatible engine and gearbox.
6. Define the relevant variant condition, for example, engine = 1200 AND gearbox
= automatic.
7. Click Create .
Teamcenter creates the rule check.
8. Expand the Rule Check branch and verify the new rule check is added below
any that already existed, for example:
ERROR Incompatible engine and gearbox IF engine = 1200 AND gearbox = automatic
9. If you need to change the rule check, select it in the Rule Check branch of the
variant data tree. Teamcenter displays the Rule Check dialog box, allowing
you to change any of the boxes.
2. In the dialog box, click Delete and the selected rule check disappears.
• Derived
A derived default is a value that is set to a value that depends on a condition. In
the example, the option radio has a value set to stereo if car type = GLX.
Defaults are owned by an item revision, like other variant data. Use the Variant
Rule dialog box to identify the item a default was set on and whether the default
is fixed or derived.
You can identify if an item has variant data attached by viewing the HVD - Has
Variant Data column in the structure properties table.
You can override option values or reinstate them as necessary.
If you set conflicting derived default values for the same option in a structure,
Teamcenter displays an error message when you attempt to save the option default
or set the option value in the variant rule that causes the conflicting derived default
to apply. The error may also appear when you expand the structure to the point that
the conflicting derived default is loaded.
3. Select the line representing the owning item revision that stores the variant
data, for example, Body Assy.
5. In the dialog box, enter the name of the option in the Option box and select a
value from the list of possible values. For example, enter aerial in the Option box
and choose aerial from the list of values.
Note The list of values contains only options that are loaded in Structure
Manager.
You can type in the name of an option name that is not loaded. If the option
name is not unique, Teamcenter displays an error when you try to enter a value.
You must specify an owning item.
6. Enter a value in the Value box, for example, standard. You do not specify a
condition for a fixed option default, so the lower part of the dialog box is not used.
7. Click Create to create the option default. Click List of Values and click standard.
8. Expand the Option Default branch and verify the new option default is added
below any that already existed, for example:
DEFAULT aerial TO standard
9. Repeat steps 4 through 8 to define any other fixed defaults, for example, fog
lights = no.
3. Enter the name of the option in the Option box, for example, radio.
4. Enter the value of the option in the Value box, for example, stereo.
7. Expand the Option Default branch and verify the option default is added below
any that already existed, for example:
SET radio TO stereo IF car type = GLX
2. In the dialog box, click Delete and the selected option default disappears.
• Refresh
To reload the variant data on the item revision for the currently selected line,
click the Refresh button in the Variants pane. This action discards changes
made since the last time you clicked Save , and loads any changes made by
other users in the meantime.
• Save As
If you select an item revision and choose Save As, option and variant data on
the first level of the structure does not carry forward because the BVR context
changes. At the second and subsequent levels of the structure, the BVR context
is the same, and options and variant conditions are therefore carried forward.
• Copy
When you copy an item or item revision, any variant conditions are not copied.
For more information, see Copy variant conditions to other occurrences.
variants. For detailed procedures for creating and maintaining variant items, see
Creating and searching for variant items.
In many structures that are configured with classic variants, you define all options
on the top-level item. This has the advantage of transparency—if all options are
defined at the top level and sound business practices ensure consistency, the user
can easily ensure the configuration is complete. When you configure the options,
you determine the configuration state of all variants throughout the structure, so
ensuring that a variant item is a completely configured structure.
The following figure shows a typical structure of an engine.
Engine Family
Mainstream Module
V6 Long Crank Fly Wheel Engine Mount Long Block Short Block
Structure of engine
You can define options on the top-level Engine Family item as follows:
Option Value
ENG V6L, V6S
TRANS M10, M50
These options determine the configuration of the lower levels of the structure
through variant conditions, as shown in the following figure.
Mainstream Module
V6 Long Crank Fly Wheel Engine Mount Long Block Short Block
ENG V6L
TRANS M10
Mainstream Module
V6 Long Crank Fly Wheel Engine Mount Long Block Short Block
ENG V6L
V6 Long Crank Fly Wheel Engine Mount Long Block Short Block
Because the variant item only prunes the immediate children that are unconfigured,
the Short Block item still exists in the resulting structure, but as an unconfigured
item. It may seem advantageous to permanently remove the Short Block item,
so that you can manage and export a minimal structure. However, this action
permanently removes Short Block from Cylinder block, an item that still
appears in the generic Mainstream Module. Because the Short Block item is
still applicable in different configurations of Mainstream Module, removal is not
an appropriate action.
Another possible course of action is to create variant items at every level of the
structure, or at least down to the lowest level that has any variant conditions. For
example, you could create variant items for the Crankcase and Cylinder Block
items, as shown in the following figure.
Engine EPL
Option Value
VI For Engine
ENG V6L
TRANS M10
V6 Long Crank Fly Wheel Engine Mount Long Block Short Block
16 Configuring structures by
modular variants
16 Configuring structures by
modular variants
Before you can use modular variants, your Teamcenter administrator must complete
the configuration steps and set certain preferences, as described in Configuring
modular variants.
The structure of the door assembly and its associated options is modelled as follows.
In the case of the refrigerator freezer module itself, the customer chooses from the
public options made available at that level, for example, appliance width, appliance
height, freezer at the top or bottom, number of shelves, and so on.
There may also be some internal options that are not set by the user, but are set
according to the values of the public options. For example, the height of the door is
set according to the appliance height, allowing for two doors, a 50 mm floor panel,
and an LED display at the top. To allow for this, you create a private (hidden) option
called Door Height on the refrigerator freezer module) that is controlled by the
public option Appliance Height as follows:
Door Height = (Appliance Height/2)-50mm
The Door Height option on the refrigerator freezer module is used to automatically
set the Door Height option on the door module. You need not know this relationship,
simply enter the overall height of the appliance.
You could use the same principle to define private options for all the assemblies of
the refrigerator freezer and bring them together only in the top-level assembly.
• Options in the parent module can set options in the child module.
FR-A1000
Refrigerator
Freezer
Top Bottom
Key
Variant data
Presented
Presented option option
Public option
Child module
Private option constraint
Presenting options
Presenting options
You can configure the same module differently, depending on where it is located.
Options can be presented to a parent module from a child module to make them
visible as though they were part of the public interface for the parent module. For
example, the Number of shelves option is presented up from the carcass module
to the refrigerator freezer module, allowing you to choose the value at the parent
level. You could also use the present method if you want to set options for different
occurrences of the same module to different values, depending on their location.
You could place the door module in a refrigerator freezer assembly with this method.
In this example, the same door module is used twice, once as a freezer door and once
as a refrigerator door. The options created previously control the components of each
door and the doors have different components due to their different functions. You
can name each occurrence of the door appropriately, for example, top and bottom.
You then present the Application option (with possible values refrigerator and
freezer) for each door to the parent refrigerator freezer module. This gives two
options to set in the refrigerator freezer module, one for each door; you can set these
to different values.
• You can only link options from the parent module to public options in the child
module, although the option in the parent module can be public or private.
Variant items are physical parts with no variability, and can be allocated an
actual manufacturing part number. Conversely, modules cannot be manufactured.
Modules with a large number of options and numeric options (with an infinite
range unless allowed values are specified) have a correspondingly large number of
permutations; not all of these permutations are manufactured. It is useful to be able
to reuse permutations that have previously been sold, as significant engineering
work may have been invested in creating technical documentation, drawings, and
manufacturing data that is attached to the variant items.
The modular variants functionality allows you to create new variant items when
they are required. You can also search for existing variant items to reuse in
new products. Variant items are built up into a complete structure for a specific
configuration corresponding to a product or customer order; in this structure all
modules are replaced by specific variant items.
If you are using NX, you can use the option values on variant items to determine the
expression values on an NX CAD part.
Caution If a module has variant items linked to it, you cannot change any of the
variant data without revising the module. Such changes may invalidate
existing variant items linked to the module revision. Disallowed changes
include:
• Removing or adding an allowed option value.
If you want to make any of these changes, you must first revise the
module.
You cannot update existing variant items linked to previous module
revisions. You can create a new variant item, but Teamcenter then
contains two different IDs for variant items that have the same
configuration and share the same stored option set (SOS) values; this
arrangement does not adequately enforce modularity. The new variant
item may also contain additional components and, if so, it would not be
appropriate to update the existing variant item.
Note The options you can use in the variant condition are limited to the public and
private options on the parent module. This limitation enforces modularity.
Defining options
Teamcenter allows you to create several different option types. You define options
in standard variants only and string values are available. The following variant
types are provided:
• String
• Integer
• Real
You can use the =, >, <, >=, =< and to operators with real and integer options, both
in the allowed values for an option and in variant conditions and constraints. For
example, you can set the door width option to a range of values, such as 400 to 700.
This allows the user to set any value within the range , although there are discrete
values allowed for standardization (500 and 600 only).
To define a global option, add the item ID that contains the global option definition
to the PSM_global_option_item_ids preference. This preference lists the IDs of all
items that contain global options, for example:
PSM_global_option_item_ids=
000400
000410
000420
These definitions can then be reused when authoring variant modules. In Structure
Manager, you can drop these global options into the module for which they are
required.
To add items to the list of IDs, in Structure Manager, select an item and choose
Tools®Variants®Set/Unset Global Option Item.
An external option is typically defined on the top-level module in the structure. Its
allowed values are the same as those on the option that references it. In addition,
the value set for the external option on the top-level module in the variant rule is
propagated to all options that reference the external option.
The following figure shows an extension of the refrigerator freezer example that
illustrates this concept.
FR-A1000
Refrigerator
Freezer
Top Bottom
Key
Variant data
Presented
Presented option option
Public option
Child module
Private option constraint
Create an item called GO-5000 to define global options. This item is a standalone
module and contains three global options for color, width and voltage. Each such
global option is specified with standard allowed values.
The color global option is used in the refrigerator freezer and door assembly modules
so that the allowed values are controlled from the color master global option in
the GO-5000 module. To set the actual value configured for the unit color on the
door module for some variant of the product, you must create a link between the
unit color option in the refrigerator freezer and the option in the door assembly, as
shown in the previous figure.
The appliance width external option is created in the refrigerator freezer module. It
is used by the door width option in the door assembly module and by the carcass
width option in the carcass module. Typically, the external option would reference a
global option, but this is not mandatory. In this case, the value set for the appliance
width for any variant of the refrigerator freezer is automatically propagated to the
options that use it lower in the structure (namely door width and carcass width),
without needing to create a link.
In the refrigerator freezer example, for some models, the freezer may always be at
the bottom and the refrigerator at the top. In this case, the value for the application
option would be fixed for each path in the refrigerator freezer module.
Note When using a global option definition, you can override a default set in the
global definition in the module in which the global option definition is used.
• Warning
Teamcenter displays the warning message, but the user may set the combination
specified.
• Information
Teamcenter displays the information message, and the user may set the
combination specified.
Note Create error checks at the appropriate module, typically at the top level.
Do not create them on global items.
Configuring a structure
When you have defined the option modules, configure the structure to simulate
the choices that the end user or customer is offered. This process ensures that the
structure is correctly and completely configured. The end user or customer can only
set values for options on the product itself; for example, for the refrigerator freezer;
they cannot set options in lower level modules.
Before doing this, you must design all the lower level modules (door assembly, door,
carcass and so on) such that they are completely configured by whatever combination
of options is set in the refrigerator freezer module. You should do this following the
methods previously described, namely:
• Options from the child module should be presented up to the parent module.
• Options in the parent module may set options in the child module.
An example of variant data for the refrigerator freezer discussed previously is shown
in Using modular variants.
Tip Use the PSE_show_option_item_prefix preference to show or hide
the owning item ID as a prefix to the option name. For details, see the
Preferences and Environment Variables Reference.
o Private options cannot be set by the user and are not displayed when
configuring a module. Private options are set from public options by
constraints.
• Choose a type for the option from the dropdown list, String with default,
Real/Integer or Logical. If you choose String, you must enter the allowed values
in the Allowed Values box.
2. Enter a name. You do not need to use the same name as the referenced external
option.
3. For option type, select The same type and restrictions as an existing option.
5. In the next window, enter the item name (not item ID) of the module on which
the external option is defined and click Next. You can use wildcards (*) to search
for all modules in the database, not only those defined as global options. Select
the option you require, as shown in the following example.
6. In the next window, select the Use option as an external option check box and
click Next.
This completes the definition of the new option, and you can now view it in the
Variants pane, as follows.
module, which have their paths labeled in the Occurrence Name structure line
property as Top and Bottom. Each path in the Door Assembly module is
presented separately, allowing you to configure each occurrence differently.
You cannot set a default value for the presenting option. Any default is inherited
from the master, that is, the lowest level module from which the option is presented.
If you change the default on the master, Teamcenter propagates the change to all the
levels to which the option is presented.
To present a child option:
1. In the product structure, select the parent module to which you want to present
the child option and click the Create Presented Option button.
Teamcenter displays the Present Options dialog box, as shown in the following
figure:
• In the Select Options list, select the option to present or check the Select
all check box to present all options.
• In the Select paths list, select the path to present from (or paths if there are
many occurrences). By default, the Select none check box is checked and
you should clear this if appropriate.
• When you have made the appropriate selections, as shown in the previous
figure, click OK.
Teamcenter displays the result in the data pane, as shown in the following
figure.
o Error
If an error condition occurs, Teamcenter displays an error message and
the user may not configure the specified combination.
o Warning
If a warning condition occurs, Teamcenter displays a warning message
and the user may set the specified combination.
o Information
If an information condition occurs, Teamcenter displays an information
message and the user may set the specified combination.
• In the Message box, enter the text of the message you want Teamcenter to
display.
• In the Condition box, specify the combination of option values that triggers
the error check, from options on the parent module only.
3. When you have made the appropriate selections, as shown in the previous
figure, click OK.
Teamcenter displays the result in the data pane, as shown in the following figure.
• To set a default option value. The user can override this value when configuring
the structure. In this case, there is no condition on other option values and
Teamcenter sets a value.
• To set fixed (hard-wired) option values that the user cannot override when
configuring the structure. As before, if there is no condition on other option
values, Teamcenter sets a value.
In the refrigerator freezer example, you use a module constraint to set the Door
Height private option in the Fridge Freezer module according to the Appliance
• Choose an option in the Option list and choose its value in the To Value.
When you do this, you set the option—in this case, the private option, unless
you set a value with no condition.
• In the Condition box, specify the constraint condition of the public option
that is setting the private option.
3. When you have made the appropriate selections, click OK or Apply. If you click
Apply, the Constraints dialog box remains displayed and you can create other
constraints.
Caution Do not click OK and Apply or you will create two identical constraints.
4. Repeat steps 1 through 3 for each public/private option value combination that
must be mapped.
1. Select the child module and click the Child Constraint button.
Teamcenter displays the Constraints dialog box.
• Set the child option. You can display a list of public options for all child
modules using the list.
• Select whether to map individual values or all the options. The following
figure shows how to map all the options, by clicking the or to option button.
This is the most common approach to setting child module options.
Teamcenter does not detect if the options have different allowed values.
However, if the options are of different types, Teamcenter detects and
prevents you setting such values.
• Map specific option values to a specific option value in the child and set
the conditions as required.
A Constraints dialog box with this information fully entered is shown next.
3. Click the Apply button and repeat step 2 if you want to create several child
module constraints. Alternatively, if you only want to create a single child
module constraint, click OK.
Caution Do not click OK after clicking Apply because this creates two
identical constraints.
• To edit a selected option or constraint, click the Edit button or double-click the
line in the data pane.
1. Select the row in the data pane that represents the constraint or option.
• Display the Variant Conditions column in the structure properties table and
double-click the relevant cell.
Teamcenter displays the Variant Condition dialog box, as shown in the following
figure.
Condition statements
You can copy existing variant conditions to reuse as follows:
2. Right-click the structure line to copy the variant condition onto and choose Paste
Property. If you select more than one line, the variant conditions apply to all
the selected lines.
Note If you have existing legacy variant conditions, you can edit them by clicking
the Edit Legacy button.
Complex constraints
3. Edit the MVL expression as appropriate. You can use many mathematical
operators, as described in Developing complex expressions with MVL.
Caution If you edit an expression in expert mode in this way, Teamcenter
marks the module as an Expert module. You can no longer maintain
the module with the basic user interface.
You can view the MVL of existing variant data for examples of the required
syntax. An example of how to use mathematical operators with options follows:
set 002504:’Door Height’ to 002504:’Appliance Height’/2*002504:
’Clearance’-002504:@Offset’
In this example, ’Clearance’ and ’Offset’ are private options you created to
store a variable for use in this logic.
If a name or identifier includes spaces or special characters (for example, - ),
you must embed them in quotation marks, for example: set ’MV-2504’:’Door
Height’.
To identify the available entries at any point in the expression, Teamcenter
utilizes Intellisense™. When you create or edit the expression, Teamcenter
displays a list of available entries. Select an entry with the mouse or the up and
down arrow keys, then press Enter to put the entry into the expression.
For more details of how to edit MVL expressions, see Developing complex
expressions with MVL.
Teamcenter expects each statement to contain these elements in the order listed.
When you use the Internal module constraints dialog box and the Child module
constraints dialog box to construct constraints or error checks, respectively,
Teamcenter arranges the MVL elements into the required order. However, if you
develop statements in the MVL editor and enter the elements in an incorrect order,
Teamcenter does not rearrange them. No error or warning messages are displayed,
but the variant structure may not be configured correctly.
Similarly, if your MVL statements contain comments, Teamcenter may not rearrange
the elements into the required order.
Also, internal and child constraints are evaluated in the following order, where 1 has
the lowest priority and 7 the highest:
1. Default
2. User set
3. Set
4. User fix
5. Fix
6. External
7. Variant item
For example, a user set takes precedence over the default value of an option for a
given type of constraint.
• White space is ignored, except when contained inside single or double quotation
marks.
• Single and double quotation marks have semantically different meanings. Single
quotation marks are required for some identifiers (IDs) and double quotes are
used for string literals.
• Text appearing inside square brackets is optional. However, if the ‘[’ and ‘]’
characters appear inside single quotes, you should type them.
• Words that are in monospaced font are keywords and should be typed exactly
as shown.
• Words in italicized font are primitives, and the most common ones follow.
PathName front
• A string enclosed in single
quotation marks and
containing any symbols.
Inside the single quotes, you
can use the \ character to
escape a single quotation
mark, and itself.
false
Reserved words
Reserved symbols
Cursor Possible
position selections Comments
1 Start of the set, fix, if, warn, Variant conditions (as
expression error, inform opposed to defining
constraints) do not have
possible selections. These
must be logical expressions
that decide whether the
selected structure line is
loaded.
Go to line 2 of this table.
2 Where an option Module interface This selection includes all
selection is options of current module
required and public options of directly
included child modules.
If an option is being
presented as a possible
value, only options having
the same type as the required
value are displayed.
If the option directly follows
set or fix then go to line 3
of this table, otherwise go to
line 5 (in this case, option
selected is a value).
Cursor Possible
position selections Comments
3 set or fix to If you selected the option
following by an rather than typing it, to
option appears automatically and
you do not need to make this
selection.
Go to line 4 of this table.
4 When a value Valid value If the option requiring a
selection is value is an enumeration, a
required list of allowable values is
shown.
If the option is logical, true
and false is shown.
A value may also be another
option of the same type from
the module interface (see
line 2).
You must type strings and
numbers manually in double
quotes.
Go to line 5.
5 After value Appropriate operator If the expression already
or expression end contains a comparison
operator, and and or are
shown. If you select one of
these, go to line 2.
If the value is numeric +, -, *,
and / are shown. If you select
one of these, go to line 4.
If the value follows if and
precedes a comparison
operator, = and !=, as well as
<, <=, >, and >= if the value
is numeric. If you select one
of these, go to line 4.
If you are building a
constraint and the value
follows both an if and a
comparison operator, then
is also shown. If you select
this, go to line 6.
If the constraint also
contains then, else, else if,
and endif are also shown.
If you select else, go to line
Cursor Possible
position selections Comments
6. If you select else, go to
line 2. If you select endif,
Teamcenter disables all
buttons other than OK and
Cancel.
If you are building a variant
condition and the value
follows both if and a
comparison operator,
endif is also shown. If
you select this, Teamcenter
halts interactive expression
building.
6 After then in a set, fix, error, If you select set or fix, go to
derived default warning, info line 2, otherwise go to line 7.
7 After error, None. You must type Teamcenter creates single
warning, or the message text. quotes (open and close) and
info places the cursor between
them. You can place the
cursor to the right of the
closing quote to make else,
else if, and endif available
as selections (see line 5).
Give the first of the I0320 lines the name front and the second one rear. Do this by
modifying the bl_occ_occurrence_name occurrence name property. You should
then add the following option declarations.
Public options
Defaults are set for all the options and the dialog box contains the default values.
However, users can override (set) the default values if they are not fixed defaults
when you toggle Set/fix to Set. This prevents any subsequent programmatic set or
fix of the option by MVL from overriding the value set by user.
2. Set the following option values to configure the structure. You can place the
cursor over the Value cell to display a tool tip containing further information
about the required option value as follows.
• Public or private
• Option name
• Allowed values
Or
public ’002547 Number of shelves’ presents 002547: ’Number of shelves’
Public ’Number of shelves’ integer = 1, 2, 3, 0 default 3
If you want to restore the original, default settings, click the Default button.
Note In production use, you would not configure the structure for a lower level
module. However, you may want to do this when debugging, to check that
all options are set in the lower level modules when the top-level module
is completely set (this verifies all options have a value). To do this, set
Tools→Variants→Only Configure Root to off.
For general use, set Tools→Variants→Only Configure Root to on; the
Configuration dialog box only displays options for the top-level module,
regardless of the structure line selected.
• You select values for numeric (real and integer) options manually as a single
value or a range. To see the allowed range or values, place the cursor over the
option and Teamcenter displays a detailed tool tip.
The Configure dialog box contains a table of options and any default values set.
Options that do not have a default value are blank. The features of the Configure
dialog box that you can use to select option values are as follows.
Feature Description
Heading Identifies and names the module to configure.
Option Lists public and legacy options for the selected module.
Value Opens a dialog box containing default values for options.
OK Configures the structure and closes the dialog box.
Apply Configures the structure and does not close the dialog box.
Load Opens a dialog box that enables you to retrieve a saved
configuration.
Save Opens a dialog box that allows you to save the current
configuration.
VI Opens a variant item search dialog box with values set.
Default Resets the configuration with option default values.
Clear Clears all configuration values.
Cancel Closes the dialog box without applying configuration.
Display only public Shows configuration of private options. You cannot set
options them here.
Configuration Displays the configuration status.
2. Select each lower level module in the structure, then click the Variant Rule
button on the toolbar or choose Tools→Variants→Configure.
In each case, Teamcenter displays the Configuration dialog box, allowing you to
confirm all the option values are set. The Configuration dialog box is updated
dynamically and it is not necessary to redisplay it each time you select a new
module.
3. If all lower level modules are not completely configured, define further
constraints in the higher level modules or present lower level options to the
top-level module, as required.
2. In the dialog box, enter a name for the saved configuration, for example,
1200x500 Top Fridge.
• Click No to omit any option values not defined in the loaded configuration as
they are currently set.
Caution You cannot load variants of modular variant assemblies from NX; you
can only load legacy data.
2. The salesman searches for variant items for each module to see if they exist.
This is an iterative process-creating variant items and changing values on the
SOS until a complete structure of variant items is created. The customer may
want to modify the original SOS due to variant items that are available and
satisfactory, but did not match the original specification.
Note You cannot push values for lower level saved option sets up to higher
levels.
3. When a complete set of variant items are located, the salesman confirms the
top-level SOS option values are correct and verifies the configuration with the
customer order.
4. The salesman creates a variant item for the top level by saving the generic item
with a unique customer name and prunes unconfigured structure lines. The
children that are modules are still generic.
5. Edit the structure by substituting the generic modules with the variant item
that works for the SOS at the top level.
• Create a new variant item if no existing variant item is found. You should create
new variant item at the lowest possible level of the structure.
After creating a variant item from a generic structure, you cannot make any
structure changes to the BOM view revisions of the generic item revision or the
variant item revision. Such changes make both the generic structure and the
variant item structure invalid. To make any such structural change, revise the
generic structure and then make changes to the new revision. These changes are not
reflected in previously linked variant items automatically; you must search for the
affected variant items and update them individually with the changes.
You cannot make structural changes to the generic item when it is linked to a variant
item, including adding or removing a line, and creating a relation. Likewise, you
can change the item revision master form attributes on the variant item, but cannot
make structural changes. If you make changes to the master form attributes, you
should search for other variant items that should be updated. For more information
about updating a variant item, see Update a variant item.
Before starting this process, ensure you have created a variant item for the top
level, as described in Create a new variant item. Typically, this has a completely
defined saved option set with a value or a range of values specified for all options.
Alternatively, you can start with an incomplete saved option set and use an iterative
process to populate the lower level generic items. You should replace all the generic
items with variant items.
Note You can automatically create variant items for an entire generic structure,
as described in Create variant items automatically.
Likewise, relationships such as Connected To are carried forward from the
generic component to the variant item.
If the query is successful, the identifiers and names of variant items whose values
match the search criteria populate the list next to the Search button.
The search only finds linked variant items—unlinked variant items may have
structure changes and would therefore not be applicable.
If the variant item search is successful, Teamcenter loads the first variant item
returned by the query and shows its values in the Value Found column. If you select
a different variant item from the list, Teamcenter loads it and updates the Value
Found column. You can then click the Replace button to replace the selected item
with the variant item.
1. Ensure you specify a single value for each option and each requirement (that is,
do not enter ranges or multiple selections), and then click New.
Teamcenter displays the New Variant Item dialog box. (This dialog box is similar
to the New Item dialog box but includes an additional tab that shows the
configuration values.)
2. Optionally, click Default to clear the table and populate the requirements with
option defaults.
3. Optionally, click Replace to define the new variant item as a replacement for the
selected generic item.
4. Click Apply to configure the structure with the selected variant item.
In this example, all the options and values are unavailable (grayed out) because you
cannot modify them for a variant item.
The following example shows a structure in which all the generic modules are not
yet replaced with variant items; for example, the cooling system and carcass. The
variant structure is complete only when you replace these generic modules with
variant items.
Variant items are identified by a gray image with a red check mark ( ); generic
modules are identified by a gray image without the red check mark .
You can add the Generic Item property as a column in the properties table in the
structure. Use this column to see the generic item to which a variant item is linked.
For details of how to add a property as a column in the properties table, see
Displaying properties.
You can create a fully instantiated structure by manually searching for generic items
and substituting a variant item for each such generic item, as described previously.
However, this process is time-consuming if your structure is large and complex. In
this case, consider creating variant item structures automatically as follows.
Note Item IDs are generated automatically, according to the naming rule
for the item type of the generic structure; however, if you set the
PSEAutoViNewItemPopup preference to True, you are prompted for an
item ID during the creation process. If you set this preference to False,
no prompts are displayed.
If you configure automatic creation, you can set a prefix for the name with
the PSEAutoViNamePrefix preference.
Note Beginning with Teamcenter 10, the order in which variant items are
automatically created is changed. Prior to Teamcenter 10, lines were
processed according to their position or appearance with respect to the top
line. Consequently, children of the first subassembly under the top line
were processed before the second subassembly. This is referred to as the
depth-first-search method. After Teamcenter 10, lines are processed in
order of their level in the structure. For example, all subassemblies of an
equivalent level are processed together before any of their children. This is
referred to as the breadth-first-search method.
1. Load and select the generic structure for which you want to automatically
create variant items.
If you request a prompt for each item identifier, item revision identifier, and item
name, Teamcenter displays the New Variant Item dialog box each time and the
process pauses until you enter values in the dialog box and click Finish.
Note This prompt displays only if the PSEAutoViNewItemPopup
preference is set to ON.
• PSEAutoViStopVICreationForUnconfiguredModule
This preference determines if the automatic creation process stops as soon as it
encounters an item that is not a generic item. If set to False (off), the process
continues to the bottom of the generic structure, displaying warning messages
for each unconfigured generic item encountered. (This is the best practice for
most business environments.) If set to True (on), Teamcenter stops the process
when it encounters an unconfigured generic item.
• PSEAutoViNewItemPopup
This preference determines if Teamcenter prompts you for an item identifier,
item revision identifier and item name each time the automatic creation process
creates a variant item. If set to False (off), Teamcenter automatically assigns
values according to the predefined numbering and naming schemes. For example,
if you have a generic item called 00100/A Generic Wheel, Teamcenter may
create a generic item called 00200/A VI_Generic Wheel. If set to True (on),
Teamcenter prompts you for this information each time a variant item is created.
• PSEAutoViNamePrefix
If the PSEAutoViNewItemPopup preference is set to False (off), this
preference defines the naming scheme prefix that Teamcenter uses. For example,
if you set this preference to VI- and create a generic item called Wheel, the
name of the variant item is VI-Wheel.
• PSEBypassVISearch
Set this preference to true to add a Create button to the Configure dialog box as
soon as the user sets a value for each option. This allows the user to bypass the
requirement to search for similar variant item configurations before creating a
new variant item. The default setting is false.
• PSECreateVISameType
If you set this preference to true, Teamcenter always creates a variant item
with the same type as its parent and creates the variant item with a Save As
action. The default setting is false.
For more information about setting preferences, see the Preferences and Environment
Variables Reference.
At this point, there are no longer any variant items linked to the new generic item
revision. The changes made are not reflected automatically in any existing variant
items linked to previous generic item revisions. You must search for the affected
variant items and update them individually with the changes.
However, you cannot make structural changes to the generic item when it is linked
to a variant item, including adding or removing a line, and creating a relation.
You can change the item revision master form attributes on the variant item, but you
cannot make structural changes. If you make changes to the master form attributes,
you should search for other variant items that should be updated.
1. Load the structure, select the revised generic item, and choose
Tools→Variants→Update Variant Item.
Teamcenter displays the welcome window of the VI Update wizard.
You can load the structure with the generic item revision as the top-level line
or with the generic item at a lower level. If the generic item revision is not
the top-level line, you must set Tools→Variants→Only Configure Root to Off
before you can update variant items.
Note You cannot update variant items if only one item revision of the generic
item exists. You can only update variant items against the second and
subsequent item revisions of the generic item.
2. Select the previous item revision of the generic item whose variant items you
want to update and click Next.
The VI Update wizard shows the saved option set values against which you can
search for applicable variant items.
3. Choose the saved option set values against which you want to search for variant
items from the lists and click Next.
The VI Update wizard shows a list of variant items matching the chosen criteria.
Note If you leave any saved option set values blank, Teamcenter includes all
possible values in the search criteria. If you leave all saved option set
values blank, the results include all available variant items.
4. Select the variant items to update from the list of search results, and click
Update to create new variant item revisions that include the structure changes.
Teamcenter shows the Revise dialog box, allowing you to define a revision, name,
description and unit of measure for the new variant item revision.
To view a selected variant item revision before you update it, click Open.
5. After you define the new variant item revision and click Finish, Teamcenter
closes the Revise dialog box and updates the VI Update wizard with the new
variant item revision. The Update button is grayed out and you cannot make
further changes to the new variant item revision. To inspect the new variant
item revision, click the Open button.
6. If applicable, you can select another variant item revision from the list and
repeat the update procedure. Do this until all the necessary variant item
revisions are updated.
7. After you finish updating new variant item revisions, click Next and the VI
Update wizard allows you to select another generic item revision whose variant
item revisions require updating.
To update the variant item revisions of another generic item revision, select
the Do you want to update variant items for other revisions of the generic
component? check box and click Finish.
To exit without updating additional variant item revisions, click Finish without
selecting the check box.
Synchronizing with NX
You can use option values to drive NX part expression values from variant items.
For variant items, the option values are fixed and hence the geometry of the CAD
design also remains fixed. You cannot synchronize generic item modules with NX, as
the value may change each time a variant rule is specified.
To enable synchronization, choose the corresponding customer default in NX.
When you create a variant item, Teamcenter performs a Save As operation. For
correct synchronization with NX, use Business Modeler IDE to set your deep copy
rules for Save As on the appropriate item type so that Teamcenter copies the
UGMASTER dataset as an object, not as reference.
Set the Business Modeler IDE rules for deep copies so that, when you choose the
Save As command for an item revision, the following are copied as objects:
• UGMaster datasets
• UGPart datasets
• Altreps
To create JT files for modular piece parts and view them in Teamcenter, you must
create the corresponding variant items and persistently store the JT files for the
different geometry.
You can drive piece part geometry from an assembly using the options presented
to the assembly from the piece parts. To do this, set the value of the option on the
assembly, which sets the option on the piece part in the generic structure. You
then create a variant item for the assembly, which has an option and a value, and
the value is the same as for the assembly. You now create a variant item with the
corresponding option value, and substitute it into the assembly for the generic part.
There is now an implicit link through the variant item structure.
Note Creating a variant item of an assembly does not automatically create
variant items of the piece parts in the assembly. You must manually or
automatically create variant items throughout the structure, as described
in the previous paragraph.
The synchronization process matches the option and expression names, so you must
take care to ensure they are identical and note the following points:
You can optionally create a special item type for variant items. If you do this, ensure
the type is set to the base type, not the variant item type.
Driving geometry
The following figures shows how a Height option in Teamcenter drives a Height
expression value in NX.
2. Enter the ID of the item in which you created the options as the value in the
PSM_global_option_item_ids preference. You can create more than one global
option item to create a different set of options for different product contexts.
Note To add items to the list of IDs, in Structure Manager, select an item and
choose Tools®Variants®Set/Unset Global Option Item.
3. For each occurrence that appears both in the design and the product architecture,
edit the identifiers so that the absolute occurrence identifier matches the
architecture element identifier. Teamcenter maps the item to the architecture
element.
Caution After creating an architecture breakdown structure in Platform Designer
and sending it to Structure Manager, do not copy and paste or drag and
drop architecture elements in the same window. It can lead to data
corruption in Platform Designer. If you inadvertently perform one of
these actions, delete the resulting line using the Remove Design from
Product button.
3. Locate the product context item revision by defining your search criteria in the
search boxes and clicking .
The system displays the results of the search in the upper pane. Alternatively,
you can copy the product item to the clipboard and paste.
Tip You can find the product item (revision) in another application without
dismissing the wizard.
5. Click Next.
The design solution is displayed in the upper and lower panes. Ignore the upper
part of the wizard. This is for the Add design to product wizard that shares
the same pane.
6. Click Next.
7. In the Architecture box, select the top-level architecture you want to use. This is
only necessary if there is more than one architecture.
Caution Do not skip this step if there are multiple architectures; otherwise,
the next steps in the wizard do not work as expected.
Tip Teamcenter remembers this selection the next time you use the wizard.
8. Specify the architecture element to which you want to add the design solution in
the Architecture Element ID box. Do one of the following:
• Type the ID.
9. Click Next.
10. In the top part of the pane, select the named variant expressions (NVEs) that
apply to the design solution.
11. (Optional) In the bottom part of the pane, further define the conditions under
which this solution is valid by selecting additional splitting NVEs.
Teamcenter adds these to the existing NVEs to further qualify the design that
you select.
Your design solution now has variant data and you can configure it by applying a
variant rule to the design structure.
Designers perform this type of audit on the installation assembly for which they are
responsible. You cannot perform this audit on a level higher than the installation
assembly.
You can still use the audit report if no part solutions exist yet, because the NVEs
on the architecture are checked. You can create an audit report for a particular
configuration by setting the variant and revision rules audit algorithm details. The
audit checks the following:
• If the NVE is not referenced by any solution.
• If the NVE is referenced by one or more solutions, but none of them have an
architecture element ID that matches that of the NVE. The audit report delivers
a list of architecture breakdowns in rows, with colored indicators specifying
whether the line is an exact, partial, or mismatch with respect to an NVE, part
number (typically the part solution ID), and usage quantity.
The audit algorithms use data stored in occurrence notes on the design solution.
It is therefore necessary to replace a design in the product using the Replace
Design in Product wizard before the audit can be run to populate the appropriate
occurrence notes. These occurrence notes are:
o Usage_Product
o Usage_PartNumber
o Usage_Quantity
• RDV_copied_occurrence_notes
Specifies the occurrence notes for the Replace Design in Product wizard
to populate before you can run the audit, for example, Usage_Product,
Usage_PartNumber, and Usage_Quantity.
2. Select the installation assembly for which you want to create an audit report.
Note The audit only checks the immediate components of the installation
assembly. Do not select a level higher than the installation assembly to
which the design solutions are attached.
4. At the top of the dialog box, choose a revision rule from the Revision Rule list.
If the installation assembly structure is precise, select the appropriate revision
rule. You can also audit a specific variant configuration by selecting a saved
variant rule.
5. Click Audit.
Structure Manager creates the audit report.
6. Select the top-level audit lines in the tree on the left to see the results.
The audit report lists all the components in the selected installation assembly.
You can expand the design to see the associated part solution—only two lines
in the following example. However, for those lines, the NVE is matched, but
the quantity is not.
7. (Optional) Refresh the variant condition and other copied occurrence data for the
selected audit line by clicking at the bottom of the dialog box.
8. (Optional) Select a line in the report and click the Details tab to see all relevant
attributes of this line.
• Manifestation
• AltRep
• EC_affected_item_rel
• EC_solution_item_rel
For more information about defining propagation rules, see the Project and Program
Guide.
You can only assign objects to projects if you are a privileged project team member.
For more information, see the Project and Program Guide.
If you are a Teamcenter administrator or a project administrator, you can assign
multiple objects in a structure to a project by running the update_project_bom
utility. You can also use this utility to remove multiple objects from a structure.
Objects can be assigned to projects by making selections from the tree or Properties
table or by selecting from the search results display.
Note You can select from different lists of values (LOVs) for a property, depending
on which project the object is assigned to.
For more information, see the Project and Program Guide.
3. Select the project or projects to which the objects will be assigned and move
them to the Selected Projects list using the right-arrow button. To select all
projects in the list, click the double-arrow button.
4. Click Apply to assign the objects to the projects and retain the dialog box. Click
OK to assign the projects and dismiss the dialog box.
Note You can also assign a selected object to a project by dragging it onto the
project symbol.
2. Choose Project→Assign.
Teamcenter displays the Assign Object to Projects dialog box.
3. Select the project or projects to which the objects will be assigned and move
them to the Selected Projects list using the right-arrow button. To select all
projects in the list, click the double-arrow button.
4. Select the objects to be assigned by selecting either the Current Page or All
Found Objects button.
5. Click Apply to assign the objects to the projects and retain the dialog box. Click
OK to assign the projects and dismiss the dialog box.
To selectively assign objects displayed in the search results tab, select the search
results tab and perform the steps described in Assign objects to projects from the
tree or Properties table.
3. Select the project or projects from which the objects will be removed and move
them to the Selected Projects list using the right-arrow button. To select all
projects in the list, click the double-arrow button.
4. Click Apply to remove the objects from the projects and retain the dialog box.
Click OK to remove the projects and dismiss the dialog box.
3. Right-click the View Type folder and choose New View Type from the shortcut
menu. The New View Type wizard runs.
a. In the Name box, enter the name you want to assign to the new BOM view
type.
b. In the Description box, enter a description of the new BOM view type.
c. Select the Attach Value List check box if you want to attach a list of values
(LOV) to the BOM view type.
d. If you select the Attach Value List check box, click the Browse button to the
right of the LOV box to locate the list of values to attach to the BOM view.
Type an asterisk * in the Find dialog box to see all possible selections. Click
the Browse button to the right of the Default Value box to choose the value
from the list of values that you want to use for the BOM view type.
e. Click Finish.
The new BOM view type displays under the View folder in the Extensions
view.
5. To save the changes to the data model, choose File →Save Data Model.
• Establish BOM view naming conventions before you create additional product
structure data. This minimizes the number of BVRs that you must rename to
reestablish automatic updates.
2. Decide if this renamed BOM view type is the new default BOM view type.
In most cases, you would make it the default because your existing product
structure data is saved under it. However, you can make any valid BOM view
type the default view.
3. If you decide to make another BOM view type the default view, create the
necessary BOM view type.
5. Decide if the BOM view renamed in step 1 is synchronized to NX. If so, change
the TC_NX_view_type preference to the renamed BOM view type.
6. Run the ps_rename_bvrs utility against the affected BOM view revision names,
as described in the Utilities Reference.
By defining a naming convention for reference sets and JT files, you control the
behavior of assemblies in the viewer. You specify the naming convention by setting
the JT_File_OverrideChildren_Refsets preference. The default setting of this
preference is unset, but you can set it to any NX reference set names, for example,
SIMPLE or FULL.
If you click on a structure line, Teamcenter displays the corresponding JT file. If
there is no JT file, the viewer shows all of its immediate children. Teamcenter
repeats this process recursively down each branch of the product structure until it
finds and displays a JT file. However, if the JT file is in the preference list, none of
its children are displayed.
If you do not set the JT_File_OverrideChildren_Refsets preference, Teamcenter
continues processing and displaying the children.
If you do not specifically set this preference, the viewer uses the default entries, that
is, {$empty.jt, $entirepart.jt, $lastsaved.jt, $model.jt}.
3. Right-click the Note folder and choose New Note Type from the shortcut menu.
The New Note Type wizard runs.
a. In the Name box, enter the name you want to assign to the new note type.
c. Select the Attach Value List check box if you want to attach a list of values
(LOV) to the note.
d. If you selected the Attach Value List check box, click the Browse button to
the right of the LOV box to locate the list of values to attach to the note. Type
an asterisk * in the Find dialog box to see all possible selections. Click the
Browse button to the right of the Default Value box to choose the value from
the list of values that you want to use for the note type.
e. Click Finish.
The new occurrence note type displays under the Note folder in the
Extensions view.
5. To save the changes to the data model, chose File→Save Data Model.
o hybrid
Allows users to define modules in structures containing legacy variant data.
o legacy
Use only legacy variants functionality.
• DisableSaveSos
Use this site preference to restrict the saving of option values in a saved option
set (SOS) when you begin to transition to managing options with the Product
Configurator.
o If this preference is set to true, users are not permitted to save option values
in an SOS, if you have set the PSEVariantsMode preference to modular
or hybrid. If a user tries to save option values in an SOS, Teamcenter
displays an error message.
o If this preference is set to false, users may save option values in an SOS.
However, if all the set option values are classic options, you can save them
• PSM_global_option_item_ids
Set this preference to a list of all item identifiers that contain global option
definitions. The default is an empty list. These definitions can be reused when
authoring variant modules. For example:
PSM_global_option_item_ids=
000400
000410
000420
To implement this functionality:
4. In Structure Manager, display the Create Option dialog box and verify the
new item and options are shown in the Based On dropdown list.
• PSESavedConfigRelationTypes
When saving a selected option set or variant configuration, the user can choose
whether to save to the Home folder, the Newstuff folder or to the module (item
revision) being configured. Use this preference to set the possible relation types
from which the user can select when saving to a module.
The default setting is:
PSESavedConfigRelationTypes=
TC_specification
TC_manifestation
TC_relation
• ShowModuleIcons
By default, the icons of the modular variants feature are hidden because their
availability affects performance. If you use modular variants, make the icons
visible by setting this preference to true.
• PSEAllowLegacyVICreation
Set this preference to true to permit the creation of variant items for structures
that include classic variant options. It also permits the creation of variant items
from assemblies that are not modules. The default setting is false.
• PSEBypassVISearch
Set this preference to true to add a Create button to the Configure dialog box as
soon as the user sets a value for each option. This allows the user to bypass the
requirement to search for similar variant item configurations before creating a
new variant item. The default setting is false.
• PSECreateVISameType
If you set this preference to true, Teamcenter always creates a variant item
with the same type as its parent and creates the variant item with a Save As
action. The default setting is false.
• PSEShowUnconfigdVarPref
Determines whether structure lines with variant conditions that do not configure
for the current variant rule are shown by default in a new Structure Manager
window. The preference affects classic variants as well as modular variants. If
a structure line is shown even though its variant condition evaluates to false
for the current variant rule, you can use the following properties to identify the
lines that do not configure for the current variant rule:
bl_is_variant=Y
bl_variant_state=
• PSEIsNewVILinkedToModule
Determines if variant items are linked to the generic item by default. If it is
set to false, they are not linked to the generic item. The default value of this
preference is true.
• EnableIntents
Set to off by default as configuration with intents adds a performance overhead
if your site does not use intents. If you set this preference to on, the intent tabs
appear in the appropriate dialog boxes.
• ShowUnconfiguredByChangeEffectivity
By default, all incremental changes (configured and unconfigured)
are visible to the user. To hide unconfigured changes, set the
ShowUnconfiguredByChangeEffectivity preference to true.
• Incremental_Change_ReleaseStatus
Defines a release status that is attached to an incremental change when the user
first creates it, for example, Pending. The status must already exist and have
an Access Manager rule that allows write access to objects with this status.
• MoveICCreationToMenu
General rules
Name = Working; Any Status
Selects the latest working revisions. If none exist, it selects the latest released
revisions. For example:
Working (any user, any group)
Has Status =Any, Configured by: Date Released
Latest revisions
Use these rules to configure revisions, regardless of whether they are working or
released.
Name = Latest by Creation Date
Selects the latest revisions according to the date they were created, regardless of
whether they are working or released. For example:
Latest (Creation date)
Name = Latest by Alpha Rev Order
Selects the latest revisions according to the revision ID, regardless of whether
they are working or released. The revisions are sorted in alphanumeric order.
For example:
Latest (Alpha-numeric order)
Precise revisions
Any revision rules that configures precise references must have a Precise entry.
You can also include this entry in any of the previous rules if they configure precise
references.
Name = Latest Working
Selects precise references if they exist. For imprecise assemblies, it selects the
latest working revisions. If none exist, it selects the latest released revisions.
For example:
Precise
Working (any user, any group)
Has Status =Any, Configured by: Date Released
Name = Precise; Any Status, No Working
Selects the precise references to specific item revisions in precise assemblies.
If imprecise assemblies are present, only working revisions are selected. For
example:
Precise
Has Status = Any, Configured by: Date Released
Snapshot ACL:
Typically, snapshots are not modified once created, but this restriction depends
on your business practice.
Owning User: Write, Delete, Copy, Change (as required)
Caution Teamcenter does not validate the entries in this file. Ensure you
check the entries carefully to avoid invalid conversions.
2. Create a text dataset and attach the XML file to it as a named reference.
For more information about setting global constants, see the Business Modeler IDE
Guide.
A Glossary
A Glossary
absolute occurrence
Relationship between a parent assembly and an item one or more levels down in
the structure. The parent assembly is the context in which the absolute occurrence
exists. When you select the context assembly and view the structure, you can define
data on the absolute occurrence that overrides the data stored on the parent.
Compare to occurrence.
allocation
Relationship between constituents of two structural views of a product, for example,
a relationship between constituents of the functional breakdown and the physical
breakdown of a product.
appearance
Sequence of occurrences that describes a unique path through an exploded structure.
An appearance corresponds to a unique instance of the component that is referenced
by the leaf node of the path within the top-level assembly. An appearance may have
spatial data associated with it, allowing spatial searches.
Appearance Configuration
Teamcenter application used to configure the use of appearance:
• Defining the appearance sets for which the site tracks appearances.
assembly
Compound object that is assembled from other objects and may add additional
information to their interpretation.
• In the context of an assembly, other assemblies are called subassemblies, while
noncompound objects are called components.
baseline
Collection of items and the relationships between the items that is established to
ensure their continued existence. It enables their configuration to be reconstructed
and audited. Baselines are often created to preserve the state of a design at a
particular checkpoint. You can baseline precise or imprecise structures.
BOM
Bill of materials.
• 100% BOM
The as sold product configuration, for example, the configuration of a car to be
built and shipped to the dealer.
• 120% BOM
Partial overlay of selected variant conditions. You cannot build the product
from a 120% BOM.
• 150% BOM
Overlays of all possible variant configurations. You cannot build the product
from a 150% BOM.
BOM view
Teamcenter object used to manage product structure information for an item.
BVR
See BOM view revision (BVR).
Change Manager
Teamcenter application used to track changes to a product throughout its life cycle.
The user proposes a change to a product and then manages the entire cycle of review,
approval, and implementation of the change. The user can articulate the work
required to implement a change, assess its impact on any managed business items,
and notify life cycle participants about proposed and authorized changes. Before and
after product configurations can also be compared.
change order
Teamcenter object that references the problem, originating change requests,
solutions, and related information. A change order contains sufficient information to
incorporate the change.
change request
Teamcenter object that requests a change, reference the problem, proposed solutions,
and related information. A change request contains sufficient information to allow a
decision to proceed further with the change.
collaboration context
Teamcenter object that holds a collection of data contained in structure and
configuration contexts. This data allows you to capture multiple different
Teamcenter structures in one container. You can open a collaboration context in
the Multi-Structure Manager application, in Manufacturing Process Planner, or in
Part Planner. You can also use a collaboration context to collect data to share with
a third-party application. See also structure context.
component
Part in a product structure defined in Teamcenter. A component is the lowest level
part in the product structure: it cannot be broken down into subparts.
composition
Special kind of structure context that allows components to be added from one or
more structure contexts, each of which may contain a different product structure.
Compositions are used for design studies and manufacturing processes that contain
data from both product and plant structures.
configuration rule
Rule that configures a structure. There are two kinds of configuration rules: revision
rule and variant rule.
dataset
Teamcenter workspace object used to manage data files created by other software
applications. Each dataset can manage multiple operating system files, and each
dataset references a dataset tool object and a dataset business object.
effectivity
Identification of the valid use of an aspect of product data tracked by unit, date, or
intent. You can specify a start definition, end definition, or both for a particular
effectivity. There are three types of effectivities:
• Unit effectivity specifies the range of item units or serial numbers.
end item
Top-level node of an assembly that can represent a product or a factory structure.
feature
Physical or geometric object associated with a product, component, or part.
Alternatively, a logical attribute of a product, component, or part. Examples: a weld
point, a signal, or a geometric pattern. A feature may be represented by a generic
design element (GDE) in a BOM. See also generic design element.
find number
Number that identifies individual occurrences (or groups of occurrences) within a
single-level assembly. Components are ordered by find number within an assembly.
GDE
See generic design element.
global alternate
Alternate that is interchangeable with another part, regardless of where the part
is used in the product structure. A global alternate applies to any revision of the
part and is independent of views.
imprecise assembly
Single-level assembly that has items as the components. The revision is determined
by the revision rule settings. Compare with precise assembly.
incremental change
Engineering change that collects several individual changes to components or
attachments in a structure, allowing them to be released simultaneously. An
incremental change is released and effectivity is applied to it by attaching an
appropriate release status.
installation assembly
Node in the CAD structure to which design solutions are added and variant
conditions applied, according to the named variant expression selected on the
architecture element. An installation assembly (IA) can be associated with an
architecture element to guide the designer by limiting the named variant expressions
from which to choose when adding a design to the product. Any structures above an
installation assembly are for organizational and navigational purposes only—there
are no transforms or geometry above an IA. IAs are designed in product space, and
are therefore all positioned correctly relative to one another when viewed together.
item
Workspace object generally used to represent a product, part, or component. Items
can contain other workspace objects including other items and object folders.
item revision
Workspace object generally used to manage revisions to items.
line of assembly
(Also called assembly component tree). Relation that represents one level of
an assembly breakdown and contains attributes that are only pertinent to the
corresponding level.
logical identity
Combination of the usage address and position designator of an absolute occurrence.
See also position designator and usage address.
MRU
See most recently used (MRU).
Multi-Structure Manager
Teamcenter application that enables users to view and manipulate data in a specific
context.
occurrence
Hierarchical structure relationship between the immediate parent assembly and
its child component item or item revision in a precise assembly. Sometimes called
relative occurrence.
occurrence effectivity
Method of configuring the occurrences in a structure with effectivity. See also
effectivity.
occurrence group
Collection of occurrences and absolute occurrences in the BOM. An occurrence group
typically represents an assembly.
occurrence path
Representation of the path from a top-level assembly to an occurrence of a component
or subassembly. An occurrence path is unique to the context of a specific BOM;
different BOMs cannot contain the same occurrence paths. The occurrence path does
not change if the configuration of the BOM changes.
occurrence type
Object used to distinguish how items occur in a product structure. An occurrence
consists of one component in an assembly including its relative position with respect
to its parent assembly. Occurrence types are representations of the PSOccurrence
business object.
option
Attribute of an item revision with a set of allowed values (for example, engine:
1200, 1600). Options are used when specifying variant data to configure a variant
of an assembly. Option names are unique within an item revision, but not within
the database.
part
Business object type that can participate in a structure as an assembly or component,
with or without attached datasets. In Teamcenter, a business item managed in a
company’s part releasing system. Typically, the assembly or component is designed
and built by the OEM.
piece part
Part with no structure (no associated BOM view revision).
position designator
Value that represents the position of a single part from a line of usage. For example,
if the line of usage references four wheels, there are four position designators—one
for each wheel.
precise assembly
Single-level assembly that has item revisions as the components. The item revision
is configured by a precise entry in a revision rule. Compare with imprecise assembly.
product structure
Hierarchy of assembly parts and component parts with a geometric relationship
between them, for example, a bill of materials (BOM). Variant and revision rules
define the generic BOM. This BOM can then be loaded to display the configured
variant.
product view
Saved configuration of the assembly viewer, including the selection of objects, zoom
factor, rotation angle, and pan displacements.
properties
Keys and values that specify the configuration settings for an application in the
Teamcenter rich client.
reference designator
Identifier appended to part attributes in the product structure. It allows unique
identification when the part is used several times in the same structure. Reference
designators need only be unique across a single level of the product structure.
release status
Status associated with a workspace object when it is released through a workflow
process.
revision rule
Parameter set by the user that determines which revision of an item is used to
configure product context.
snapshot
Folder that contains all the revisions of a configured product structure. A snapshot
can be used to redisplay the as-saved structure.
spatial data
Either NX true shape files or PLM visualization JT files that define the volume of
the part as a set of cubes. The cube size is set in the CAD programs defaults file. The
CAD files do not set absolute position; this is defined when the files are associated
with an appearance.
structure
Representation of multiple objects and their interdependencies. For example, a
classification structure represents classes and their inheritance dependencies, and
an assembly structure represents how components and subassemblies are associated
to build up an assembly. The structure can be viewed in several applications,
including Structure Manager, Manufacturing Process Planner, Part Planner,
Multi-Structure Manager, and Resource Manager.
In Resource Manager, most structures are hierarchical. For example, they acquire
the form of a tree where each node can have only one parent but multiple siblings
and children.
structure context
BOM or assembly structure contained in a collaboration context. The structure
context can contain occurrence groups, items, and item revisions. See also
collaboration context.
substitute
Component that can be used interchangeably within an occurrence, typically for
manufacturing purposes. The preferred substitute is displayed in the structure.
supersedure
Manually created relation that graphically displays deleted components and the
components that replace them. A supersedure is always created in the context of
a parent assembly. Therefore, a single component can be used in more than one
supersedure if it is used in different parent assemblies. A supersedure can be created
for changes of part number or of quantity, but not for changes in a part revision.
usage address
Type of object that occupies an occurrence in the structure, for example, wheel.
variant condition
• Rules applicable to one component in a product structure.
variant rule
Collection of option values used in determining the variant of the BOM to be
configured (for example, car type = GLS, engine = 1200, gearbox = manual).
view type
Attribute of a BOM view revision. The view type specifies the BOM view revision’s
intended use (for example, design or manufacture). The view type distinguishes one
BOM view revision from another BOM view revision of the same item revision.
workflow
Automation of the concept that all work flows through one or more business
processes to accomplish an objective. Using workflow, documents, information, and
tasks are passed between participants during the completion of a particular process.
working revision
Revision that can be changed by a user with write privileges. No record of
intermediate states of a working revision is maintained by Teamcenter.
Component Creating
Adding installation assembly . . . . . . 17-2 Transfer supersedures . . . . . . . . . . 10-25
Find by property . . . . . . . . . . . . . . . 3-14 Custom form (associate with
Finding . . . . . . . . . . . . . . . . . . . . . . 3-14 supersedure) . . . . . . . . . . . . . . . . . . 10-34
Purpose . . . . . . . . . . . . . . . . . . . . . . 1-32 Custom form (create) . . . . . . . . . . . . . 10-34
Remove substitute . . . . . . . . . . . . . . 4-58 Custom form (enable) . . . . . . . . . . . . 10-34
Component arrays . . . . . . . . . . . . . . . 16-49 Custom note
Components Define text . . . . . . . . . . . . . . . . . . . 4-68
Add . . . . . . . . . . . . . . . . . . . . . 4-8, 4-11 View . . . . . . . . . . . . . . . . . . . . . . . . 3-23
Changing . . . . . . . . . . . . . . . . . . . . 4-52 Viewing . . . . . . . . . . . . . . . . . . . . . . 3-23
Display substitutes . . . . . . . . . . . . . 4-56
Display substitutes on separate D
line . . . . . . . . . . . . . . . . . . . . . . 4-57
Move to another assembly . . . . . . . . . 4-53 Dashboard, compliance . . . . . . . . . . . . 4-74
Paste . . . . . . . . . . . . . . . . . . . . . . . 4-13 Dashboard, material and substance . . . 4-74
Remove . . . . . . . . . . . . . . . . . . . . . . 4-53 Data Dictionary Search Dialog . . . . . . . 4-80
Replace operation . . . . . . . . . . . . . . 4-55 Database
Replacing . . . . . . . . . . . . . . . . . . . . 4-53 Load variant rules from . . . . . . . . . 15-28
Compound property, adding . . . . . . . . . 6-15 Modify saved variant rules . . . . . . . 15-29
Conditions Save variant rules . . . . . . . . . . . . . 15-28
Copy . . . . . . . . . . . . . . . . . . . . . . . 15-24 Store variant rules . . . . . . . . . . . . . 15-27
Create . . . . . . . . . . . . . . . . . . . . . . 15-21 Datasets
Modifying . . . . . . . . . . . . . . . . . . . 15-23 Associate with absolute occurrence . . 5-14
Remove . . . . . . . . . . . . . . . . . . . . . 15-25 Datasets, export . . . . . . . . . . . . . . . . . 4-62
Configuration items . . . . . . . . . . . . . . 11-23 Date entry (revision rules) . . . . . . . . . 11-12
Creating . . . . . . . . . . . . . . . . . . . . 11-24 Date/unit/end item, set . . . . . . . . . . . 11-18
Define effectivity mapping . . . . . . . 11-27 Datum points . . . . . . . . . . . . . . . . . . . 3-34
Configuration rule Default option values, location . . . . . . 15-10
Purpose . . . . . . . . . . . . . . . . . . . . . . 1-32 Default precedence (options) . . . . . . . 15-32
Configurations, comparing . . . . . . . . . . 10-1 Default values (variants) . . . . . . . . . . 15-15
Configure dialog box . . . . . . . . . . . . . 16-35 Default view type
Configure displays by effectivity . . . . . 13-15 Definition . . . . . . . . . . . . . . . . . . . . 19-1
Configure variant products . . . . . . . . . 1-42 Purpose . . . . . . . . . . . . . . . . . . . . . . 1-32
Configuring revision rules for Derived default values . . . . . . . . . . . . 15-27
searching . . . . . . . . . . . . . . . . . . . . . 4-90 Derived default, purpose . . . . . . . 15-2, 16-2
Configuring Structure Manager . . . . . . . 1-1 Derived defaults, variant rules . . . . . . . 15-6
Connection Derived option defaults . . . . . . . . . . . 15-33
Create . . . . . . . . . . . . . . . . . . . . . . . 4-67 Derived values (variants) . . . . . . . . . . 15-15
Remove . . . . . . . . . . . . . . . . . . . . . . 4-67 Design
Connection point information Add architecture element . . . . . . . . . 17-2
Display . . . . . . . . . . . . . . . . . . . . . . 3-16 Publishing preferences . . . . . . . . . . . . 2-5
Connection points . . . . . . . . . . . . . . . . 3-15 Purpose . . . . . . . . . . . . . . . . . . . . . . 1-32
Connections, show . . . . . . . . . . . . . . . . 3-34 Remove from product . . . . . . . . . . . . 17-6
Constants Detail part histories . . . . . . . . . . . . . 10-18
Mature statuses . . . . . . . . . . . . . . . . . 2-5 Dialog boxes
Constraint, purpose . . . . . . . . . . . . . . . 15-2 Create Trace Link with Subtype . . . 4-76,
Constraints dialog box . . . . . . . . . . . . 16-22 4-80
Controls tab . . . . . . . . . . . . . . . . . . . 10-11 Export To Excel . . . . . . . . . . . . . . . . 4-77
Conventions, MVL . . . . . . . . . . . . . . 16-27 Search Class . . . . . . . . . . . . . . . . . . 4-85
Copy item . . . . . . . . . . . . . . . . . . . . . . 4-10 DirectModel dataset, purpose . . . . . . . . 1-32
Copy item revision . . . . . . . . . . . . . . . 4-10 DisableSaveSos preference . . . . . . . . . . 19-6
Copying objects . . . . . . . . . . . . . . . . . . . 4-9 Disparate revision histories . . . . . . . . 10-18
Create Trace Link with Subtype dialog Display name
box . . . . . . . . . . . . . . . . . . . . . . 4-76, 4-80 Create . . . . . . . . . . . . . . . . . . . . . . . . 6-9