16
iS3 N. revisió doc.: 1.4 Manual d’usuari Plataforma de Proves stand alone N. versió solució: 1.0 Pàg. 1 / 16 Revis Redactat per Revisat per Aprovat per Data aprovació Data publica ció 1.0 David Martínez Gómez 1.1 Marina Sánchez 29/03/20 16 1.2 Ana L. Garcia 29/03/20 16 1.3 David Martínez 28/04/20 16 1.4 Ana L. Garcia 11/05/20 16 NOTA: Al final del document es troben les signatures i comentaris a la revisió i aprovació Registre de Canvis Revisi ó Apartat Data Modificació Motiu del canvi 1.1 1.2, 7.2 16/03/2016 Afegir exemples de validació de missatgeria. 1.2 Tots 29/03/2016 Modificar format per adaptar-ho a la plantilla Manual Usuari 1.3 2 28/04/2016 Incloure abast de validacions 1.4 4.3 11/05/2016 Inclure com modificar el port pel que es comunica la Plataforma de testing en cas de que el 8080 ja l’estigui emprant l’usuari RESPONSABLE DEL DOCUMENT: Í N D E X 1. INTRODUCCIÓ........................................................... 2 1.1 Objecte 2 1.2 Abast 2 1.3 Documentació Relacionada 2 2. DESCRIPCIÓ GENERAL DEL SISTEMA........................................2 2.1 Entorn de treball 3 2.2 Perfils d’Usuari 3 2.3 Funcionament del Sistema 3 2.3.1 Instalació del Mòdul..........................................3 2.3.2 Verificació de la instalació..................................5 2.3.3 Desinstalació o rollback......................................6 document.docx 17/05/202217:12:24

Document General - TicSalut€¦  · Web viewManual . d’usuari Plataforma de Proves stand alone. ... el camp on es detallen els ... Es selecciona la pestanya “Service Endpoints”

  • Upload
    buicong

  • View
    218

  • Download
    3

Embed Size (px)

Citation preview

Document General

Revisi

Redactat per

Revisat per

Aprovat per

Data aprovaci

Data publicaci

1.0

David Martnez Gmez

1.1

Marina Snchez

29/03/2016

1.2

Ana L. Garcia

29/03/2016

1.3

David Martnez

28/04/2016

1.4

Ana L. Garcia

11/05/2016

NOTA: Al final del document es troben les signatures i comentaris a la revisi i aprovaci

Registre de Canvis

Revisi

Apartat

Data Modificaci

Motiu del canvi

1.1

1.2, 7.2

16/03/2016

Afegir exemples de validaci de missatgeria.

1.2

Tots

29/03/2016

Modificar format per adaptar-ho a la plantilla Manual Usuari

1.3

2

28/04/2016

Incloure abast de validacions

1.4

4.3

11/05/2016

Inclure com modificar el port pel que es comunica la Plataforma de testing en cas de que el 8080 ja lestigui emprant lusuari

RESPONSABLE DEL DOCUMENT:

N D E X

1.INTRODUCCI2

1.1Objecte2

1.2Abast2

1.3Documentaci Relacionada2

2.DESCRIPCI GENERAL DEL SISTEMA2

2.1Entorn de treball3

2.2Perfils dUsuari3

2.3Funcionament del Sistema3

2.3.1Installaci del Mdul3

2.3.2Verificaci de la installaci5

2.3.3Desinstallaci o rollback6

2.4Sistemes relacionats6

2.5Ajudes6

3.FUNCIONALITATS DEL SISTEMA7

3.1Validaci de la missatgeria7

3.1.1Descripci7

3.1.2Perfils dUsuaris Autoritzats7

3.1.3Operativa de la Funcionalitat7

4.ANNEXES11

4.1Annex 1: Glossari11

4.2Annex 2: Incidncies ms Freqents11

4.3Annex 3: Error per utilitzaci de port 808011

4.4Annex 4: Descripci de les Pantalles13

4.5Annex 5: Descripci dInformes13

4.6Annex 6: Suport Tcnic13

INTRODUCCIObjecte

Aquest document defineix les instruccions dinstallaci i s de la Plataforma de Proves (TSP) Stand-Alone, aix com les comprovacions que cal realitzar per validar que es poden iniciar les proves.

Abast

Aquest document aplica a la installaci del aplicatiu i s. Els apartats sn els segents:

Prerequisits. Requisits de maquinari i programari base necessaris

Installaci. Procediment per a la configuraci i installaci dels diferents components, tant del programari base (configuraci de les pools de connexions, esquemes de base de dades que cal crear pel sistema dinformaci, etc.) , com del propi sistema dinformaci.

