Servigistics InService 发布和加载 > 使用发布和加载 > 运行 PxTAL
  
运行 PxTAL
Px 束支持
束兼容性
TAL 支持 Servigistics InService 6.5 和 7.1 束。将根据束中的发布信息来确定版本。
* 
您只能加载 6.5 或 7.1 束中的一个。无法同时加载不同的类型。
束限制
以下是针对束数据的一些限制：
• 请勿在位于 Servigistics InService 束中的文件名中使用 "#" 字符。
如果有文件名包含此字符，则变换和加载进程将失败，并出现以下错误：
[ERROR,ProcessActionHandler] Failed node: fetchApplicableFilesForPartsList within flow:getRegistryFromIMANSubFlow_PD , reason #path to a partslist item(The system cannot find the file specified) java.io.FileNotFoundException:#path to a partslist item(The system cannot find the file specified)
• 请勿在 APEX 特性值中使用竖线 ( | ) 字符，除非用其表示逻辑 OR。
Px 束内容
Px 束包含的文件夹和文件如下表所示：
名称
文件/文件夹
说明
com.ptc.arbortext.windchill.partlist.PartList
文件夹
包含从 *-DMPmap.xml 中引用的部件列表。文件夹名称通常是基于 SIM/SP 中所创建数据的类型名称。
com.ptc.ptcnet.DynamicDocument
文件夹
包含从 *-DMPmap.xml 中引用的动态文档。通常，内容特定于 DITA XML、常规 XML、PDF 或图像。文件夹名称通常是基于 SIM/SP 中所创建数据的类型名称。
reps
文件夹
包含 *_Hierarchy.xml 的关联图像。
*_Hierarchy.xml
文件
产品层次结构文件提供产品结构的层次信息。
*_Hierarchy.xml.meta
文件
产品层次结构元数据文件
*-DMPmap.xml
文件
信息结构 (IS) 或发布结构 (PS) 文件，通常会提供目录。也会在层次结构中显示数据。
*-DMPmap.xml.meta
文件
IS 或 PS 关联的元数据文件
OptionsDefinition.xml
文件
选项和选择列表的定义及其与上下文 (PH 或IS) 的关联。
partThumbnails.zip
文件
与部件相关的图像。
ProductInstances.xml
文件
产品实例文件提供上下文映射的序列号。此文件在单个文件中包含多个值。
publishInfo.xml
文件
与已发布束相关的元数据信息。此文件通常指示束 ID、发布日期、区域设置、束序列以及指示束是完全束还是增量束的标志。
此文件包含 Bundle-Source 参数，用于标识束的所有者。如果此特性不存在，则 TAL 默认使用来自束源 Rootobjects 中的特性 orgName。
束是完全束还是增量束取决于以下特性：
• JobSpecification/@increment
• JobSpecification/@incremental
完全束将具有值 increment="0" 或 incremental="false"。增量束将具有值 increment="1" 或 incremental="true"。
束的语言由 JobSpecification 元素下的 Language 参数标识。
<JobSpecification
…………………………..
<Parameter token="com.ptc.arbortext.
wvs/Language">
<Value>ja</Value>
</Parameter>
<Parameter token="Language">
<Value>ja</Value>
</Parameter>
……………….
</JobSpecification>
ReadyForTAL
文件
指示束可用于 TAL 的零字节 sentinel 文件。如果此文件不存在，则束不会被处理。
referencedObjects.xml
文件
指示从不同对象引用的多个对象。
在典型的 IS 束中，包含通过 relatedContext.xml 连接的上下文 (作为目标属性) 的 URI。此文件还提供了有关 URI 和相关对象的详细信息，以及与 ServiceInformation 属性相关的 PRODUCT 详细信息。
referencedParts.xml
文件
部件特定文件，此文件提供了从部件列表引用的所有部件的详细信息。
relatedContexts.xml
文件
表示束 （通常为 IS 或 PS） 所关联的上下文。
relatedParts.xml
文件
提供部件关系的相关信息，例如替换、取代、交叉引用等。
translation.xml
文件
提供在诸如 PH、IS、PS、PL、IEXML、PDFM、图形和部件等不同业务对象中使用的本地化属性的本地化值。
excludedObjects.xml
文件
提供要从先前已发布内容中删除的内容的 URI。
ModelItemPartObjects.xml
文件
通用 IE 制品，用于创建从源 IEXML 到零个或多个相关 IEXML 对象的链接。
contentMap.xml
文件
映射文件，用于提供物理文件映射的 URI。还包括校验和、元校验和以及用于确定是否需要加载数据的收集日期的值。
信息结构和发布结构
*-DMPMap.xml 文件表示 IS 或 PS 文件。该部分将介绍这些实体的组件。使用的术语来自于 SIM/SP 中使用的语言。例如，IsRoot 是以 …|com.ptc.sis.IsRoot 结尾的 wt.part.WTPart 可变类型。
信息结构包含以下节点：
• 节点 <topicref>
◦ IsRoot
◦ IsGroup
◦ ContentRef (为内容载体)
• 从父节点到子节点的使用链接
• 指向任何上述节点的服务有效性
• 上述节点的选定表示
结构可能会引用图形、XML 文档或部件列表。它也可能会从这些引用的对象中获取元数据。
发布结构包含以下节点：
• 节点 (包括生成的挂接) <topicref>
◦ PsRoot
◦ PsSection
◦ PsToc
◦ PsIndex
◦ ContentRef
• 从父节点到子节点的使用链接
• 指向任何上述节点的服务有效性
结构可能会引用 XML 文档或部件列表。它也可能会从这些引用的对象中获取元数据。
这些结构之一中的典型节点如下所示：
<topicref id="..."
href="uri of node"
copy-to="relative path of Information Element (IE)"
format="dita|pdf|xml|…"
...>
增量束的“信息元素”无更改，则 copy-to 属性不存在。
信息元素
全部信息元素均由主要内容及其元数据组成。Px 束支持以下类型的内容。
部件列表组件
• 部件列表本身
• 图像 GDD (图形动态文档) 或其后期发布的 GDD
◦ 主要内容
◦ 其表示
◦ 其附件
• 部件列表项
◦ 部件
• 从父节点到子节点的使用链接
• 指向任何上述内容的服务有效性
XML 文档组件
• 主要 DD (动态文档)
◦ 其元数据
◦ 其主要内容
• 引用的图像
◦ 主要内容
◦ 其表示
◦ 其附件
• 发布进程中已解决的 XML 内容
◦ Xinclude
◦ DITA 主题参考
◦ DITA conref、conkeyref 等
对外部 XML 文档的交叉引用不属于实体的组件。
图形内容
• 主要 GDD (图形动态文档)
◦ 其元数据
◦ 其主要内容
◦ 其表示
◦ 其附件
部件
• 部件
◦ 元数据 (主数据和实例)
◦ 相关部件
◦ 指向部件的服务有效性
◦ 缩略图
当前部件已提取且发布，但发布并不将其视为一个实体，而是部件清单列表的一个组件。当前发布包括相关部件。
服务有效性标记
服务有效性不是一个实体，而是与多个实体关联的信息。它表示不同 IE 对象的筛选信息。它作为元数据出现在其指向的任何对象中。例如：
<Metadata ...
<Property token="ServiceEffectivity">
<Value>(OR (AND (PRODUCT '0000016602') (INSTANCE 'SUV_WE_EV4_SN001'
'SUV_WE_EV4_SN002')) (AND (PRODUCT '0000016610') (INSTANCE
'SUV_WE_EE_SN002' 'SUV_WE_EE_SN001')) (AND (PRODUCT '0000016611')
(INSTANCE 'SUV_WF_EV6T_SN001' 'SUV_WF_EV6T_SN002')) (AND (PRODUCT
'0000016617') (INSTANCE )))</Value>
</Property>
...
</Metadata>
束类型
在 Servigistics InService 中，有以下两种类型的 Px 束。将根据 publishInfo.xml 文件来确定束类型。
支持下列类型：
• PH 束
此类束中包含统一的产品层次结构和相关产品实例的信息。通常，此束具有以下类型的数据：
◦ 产品层次结构 (PH) (*Hierarchy.xml)
◦ 产品实例 (PI) (ProductInstances.xml)
◦ 选项和选择 (OptionsDefinitions.xml)
◦ PublishInfo.xml
• IS 或 PS 束
此类束中包含信息结构 (IS) 或发布结构 (PS) 的相关信息。通常，此束具有以下类型的数据：
◦ relatedContext.xml
◦ IS
◦ 信息元素 (IEXML、PDFM、图形、部件清单) - 通常通过 IS 连接
◦ 通用信息元素
◦ 与部件列表关联的部件
◦ 部件关系
◦ 部件相关文档
◦ 选项和选择
◦ 症状树
◦ PublishInfo.xml
• 非产品束
此束与 IS 束相似，但没有 relatedContext.xml 文件。这表示该束不与任何产品上下文关联。通常，这些束类型与 publishInfo.xml 文件中定义的类别相关联。
标识束的上下文和类别
上下文信息表示与项相关联的产品上下文。在 Servigistics InService 中，上下文用于存储、筛选和查找系统中的各种项。IS 或 PS 束通常与上下文相关联。请注意，PH 束不与任何上下文关联，因为这种类型的束本身即为上下文。在 Servigistics InService 中，PH 束被加载到每一个段。
Px 束中包含 relatedContext.xml 文件，该文件用于标识与束关联的上下文。请注意，束可指单个或多个上下文。以下是 relatedContext.xml 文件的一部分。src 属性是指 IS 或 PS。target 属性是指上下文信息。
例如：
束的类别包含在 PublishInfo.xml 文件中。例如：
束标记文件
标记文件是在束中创建的特殊零字节文件，用于标记不同的处理状态。可能存在以下标记文件：
• ReadyForTAL
该文件由束所有者生成。如果存在此文件，则意味着束已完全生成且可以由 TAL 处理。
• PrepTAL
使用变换和加载任务一次加载多个束时，会创建此文件。
• TransformInProgress_Collection 或 TransformInProgress_BundleID
此文件的名称取决于您是否启用了内容共享。未启用内容共享时，此文件被命名为 TransformInProgress_Collection。启用内容共享时，此文件被命名为 TransformInProgress_BundleID。在变换过程中会创建此文件。
• TransformFailed_Collection 或 TransformFailed_BundleID
此文件的名称取决于您是否启用了内容共享。未启用内容共享时，此文件被命名为 TransformFailed_Collection。启用内容共享时，此文件被命名为 TransformFailed_BundleID。开始执行时，此文件由变换任务创建。如果变换任务成功完成，则会删除此文件。
• TransformCompleted_Collection 或 TransformCompleted_BundleID
此文件的名称取决于您是否启用了内容共享。未启用内容共享时，此文件被命名为 TransformCompleted_Collection。启用内容共享时，此文件被命名为 TransformCompleted_BundleID。开始执行时，此文件由变换任务创建。集合的变换任务成功完成时，会创建此文件。
• tal_completed
变换任务完成后，会创建此文件。
• tal_failed
变换任务失败时，会创建此文件。
从束中排除对象
如果存在要从束中明确排除的对象，则需要在束中包含 excludedObjects.xml 文件。此文件包含一系列 Object 标记，您可在其中提供您不希望使用束加载的对象的 id 和 uri。
以下是此文件的示例：
<?xml version="1.0" encoding="UTF-8"?>
<ExcludedObjects>
<Object id="PartListItem_8153223"
uri="x-wc://com.ptc.arbortext.windchill.partlist.PartListItem:8153223"/>
<Object id="PartListItem_8153222"
uri="x-wc://com.ptc.arbortext.windchill.partlist.PartListItem:8153222"/>
<Object id="WTPartMaster_8118901"
uri="x-wc://f5e0179d8f894049:wt.part.WTPartMaster:0069313461"/>
<Object id="WTPartMaster_8118955"
uri="x-wc://134e815ca9117606:wt.part.WTPartMaster:0069313463"/>
<Object id="WTPartMaster_8118947"
uri="x-wc://ce2ace730699a033:wt.part.WTPartMaster:0069313462"/>
<Object id="EPMDocumentMaster_8143009"
uri="x-wc://file=0000020874.png"/>
</ExcludedObjects>