定义属性集

其他功能 > 服务信息管理 > 配置指南 > 配置属性 > 定义属性集

定义属性集

AttributeSet 配置文件

AttributeSet 的标记定义可为每个属性类定义默认 include 或 exclude 行为。AttributeSet 配置文件的路径如下：

<Windchill-path>\codebase\com\ptc\arbortext\windchill\siscore\attset\xml

在配置文件中定义一组属性时，请确保将单一类型的所有属性组合在一起。

有多个配置文件可供使用：

• localizable_attset.xml

定义要以 XLIFF 文件发送以进行翻译的属性集。例如，文件的两个部分将标识 name 属性：

• manifest_attset.xml

定义要作为内容清单中的元数据而发送的属性集。例如，文件的一个部分可标识“部件列表”的属性：

• publishable_attset.xml

定义要作为元数据发送到 Arbortext Publishing Engine 以供发布的属性集。例如，文件的一个部分可标识发布结构的属性：

将 Windchill 中的枚举类型属性作为对象的元数据进行发布。在以下示例中，枚举类型为关键 ”INWORK”，而值 In Work 为名称：

在文件摘录中，通过对属性进行标识，可同时反映 lifeCycleState 的名称和枚举类型，其中关联的 token 属性实际上指定了枚举类型 (此情况下为 wt.lifecycle.State) 的完整 Java 类名称。

您可以指定“部件”分类类别属性。如果执行此操作，则系统将自动包括或排除子项分类属性。您可以排除主要分类属性本身，以排除所有与分类关联的子项属性。有关分类属性的详细信息，请参阅在 Windchill 中分类部件。

在 publishable_attset.xml 中，请勿更改或移除 thePersistInfo.modifyStamp 和 thePersistInfo.updateStamp 的任何属性 include 操作。这些操作将通过文件进行指定，并在 Arbortext Content Delivery 束中使用。

如果要执行自定义子类型，则需要将这些语句添加到规范中。

• referencedObjects_attset.xml

定义属性集，所述属性参考了 Windchill 中其他要包括在束的 referencedObjects.xml 中的对象。例如，文件的一个部分可标识动态文档 (EPMDocuments 的子类型) 的属性：

参考另一对象的属性必须定义明确，这样才能被视为参考属性。

• publishinfo_attset.xml

定义一组要在有效载荷文件 publishinfo.xml 中包括或排除的属性，该有效载荷文件与待发布的服务结构相关。例如，默认情况下，该文件定义发布结构和信息结构 (由其类型标识) 将包括待发布结构的名称、编号和组织名称：

Type name="com.ptc.sis.PsRoot">
<Attribute action="include" name="name" />
<Attribute action="include" name="number" />
<Attribute action="include" name="orgName" />
</Type>
<Type name="com.ptc.sis.IsRoot">
<Attribute action="include" name="name" />
<Attribute action="include" name="number" />
<Attribute action="include" name="orgName" />
</Type>

通过遵循设置用于管理自定义文件和文本定制的目录结构和 PTC 提供的自定义文件最佳做法中的建议，可以维护这些文件的自定义版本。

AttributeSet 更新命令

可能无法立即加载对属性集文件所做的更改，例如，正在等待更新的发布作业运行时。对属性设置配置文件进行更改后，在 Windchill shell 中重新启动服务器以使更改生效。

如果无法立即重新启动 Windchill，可转为手动清除缓存：

1. 打开 Windchill shell。

2. 输入下面的命令：

windchill com.ptc.arbortext.windchill.publisher.cmdline.
CleanCacheAttibuteSet

该命令可清除缓存并加快更改进程。

Windchill 属性类别

• LWCIBAAttDefinition - 基于实例的属性或 IBA

• LWCHardAttDefinition - 模型化或不可变属性

• LWCLogicalAttDefinition - 逻辑属性

• LWCNonPersistedAttDefinition - 非持续属性

• LWCFlexAttDefinition - 可变属性 (先前称为弹性属性)

• LWCAttributeSetAttDefinition - 属性集

适用于结构的类型属性

下表显示了可自定义的类型属性的列表：

