Documento de Configuración - Integración RIS

MANUAL DE CONFIGURACIÓN
INTEGRACIÓN - RIS ESTÁNDAR

Manual de Configuración – Integración RIS
Integrador de Aplicaciones Externas
Versión Aplicativo: 3.1
Este documento fue preparado por:

Análisis Funcional
Carvajal Servicios S.A.S.
Medellín, Colombia.
Este documento está protegido bajo las leyes de derechos de autor de Colombia y otros países
como una obra inédita. Este documento contiene información interna de propiedad de Carvajal
Servicios y/o de sus socios en alianza técnica, que no podrá ser divulgada, compartida, transferida,
duplicada, usada o revelada en su totalidad o en parte, para cualquier propósito diferente que no
sea para evaluar Carvajal Servicios. Queda prohibido cualquier uso o divulgación total o parcial de
esta información sin el permiso expreso y por escrito de Carvajal Servicios. ©2019 Carvajal
Servicios. Todos los derechos reservados.
This document is protected under the copyright laws of Colombia and other countries as an
unpublished work. This document contains internal information that belongs to Carvajal Services
and/or its technical alliance partners, which shall not be disclosed outside or duplicated, used or
disclosed in whole or in part for any purpose other than to evaluate Carvajal Services. Any use or
disclosure in whole or in part of this information without the express written permission of Carvajal
Services is prohibited. ©2019 Carvajal Services. All rights reserved.
La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

Se prohíbe su reproducción total o parcial sin autorización.
Página 2
Historial de Cambios
Versión Versión
Document Aplicativo Fecha Responsable Descripción
o
1.0 3.1 25/11/2019 Jairo Andres Claro Elaboración documento.
Ajuste campo constante
SEDEQU.
Adición permiso de observación.
Plantilla única de integración

RIS.
1.1 3.1 10/11/2020 Jairo Andres Claro Consultar Imagen del RIS
mediante parametrización.
Adicionar argumentos flujo de

entrada.
Adicionar configuración de la
fecha de agendamiento.
Ajuste de variables de
1.2 3.1 07/12/2020 Jairo Andres Claro
programa.
Revisión y Aprobación

Página 3
TABLA DE CONTENIDO
1. CONFIGURACIÓN GENERALES.............................................................................................. 5
1.1 PARAMETRIZACIÓN............................................................................................................................5
1.2 MAESTRO DE EVENTOS – IKEVE...........................................................................................................11
2. CONFIGURACIÓN DE EVENTOS DE SALIDA.......................................................................13
2.1 MAESTRO DE ACTIVIDADES – ITORD (ÓRDENES MEDÍCAS).............................................................13
2.2 MAESTRO DE GRUPO DE ESTADOS DE ÓRDENES.............................................................................14
2.3 MAESTRO DE EXÁMENES PARA INTEGRACIÓN DE LABORATORIO - FAEXAEXT (FACTURACIÓN).....15
2.4 MAESTRO EVENTOS DE INTEGRACIÓN- INEVECAM.........................................................................15
2.5 CONFIGURACIÓN DE LISTENERS (IKEVEENT_RIS.WFL, IKEVEORD_RIS.WFL).......................................17
2.6 CONFIGURACIÓN DE WORKFLOW (EVENTOSRIS_SCS.XAML)...............................................................18
3. CONFIGURACIÓN DE EVENTOS DE ENTRADA...................................................................19
3.1 MAESTRO DE ESTADOS EQUIVALENTES - IKESTEQU........................................................................19
3.2 MAESTRO DE IDENTIFICACIÓN DE USUARIOS (SIIDE).......................................................................20
3.3 CONFIGURACIÓN DE LISTENERS (RECIBIR MENSAJERIA RIS.WFL)...........................................................21
3.4 CONFIGURACIÓN DE WORKFLOW (EVENTOSRIS_SCS.XAML)...............................................................22

Página 4
OBJETIVO GENERAL
Este documento describe el proceso de configuración de los módulos administrativos y clínicos de

Servinte Clinical Suite para la generación de información hacia bus integrador de aplicaciones
externas (ITLink) previamente convertida en mensajería HL7 v2.5 que viaja hacia el sistema
externo, y también viaja desde el sistema externo para ser procesada en nuestro sistema HIS,
abarcando todo el proceso de integración.
1. CONFIGURACIÓN GENERALES
1.1 PARAMETRIZACIÓN
Para un correcto funcionamiento de la integración de Servinte Clinical Suite Enterprise con el

