专业化管理 > 定制业务对象 > 类型和属性管理 > 使用类型和属性管理实用程序 > 管理类型 > 类型信息页面 > “属性”选项卡 > 创建新属性 > 别名属性映射
  
别名属性映射
别名属性映射至相关对象上的属性。通过在布局中包含别名属性,此映射允许将相关对象的信息显示在当前类型的用户界面上 (例如,信息页面或表格)。在“映射”属性中指定到其他属性的映射,这样通过使用运算符和类型与属性的内部名称即可导航对象链接和参考。
* 
特定别名映射只能在一种类型或其子类型中使用一次。如果使用相同映射定义另一个别名属性,则会出现错误。类型的 Logical Attributes Report 列出已用于该类型的映射,包括那些用于“类型和属性管理”实用程序中别名属性的映射。Logical Attributes Report“自定义” > “工具”中提供。有关详细信息,请参阅 Customization Tools Overview (自定义工具概述)。
有关如何显示布局中所包括的别名属性的信息,请参阅属性显示
映射语法
映射的起始点即定义别名属性时所在的对象,且不包括在“映射”属性值中。映射结束后 attribute 的值在用户界面中将显示为别名属性的值。
当定义映射时,将使用以下分隔符符号:
代字号符号 (~) 用在左侧的类型与右侧的属性之间,以标识在该类型上定义的特定属性。请查看下面 at 符号 (@) 的定义,将其视为例外情况。
<类型 A>~<类型 A 的属性>
脱字符符号 (^) 用在左侧的属性与右侧的类型之间,以通过该属性导航至此特定类型的实例。
<类型 A>~<类型 A 的属性>^<类型 B>
at 符号 (@) 用在左侧的属性与右侧的类型之间,以通过在右侧类型上定义的属性导航至此类型的实例。属性右侧的 at 符号 (@) 将优先于属性左侧的代字号符号 (~),以便于确定属性的定义位置。
<类型 A>~<类型 B 的属性>@<类型 B>
等于符号 (=) 用在左侧的属性与右侧的属性之间,以导航至右侧类型的实例,其中左右两侧的属性值相等。在等于符号 (=) 的左右两侧只能指定布尔型、整数、字符串和日期类型的模型化属性。
<类型 A>~<类型 A 的属性>=<类型 B 的属性>@<类型 B>
“映射”属性值的语法为:
<association>~<attribute>
其中:
<关联> 属于下列情况之一:
<关联>
含义:
<属性>^<类型>
导航至此对象所引用的其他对象
<属性>@<类型>
导航至引用此对象的其他对象
<属性>=<属性>@<类型>
导航至与此对象具有相同值的其他对象
* 
对于<属性>=<属性>@<类型>映射中的 attribute 条目,只能指定布尔型、整数、字符串和日期类型的模型化属性。模型化属性指存储在 LWCHardAttDefinition 表格中的那些属性。
<关联>~<关联>
导航至跨多个<关联>的对象,并将它们连接在一起
<属性>是在类型上定义的属性的内部名称。对于不显示在“类型和属性管理”实用程序中的类型的属性,请使用属性的模型化名称。
<typeName> 为类型的内部名称。对于不显示在“类型和属性管理”实用程序中的类型,请使用类型的类名称。
映射示例
以下是针对在内部名称为 wt.doc.WTDocument“文档”类型上所指定的别名属性的示例。
例如,如果“映射”属性值为
masterReference^wt.doc.WTDocumentMaster~name
,则表示将从当前 wt.doc.WTDocumentwt.doc.WTDocumentMaster 导航 masterReference 参考属性,并返回到 wt.doc.WTDocumentMastername 属性,如下图所示:
下图显示了由 wt.doc.WTDocumentUsageLink 链接类型链接到一起的两种类型,wt.doc.WTDocumentwt.doc.WTDocumentMasterwt.doc.WTDocumentUsageLink 链接类型有两个参考属性:usedBy (引用 wt.doc.WTDocument) 和 uses (引用 wt.doc.WTDocumentMaster)。
usedBy 参考属性用于在 wt.doc.WTDocument 对象和引用其的 wt.doc.WTDocumentUsageLink 对象之间进行导航。由于 usedBy 属性是在即将导航至的类型上定义的,因此,请使用 at 符号 (@) 分隔符符号。
以下“映射”值:
usedBy@wt.doc.WTDocumentUsageLink~uses^wt.docWTDocumentMaster~name
先导航至具有引用当前 wt.doc.WTDocument 对象的 usedBy 属性的 wt.doc.WTDocumentUsageLink 对象,然后导航至由 wt.doc.WTDocumentUsageLink 对象上的 uses 属性所引用的 wt.doc.WTDocumentMaster 对象,之后再检索这些 wt.doc.WTDocumentMaster 对象的名称。
其他别名映射示例
下表提供了其他有关别名属性映射的示例:当属性或类型在“类型和属性管理”使用程序中为可视项时,则显示名称将包含在映射说明中。对于不显示在“类型和属性管理”使用程序中的类型及其上的属性,将使用类型的类名称和该类型上属性的模型化名称;其中很多都位于本主题末尾的常用链接对象表格中。
当前对象
映射属性值
说明
“活动”com.ptc.projectmanagement.plan.PlanActivity
containerReference^wt.projmgmt.admin.Project2~containerInfo.name
导航至当前“活动”(com.ptc.projectmanagement.plan.PlanActivity) 对象上的“上下文”(containerReference) 属性所引用的“项目”(wt.projmgmt.admin.Project2) 对象,然后从“项目”(wt.projmgmt.admin.Project2) 对象中检索“名称”(containerInfo.name) 属性。
“文档”(wt.doc.WTDocument)
describedBy@wt.part.WTPartDescribeLink~describes^wt.part.WTPart~name
先导航至如下 wt.part.WTPartDescribeLink 对象:具有引用当前“文档”(wt.doc.WTDocument) 对象的 describedBy 属性,然后导航至 wt.part.WTPartDescribeLink 对象上的 describes 属性所引用的“部件”(wt.part.WTPart) 对象,之后再检索“部件”(wt.part.WTPart) 对象上的 name 属性。
“资源分配”(com.ptc.projectmanagement.assignment.ResourceAssignment)
parentReference^com.ptc.projectmanagement.plan.PlanActivity~deadline
导航至当前“资源分配”(com.ptc.projectmanagement.assignment.ResourceAssignment) 对象上的“父项参考”(parentReference) 属性所引用的“活动”(com.ptc.projectmanagement.plan.PlanActivity) 对象,然后从“活动”(com.ptc.projectmanagement.plan.PlanActivity) 对象中检索“最后期限”(deadline) 属性。
“部件”(wt.part.WTPart)
describes@wt.part.WTPartDescribeLink~describedBy^wt.doc.WTDocument~publisher
此映射假定您已在“文档”(wt.doc.WTDocument 对象类型) 上创建了“发布者”(publisher) 属性。
导航至如下 wt.part.WTPartDescribeLink 对象:具有引用当前“部件”(wt.part.WTPart) 对象的 describes 属性,然后导航至“部件”(wt.part.WTPart) 对象上的 describedBy 属性所引用的“文档”(wt.doc.WTDocument) 对象,之后再检索这些“文档”(wt.doc.WTDocument) 对象上的“发布者”(publisher) 属性。
“部件”(wt.part.WTPart)
name=title@wt.doc.WTDocument~description
导航至如下“文档”(wt.doc.WTDocument) 对象:具有与当前“部件”(wt.part.WTPart) 对象上的“名称”(name) 属性相匹配的“标题”(title) 属性,然后检索“文档”(wt.doc.WTDocument) 对象上的“说明”(说明) 属性。
“文档”(wt.doc.WTDocument)
usedBy@wt.doc.WTDocumentUsageLink~uses^wt.doc.WTDocumentMaster~name
导航至如下 wt.doc.WTDocumentUsageLink 对象:具有引用当前“文档”(wt.doc.WTDocument) 对象的 usedBy 属性,然后导航至 wt.doc.WTDocumentUsageLink 对象上的使用属性所引用的“文档主数据”(wt.doc.WTDocumentMaster) 对象,然后检索这些“文档主数据”(wt.doc.WTDocumentMaster) 对象上的“名称”(name) 属性。
常用链接对象
下表列出了常用的 Windchill 链接对象及其关系。此信息在别名属性映射中非常有用。
自对象
自关系
链接对象
至关系
至对象
wt.doc.WTDocument
usedBy
wt.doc.WTDocumentUsageLink
uses
wt.doc.WTDocumentMaster
wt.doc.WTDocument
describes
wt.doc.WTDocumentDependencyLink
describedBy
wt.doc.WTDocument
wt.doc.WTDocument
describedBy
wt.part.WTPartDescribeLink
describes
wt.part.WTPart
wt.part.WTPart
usedBy
wt.part.WTPartUsageLink
uses
wt.part.WTPartMaster
wt.part.WTPart
referencedBy
wt.part.WTPartReferenceLink
references
wt.doc.WTDocumentMaster
wt.part.WTPart
buildTarget
wt.epm.EPMBuildRule
buildSource
wt.epm.EPMDocument
wt.part.WTPart
describes
wt.epm.EPMDescribeLink
describedBy
wt.epm.EPMDocument
wt.part.WTPartMaster
alternates
wt.part.WTPartAlternateLink
alternateFor
wt.part.WTPartMaster
wt.part.WTPartUsageLink
substituteFor
wt.part.WTPartSubstituteLink
substitutes
wt.part.WTPartMaster
wt.epm.EPMDocument
contains
wt.epm.structure.EPMContainedIn
containedIn
wt.epm.familytable.EPMFamilyTable
wt.epm.EPMDocument
usedBy
wt.epm.structure.EPMMemberLink
uses
wt.epm.EPMDocumentMaster
wt.epm.EPMDocument
referencedBy
wt.epm.structure.EPMReferenceLink
references
wt.epm.EPMDocumentMaster
wt.epm.EPMDocument
variant
wt.epm.structure.EPMVariantLink
generic
wt.epm.EPMDocumentMaster
wt.change2.WTChangeOrder2
addressedBy
wt.change2.AddressedBy2
addresses
wt.change2.WTChangeRequest2
wt.change2.WTChangeActivity2
includedIn
wt.change2.IncludedIn2
includes
wt.change2.WTChangeOrder2