名称和类型	逻辑形式 (不完整类型名称)	说明
部件，结构节点	wt.part.WTPart	部件 (模型化)
信息基础，结构节点	com.ptc.sis.Base	衍生自所有发布结构和信息结构对象的 WTPart 的抽象基本类型。
分区基础，结构节点	com.ptc.sis.BaseDiv	在发布结构和信息结构中使用的分区类型的抽象基本类。
发布结构，结构节点	com.ptc.sis.PsRoot	发布结构根对象。
发布部分，结构节点	com.ptc.sis.PsSection	发布结构中的分区或部分。
信息结构，结构节点	com.ptc.sis.IsRoot	信息结构根对象。
信息组，结构节点	com.ptc.sis.IsGroup	信息结构中的分区或部分。
内容基础，结构节点	com.ptc.arbortext.sis.Content	内容参考和特殊节点的抽象基础。
内容载体，参考节点	com.ptc.sis.ContentRef	内容文件的通用参考。
插图载体，参考节点	com.ptc.sis.IllustrationRef	图形“动态文档”的参考。
部件列表载体，参考节点	com.ptc.sis.PartsListRef	“部件列表”对象的参考。
文本内容载体，参考节点	com.ptc.sis.TextualContentRef	“动态文档”(XML、PDF、文本等) 的参考。
特殊基础，结构节点	com.ptc.sis.PsSpecial	表示生成文本标记的抽象基础。
目录，结构节点	com.ptc.sis.PsToc	在发布结构中指示目录出现位置的标记。
索引，结构节点	com.ptc.sis.PsIndex	在发布结构中指示索引出现位置的标记。
信息使用关系链接，参考对象	com.ptc.sis.BaseUsageLink	用于创建 Windchill Service Information Manager 结构 (模型化) 的两个“基础”节点之间的链接。
部件使用关系链接，参考对象	wt.part.WTPartUsageLink	用于创建结构 (模型化) 的两个 WTPart 节点之间的链接。
部件列表，参考对象	com.ptc.arbortext.windchill.partlist.PartList	“部件列表项”(模型化) 的“部件列表”容器。
部件列表项，参考对象	com.ptc.arbortext.windchill.partlist.PartListItem	链接到实际部件 (模型化) 的“部件列表项”。
EPMDocument，参考对象	wt.epm.EPMDocument	任意 EPMDocument。DynamicDocument (模型化) 的基本类型。
DynamicDocument，参考对象	com.ptc.ptcnet.DynamicDocument	保留文本或图形内容的 Arbortext 动态文档。
Xliff Link，参考对象	com.ptc.sis.XliffLink	翻译文档的链接。

AttributeSet 元素

定义所有对象属性或特定类属性的默认操作。子 Type 元素允许覆盖 Persistable 类型的默认行为。

AttributeSet 元素的属性可定义为下列项目：

• default

未由更特定测试包括或排除的所有属性的默认操作。

• hard

未由更特定测试包括或排除的所有 hard (LWCHardAttDefinition) 属性的默认操作。

• soft

未由更特定测试包括或排除的所有 soft (LWCFlexAttDefinition) 属性的默认操作。

• iba

未由更特定测试包括或排除的所有 iba (LWCIBAAttDefinition) 属性的默认操作。

• logical

未由更特定测试包括或排除的所有 logical (LWCLogicalAttDefinition) 属性的默认操作。

• classification

未由更多特定测试包括或排除的所有 classification 属性的默认操作。如果不存在，请使用 iba 属性的值。有关这些属性的详细信息，请参阅“分类属性”。

• nonPersisted

未由更特定测试包括或排除的所有 nonPersisted (LWCNonPersistedAttDefinition) 属性的默认操作。

• set

未由更特定测试包括或排除的所有 set (LWCAttributeSetAttDefinition) 属性的默认操作。

例如：

Type 元素

Type 元素可用于针对实现 Persistable 接口 (允许从数据库读取和写入对象) 的任何对象，指定要执行 include 或 exclude 操作的 Windchill 属性。类型是模型化 (不可变) 类型，或是以模型化类型或其他子类型为基础的子类型。子类型使用“类型和属性管理器”或加载程序文件创建和管理。

<!ELEMENT Type ( Attribute* )>
<!ATTLIST Type
name CDATA #REQUIRED
token NMTOKENS #IMPLIED
default (include | exclude) #IMPLIED
>

Type 元素的属性可定义为下列项目。

• name

可变或模型化类型的逻辑形式。分类属性使用以“@”开头的 name 值标识。

• token

可用于将语意映射为此类型的可选名称或名称集合。

• default

包括或排除缺少更特定设置的所有此类型属性的默认操作。

所有类型都可按照名为 Logical Form (也称为 LogicalID) 的类型名称字符串标识。逻辑形式必须在站点级别具有唯一性，因为它会唯一标识类型。例如 (忽略换行符)：

com.ptc.ptcnet.DynamicDocument =>
WCTYPE|wt.epm.EPMDocument|com.ptc.ptcnet.DynamicDocument
wt.part.WTPart => WCTYPE|wt.part.WTPart

第一个示例为 EPMDocument 的 DynamicDocument 子类型的名称，而第二个示例为模型化类型 wt.part.WTPart 的名称。逻辑形式会映射为类型的外部形式。如果为模型化类型，则对象的 java 类名称将以 WCTYPE| 为前缀。如果为子类型，则名称为基本类型 (可变或不可变) 的名称，其后加上竖线 | 以及用户定义的类型名称。逻辑形式通常与外部形式的最后段相同。但是，只要逻辑形式具有唯一性，您就可以定义自己的逻辑形式。

例如：

Attribute 元素

Attribute 元素主要指定对属性集中的特定 Windchill 属性执行 include 还是 exclude 操作。也可用于为属性或其值定义语义。

<!ELEMENT Attribute ( Choice* )>
<!ATTLIST Attribute
name CDATA #REQUIRED
token NMTOKENS #IMPLIED
type CDATA #IMPLIED
action (include | exclude) #REQUIRED
>

Attribute 元素的属性可定义为下列项目。

• name

逻辑形式中的属性名称。

• token

