#Entorno de desarrollo

¿Te estás preparando para usar VS Code por primera vez? Asegúrate de que tengas los privilegios suficientes.

¿Has definido tu servidor IRIS en la configuración de VS Code y aún recibes el siguiente error?

VS Code accede a IRIS/HealthConnect mediante la aplicación web /api/atelier. Si no tienes permiso (si estás utilizando por ejemplo un usuario LDAP para conectarte y la aplicación web no está configurada para admitir LDAP), esta es la razón por la que no pudiste conectarte.

También verás una entrada de 'Error de inicio de sesión' en la base de datos de auditoría con dicho motivo.

¡Hola comunidad!

En el pasado, la documentación técnica del código fuente y de los productos de software se generaba en archivos chm, pdf y generadores de documentación de los propios lenguajes de programación. Este enfoque antiguo tenía las siguientes limitaciones:

1. Documentación obsoleta,
2. Documentación no interactiva y difícil de consultar,
3. Diseño poco amigable y que no se adhiere a HTML,
4. Imposibilidad de personalizar el diseño de los documentos,
5. Imposibilidad de tener documentación en HTML 5 online y offline.
6. Falta de soporte a Markdown.

Hoy en día, existen varias soluciones de generación de documentación que producen Portales de Documentación Web muy atractivos, interactivos y con opciones estáticas y dinámicas, con soporte total para HTML 5 y más recientemente Markdown.

Consulta la tabla con las opciones de código abierto más populares:

¡Hola desarrolladores!

Comparto con vosotros una plantilla de Python Embebido básica, que recomiendo como punto de partida para cualquier proyecto general con InterSystems IRIS que use Python Embebido.

Funcionalidades:

• Python Embebido configurado;
• 3 ejemplos con difentes formas de desarrollar con Python Embebido;
• VSCode configurado;
• Docker disponible;
• Demo online disponible;
• Desarrollo ZPM First disponible.

Vamos a comentar estas funcionalidades.

¿Os gustaría poder acceder al Terminal Web directamente desde vuestro VSCode?

Este es otro genial artículo de la serie de Tani Frankel sobre "Trucos y consejos de VSCode" y es bastante similar al anterior sobre el Asistente SOAP.

Atelier necesita como mínimo la versión de Java 1.8 para su ejecución. pero manejar diferentes versiones de Java puede ser algo enredada en OSX (Mac)

En este artículo trato de explicar cómo manejar diferentes versiones de Java en el Mac.

El siguiente comando nos puede ayudar a aclarar algunos problemas en nuestro entorno:

Con https://openexchange.intersystems.com/package/IRIS-Publisher puedes documentar tu IRIS Application y generar el Portal Web con Documentación de la Aplicación (responsive). Mira los resultados:

Página principal:

Menú "Clases" y página "Clase": La página "clase" con documentación de la clase, la lista de métodos y propiedades.

Navigation and Search bar:

Cuadro de búsqueda:

Página "Sobre nosotros": tus contactos

Cambia el tema:

Como anunciamos por primera vez en mayo, y tras muchas presentaciones y debates en el Global Summit 2023, seguimos adelante con los planes de "deprecar" o discontinuar InterSystems Studio (deprecated designa una funcionalidad o tecnología que InterSystems ya no desarrolla de forma activa y para la que existen mejores opciones).

InterSystems Studio fue discontinuado en 2023.2, pero continuará siendo incluido en las versiones 2023.3 y 2024.1.

¡Hola colegas!

A menudo, durante el desarrollo de una aplicación frontend o cualquier otro tipo de comunicación vs API REST, vale la pena tener una Swagger UI - una interfaz de usuario de prueba para la API REST que sigue la especificación Open API 2.0. Por lo general es de gran ayuda, ya que permite, todo en uno, hacer pruebas manuales rápidas vs API REST, con sus respuestas y todos los datos.

Recientemente he introducido el soporte Swagger en la plantilla InterSystems IRIS FHIR para la API FHIR R4:

¿Cómo hacerlo funcionar?

Estoy encantado de anunciar que InterSystems se unirá a la comunidad de código abierto (open source) en el proyecto de Extensión de Visual Studio Code para InterSystems ObjectScript. A principios de este año Raj Singh publicó que emprendíamos un viaje para redefinir el futuro de nuestra estrategia en relación al IDE, y llegamos a la conclusión de que es Visual Studio Code el IDE que puede soportar ese futuro.

Comenzando este año 2023, hemos programado una serie de cursos oficiales sobre InterSystems IRIS que iremos realizando a lo largo del año. Los cursos se impartirán on-line y ya están abiertos para que os podáis registrar si estáis interesados (hasta un máximo de 10 personas por curso, quorum mínimo 5 asistentes). Toda la información está disponible en nuestro sitio web: Formación en el aula virtual | InterSystems

Os presento el soporte de InterSystems IRIS en IntelliJ IDEA. Este plugin añade soporte de Syntax Highlighting para ObjectScript, así como la auto importación y la compilación en el servidor después de guardar un archivo modificado. Utiliza LanguageServer escrito en Rust, donde se añadió la capacidad de importar y compilar código.

