topic Re: Introduce a new tab in WTDocument Page in Windchill Customization

Introduce a new tab in WTDocument Page

Sha11 — Fri, 15 Mar 2024 14:03:19 GMT

Hello,

I want to introduce a new tab under a specific type of WTDocument page and populate it with some of the attributes, could you shed some light on how to approach this requirement?

Thanks,

Sha

Re: Introduce a new tab in WTDocument Page

HelesicPetr — Wed, 25 Jan 2023 12:36:46 GMT

Hi @Sha11

You need to define own JSP page and crate action definition in the customAction and customActionModel

definition in customAction

Put the action to the customActionModel to show in the document tab menu

third_level_nav_doc

the builder class

package cz.aveng.NewDocTab; import com.ptc.mvc.components.*; import org.apache.logging.log4j.Logger; import wt.util.WTException; @ComponentBuilder(value = "cz.aveng.NewDocTab.DetailTabBuilder", type = ComponentBuilderType.CONFIG_AND_DATA) public class DetailTabBuilder extends AbstractComponentBuilder { protected static Logger logger = ShowChangesInBOMLogger.GetShowChangesInBOMLogger(); @Override public ComponentConfig buildComponentConfig(ComponentParams componentParams) throws WTException { MultiComponentConfig multiComp = new MultiComponentConfig(); //multiComp.addNestedComponent("cz.aveng.AVChangeInBOM.AVFilterBuilder"); multiComp.addNestedComponent("cz.aveng.NewDocTab.TreeBuilder"); multiComp.setView("/cz/aveng/NewDocTab/DetailTabBuilder.jsp"); return multiComp; } @Override public Object buildComponentData(ComponentConfig componentConfig, ComponentParams componentParams) throws Exception { return null; } }

NestedComponent is definition of table or attribute panel builder..

PetrH

Re: Introduce a new tab in WTDocument Page

Sha11 — Wed, 25 Jan 2023 12:44:43 GMT

@HelesicPetr - Thank you for the info, will try to implement by following your steps. Could you let me know if there is any article or link which could provide more information on the implementation that you have mentioned?

Re: Introduce a new tab in WTDocument Page

HelesicPetr — Wed, 25 Jan 2023 12:46:42 GMT

@Sha11

JSP Example>

<%@ page import="java.util.List" %> <%@ page import="java.util.ArrayList" %> <%@ page import="wt.lifecycle.LifeCycleTemplate" %> <%@ page import="wt.lifecycle.LifeCycleHelper" %> <%@ page import="java.util.Vector" %> <%@ page import="wt.lifecycle.State" %> <%@ page import="wt.fc.Persistable" %> <%@ page import="com.ptc.netmarkets.model.NmOid" %> <%@ page import="wt.part.WTPart" %> <%@ page import="wt.lifecycle.LifeCycleManaged" %> <%@ taglib uri="http://www.ptc.com/windchill/taglib/jcaMvc" prefix="mvc"%> <%@ taglib prefix="wrap" uri="http://www.ptc.com/windchill/taglib/wrappers" %> <%@include file="/netmarkets/jsp/util/begin_comp.jspf"%> <mvc:tree/> <%@ include file="/netmarkets/jsp/util/end_comp.jspf"%>

PetrH

Re: Introduce a new tab in WTDocument Page

HelesicPetr — Wed, 25 Jan 2023 13:26:59 GMT

Hi @Sha11

generally use a Windchill help center and custom documentation from Windchill

adress to the windchill

https://werverAdress.comp.com/Windchill/app/#ptc1/componentCatalog/componentCatalog?oid=OR%3Awt.org.WTUser%3A207&u8=1

specific example is in windchill

https://werverAdress.comp.com/Windchill/app/#ptc1/tcomp/infoPage?typeIdForTypeLookup=com.ptc.carambola.customization.examples.infoPage.Carambola

and

https://werverAdress.comp.com//Windchill/app/#ptc1/comp/carambola.AboutInfoPageExample?portlet=poppedup

help Attribute panel

https://support.ptc.com/help/windchill/r12.1.2.0/en/#page/Windchill_Help_Center/customization/WCCG_UICust_CustHTMLClients_AttrPanel.html#

PetrH

Re: Introduce a new tab in WTDocument Page

HelesicPetr — Wed, 25 Jan 2023 13:12:11 GMT

I forgot mention very important point.

You should create own Validation class where you check if the action should be shown in the detailpage of your WTDocument subtype

definition in customaction

definition in service.properties

wt.services/svc/default/com.ptc.core.ui.validation.SimpleValidationFilter/hideDocValidator/null/0=cz.aveng.NewDocTab.DocValidator/duplicate

this validator hide the action if the subtype document is not "DOCINTERNALSUBSTRING" internal name ends with this string

validator class

package cz.aveng.NewDocTab; import com.ptc.core.ui.validation.DefaultSimpleValidationFilter; import com.ptc.core.ui.validation.UIValidationCriteria; import com.ptc.core.ui.validation.UIValidationKey; import com.ptc.core.ui.validation.UIValidationStatus; import wt.fc.Persistable; import wt.fc.WTReference; import wt.type.TypedUtilityServiceHelper; import wt.util.WTException; import wt.wvs.WVSLogger; import java.rmi.RemoteException; public class DocValidator extends DefaultSimpleValidationFilter { private static final WVSLogger logger = WVSLogger.getLogger(DocValidator.class, "cz.aveng.DocValidator"); public DocValidator() { } public UIValidationStatus preValidateAction(UIValidationKey valKey, UIValidationCriteria criteria) { UIValidationStatus validatioNStatus = UIValidationStatus.ENABLED; WTReference contextObject = criteria.getContextObject(); if (contextObject != null) { Persistable persistObject = contextObject.getObject(); String subtypeString = null; try { // get object type subtypeString = TypedUtilityServiceHelper.service.getExternalTypeIdentifier(persistObject); // if (!subtypeString.endsWith("DOCINTERNALSUBSTRING")) { validatioNStatus = UIValidationStatus.HIDDEN; } } catch (WTException | RemoteException e) { e.printStackTrace(); } } logger.debug("Exit DocValidator.preValidateAction() status=" + validatioNStatus); return validatioNStatus; } }

PetrH