有效载荷和内容清单
有效载荷 Zip 文件
有效负载文件是从 WVS 发送到 Arbortext Publishing Engine 服务器的 zip 文件。有效载荷中包含将用于生成所需输出的内容和元数据。有效载荷内容由两个因素确定:所请求的已发布输出类型,以及请求是针对全部发布作业还是针对增量发布作业。发布可以从信息结构、发布结构或产品层次结构中启动。
有效载荷的文件集中可能包含下列文件,具体取决于发布请求和结构类型:
• manifest.xml
列出有效载荷中所有对象的明细。其中的条目表示有效载荷文件内容的清单。内容清单中还包括其他信息,如指向发布规范的 Windchill 路径、服务器主机名、创建日期、输出类型和根结构的 URI 等。
• PublishInfo.xml
列出与用于创建有效载荷的环境和系统相关的详细信息。
◦ 有效负载版本
◦ Windchill 版本的系统输出
◦ 版本切换
◦ 发布作业规范,包括 WVS 发布作业 ID。
◦ 基本服务结构信息与属性
在束中,PublishInfo.xml 也包含束版本,Arbortext Publishing Engine 版本及事务处理 ID。
PublishInfo.xml 中包含的服务结构属性可在 publishinfo_attset.xml 中进行配置。
• windchill.type.name 目录
一个或多个包含结构内容 (如动态文档) 的目录。名称将根据 Windchill 类型形成。可以存在其中的一个或多个目录。
• windchill.partlist.PartList 目录
包含部件列表的目录,这些部件列表以 partslist.xml 常规批注格式进行序列化。
• 自定义目录
Windchill 中包含自定义制品的目录。自定义制品可以是非
Windchill 对象或者未链接到发布结构、信息结构或产品层次结构的对象。此目录的创建、向此目录添加自定义制品以及将目录添加至有效负载均由
CustomArtifactProvider 扩展进行控制。有关详细信息,请参阅
发布的高级自定义。
• Identfier.xml
是以 WVS 所发送的常规批注格式序列化为 XML 文件的根服务结构。将生成 Identfier。此文件是表示待处理根结构的 XML 文件。
发布束时,结构由 URI 标识,该 URI 为不受语言影响的固定值。
• ProductInstances.xml
包含与产品层次结构关联的产品实例信息,如果存在,格式为序列化 XML。
ProductInstances.xml 元数据属性可在 publishable_attset.xml 中进行配置。
对于有效负载中的对象,ResourceMap 信息中的内容元素包含表示文件角色的角色属性。例如,对于一个文件而言,角色 = "THUMBNAIL_SMALL" 即表示该文件是对象的缩略图。
• reps
包含 ResourceMap 元素 (指定为各种 XML 制品) 所参考的表示。这些表示的明细未在有效载荷内容清单中列出。
• pubspec.xml
包含基于选定 WVS 发布规则进行发布的规范,已变换为供 Arbortext Publishing Engine 服务器使用的 XML 格式。选择发布规则后,其规范将置于 pubspec.xml 中,并由 WVS 发送至 Arbortext Publishing Engine。
另一个 pubspec.xml 文件位于 Arbortext Publishing Engine 服务器中,通常在服务应用程序内,其中包含发布参数的默认值集。从 WVS 发送的 pubspec.xml 中指定的参数值会覆盖 Arbortext Publishing Engine 服务器上文件中的默认值 (如果已设置)。默认情况下,服务应用程序的以下位置中存在包含默认值的 pubspec.xml 文件:
Arbortext-path\application\com.ptc.arbortext.service\lib\pubspec.xml
如果要对服务器上 pubspec.xml 中的默认值进行更改,请在更改之前保存该文件的备份副本。
• OptionsDefinition.xml
指定传递给束的结构。
如果为配置文件配置了选项集,则会包含选项定义。有关详细信息,请参阅
在发布中的适用性。
• referencedObjects.xml
包含未包括在有效负载中的参考对象的元数据。
可以设置要包括在 referencedObjects_attset.xml 中的自定义属性集。
• referencedParts.xml
包含在有效负载中引用的所有部件的元数据。
对于有效负载中的对象,ResourceMap 信息中的内容元素包含表示文件角色的角色属性。例如,对于一个文件而言,角色 = "THUMBNAIL_SMALL" 即表示该文件是对象的缩略图。
• relatedParts.xml
包含部件列表中被其他部件取代或具有备用部件的各个部件之间的关系。
您可以通过将属性输入到 publishable_attset.xml 文件中来指定要包括的属性。条目需要指定为相关部件发布的属性的列表。
• classifications.xml
包含有效载荷中使用的“部件”分类类别的名称、属性及默认值。
分类子项属性不受
publishable_attset.xml 控制。您可以排主要分类属性本身,以排除所有与分类关联的属性 (包括子项属性)。有关详细信息,请参阅
在 Windchill 中分类部件。
• partThumbnails.zip
包含部件的缩略图图形图像。缩略图是束中参考的各个部件的默认表示,其具有角色。
一个部件可以具有多个缩略图,而各个缩略图由其角色进行标识。thumbnailRole 发布参数可指定束中包括的角色。
您还可以使用 PartResources 参数指定要包括的缩略图。借助 PartResources,您可以更为灵活地指定多个缩略图角色以及要包括的 PVZ 组件。
这两个参数均可用于处理特殊 PVZ 值。对于 thumbnailRole,默认表示将压缩为 PVZ 文件,并用作部件的缩略图。当值为角色时,与指定角色匹配的缩略图将置于 partThumbnails.zip 中。将 PartResources 与 PvzFilter 参数结合使用时,您可以指定多个角色和 PVZ 组件。
两个缩略图参数均设置完毕后,partThumbnails.zip 的内容将为处理两个参数所获得的产物。
• translation.xml
包含在发布过程中找到的可本地化的元数据字符串。会将此文件复制到束。该文件包含有效负载每种目标语言的 Target 元素 (在 xml:lang 中指定)。Target 元素针对每个指定 xml:lang 的每一可本地化属性均包含一个 Value 元素。可本地化属性在 localizable_attset.xml 中指定。
• ContentMap.xml
包含到束中的本地内容的 URI 映射。每个映射都包括 .meta 文件的路径、内容的路径和内容的 URI。路径会相对于束的根。
• relatedContexts.xml
包含与 Windchill 中的服务结构相关联的产品层次结构信息。该文件包含服务结构与一个或多个产品层次结构之间关系的信息。
|
产品层次结构文件是一个单独文件。此文件从产品层次结构束中发布。对于有效负载中的对象,ResourceMap 信息中的内容元素包含表示文件角色的角色属性。例如,对于一个文件而言,角色 = "THUMBNAIL_SMALL" 即表示该文件是对象的缩略图。
|
• SymptomTree.xml
将使用“症状集”文档类型创作的症状值包含在一个树结构中。在发布过程中,针对每个站点、每种语言,仅生成一个 SymptomTree.xml 文件。
仅当症状集处于“已发布”状态时,才会进行发布。如果 Windchill 服务器中有多个症状集处于“已发布”状态,则束的发布将失败。可以通过 wt.properties 文件中的 com.ptc.arbortext.windchill.siscore.SKDSymptomsTreeReadyState 特性配置症状集的就绪状态。此特性的默认值设置为已发布。
您可以配置一些要包括在内容清单中以及为翻译、参考对象和发布所发送的 XLIFF 中的属性。有关详细信息,请参阅
定义属性集。