Por qué los parámetros y las variables locales en HotDocs 11 revolucionan la generación de documentos

Hace unos años, una de mis crisis de mediana edad fue apuntarme a un curso de introducción a la programación. Antes, venía de un entorno literario, más creativo, donde se daba mucha importancia a la autenticidad y la «originalidad». Cada proyecto tenía que ser una obra de arte. Así que, para mi curso de programación, quería escribir cada programa desde cero, asegurándome de que fuera lo más eficiente posible.

Decorative image
Hace unos años, una de mis crisis de mediana edad fue apuntarme a un curso de introducción a la programación. Antes, venía de un entorno literario, más creativo, donde se daba mucha importancia a la autenticidad y la «originalidad». Cada proyecto tenía que ser una obra de arte. Así que, en mi clase de programación, quería escribir cada programa desde cero, asegurándome de que fuera lo más eficiente posible, añadiendo mi toque artístico y haciéndolo mío. Imaginen mi sorpresa cuando descubrí que los programadores fomentan, e incluso aceptan de todo corazón, una especie de plagio: Código reutilizable¿Por qué reescribir funciones (piensa en «scripts» o «cálculos») que ya funcionan, no solo aquí, sino allí y en todas partes?

La idea es tomar un bloque de código modelo —una plantilla de código, por así decirlo— que se puede utilizar siempre que sea aplicable, pasando información variable a sus marcadores de posición. El resultado es el mismo, ya sea una cadena de texto, un valor verdadero/falso o un número, pero los «parámetros» que se le pasan cambian según sea necesario. Es un concepto maravilloso que minimiza la redundancia. Junto con los parámetros, también surge la idea de las variables locales: variables que tienen sus respectivos valores solo durante el tiempo de procesamiento de la función o el script. Con el lanzamiento de HotDocs 11, se han introducido en el mundo de los scripts de HotDocs tanto la funcionalidad de los parámetros como la de las variables locales. Por fin, los desarrolladores de plantillas en el mundo de BPM disponen de las herramientas que necesitan para aumentar la eficiencia de sus scripts, así como para garantizar su reutilización.

Parámetros

Un uso de los parámetros es realizar un cálculo de texto que una el nombre, los segundos nombres y los apellidos. A continuación, puede utilizar este cálculo en cualquier parte del documento e introducir los valores del nombre, los segundos nombres y los apellidos de los clientes, las partes contrarias, los fideicomisarios, etc. Pero solo tiene que escribir un cálculo:

/// Name: GetFullName

/// Type: Text Computation

/// Locals:

PARAM FirstName: TEXT

PARAM MiddleName: TEXT

PARAM LastName: TEXT

/// Script:

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

Para el nombre de un cliente, puede introducir «GetFullName(ClientFirstName, ClientMiddleName, ClientLastName)» en su documento, pasando los valores del nombre, segundo nombre y apellido del cliente. También puede realizar cálculos de modelos que calculen cosas como la amortización o los intereses, generar direcciones en línea y en bloque, y determinar la veracidad de ciertas expresiones (por ejemplo, 42), todo ello utilizando parámetros. Puede introducir valores de texto, números, verdadero/falso y fechas. Los parámetros tienen muchos usos excelentes. A su vez, las ventajas son menos cálculos de nombres, direcciones y cálculos en su archivo CMP; un código más limpio; y un enfoque más eficiente para la generación de documentos.

Variables locales

¿Recuerdas todas esas variables «Temp NU» que creaste cuando necesitabas configurar variables numéricas temporales para indexar o contar? Estas variables temporales ya no saturarán tu archivo CMP. Ahora puedes asociar estas variables con el script en el que «viven», de modo que no existirán fuera de ese script. Se definen cuando creas el cálculo en el que las utilizarás. Al igual que los parámetros, puedes definir tipos de texto, número, verdadero/falso y fecha.

Compartir scripts de HotDocs

Otra ventaja de utilizar parámetros y variables locales con sus scripts es la oportunidad de compartir su obra maestra de plantilla de código con la comunidad HotDocs. Dado que los scripts que utilizan parámetros se pueden aplicar de forma global, cualquiera puede utilizarlos en la generación de documentos. Así que entre en el foro de HotDocs, inicie sesión, haga clic en «HotDocs Script Sharing» (Compartir scripts de HotDocs) y comparta lo que desee. Cuantos más scripts modelo publiquemos, más nos ayudaremos unos a otros y más ampliaremos la comunidad HotDocs, facilitando la creación de plantillas de documentos más eficientes.

¡Feliz programación!


Nota de la Redacción: Este artículo se publicó originalmente en HotDocs.com. En junio de 2024, Mitratech adquirió la plataforma avanzada de automatización de documentos, HotDocs. El contenido ha sido actualizado desde entonces para incluir información alineada con nuestra oferta de productos, cambios en la regulación y cumplimiento.