HotDocs Developer 11: La perspectiva de un desarrollador sobre las nuevas funciones

Una de las ventajas de ser el abogado contratado por HotDocs es que puedo probar sus novedades antes que nadie. Compañeros desarrolladores, HotDocs Developer 11 os va a encantar. Aquí tenéis una breve nota sobre lo que podéis esperar y algunos consejos para sacar el máximo partido al software.

Soy desarrollador de plantillas y abogado en ejercicio, y he estado actualizando las plantillas de mis clientes para prepararlas para esta versión. Esta nota da por sentado que usted también es un usuario experimentado. No forma parte de las notas oficiales de la versión, por lo que le recomendamos que eche un vistazo al texto habitual del archivo Léame y utilice los nuevos archivos de ayuda.

Lo que más me ha impactado: la compatibilidad con .docx como formato nativo para las plantillas. El proceso de renderización de documentos a través de archivos RTF tenía problemas inherentes que ahora han desaparecido. Tendrá que utilizar Word para guardar sus plantillas RTF actuales como archivos .docx, ya que HotDocs no realiza esa conversión. Lo primero que notará, si tiene algún gráfico, como logotipos de empresas, es que el tamaño del archivo de su plantilla se reducirá. Algunas de mis plantillas con logotipos de clientes se han reducido drásticamente.

Lo siguiente que notarás es que ahora es mucho más fácil controlar el formato. Es el momento de familiarizarse con el uso de los estilos en Word, cómo importarlos a los documentos y cómo establecer las fuentes predeterminadas en los documentos. Recomiendo utilizar estilos con nombres personalizados para que no haya riesgo de que entren en conflicto cuando lleguen a los ordenadores de tus clientes. Especialmente con las plantillas insertadas, veo que se acabaron los problemas con el formato inconsistente de los párrafos. Esto es una ventaja visible para los usuarios de tus plantillas.

Hablando de los usuarios de plantillas, no olvide que necesitarán utilizar una versión compatible de HotDocs, ya sea HotDocs Server 11, HotDocs User 11 o HotDocs Player 11. De lo contrario, no podrán leer sus plantillas. Puede forzar a Developer 11 a crear plantillas que sean compatibles con versiones anteriores, pero no le conviene hacerlo.

Cuando empecé a actualizar mis plantillas existentes, caí en una trampa que había pasado por alto. Tenía un esquema de nomenclatura de variables que incluía algunos nombres de variables en mayúsculas. Por ejemplo, podía tener una variable de fecha llamada «Fecha del acuerdo PRINCIPAL». En ese momento me pareció una buena idea. Tengo algunos conjuntos de plantillas que tenían casi 2000 variables, por lo que era esencial establecer algún tipo de convención de nomenclatura. El problema es que utilicé algunas palabras que ahora son nuevas palabras clave en HotDocs. Developer 11 incluye una serie de nuevas expresiones matemáticas. Por ejemplo, se puede utilizar TERM para calcular los plazos de los préstamos como parte del nuevo modelo financiero. Tenía algunas variables que casualmente tenían el prefijo «TERM» y eso fue un problema. Es culpa mía: el consejo habitual es que no se deben utilizar términos en mayúsculas, ya que siempre existe el riesgo de que entren en conflicto con nuevas palabras reservadas para el software. Yo lo hice de todos modos. Quizás usted también.

Acabo de mencionar los nuevos modelos de expresiones matemáticas, que sin duda ahorrarán a algunos desarrolladores tener que crear sus propios cálculos.

Después de la compatibilidad con .docx, mi característica favorita (soy británico, así que perdónenme la ortografía) es la compatibilidad con parámetros y variables locales. Hay críticos a los que les encanta decir que HotDocs requiere scripts que parecen programación, pero ustedes ya han superado ese debate o no estarían leyendo esto. Sin embargo, espero que algunos de esos críticos digan «te lo dije» cuando oigan mencionar «parámetros» o «variables locales». No eres tan simplista, ¿verdad? Para cualquiera de vosotros que cree plantillas complejas, estas funciones os harán sonreír. Creo que facilitan la creación de plantillas más fáciles de seguir. Llevo ya un tiempo utilizando Developer 11 y me he dado cuenta de que puedo volver a una plantilla que no he tocado durante un tiempo razonable y me resulta más fácil recordar cómo funcionaban mis scripts y cálculos.

Los parámetros y las variables locales son más difíciles de explicar al principio, pero una vez que los haya utilizado, no querrá prescindir de ellos. He aquí un ejemplo de cómo los utilicé recientemente: estaba trabajando en una plantilla para un contrato de subcontratación que incluía una tabla con el número de días necesarios para determinadas tareas. Había varias tablas que podían incluirse, cada una con múltiples filas. El número de días dependía de varios cálculos. Ahora bien, el problema era que los días no eran días completos, sino que podían ser, por ejemplo, 1 ¼ días o 2 ½ días. Obviamente, todos los cálculos tenían que utilizar números decimales, pero mi cliente quería que se mostraran como fracciones. Creé un cálculo con un parámetro que convertía cualquier número decimal en una fracción (que tenía que estar en formato de texto, obviamente). Con la versión anterior de HotDocs, habría tenido que repetir el mismo cálculo docenas de veces.

Las variables locales son muy útiles en scripts o cálculos en los que es necesario almacenar resultados temporales de cálculos. Hasta ahora, los cálculos podían manipular un solo valor interno, concretamente «RESULT». Eso era limitante. Ahora se puede tener cualquier número de valores en el cálculo.

El nuevo Administrador de plantillas tiene el mismo aspecto, pero ahora me resulta mucho más rápido. Tenía algunas bibliotecas de componentes grandes que podían afectar al Administrador de plantillas si realizaba demasiados cambios sin cerrarlo de vez en cuando para forzar una actualización de la base de datos. Eso ya no es un problema, y ahora es muy rápido.

Hay otros cambios también, y esta nota no les hace justicia. En cambio, solo quería despertar su interés por la actualización. Oigan, será gratis para la mayoría de ustedes con contratos de mantenimiento. Vale la pena la actualización aunque solo sea por la compatibilidad con .docx, pero no pasen por alto esas nuevas funciones. Sus clientes no las verán, pero les darán esa cálida sensación interior.

He oído que hay un nuevo foro para que los desarrolladores intercambien ideas sobre cálculos. Es de esperar que se vean algunos usos imaginativos de variables y parámetros locales. ¿Alguien quiere un conversor de decimales a fracciones?

Charles Drayson
[email protected]


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.