Una solución de control de versiones eficaz permite a las organizaciones gestionar bases de código complejas, facilitar una colaboración sin fisuras dentro de los equipos de desarrollo y agilizar los procesos de despliegue.

Sonic Healthcare, un proveedor líder de servicios médicos corporativos, de práctica general, radiología y patología, ha mejorado significativamente la visibilidad y el control sobre su entorno complejo al implementar el control de versiones de Deltanji.

Hola desarrolladores!

Este es otro artículo para simplificar la vida de los desarrolladores. Hablamos de hacer que GitHub ejecute tus pruebas unitarias (unittest) con cada push que hagas a tu repositorio simplemente añadiendo un fichero. Gratis :). En GitHub Cloud. Suena genial, ¿no?

Es factible, y además muy sencillo. El mérito es para @Dmitry Maslennikov (y su repo), el gestor de paquetes ZPM y las GitHub Actions. Vamos a ver cómo funciona todo en conjunto.

Al trabajar desde casa durante estos "días de coronavirus", me faltan recursos.

• no tengo ninguna máquina Linux disponible
• espacio en disco limitado

Además, Docker Desktop (en Windows10) bloqueó de alguna manera los scripts de Durable %SYS como se describe aquí.
Investigando el caso, descubrí que se almacenaban muchos más datos de los que realmente necesitaba.
Así que diseñé mi durabilidad personalizada.

Al empezar el desarrollo con IRIS tenemos un kit de distribución o, en el caso de Docker, obtenemos la imagen Docker y después a menudo tenemos que iniciarla y configurar el entorno de desarrollo. Puede que necesitemos crear bases de datos, namespaces, activar/desactivar algunos servicios, crear recursos. Muchas veces necesitamos importar el código y los datos a la instancia de IRIS y ejecutar algún código personalizado para iniciar la solución.

Sólo quería dar visibilidad a un repositorio en GitHub donde todo el mundo puede publicar Peticiones de Mejora de producto, Ideas e Innovaciones que crea que estarían muy bien tener dentro de nuestro ecosistema de tecnologías de InterSystems.

Si quieres añadir tu solicitud de mejora, o echar un vistazo y ver si ya está allí, votar por ella, contribuir, etc.., haz click en este link

Hola desarrolladores:

Al observar la avalancha de herramientas de desarrollo impulsadas por IA y al estilo vibe coding que han estado apareciendo últimamente casi cada mes, con funciones cada vez más emocionantes, me preguntaba si sería posible aprovecharlas con InterSystems IRIS. Al menos para construir un frontend. Y la respuesta es: ¡sí! Al menos con el enfoque que seguí en este ejemplo.

Aquí tenéis mi receta para crear la interfaz de usuario mediante prompts frente al backend de InterSystems IRIS:

1. Tened una API REST en el lado de IRIS, que refleje una especificación Open API (swagger).
2. Generad la interfaz de usuario con cualquier herramienta de vibe coding (por ejemplo, Lovable) y apuntad la interfaz al endpoint de la API REST.
3. ¡Y listo!

Aquí tenéis el resultado de mi propio experimento: una interfaz 100 % generada por prompts frente a la API REST de IRIS, que permite listar, crear, actualizar y eliminar entradas de una clase persistente (Open Exchange, código del frontend, vídeo).

¿Cómo es la receta en detalle?

¡Hola desarrolladores!

Aquí podéis ver el anuncio del proyecto isc-tar de @Dmitriy Maslennikov. En ocasiones, la historia de porque se ha llegado a un resultado es igual o más interesante que el resultado: cómo se construyó, cómo funciona y qué sucede en torno al proyecto. Esta es la historia:

• Cómo desarrollar este proyecto
• Cómo probarlo
• Cómo lanzar nuevas versiones para publicar
• Cómo automatizar todo lo anterior
• Integración continua

Os hablaré de todo eso.

Traducción del artículo originalmente publicado el 27 de Febrero de 2023

Me complace anunciar la versión 2.6.0 de la extensión VS Code ObjectScript, que contiene un buen número de mejoras para hacer más fácil la vida de los desarrolladores. Describo más abajo las más destacadas. Como siempre, podéis encontrar la lista de modificaciones en el CHANGELOG, incluyendo muchas correcciones de errores y vulnerabilidades.

Cambio rápido de namespaces

Gracias a @Olli Tanskanen de nuestro partner JediSoft Oy por esta mejora!

Además de IntelliJ IDEA, ahora es posible configurar SublimeText3 para compilar código con él. Solo necesitarás el servidor de idiomas que hice.

Existen muchas aplicaciones para trabajar con mensajes HL7 V2, pero las herramientas para trabajar con XML en el Portal de Gestión o los IDE de IRIS son limitadas. Aunque hay muchas utilidades externas e IDEs que funcionan con mensajes XML e incluso documentos C-CDA, hay una razón convincente para poder hacer pruebas directamente en el marco de trabajo C-CDA de IRIS.

Hacer pruebas dentro del entorno de IRIS os proporciona el contexto necesario:

• Configuración del analizador XML
• Contexto del espacio de nombres XML
• Configuración de facilidades y OID
• Manejo de cabeceras IHE
• Los paquetes HS.

¡Hola a tod@s!

En esta serie de artículos me gustaría presentar y discutir varios enfoques posibles para desarrollar software mediante las tecnologías de InterSystems y GitLab.

¡Hola desarrolladores!

Cuando desarrollas con ObjectScript Package Manager, un aspecto crucial es la versión del paquete, que situamos en el fichero module.xml. Cuando añadimos cambios al paquete y estamos listos para publicar una nueva versión del paquete en el registro, también necesitamos aumentar el número de versión. Esto está claro, pero es un poco molesto, y a menudo podemos olvidarnos de hacerlo. 

Este breve artículo os ayudará a automatizar ese proceso.

Ahora que la extensión de ObjectScript para VS Code ha alcanzado la versión 1.0 y ha sido presentada en varias sesiones de la Cumbre Virtual 2020, parece un buen momento para ofrecer algunos consejos sobre cómo reportar problemas.

InterSystems ObjectScript para VS Code se basa en tres extensiones de VS Code que colaboran entre sí. Para facilitar la instalación y la administración hay una cuarta entidad, el paquete de extensiones de InterSystems ObjectScript. Es la mejor manera de empezar con un mínimo de clics y es práctico tenerlo incluso si ya habéis instalado las otras extensiones.

IRIS admite transformaciones CCDA y FHIR de forma nativa, pero acceder y visualizar estas funcionalidades requiere tiempo de configuración y conocimiento del producto. La aplicación IRIS Interop DevTools fue diseñada para cerrar esa brecha, permitiendo a los implementadores comenzar de inmediato y explorar las capacidades de transformación integradas del producto.

¡Hola desarrolladores!

Estoy seguro de que la mayoría de vosotros ya conoceis la posibilidad de usar GZIP en los productos de InterSystems. Pero el problema es que GZIP trabaja con un único archivo o flujo de datos, y no admite carpetas. Al trabajar con sistemas Unix, es posible solucionarlo con la herramienta de compresión tar, incluida en cada sistema Linux de forma predeterminada. Pero ¿qué hacer si debemos trabajar también en Windows, que no lo incluye?

Me alegra poder enseñaros el nuevo proyecto, isc-tar, que os ayudará a no preocuparos del sistema operativo y os permitirá gestionar los archivos tar en cualquier sitio.

¡Buenas noticias para los desarrolladores que usan GitLab como repositorio de aplicaciones de InterSystems! Open Exchange ha ampliado su soporte para incluir GitLab, lo que permite enviar proyectos tan fácilmente como se haría con repositorios de GitHub. 

Cómo enviar a Open Exchange una aplicación del repositorio de GitLab:

1. Entra en Open Exchange e inicia sesión con tu cuenta.
2. Ve a "Submit Application" (Enviar aplicación)
3. En el campo "GitHub/GitLab URL", añade el enlace a tu repositorio abierto de GitLab.
4. Asegúrate de marcar la casilla "Use GitHub/GitLab README as long description". Esto asegura que el fichero README de tu proyecto sirve como descrición larga para la aplicación.

El lenguaje ObjectScript de InterSystems IRIS tiene un motor de metadatos muy potente llamado XData. Esta característica permite crear definiciones de metadatos para tus clases, que serán utilizadas por el compilador o por los programas para ampliar las características estándar del lenguaje, basándose en las definiciones XData de su campo de acción.

Un ejemplo es IRIS Publisher, una aplicación de código abierto de la Comunidad, capaz de recopilar todas las definiciones de XData en formato HTML y/o Markdown, y que puede generar un Portal web con todos los documentos de la aplicación, recopilados a partir de estos elementos XData.

Hemos tenido Webterminal disponible durante bastante tiempo, pero era limitado, no todas las funciones funcionaban allí. No había soporte para shell ni para la última funcionalidad de soporte integrado de Python. Hay algunos problemas con las herramientas que requieren el modo de programador. La autenticación básica no es tan práctica como una simple página de inicio de sesión, donde podríais tener opciones para agregar vuestra propia página de login, en caso de que deseaseis cambiar la forma de iniciar sesión en la aplicación, como por ejemplo usando SSO (inicio de sesión único).

Con el terminal Iris original, envuelto en un formulario web y utilizando xterm.js, una de las herramientas más usadas en el mundo web, como en VSCode, junto con algo de magia de Python, que ayudó con la comunicación interprocesos tty, podemos llevar el terminal a la web con todas sus capacidades.

Como sabéis, el namespace EnsDemo de Ensemble ya no está disponible en IRIS.

Esto es algo positivo, ya que IRIS está orientada a la nube y por lo tanto debe ser lo más ligera y rápida posible. La nueva forma de compartir ejemplos de código o módulos es a través de git, integración continua y OpenExchange.

Pero no os preocupéis, somos conscientes de que, en algunos casos, querréis volver a recuperar ejemplos y código presente en EnsDemo, ya sea como fuente de inspiración o para ayudaros a revisar buenas prácticas.