使用加载程序创建追溯链接
本节介绍如何使用 Windchill 加载程序在 Windchill 可追溯对象和远程资源之间创建指定类型的追溯链接。
使用加载文件创建追溯链接
1. 创建一个 XML 加载文件，如本示例所示。
 |
• 在加载 XML 文件之前，必须检入所有 Windchill 可追溯对象。
• 系统不会验证远程资源 URI。验证 URI 值是否正确。
|
2. 使用以下命令从 Windchill shell 执行加载文件：
windchill wt.load.LoadFromFile -d Load File Location -u username -p password
|
|
检查方法服务器日志，了解追溯链接创建期间遇到的任何问题。
|
加载文件属性
XML 数据文件中使用以下属性:
|
属性
|
说明
|
必需还是可选
|
|---|---|---|
|
csvTraceLinkType
|
追溯链接的类型
|
必需
|
|
csvTraceLinkRoleAType
|
Windchill 可追溯对象的类型，如部件、文档、选项、选择、资源和标准控制特征
|
必需
|
|
csvTraceLinkRoleAObjectNumber
|
Windchill 可追溯对象的编号
|
必需
|
|
csvTraceLinkRoleBShape
|
远程资源的类型
|
必需
|
|
csvTraceLinkRoleBURI
|
远程资源的 URI
|
必需
|
|
csvTraceLinkLastModifiedTimeStamp
|
远程资源的上次修改时间戳 (纪元毫秒)
|
必需
|
|
|
除上表中列出的必填属性外，一些属性特定于 Windchill 可追溯对象类型。有关详情，请参阅以下示例。
|
XML 加载文件示例
|
|
可使用 XML 加载文件创建对象至对象和版本至版本的追溯链接：
• 对于对象至对象追溯链接，请将 csvCreateTraceLink 处理程序设置为 wt.trace.load.LoadTraceLink.createObjectToObjectTraceLink。
• 对于版本至版本追溯链接，请将 csvCreateTraceLink 处理程序设置为 wt.trace.load.LoadTraceLink.createVersionToVersionTraceLink。
|
有关在远程 URI 与部件、文档、选项、选择、资源和标准控制特征之间创建对象至对象追溯链接的信息，请参阅以下示例：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE NmLoader SYSTEM "standard13_1.dtd">
<NmLoader>
<!-- O2O LINKS -->
<!-- Part -->
<csvCreateTraceLink handler="wt.trace.load.LoadTraceLink.createObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>wt.part.WTPart</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>0000000001</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectName/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVersion>A</csvTraceLinkRoleAObjectVersion>
<!-- Optional -->
<csvTraceLinkRoleAObjectIteration/>
<!-- Optional -->
<csvTraceLinkRoleAObjectView>Design</csvTraceLinkRoleAObjectView>
<!-- Optional -->
<csvTraceLinkRoleAObjectVariation1/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVariation2/>
<!-- Optional -->
<csvTraceLinkRoleAOrgID/>
<!-- Optional -->
<csvTraceLinkRoleAOrgName/>
<!-- Optional -->
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest06-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1006</csvTraceLinkRoleBURI>
<csvTraceLinkLastModifiedTimeStamp>1752228120</csvTraceLinkLastModifiedTimeStamp>
</csvCreateTraceLink>
<!-- Option -->
<csvCreateTraceLink handler="wt.trace.load.LoadTraceLink.createObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>com.ptc.windchill.option.model.Option</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>00021</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectName>COLOR</csvTraceLinkRoleAObjectName>
<!-- Optional -->
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest06-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1006</csvTraceLinkRoleBURI>
<csvTraceLinkLastModifiedTimeStamp>1752228120</csvTraceLinkLastModifiedTimeStamp>
</csvCreateTraceLink>
<!-- Choice -->
<csvCreateTraceLink handler="wt.trace.load.LoadTraceLink.createObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>com.ptc.windchill.option.model.Choice</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>00021</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectName>RED</csvTraceLinkRoleAObjectName>
<!-- Optional -->
<csvTraceLinkRoleAOptionNumberForChoice>00021</csvTraceLinkRoleAOptionNumberForChoice>
<!-- Optional -->
<csvTraceLinkRoleAOptionNameForChoice>COLOR</csvTraceLinkRoleAOptionNameForChoice>
<!-- Optional -->
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest06-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1006</csvTraceLinkRoleBURI>
<csvTraceLinkLastModifiedTimeStamp>1752228120</csvTraceLinkLastModifiedTimeStamp>
</csvCreateTraceLink>
<!-- Document -->
<csvCreateTraceLink handler="wt.trace.load.LoadTraceLink.createObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>wt.doc.WTDocument</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>001</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectVersion/>
<!-- Optional -->
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest06-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1004</csvTraceLinkRoleBURI>
<csvTraceLinkLastModifiedTimeStamp>1753263533000</csvTraceLinkLastModifiedTimeStamp>
</csvCreateTraceLink>
<!-- MPMResource -->
<csvCreateTraceLink handler="wt.trace.load.LoadTraceLink.createObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>com.ptc.windchill.mpml.resource.MPMResource</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>0000000101</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectName/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVersion/>
<!-- Optional -->
<csvTraceLinkRoleAObjectIteration/>
<!-- Optional -->
<csvTraceLinkRoleAObjectView>Design</csvTraceLinkRoleAObjectView>
<!-- Optional -->
<csvTraceLinkRoleAObjectVariation1/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVariation2/>
<!-- Optional -->
<csvTraceLinkRoleAOrgID/>
<!-- Optional -->
<csvTraceLinkRoleAOrgName/>
<!-- Optional -->
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest06-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1000</csvTraceLinkRoleBURI>
<csvTraceLinkLastModifiedTimeStamp>1753263533000</csvTraceLinkLastModifiedTimeStamp>
</csvCreateTraceLink>
<!-- StandardCC -->
<csvCreateTraceLink handler="wt.trace.load.LoadTraceLink.createObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>com.ptc.windchill.mpml.pmi.MPMStandardCC</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>0000000001</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectName/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVersion/>
<!-- Optional -->
<csvTraceLinkRoleAObjectIteration/>
<!-- Optional -->
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest06-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1000</csvTraceLinkRoleBURI>
<csvTraceLinkLastModifiedTimeStamp>1753263533000</csvTraceLinkLastModifiedTimeStamp>
</csvCreateTraceLink>
</NmLoader>
<!DOCTYPE NmLoader SYSTEM "standard13_1.dtd">
<NmLoader>
<!-- O2O LINKS -->
<!-- Part -->
<csvCreateTraceLink handler="wt.trace.load.LoadTraceLink.createObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>wt.part.WTPart</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>0000000001</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectName/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVersion>A</csvTraceLinkRoleAObjectVersion>
<!-- Optional -->
<csvTraceLinkRoleAObjectIteration/>
<!-- Optional -->
<csvTraceLinkRoleAObjectView>Design</csvTraceLinkRoleAObjectView>
<!-- Optional -->
<csvTraceLinkRoleAObjectVariation1/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVariation2/>
<!-- Optional -->
<csvTraceLinkRoleAOrgID/>
<!-- Optional -->
<csvTraceLinkRoleAOrgName/>
<!-- Optional -->
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest06-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1006</csvTraceLinkRoleBURI>
<csvTraceLinkLastModifiedTimeStamp>1752228120</csvTraceLinkLastModifiedTimeStamp>
</csvCreateTraceLink>
<!-- Option -->
<csvCreateTraceLink handler="wt.trace.load.LoadTraceLink.createObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>com.ptc.windchill.option.model.Option</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>00021</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectName>COLOR</csvTraceLinkRoleAObjectName>
<!-- Optional -->
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest06-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1006</csvTraceLinkRoleBURI>
<csvTraceLinkLastModifiedTimeStamp>1752228120</csvTraceLinkLastModifiedTimeStamp>
</csvCreateTraceLink>
<!-- Choice -->
<csvCreateTraceLink handler="wt.trace.load.LoadTraceLink.createObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>com.ptc.windchill.option.model.Choice</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>00021</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectName>RED</csvTraceLinkRoleAObjectName>
<!-- Optional -->
<csvTraceLinkRoleAOptionNumberForChoice>00021</csvTraceLinkRoleAOptionNumberForChoice>
<!-- Optional -->
<csvTraceLinkRoleAOptionNameForChoice>COLOR</csvTraceLinkRoleAOptionNameForChoice>
<!-- Optional -->
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest06-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1006</csvTraceLinkRoleBURI>
<csvTraceLinkLastModifiedTimeStamp>1752228120</csvTraceLinkLastModifiedTimeStamp>
</csvCreateTraceLink>
<!-- Document -->
<csvCreateTraceLink handler="wt.trace.load.LoadTraceLink.createObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>wt.doc.WTDocument</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>001</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectVersion/>
<!-- Optional -->
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest06-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1004</csvTraceLinkRoleBURI>
<csvTraceLinkLastModifiedTimeStamp>1753263533000</csvTraceLinkLastModifiedTimeStamp>
</csvCreateTraceLink>
<!-- MPMResource -->
<csvCreateTraceLink handler="wt.trace.load.LoadTraceLink.createObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>com.ptc.windchill.mpml.resource.MPMResource</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>0000000101</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectName/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVersion/>
<!-- Optional -->
<csvTraceLinkRoleAObjectIteration/>
<!-- Optional -->
<csvTraceLinkRoleAObjectView>Design</csvTraceLinkRoleAObjectView>
<!-- Optional -->
<csvTraceLinkRoleAObjectVariation1/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVariation2/>
<!-- Optional -->
<csvTraceLinkRoleAOrgID/>
<!-- Optional -->
<csvTraceLinkRoleAOrgName/>
<!-- Optional -->
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest06-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1000</csvTraceLinkRoleBURI>
<csvTraceLinkLastModifiedTimeStamp>1753263533000</csvTraceLinkLastModifiedTimeStamp>
</csvCreateTraceLink>
<!-- StandardCC -->
<csvCreateTraceLink handler="wt.trace.load.LoadTraceLink.createObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>com.ptc.windchill.mpml.pmi.MPMStandardCC</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>0000000001</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectName/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVersion/>
<!-- Optional -->
<csvTraceLinkRoleAObjectIteration/>
<!-- Optional -->
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest06-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1000</csvTraceLinkRoleBURI>
<csvTraceLinkLastModifiedTimeStamp>1753263533000</csvTraceLinkLastModifiedTimeStamp>
</csvCreateTraceLink>
</NmLoader>
有关在单个小版本中的部件和多个远程 URI 之间创建对象至对象追溯链接的信息，请参阅以下示例：
<NmLoader>
<!-- O2O tracelinks -->
<csvBeginCreateTraceLink handler="wt.trace.load.LoadTraceLink.beginCreateObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>wt.part.WTPart</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>WCDS000127</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectName/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVersion>A</csvTraceLinkRoleAObjectVersion>
<!-- Optional -->
<csvTraceLinkRoleAObjectIteration/>
<!-- Optional -->
<csvTraceLinkRoleAObjectView>Design</csvTraceLinkRoleAObjectView>
<!-- Optional -->
<csvTraceLinkRoleAObjectVariation1/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVariation2/>
<!-- Optional -->
<csvTraceLinkRoleAOrgID/>
<!-- Optional -->
<csvTraceLinkRoleAOrgName/>
<!-- Optional -->
</csvBeginCreateTraceLink>
<csvAddRoleBToCreateTraceLink handler="wt.trace.load.LoadTraceLink.addRoleBToCreateTraceLink">
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest01-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1008</csvTraceLinkRoleBURI>
</csvAddRoleBToCreateTraceLink>
<csvAddRoleBToCreateTraceLink handler="wt.trace.load.LoadTraceLink.addRoleBToCreateTraceLink">
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest01-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1004</csvTraceLinkRoleBURI>
</csvAddRoleBToCreateTraceLink>
<csvEndCreateTraceLink handler="wt.trace.load.LoadTraceLink.endCreateObjectToObjectTraceLink"/>
</NmLoader>
<!-- O2O tracelinks -->
<csvBeginCreateTraceLink handler="wt.trace.load.LoadTraceLink.beginCreateObjectToObjectTraceLink">
<csvTraceLinkType>com.ptc.requirement.trace.links.SatisfyTraceLink</csvTraceLinkType>
<csvTraceLinkRoleAType>wt.part.WTPart</csvTraceLinkRoleAType>
<csvTraceLinkRoleAObjectNumber>WCDS000127</csvTraceLinkRoleAObjectNumber>
<csvTraceLinkRoleAObjectName/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVersion>A</csvTraceLinkRoleAObjectVersion>
<!-- Optional -->
<csvTraceLinkRoleAObjectIteration/>
<!-- Optional -->
<csvTraceLinkRoleAObjectView>Design</csvTraceLinkRoleAObjectView>
<!-- Optional -->
<csvTraceLinkRoleAObjectVariation1/>
<!-- Optional -->
<csvTraceLinkRoleAObjectVariation2/>
<!-- Optional -->
<csvTraceLinkRoleAOrgID/>
<!-- Optional -->
<csvTraceLinkRoleAOrgName/>
<!-- Optional -->
</csvBeginCreateTraceLink>
<csvAddRoleBToCreateTraceLink handler="wt.trace.load.LoadTraceLink.addRoleBToCreateTraceLink">
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest01-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1008</csvTraceLinkRoleBURI>
</csvAddRoleBToCreateTraceLink>
<csvAddRoleBToCreateTraceLink handler="wt.trace.load.LoadTraceLink.addRoleBToCreateTraceLink">
<csvTraceLinkRoleBShape>com.ptc.requirement.trace.resource.Requirement</csvTraceLinkRoleBShape>
<csvTraceLinkRoleBURI>https://solperftest01-az.ptcnet.ptc.com:8090/api/oslc/projects/3/rm/requirements/1004</csvTraceLinkRoleBURI>
</csvAddRoleBToCreateTraceLink>
<csvEndCreateTraceLink handler="wt.trace.load.LoadTraceLink.endCreateObjectToObjectTraceLink"/>
</NmLoader>