Tree options

<< Click to Display Table of Contents >>

Navigation:  Options > User Interface >

Tree options

Tree options

radOFF Explorer Project Tree Mode

radON Standard Project Tree mode

By selecting the Explorer Project Tree mode, the upper tree will contain projects only, clicking one project in the project tree will populate the lower tree with the content of the upper tree selected project; See specific topic.

images_Interface_ExplorerProjectTreeMode

This mode will notably enhance the performance of the control.

The Standard Project Tree mode is the R20 standard mode, with documents and projects in the same strucutre.

optOFFPopulate Child/Parent Tree in the Sub-Tree

If checked, the output of the RMB→Child Tree/Parent Tree action is shown in an additional Tree Control (named Sub-Tree) rather than in the common Project Tree.

plussee example

images_SubTree

Show the value in a column beside the Tree:

optONExisting drawings

images_ShowExistingDrawingsInTrees

If checked, a drawing icon is shown in the right-most column to indicate the presence of at least one drawing for the part/assembly enlisted in the Tree.

If more than one drawing is related to the current record, a special icon with 2 drawings is shown instead of the default one.

images_MoreDrawings

If you rightclick (RMB) on the icon in the Drawing column, you'll obtain the same popup menu you'd have by clicking on a drawing record; this is very useful if you don't show drawings as nodes in trees.

 

images_icons_SW16Solidworks users only

If the drawing is detached, the common drawing icon will be replaced with the specific detached icon and an additional [_D_] string is shown in the tree:

images_detachedDrawing

optOFFPhysical quantities

If checked, and if the physical quantities environment is correctly set, MechworksPDM displays the physical quantity of the items in the Tree Page. Read the topic Change quantity for details on the activation, that may require modifications in the database structure. To see an example of resulting display, please read the topic The Tree window.

optONBOM quantities

If checked, a column with the Quantity is shown in the Trees

optOFFCOMPANY_ID

If this option is checked and the Remote Access is active, a column with the COMPANY_ID values is shown in the Tree Page

optONREVISION

If checked, a column with the revision values is shown in the Tree Page

optOFFMAKE_BUY

If checked, a column with MAKE_BUY values is shown in the Tree Page.

Please note this option shows the DOCUMENT.MAKE_BUY field. To visualize the PARENT_CHILD.MAKE_BUY field you've to use the Extra PARENT_CHILD or Linked Database Tables Columns to show in the Trees option.

optONFilter MAKE value

If enabled the value MAKE (default) won't be shown in the tree (to keep the visualization lighter).

images_filterMAKEyes

images_filterMAKEno

option disabled

option enabled

Extra DOCUMENT table fields:

In this list, choosing from a dialog, it is possible to specify other columns (fields of the DOCUMENT table) to show in the tree structure interface of the Tree Page.

Please note this option drives also the fields to be shown (adding them to defaults ones, not hideable) in

recursive revision dialog

briefcase

reload of skipped components

ownership change of Remote Access

document multiple submission to workflow

ShowDocumentSelectorDialog shell command

 

images_customRecursiveDialogFields

Extra PARENT_CHILD or Linked Database Tables fields:

In this list, choosing from a dialog, it is possible to specify other columns (fields of the PARENT_CHILD table) to show in the tree structure interface of the Tree Page.

Use of an existing DOCUMENT field with the same name

The Tree is able to display the DOCUMENT table value of a field if the PARENT_CHILD field with the same name has a null value.

Example

Parent_Child field: PARENT_CHILD_MYFIELD

PART view field: MYFIELD

If PARENT_CHILD_MYFIELD is declared in the option like this:

images_extraPCfield0

then, if the PARENT_CHILD_MYFIELD value is null, the DOCUMENT::MYFIELD will be displayed for the Tree item;
in the following picture, the "hinge1_Bolt (Default)" part has a PARENT_CHILD_MYFIELD value equal to "MyPCFieldValue", while the "hinge1_Nut (Default)" part has a PARENT_CHILD_MYFIELD value that is null, but the PART::MYFIELD value is equal to "MyDOCFieldValue"

images_extraPCfield1

optOFFShow drawings as nodes in the Trees

