Bluebeam ：开始使用交互式图章

什么是交互式图章？

在 Revu eXtreme 中，您可以创建根据项目需求定制的交互式图章。 图章是使用 JavaScript 制作的，可以包括按钮、表单字段、公司徽标、日期等。 一旦它们出现在文档中，您和您的同事就可以通过填写表单域、复选框和修改与您的项目相关的其他内容来与图章进行交互。

 

交互式图章允许您创建任何人都可以编辑和填写的表格。 例如，当用户放置 Submittal_Status 标记时，Revu 会提示他们：

• 选择与图章相关的项目名称
• 检查正在盖章的 PDF 的适当状态
• 填写有关用户、规格、日期和提交编号的相关信息。

 

哪些 Revu 产品适用于交互式图章？

虽然所有版本的 Revu 都可以编辑交互式图章的外观，但 Revu eXtreme 需要添加表单字段、编辑表单字段和编辑交互式图章的 JavaScript。

为 Revu 添加图章

有两种方法可以制作交互式图章。 一种方法是使用 JavaScript 从头开始创建图章。 另一种方法是从一个预制的图章模板（例如我们的 Revu 自定义库页面）开始，并为您的项目自定义它。 本文将重点介绍使用模板创建图章。

下载模板

• 转到 Revu 自定义库页面。
• 在“交互式图章”下，点击“提交状态”，您的下载将开始。
• 在下载目标中找到 submittal-status.zip，右键单击它，然后选择全部提取。
• 点击提取。

 

导入图章

• 打开Revu.
• 转到工具 > 图章 > 导入图章...
• 导航到带有您的图章的文件夹。
  对于此示例，请转到您的下载目的地并打开名为 submittal-status 的文件夹。文件夹里会有三个PDF。
  • Submittal_Status Instructions.pdf 将包含特定于修改该邮票中的全局脚本和表单字段的说明。
  • Submittal_Status.pdf 用于放置单个图章。
  • Submittal_Status_Batch.pdf 用于一次在多个页面上盖章。
• 选择您的图章。
  对于此示例，请选择 Submittal_Status.pdf。
• 点击打开。

下次选择图章工具时，此图章将出现在列表中。

放置图章

• 转到工具 > 图章，然后在图章列表中选择 Submittal_Status。
• 单击要放置图章的文档画布。 系统会提示您填写以下字段：

 

• 从下拉列表中选择一个项目。
• 选择一个状态。
• 填写文本字段。
• 点击“确定”将图章放置在页面上。

 

图章中的内容添加到页面后无法更改。

自定义图章

除了表单字段中的文本外，您可以在任何版本的 Revu 中自定义图章外观的任何方面。 在此示例中，我们将自定义公司名称和公司徽标。

要更改图章，请在编辑模式中打开它：

• 转到工具 > 图章，然后将光标悬停在所需图章上，然后点击右侧显示的编辑图标。
  对于此示例，请编辑 Submittal_Status.pdf 图章。
• 使用标记工具自定义图章； 添加您的公司名称、编辑文本颜色、背景颜色和徽标。

 

如果您需要调整、添加或删除表单字段，您将需要 Revu eXtreme。

• 自定义图章后，转到“文件”>“另存为”并为您的图章键入新名称。 编辑后的图章将保存为新图章以备将来使用。

 

表单字段编辑和 JavaScript

本节重点介绍如何在几乎不了解 JavaScript 的情况下更改 JavaScript 对话框和表单字段。 在文档上放置交互式图章后：

• 这会触发“计算”字段中的操作，从而生成图章对话框。
• 然后，放置图章的人可以在 JavaScript 提示中填写所需的详细信息。

我们扩展页面的图章中的 JavaScript 分为两部分：StampCode 和计算脚本。 在编辑印章之前，了解这两个术语很重要。

计算脚本

计算脚本是预先编写的，不应更改。 它可以在“计算”表单字段的属性中找到。 计算脚本定义了在 StampCode 中引用的变量。 如果没有对 JavaScript 的高级理解，编辑计算脚本可能会导致您的图章失败。 不要编辑或删除图章中的“计算”字段。

“扩展”页面提供的每个图章都适用于预定义的表单字段。 如果您需要添加更多单选组或其他表单字段类型，则不支持这些类型。 如果需要，您可以联系技术支持获取更多图章示例。

StampCode

每个图章都有一个名为 StampCode 的存储值。这是代表交互式图章中的视觉元素的后端代码。 例如，如果您想添加任何表单字段或编辑现有的字段，则必须通过 StampCode 来完成。 StampCode 控制在图章对话框中显示什么内容，并直接与图章中的表单字段交互。

以下是 StampCode 如何与表单字段名称关联的示例：

 

对于 Revu 自定义库页面上可用的所有图章，StampCode 分为两部分：StampCode 的前半部分引用了图章中使用的所有文本字段，而后半部分引用了一组单选按钮和 一个下拉列表。

 

编辑StampCode

• 转到窗口 > 面板 > 表单 (Alt+Q)
  出现表单面板。
• 转到工具 > 表单 > JavaScript…（Ctrl+Shift+J）
  出现全局脚本对话框。

