评审后改了几条需求,再比较两份基线,正文修改能看到,状态变化却没有出现;另一个条目明明还在文档里,比较时又像被删掉了。遇到这类情况,先保留两侧的修订号。基线名称、文档路径、过滤条件和显示选项都需要核对,单凭差异页上的红绿标记,还不足以判断某项修改是否进入了基线。
一、Polarion如何创建并比较文档基线
文档基线用于标记某份LiveDoc在特定修订时的内容。它与项目基线、Collection基线的范围不同,创建时应选准对象。
1、保存需要纳入基线的修改
①进入【Documents&Pages】,打开目标LiveDoc,完成编辑后点击【Save】。
②打开文档的【History】,查看最新修订及修改说明。
正文和工作项字段都应确认已经保存。尤其是多人同时编辑时,应核对评审要求涉及的修改是否已经提交,避免基线建立后才发现某条需求还留在编辑状态。
2、创建并确认文档基线
①返回目标文档,打开文档操作菜单,选择【Create Baseline】。
②在弹窗中填写【Name】和【Description】,确认创建。
③再次进入【History】,通过【Show Baselines Only】查看基线记录,点击名称打开对应版本。
名称可以包含发布或评审节点,描述中写明用途。基线本质上是在文档历史修订上增加标识,后续编辑当前文档不会把既有基线变成新内容。界面入口可能随版本调整。
3、选择两侧修订进行比较
①在【History】中选择需要比较的两个版本,通过【Compare】进入比较页面。
②核对【Older】和【Newer】两侧的文档、基线名称及修订号。
③按检查内容切换【Document】与【Work Items】视图。
正文阅读适合从文档视图入手,工作项字段则需结合工作项视图查看。若拿基线与HEAD比较,右侧代表当前内容;需要复现一份固定差异结果时,应明确记录右侧修订号。
二、Polarion基线版本差异未完整显示如何检查
先选一条确定发生过变化的需求作对照,逐项检查,避免一开始就调整整个项目配置。
1、确认变化发生在比较区间内
①在比较页面核对【Older】和【Newer】,分别打开对应的历史文档。
②返回【History】,查看目标修改发生的修订。
两个不同名称的基线可能指向相同修订,也可能都建立在修改之后。这种情况下,没有出现差异并不意外。若名称与记忆不一致,应以实际修订及其内容为准,不要仅按“初版”“终版”判断时间先后。
2、检查状态等字段的显示设置
①切换到【Work Items】,打开比较页面的选项菜单。
②勾选【Show changed non-mergeable fields】,重新查看目标工作项。
该选项在2404版本引入,用于控制初始化字段或不支持手动合并字段的变化是否显示,状态就是其中一个例子。旧版本没有同名选项时,应打开两侧工作项逐项核对,不能照搬新版界面操作。
字段没有出现在当前比较范围内,也不能据此认定它没有修改。
3、排除过滤器隐藏的条目
①查看比较页面的【Filter】,清除当前筛选条件,重新检查差异。
②在支持该功能的版本中,启用【Show items filtered out on one side】。
③查看标有【Filtered out】的条目,分别打开两侧内容。
按状态筛选时尤其容易出现误判。例如需求从草稿改为批准后,可能只在一侧符合条件。单侧被过滤不等于被删除;而两侧都不符合过滤条件的条目,即使启用上述选项也仍会隐藏。
4、核对引用和冻结变化
①在【Work Items】比较选项中启用【Show items with no changed fields】。
②展开目标条目,查看两侧工作项ID、引用及修订信息。
该选项同样属于2404的比较改进。在支持的比较场景中,条目被覆盖或冻结,但字段值尚未变化时,仍可能存在值得核查的差异。比较主文档与分支文档时尤其要留意,不能把文字相同直接理解为引用方式和后续更新行为也相同。
三、Polarion文档差异怎样逐项复核
页面设置检查完后,再围绕评审关心的内容核验,确认差异结果能回答具体问题。
1、用一条已知修改验证比较范围
①在【Work Items】视图中找到已知修改的条目,展开两侧字段。
②切换到【Document】,定位它在正文中的位置。
可以选一条修改过预期结果或需求描述的记录。如果已知变化仍未出现,应继续核对修订和字段范围;不宜直接根据页面差异数量填写评审结论。
2、从工作项历史补查遗漏字段
①点击目标工作项,打开【History】,选择相关修订查看修改记录。
②返回文档比较页面,对照该条目两侧内容。
工作项历史可以帮助确认谁在什么时候修改了字段,但打开工作项后要留意是否跳到了当前版本。用当前字段值解释旧基线,容易把基线之后的修改也算进去。
3、确认引用条目的比较对象
①在历史文档中选择引用条目,打开对应工作项,核对ID及修订信息。
②在另一侧重复检查,再返回【Work Items】比较视图。
遇到同名条目,要区分它们是同一个工作项、分支后的不同工作项,还是固定在不同修订上的引用。标题相同只能帮助定位,不能替代对象身份检查。
总结
基线比较通常用在评审、变更分析和交付确认中,读者需要知道两份内容之间究竟发生了什么。若结果用于后续决策,最好同时留下文档路径、两侧修订和本次筛选范围,让接手的人能够重新打开核查。没有显示差异的地方,尤其是状态、引用方式等内容,也应按评审要求确认,避免把显示上的省略当成没有变化。希望这些操作能帮到大家,减少版本核对时的反复查找。如有相关需求,欢迎交流咨询。