Hola,

He pensado en compartir con vosotros un hook bastante útil que me ha ayudado cuando desarrollo en Health Connect Cloud con VS Code y GitBash. Al desarrollar en Health Connect Cloud, si hacéis cambios directamente en el servidor, como reglas de enrutamiento o despliegue de componentes, estos no se incluyen automáticamente en el control de versiones; por lo tanto, debéis exportarlos desde el servidor a vuestros archivos locales y hacer push a vuestro repositorio remoto. Estoy seguro de que hay métodos más sencillos para gestionar esto, que estoy en proceso de probar, pero como solución rápida pensé que sería útil tener un hook de pre-commit que active un recordatorio en GitBash. Mirad el ejemplo a continuación.

Este recordatorio se puede ajustar para mencionar las reglas de enrutamiento y cualquier otra cosa que penséis que debe tenerse en cuenta para exportar.

El código del hook:

#!/bin/bash
# Git pre-commit hook - gentle reminder for Production.cls
targetFile="src/HCC/Connect/Production.cls"
# Check if Production.cls is already staged
staged=$(git diff --cached --name-only | grep "$targetFile")

# If Production.cls is not staged, show a gentle reminder
if [ -z "$staged" ]; then
    echo ""
    echo "💡 Gentle reminder: Have you made any changes to the Production class on the server?"
    echo ""
    echo "   If YES: Export and add $targetFile to this commit"
    echo "   If NO:  Continue with: git commit --no-verify"
    echo ""
    echo "   (This reminder appears on every commit - use --no-verify to skip)"
    echo ""
    exit 1
fi
# Production.cls is staged, proceed normally
exit 0

Espero que esto os resulte útil a quienes desarrolláis con Health Connect Cloud.

Jordan

Empezar con ObjectScript es realmente emocionante, pero también puede resultar un poco extraño si estáis acostumbrados a otros lenguajes. Muchos principiantes tropiezan con los mismos obstáculos, así que aquí tenéis algunas "trampas” a las que debéis prestar atención. (Y también algunos consejos para evitarlas)

PONER NOMBRES AL AZAR

Todos hemos caído en la tentación de llamar a algo Test1 o MyClass solo para avanzar rápido. Pero una vez que vuestro proyecto crece, esos nombres se convierten en una pesadilla.

➡ Elegid nombres claros y coherentes desde el principio. Pensad en ello como si dejarais migas de pan para vuestro yo del futuro y para vuestros compañeros de equipo.

CONFUNDIR GLOBALES Y VARIABLES

Los globales (^GlobalName) pueden ser confusos al principio. No son simples variables. Viven en la base de datos y permanecen incluso después de que vuestro código deje de ejecutarse.

➡ Usadlos solo cuando realmente necesitéis datos persistentes. Para todo lo demás, quedaos con variables locales. (Esto también ahorra almacenamiento.)

OLVIDAR LAS TRANSACCIONES

Imaginad que actualizáis el registro de un paciente y vuestra sesión se bloquea a mitad de camino. Sin una transacción, os quedaríais con datos a medio hacer.

➡ Encapsulad las actualizaciones importantes en TSTART/TCOMMIT. Es como pulsar “guardar” y “deshacer” al mismo tiempo.

CONSTRUIR SQL EN CADENAS

Es tentador meter SQL directamente en cadenas y ejecutarlo. Pero eso rápidamente se vuelve desordenado y difícil de depurar.

➡ Usad SQL embebido. Es más limpio, seguro y fácil de mantener.

EJEMPLO:

❌ Construir SQL en cadenas

Set id=123
Set sql="SELECT Name, Age FROM Patient WHERE ID="_id
Set rs=##class(%SQL.Statement).%ExecDirect(,sql)

✅ Uso de SQL Embebido

&SQL(SELECT Name, Age INTO :name, :age FROM Patient WHERE ID=:id)
Write name_" "_age,!

SALTARSE EL MANEJO DE ERRORES

A nadie le gusta ver cómo su aplicación se bloquea con un mensaje críptico. Eso suele pasar cuando se ignora el manejo de errores.

➡ Encapsulad las operaciones arriesgadas en TRY/CATCH y daos a vosotros mismos mensajes de error con sentido.

IGNORAR MEJORES HERRAMIENTAS

Sí, el terminal funciona. Pero si solo programáis ahí, os estáis perdiendo mucho.

➡ Usad VS Code con la extensión de ObjectScript. La depuración, el autocompletado y el resaltado de sintaxis hacen la vida mucho más fácil.

REINVENTAR LA RUEDA

Los desarrolladores nuevos suelen intentar escribir sus propias utilidades de registro o de manejo de JSON, sin darse cuenta de que ObjectScript ya tiene soluciones integradas.

➡ Explorad %Library y los objetos dinámicos antes de crear lo vuestro.

ESCRIBIR “CÓDIGO MISTERIOSO”

Todos hemos pensado: “Esto lo recordaré más tarde.”

⚠️ SPOILER: ¡NO LO HARÉIS!

➡ Añadid comentarios breves y claros. Incluso una sola línea explicando por qué habéis hecho algo ayuda muchísimo.

CONCLUSIONES FINALES :)

Aprender ObjectScript es como aprender cualquier otro lenguaje nuevo. Requiere un poco de paciencia, y cometeréis errores por el camino. La clave está en reconocer estas trampas comunes cuanto antes y construir buenos hábitos desde el principio. De ese modo, en lugar de pelearos con el lenguaje, disfrutaréis realmente de lo que puede hacer.