proveedor del sistema externo, es necesario tener configurado los siguientes puntos:
Maestro /
Tipo parámetro Aplicación Acción
Módulo -- -- Tener ejecutado en la base de datos el módulo
correspondiente a cada integración:
- INTEGRAHL7 (Administrador de pacientes)
- INTEGRARIS (Ayudas Diagnosticas - Facturación).
-- -- ITLINK Deben existir las siguientes tablas en la base de

datos:
- (Código) – (Descripción)
- ikeveent-Eventos de entrada
- ikeveord-Eventos de entradas
- ikevepro-Eventos procesados
- ikeve- Eventos HL7 para ITLink
- ikeveapx- Eventos por aplicación externa
- ikestequ-Estados equivalentes.
Plano -- -- Verificar que en la tabla de configuración de tipos de

plantillas (HPTIPPLA), se tenga un registro con los
siguientes códigos:
(Código) – (Descripción)
- RESULT- Resultados
- INTRES- Interpretación
Plano -- -- Verificar que se tenga en la tabla (SISMEN), los

registros relacionados con los maestros mencionados
en este documento, necesarios para una correcta
funcionalidad de las integraciones RIS.
Maestro Maestro de LMAEST En este maestro deben existir el siguiente registro:

Tipo de (Código) – (Descripción)
episodio - AYRA - Ayudas Diagnósticas en RIS.

Página 5
Maestro /
Maestro Campos SISTEG Debe existir las siguientes constantes (SICTE):
constantes (Código) – (Descripción)
- TSELIS-Tipo de servicios que se integran.
- SEDEQU- Sede Equivalente.
NOTA:
SEDEQU: Definir los valores que se envían en el

segmento ORC posición 2.2 y en el segmento OBR
posición 4.3, de acuerdo a la sede donde está
ubicado el paciente.
Los campos de los detalles (SICTEDET) se deben

llenar así:
- ctedetcod= SEDEQU
- ctedetpar= Est. administrativa del paciente.
- ctedetdes= Código de la estructura en
Proveedor.
Maestro Constantes LMAEST Debe existir las siguientes constantes clínicas

Clínicas (HICTE):
- TIPPAC- Tipo de Paciente
NOTA:
TIPPAC: Definir los valores que se envían en el

segmento PV1 posición 18, de acuerdo a lo definido
en el segmento PV1 posición 2 (Tipo paciente
estándar HL7).
Los campos de los detalles (HICTEDET) se deben

llenar así:
- ctedetcod= TIPPAC
- ctedetpar= Tipo de paciente (PV1(2))
- ctedetdes= Tipo de paciente (PV1(18))
Maestro Aplicaciones SISTEG Debe existir un matricula el siver de la aplicación de

VS Versión ITLInk en este maestro.
Vigente
Maestro Maestro de ORDENG En este maestro se configura todas las integraciones
actividades – que se pueden generar a partir de generar la orden
Opción médica. La indicación de como parametrizar este
Información maestro se encuentra más adelante en el
de integración documento.
Maestro Exámenes de HMAEST En este maestro se configura los exámenes o

Integración procedimientos que deben generar una integración a

Página 6
Maestro /
Laboratorio partir de la generación de un cargo asociado.
externo
Maestro Plantillas LMAEST Verificar que se tenga instalada las siguientes
dinámicas plantillas en este maestro:
- chpresris-Resultados RIS
Maestro Permisos a SISTEG Definir los permisos al grupo de usuario al que

grupos de pertenece el usuario que ejecuta las acciones
usuario disponibles en cada una de las plantillas
mencionadas en el ítem anterior:
1:Guardar
2: Firmar
3: Consultar
5: Imprimir
6: Interpretar
7: Consultar trazabilidad
8: Consultar imágenes
9: Observaciones
El número representa la posición del permiso.
Maestro Estados por LMAEST Verificar que el grupo de usuarios, del usuario que
perfil realiza el cambio de estado de la orden, según el
momento de la integración, tenga permisos para ese
estado, tipo de orden y que esté activo.
Maestro Variables de LMAEST Consultar Imágenes asociadas a un Resultado:

configuración
Utilizar la variable de configuración (HCCON):
URLCONSULTIMAG
Valor por defecto:

http://agfahc://impax-client-epr/?domain=Agfa
Healthcare/{m:ide}&{m:nroacc}&usu=usuario&pass=c
ontraseña
- (m) corresponde al origen de datos donde el

sistema consulta la información (m=mensaje ORU);
el cual almacena los parámetros requeridos en un
objeto XLM en la tabla HHREGDOC.regdocurl.
- (ide- nroacc) corresponde al nombre del parámetro.
- (usuario) debe remplazarse por el usuario genérico
del IMPAX

