用户帮助 > 使用文档 > 比较不相关文档
  
比较不相关文档
CLI EQUIVALENT 
im diffsegments --compareUnrelatedDocuments
此功能解决了两个不相关的文档必须进行比较时如何处理用例的问题。考虑以下用例:
在典型的行业情景中,组织会收到来自多个 OEM 的输入。组织可以选择将这些输入存储在单独的输入文档中。随后的需求文档会在这些输入文档的基础上演变。“比较无关文档”功能可帮助组织实现:
从这些不同的要求文档中找到常用项。
如果输入在一段时间内出现变化,请从输入和要求文档中查找常用项。
比较不相关的文档,可以了解两个不同类型的文档之间的文本差异。如果所比较的文档没有相同的根 ID,则被视为不相关。以下也可视为不相关文档:
不是相同的文档,或者不是相同文档的分支或版本
不是同一文档的“截至”配置,或者不是同一文档的分支或版本的“截至”配置
例如,此功能可让您将需求文档与输入文档或任何不相关的需求文档进行比较。
* 
被比较的两个不相关的文档必须具有相同的主长文本字段。
输出位于“文档差异”视图,其中结构和内容的差异在两个文档窗格中并排显示。与文本差异有关的添加、删除、移动、更改被突出显示。您可以使用导航工具查看和浏览文档的文本和结构差异。
* 
如果“文档差异”视图在升级至 Windchill RV&S 最新版本后不可见,则必须自定义现有的 Windchill RV&S 视图集和快捷菜单,以在 GUI 中启用此视图。系统会保存并记住视图集和快捷菜单的自定义内容,方便您下次访问客户端时使用。
要自定义现有视图集,请选择“视图集” > “自定义”。在“操作”选项卡上,选择“工作流和文档” > “文档” > “文档”,让该选项在“文档”菜单上显示出来。
要自定义右键单击快捷菜单,请单击鼠标右键,然后选择“自定义此菜单”。单击“添加操作”。选择“工作流和文档/项”,然后选择“比较不相关文档”
有关自定义视图集或快捷菜单的详细信息,请参阅自定义视图集自定义快捷菜单
要在 GUI 中比较两个不相关的文档
* 
系统会在服务器上计算不相关文档的差异,这属于内存密集型操作。反复执行此操作可能导致服务器内存不足。所以应该小心谨慎执行这个操作。
此外,不相关文档差异的表现取决于文档的复杂性、文档中的添加、删除和修改的变化程度以及受影响的节点数量。显示比较所需的时间取决于更改的次数和文档的复杂程度。
1. 选择“文档” > “比较不相关文档”
“比较不相关文档”窗口随即显示。
2. 通过输入“文档 ID”或单击“选择”并查找文档来指定要比较的主文档。
3. 可以对源和目标文档选择“截至”配置选项来比较两个不同时间点处的文档。下表描述了文档比较的“截至”选项:
要比较截至下列各项的文档
请执行此操作...
现在
选择“现在”可比较文档的当前版本。
修订版本
选择“修订版本”。此时会显示与修订版本关联的所有标签的列表。选择您想要对其执行文档比较的修订版本。
* 
此选项仅在您比较允许版本化的文档时可用。
标签
选择“标签”。此时会显示文档上的所有标签的列表。选择您想要对其执行文档比较的标签。
分支
选择“分支”。此时会显示与文档关联的所有分支的列表。选择与您要比较的文档的截止时间对应的分支。
* 
此选项仅在您要比较已创建分支或是分支的文档时可用。
4. 或者,您可以选择“隐藏没有差异的项”复选框以隐藏没有内容或结构差异的项。
5. 搜索现有项时,可以按可见文本或字段进行筛选,也可以按“项 ID”进行搜索。有关详细信息,请参阅文档查找器
审阅文档差异
“文档差异”视图包含两个文档窗格。您先指定的源文档会显示在左侧窗格中,之后指定的目标文档会显示在右侧窗格中。您可以单独在每个窗格中导航。目前作为焦点的文档窗格具有蓝色边框。
视图会使用不同颜色的突出显示和连接器箭头来直观显示差异并突出显示文本差异,而且还会使用交互式行标题图标来表示差异类型。不同颜色的连接器箭头会动态结合窗格之间的内容和字段级别的差异,前提是这两种差异在每个窗格中至少部分可见。在任何一个文档中滚动时,连接器箭头都会刷新以连接视图中的可见内容。
下表介绍了视图如何直观表示文档差异:
文档差异类型
突出显示/连接器箭头颜色
界面图标
添加的内容
源文档中不存在,但目标文档中存在的项。
占位符以可见方式指明在源文档中进行了添加的位置。
绿色
移动的内容
在源文档和目标文档中都存在的项:
具有不同的父项
具有相同的父项,但相对位置不同
的父项已移动。
蓝色
删除的内容
源文档中存在,但目标文档中不存在的项。
占位符以可见方式指明目标文档中进行了删除的位置。
红色
已修改的内容
对项或字段内容进行的任何非结构更改。
黄色
已移动并修改的内容
紫色
文本差异
“文档差异”视图会在文本级别对文档内容进行比较,包括字母数字字符、标点符号、空格和超链接文本。文本差异会在每个文档窗格突出显示,如下所示:
删除的文本会在左侧窗格中的源文档中以红色突出显示。
添加的文本会在右侧窗格中的目标文档中以绿色突出显示。
已更改的文本会在左侧窗格中显示为删除项,在右侧窗格中显示为添加项。
视图不会比较或突出显示以下文档元素:
文本格式,如斜体、字体属性或带有编号的列表
图像
超文本链接目标内容
短文本字段内容
左侧窗格:删除的文本以红色突出显示
右侧窗格:添加的文本以绿色突出显示
单击一个文档窗格中的交互式行标题图标可在其他窗格上方看到相关内容。要并排比较内容,请单击两个窗格中的对应行标题图标。将鼠标悬停在行标题上可显示工具提示和部分信息。视图窗口左下角还会显示状态详细信息。
您可以从“项”菜单或已选定特定节点的快捷菜单中执行项操作,如编辑或查看项。
默认情况下,视图会显示所有项。要隐藏没有字段或文档结构差异的项,请选择“视图” > “隐藏无差异的项”
您可以随时通过选择“查看” > “刷新”或按 F5 刷新视图。
重要注意事项: 比较不相关文档差异视图结果
使用专门算法,根据两个文档的主文本字段值对文档进行比较。该算法计算两个文档中的节点的概率相似性,将得分最高的最佳匹配节点标识为节点对。重要的是可以注意到,随着内容中字数的增加,算法的准确性也随之提高。
匹配的节点
两个节点如果符合以下任一条件,即被视为最佳匹配:
具有完全相同的内容。
超过 50% 的文本内容相同。
超过 50% 以上内容相同的匹配节点在与根/父节点的距离方面差别不大。
根据相似性分数对节点分类
根据概率相似性分数,匹配的节点可分为以下类型:
* 
在同一组文档(如果已修改任一文档)中以不同间隔进行的比较结果可能不相同。
如果分数为 100%,则节点被视为相同。
如果分数低于 50%,则意味着节点没有相似内容,节点因此被突出显示为已添加已删除
请注意,在计算分数时,匹配节点与根/父项节点之间的距离也被考虑在内。因此,相对于其父项或匹配节点的父项发生移动的节点被突出显示为已移动
如果分数大于或等于 50%,则意味着匹配节点的内容发生一定程度更改,并且节点突出显示为已更改。如果节点在文档内部移动,则这些节点会突出显示为已移动和更改
下图更详细地说明了这点。
下图显示了原始状态下的两个不相关的文档。文档 ID 642 是源文档,文档 ID 1079 是目标文档。如下所示,虽然目标文档中没有实际的移动操作,但是第 2.1 部分和第 1.2 部分已标识为“移动”,因为它们与此精确匹配。
在下一个图像中,第 1.2 部分被移到目标文档 1079 中的第 2.1 部分。因此,文档显示为相同。
下图显示了第 2.1 部分移至第 2.4 部分后比较的同一组文档。
下图说明了在目标文档中的不同位置添加相同内容时的情况。在这个例子中,第 2.4 部分中的文本被复制到第 2.7 部分。
从上述示例可以看出,计算出的差异总是与其他文档中的实际文本相关,并且与每个单独文档中的实际操作无关。
子文档的比较
所含子文档的比较根据其相同的摘要/说明短文本字段值单独进行。如果文档不包含与短文本字段值匹配的子文档,则整个子文档突出显示为已添加已删除
插入的子文档在差异视图中显示为一个节点。
已知问题和限制
PTC 不建议同时比较不相关的大型文档,因为这可能会导致服务器资源的显着增加。
不支持将两个不相关的文档与其他字段进行比较的功能。考虑到仅根据文本对节点进行比较和匹配的情况,其他字段的比较可能完全出现在上下文之外,并且可能会在比较视图中产生误导。
例如,如果需求节点和输入节点的文本内容完全匹配,则节点将显示为相同。然而,这不一定意味着这两个节点上显示的其他字段是可比较的。这些字段的任何比较尝试可能会产生无意义的结果。
导航文档差异
您可以使用“查看”菜单选项,或使用以下工具栏或快捷键选项,在当前文档窗格中以递增方式导航每个差异:
上一个差异: 或按 F7
下一个差异: 或按 F8
第一个差异: 或按 CTRL + F7
最后一个差异: 或按 CTRL + F8 键
选择“查看” > “对不同的搜索换行”以将“上一个差异”和“下一个差异”搜索选项配置为换行至文档窗格的顶部或底部。清除“对不同的搜索换行”选项,以在文档窗格的开头或末尾停止。
导航文档窗格
“文档差异”视图中的当前文档窗格中提供了以下文档窗格键盘导航选项:
快捷键
操作
CTRL+TAB
将焦点切换至其他文档窗格。
TAB
选择下一个字段。
向上键
选择上一个行标题。
向下键
选择下一个行标题。
HOME
选择第一个行标题。
END
选择最后一个行标题。
空格键
选择在焦点中的行标题图标,然后移至其他文档窗格中的对应位置。
PAGE UP
向上滚动约一页。
PAGE DOWN
向下滚动约一页。