With this option checked, drawings are explicitly displayed in the Project Tree

images_ShowDrawsInTree

Please note that the appareance of the Project Tree could substantially change due to the parent-child relationship between a drawing and its component.

optOFFShow only unreferenced drawings

Some drawings can exist with no link to any model (e.g. 2D drawings in Solid Edge);
by enabling this option you will see in the Tree the unreferenced drawing only, otherwise to see them you would have to see also every drawing, included the ones with a 3D model link to it:

images_ShowUnreferencedDrawOnly

On the left the option is disabled (see all drawings in the Trees); on the right the option is enabled (hide drawings with a linked model and show the unreferenced ones in the Trees).

optOFFShow project descriptions in the Project Tree

images_ShowProjDescInTree

If checked, MechworksPDM displays the project descriptions in the Project Tree, This option should be checked when the ID is a numeric code and should be left unchecked when the value in the field Description is very long or when the ID itself is self-describing.

optOFFShow ONLY description

If checked, displays only the Projects Description in the Project Tree, instead of concatenating it to the Project ID.

Example

images_ShowProjDescInTree1
Default ID only visualization

images_ShowProjDescInTree2
ID + Description visualization

images_ShowProjDescInTree3
Description only visualization

optONShow only top level objects in the Trees

If checked, MechworksPDM displays only the top level objects (main assemblies) in the expanded branches of the Project Tree.

images_showTopLevelObjOnly1

images_showTopLevelObjOnly0

option enabled

option disabled

Note: this feature can have a significant negative effect on the tree rebuilding speed, so you should avoid to check it if managing projects with thousands of components.

optONExpand the current project in the Project Tree and collapse all the others

If checked, MechworksPDM always expands the current project everytime it is set. By default, active.

Max number of expanded sub-projects levels in Project Tree

It is the max number of expanded sub-project level in the Project Tree.
The current project is visible indipendently from the value of this option.
In order to improve tree rebuild performances it is recommended to keep this value as lower as possible.

The value 0 (zero) disables the forward check for any existing sub-project while populating the Project Tree. This leads to a huge performance enhancement when populating very large project trees (10.000 and more) - the negative effect is that the plus plus sign is ALWAYS displayed even if a project does not have any subproject under it.

Example

images_maxExpSubProj

The subproject 2532-78-FG3566-05-FOLDER has no subprojects but the plus icon is shown as well.

optONMark parent-child relation according to external reference

This option, for Solidworks users only and formerly defined under options→Environment→Derived Parts has been enhanced and moved to this UI section of options

It now applies not only to derived parts but also to assemblies, ensuring a more consistent handling of external reference information across different saving operations.

This option improves the tracking of external references between parts and parent models.
By saving a derived part/assembly, the system will register child models also in case of Locked, Broken references.

The data is recorded in the table PARENT-CHILD.PARENT_CHILD_REFERENCE_STATUS (see here).
This management ensures that the references are also reflected in the PARENT-CHILD table; a symbolic notation is appended next to each tree item child ID to indicate the specific reference status.

Here are the external reference possible values and relative symbols:

state

displayed as

PARENT_CHILD_REFERENCE_STATUS

Tree UI

Broken reference

[->X]

0

images_extReferenceType0

Locked

[->*]

1

images_extReferenceType1

In Context

[->]

3

images_extReferenceType3

Out of Context

[->?]

4

images_extReferenceType4

This approach makes it easier to identify the state of the external parent model toward its dependencies directly from the relationship data, including references that were previously ignored if marked as Broken or Locked.

Remarks:

In case the parent model (P2) contains multiple references to the same source model (P1), each with a different external reference status, the PARENT-CHILD table records the status with the highest precedence, determined by the following severity:

The broken reference state takes precedence over all other states.

The locked reference state takes precedence over all other states except the 'broken' state.

The In Context reference state takes precedence only over the 'Out of Context' reference state.

The Out of Context reference state does not take precedence over any other states.

optONEnable drag-and-drop in the Trees

If checked, MechworksPDM enables drag & drop operations in the Project Tree and in the Tree Page. It is also possible to drag & drop a file in the SW desktop directly from any Tree Control item, starting to drag from the item label; multiple selections are allowed.

