Cómo configurar el servidor FHIR de InterSystems con un solo comando

¡Hola desarrolladores!

Se acaba de actualizar la plantilla para desarrollo FHIR de forma que ahora publica el paquete IPM fhir-server que hace que la configuración del servidor FHIR de InterSystems sea una sencilla tarea manual, automática o programática vía un solo comando.

Os explico más abajo cómo podéis utilizarlo.

TLDR

USER>zpm "install fhir-server"

Todos los detalles aquí:

Configurar el servidor FHIR de InterSystems sin IPM 

Por supuesto puedes configurar el servidor FHIR de InterSystems sin usar el gestor de paquetes IPM. Estas son las opciones:

1. Configurar un servidor FHIR en la nube con una prueba durante varios días siguiendo estas instrucciones. Esto será un servidor FHIR de InterSystems FHIR en la nube de AWS.

2. Configurar un servidor FHIR de InterSystems ejecutando InterSystems IRIS for Health siguiendo estos pasos.

3. Y también se puedes clonar el repositorio de esta plantilla y ejecutar en un directorio clonado:

$ docker-compose up -d

para tener el servidor FHIR de InterSystems en marcha en tu equipo.

Lo que propongo en este artículo es el punto 2, con el que se pueden saltar todos los pasos manuales y tener el servidor FHIR funcionando en tu equipo tanto en docker como en una instalación nativa.

Configurar el servidor FHIR con IPM 

DESCARGO DE RESPONSABILIDAD - Los pasos descritos más abajo se refieren a una instancia de IRIS for Health recién instalada o para usarse con imágenes docker. El paquete crea un nuevo namespace y una nueva aplicación web, lo que quizá pueda dañar la configuración que se haya establecido antes.

IPM significa InterSystems Package manager (antes se llamaba ZPM). Aseguraos de tener instalado el IPM-client. Podéis comprobarlo si ejecutáis el comando zpm en el terminal de IRIS y veis lo siguiente:

IRISAPP>zpm     

=============================================================================
|| Welcome to the Package Manager Shell (ZPM).                             ||
|| Enter q/quit to exit the shell. Enter ?/help to view available commands ||
=============================================================================
zpm:IRISAPP>

Necesitarás IRIS for Health versión 2022.x o posteriores.  

¿Cómo ejecutar IRIS for Health en tu equipo?

Ejecutar en una instalación local

En la página de evaluación de InterSystems descargad la última versión de IRIS for Health adecuada para vuestra plataforma (Windows, Mac, Linux) e instaladla. Instalad IPM. Aquí tenéis un solo comando para hacer la instalación de IPM:

USER>zn "%SYS" d ##class(Security.SSLConfigs).Create("z") s r=##class(%Net.HttpRequest).%New(),r.Server="pm.community.intersystems.com",r.SSLConfiguration="z" d r.Get("/packages/zpm/latest/installer"),$system.OBJ.LoadStream(r.HttpResponse.Data,"c")

Ejecutar una versión docker

Llamad al terminal para lanzarlo:

docker run --rm --name iris4h -d --publish 9091:1972 --publish 9092:52773 intersystemsdc/irishealth-community

Después, iniciad el terminal:

docker exec -it iris4h iris session IRIS

Instalar el servidor FHIR

Una vez se tiene IRIS ejecutándose, en el terminal de IRIS escribe lo siguiente:

USER>zpm "install fhir-server"

Esto instalará el servidor FHIR en el namespace FHIRSERVER con parámetros:

Set appKey = "/fhir/r4"
Set strategyClass = "HS.FHIRServer.Storage.Json.InteractionsStrategy"
set metadataPackages = $lb("hl7.fhir.r4.core@4.0.1")

Set metadataConfigKey = "HL7v40"

La API Rest de FHIR estará disponible en http://yourserver/fhir/r4.

También añadirá algunos datos generados.

¿Cómo saber si el servidor está funcionando?

Para probarlo en la versión servidor:

http://localhost:52773/fhir/r4/metadata

Para probarlo en la versión docker:

http://localhost:9092/fhir/r4/metadata

Este paquete IPM también instala una interfaz sencilla que está disponible en: http://yourserver/fhirUI/FHIRAppDemo.html

Y se verá algo parecido a esto (introduciendo patient id=1):

¿Cómo funciona?

Puede comprobar lo que se ha instalado con este módulo IPM echando un vistazo al module.xml. Se puede ver que importa el código, instala la aplicación UI sencilla y ejecuta el script post-instalación, que llama al siguiente método. El script en el método realiza la configuración del servidor FHIR.

Instalar el servidor FHIR programáticamente

También se puede instalar programáticamente a través del siguiente comando:

set sc=$zpm("install fhir-server")

¡Feliz desarrollo FHIR!