Página 7
Maestro /
- (contraseña) debe remplazarse por la contraseña
perteneciente al usuario genérico del IMPAX.
Maestro Programas SISTEG Definir la configuración de las siguientes variables de
programa según su funcionalidad del valor
configurado:
PARÁMETRO:
CI (Evento Cambio de Identificación por opción
Modificar o Modificar Identificación) para el programa
“cgppac” (Administrador de Pacientes).
Funcionalidad:
Este parámetro es para identificar en los eventos que
se generan para los integradores, si el cambio de
identificación del paciente se genera con el evento de
modificar datos demográficos o con evento de
cambio de identificación.
Posibles valores:
 I (Genera mensaje HL7 ADT A08 de cambio
de identificación y ADT A40 de Actualización
de datos demográficos del paciente.)
 M (No genera mensaje HL7 ADT A08, solo
genera ADT A40, donde incluye la
modificación de la identificación y
actualización de datos demográficos del
paciente.)
Valor por defecto CI = M
PARÁMETRO:
IL (Generar mensaje HL7 al sistema externo
detallado o agrupado cuando se graba un cargo)
para el programa “caymov” si es desde la aplicación
de AYUDAS o el programa “cfacar” si es desde la
aplicación de FACTURACIÓN.
Funcionalidad:
Este parámetro es para definir si se genera un
mensaje HL7 agrupado con todas las líneas del
cargo, o si genera un mensaje HL7 por cada línea del
cargo, ya sea desde los cargos generados mediante
la aplicación de AYUDAS y/o FACTURACIÓN.
Posibles valores:

Página 8
Maestro /
 A (Genera un mensaje HL7 agrupado por el
cargo, es decir si el cargo tiene 10 líneas se
genera un mensaje HL7 con 10 líneas hacia
el proveedor).
 D (Genera un mensaje HL7 por cada línea
del cargo, es decir si el cargo tiene 10 líneas
se generan 10 mensajes HL7 hacia el
proveedor).
Valor por defecto IL = A
PARÁMETRO:
LI (Generar mensaje HL7 al sistema externo
detallado o agrupado cuando se anula un cargo) para
el programa “caymov”.
Funcionalidad:
Este parámetro es para definir si se genera un
mensaje HL7 agrupado con todas las líneas del
cargo, o si genera un mensaje HL7 por cada línea del
cargo, cuando el usuario anula el cargo.
Posibles valores:
 A (Genera un mensaje HL7 de anulación
agrupado por el cargo, es decir si el cargo
tiene 10 líneas se generan un mensaje con
10 líneas hacia el proveedor).
 D (Genera un mensaje HL7 de anulación por
cada línea del cargo, es decir si el cargo
tiene 10 líneas se generan 10 mensajes
hacia el proveedor).
Valor por defecto LI = A
PARÁMETRO:
SU (Enviar servicio o ubicación del paciente al
sistema externo) para el programa “caymov” si es
desde la aplicación de AYUDAS o el programa
“cfacar” si es desde la aplicación de FACTURACIÓN.
Funcionalidad:
Este parámetro es para identificar que dato se envía
en el mensaje HL7 en el segmento PV1 posición 3
cuando se genera un cargo desde la aplicación de
Página 9
Maestro /
AYUDAS y/o FACTURACIÓN.
Posibles valores:
 U (Genera mensaje HL7 con el dato del
código de la ubicación del paciente).
 N (Genera mensaje HL7 con el dato del
Nombre de la ubicación del paciente).
 S (Genera mensaje HL7 con el dato del
servicio y la sede del paciente).
Valor por defecto LI = S
PARÁMETRO:
AX (Enviar número de episodio o documento del
cargo al sistema externo) para el programa “caymov”
si es desde la aplicación de AYUDAS o el programa
“cfacar” si es desde la aplicación de FACTURACIÓN.
Funcionalidad:
Este parámetro es para identificar que dato se envía
en el mensaje HL7 en el segmento PV1 posición 19
cuando se genera un cargo desde la aplicación de
AYUDAS y/o FACTURACIÓN.
Posibles valores:
 N (Genera mensaje HL7 con el dato del
documento del cargo).
 S (Genera mensaje HL7 con el dato del
episodio).
Valor por defecto AX = N
PARÁMETRO:
LR (Generar mensaje HL7 listo por refacturar) para el
programa “caymov” si es desde la aplicación de
AYUDAS o el programa “cfacar” si es desde la
aplicación de FACTURACIÓN.
Funcionalidad:
Este parámetro permite generar mensajes HL7 para
enviados al sistema externo cuando se generan
cargos refacturados desde la aplicación de AYUDAS
y/o FACTURACIÓN.

