确定要发布的文档
默认情况下,仅发布代表 RevisionControlled 对象与文档关联的变更的信息。已发布到分布目标的任何信息都不会重新发布。
以下示例显示了发布到目标企业系统的内容。此处的 WTPart 小版本仅用于说明目的,但它可以是
部件和文档关系一节的注解中提及的任何 RevisionControlled 对象的小版本。
上图显示了分配给分布目标 1 且附加了文档 (DOC 1) 的部件 100 小版本 A。如果之前从未将此部件小版本和文档小版本发布到分布目标 1,则在发布部件时,也会发布文档和文档链接。文档显示在子元素
<AddedDocuments> 中,文档链接显示在子元素
<AddedDocmentLinks> 中。有关 Windchill ESI RPC 响应的 XML 结构的详细信息,请参阅 Windchill Enterprise Systems Integration 应用程序编程接口指南。
在此图中,部件 100 小版本 A (附加了文档 1) 已发布到分布目标 1。第二个文档 (DOC2) 已添加到 Part 100 小版本 B 中,然后进行发布。如果之前未将文档 (DOC2) 发布到分布目标 1,则会将文档 (DOC2) 和关联的文档链接发布到分布目标 1。文档 (DOC2) 随即出现在 XML 元素
<AddedDocuments> 中,链接将出现在 ESI RPC 响应的 XML 元素
<AddedDocumentLinks> 中。另一方面,如果文档 (DOC2) 已存在于目标企业系统中,则会发布文档的文档链接,但不会发布文档 (DOC2)。文档 (DOC2) 随即出现在 Xml 元素 <UnchangedDocuments> 中,文档链接则出现在 XML 元素 <AddedDocumentLinks> 中。
在此图中,部件 100 小版本 A (附加了文档 1) 已发布到分布目标 1。如果部件 200 小版本 A 使用与部件 100 相同的文档发布,并且文档的小版本相同,则对于 Part 200,仅会在 XML 元素 <AddedDocumentLinks> 中发布文档链接。如果文档小版本不同,则会将文档发布为对 XML 元素 <ChangedDocuments> 中的文档的变更,文档链接将发布为在 XML 元素 <AddedDocumentLinks> 中添加的文档链接。
在上图中,部件 100 小版本 A (附加了 DOC 1 和 DOC 2) 已发布到目标 1。文档 2 已从 Part 100 小版本 B 中移除并发布。创建的唯一 XML 元素是 <DeletedDocumentLinks>,用于说明部件和文档之间链接。不会移除该文档,因为该文档可能与其他部件关联。
| 同样,上述用例情景不仅适用于 WTPart 小版本,也适用于任何受支持的 RevisionControlled 对象的小版本。此外,诸如 <AddedDocuments>、<ChangedDocuments>、<DeletedDocumentLinks> 等 XML 元素名都是使用默认 ESI 响应元信息文件生成的元素名称。 |
| 首次发布的文档显示在 ESI 响应的 <AddedDocuments> 元素中。根据 Windchill ESI 首选项“检查小版本”的值为“是”还是“否”,确定在 <ChangedDocuments> 还是在 <UnchangedDocuments> 元素中发送先前发布的文档的新小版本。先前发布的文档的新修订版本始终通过 <ChangedDocuments> 元素发送。对文档生命周期状态的变更将被视为对文档的变更;因此,在变更生命周期状态后发布先前发布的文档小版本会导致在 <ChangedDocuments> 元素中发送小版本。无论文档是随 RevisionControlled 对象一起发送还是独立发布,所有这些内容均适用。 |