这种方法的原理是采用一个代码模型块--可以说是一个代码模板--将变量信息传递给其占位符,即可在任何适用的地方使用。这样,无论是文本字符串、真假值还是数字,输出结果都是一样的,但你传递给它的 "参数 "会根据需要而改变。这是一个很好的概念,可以最大限度地减少冗余。与参数一起出现的还有局部变量的概念:变量只有在函数或脚本的处理过程中才有各自的值。随着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。此后,我们对内容进行了更新,以纳入与我们的产品、法规变化和合规性相一致的信息。