Página 10
Maestro /
Posibles valores:
 N (No genera mensaje HL7).
 S (Genera mensaje HL7).
Valor por defecto LR = S

-- -- ITLINK La aplicación de ITlink debe estar instalada en el
servidor para mayor información consultar el manual
de instalación.
NOTA: Para realizar el montaje de los archivos de

ITLInk (Listeners, Workflows, References, etc…) los
servicios de ITlink deben estar detenidos, una vez
realizado este montaje de estos, subir nuevamente
los servicios y verificar el correcto funcionamiento.
Listeners -- ITLINK El paquete recibido debe contener los siguientes

Listeners o servicios de escuchas correspondiente a
la integración:
- IKEVEENT_RIS.wfl
Procesa registros de Administrador de pacientes
- IKEVEORD_RIS.wfl
Procesa registros generados desde facturación u
órdenes médicas.
- Recibir Mensajeria RIS.wfl

Procesa eventos ORU y/ORM que llegan a Historia
Integrada. Incluye cambio de estado de la orden.
Los listeners deben ser ubicados en la siguiente ruta

en el servidor donde se encuentra a la aplicación de
ITLink:
C:\Servinte\Servinte Services Manager\ITLink\

Listeners
Workflow -- ITLINK El paquete recibido debe contener los siguientes

s archivos o flujos de trabajo correspondiente a la
integración:
- EventosSCS_RIS.xaml
Flujo de trabajo que envía mensajería HL7 mediante
socket desde el SCSE al sistema externo.
- EventosRIS_SCS.xaml

Página 11
Maestro /
Flujo de trabajo que recibe mensaje HL7 mediante
comunicación por socket del sistema externo hacia
SCSE, clasificando si es una publicación de
resultados o un cambio de estado de la orden.
-ProccesingOBXMonitoring_RIS.xaml
Flujo de trabajo encargado de extraer los datos
básicos del mensaje HL7 (ORU) para la grabación
del resultado en la historia clínica integrada.
- ProcesarPlantillaDinamica_RIS.xaml
Flujo de trabajo encargado de invocar el proceso de
grabación de la plantilla dinámica en Historia clínica.
Los archivos deben ser ubicados en la siguiente ruta

ITLink:
C:\Servinte\Servinte Services Manager\ITLink\

Workflows
Referenc -- HCECLI El paquete recibido debe contener las siguientes

es librerías de historia clínica, utilizadas desde el ITlink
para la grabación del resultado como una nota
clínica:
- Servinte.Clinic.Controls.dll
- Servinte.Clinic.Core.dll
- Servinte.Clinic.Core.Reads.dll
- Servinte.Clinic.Core.Writes.dll
- Servinte.Clinic.History.Reads.dll
- Servinte.Clinic.History.Writes.dll
- Servinte.Clinic.Interactions.dll
- Servinte.Clinic.Interactions.Reads.dll
- Servinte.Clinic.Interactions.UI.dll
- Servinte.Clinic.Ordeng.Messages.dll
- Servinte.Clinic.Orders.Messages.dll
- Servinte.Clinic.Orders.Reads.dll
- Servinte.Clinic.Orders.Reports.UI.dll
- Servinte.Clinic.Orders.UI.dll
- Servinte.Clinic.Orders.Writes.dll
- Servinte.Clinic.UI.Core.dll
- Servinte.ClinicalSuite.Framework.dll
- Servinte.DynamicUI.AdministrativeEditors.dll

Página 12
Maestro /
- Servinte.DynamicUI.ClinicEditors.dll
- Servinte.DynamicUI.Configuration.dll
- Servinte.DynamicUI.Editors.dll
- Servinte.DynamicUI.Editors.XmlSerializers.dll
- Servinte.DynamicUI.Template.dll
- Servinte.Multimedia.Controls.dll
- Servinte.Multimedia.PDFViewer.dll
- Servinte.MultimediaComponent.Messages.dll
- Servinte.MultimediaComponent.Reads.dll
- Servinte.MultimediaComponent.Writes.dll
- Servinte.Operations.ClinicCoreMessages.dll
- Servinte.Operations.ClinicCoreReads.dll
- Servinte.Operations.ClinicCoreWrites.dll
- Servinte.Operations.Common.dll
- Servinte.Operations.CommonUI.dll
- Servinte.Operations.ExplanatoryNoteMessages.dll
- Servinte.Operations.ExplanatoryNoteWrites.dll
- Servinte.Operations.LocksMessages.dll
- Servinte.Operations.Paintv2.Controls.dll
- Servinte.Operations.Paintv2.Messages.dll
- Servinte.Operations.SecurityMessages.dll
- Servinte.Presentation.ClinicControls.dll
- Servinte.Presentation.Controls.dll
- Servinte.Presentation.Core.dll
- Servinte.Schemas.dll
- Servinte.Schemas.XmlSerializers.dll
- System.Windows.Interactivity.dll
- Servinte.Operations.Security.dll
- Newtonsoft.Json.dll
Los archivos deben ser ubicados en la siguiente ruta

