INSTALACIÓN VM WEBSERVICE Requisitos mínimos: Importante para poder instalar VM WEBSERVICE, el equipo debe cumplir con los siguientes requisitos mínimos: El sistema operativo tiene que tener las últimas actualizaciones instaladas Tiene que tener la última versión del Medical Workstation (disponible en FTP) instalada El sistema Operativo tiene que ser de 64 bits Sistemas operativos compatibles: *Windows 10, *Windows 7 Service Pack 1, *Windows 8, *Windows 8.1, *Windows Server 2008 R2 SP1, *Windows Server 2008 Service Pack 2, *Windows Server 2012, *Windows Server 2012 R2, *Windows Vista Service Pack 2, Server 2016 (no está probado) ES RECOMENDABLE QUE EL WEBSERVICE SE INSTALE EN EL SERVIDOR DONDE SE ENCUENTRAN INSTALADOS EL E MODALITY WORKLIST Y EL PACS DE IMÁGENES.
SI NO TIENE MWSWEB HTML5 INSTALADO: PASO 1 Necesitamos el archivo.rar que se encuentra dentro de la carpeta \raiz-ftp\vm WEBSERVICE INTEGRAD del ftp. Este archivo se llama INSTALADOR APACHE-WEBSERVICE.rar y contiene el servidor Apache necesario para deployar el webservice y el webservice propiamente dicho. En el caso de que Ud. sea un distribuidor de Latam debe bucar este archivo dentro de la carpeta \raiz-ftp\vm-int\ VM WEBSERVICE INTEGRAD del ftp PASO 2 Descomprimimos el contenido de INSTALADOR APACHE-WEBSERVICE.rar dentro de la raíz del disco duro donde vamos a instalar el servidor. Se nos creara la carpeta MWSWEB. PASO 3 En la carpeta MWSWEB se encuentra la carpeta extras. Dentro de la carpeta extras encontramos los dos instaladores siguientes: Estos archivos son versiones de C++ necesarias para instalar Apache. Hacemos clic en cada uno de ellos con el botón derecho del mouse y a continuación seleccionamos Ejecutar como administrador. El orden en que se instalen no es importante. ATENCIÓN: SI SURGE ALGUN PROBLEMA INSTALANDO ESTOS DOS ARCHIVOS ES PROBABLE QUE SEA DEBIDO A QUE NO SE ENCUENTRA INSTALADO EL SERVICE PACK DEL SISTEMA OPERATIVO O QUE EL MISMO NO SE ENCUENTRA ACTUALIZADO. REVISAR! PASO 4 Nos dirigimos a la carpeta Apache24 que se encuentra dentro de la carpeta MWSWEB. Dentro de Apache24 entramos a la carpeta bin : Dentro de la carpeta bin buscamos el ejecutable install-mwsweb.cmd y hacemos clic en el con el botón derecho del mouse y a continuación seleccionamos Ejecutar como administrador. Mediante esto instalaremos el servicio MWSWEB que corresponde al servidor Apache. Se abrirá una pantalla de cmd y al finalizar el proceso de instalación del servicio veremos lo siguiente:
PASO 5 Ingresamos a la carpeta bin que se encuentra dentro de Apache24 y buscamos el archivo ejecutable config-mwsweb.cmd : En este archivo hacemos clic en el con el botón derecho del mouse y a continuación seleccionamos Ejecutar como administrador. Al ejecutar este archivo se abrirá una ventana del navegador con la siguiente pantalla: Además de esta pantalla se abrirá una ventana de cmd con un contador. Cuando el contador llegue a cero la ventana con el Configurador Web se cerrara automáticamente.
PASO 6 Dentro de la pantalla del navegador que se abrió hacemos clic en el borde inferior izquierdo: Seremos redirigidos a la pantalla de inicio del Configurador Web. PASO 7 En la pantalla de inicio ingresaremos la ip donde se encuentra instalada la base de datos del Modality WorkStation. Usualmente bastará con ingresar 127.0.0.1 a menos que se encuentre instalado en otra pc por lo que en ese caso deberemos ingresar la ip de la misma. Una vez ingresado dentro del Configurador Web al final de la pantalla se encuentran las opciones de configuración del webservice. ATENCION: SI NO VEMOS LAS OPCIONES DE CONFIGURACION DEL WEBSERVICE ESTO SE DEBE A QUE EL MISMO NO SE ENCUENTRA INSTALADO Y NO SE HA COPIADO LA CARPETA webservicewl DENTRO DE LA CARPETA htdocs.
PASO 8 Al final de todas las opciones de configuración tenemos el botón ACTUALIZAR. Al hacer clic en este botón se crearan y actualizaran las bases de datos que utiliza el webservice. Se deberá hacer clic en este botón la primera vez que se instala el webservice y cada vez que se actualice el mismo. SI TIENE MWSWEB HTML5 INSTALADO: PASO 1 Ingresamos a \raiz-ftp\vm WEBSERVICE INTEGRAD\versiones y entramos a la carpeta con el número de versión más grande (en este caso 1.2): En el caso de que Ud. sea un distribuidor de Latam debe buscar esta carpeta dentro de la carpeta \raiz-ftp\vm-int\ VM WEBSERVICE INTEGRAD del ftp Dentro encontramos la carpeta webservicewl que es el webservice propiamente. Copiamos la carpeta webservicewl dentro de la carpeta htdocs que se encuentra dentro de la carpeta Apache24 de la instalación de Apache:
webservicewl debe quedar dentro de htdocs. En esta carpeta se deployan las aplicaciones de Apache: PASO 2 Ingresamos a la carpeta bin que se encuentra dentro de Apache24 y buscamos el archivo ejecutable config-mwsweb.cmd : En este archivo hacemos clic en el con el botón derecho del mouse y a continuación seleccionamos Ejecutar como administrador. Al ejecutar este archivo se abrirá una ventana del navegador con la siguiente pantalla:
Además de esta pantalla se abrirá una ventana de cmd con un contador. Cuando el contador llegue a cero la ventana con el Configurador Web se cerrara automáticamente. PASO 3 Dentro de la pantalla del navegador que se abrió hacemos clic en el borde inferior izquierdo: Seremos redirigidos a la pantalla de inicio del Configurador Web. PASO 4 En la pantalla de inicio ingresaremos la ip donde se encuentra instalada la base de datos del Modality WorkStation. Usualmente bastará con ingresar 127.0.0.1 a menos que se encuentre instalado en otra pc por lo que en ese caso deberemos ingresar la ip de la misma.
Una vez ingresado dentro del Configurador Web al final de la pantalla se encuentran las opciones de configuración del vm webservice. ATENCION: SI NO VEMOS LAS OPCIONES DE CONFIGURACION DEL WEBSERVICE ESTO SE DEBE A QUE EL MISMO NO SE ENCUENTRA INSTALADO Y NO SE HA COPIADO LA CARPETA webservicewl DENTRO DE LA CARPETA htdocs. PASO 5 Al final de todas las opciones de configuración tenemos el botón ACTUALIZAR. Al hacer clic en este botón se crearan y actualizaran las bases de datos que utiliza el webservice. Se deberá hacer clic en este botón la primera vez que se instala el webservice y cada vez que se actualice el mismo.
CONFIGURACIÓN VM WEBSERVICE PASO 1 En la primer parte Conexión bases de datos ingresaremos las ip y puertos para conectarnos a las bases de datos de Modality WorkList, Medical WorkStation y Telerad. Por defecto estos campos están completados con la ip 127.0.0.1 y el puerto 5432. Estos valores deberían ser correctos a menos que las bases de datos en cuestión se encuentren en otra pc. PASO 2 En el campo url 1 de telerad se ingresara la url para ingresar a Telerad por una ip interna. Este valor se utiliza cuando el webservice devuelve la url para visualizar imágenes de estudios a través de Telerad. PASO 3 En el campo url 2 de telerad se ingresara la url para ingresar a Telerad por la ip pública del servidor. Este valor se utiliza cuando el webservice devuelve la url para visualizar imágenes de estudios a través de Telerad. PASO 4 En el campo url de SMS se ingresa la url donde se envían los mensajes que posteriormente se reenviaran como sms. PASO 5
En el campo url de manual se ingresara la url donde se encuentra publicado el manual de uso del vm webservice. Por lo general debería ser algo asi: http://url_del_servidor/webservicewl/ manual_webservicewl.pdf PASO 1 TESTING DE VM WEBSERVICE Ingresamos a \raiz-ftp\vm WEBSERVICE INTEGRAD y entramos a la carpeta PARA TESTEAR WEBSERVICE : En el caso de que Ud. sea un distribuidor de Latam debe buscar esta carpeta dentro de la carpeta \raiz-ftp\vm-int\ VM WEBSERVICE INTEGRAD del ftp Dentro encontramos el archivo.jar RESTClient 3.2.2.jar que es el programa Java que usaremos para testear el webservice. Por lo tanto necesitaremos una pc con Java instalado para realizar las pruebas. PASO 2 Ejecutamos el archivo.jar RESTClient 3.2.2.jar y se nos abrirá la siguiente pantalla:
PASO 3 En la pantalla anterior; dentro de la pestaña METHOD ; en el campo URL ingresaremos la url de uno de los servicios del vm webservice. En este caso para probar el funcionamiento se usará el servicio Consulta tags Dicom. Entonces en el campo url ingresaremos la url del servicio en cuestión: http://url_webservice/webservicewl/index.php/acciones/consultatags. Esta url y la de los demás servicios la encontraremos dentro del Manual de integración Visual Medica Mediante webservice 4.1 que se encuentra dentro de la carpeta del webservice en el ftp. Dentro del cuadro HTTP METHOD seleccionaremos POST. Entonces la pantalla nos deberá quedar así:
PASO 4 Hacemos clic en la pestaña Body :
PASO 5 Hacemos clic en el menú desplegable donde dice None y seleccionamos String body : PASO 6
Hacemos clic en el botón que dice Edit Content-type & Charset. Del grupo de tres botones es el primero a la izquierda. PASO 7
En el primer campo de la ventana que se abre escribiremos application/json. El segundo campo lo dejaremos tal cual con UTF-8 y haremos clic en el botón Ok. PASO 8 Se nos habilitará el cuadro de texto marcado en rojo en la siguiente imagen. Ahí escribiremos el mensaje en formato JSON que usaremos para probar el VM WebService. Ejemplos de mensajes JSON para este servicio y los demás servicios los encontraremos dentro del Manual de integración Visual Medica Mediante webservice 4.1 que se encuentra dentro de la carpeta del webservice en el ftp.
En este ejemplo utilizamos el mensaje JSON siguiente: { "datosestudioabuscar": { "estudioaccessionnumber": "45123687" } } En estudioaccessionnumber debemos ingresar un accession number de un estudio que se encuentre en el Medical WorkStation.
PASO 9 Haremos clic en el botón con dos flechas verdes que se encuentra a la derecha del campo donde ingresamos la url: PASO 10 En la parte inferior, si todo fue correcto, en el campo Status deberemos leer HTTP/1.1 200 OK y en la pestaña Body veremos la respuesta JSON que devuelve el webservice. Según el servicio al que se consulta el webservice devuelve distintos mensajes de error si surgió algún inconveniente. Ejemplos de mensajes JSON de respuesta para este servicio y los demás servicios los encontraremos dentro del Manual de integración Visual Medica Mediante webservice 4.1 que se encuentra dentro de la carpeta del webservice en el ftp. ATENCIÓN: SI DENTRO DEL CAMPO Status LEEMOS ALGO DISTINTO AL CÓDIGO HTTP/1.1 200 OK ENTONCES HAY ALGUN PROBLEMA DE COMUNICACIÓN CON EL WEBSERVICE O EL WEBSERVICE NO SE ENCUENTRA FUNCIONANDO CORRECTAMENTE.