Making the Configurable Links Available in PSB
To make Configurable Links available in Part Structure Browser (PSB), perform the following procedure:
1. Create action models.
◦ Part: configurable_links_structure_tab_part
◦ Part Master: configurable_links_structure_tab_partmaster
◦ Document: configurable_links_structure_tab_doc
◦ Document Master: configurable_links_structure_tab_docmaster
2. Set the com.ptc.windchill.enterprise.part.psb.showConfigurableLinksTab property to true for displaying the Configurable Links tab in PSB.
Example of action models:
<actionmodels>
<!-- "Configurable Link Examples" 3rd level nav menu options -->
<model name="configLinks" resourceBundle="com.ptc.windchill.enterprise.object.configurableLinkExamplesResource">
<description>Custom Config Link 3rd level nav menu</description>
<action name="childObjectsTable_customDescribeLink" type="object"/> <!-- Describes Child Objects -->
<action name="childObjectsTable_customReferenceLink" type="object"/> <!-- Reference Child Objects -->
<action name="childObjectsTable_customRevisionLink" type="object"/> <!-- Describes Child Objects -->
<action name="childObjectsTable_customMastersLink" type="object"/> <!-- Master Child Objects -->
<action name="parentObjectsTable_customDescribeLink" type="object"/> <!-- Describes Parents Objects -->
<action name="parentObjectsTable_customReferenceLink" type="object"/> <!-- Reference Parent Objects -->
<action name="parentObjectsTable_customRevisionLink" type="object"/> <!-- Describes Parents Objects -->
<action name="parentdObjectsTable_customMastersLink" type="object"/> <!-- Master Parent Objects -->
</model>
<model name="configurable_links_structure_tab_part"> <!-- "Configurable Links Part PSB action model -->
<submodel name="configLinks"/> <!-- "Configurable Link Examples -->
</model>
</actionmodels>
<!-- "Configurable Link Examples" 3rd level nav menu options -->
<model name="configLinks" resourceBundle="com.ptc.windchill.enterprise.object.configurableLinkExamplesResource">
<description>Custom Config Link 3rd level nav menu</description>
<action name="childObjectsTable_customDescribeLink" type="object"/> <!-- Describes Child Objects -->
<action name="childObjectsTable_customReferenceLink" type="object"/> <!-- Reference Child Objects -->
<action name="childObjectsTable_customRevisionLink" type="object"/> <!-- Describes Child Objects -->
<action name="childObjectsTable_customMastersLink" type="object"/> <!-- Master Child Objects -->
<action name="parentObjectsTable_customDescribeLink" type="object"/> <!-- Describes Parents Objects -->
<action name="parentObjectsTable_customReferenceLink" type="object"/> <!-- Reference Parent Objects -->
<action name="parentObjectsTable_customRevisionLink" type="object"/> <!-- Describes Parents Objects -->
<action name="parentdObjectsTable_customMastersLink" type="object"/> <!-- Master Parent Objects -->
</model>
<model name="configurable_links_structure_tab_part"> <!-- "Configurable Links Part PSB action model -->
<submodel name="configLinks"/> <!-- "Configurable Link Examples -->
</model>
</actionmodels>
Customizing the Configurable Links Tab Name
To customize the Configurable Links tab name in PSB, set the PSB_CONFIGURABLELINKS_TAB_NAME property in the com.ptc.windchill.enterprise.part.psb.server.util.ConfigurableLinksResource resource bundle.
Controlling the Display of the Configurable Links Tab in PSB
You can control the display of the Configurable Links tab in PSB using the following mechanisms:
• Property-based
• Role-based
Property-based Display Control
To control the display of the Configurable Links tables in the Configurable Links tab, use the following properties for each configurable link type:
• ReferenceLink: com.ptc.windchill.enterprise.part.showReferenceLinksTable
• DescribeLink: com.ptc.windchill.enterprise.part.showDescribeLinksTable
• RevisionLink: com.ptc.windchill.enterprise.part.showRevisionLinksTable
• MasterLink: com.ptc.windchill.enterprise.part.showMasterLinksTable
Each property can have four values:
• PARENT: Enables Configurable Link for Parent only.
• CHILD: Enables Configurable Link for Child only.
• ALL: Enables Configurable Links for Parent and Child.
• OFF: Disables Configurable Link for all.
In the out-of-the-box system, the following filters are available:
• hideBasedOnChildDescribeProperty: For Describe Link Child side.
• hideBasedOnParentDescribeProperty: For Describe Link Parent side.
• hideBasedOnChildReferenceProperty: For Reference Link Child side.
• hideBasedOnParentReferenceProperty: For Reference Link Parent side.
• hideBasedOnChildRevisionProperty: For Revision Link Child side.
• hideBasedOnParentRevisionProperty: For Revision Link Parent side.
• hideBasedOnChildMasterProperty: For Master Link Child side.
• hideBasedOnParentMasterProperty: For Master Link Parent side.
 |
• To make Configurable Links available in Part Structure Browser or on the Information pages of part, documents, or changes, you must first add the properties to the site.xconf file.
• Using the com.ptc.windchill.enterprise.part.psb.showConfigurableLinksTab property will control the display of the Configurable Links tab for all the users.
• To enable the property-based display control for existing custom configurable links tables, you must add appropriate filters to the corresponding action.
|
Role-based Display Control
To enable the role-based display control for existing custom configurable links tables, you must add appropriate uicomponent attribute to the corresponding action.
|
|
Using the standard profile will control the display of the Configurable Links tab for specific users.
|
There are following UICOMPONENTs that can be used for Configurable Links display control:
• VIEW_PSB_DESCRIBE_CONF_LINKS_TABLE for Describe Link
• VIEW_PSB_REFERENCE_CONF_LINKS_TABLE for Reference Link
• VIEW_PSB_REVISION_CONF_LINKS_TABLE for Revision Link
• VIEW_PSB_MASTER_CONF_LINKS_TABLE for Master Link
Example of actions with UICOMPONENT and filters:
<action name="childObjectsTable_customDescribeLink" uicomponent="VIEW_PSB_DESCRIBE_CONF_LINKS_TABLE">
<command url="/netmarkets/jsp/object/configurableLinkRoleATable.jsp" />
<includeFilter name="hideForChangeTemplates"/>
<includeFilter name="hideBasedOnChildDescribeProperty"/>
<nonSupportedTypes value=="wt.vc.Mastered"/> <!-- This kind of link is not applicable for Mastered Context Objects -->
</action>
<command url="/netmarkets/jsp/object/configurableLinkRoleATable.jsp" />
<includeFilter name="hideForChangeTemplates"/>
<includeFilter name="hideBasedOnChildDescribeProperty"/>
<nonSupportedTypes value=="wt.vc.Mastered"/> <!-- This kind of link is not applicable for Mastered Context Objects -->
</action>
Adding, Removing, and Re-ordering the Configurable Links Tables in PSB
You can add, remove, and re-order the Configurable Links tables in PSB by simply adding, removing, or re-ordering the actions in the corresponding action model.
Parent topic