Algunos de vosotros no conoceréis esta limitación o problema conocido que se produce en los Procesos de Negocio (Business Processes) basados en BPL.
Aquellos que no estabais al tanto quizá os habéis encontrado esto:
ERROR <Ens>ErrBPTerminated: Terminating BP <my_process_name> # due to error:
ERROR #7201: Datatype value 'xxS6xxS6...xxS6' length longer than MAXLEN allowed of 5
ObjectScript tiene diferentes formas para gestionar errores (códigos %Status, %Exception, SQLCODE, etc). La mayor parte del código de sistema utiliza códigos pero las son en ocasiones más fáciles de gestionar.
Si tienes que trabajar o mantener aplicaciones con cierto recorrido seguramente acabes lidiando con distintas técnicas de gestión de errores. A continuación os dejo una chuleta u hoja de trucos que puede servir como referencia. ¡Espero que os sea útil!
¡Hola desarrolladores!
Últimamente he estado probando el módulo csvgen y buscaba un fichero CSV para probar. Resulta que encontré un fichero muy interesante en Data.World con estadísticas sobre los episodios de Game of Thrones (Juego de Tronos). Estadísticas sobre muertes 😱.
¡Han documentado todos los asesinatos a lo largo de las 8 temporadas y han anotado dónde, quién, qué clan y con qué arma ha matado a otro personaje!
Así que lo he importado para hacer un cuadro de mando con IRIS Analytics.
No te preocupes, Jon. Con este cuadro de mando podremos hacer que averigües algo.
¡Hola desarrolladores!
Con frecuencia, cuando colaboramos con el repositorio de alguien en GitHub, seguimos el siguiente ciclo:
¡Todo esto es genial y funciona bien!
Y si queremos realizar una segunda colaboración justo después de llevar a cabo un Merge , es necesario que primero realicemos un Fetch upstream en nuestro repositorio clonado para que tengamos disponibles los cambios actualizados que incorporamos al repositorio original a través del Pull Request.
Los más frikies de git lo hacen muy fácilmente, pero muchos terminamos simplemente por eliminar nuestro primer fork y crear otro nuevo.
¡Hola desarrolladores!
Otra forma de empezar a utilizar InterSystems Objectscript Package Manager es descargar las imágenes pre-construidas de InterSystems IRIS Community Edition o IRIS for Health Community Edition.
Estas imágenes de IRIS están desplegadas en DockerHub y puedes ejecutarlas directamente con este comando:
docker run --rm -p 52773:52773 --init --name my-iris -d intersystemsdc/iris-community:2021.1.0.215.0-zpm
¡Hola desarrolladores!
A veces necesitamos importar datos CSV de forma programática en InterSystems IRIS desde un fichero o una URL. Y esperamos además que automáticamente se genere una clase con los tipos de datos adecuados y los datos importados.
Echadle un ojo al módulo csvgen en Open Exchange que hace exactamente eso que hemos descrito.
Si necesitas importar un fichero CSV en IRIS puedes hacer esto:
USER>do ##class(community.csvgen).Generate("/usr/data/titanic.csv",,"Data.Titanic")
Class name: Data.Titanic
Header: PassengerId INTEGER,Survived INTEGER,Pclass INTEGER,Name VARCHAR(250),Sex VARCHAR(250),Age INTEGER,SibSp INTEGER,Parch INTEGER,Ticket VARCHAR(250),Fare MONEY,Cabin VARCHAR(250),Embarked VARCHAR(250)
Records imported: 891
USER>
InterSystems IRIS ofrece la posibilidad de crear interfaces REST con el enfoque spec-first, esto es, partiendo de las especificaciones de la API.
Puedes echarle un vistazo a este artículo para más información al respecto : https://es.community.intersystems.com/post/cómo-desarrollar-una-api-rest-con-un-enfoque-spec-first.
Algo muy práctico que tiene este enfoque y la propia OpenAPI, es la definición de los objetos que se van a intercambiar.
El comando do ^%REST crea las rutas y los métodos asociados, pero sin embargo no crea las definiciones de los objetos.
Hace un tiempo se publicó el paquete AppS.REST. AppS.REST es un framework para exponer fácilmente clases persistentes de IRIS como recursos REST. Las clases que tienen habilitado AppS.REST soportan operaciones CRUD con poco esfuerzo del desarrollador, acortando la brecha entre los datos persistentes en IRIS y los consumidores de datos, como una aplicación front-end de Angular.
¡Pero las clases de IRIS son mucho más que una simple definición para cargar y guardar registros individuales! Este artículo tiene como objetivo destacar algunas maneras de aprovechar el poder de IRIS en tus aplicaciones REST. Usando la aplicación de ejemplo Phone.Contact, veremos el soporte de consultas incluido en AppS.REST, el uso de consultas de clase y finalmente los métodos ObjectScript.
Existe una forma muy sencilla de añadir los certificados de una Autoridad Certificadora a las configuraciones de TLS / SSL en InterSystems IRIS en Windows y Mac.
Puedes pedirle a IRIS que utilice el almacén de certificados de tu sistema operativo indicando %OSCertificateStore en el campo para "File containing Trusted Certificate Authority X.509 certificate(s)".
Aquí tenemos un ejemplo de cómo hacerlo:
En este artículo, ejecutaremos un clúster InterSystems IRIS usando Docker y archivos CPF combinados - una nueva característica que permite configurar servidores con facilidad.
En UNIX® y Linux, puedes modificar el archivo predeterminado iris.cpf utilizando un archivo CPF combinado declarativo. Un archivo combinado es un CPF parcial en el que se establecen los valores deseados que queramos que tenga una instancia al iniciar. La operación de combinación en CPF sólo funciona una vez para cada instancia.
Nuestra arquitectura de clúster es muy sencilla, consistirá en un Nodo 1 (nodo maestro) y dos Nodos de datos (echa un vistazo a todas las funciones disponibles). Desafortunadamente, docker-compose no puede desplegar en diferentes servidores (aunque puede desplegar a hosts remotos), por lo que esto es útil para el desarrollo local de modelos de datos que utilicen sharding, pruebas, etc. Para el despliegue en producción de un cluster de estar características, debes utilizar ICM o IKO.
Hola Comunidad! Aprovechando la publicación de la nueva versión IRIS 2021.1 y también de IAM 2.3 os paso los ejercicios de un taller (workshop) sobre desarrollo de APIs REST y gestión de las mismas utilizando InterSystems API Manager.
Contiene ejercicios paso a paso para:
Lo tenéis todo en la aplicación de Open Exchange vinculada.
¿Os gustaría poder acceder al Terminal Web directamente desde vuestro VSCode?
.png)
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.
Otro artículo sobre "Trucos y consejos de VSCode" -
.png)
¿Quieres ver esta opción en VSCode?
¡Hola Comunidad!
¿Necesitas conectar tu VSCode a un servidor de InterSystems? Le echamos un vistazo hoy a un gran truco que nos pasa Tani Frankel
¿Has oído hablar de esta opción?
.png)
En este artículo, me gustaría hablar sobre el enfoque spec-first para el desarrollo de una API REST.
Mientras que el desarrollo tradicional code-first de una API REST es así:
Spec-first sigue los mismos pasos, pero a la inversa. Comenzamos con una especificación, — que también actúa como documentación — , generamos el código base de la aplicación REST a partir de ella, y finalmente escribimos la lógica de negocio concreta que nos haga falta.
Esto ofrece varias ventajas:
¡Hola desarrolladores!
Hoy publico este breve artículo para todos aquellos que quieran añadirse una placa muy chula (shield) de Open Exchange como esta:
En tu repositorio de GitHub puedes incluirla añadiendo una simple línea:
[](https://openexchange.intersystems.com/package/csvgen)
Recuerda escribir en la URL la ruta a tu página en Open Exchange.
Gracias a los participantes del concurso por esta placa tan chula :D
¿Qué otros shields o placas útiles conoces? ¡Compártelos en los comentarios!
En Studio, podías abrir una clase directamente usando su nombre, sin tener que recorrer completamente el árbol de paquetes con un montón de clics hasta llegar a la clase deseada.
Con Ctrl + O o (File -> Open) podías escribir el nombre de la clase de forma sencilla, por ejemplo:
.png)
Pulsabas Enter y voilà!, la clase se abría.
¿Cómo se logra esto en VSCode?
Si trabajas utilizando el Portal de Gestión con varias instancias de IRIS, es posible que te resulte útil establecer el Modo del Sistema de esas instancias, de forma que tengas un recordatorio visual acerca del tipo de instancia con la que estás trabajando.
Por ejemplo:
or:
or:
or:
Esta configuración se establece aquí:
Y la funcionalidad se menciona aquí en la documentación.
Internamente esta configuración se almacena en la global ^%SYS("SystemMode") y tiene como posibles valores: LIVE, TEST, DEVELOPMENT, FAILOVER.
Puede obtenerse este valor también utilizando $SYSTEM.Version.SystemMode()
¡Hola desarrolladores!
Supón que tienes una clase persistente con datos y quieres tener una interfaz de usuario Angular sencilla, para ver los datos y llevar a cabo operaciones CRUD.
En este artículo describíamos cómo desarrollar una interfaz de usuario Angular para InterSystems IRIS utilizando RESTForms2.
A continuación vamos a explicar cómo conseguir una interfaz de usuario Angular sencilla que permita realizar operaciones CRUD y ver automáticamente los datos de tu clase de InterSystems IRIS en menos de 5 minutos.
¡Vamos!
Si resuelves problemas complejos en ObjectScript, probablemente tienes mucho código que funciona con los valores de %Status. Si has interactuado con clases persistentes desde una perspectiva de objetos (%Save, %OpenId, etc.), casi seguro que las ha visto.
Un %Status proporciona una envoltura alrededor de un mensaje de error localizable en las plataformas de InterSystems. Un estado OK ($$$OK) simplemente es igual a 1, mientras que un mal estado ($$$ERROR(errorcode,arguments...)) se representa como un 0 seguido de un espacio seguido de una lista $ListBuild con información estructurada sobre el error.
¡Hola! ¿Sabéis que se puede habilitar Ctrl+C y Ctrl+V en el terminal de IRIS para Windows?
Para hacerlo, hay que abrir el Terminal, seleccionar Edit > User Settings y habilitar Widows Edit accelerators.
Esta opción especifica si el Terminal habilita atajos de teclado habituales en Windows (Ctrl+C, Ctrl+V, Ctrl+Shift+V) además de los atajos típicos del Terminal básico (Ctrl+Insert, Shift+Insert).
Tras habilitar esa opción Ctrl+C y Ctrl+V deberían estar habilitados y funcionar correctamente.
Hola a todos! Comentamos hoy una entrada de Timothy Leavitt cuyo equipo (Application Services en InterSystems - encargado de desarrollar y mantener muchas de nuestras aplicaciones internas, y proporcionar herramientas y prácticas recomendadas a otras aplicaciones departamentales), durante el último año, se embarcó en un viaje hacia el desarrollo de interfaces de usuario basadas en Angular/REST, para las aplicaciones existentes construidas originalmente con CSP y/o Zen.
Hola a todos! Os traigo hoy un ejemplo de código que compartía Robert Cemper para mostrar por SQL los registros de error almacenados en ^ERRORS.
Hola! Comparto hoy un ejemplo de Yuri Marx sobre el uso de ReadMIMEPart. Si necesitáis obtener un fichero de una API o formulario multipart echadle un ojo a este ejemplo:
Class dc.Test.TestService Extends Ens.BusinessService
{
Parameter ADAPTER = "EnsLib.HTTP.InboundAdapter";
Method OnProcessInput(pInput As %GlobalBinaryStream, pOutput As %RegisteredObject) As %Status
{
Set file=##class(%Stream.FileBinary).%New()
Set file.Filename="/tmp/automl11.png"
Set reader = ##class(%Net.MIMEReader).%New()
//Set message = ##class(%Net.MIMEPart).%New()
Do reader.OpenStream(pInput)
Set tsc2 = reader.ReadMIMEMessage(.message)
Do message.ClearHeaders()
Do file.CopyFromAndSave(message.Body)
Set tSC=$$$OK
Set pOutput = "success"
Quit tSC
}
}
Una cuestión muy común es cuál es la configuración ideal para el servidor web Apache HTTPD cuando se utiliza con HealthShare. El propósito de este artículo es describir la configuración inicial recomendada del servidor web para cualquier producto HealthShare.
Como punto de partida, se recomienda la versión 2.4.x (64-bit) de Apache HTTPD. Existen versiones anteriores como la 2.2.x, pero no se recomienda esta versión por rendimiento y escalabilidad de HealthShare.
Si os habéis pasado de Studio a VSCode recientemente tal vez os hayáis dado cuenta de que en el Explorador faltan algunos elementos.
Por ejemplo, cuando se crea una API REST a partir de sus especificaciones, se generan 3 clases:
Como la clase es una clase generada, para mostrarla tendremos que activar la opción correspondiente haciendo click en en el Explorador:
.png)
En ese mismo lugar también encontraremos una opción para mostrar los elementos de sistema.
Hola a todos! Os comparto hoy un artículo sobre la utilización del procesamiento de lenguaje natural y su combinación con FHIR donde se muestra un chatbot que interactúa con FHIR desarrollado por Renato Banzai.
PLN significa Procesamiento del Lenguaje Natural (NLP en inglés) y es un campo de la Inteligencia Artificial muy complejo que utiliza técnicas para, en pocas palabras, “entender de qué se está hablando”.
Hola de nuevo a todos!
Cuando hacemos una instalación por defecto de VS Code, nos podemos encontrar que al crear un nuevo archivo, el lenguaje que tiene cargado por defecto es "Plain Text":
.png)
Debemos hacer click ahí para cambiar el lenguaje cargado para el archivo.
Por suerte, hay una configuración del VS Code que podemos utilizar para ajustar este comportamiento, se llama files.defaultLanguage.
Aquí podemos indicar el ID del lenguaje que queramos o incluso podemos configurarlo para que utilice el mismo lenguaje que tenemos cargado en el contexto en el que estamos trabajando actualmente:
"files.defaultLanguage": "${activeEditorLanguage}"
Hola a todos,
Compartimos hoy un truco que quizá le resulte útil a aquellos que tienen que trabajar con JavaScript embebido.
Si tienes que trabajar con CSP o Zen probablemente más de una vez has necesitado utilizar JavaScript embebido. Supón que tienes que programar algunos bucles, que utilizan los caracteres <` o `> en alguna expresión, por ejemplo:
&js<
var test = document.getElementById('seTest');
for (var i = 0; i < test.options.length; i++) {
// hacer algo con test.options[i]...
}
>
Hola a todos!
Comparto una pequeña utilidad (servicio REST) para descargar mensajes de una producción de interoperabilidad como ficheros.
Sólo necesitas:
/downloadmsg) que tenga configurado DispatchClass=Util.DownloadMsg.///
/// Util to download messages given a message header id
///
/// Setup:
/// 1. Create a webapplication (e.g. /downloadmsg) and set DispatchClass=Util.DownloadMsg
/// 2. Go to http://localhost:52773/downloadmsg/ns/user/msgid/19 to download the message reference by header 19
Class Util.DownloadMsg Extends %CSP.REST
{
XData UrlMap [ XMLNamespace = "http://www.intersystems.com/urlmap" ]
{
<Routes>
<Route Url="/ns/:ns/msgid/:msgId" Method="GET" Call="DownloadMessage"/>
</Routes>
}
/// Download a message given a Ens.MessageHeader id
ClassMethod DownloadMessage(ns As %String, msgId As %String = "") As %Status
{
set ret = $$$OK
set currentNs = $namespace
try {
set $namespace = ns
$$$ThrowOnError(..ExportMsgToStream(msgId, .stream, .filename))
// set headers to download stream as filename
do %response.SetHeader("Content-Type", "application/octet-stream")
do %response.SetHeader("Content-Disposition", "attachment; filename="""_filename_"""")
do %response.SetHeader("Content-Length", stream.Size)
do stream.Rewind()
do stream.OutputToDevice()
} catch ex {
set ret = ex.AsStatus()
}
// restore namespace
set $namespace = currentNs
quit ret
}
/// Export a message to stream given a Ens.MessageHeader id
ClassMethod ExportMsgToStream(msgId As %String, Output stream As %Stream.Object, Output filename As %String) As %Status
{
set ret = $$$OK
try {
// stream
set stream = ##class(%Stream.GlobalCharacter).%New()
set filename = ""
// message header
set headerObj = ##class(Ens.MessageHeader).%OpenId(msgId,,.sc)
$$$ThrowOnError(sc)
// message body
set obj = $classmethod(headerObj.MessageBodyClassName, "%OpenId", headerObj.MessageBodyId)
set classname = $classname(obj)
// output to stream
if classname="EnsLib.HL7.Message" {
set sc = $method(obj, "OutputToLibraryStream", .stream)
$$$ThrowOnError(sc)
set filename = msgId_".hl7"
}
else {
set writer = ##class(%XML.Writer).%New()
set writer.Indent=1
set writer.NoXMLDeclaration=1
$$$ThrowOnError(writer.OutputToStream(.stream))
$$$ThrowOnError(writer.RootObject(obj))
set filename = msgId_".xml"
}
} catch ex {
set ret = ex.AsStatus()
}
quit ret
}
}