By default, this option is unchecked.

minusoptONEnable drag-and-drop on Assemblies

This option allows the drag & drop on assemblies.

minusoptONOnly for fake components

This option allows the drag & drop of components into existing assemblies only if the components have been created with the Create New Bom Item functionality (fake components).

optONHighlight 'dirty' revision documents in the Tree (and Grids)

If checked, and if the 'dirty' revision flag environment is correctly set, MechworksPDM highlights in the Trees the released documents that have the DIRTY_REVISION_FLAG value not null.

images_dirtyRevision

See specific help topic.

minusoptOFFEven for documents in CHECKED-IN/CHECKED-OUT state

if this option is enabled, the dirty status is highlighted also for states of checkin and checkout (being_modified).

optONHighlight 'fake' components and quantities in the Tree

If checked, MechworksPDM highlights in the Trees the components that have a 'fake' quantity assigned using the Change Quantity. functionality.

optOFFHighlight records not updated in the DB

If checked, MechworksPDM highlights in the Trees the components that have been saved through the CAD application but (due to the CTRL+Save action and options) haven't been updated in the db yet.

Working with the option
Environment → images_checkONEnable CTRL key for executing native CAD 'Save'
or
Save → images_checkOFFAlways update database structure on checked-out document save
it is possible to keep track of not updated record at database level.

Based on the field named CTRL_SAVE_FLAG (same name for all the supported languages) available in the DOCUMENT table, the field keeps track of record with no updated information based on the last save operation performed: the value 1 indicates that only a CAD save operation was performed without updating the PDM database structure.
The value of this field is reset to NULL each time the database structure is updated for the specific record.

This option allow to highlight at browser level the record with no updated DB information: the involved records are marked with a specific icon both in the Browser at tree/grid level:

images_Interface_ic_noDBupd

At Event log, the corresponding events are dumped as ASSEMBLY_SAVE_NO_DB_UPD, PART_SAVE_NO_DB_UPD and DRAWING_SAVE_NO_DB_UPD.

optOFFShow descriptions in the Trees

If checked, the Project Tree displays both the IDs and the Descriptions of the Tree items. This option should be checked if the IDs are numeric or codes and an explicit description can help the designer to identify items in the Project Tree.

optOFFShow ONLY description

If checked, the Project Tree displays only the Descriptions of the enlisted items Projects.

Example

images_ShowDescInTrees1
Default ID only visualization

images_ShowDescInTrees2
ID + Description visualization

images_ShowDescInTrees3
Description only visualization

optOFFHide Inventor Presentations in the Trees

When checked the .IPN Presentation documents will not be displayed in the Tree

images_showIPNinTreesYES
Show IPN in the tree

images_showIPNinTreesNO
Hide IPN from the tree

Extra fields to show in the Trees

MechworksPDM allows to add fields to the tree, indicating them in the text box separated by commas (example: COST,ITEM_CODE,SUPPLIER_ID); we suggest not to use many fields in order to continue to have a good performance on tree regeneration.

Here's a valid example and the generated result:

images_xtraFieldsInTrees

optOFFAvoid Child Tree for Documents with File Names like...

You can define file patterns to exclude files from being included in the child tree.

optOFFAvoid Parent Tree for Documents with IDs like...

You can define ID patterns to exclude records parent tree from being shown.

Example

Suppose you have this structure and settings:

images_avoidParentTree00 images_avoidParentTree01

When performing a RMB→ParentTree on P3 you'll see different behaviors:

images_avoidParentTree02
option enabled

images_avoidParentTree03
option disabled

Visible Grids:

It is possible to selectively display specific Grids in the Tree Page.
This option can be filled with the identifiers of the Grids that must be visible in the Tree Page interface.
When the Option is empty, ALL the Grids will be available.
All the LST\OnCustomQueryTab_xxx.LST are available in the choise combo box.

For example, with the following setting:

images_optionsUIgrids

the Grids area of the Tree Page User Interface will appear as:

images_optionsUIgrids2

Notes: it is not possible to control the ORDER of the Grids, but only their visibility.