ITLink:
C:\Servinte\Servinte Services Manager\Tilín\

References
NOTA: En esta misma ruta se debe incluir el

archivo .config de la aplicación de HCECLI del
servidor de aplicaciones.

Página 13
1.2 MAESTRO DE EVENTOS – IKEVE
En este maestro se definen todos los eventos de salida (SCSE – RIS) y entrada (RIS – SCSE) que
se van a manejar en la integración y sus características, estos eventos son definidos por el cliente
durante la definición del proceso de la integración.
Descripción de los campos:

Código Nombre E/S Apl. Apl. Instal. Format Format Cliente Ident.
Origen Destino Destino o o Ppal
Origen Destino
Evecod Evenom Eveind Eveaor Eveade Eveide Evefor Evefde Evecli Eveidp
A01 Ingreso de S INFGEN RIS RIS XML HL725 SERVIN H
pacientes
A02 Traslado de S HCEPAC RIS RIS XML HL725 SERVIN H
pacientes
A03 Egreso de S HCEPAC RIS RIS XML HL725 SERVIN H
pacientes
A04 Creación de S GESPAC RIS RIS XML HL725 SERVIN H
pacientes
A08 Actualización S GESPAC RIS RIS XML HL725 SERVIN H
de datos
demográficos
A11 Anulación de S INFGEN RIS RIS XML HL725 SERVIN H
ingreso
A13 Anulación de S HCEPAC RIS RIS XML HL725 SERVIN H
Egreso de
pacientes
(Reingreso)
A34 Unificación de S GESPAC RIS RIS XML HL725 SERVIN H
Historias
A40 Cambio de S GESPAC RIS RIS XML HL725 SERVIN H
Identificación

Página 14
O01 Orden Nueva S ORDENG RIS RIS XML HL725 SERVIN H

o Cancelada
O01 Orden Nueva S FACTUG RIS RIS XML HL725 SERVIN H
o Cancelada
Todos los eventos se graban con indicador de Activo en S.
En el detalle de Aplicaciones externas de este maestro (ikeveapx), se configura si el dato ubicación

PV1 (3.1), se envía con:
- Código de Ubicación
- Nombre Ubicación
- Servicio-Sede
NOTAS:
En el maestro de eventos por Aplicación (IKEVEAPX)

Para los clientes que tienen integración RIS y LIS simultáneamente deben tener en cuenta lo
siguiente:
Para los eventos ADT deben existir dos registros en Maestro de Eventos (IKEVE), uno para LIS y
otro para RIS, ya que un mismo evento se envía para dos sistemas.
En el caso de los eventos ORM de Orden nueva, debe existir un único registro en el Maestro de
Eventos (IKEVE) con la aplicación destino ITLINK, porque una misma orden no va para RIS y LIS,
como sucede con los eventos ADT.
En la configuración del maestro de integraciones de órdenes (ITORD), se define para cada

actividad la aplicación externa (ordapx), para indicar si la actividad va para LIS o para RIS.
EVENTO MFN^M02 - Actualización de Médicos
Este evento es opcional, se utiliza para enviar información de los médicos al proveedor externo,
se ejecuta cuando se crea o modifica un registro en el Maestro de Usuarios de la aplicación
Sistema de Seguridad (SISTEG), donde el oficio clínico asociado al usuario sea 'MEDI', 'ANES' ó
'CIRU'. Adicional se debe configurar el evento en el maestro de eventos (IKEVE), donde el código
del evento (evecod) sea igual a ‘M02’ y tener creado los siguientes objetos de base de datos de
acuerdo al motor:
Informix:
 S_SCS_SIIDE_INTEGRADOR_ITLINK
 T_SCS_I_SIIDE_INTEGRADORITLINK
 T_SCS_D_SIIDE_INTEGRADORITLINK
 T_SCS_U_SIIDE_INTEGRADORITLINK
Oracle:
 SIIDE_HL7_MFN

Página 15
EVENTO ADT^A01 - Ingreso
2. CONFIGURACIÓN DE EVENTOS DE SALIDA
2.1 MAESTRO DE ACTIVIDADES – ITORD (ÓRDENES MÉDICAS)
A continuación, se definen los datos que se deben insertar en el Maestro de Actividades de