可用于将语意映射为此属性的可选名称或名称集合。

• type

指定要包括或排除的属性类型的字符串。type 支持的唯一值是 reference。

如果将属性及其类型的 name 指定为 reference，则会将属性值定义为参考对象。

• action

要针对此属性执行的操作。

此操作 (如果指定) 是该属性的最高优先级设置。可能会忽略 action 并允许下一个较高优先级设置控制属性集中此属性的包含内容。

属性为模型化 (不可变) 类型或是可变属性。可变属性使用“类型和属性管理器”或加载程序文件创建和管理。所有属性都可按照名为 Logical Form 的属性名称字符串进行标识。逻辑形式必须对于对象类型具有唯一性，因为它会唯一标识该类型的属性。例如，以下内容会将属性的逻辑形式映射为其外部形式：

指定类型上的字符串 name 仅会唯一标识一个属性。第一个示例标识 wt.part.WTPart 类型的“基于模型的属性”(MBA)。第二个示例标识 wt.doc.WTDocument 的属性。第三个示例是 wt.epm.EPMDocument 类型的 filename 属性。最后一个示例声明先前属性的别名。对象类型不包括在属性的外部形式中。

例如：

通过将属性及其类型的 name 指定为 reference，属性值会被定义为参考对象，而且其 URI 将在有效负载中进行转换，以便您能够在 Arbortext Content Delivery 中找到对象。

Attribute action="include" name="PartListVersionRef" type=”reference”

Choice 元素

Choice 元素可定义属性的可能值。它不会影响要创建的属性集中包含或排除的属性。但会定义用于下游处理的值的范围。此外，可将一个或多个标记与值相关联，以在下游处理中为该值提供特殊语义。Choice 元素的内容为表示父 Attribute 元素的可能值的字符串。

<!ELEMENT Choice (#PCDATA) >
<!ATTLIST Choice
token NMTOKENS #IMPLIED
>

Choice 元素的 token 属性会定义为可用于将语意映射为此值的可选名称或名称集合。

例如，要扩展 Attribute 示例：

计算属性集包含

AttributeSet 配置文件的设计，是为了在不同级别使用明确操作定义属性集。形式为 Element.attribute_of_element。所支持级别如下所示，以降序或优先级排序。

• Attribute.action：特定对象类型 (Type.name) 的特定属性 (Attribute.name)

• Type.default：对象类型 (Type.name) 的所有属性值

• AttributeSet.hard、AttributeSet.soft、AttributeSet.iba 等：某类的所有属性

• AttributeSet.default：所有属性值

一般而言，设置越特定，指定给该操作设置的优先级越高。在特定级别忽略对属性的操作，意味着必须检查优先级的下一个最高级别，以查看是否针对该属性提供明确操作。当找到明确操作时，停止搜索。如果找不到明确操作，则会使用默认行为。

系统默认行为取决于上下文。例如，本地化的默认属性集与序列化的默认集不同。发布结构所包含的不可变属性有：

• name

• state.state

• versionIdentifier.versionId

例如，将发布结构或信息结构序列化至有效载荷时，默认行为是包括所有 soft、iba 和 logical 属性以及不可变属性。

序列化参考其他对象的属性

要在有效载荷中指定对象参考的元数据，必须指定 Attribute 元素的 name 和 type 属性。例如：

参考对象属性放入有效载荷的 referencedObjects.xml 中。参考形式会从其 Windchill 标识符更改为可用于在将对象发布到 Arbortext Content Delivery 之后查找对象的 URI。

参考了对象的属性在有效载荷中以 Property 元素 (使用 token 属性标识) 表示。Value 元素具有 ref 属性，该属性用于将对象参考转换为 URI 以便将有效载荷发布至捆绑。多个属性在有效负载中会具有多个 Value 条目。

AttributeSet API

AttributeSet 配置文件用于标识 Windchill 对象的属性集。该集将随选定对象的不同而异。并非相同类型的所有对象都会针对该集的所有属性定义值，但该集是相同的。配置是上下文特定的。例如，您可能需要使用不同的 XML 文件来配置 localizable 和 publishable 属性。

AttributeSet 类是一或多个 AttributeSet 配置文件的 API。工厂方法 getAttributeSet 会按照 AttributeSet 配置文件列表中的定义，加载与上下文名称相符且文件扩展名为 .xml 的文件。

public class AttributeSet {

// Load one or more configuration files for a named context
and return an AttributeSet object
public static AttributeSet getAttributeSet(String context);

// Get the context for this AttributeSet
public String getContext();

// Test if a type/attribute is a member of this AttributeSet
public boolean isMember(String typeLogicalForm, String logicalForm);
public boolean isMember(TypeIdentifier type, AttributeTypeIdentifier att);

// Get the set of attributes and their types for an persistable object type.
public Map<String, AttributeTypeIdentifier> getAttributes
(String typeLogicalForm);
public Map<String, AttributeTypeIdentifier> getAttributes
(TypeIdentifier type);

// Get attribute values for a Persistable. Mapped object may be an array.
public Map<String, Object> getAttributeValues(Persistable wtobject);

}

这对您有帮助吗?