用户帮助 > 使用文档 > 查看差异
  
查看差异
CLI EQUIVALENT 
im diffsegments
使用“文档差异”视图比较所选两个文档之间的内容和字段级别差异。例如,您可以选择一个具有两个基线标签以及感兴趣的相关字段的需求文档,以了解该文档在一段时间内的更改情况。视图会在两个文档窗格中并排显示结构和内容更改。它会突出显示项和字段添加、删除、移动、更改以及文本差异。您可以使用导航工具有效地审阅和导航文档差异。
要在 GUI 中访问“文档差异”视图,请选择“文档” > “查看差异”
用于比较文档的工作流包括下列步骤:
1. 选择要比较的文档。
2. 选择要比较的字段。
3. 在视图中筛选比较结果。
4. 审阅文档差异。
* 
如果“文档差异”视图在升级至 Windchill RV&S 最新版本后不可见,则必须自定义现有的 Windchill RV&S 视图集和快捷菜单,以在 GUI 中启用此视图。系统会保存并记住视图集和快捷菜单的自定义内容,方便您下次访问客户端时使用。
要自定义现有视图集,请选择“视图集” > “自定义”。在“操作”选项卡上,选择“工作流和文档” > “文档” > “文档” > “查看差异”,以使该选项在“文档”菜单中可见。在“视图”选项卡的“工作流和文档”下方,将“查看差异”配置为浮动或停靠。默认情况下,视图处于停靠状态。
要自定义右键单击快捷菜单,请在文档节点上单击鼠标右键,然后选择“自定义此菜单”。单击“添加操作”。选择“工作流和文档/项”,然后选择“查看差异”
有关自定义视图集或快捷菜单的详细信息,请参阅自定义视图集自定义快捷菜单
选择要比较的文档
您可以指定以下文档选择类型:
两个不同时间点的同一文档。
同一文档的两个版本(可以根据需要选择不同时间点的文档)。
两个共享一个通用分支上级项 ID 的分支文档(可以根据需要选择不同时间点的文档)。例如,将已版本化的文档与已创建分支的文档进行比较。
1. 选择“文档” > “查看差异”
此时会打开“查看文档差异”窗口。
2. 通过输入“文档 ID”或单击“选择”并查找现有项来指定要比较的主文档。然后,请执行下列操作之一:
要对两个不同时间点的同一文档进行比较,请清除“比较版本或分支”。展开源文档和目标文档的“截至”选项并进行选择。下表描述了文档比较的“截至”选项:
要比较截至下列各项的文档
请执行此操作...
现在
选择“现在”可比较文档的当前版本。
修订版本
选择“修订版本”。此时会显示与修订版本关联的所有标签的列表。选择您想要对其执行文档比较的修订版本。
* 
此选项仅在您比较允许版本化的文档时可用。
标签
选择“标签”。此时会显示文档上的所有标签的列表。选择您想要对其执行文档比较的标签。
分支
选择“分支”。此时会显示与文档关联的所有分支的列表。选择与您要比较的文档的截止时间对应的分支。
* 
此选项仅在您要比较已创建分支或是分支的文档时可用。
编辑
选择“编辑”。此时会显示对文档项进行了重大修改的所有日期的列表。选择您想要对其执行文档比较的时间。
日期
选择“日期”,以使用日历和时间字段选择任意日期和时间进行文档比较。
要将文档与其分支之一进行比较,请选择“比较版本或分支”,然后指定一个分支“文档 ID”或单击“选择”以查找源文档的现有分支。
要将文档与其版本之一进行比较,请选择“比较版本或分支”,然后指定一个版本“文档 ID”或单击“选择”以查找源文档的现有版本。如果已启用文档版本化,则可以使用 Live Item ID-major.minor 格式来查找已版本化的文档。例如,184–1.2。
搜索现有项时,可以按可见文本或字段进行筛选,也可以按“项 ID”进行搜索。有关详细信息,请参阅文档查找器
选择要比较的字段
1. 展开“选项”,然后选择要比较的内容字段:
可指定要添加至“要比较的其他字段”列表的字段。您可以筛选字段列表。
可从“要比较的其他字段”列表中移除选定的字段。
可调整字段在“文档差异”视图中的显示顺序。
2. 单击“确定”。系统会记住您选择的字段,以便您下次比较相同文档类型的文档。
字段选择的重要考虑事项
始终会比较主文本字段。
您只能比较与所选文档类型的内容类型相关的内容字段。支持用于比较的字段类型包括:长文本、多格式的文本、短文本、选择列表、附件、类别、追溯关系、整数、浮点、状态、逻辑、日期、用户、组、长文本的字段值属性、多格式文本的字段值属性、短文本的字段值属性、选择列表的字段值属性、附件的字段值属性、整数的字段值属性、浮点的字段值属性、逻辑的字段值属性、日期的字段值属性、用户的字段值属性和组的字段值属性。不受支持的字段类型可能包含差异;但是,文档比较算法会忽略不受支持的字段类型中的差异。
除文本字段外,您不会选择比较的任何字段都可能包含差异;但是,文档比较算法会忽略不考虑进行文档比较的字段中的差异。
无法选择参数和参数值字段类型进行比较。不会在“文档差异”视图中替换参数。有关字段类型的详细信息,请参阅使用字段类型
筛选比较结果
选择要比较的字段时,可以在“文档差异”视图中筛选文档比较结果。
要隐藏没有字段或文档结构差异的项,请选中“隐藏无差异的项”复选框。
要在“要比较的其他字段”列表中隐藏不包含任何差异的字段,请选中“隐藏无差异的字段”复选框。
系统会记住您选择的字段筛选器,以便您下次比较相同文档类型的文档。系统会始终记住您选择的项筛选器。
审阅文档差异
“文档差异”视图包含两个文档窗格。您先指定的源文档会显示在左侧窗格中,之后指定的目标文档会显示在右侧窗格中。您可以单独在每个窗格中导航。目前作为焦点的文档窗格具有蓝色边框。
视图会使用不同颜色的突出显示和连接器箭头来直观显示差异并突出显示文本差异,而且还会使用交互式行标题图标来表示差异类型。不同颜色的连接器箭头会动态结合窗格之间的内容和字段级别的差异,前提是这两种差异在每个窗格中至少部分可见。在任何一个文档中滚动时,连接器箭头都会刷新以连接视图中的可见内容。
下表介绍了视图如何直观表示文档差异:
文档差异类型
突出显示/连接器箭头颜色
界面图标
添加的内容
源文档中不存在,但目标文档中存在的项。
占位符以可见方式指明在源文档中进行了添加的位置。
绿色
移动的内容
在源文档和目标文档中都存在的项:
具有不同的父项
具有相同的父项,但相对位置不同
的父项已移动。
蓝色
删除的内容
源文档中存在,但目标文档中不存在的项。
占位符以可见方式指明目标文档中进行了删除的位置。
红色
已修改的内容
对项或字段内容进行的任何非结构更改。
黄色
已移动并修改的内容
紫色
文本差异
“文档差异”视图会在文本级别对文档内容进行比较,包括字母数字字符、标点符号、空格和超链接文本。文本差异会在每个文档窗格突出显示,如下所示:
删除的文本会在左侧窗格中的源文档中以红色突出显示。
添加的文本会在右侧窗格中的目标文档中以绿色突出显示。
已更改的文本会在左侧窗格中显示为删除项,在右侧窗格中显示为添加项。
视图不会比较或突出显示以下文档元素:
文本格式,如斜体、字体属性或带有编号的列表
图像
超文本链接目标内容
短文本字段内容
左侧窗格:删除的文本以红色突出显示
右侧窗格:添加的文本以绿色突出显示
单击一个文档窗格中的交互式行标题图标可在其他窗格上方看到相关内容。要并排比较内容,请单击两个窗格中的对应行标题图标。将鼠标悬停在行标题上可显示工具提示和部分信息。视图窗口左下角还会显示状态详细信息。
您可以从“项”菜单或已选定特定节点的快捷菜单中执行项操作,如编辑或查看项。
默认情况下,视图会显示所有项。要隐藏没有字段或文档结构差异的项,请选择“视图” > “隐藏无差异的项”。要在“要比较的其他字段”列表中隐藏不包含任何差异的字段,请选择“查看” > “隐藏无差异的字段”
您可以随时通过选择“查看” > “刷新”或按 F5 刷新视图。
“文档差异”视图结果的重要考虑事项
无论管理员如何配置关系字段的显示格式,该视图都会采用 CSV 格式显示该字段。采用 CSV 格式使文档比较算法可以查找关系字段本身的内容(包括项 ID、项在字段中的顺序以及任何关联的标志)中的差异。但是,该算法不会查找关系字段中参考的项上的字段值差异。
有关关系标志的信息,请参阅“关系字段”
“文档差异”视图会呈现所选文档之间的文本更改净差异。但是,此视图中显示的差异可能不代表用户对文档所做的实际更改。
系统会针对每个节点,以堆叠垂直格式显示选定用于比较的字段。
附件字段呈现为以逗号分隔的文件名值。
如果您比较的文档包含子文档,则会突出显示包括的所有子文档的差异,包括添加、移动、删除和修改的内容。对子文档的循环参考会作为插入(或参考)的子文档显示。
对于插入(或参考)的子文档,视图只会突出显示已添加和已删除的子文档操作。
已修改的内容项不一定包括突出显示的文本差异。例如,单个段落分割为两个显示为已修改内容更改(不含文本差异)的段落。
导航文档差异
您可以使用“查看”菜单选项,或使用以下工具栏或快捷键选项,在当前文档窗格中以递增方式导航每个差异:
上一个差异: 或按 F7
下一个差异: 或按 F8
第一个差异: 或按 CTRL + F7
最后一个差异: 或按 CTRL + F8 键
选择“查看” > “对不同的搜索换行”以将“上一个差异”和“下一个差异”搜索选项配置为换行至文档窗格的顶部或底部。清除“对不同的搜索换行”选项,以在文档窗格的开头或末尾停止。
导航文档窗格
“文档差异”视图中的当前文档窗格中提供了以下文档窗格键盘导航选项:
快捷键
操作
CTRL+TAB
将焦点切换至其他文档窗格。
TAB
选择下一个字段。
向上键
选择上一个行标题。
向下键
选择下一个行标题。
HOME
选择第一个行标题。
END
选择最后一个行标题。
空格键
选择在焦点中的行标题图标,然后移至其他文档窗格中的对应位置。
PAGE UP
向上滚动约一页。
PAGE DOWN
向下滚动约一页。