Órdenes, para pacientes hospitalizados.
Para cada actividad que se integre con el RIS se debe llenar la información de integración, así:
Los datos que se deben llenar en esta pantalla son:
Estado: estado en el cual se debe generar el mensaje ORM para la aplicación externa.
Aplicación Origen: se registra ORD.
Aplicación Destino: se registra ITLINK.
Tipo: corresponde al tipo de orden. Valores posibles: Internas, Externas o Ambas.
Ubicación: se registra ‘*’.
Aplicación Externa: se registra RIS.
Estructura administrativa: Se registra la estructura administrativa que se ejecuta la integración.
Adicionalmente, se debe definir el código externo asociado a la actividad, que se manda al RIS:

Página 16
2.2 MAESTRO DE GRUPO DE ESTADOS DE ÓRDENES
Para que el sistema de órdenes permita recibir cambios en el agendamiento desde el RIS para una
misma orden, se debe configurar que el estado Agendado se pueda repetir (Maneja Cierre = ‘S’).
2.3 MAESTRO DE EXÁMENES PARA INTEGRACIÓN DE LABORATORIO -

FAEXAEXT (FACTURACIÓN)
A continuación, se definen los datos que se deben insertar en el Maestro de Exámenes para
Integración con Laboratorio (FAEXAEXT), para pacientes ambulatorios.
Este maestro se encuentra ubicación en la aplicación de Maestros Administrativos (HMAEST).

Para cada examen que se integre con el RIS, se debe llenar la siguiente información:

Página 17
Los datos que se deben llenar en esta pantalla son:
Tipo: Indicador de Examen / Procedimiento.

Examen/Procedimiento: Examen o procedimiento que se integra con el RIS.
Código Externo: Código externo asociado al examen / procedimiento que se envía al RIS.
Nombre Externo: Nombre externo para el examen / procedimiento que se envía al RIS.
Integración Pacientes hospitalizados: Indica si se generan el evento ORM para cargos
generados desde facturación (Pacientes con ingreso por Admisiones).
Integración de Pacientes Ayudas Diagnósticas: Indica si se generan el evento ORM para
cargos generados desde Ayudas Diagnósticas (Pacientes con ingreso por Ayudas Diagnósticas).
Activo: Indica activo o no.
Detalle de Estructuras Administrativas: Define las Estructuras Administrativas para las que se
genera la integración.
2.4 MAESTRO EVENTOS DE INTEGRACIÓN- INEVECAM
En este maestro se definen los eventos de unificación de historias y cambio de identificación, los
cuales se utilizan en el programa Administrador de Pacientes.
El maestro se encuentra ubicado en el “Menú Maestros Integración Externa”.

Página 18
CAMPO LONG
EN TIPO MAX. OBL DESCRIPCION
PANTALLA
Programa Char 10 S Código de proceso (programa)
Administrador de pacientes.
Operación Num 6 S Número de la operación asociado al programa. Las

operaciones se obtienen del Maestro de operaciones por
programa de la aplicación sistema. Las operaciones que
se pueden generar para el administrador de pacientes
son:
 Modificar paciente
 Unificar paciente
 Cambiar identificación del paciente
Aplicación Char 10 S Se presenta ayuda con la constante clínica APLEXT,

externa seleccionar RIS.
Evento Char 6 S Código del evento para enviar a la aplicación externa.
Para el RIS se configura:

A08: Actualizar datos demográficos
A34: Unificar paciente
A40: Cambio de identificación
Activo char 1 S Activo con los valores de (Si/No)

Página 19
2.5 CONFIGURACIÓN DE LISTENERS (IKEVEENT_RIS.wfl, IKEVEORD_RIS.wfl)
Estos listener son de tipo base de datos, por lo tanto, se le debe configurar en cada uno la
conexión de base de datos, ambos listener están configurados para leer las tablas buzón o tabla de
eventos de entradas y una tabla de eventos procesados:
- ikeveent-Eventos generados por el Administrador de pacientes (Mensajes ADT).

- ikeveord-Eventos generados por Ordenes Medicas y/o Facturación (Mensaje ORM)
- ikevepro-Todos los registros que son procesados de las tablas buzón por la aplicación de
ITLink.
Para modificar el listener y agregar la conexión a base de datos, hacer doble clic sobre este, luego
se despliega la pantalla que se muestra a continuación. En ambos listener se debe seleccionar el
motor e ingresar los datos de conexión (seleccionar opción “Cadena de conexión”) de la de base
de datos donde se va a realizar el montaje de ITLink.
NOTA: Los listener por defecto ya tienen configurados las respectivas tablas de eventos y campos
(Ikeveent, Ikeveord e Ikevepro).
IKEVEENT_RIS.wfl
IKEVEORD_RIS.wfl