Verificaci de la installaci. Procediment per comprovar que la installaci ha estat satisfactria i el sistema dinformaci est preparat per ser usat o ser provat en detall.

Desinstallaci o rollback. Procediment per a leliminaci neta del sistema.

Funcionalitats del aplicatiu.i exemples (a lapartat Annex 2 es afegeixen exemples de referencia per a la validaci de missatgeria).

Documentaci Relacionada

Documents relacionats:

iS3_TSP_PLA_PMP_Simulador_20160229_v1.0.docx

DESCRIPCI GENERAL DEL SISTEMA

Des del projecte IS3 es posar a disposici dels provedors la Plataforma d' Interoperabilitat de test que permetr dur a terme les proves de missatgeria de forma autnoma necessries per a la incorporaci a la plataforma d'un nou provedor.

Al present mdul es proporcionen les segents funcionalitats:

Proves relatives a validacions destructura de missatge.

A la plataforma de test es proporcionaran eines que permetin validar que els missatges que es generen o reben en un centre sn missatges construts dacord als esquemes WIFIS vigents a la plataforma dinteroperabilitat -actualment WIFIS 2.0.1.

Aquestes eines estaran disponibles de forma Stand-Alone, facilitant en aquest ltim cas la realitzaci de proves sense requeriments previs de connectivitat.

El mdul validar principalment els segents casos definits en lestndard WIFIS 2.0.1:

Estructura del missatge global.

Obligatorietat i cardinalitat del segments del missatge.

Valors fixes dels camps.

Proves relatives a enviament i recepci de missatges.

Es proporcionaran plantilles editables per lusuari, eines per simular lintercanvi de missatgeria entre centres de forma que es pugin realitzar proves extrem a extrem sense requerir la participaci de altres centres. Ser la prpia plataforma la que actuar com a interlocutor.

Al present mdul resten fora de labast els segents punts:

Validacions que requereixen accs al Servei de Catlegs. Donat que es tracta dun mdul allat sense connexi al Servidor Terminolgic, en aquesta entrega queda fora de labast la validaci de vocabulari controlat definit per Comit dEstndards..

Aquells casos en que la definici del estndard s heterognia, s a dir, aquells segments que depenent de la intencionalitat del missatge estan definits al estndard WIFIS amb un format especfic. Per exemple, el camp on es detallen els diferents tipus dinforme (Segments OBX), JPG, PDF, HC3 on la definici de WIFIS 2.0.1 varia sobre els mateixos camps depenent de linforme enviat.

Aquells casos en que la configuraci del camp sigui depenent duna lgica complexa.

Processament de missatgeria i resposta automtica. Resta pendent per a una nova fase que lusuari pugui pujar un missatge i que la plataforma el processi i retorni una resposta de forma automtica i coherent amb la informaci del missatge dentrada.

Tractament de versions prvies a la WIFIS 2.0.1. Donat que la plataforma de test es subministra per centres que sincorporen amb aquesta versi, no seria necessari proveir versions anteriors s que esta previst a la soluci la incorporaci de qualsevol possible versi posterior.

Entorn de treball

Lentorn de treball s lestaci de treball del tcnic que lempri, aquest mdul no requereix de connexi als sistemes CatSalut.

Perfils dUsuari

No aplica, el mdul Stand-Alone no te usuaris.

Funcionament del SistemaInstallaci del MdulPre-installaci

Com a preinstallaci del validador Stand-Alone ser necessari disposar del fitxer comprimit (validador.zip) i del programari requerit. En aquestes URL es podr descarregar el programari necessari per executar el validador; http://www.7-zip.org/,https://www.soapui.org/

Procediment dinstallaci

El primer pas es descomprimir el fitxer .zip a la ruta desitjada (no hi ha cap mena de restricci de ruta).

Executar el arxiu start.bat per iniciar el servei local de validaci.

Obrir el programa de test de SOAP i carregar el projecte de test incls a la carpeta descomprimida. En el nostre cas el projecte es diu ValidadorEstructuraImplPort-wsdl-soapui-project.xml

Sistema dinformaci

Dintre del projecte es troben els missatges SOAP parametritzats segons el servei/acci depenent del missatge que es vulgui validar.

Dintre del fitxer read.txt es troben tots els possibles valors dels parmetres:

WIFIS_Cites_2.0.1

DemanarNova

NotificarCancelacio

NotificarNoPresentacio

NotificarProgramacio

NotificarReprogramacio

RespondreNova

WIFIS_Derivacions_2.0.1

DemanarCancelacio

DemanarNova

NotificarCancelacio

NotificarFinalitzacio

NotificarResultats

RespondreCancelacio

