目的

此工具是为测试不同CET版本之间的文件打印输出（PDF文件）而开发。所有可以包含在打印输出中的元素都可以用此工具进行测试，例如物料清单、2D平面图、3D视角和图纸视图。

多绘图测试

PDF差异测试可通过使用同一打印报表设置进行多绘图测试。为了启动比较测试，需在早期版本中创建参考文件。

创建参考文件

1. 从打印报表对话框里创建报表设置（.rep）。可指定打印报表应有的文件内容，例如物料清单、平面图（2D）、视角（3D）、图纸视图和/或其他客户特定的可打印元素。
   

   

   

    

2. 单击‘创建参考文件’，然后选择要存放绘图与打印报表设置的文件夹。
   

   

    

3. 这将打开PDF差异测试的创建参考文件对话框，并自动尝试识别步骤2中选定位置里所需的文件。
   

   

   • 打印报表文件 — 步骤1创建的打印报表设置（.rep）
   • 核心设置 — 包含例如控制面板中要使用的距离单位的设置。
   • 运行设置 — 包含例如控制面板中要使用的语言设置。
     可使用‘保存核心设置’以及‘保存运行设置’按钮将文件存储在绘图位置当中。
     
   • 参考文件夹—所选绘图已创建的PDF参考文件的储存位置

   单击对话框右下角的‘创建参考文件’开始创建PDF参考文件。

    

4. 绘图将自动加载到CET中，绘图视图的底部将出现一个进度条。
   

   

   然后出现一个消息对话框，表明参考文件已创建成功。

   

   PDF参考文件与绘图文件名称相同

   如果决定编辑或添加更多的绘图到文件位置，以及再次创建参考文件，该工具将首先检查参考文件目录中是否已经存在类似名称的参考文件文件。如果目录中已存在参考文件文件，就会出现一条关于覆盖现有文件的警告消息。

   

   • 确定 — 将为所有绘图创建新的参考文件文件
   • 取消 — 取消操作，并且不创建参考文件

   此检查用于防止错误覆盖旧的参考文件。

批量测试

1. 点击同一版本或更新版本的CET中的‘运行PDF差异测试。
   

   

    

2. 选择存有绘图和参考文件的文件夹。
   

   

   此时，将会打开PDF差异测试对话框，并自动尝试检测所需的文件。

   如果核心和运行设置文件位于相同的文件位置，那么所有目录将在对话框打开时自动填充。否则，您可以浏览对话框中，选择在创建参考文件时使用的首选项文件。

   

   如果未指定运行和核心设置，那么将使用当前CET的核心与运行设置进行测试。

    

3. 单击“运行测试”导航至下面的对话框。
   

   

    

4. 在PDF差异测试对话框中，将列出所选文件夹中的绘图名称，包括PDF中每一页的名称。页码编号从0000开始，编号旁是关于文件类型的文本。例如，图纸视图、平面图和视角。
   

   如果用户在图纸管理器中改变了图纸视图名称，那么该图纸的名称将会显示在页码旁边的对话框中。

   可选择使用2个选项来进行比较测试。

   • 通过单击按钮运行特定绘图及其所有页面。

     

   • 通过单击对话框底部的‘运行全部测试’按钮来运行所有绘图。

     

   针对每个正在运行的测试，对话框将会把状态从‘未测试’更改为‘正在运行’，并以‘完成’(ok)或‘失败’(failed)结束。

   

   • 完成(ok) - 在参考文件和当前打印输出之间未发现任何差异
   • 失败(failed) - 在参考文件和当前打印输出间检测到一处或多处差异。‘差异’按钮显示在失败页面旁边，‘接受’按钮显示在失败图纸的同一行上。. 

   从低向高移动滑块，可以改变比较测试的灵敏度。‘差异容忍度’越低，细小差异就越可能导致工具将该参考文件标记为失败。一旦调整‘差异容忍度’，就可以在不关闭对话框的情况下，选择重新运行特定的绘图或全部测试。

    