Página 20
2.6 CONFIGURACIÓN DE WORKFLOW (EventosRIS_SCS.xaml)
El flujo de trabajo EventosRIS_SCS.xaml es el encargo de procesar, convertir y enviar la

mensajería HL7 de salida de SCSE hacia el Proveedor (Software Externo). Al flujo se le deben
configurar por defecto los siguientes nombres de variables:
Variables
Nombre Valor Predeterminado (Concepto del Dato)
ipAddress Variable IP del Proveedor para mensajería.
portAdt Variable que contiene el puerto del Proveedor para mensajería ORM.
porOrm Variable que contiene el puerto del Proveedor para mensajería ADT.
portMFN Variable que contiene el puerto del Proveedor para mensajería MFN
(opcional).
Verificar si la información que tiene por defecto son las correctas, en caso contrario modificarlas,
haciendo doble Clic sobre el flujo el cual muestra la siguiente
pantalla:

Página 21
Para visualizar y editar el valor de las variables, seleccionar la secuencia “procesar mensaje” y
seleccionar la pestaña Variables en la parte inferior y en la columna valor predeterminado cambiar
los valores según corresponda, luego de actualizar la información se procede a guardar y cerrar en
la parte superior.
3. CONFIGURACIÓN DE EVENTOS DE ENTRADA
3.1 MAESTRO DE ESTADOS EQUIVALENTES - IKESTEQU
En este maestro se define la equivalencia entre los estados del proveedor y los estados de la orden
en SCSE. Esta tabla se utiliza para el cambio de estado de una orden por medio de un mensaje
HL7 ORM y/o ORU cuando se reciben desde proveedor

Página 22
uc CU000014561IK Administrar Maestro de Estados Equiv alentes
Descripción de los campos IKESTEQU:
ID Control Estado Estado Apl. Externa Estado Equivalente Observaciones

(ORC-1) (ORC-5) (ORC-25) SCS
Estequcon Estequest Estequeex Estequese Esqequobs
SC IP * TO (tomado)
RE CM * RE (realizado)
Consideraciones para cada campo:
- El campo “Control” corresponde al dato contenido en el segmento ORC (1).
- El campo “Estado” corresponde al dato contenido en el segmento ORC (5). Se configura

según los estados que maneja el proveedor.
- El campo “Estado Apl. Externa” para la integración de RIS corresponde al dato contenido
en el segmento ORC (25), si no envía este dato por defecto se queda con “*”.
- Los datos de la columna “Estado Equivalente SCS” dependen de los grupos de estados
definidos en la institución para las órdenes que se procesan desde sistema externo.
- El dato de “Observaciones” Se ingresa texto para las observaciones del cambio de estado.
NOTA:
Para guardar la fecha y hora de agendamiento de un estudio por parte del proveedor
(Mensaje ORM), se requiere que en las observaciones relacionadas
(IKESTEQU.Esqequobs) al estado equivalente se realice lo siguiente: configurar la palabra
[PlanDate] correspondiente al cambio de estado de agendamiento en el maestro de
estado de estados equivalentes, como se muestra a continuación.

Página 23
Al realizar la integración, el texto [PlanDate] es remplazado por la fecha del agendamiento

del mensaje ORM segmento OBR posición 7 de cambio de estado.
- En el campo de “Aplicación Externa” registrar LIS - RIS.
- El campo “Genera Nota” no aplica para esta integración, se debe dejar en N.
3.2 MAESTRO DE IDENTIFICACIÓN DE USUARIOS (SIIDE)
En este maestro se crean los usuarios que serán recibidos en los mensajes del RIS.
Para los usuarios que realizan cambio de estado de las órdenes médicas, se debe tener un grupo
de usuarios autorizado para cambios de estado en el detalle de estructuras administrativas.
En caso de que el RIS envíe usuarios genéricos, estos se deben crear por este maestro.
Los usuarios que firman los resultados en el RIS y se reciben en el mensaje ORU de resultados,
también se deben crear en este maestro.
3.3 CONFIGURACIÓN DE LISTENERS (Recibir Mensajeria RIS.wfl)