确保突出显示了 StampCode，然后点击编辑图标。
3. 显示提交状态的预构建 StampCode JavaScript。

您可能会注意到 StampCode 中的值当前反映了邮票中使用的每个表单字段的名称。 例如，在 Forms 面板中，单选按钮“Revise”在邮票代码中被引用为：

{ value:"Revise", description:"Revise" }

名为“CheckedBy”的文本字段在 StampCode 中被引用为：

{ field:"CheckedBy", description:"Checked by:", default:function() { return Collab.user; } }

在这两个示例中，StampCode 以 value: 或 field: 开头。 这两个术语与表单字段中的名称直接相关。 如果表单字段名称与其 StampCode 值或字段不完全匹配，JavaScript 将无法执行。 例如，如果我们将单选按钮“Revise”更改为“Revised”，但没有更新 StampCode 以匹配该术语，则 Stamp 将失败。

在 value 或 field 之后是描述，这是在放置图章并遇到 JavaScript 对话框后将显示的内容。 例如，表单字段“Spec”被引用为：

{ field:"Spec", description:"Spec #:", default:function() { return ""; } }

要自定义显示在 JavaScript 对话框中的字段说明，请在“表单”面板和 StampCode 中编辑表单字段的名称。 描述不需要与表单字段的名称相匹配。 例如，如果我们将 StampCode 中的“Spec #”更改为“Specification Number”，对话框将反映该更改。

编辑广播组

将新单选按钮添加到现有单选组

• 转到工具 > 图章，然后将光标悬停在所需图章上，然后点击右侧显示的编辑图标。
• 转到“表单”面板 (Alt + Q)。
• 选择表单面板中单选组状态中的单选按钮之一（即已批准、拒绝或修订）。 这应该突出显示图章中的单选按钮。
• 在图章中，右键单击选定的单选按钮并选择复制。
• 将单选按钮粘贴 (Ctrl+V) 到图章上所需的位置。
• 在“表单”面板中，双击新的单选按钮以对其进行重命名。 在此示例中，添加了一个单选按钮并重命名为“支持”。

 

• 转到工具 > 表单 > JavaScript（Ctrl + Shift +J）
• 选择 StampCode，然后点击 Edit 图标。
• 向 radioGroup 添加一个新值：

新的代码部分如下所示：

{ value:"Approved", description:"Approved" },
{ value:"Revise", description:"Revise" },
{ value:"Rejected", description:"Rejected" },
{ value:"Support", description:"Supported" }

 

• 点击确定退出 JavaScript 编辑器。
• 单击“确定”退出“全局 JavaScript”对话框。
• 保存图章并测试您的更改。

将图章添加到 PDF 时，图章对话框应显示创建的新选项。 在这种情况下，对话框现在显示第四个单选按钮，称为支持。

 

图章已成功修改！

如果您直接使用表单工具添加新的单选按钮，将创建第二个单选组，并且不会成为已存在的同一个单选组的一部分。 您可以在属性 (Alt + P) 中更改新单选按钮的名称，将名称更改为“状态”，这会将按钮添加到状态单选组中。

提交状态图章仅适用于一个 radioGroup。 如果您尝试添加第二个 radioGroup，则图章将不再正常工作。

 

有用的信息

交互式图章过程

总之，Interactive Stamp 过程按以下顺序发生：

• 放置图章。
• 计算脚本根据全局脚本生成图章对话框。
• 信息被输入到图章对话框中。
• 图章用所需的信息完成。

 

下拉列表和列表框字段类型

在扩展页面提供的多个图章中，您可能会注意到文本字段用作下拉列表或列表框表单字段。 使用实际的列表框或下拉列表字段类型将与嵌入在 Bluebeam 邮票中的任何计算脚本不兼容。

以下是在图章对话框中显示为下拉列表的文本字段示例：

 

文本字段“项目”充当图章对话框中的下拉列表。 将出现在图章对话框中的项目列表取决于图章代码。

 

故障排除

放置图章时不出现 JavaScript 对话框

交互式图章发生的最常见问题是计算字段被删除。 如果删除计算字段，则在放置图章时不会出现 JavaScript 对话框。

 

要在删除后重新创建计算字段，您首先需要找到并复制原始模板的计算字段

• 转到工具 > 图章，然后将光标悬停在所需图章（本例中为提交状态）上，然后点击右侧显示的编辑图标。
• 右键单击计算脚本并选择复制。

 

然后将 Calculation 字段添加到损坏的图章中：

• 转到工具 > 图章，然后将光标悬停在所需图章上，然后点击右侧显示的编辑图标。
• 转到工具 > 表单 > 文本框。 将文本框放在图章中的任意位置，然后使用表单面板命名字段计算。

 

• 右键单击“计算”字段并选择“属性”。 进入“属性”后，向下滚动到“计算”并将其设置为“自定义计算”字段。

 

• 在图章的计算脚本中单击编辑并粘贴 (Ctrl + V)。
• 保存图章。
• 转到“文件”>“新建”并将图章放在文档上以验证它是否正常工作。

 

如果您在本文中的步骤中遇到任何问题或对我们的交互式图章有任何疑问，请发送电子邮件给我们。