5. 接下来，可以通过单击“差异”按钮来核实参考文件和当前PDF之间的差异。
   

   

   这将打开另一个对话框，左边显示参考文件页，右边显示新生成的页面。在这个对话框中，有几个功能可以用来帮助验证参考文件和测试图像之间的差异。

   

   • 参考文件图像和测试图像 — 放大一个图像将自动放大另一个图像
   • 差异像素 — 显示参考文件图像和测试图像之间的像素差异百分比
   • 全部放大 — 同时缩小参考文件图像和测试图像，以便显示整个页面
   • 突出显示差异 — 突出显示测试图像中与参考文件图像不同的部分
   • 像素突出显示的容差 — 在比较参考文件图像和测试图像时工具的灵敏度。容忍度越低，细小差异就越可能导致工具将零件高亮显示为失败

   也可以通过单击按钮加载绘图并研究两者的差异。

   

   如果发现该差异有意更改过（例如，更正拼写错误，更改文本、2D形状或颜色，改进3D模型），可能需要更新参考文件以避免将来出现错误失败。那么可通过单击对话框中图纸标头行中的“接受”按钮来完成。

   

   这将用PDF差异测试工具创建的当前PDF替换绘图的参考文件。

   

   选中的绘图的状态也将恢复到‘未测试’，可以基于新的参考文件，使用按钮，选择重新运行测试。

   

   如果新创建的PDF与参考PDF的页数不同，该工具会立即将测试标记为失败并将其标记为‘页数不同’

   

   可以单击‘差异’按钮来确定丢失了哪一页。

   

    

6. 当发现由错误（非故意更改）引起差异时，需要向开发团队提交错误报告。可以单击对话框底部的‘保存失败的测试’的按钮来获取相关所需的文件。

   

   这时将出现一个‘浏览文件夹’对话框，可以指定所需文件的存储位置。

   

   然后，差异再现所需的文件将存储在指定位置。

   

   这包括打印报表设置、核心设置、运行设置、绘图文件、PDF和图像。测试期间创建的PDF和图像在‘pdf’和‘.png’格式后又将附加后缀“.new”。

一般注意事项

• 运行测试时需要使用与创建参考PDF文件时相同的币种和标题（如果此类页面包含在打印报告中，则用于物料清单）。
• 如果绘图缺少参考PDF文件，则该绘图将不会包含在测试中。因此，从测试中排除绘图的一种简单方法是临时移动或重命名其参考文PDF文件。
• 如果想移动或重命名测试中使用的任何PDF文件，需要首先关闭CET，因为CET在设置PDF差异测试时会将这些文件锁定。如果CET是在开发模式下通过Emacs启动的，则需要在Emacs中按Ctrl-alt-e来关闭进程。
• 当在两台计算机上分别运行PDF差异测试和创建PDF参考文件时，在打印机设置中使用相同的打印机就十分重要。更重要的是，如果这些计算机不是处于同一间办公室甚至不在同一个国家—它们可能无法访问同一台物理打印机。如果计算机（在运行PDF差异测试时）无法找到打印报告中设置的打印机，CET将使用一些默认值—这可能与打印机预期设置不匹配，导致测试出现差异。图纸上的可打印区域可能因打印机而异，导致PDF差异测试可能捕获的打印输出略有不同。例如，物料清单/物品视图中的分页符可能因打印机而异。如果PDF差异测试显示了这种差异，那么现在就有迹可循了。

可为图纸视图设置打印机：

为了避免打印机引起的差异，我们建议使用Windows提供的默认打印机，因为它们适用于所有（Windows）计算机：

• Microsoft XPS文档编写器
• Microsoft打印成PDF格式

测试小贴士

• 打印输出的2D页面（平面图或图纸视图中的2D视图）— 可用于测试不同的视图模式—测试正确的图形和文本是否可见。
• 3D（视角或图纸视图中的3D视图）— 可用于测试不同的视图模式—测试正确的3D是否可见。
• 若要检测随机错误，请在同一版本上多次运行PDF差异测试。这意味着从‘运行PDF差异测试’开始，而不仅仅是再次单击‘运行全部测试’按钮（这不会创建新的测试PDF，只是比较两个PDF）。

文件和文件夹组织

建议将PDF差异测试使用的全部文件保存在同一个文件夹中。这可以使该工具能够自动检测测试运行所需的文件，而无须手动搜索每个所需文件。

• 绘图
• 参考文件
• 打印报表设置
• 核心和运行设置文件。