Página 24
Estos listener es de tipo escucha de socket, solo se debe configurar los campos “Dirección IP”
(Debe configurar el número de IP del servidor donde se encuentra instalado la aplicación de ITLink)
y el “Puerto” (Puerto definido en conjunto con el cliente para recibir mensajería) por el cual se van a
recibir los mensajes HL7 por parta del proveedor:
3.4 CONFIGURACIÓN DE WORKFLOW (EventosRIS_SCS.xaml)
Para este flujo se debe copiar el nombre de la variable Nombre de la conexión, con el valor que
tenga configurado en la conexión de base de datos principal de la aplicación de ITLInk:
Nombre conexión principal (SCSE).
Luego el nombre definido en la conexión de base de datos se debe copiar en el flujo de nombre
“EventosRIS_SCS.xaml”, para esto hacer clic sobre el flujo el cual muestra la siguiente pantalla y

Página 25
seleccionar la pestaña argumentos y en la columna valor predeterminado cambiar los valores solo
de los argumentos que aparecen a continuación:
Argumentos
Nombre Valor Predeterminado (Concepto del Dato)
StructAdmintrate Código de la estructura administrativa.
Client Código del cliente.
ServiceCode Código de servicio que exista en el Maestro de Servicios (INSER).
OrderService URL de cambio de estados que se encuentra en la aplicación de
ordenes desplegado en el servidor de componentes. Para acceder
a este servicio los servidores el servidor debe tener permisos a nivel
de red sobre el servidor de componentes.
Connection Nombre de la cadena de conexión de base datos creada en el
punto anterior.
userCode Código del maestro de identificaciones de usuario (SIIDE.idecod)
Luego de actualizar la información en cada uno de los flujos se procede a guardar y cerrar el Flujo
de la parte Superior.

Página 26

Documento de Configuración - Integración RIS

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Documento de Configuración - Integración RIS

Cargado por

Copyright:

Formatos disponibles

MANUAL DE CONFIGURACIÓN

INTEGRACIÓN - RIS ESTÁNDAR

Este documento fue preparado por:

La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

Adición permiso de observación.

Plantilla única de integración

Adicionar argumentos flujo de

La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

Este documento describe el proceso de configuración de los módulos administrativos y clínicos de

Para un correcto funcionamiento de la integración de Servinte Clinical Suite Enterprise con el

-- -- ITLINK Deben existir las siguientes tablas en la base de

Plano -- -- Verificar que en la tabla de configuración de tipos de

Plano -- -- Verificar que se tenga en la tabla (SISMEN), los

Maestro Maestro de LMAEST En este maestro deben existir el siguiente registro:

La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

SEDEQU: Definir los valores que se envían en el

Los campos de los detalles (SICTEDET) se deben

Maestro Constantes LMAEST Debe existir las siguientes constantes clínicas

TIPPAC: Definir los valores que se envían en el

Los campos de los detalles (HICTEDET) se deben

Maestro Aplicaciones SISTEG Debe existir un matricula el siver de la aplicación de

Maestro Exámenes de HMAEST En este maestro se configura los exámenes o

La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

Maestro Permisos a SISTEG Definir los permisos al grupo de usuario al que

El número representa la posición del permiso.

Maestro Variables de LMAEST Consultar Imágenes asociadas a un Resultado:

Valor por defecto:

- (m) corresponde al origen de datos donde el

La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

Valor por defecto CI = M

La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

Valor por defecto IL = A

Valor por defecto LI = A

Valor por defecto LI = S

Valor por defecto AX = N

La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

Valor por defecto LR = S

NOTA: Para realizar el montaje de los archivos de

Listeners -- ITLINK El paquete recibido debe contener los siguientes

- Recibir Mensajeria RIS.wfl

Los listeners deben ser ubicados en la siguiente ruta

C:\Servinte\Servinte Services Manager\ITLink\

Workflow -- ITLINK El paquete recibido debe contener los siguientes

La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

Los archivos deben ser ubicados en la siguiente ruta

C:\Servinte\Servinte Services Manager\ITLink\

Referenc -- HCECLI El paquete recibido debe contener las siguientes

La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

Los archivos deben ser ubicados en la siguiente ruta

C:\Servinte\Servinte Services Manager\Tilín\

NOTA: En esta misma ruta se debe incluir el

La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

1.2 MAESTRO DE EVENTOS – IKEVE

Descripción de los campos:

La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

O01 Orden Nueva S ORDENG RIS RIS XML HL725 SERVIN H

Todos los eventos se graban con indicador de Activo en S.

En el detalle de Aplicaciones externas de este maestro (ikeveapx), se configura si el dato ubicación

En el maestro de eventos por Aplicación (IKEVEAPX)

En la configuración del maestro de integraciones de órdenes (ITORD), se define para cada

EVENTO MFN^M02 - Actualización de Médicos

La propiedad intelectual de este documento es de CARVAJAL SERVICIOS S.A.S.

EVENTO ADT^A01 - Ingreso