为何在 HotDocs 11 Rock 文档生成中使用参数和局部变量

几年前,我的中年危机之一就是参加了编程入门班。在此之前,我来自右脑文学背景,在那里,真实性和 "原创性 "被放在首位。每个项目都是艺术品。因此,在我的编程课上,我想从头开始编写每个程序,确保我认为最有效的

Decorative image
几年前,我经历了一场中年危机,于是报名参加了编程入门课程。此前我来自右脑主导的文学背景,那里将真实性与"原创性"奉为圭臬。每个项目都必须是艺术品。因此在编程课上,我坚持从零开始编写每个程序,确保采用我认为最高效的方法,融入个人艺术风格,使其成为独一无二的作品。 当我发现程序员们竟鼓励甚至全心拥抱某种形式的抄袭时,着实大吃一惊: 可复用代码既然某些函数(不妨称之为“脚本”或“计算”)不仅在此处,而且在其他地方乃至任何地方都能正常运行,为何还要重新编写它们?

这种方法的原理是采用一个代码模型块--可以说是一个代码模板--将变量信息传递给其占位符,即可在任何适用的地方使用。这样,无论是文本字符串、真假值还是数字,输出结果都是一样的,但你传递给它的 "参数 "会根据需要而改变。这是一个很好的概念,可以最大限度地减少冗余。与参数一起出现的还有局部变量的概念:变量只有在函数或脚本的处理过程中才有各自的值。随着HotDocs 11 的发布,HotDocs 脚本世界引入了参数和局部变量功能(并非双关语)。BPM 领域的模板开发人员终于拥有了提高脚本效率和确保脚本可重用性所需的工具。

参数

使用参数的一种方法是进行文本计算,将名字、中间名和姓串联起来。然后,您可以在文档中的任何地方使用该计算,并为客户、对方当事人、受托人等传递名、中、姓值。但是您只需编写一个计算:

/// Name: GetFullName

/// Type: Text Computation

/// Locals:

PARAM FirstName: TEXT

PARAM MiddleName: TEXT

PARAM LastName: TEXT

/// Script:

SPACE(FirstName) + SPACE(MiddleName) + VALUE(LastName)

对于客户的姓名,您可以在文档中输入 "GetFullName(ClientFirstName, ClientMiddleName, ClientLastName)",传递客户的名字、中间名和姓的值。您还可以使用参数进行模型计算,如计算摊销或利息、输出内联和块地址,以及确定某些表达式的真值(如 42)。您可以输入文本、数字、真/假值和日期值。参数有很多妙用。反过来,这样做的好处是减少了 CMP 文件中的名称、地址和计算量,代码更简洁,文件生成更高效。

本地变量

还记得您在需要为索引或计数设置临时数字变量时创建的所有 "Temp NU "变量吗?现在这些临时变量再也不会弄乱你的 CMP 文件了。现在你可以将这些变量与它们 "所在 "的脚本关联起来,这样它们就不会存在于脚本之外了。它们是在创建计算时定义的。与参数一样,您可以定义文本、数字、真/假和日期类型。

HotDocs 脚本共享

在脚本中使用参数和局部变量的另一个好处是,您有机会与 HotDocs 社区分享您的代码模板艺术作品。由于使用参数的脚本可以全局应用,因此任何人都可以在文档生成中使用它们。因此,请访问HotDocs 论坛,登录并单击HotDocs 脚本共享,然后开始分享。我们发布的模型脚本越多,我们就能通过促进创建更高效的文档模板,为彼此和更广泛的 HotDocs 社区提供更多帮助。

祝您编写脚本愉快!


编者按 本文最初发表于 HotDocs.com.2024 年 6 月,Mitratech 收购了高级文档自动化平台 HotDocs。此后,我们对内容进行了更新,以纳入与我们的产品、法规变化和合规性相一致的信息。