RespondreNova

WIFIS_Notificacions_2.0.1

NotificacioRealitzacio

WIFIS_General_2.0.1

ACK_Cita

ACK_DerivacioNotificacio

Tamb el projecte SOAP disposa de diferents TestCases per si es desitja provar un grup de missatges de manera seqencial.

Verificaci de la installaci

Realitzar els casos de prova segents:

Validar el servei local de validaci: Obrir el fitxer read.txt incls a la carpeta generada, copiar la URL del Endpoint:

http://localhost:8080/validador-WIFIS/services/ValidadorEstructuraImplPort?wsdl

Executar els TestCase amb les plantilles que venen per defecte.

Comprovar que el resultat queda de la segent manera:

Accedir al document de referncia adjunt Manual dusuari.

Desinstallaci o rollback

Per desinstallar el validador Stand-Alone WIFIS 2.0.1 noms s necessari aturar el servei tancant la finestra de smbol del sistema i eliminar la carpeta generada en la descompressi del fitxer .zip

Sistemes relacionats

Per fer us del validador Stand-Alone de missatges WIFIS 2.0.1 s necessari com a mnim tenir el programari i el espai en disc requerit.

Tipus

Nom

Versi (mnima)

Comentaris

Sistema operatiu

Windows

N/A

Descompressi de fitxers .zip

Winzip, 7-zip, Winrar, etc...

N/A

Programa de test per SOAP

SOAPUI, Rational, etc...

N/A

Es recomana SOAPUI, les proves shan realitzat amb aquest programari

Ajudes

No sha definit cap ajuda especfica.

TIPUS DE DOCUMENT

Paannnn-AAAAAAAA

Ttol del Document

N. versi: 1.0.

Pg. 1 / 8

iS3

N. revisi doc.: 1.4

Manual dusuari Plataforma de Proves stand alone

N. versi soluci: 1.0

Pg. 12 / 13

Assumpte_MAN_INS_v1.0

12/05/2016 09:53:35

iS3_TSP_MAN_USU_Simulador_20160308_V1.4.docx

12/05/201609:53:35

FUNCIONALITATS DEL SISTEMA

Les funcionalitats del sistema sn les segents:

Validaci de la missatgeriaDescripci

Aquesta funcionalitat permet la validaci estructural dels missatges generats per provedor

Perfils dUsuaris Autoritzats

No aplica.

Operativa de la Funcionalitat

Lusuari selecciona el missatge a validar el pega al SOAP-GUI i prem la icona verd de validar. El sistema revisa els canvis i retorna el resultat que pot ser el segent:

True: el missatge generat s correcte

False error en el missatge. En aquests casos el mdul indica el tipus derror aix com el camp en el que sha detectat.

A continuaci es mostren diversos exemples de validacions correctes i errnies.

Exemple 1-Validaci del missatge OK

1. Seleccionar missatge.

2. Mantenir ple-omplert servei/acci.

3. Executar la request.

4. Visualitzar resultat.

Exemple 2 2-Cita Demanar Nova Validaci de missatge i retorn derror per absncia de obligatori.

1. Seleccionar missatge.

2. Mantenir ple-omplert servei/acci.

3. Comentar camp obligatori.

4. Executar la request.

5. Visualitzar resultat.

Exemple 3- Derivaci Demanar Nova false per longitud de camp ms gran que la definida.

1. Seleccionar missatge.

2. Modificar contingut PID.3-CX.1.

3. Executar la request.

4. Visualitzar resultat.

ANNEXESAnnex 1: Glossari

No aplica

Annex 2: Incidncies ms Freqents

No aplica

Annex 3: Error per utilitzaci de port 8080

Laplicatiu funciona emprant el port 8080, s per aix que abans dactivar-ho lusuari shauria dassegurar que no t el port ocupat per un altre aplicatiu. En cas que ho vulgui canviar hauria de seguir els segents passos:

1. Accedir al fitxer Start.ini que es troba a la carpeta jetty

2. Obrir el fitxer i modificar el port amb el nmero que tingui disponible

3. Prmer gravar i tancar el fitxer.

4. Entrar en el SoapUI i clicar dos cops sobre el projecte per obrir les propietats.

5. Es selecciona la pestanya Service Endpoints i es modifica el port amb el mateix nmero indicat al fitxer start.ini

Annex 4: Descripci de les Pantalles

No aplica

Annex 5: Descripci dInformes

No aplica

Annex 6: Suport Tcnic

En cas dincidncia contactar amb:

Servei dAtenci a lUsuari, despai de treball i collaboraciCentre de Telecomunicacions i Tecnologies de la InformaciTel :900 701 [email protected]