Documentazione Tecnica AddOn CGM CSE

Transcript

Documentazione Tecnica AddOn CGM CSE Software Cartella Clinica VENERE
Documentazione Tecnica AddOn CGM CSE
Software di Cartella Clinica VENERE
For internal use only!
State: released
Date: 9/11/2012
Version: 1.1
Author: CGM Italia
Abstract
Documentazione tecnica richiesta per l’accreditamento del software di AddOn CGM CSE dell’applicativo
gestionale di cartella clinica VENERE in dotazione ai Medici di Medicina Generale (MMG).
Copyright © CompuGroup Medical Italia – All rights reserved. For internal use only.
1 of 37
Indice
1 Dati identificativi......................................................................................................................4
2 Descrizione del sistema.............................................................................................................6
2.1 Integrazione con Anagrafe Persone e Anagrafe Sanitaria..................................................................6
2.2 Registrazione delle Prescrizioni: predisposizione ed invio dei documenti di prescrizione .................6
2.3 Annullamento delle Prescrizioni........................................................................................................7
2.4 Registrazione/Aggiornamento PS: predisposizione ed invio dei documenti di patient summary .......7
2.5 Riepilogo eventi delle RFC di riferimento gestiti dall’AddOn..............................................................7
3 Architettura..............................................................................................................................8
4 Casi d’Uso...............................................................................................................................10
4.1 Attori...............................................................................................................................................10
4.2 Use Case Diagrams...........................................................................................................................11
4.3 Use Case Specification.....................................................................................................................15
5 Scenari di Cooperazione..........................................................................................................27
5.1 Allineamento Massivo Anagrafiche Assistiti (ANA_UC_001)............................................................27
5.2 Allineamento Anagrafiche Assistiti Scelti (ANA_UC_002)................................................................28
5.3 Allineamento Iscrizioni Revocate Assistiti (ANA_UC_003)...............................................................29
5.4 Allineamento Puntuale Anagrafica Assistito (ANA_UC_004)............................................................30
5.5 Identificazione Soggetto Assistito (ANA_UC_005)............................................................................31
5.6 Identificazione Soggetto Medico (ANA_UC_006).............................................................................31
5.7 Richiesta Assegnazione Lotto NRE (NRE_UC_001)............................................................................32
5.8 Ripristino NRE Assegnati e non ancora utilizzati (NRE_UC_002).......................................................32
5.9 Consultazione Posizione Ticket (TCK_UC_001).................................................................................33
5.10 Invio Prescrizione (PRS_UC_001)...................................................................................................34
5.11 Annullamento Prescrizione (PRS_UC_002).....................................................................................35
5.12 Invio Patient Summary (PSS_UC_001)............................................................................................36
6 Documenti RFC di riferimento.................................................................................................37
Indice delle Tabelle e delle Figure
Tabella 1 – Dati relativi all'applicazione software........................................................................4
Tabella 2 – Storico dell'applicazione software..............................................................................4
Tabella 3 – Dati relativi al documento tecnico..............................................................................4
Tabella 4 – Storico del documento...............................................................................................5
Figura 1 - UML Deployment Diagram AddOn CGM CSE................................................................8
Figura 2 – UML Actor Diagram...................................................................................................10
2 of 37
Figura 3 – UML UC Diagram relativo a “Allineamento Massivo
Anagrafiche Assistiti“ ................................................................................................................11
Figura 4 - UML UC Diagram relativo a “Allineamento Puntuale Anagrafica Assistito“................12
Figura 5 - UML UC Diagram relativo a “Invio / Annullamento Prescrizione“...............................13
Figura 6 - UML UC Diagram relativo a “Invio Patient Summary“................................................14
Tabella 5 - UC Specification "Allineamento Massivo Anagrafiche Assistiti"................................15
Tabella 6 - UC Specification "Allineamento Anagrafiche Assistiti Scelti".....................................16
Tabella 7 - UC Specification "Allineamento Iscrizioni Revocate Assistiti"....................................17
Tabella 8 - UC Specification "Allineamento Puntuale Anagrafica Assistito"................................18
Tabella 9 - UC Specification "Identificazione Soggetto Assistito"................................................19
Tabella 10 - UC Specification "Identificazione Soggetto Medico.................................................20
Tabella 11 - UC Specification "Richiesta Assegnazione Lotto NRE"............................................. 21
Tabella 12 - UC Specification "Ripristino NRE Assegnati e non ancora utilizzati" ........................ 22
Tabella 13 - UC Specification "Consultazione Posizione Ticket".................................................. 23
Tabella 14 - UC Specification "Invio Prescrizione".......................................................................24
Tabella 15 - UC Specification "Annullamento Prescrizione".......................................................25
Tabella 16 - UC Specification "Invio Patient Summary"..............................................................26
Figura 7 - UML Sequence Diagram "Allineamento Massivo Anagrafiche Assistiti"......................27
Figura 8 - UML Sequence Diagram "Allineamento Anagrafiche Assistiti Scelti"..........................28
Figura 9 - UML Sequence Diagram "Allineamento Iscrizioni Revocate Assistiti" ..........................29
Figura 10 - UML Sequence Diagram "Allineamento Puntuale Anagrafica Assistito"...................30
Figura 11 - UML Sequence Diagram "Identificazione Soggetto Assistito"................................... 31
Figura 12 - UML Sequence Diagram "Identificazione Soggetto Medico".....................................31
Figura 13 - UML Sequence Diagram "Richiesta Assegnazione Lotto NRE"...................................32
Figura 14- UML Sequence Diagram "Ripristino NRE Assegnati e non ancora utilizzati"...............32
Figura 15 - UML Sequence Diagram "Consultazione Posizione Ticket"........................................33
Figura 16 - UML Sequence Diagram "Invio Prescrizione"............................................................34
Figura 17 - UML Sequence Diagram "Annullamento Prescrizione"............................................. 35
Figura 18 - UML Sequence Diagram "Invio Patient Summary"....................................................36
3 of 37
1
Dati identificativi
NOME APPLICAZIONE
NUMERO DI VERSIONE
CGM CSE
1.0.0.1
DATA DI RILASCIO
9/11/2012
RFC E.TOSCANA DI
•
N. 85 - Servizi Anagrafe Persone;
•
N. 87 - Servizi Anagrafe Sanitaria - Gestione MMG/PLS
•
N. 133 - Carta Sanitaria Regione Toscana – Patient Summary
•
N. 161 - Invio -Annullamento Prescrizione
•
N. 123 - Storage Geografico HDIS - Archiviazione e Consultazione degli Eventi
Sanitari
•
N. 198 - Determinazione fasce di reddito per ticket su erogazione di farmaci e
prestazioni.
•
N. 207 - Acquisizione Numeri Ricetta Elettronica
•
N. 98 – Busta evento clinico
RIFERIMENTO
RESPONSABILE DEL PRODOTTO
CLAUDIO MUSCOGIURI
REFERENTE TECNICO
ANTONIO VALENTE
Tabella 1 – Dati relativi all'applicazione software
VERSIONE SOFTWARE
DATA
1.0.0.1
9/11/2012
1.0.0.0
8/08/2012
MODIFICHE
Eliminata gestione esenzioni/fasce di reddito nell’ambito della
funzionalità di allineamento MASSIVO delle anagrafiche
assistiti come da comunicazione di RT del 30/10/2012
Prima Release
Tabella 2 – Storico dell'applicazione software
NOME DEL DOCUMENTO
VERSIONE DEL DOCUMENTO
DOCUMENTAZIONE TECNICA ADDON CGM CSE – CARTELLA CLINICA VENERE
1.1
AUTORE
CGM ITALIA
DATA DI RILASCIO
09/11/2012
Tabella 3 – Dati relativi al documento tecnico
4 of 37
VERSIONE DOCUMENTO
1.1
1.00
DATA
MODIFICHE
Revisione scenario Allineamento Anagrafiche Assistiti a
seguito della direttiva di RT del 30/10/2012:
09/11/2012
8/08/2012
•
Eliminati riferimenti alle esenzioni nei paragrafi 2.1 e
2.5;
•
Aggiornato Cap. 4, Use Case Diagram, par. 4.2.1
Allineamento Massivo Anagrafiche Assistiti
•
Aggiornato Cap. 4, Use Case Specification, par. 4.3.1
ANA_UC_001 Allineamento Massivo Anagrafiche
Assistiti;
•
Aggiornato Cap. 4, Use Case Specification, par. 4.3.2
ANA_UC_002 Allineamento Anagrafiche Assistiti
Scelti;
•
Aggiornato Cap. 5, Scenari di Cooperazione, par. 5.1
•
Allineamento Anagrafiche Assistiti Scelti
•
Allineamento Iscrizioni Revocate Assistiti
•
Aggiornato Cap. 6 Documentazione di Riferimento
Prima Versione.
Tabella 4 – Storico del documento
5 of 37
2
Descrizione del sistema
Questa sezione fornisce una descrizione di carattere generale dell'applicazione software e delle sue
funzionalità previste per la FASE 1.
Le funzionalità di integrazione con i servizi CSE previsti dalla DGR 469 di Regione Toscana rese disponibili
per le utenze dei medici convenzionati sono state realizzate attraverso la produzione di un software di
AddOn che estende le originali funzionalità dell’applicativo gestionale di cartella clinica VENERE ed integra
nuove librerie che offrono nuove classi di funzionalità e specifiche interfacce utente con l’obiettivo di
implementare gli scenari di integrazione come indicati nelle specifiche tecniche allegate alla procedura
negoziata.
2.1
Integrazione con Anagrafe Persone e Anagrafe Sanitaria
L’AddOn implementa le funzionalità per la fruizione dei Servizi di Identificazione Anagrafica, utili al
recupero dei dati anagrafici dei soggetti assistiti/utenti con l’ottenimento dell’ID Universale del soggetto
identificata, sulla base di quanto indicato nelle RFC 85 e 87
Le funzionalità dell’AddOn a seconda degli scenari di utilizzo può integrare i servizi in maniera trasparente
all’utente secondo temporizzazioni schedulate in background; a seguito di prima e successive invocazioni, il
dato di ID Universale è conservato dalla logica dell’AddOn, per essere verificato e fruito nell’ambito di altri
scenari di integrazione previsti.
L’AddOn integra l’applicativo di cartella clinica offrendo all’utente funzionalità per recuperare ed allineare
le informazioni di dettaglio relative alle informazioni di scelta e revoca per un medico, registrate
nell’applicativo di cartella clinica in uso, con quelle registrate nel sistema regionale. Nuove scelte attive
sono inserite nell’applicativo. Infine, l’interazione con i servizi offerti dall’infrastruttura regionale consente
all’applicativo di effettuare l’aggiornamento puntuale delle esenzioni per i pazienti in scelta secondo
quanto indicato dalla RFC198.
2.2
Registrazione delle Prescrizioni: predisposizione ed invio dei documenti di prescrizione
Il modulo di integrazione supporta il client di cartella clinica nella realizzazione dello scenari di registrazione
delle prescrizioni. Laddove previsto dalle specifiche la logica di composizione del CDA usufruisce degli
identificativi ottenuti interagendo con i servizi di Identificazione Anagrafica (i.e come previsto dagli Scenari
di Integrazione con Anagrafe Persone e Anagrafe Sanitaria)
Le funzionalità dell’AddOn per l’invio delle prescrizioni SSN sono integrate con le funzionalità di
registrazione/stampa delle prescrizioni previste per l’applicativo di cartella clinica. Alla richiesta di stampa
della prescrizione da parte dell’utente Medico tramite le funzionalità dell’AddOn viene generato un
documento clinico, nel formato HL7v3 – CDA v2.0, per ogni ricetta da stampare generata dalla registrazione
degli item di prescrizione. I documenti clinici generati sono corredati di NRE, gestiti sulla postazione del
medico a lotti tramite le funzionalità offerte dai servizi previsti dalla [RFC207].
I documenti clinici, anche nel caso di altri scenari per la gestione di altri classi di documenti clinici, sono
gestiti in appositi store per il tracciamento delle code di invio, dei set di documenti inviati, così come delle
informazioni sugli invii falliti.
Gli scenari d’integrazione non prescrivono specifiche implementazioni lato cartella clinica per la gestione
dei collaboratori di studio; al proposito, l’azienda si è riservata la libertà progettuale di implementare
nell’AddOn funzionalità utili a soddisfare eventuali necessità della propria utenza di gestione dei dati di
prescrizione in regime di collaboratori di studio e configurazione di medicina di gruppo, nel rispetto delle
obbligatorietà dettate.
6 of 37
Gli scenari per la consultazione degli NRE (i.e. primo NRE disponibile, NRE
assegnati ed utilizzati in prescrizioni, ultimo NRE utilizzato in prescrizioni) sono considerati facoltativi, in
quanto non propedeutici allo scenario primario di composizione e invio delle prescrizioni.
L’utilizzo di codifiche da catalogo delle prestazioni regionali è condizionata dalla disponibilità di servizi
fruibili per l’aggiornamento dei tali cataloghi; l’ipotesi progettuale allo stato si basa, dunque, sull’utilizzo dei
nomenclatori nazionali utilizzati dall’applicativo di cartella.
2.3
Annullamento delle Prescrizioni
L’AddOn implementa le funzionalità per realizzare le richieste di annullamento di prescrizioni
precedentemente inviate al sistema regionale. L’interfaccia Utente dell’AddOn di integrazione offre
all’utente la possibilità di interrogare la lista dei documenti di prescrizione inviati, da cui selezionare
l’evento di prescrizione ed inviare la richiesta di annullamento (secondo quanto previsto dalla RFC 123).
2.4
Registrazione/Aggiornamento PS: predisposizione ed invio dei documenti di patient
summary
L’AddOn implementa le funzionalità per realizzare gli scenari di primo inserimento e aggiornamento del
Patient Summary. Attraverso l’interfaccia Utente dell’AddOn di integrazione l’utente seleziona la
funzionalità di Invio Patient Summary per il paziente “attivo” o selezionato che predispone ed invia il
documento secondo quanto indicato dalla RFC133.
2.5
Riepilogo eventi delle RFC di riferimento gestiti dall’AddOn
Si elencano di seguito gli eventi gestiti dall’AddOn CGM CSE (VENERE) delle RFC di riferimento di FASE 1:
 RFC 85
“Acquisizione Dati Anagrafici ed Identificativo Universale singolo paziente”
“Acquisizione Identificativo Universale medico”
 RFC 87
“Acquisizione lista pazienti scelti al momento della richiesta"
“Acquisizione lista pazienti revocati in un certo intervallo di date"
 RFC 207
"Richiesta di un lotto di NRE"
“Richiesta di tutti gli NRE assegnati e non utilizzati”
 RFC 198
"Determinazione esenzione dal pagamento del ticket o della fascia di reddito "
 RFC 161
"Invio prescrizione"
"Annullamento prescrizione"
 RFC 133
"Invio Patient Summary “campione“
7 of 37
3
Architettura
Questa sezione presenta una descrizione testuale e grafica (UML Deployment Diagram) dell’architettura
dell’applicativo di gestione dello studio medico focalizzata sulle principali responsabilità funzionali delle
componenti software dell’AddOn CGM CSE realizzato per l’integrazione con i servizi del progetto CSE
Toscana.
cmp AddOn Deployment Diagram
Applicativ o Gestione Studio Medico
«d e vi ce»
VENERE
«e xe cu tio n e nvi ro nm en t»
AddOn CSE
e P re scription
Custom
Action
Module
Controller
Module
User Inteface Layer
(GUI)
Sche da Pa zie nti
P atien t S u m m a ry
Serv ice
Agent
Module
P a ti en t S um m a ry
T i cket
Business Service
Module
P o rt5
P re scrizi on e
Data Application Layer (DAL)
SAR
L og on /Lo go ff
Anagrafe
«d evi ce»
DataBase
«d evi ce»
DataBase
APS
NIL
PDD
A na gra fiche
AAS
Figura 1 - UML Deployment Diagram AddOn CGM CSE
Il modello architetturale dell’AddOn di cartella clinica in Figura 1 si basa sui canoni del pattern MVC (Model
View Controller) dove i ruoli principali sono interpretati dal:
 "Controller": riceve i comandi dell'utente (in genere attraverso la “View”) e li attua modificando lo
stato degli altri due componenti;
 "View": visualizza i dati contenuti nel “model” e si occupa dell'interazione con utenti e agenti;
 "Model": fornisce i metodi per accedere ai dati utili all'applicazione.
La scelta di utilizzo di questo schema ha permesso la separazione fra la logica applicativa (o "logica di
business"), quasi totalmente a carico del “Model” e in piccola parte del “Controller”, e l'interfaccia utente a
carico del “View”. Di seguito, una descrizione delle interazioni tra le componenti.
L'addOn riceve due macro classi di input:
1) l'applicativo di cartella clinica chiama i metodi di interfaccia del controller a seguito di eventi di tipo
- logon/logoff;
- stampa prescrizione;
- apertura/chiusura/eliminazione scheda paziente.
2) l'utente, tramite la GUI dell'AddOn,
- chiede di inviare il patient summary del paziente attivo
- chiede di allineare le informazioni anagrafiche e la posizione ticket del paziente attivo;
- chiede l'allineamento massivo dei dati anagrafici degli assistiti a lui assegnati;
8 of 37
-
chiede l'allineamento delle iscrizioni degli assistiti che hanno
revocato la scelta.
3) Il “Controller”, ricevuta la richiesta, demanda al “Model”, che contiene il core applicativo dell'addon, il
processing della richiesta eventualmente connettendosi al data application layer o al service agent
module.
I risultati delle elaborazioni restituiti al “Controller” sono poi opportunamente visualizzati mediante
GUI.
L’architettura presentata in Figura 1 illustra per semplicità esplositiva i domini di interazione (paziente,
prescrizione, patient summary, login/logoff, etc) tra l’applicativo di gestione dello studio medico ed il
software di AddOn; quest’ultimo interagisce con i servizi CSE mediante apposite interfacce applicative
implementate nel Service Agent Module.
9 of 37
4
Casi d’Uso
Questa sezione riporta gli attori ed i casi d’uso principali e secondari necessari per descrivere le funzionalità
principali dell’AddOn dell’applicativo di cartella clinica in uso ai Medici di Medicina Generale (MMG). In
particolare, sono descritte le specifiche dei casi d’uso che comportano l’interazione con l‘APS.
4.1
Attori
Si riportano i principali attori individuati nella gerarchia di Figura 2 per la descrizione delle funzionalità
dell’AddOn:
•
Medico di Medicina Generale (MMG)
•
AddOn CSE o Sistema software da accreditare
•
Access Point Subsystem (APS)
uc Gerarchia Attori MMG AddOn C...
Medico
Applicativ o Gestione
Studio Medico
Medico Medicina
Generale (MMG)
AddOn CSE
Access Point
Subsystem (APS)
Figura 2 – UML Actor Diagram
10 of 37
4.2
Use Case Diagrams
Di seguito, la descrizione grafica in UML dei casi d’uso necessari a descrivere le funzionalità dell’applicativo
di AddOn con i servizi CSE. Per una maggiore chiarezza espositiva si riportano graficamente anche i casi
d’uso propri dell’applicativo di gestione cartella clinica laddove questi attivino le funzionalità dell’AddOn
che possono comportare le interazioni con l’APS. Per semplicità espositiva, si assume d’ora in poi che
l’attore generico “Medico” presentato nelle seguenti sezioni implementi il ruolo effettivo di “MMG”.
4.2.1
Per questi use case, l’ipotesi progettuale prevede l’avvio dell’allineamento massivo comprensivo dei dati
anagrafici degli assistiti in scelta e delle iscrizioni revocate in base alla temporizzazione schedulata in
background nella componente d’integrazione e configurata allo start-up dell’applicativo gestionale di
cartella clinica da parte del medico convenzionato. Lo Use Case Diagram illustra anche la possibilità di
eseguire on-demand le funzionalità di allineamento delle anagrafiche e delle iscrizioni revocate offerte
uc Allineamento Massiv o Anagrafiche Assis...
all’utente mediante interfaccia dell’AddOn.
AddOn CSE
Medico
Av v iare Applicativ o
Cartella Clinica
« i n cl u de »
ANA_UC_001
Allineamento Massiv o
Anagrafiche Assistiti
« inclu d e »
« in clu d e»
ANA_UC_002 Allineamento
Anagrafiche Assistiti Scelti
ANA_UC_003 Allineamento
Iscrizioni Rev ocate Assistiti
Access Point
Subsystem (APS)
Figura 3 – UML UC Diagram relativo a “Allineamento Massivo Anagrafiche Assistiti“
11 of 37
4.2.2
Allineamento Puntuale Anagrafica Assistito
Per questi use case, l’evento di allineamento puntuale è scatenato all’apertura della scheda di un paziente
e consiste nel recupero dei dati anagrafici dell’assistito e nella consultazione della posizione ticket. Anche in
questo caso, l’AddOn offre la possibilità all’utente di eseguire on-demand l’allineamento puntuale di un
uc Allineamento Puntuale Anagrafica Assistito
assistito mediante apposita funzionalità offerta dall’interfaccia grafica.
Aprire Scheda
Paziente
AddOn CSE
Medico
« i n cl u d e»
ANA_UC_004
Allineamento Puntuale
Anagrafica Assistito
« i n clu d e»
« i ncl u de »
ANA_UC_005
Identificazione Soggetto
Assistito
TCK_UC_001
Consultazione Posizione
Ticket
Access Point
Subsystem (APS)
Figura 4 - UML UC Diagram relativo a “Allineamento Puntuale Anagrafica Assistito“
12 of 37
4.2.3
Invio / Annullamento Prescrizione
L’evento che attiva l’invio della prescrizione è scatenato dall’esecuzione dell’attività di stampa della stessa;
il documento è inviato al sistema regionale dopo le verifiche sui dati obbligatori richiesti. In questo
diagramma, si illustrano anche gli use case relativi all’annullamento di una prescrizione già inviata al SAR e
quello relativo alla verifica ed all’eventuale ripristino degli NRE da apporre sulla ricetta elettronica.
uc Inv io/Annullamento Prescrizio...
Aprire Scheda
Paziente
Medico
Compilare
Prescrizione
Ricercare Prescrizione
Inv iata
Stampare
Prescrizione
«in clu de »
PRS_UC_001 Inv io
Prescrizione
AddOn CSE
«i n clude »
Verifica Dati Anagrafici
Assistito
« exten d»
ANA_UC_005
Assistito
« in clu de»
PRS_UC_002
Annullamento
Prescrizione
« i ncl ud e»
Verifica Dati Anagrafici
Medico
«e xtend»
ANA_UC_006
Medico
NRE_UC_002 Ripristino
NRE Assegnati e non
ancora utilizzati
Verifica Disponibilità
NRE
« exte nd »
« exten d»
NRE_UC_001 Richiesta
Assegnazione Lotto NRE
Access Point
Subsystem (APS)
Figura 5 - UML UC Diagram relativo a “Invio / Annullamento Prescrizione“
13 of 37
4.2.4
Invio Patient Summary
Per questo use case, l’ipotesi progettuale prevede la possibilità di invio del patient summary per un assistito
in carico al medico dopo l’apertura della relativa scheda (paziente attivo). Come descritto negli UC
Specification, l’AddOn è comunque coinvolto nel processo di svuotamento della coda di invio.
uc Inv io Patient Summ...
Aprire Scheda
Paziente
AddOn CSE
Medico
PSS_UC_001 Inv io
Patient Summary
« in clud e»
«inclu de»
« in clud e»
Verifica Dati
Anagrafici Assistito
Verifica Dati
Anagrafici Medico
« extend »
ANA_UC_005
Assistito
Acquisizione Dati
Patient Summary dal
DB
«extend »
ANA_UC_006
Medico
Access Point
Subsystem (APS)
Figura 6 - UML UC Diagram relativo a “Invio Patient Summary“
14 of 37
4.3
Use Case Specification
Di seguito la descrizione delle specifiche dei caso d’uso. Laddove si è ritenuto necessario, sono citati i casi
d’uso inclusi e/o estesi evidenziati nei diagrammi UML degli UC.
4.3.1
ANA_UC_001 Allineamento Massivo Anagrafiche Assistiti
ID USE CASE
NOME USE CASE
ANA_UC_001
ATTORE PRINCIPALE
Medico
ATTORI SECONDARI
AddOn, APS
DESCRIZIONE
Consente di allineare i dati anagrafici degli assistiti in carico al medico che sono già
presenti nell’archivio di cartella clinica, di inserire i dati anagrafici degli assistiti di
nuova scelta e di aggiornare lo stato degli assistiti con iscrizioni revocate con le
corrispondenti informazioni contenute nell’Anagrafica Regionale.
PRE-CONDIZIONI
Nel client di cartella clinica sono:
POST-CONDIZIONI
1.
aggiornate le informazioni anagrafiche di dettaglio degli assistiti in carico
che erano già presenti nell’archivio locale con quelle presenti nell’anagrafe
regionale alla data corrente;
2.
registrate le informazioni anagrafiche di dettaglio degli assistiti di nuova
scelta;
3.
aggiornati gli stati delle iscrizioni dei pazienti presenti nell’archivio locale
che hanno revocato la scelta del medico;
4.
aggiornati gli stati di integrazione dei pazienti non presenti nell’anagrafe
regionale ma presenti nell’archivio locale del medico;
1.
Il medico esegue lo start-up dell’applicativo di cartella clinica;
2.
L’AddOn avvia automaticamente l’allineamento massivo degli elenchi degli
assistiti scelti alla data corrente nell’applicativo richiamando il caso d’uso
<<include>> “ANA_UC_002 – Allineamento Anagrafiche Assistiti Scelti”;
3.
L’AddOn avvia automaticamente la funzionalità di allineamento massivo
degli elenchi delle iscrizioni revocate degli assistiti richiamando il caso d’uso
<<include>> “ANA_UC_003 – Allineamento Iscrizioni Revocate Assistiti
4.
Il caso d’uso termina
SCENARIO PRINCIPALE
SCENARIO ERRORE
A fronte dell’esito negativo dell’operazione, l’AddOn visualizza l’errore ottenuto.
Tabella 5 - UC Specification "Allineamento Massivo Anagrafiche Assistiti"
15 of 37
4.3.2
ANA_UC_002 Allineamento Anagrafiche Assistiti Scelti
ID USE CASE
NOME USE CASE
ANA_UC_002
Allineamento Anagrafiche Assistiti Scelti
ATTORE PRINCIPALE
Medico o AddOn
ATTORI SECONDARI
AddOn, APS
DESCRIZIONE
Consente di allineare i dati anagrafici degli assistiti in carico al medico che sono già
presenti nell’archivio di cartella clinica e di registrare i dati degli assistiti di nuova
scelta aggiornati al momento della richiesta di allineamento.
PRE-CONDIZIONI
Nel client di cartella clinica sono:
POST-CONDIZIONI
1.
aggiornate le informazioni anagrafiche di dettaglio degli assistiti in carico al
medico che erano già presenti nell’archivio locale con quelle corrispondenti
ricevute dall’Anagrafe Regionale alla data corrente;
2.
registrate le informazioni anagrafiche di dettaglio degli assistiti di nuova
scelta;
3.
aggiornate le informazioni relative allo stato di integrazione dei pazienti
non presenti in Anagrafe Regionale ma presenti nell’archivio locale del
medico
1. L’AddOn avvia l’allineamento degli elenchi degli assistiti in modalità
sincrona allo startup dell’applicativo di cartella;
2.
SCENARIO PRINCIPALE
L’AddOn invia all’APS il messaggio di richiesta conforme al formato HL7v3
Patient Registry Find Candidates Query (PRPA_IN201305UV02) per
recuperare l’elenco delle anagrafiche degli assistiti in carico al medico alla
data corrente attivando il servizio indicato nello scenario “Dati anagrafici
degli assistiti aggiornati al momento della richiesta” (RFC87, par. 3.10)
3. Il caso d’uso termina
SCENARIO ALTERNATIVO 1
(ON-DEMAND)
1.1 Il medico attiva on-demand, da apposita funzionalità offerta dall’interfaccia
utente dell’AddOn, l’allineamento delle anagrafiche degli assistiti in scelta
SCENARIO ERRORE
A fronte dell’esito negativo dell’operazione (errore applicativo o di
comunicazione), l’AddOn visualizza la descrizione dell’errore restituito
Tabella 6 - UC Specification "Allineamento Anagrafiche Assistiti Scelti"
16 of 37
4.3.3
ANA_UC_003 Allineamento Iscrizioni Revocate Assistiti
ID USE CASE
NOME USE CASE
ATTORE PRINCIPALE
ATTORI SECONDARI
DESCRIZIONE
ANA_UC_003
Allineamento Iscrizioni Revocate Assistiti
Medico o AddOn
AddOn, APS
Consente di aggiornare nell’archivio locale dell’applicativo di cartella clinica i dati
relativi alle iscrizioni degli assistiti che hanno revocato la scelta del medico in un
certo intervallo temporale.
PRE-CONDIZIONI
POST-CONDIZIONI
Nel client di cartella clinica sono aggiornate le informazioni relative ai dati di
iscrizione degli assistiti che hanno revocato la scelta del medico nell’intervallo
temporale selezionato e che non risultano in scelta alla data corrente.
1. L’AddOn avvia l’allineamento dei dati relativi alle iscrizioni degli assistiti
revocati in modalità sincrona allo startup dell’applicativo di cartella clinica,
visualizzando apposita interfaccia utente per la selezione dell’intervallo
temporale inizialmente impostato con valori predefinit;
SCENARIO PRINCIPALE
2. Il medico conferma l’intervallo temporale predefinito (default con valore
iniziale ad un anno dalla data corrente e con valore finale alla data corrente)
3. L’AddOn invia all’APS il messaggio di richiesta conforme al formato HL7v3
Patient Registry Find Candidates Query (PRPA_IN201305UV02) per il
recupero dell’elenco delle iscrizioni revocate nell’intervallo temporale
selezionato invocando il servizio indicato nello scenario “Lista degli assistiti
revocati in un certo intervallo di date” (RFC87, par. 3.9 )
4. Il caso d’uso termina.
(NUOVO INTERVALLO)
(AVVIO ON-DEMAND)
(AVVIO ON-DEMAND E NUOVO
INTERVALLO)
2.1 Il medico conferma un nuovo intervallo temporale di date
1.1 Il medico avvia l’allineamento dei dati di iscrizione degli assistiti revocati
in modalità asincrona (on-demand) attraverso apposita funzionalità attivabile
dall’interfaccia utente dell’AddOn che mostra la maschera per la selezione
dell’intervallo temporale (con valori predefiniti)
1.1 Il medico avvia l’allineamento dei dati di iscrizione degli assistiti revocati in
modalità asincrona (on-demand) attraverso apposita funzionalità attivabile
dall’interfaccia utente dell’AddOn che mostra la maschera per la selezione
dell’intervallo temporale (con valori predefiniti)
2.1 Il medico conferma un nuovo intervallo temporale di date
SCENARIO ERRORE
comunicazione), l’AddOn visualizza la descrizione dell’errore restituito
Tabella 7 - UC Specification "Allineamento Iscrizioni Revocate Assistiti"
17 of 37
4.3.4
ANA_UC_004 Allineamento Puntuale Anagrafica Assistito
ID USE CASE
NOME USE CASE
ANA_UC_004
Allineamento Puntuale Anagrafica Assistito
ATTORE PRINCIPALE
Medico o AddOn
ATTORI SECONDARI
AddOn, APS
DESCRIZIONE
Consente di allineare i dati anagrafici e le esenzioni dal ticket per reddito
e/o le fasce di reddito relative ad un soggetto anagrafico assistito con le
corrispondenti informazioni presenti in Anagrafe regionale.
PRE-CONDIZIONI
L’assistito ha fornito il proprio consenso al trattamento dei dati personali.
POST-CONDIZIONI
Nel client di cartella clinica sono aggiornate le informazioni anagrafiche e le
esenzioni dal ticket e/o fascia di reddito dell’assistito selezionato.
1. Il medico attiva la funzione di apertura della scheda relativa ad un paziente
presente nell’archivio locale dell’applicativo di cartella clinica attraverso
apposita interfaccia utente.
SCENARIO PRINCIPALE
2. L’AddOn attiva automaticamente la funzionalità di aggiornamento puntuale
della scheda anagrafica del paziente selezionato richiamando il caso d’uso
<<include>> “ANA_UC_005 – Identificazione Soggetto Assistito”
3. L’AddOn attiva automaticamente la funzionalità di consultazione puntuale
delle esenzioni dal ticket per reddito e/o della fascia di reddito dell’assistito
identificato al passo precedente richiamando il caso d’uso <<include>>
“TCK_UC_001– Consultare posizione ticket”
4. Lo use case termina
(ON-DEMAND)
2.1 Il medico attiva on-demand da apposita funzionalità offerta dall’interfaccia
utente dell’AddOn la funzionalità di allineamento puntuale dei dati anagrafici
dell’assistito selezionato.
SCENARIO ERRORE
comunicazione), l’AddOn visualizza la descrizione dell’errore ottenuto
Tabella 8 - UC Specification "Allineamento Puntuale Anagrafica Assistito"
18 of 37
4.3.5
ANA_UC_005 Identificazione Soggetto Assistito
ID USE CASE
NOME USE CASE
ATTORE PRINCIPALE
ATTORI SECONDARI
ANA_UC_005
Identificazione Soggetto Assistito
AddOn
APS
Consente di allineare i dati anagrafici relativi a un soggetto assistito con le
corrispondenti informazioni presenti in Anagrafe Regionale.
DESCRIZIONE
PRE-CONDIZIONI
L’AddOn dispone dei tratti anagrafici dell’assistito da identificare (Codice Fiscale o
parametri di input quali nome, cognome, sesso, e data di nascita dell’assistito)
POST-CONDIZIONI
L’AddOn riceve in risposta dall’APS un messaggio nel formato HL7v3 Person Registry Find
Candidates Query Response (PRPA_IN101306UV02) contenente il dettaglio anagrafico del
soggetto e l’identificativo univoco (ID Universale).
1. L’AddOn invia all’APS il messaggio di richiesta conforme al formato HL7v3 Person Registry
SCENARIO PRINCIPALE
2.
Find Candidates Query (PRPA_IN101305UV02) compilando la richiesta con il codice fiscale
del paziente al fine di recuperare le informazioni anagrafiche e l’identificativo univoco
regionale (ID Universale) del soggetto assistito mediante attivazione del servizio indicato
nello scenario “Ricerca Soggetto per tratti anagrafici acquisiti”(RFC85, par. 3.3).
Lo use case termina
1.
SCENARIO ERRORE 1
SCENARIO ERRORE 2
SCENARIO ERRORE 3
SCENARIO ERRORE 4
All’attivazione del servizio, l’AddOn ottiene un errore applicativo sulla correttezza
delle informazioni in input (ad es.: codice fiscale non corretto”)
2. L’AddOn invia all’APS il messaggio conforme al formato HL7v3 Person Registry Find
Candidates Query (PRPA_IN101305UV02) compilando la richiesta con i parametri di
input: [nome, cognome, sesso, data di nascita] al fine recuperare il dettaglio
anagrafico e l’identificativo univoco regionale (ID Universale) del soggetto assistito
mediante attivazione del servizio indicato nello scenario “Ricerca Soggetto per tratti
anagrafici acquisiti” (RFC85, par. 3.3).
1. All’attivazione del servizio, l’AddOn verifica che nella scheda dell’assistito presente
nell’archivio locale del medico non è memorizzato il codice fiscale del soggetto da
identificare
2. L’AddOn invia all’APS il messaggio conforme al formato HL7v3 Person Registry Find
Candidates Query (PRPA_IN101305UV02) compilando la richiesta con i parametri di
input: [nome, cognome, sesso, data di nascita] al fine recuperare il dettaglio
anagrafico e l’identificativo univoco regionale (ID Universale) del soggetto assistito
mediante attivazione del servizio indicato nello scenario “Ricerca Soggetto per tratti
anagrafici acquisiti” (RFC85, par. 3.3).
Il medico non dispone dei dati sufficienti per l’invocazione del servizio (assenza
contemporanea del codice fiscale e di almeno uno dei 4 parametri di input). Il servizio
visualizza all’utente un messaggio inerente l’impossibilità di richiedere
l’identificazione dell’assistito.
Il medico dispone di dati errati per l’invocazione del servizio (codice fiscale e almeno
uno dei 4 parametri di input non corretti). Il servizio visualizza all’utente un messaggio
inerente l’impossibilità di richiedere l’identificazione dell’assistito.
Il medico ha dati errati/assenti per l’invocazione del servizio (codice fiscale assente e
almeno uno dei 4 parametri di input non corretti). Il servizio visualizza all’utente un
messaggio inerente l’impossibilità di richiedere l’identificazione dell’assistito.
Il medico ha dati assenti/errati per l’invocazione del servizio (codice fiscale assente e
almeno uno dei 4 parametri di input non corretti). Il servizio visualizza all’utente un
messaggio inerente l’impossibilità di richiedere l’identificazione dell’assistito.
Tabella 9 - UC Specification "Identificazione Soggetto Assistito"
19 of 37
4.3.6
ANA_UC_006 Identificazione Soggetto Medico
Si osserva che questo use case non è oggetto delle sessioni di collaudo, ma è ugualmente specificato per
completezza espositiva al fine di verificare la presenza dei dati obbligatori dei medici richiesti dalle
specifiche d’integrazione ai servizi CSE laddove gli scenari lo richiedano.
ID USE CASE
NOME USE CASE
ANA_UC_006
Identificazione Soggetto Medico
ATTORE PRINCIPALE
AddOn
ATTORI SECONDARI
APS
DESCRIZIONE
PRE-CONDIZIONI
POST-CONDIZIONI
SCENARIO PRINCIPALE
Consente di identificare il soggetto richiedente, abilitato all’accesso ai
servizi del Sistema Regionale ad uso dei medici convenzionati, al fine di
ottenere l’identificativo univoco (ID Universale).
L’AddOn dispone del codice fiscale del soggetto Medico.
Nel client di cartella clinica sono registrate le informazioni relative
all’identificativo univoco regionale del soggetto Medico (ID Universale)
ricevuto dall’APS nel messaggio di risposta nel formato HL7v3 Person
Registry Find Candidates Query Response (PRPA_IN101306UV02)
1. L’AddOn invia all’APS il messaggio di richiesta conforme al formato HL7v3
Person Registry Find Candidates Query (PRPA_IN101305UV02) al fine di
identificare il medico e recuperare l’identificativo univoco regionale (ID
Universale) invocando il servizio indicato nello scenario “Ricerca Soggetto per
tratti anagrafici acquisiti” (RFC85, par. 3.3)
SCENARIO ERRORE
Tabella 10 - UC Specification "Identificazione Soggetto Medico
20 of 37
4.3.7
NRE_UC_001 Richiesta Assegnazione Lotto NRE
ID USE CASE
NOME USE CASE
NRE_UC_001
Richiesta Assegnazione Lotto NRE
ATTORE PRINCIPALE
AddOn
ATTORI SECONDARI
Medico, APS
DESCRIZIONE
Consente di richiedere al Sistema Regionale l’assegnazione di un nuovo
lotto di NRE da utilizzare nel processo prescrittivo.
PRE-CONDIZIONI
L’AddOn dispone del codice fiscale del medico.
POST-CONDIZIONI
Nel client di cartella clinica sono registrate le informazioni relative al lotto di NRE
ricevuto dall’APS.
1. In base alla temporizzazione configurata, l’AddOn avvia la funzionalità di
controllo in background della disponibilità di NRE nell’archivio locale
dell’applicativo di cartella e verifica che il numero di NRE risulti inferiore ad
una certa soglia predefinita e configurabile (ad. Es.: <300).
SCENARIO PRINCIPALE
2. L’AddOn invia all’APS un messaggio di richiesta per l’assegnazione di un nuovo
lotto di NRE conforme al formato RichiestaNreMessage contenente
l’identificativo univoco del messaggio, il codice fiscale del medico richiedente,
la data della richiesta e la quantità di NRE da assegnare invocando
l’operazione GestioneAssegnazioneNre del servizio GestioneNreService come
descritto nella specifica RFC207.
1.1 Il medico compila e stampa una prescrizione. L’AddOn verifica
l’assenza di disponibilità di NRE nell’archivio locale dell’applicativo di cartella
clinica
Tabella 11 - UC Specification "Richiesta Assegnazione Lotto NRE"
21 of 37
4.3.8
NRE_UC_002 Ripristino NRE Assegnati e non ancora utilizzati.
ID USE CASE
NOME USE CASE
NRE_UC_002
Ripristino NRE assegnati e non ancora utilizzati
ATTORE PRINCIPALE
Medico, AddOn
ATTORI SECONDARI
APS
DESCRIZIONE
Consente di richiedere al Sistema Regionale l’elenco degli NRE assegnati e
non ancora utilizzati da utilizzare nel processo prescrittivo.
PRE-CONDIZIONI
Il medico ha perso gli NRE a causa di un crash di sistema, di una cancellazione
accidentale, ecc..
POST-CONDIZIONI
Nel client di cartella clinica sono registrate le informazioni relative all’elenco di NRE
assegnati e non ancora utilizzati ricevuto dall’APS.
1. Il medico avvia nella finestra delle impostazioni avanzate dell’ AddOn la richiesta
di allineamento degli NRE assegnati.
SCENARIO PRINCIPALE
2. L’AddOn invia all’APS un messaggio di consultazione di tutti gli NRE assegnati
conforme al formato QueryNreReqTNREMessage contenente l’identificativo
univoco del messaggio, il codice fiscale del medico richiedente e la data della
richiesta invocando l’operazione QueryNreTNRE del servizio GestioneNreService
come descritto nella specifica RFC207.
PRE-CONDIZIONI
Il medico prescrittore ha superato il limite di NRE assegnabili per singolo medico
ed è inibito alla richiesta di ulteriori NRE
PRE-CONDIZIONI
Il medico prescrittore ha compilato almeno una prescrizione da una postazione
differente da quella attuale, sulla quale ha effettuato un allineamento degli NRE
Tabella 12 - UC Specification "Ripristino NRE Assegnati e non ancora utilizzati"
22 of 37
4.3.9
TCK_UC_001 Consultazione Posizione Ticket
ID USE CASE
NOME USE CASE
TCK_UC_001
Consultazione Posizione Ticket
ATTORE PRINCIPALE
AddOn
ATTORI SECONDARI
APS
DESCRIZIONE
PRE-CONDIZIONI
Consente di recuperare dal Sistema Regionale le informazioni di esenzione
dal ticket per reddito e/o le fasce di reddito relative ad un assistito.
1. L’AddOn dispone del codice fiscale dell’assistito del quale deve recuperare le
informazioni di esenzione dal ticket per reddito e/o le fasce di reddito
2. L’AddOn dispone del codice fiscale del soggetto Medico.
POST-CONDIZIONI
SCENARIO PRINCIPALE
L’AddOn riceve in risposta dall’APS un messaggio nel formato
ConsultaPosizioneTicketResponse o ConsultaFasciaReddito contenente, se
presente, l'eventuale codice di esenzione da reddito del cittadino o, in alternativa,
la fascia di reddito di appartenenza individuata a partire dal reddito familiare
fiscale o da ISEE.
1. L’AddOn invia all’APS il messaggio di richiesta conforme al formato
ConsultaPosizioneTicketRequest compilando la richiesta con il codice fiscale
del paziente, il codice fiscale del medico richiedente e un codice di ricetta
dummy al fine di recuperare le informazioni di esenzione dal ticket per reddito
e/o le fasce di reddito mediante attivazione del servizio indicato nello scenario
“Consultazione Posizione Ticket”(RFC198, par. 2.2.1).
2. L’AddOn riceve un messaggio di risposta nel formato
ConsultaPosizioneTicketResponse contenente l’esenzione associata
all’assistito.
3. Lo use case termina
SCENARIO ALTERNATIVO
SCENARIO ERRORE
2.1 L’AddOn riceve un messaggio di risposta nel formato
ConsultaFasciaReddito contenente la fascia di reddito di appartenenza
dell’assistito
Tabella 13 - UC Specification "Consultazione Posizione Ticket"
23 of 37
4.3.10 PRS_UC_001 Invio Prescrizione
ID USE CASE
NOME USE CASE
ATTORE PRINCIPALE
ATTORI SECONDARI
DESCRIZIONE
PRE-CONDIZIONI
POST-CONDIZIONI
SCENARIO PRINCIPALE
SCENARIO ERRORE 1
SCENARIO ERRORE 2
SCENARIO ERRORE 3
SCENARIO ERRORE 4
PRS_UC_001
Invio Prescrizione
Medico o AddOn
AddOn, APS
Consente di inviare nuove prescrizioni al Sistema Regionale.
L’operatore sanitario è il medico scelto o il medico associato / sostituto.
La prescrizione è stampata ed il Sistema Regionale fornisce un messaggio di conferma
dell’avvenuto invio della prescrizione.
1. Il medico apre la scheda del paziente per cui compilare una prescrizione.
2. L’AddOn richiama il caso d’uso <<include>> “ANA_UC_004 – Allineamento Puntuale
Anagrafica Assistito”
3. Il medico compila una prescrizione per l’assistito selezionato, conferma i dati inseriti
nell’apposita interfaccia utente e avvia il processo di stampa;
4. L’AddOn verifica nell’archivio locale la presenza dell’ID Universale del paziente per cui
erogare la prescrizione;
5. L’AddOn verifica nell’archivio locale la presenza dell’ID Universale del medico che
eroga la prescrizione;
6. L’AddOn verifica nell’archivio locale la disponibilità di almeno un NRE da utilizzare;
7. L’AddOn produce la prescrizione nel formato HL7v3 – CDA v2.0 conforme alle
specifiche definite nella RFC161 che può visualizzare al medico prima dell’invio;
8. Il medico attiva la funzionalità dall’interfaccia utente che invia la prescrizione nella
coda dei documenti da inviare (“IN USCITA”);
9. In base alla temporizzazione configurata, l’AddOn invia all’APS il messaggio di richiesta
invocando il servizio RCMR_AR000003UV02_ RCMR_IN000002UV02 definito dalla
RFC123;
10. A fronte dell’esito positivo dell’operazione, l’AddOn aggiorna il LOG dei documenti
“INVIATI”;
4.1 L’AddOn attiva lo use case <<extends>> “ANA_UC_005 – Identificazione Soggetto
Assistito” per il recupero dell’ID Universale;
Medico” per il recupero dell’ID Universale;
6.1 L’AddOn attiva lo use case <<extends>> “NRE_UC_001 – Richiedere assegnazione
lotto NRE” per una nuova assegnazione di un lotto NRE (Scenario Alternativo 1)
9.1 Il medico seleziona la prescrizione dai documenti “IN USCITA” ed attiva la
funzionalità dell’interfaccia per l’invio sincrono all’APS che invoca il servizio
RCMR_AR000003UV02_RCMR_IN000002UV02 definito dalla RFC123.
A fronte dell’esito negativo dell’operazione (errore applicativo o di comunicazione),
l’AddOn aggiorna il LOG dei documenti “INVII FALLITI”.
A fronte di una situazione di OFF-LINE, lo stato dei documenti persiste nel LOG
“IN USCITA”
A fronte della mancanza di almeno uno dei seguenti dati fondamentali:
• ID Universale del paziente per cui erogare la prescrizione;
• ID Universale del medico che eroga la prescrizione;
• NRE da utilizzare per la prescrizione erogata;
al medico prescrittore viene proposto di annullare la stampa perché non sarà
possibile creare la prescrizione elettronica secondo il formato HL7v3 – CDA v2.0
A fronte dell’esito negativo dell’operazione per “NRE non assegnato al medico” o
per “NRE già utilizzato”, l’AddOn aggiorna il LOG dei documenti “INVII FALLITI”.
Tabella 14 - UC Specification "Invio Prescrizione"
24 of 37
4.3.11 PRS_UC_002 Annullamento Prescrizione
ID USE CASE
NOME USE CASE
PRS_UC_002
Annullamento Prescrizione
ATTORE PRINCIPALE
Medico
ATTORI SECONDARI
AddOn, APS
DESCRIZIONE
Consente di annullare una prescrizione precedentemente inviata al
Sistema Regionale.
PRE-CONDIZIONI
POST-CONDIZIONI
Il Sistema Regionale fornisce un messaggio di conferma dell’avvenuto
annullamento della prescrizione.
1. Il medico attiva la ricerca della prescrizione da annullare tra quelle già inviate
all’APS impostando il filtro fornito dall’interfaccia utente e avvia il processo di
annullamento
SCENARIO PRINCIPALE
2. L’AddOn produce il messaggio di annullamento e invoca il servizio
RCMR_AR000004UV01_RCMR_IN000023UV02 definito nella RFC123.
3. A fronte dell’esito positivo dell’operazione, l’AddOn aggiorna il LOG dei
documenti “ANNULLATI”;
SCENARIO ERRORE
Tabella 15 - UC Specification "Annullamento Prescrizione"
25 of 37
4.3.12 PSS_UC_001 Invio Patient Summary
ID USE CASE
NOME USE CASE
ATTORE PRINCIPALE
ATTORI SECONDARI
DESCRIZIONE
PRE-CONDIZIONI
POST-CONDIZIONI
SCENARIO PRINCIPALE
SCENARIO ERRORE 1
SCENARIO ERRORE 2
SCENARIO ERRORE 3
PSS_UC_001
Invio Patient Summary
Medico, AddOn
AddOn, APS
Consente di inviare al Sistema Regionale le informazioni di Patient
Summary relative ad un assistito
Il Sistema Regionale fornisce un messaggio di conferma dell’avvenuta registrazione del
documento di Patient Summary che l’AddOn rende disponibile all’utente.
1. Il medico apre la scheda del paziente e attiva la funzionalità di invio PS
2. L’AddOn verifica nell’archivio locale la presenza dell’ID Universale del paziente per cui
erogare la prescrizione;
3. L’AddOn verifica nell’archivio locale la presenza dell’ID Universale del medico che
eroga la prescrizione;
4. L’AddOn presenta all’utente l’interfaccia per la selezione delle sezioni del PS da inviare
(allo stato, l’AddOn considera in default solo le sezioni OBBLIGATORIE non
modificabili);
5. Il medico conferma l’invio delle sezioni OBBLIGATORIE predefinite;
6. L’AddOn recupera le informazioni dall’archivio locale e produce il documento di PS nel
formato HL7v3 – CDA v2.0 conforme alle specifiche definite nella RFC133 che visualizza
all’utente;
7. Il medico verifica la correttezza dei dati visualizzati e attiva la funzionalità
dall’interfaccia utente che registra il PS nella coda dei documenti da inviare (“IN
USCITA”);
8. In base alla temporizzazione configurata, l’AddOn invia all’APS il messaggio di richiesta
invocando il servizio Evento Clinico One-Way riferito nella RFC133;
9. A fronte dell’esito positivo dell’operazione, l’AddOn aggiorna il LOG dei documenti
“INVIATI”;
6.1 Il medico seleziona il PS dai documenti “IN USCITA” ed attiva la funzionalità
dell’interfaccia per l’invio all’APS che invoca il servizio Evento Clinico One-Way definito
nella RFC133
5.1 Il medico verifica i dati del PS visualizzati ed attiva la funzionalità dall’interfaccia
utente di Annullamento Invio
Assistito” per il recupero dell’ID Universale;
Medico” per il recupero dell’ID Universale;
A fronte dell’esito negativo dell’operazione (errore applicativo o di comunicazione),
l’AddOn aggiorna il LOG dei documenti “INVII FALLITI”
A fronte di una situazione di OFF-LINE, lo stato dei documenti persiste nel LOG “IN
USCITA”
A fronte della mancanza di almeno uno dei seguenti dati fondamentali:
• ID Universale del paziente per cui erogare la prescrizione;
• ID Universale del medico che eroga la prescrizione;
al medico verrà visualizzato un errore con la descrizione dell’errore occorso
durante il recupero del dato mancante.
Tabella 16 - UC Specification "Invio Patient Summary"
26 of 37
5
Scenari di Cooperazione
Di seguito i diagrammi di sequenza dei casi d‘uso presentati nella sezione precedente.
5.1
Allineamento Massivo Anagrafiche Assistiti (ANA_UC_001)
sd ANA_UC_001 Allineamento Massiv o Anagrafiche Assis...
Ap p licati vo
Ge stio ne Stu di o
M e dico
M e dico
Ad dOn CSE
sta rtu p ()
a vvia Ad d On ()
«Al li n ea m e nto An ag ra fiche Assistiti» In clud e: e se cu zion e A NA_ UC_ 00 2 ()
alt Dati Anagrafici
[Ok]
«Ag g i orn am en to An ag ra fiche »
[Erro r]
Visu ali zza m e ssa g gi o e rro re()
«A l lin eam e nto Iscri zi on i Re vo cate A ssi stiti » In clu d e: ese cuzio ne ANA_ UC_ 00 3()
alt Dati Iscrizioni Rev ocate
[Ok]
«Ag gi orn am en to Iscrizio ni Re vo ca te »
[Erro r]
Visua lizza m e ssag gi o e rro re ()
Figura 7 - UML Sequence Diagram "Allineamento Massivo Anagrafiche Assistiti"
27 of 37
5.2
Allineamento Anagrafiche Assistiti Scelti (ANA_UC_002)
sd ANA_UC_002 Allineamento Anagrafiche/Esenzioni Assistiti Scelti
DataB a se
M ed i co
AP S
A dd On CS E
opt Av v io Allineamento
[M od al ità sch ed ul ata i n b ackgro un d]
P atie nt Re gistry Fi nd Can di da tes Qu ery (PRPA _ IN20 1306UV02 )
«re que st»
[M od al ità o n-de m an d]
Ri chi ed ere Al l in ea m en to An agra fi ch e()
Pa ti e nt Reg istry Fi nd Can di da tes Qu ery (PRP A_IN2 01 30 5UV 02 )
«re que st»
alt Esito
[P osi ti vo ]
P ati en t Re gi stry Fin d Ca ndi d ates Que ry Respo nse(PRP A _ IN201 30 6UV 02 )
«A cqu isi zi on e El en co A ssi sti ti »
E le nco Assi sti ti DB Lo cal e ()
Con fro nto El e nco A ssi sti ti A P S vs. DB l o cal e ()
loop Per ogni paziente rilev ato dalla fase di confronto
opt Inserimento
Inseri m en to Dati Nuo vo P azie nte()
opt Aggiornamento
A gg iorna m en to Dati Pazie nte Esi ste nte()
opt Non Integrato
Ri le va zion e P azi en te Non In te grato()
[Neg ati vo ]
A ccep t Ack(M CCI_IN00 00 02 UV0 1)
Gestio ne M essa ggi o E rro re ()
V isua l izza m essa ggi o e rro re ()
Figura 8 - UML Sequence Diagram "Allineamento Anagrafiche Assistiti Scelti"
28 of 37
5.3
Allineamento Iscrizioni Revocate Assistiti (ANA_UC_003)
sd ANA_UC_003 Allineamento Iscrizioni Rev ocate Assis...
Ad d O n CS E
Da ta Ba se
APS
M e d i co
opt Av v io Allineamento
[M o d al ità sch e d u la ta in b a ckg ro u n d ]
In te rfa ccia Se l ezi o ne In te rva llo T e m p o ral e ()
Co n fe rm a S e le zio n e In te rva ll o T e m p o ra le ()
alt Esito
V e ri fi ca Di sp o n ib il ità El e n co An a g ra fich e A ssi sti ti S cel ti ()
[P ositivo ]
[Neg a tivo ]
In clu d e (E se cu zio n e A NA _ UC_ 0 0 2)
«A g g io rn a m e n to A na g rafich e »
Pa ti e nt Re g istry Fi n d Can d i da te s Q ue ry(P RP A_ IN2 0 1 3 0 5 UV 0 2)
« Ri ce rca A ssi sti ti Re vo ca ti»
[M o d al ità o n d -d e m a n d ]
Rich i ed e re Al li n ea m en to Iscrizi o n i Re vo cate ()
Il SD ri pro p on e il b lo cco d e l m e d e sim o fra gm e nt "M o da l ità sch e d ul a ta i n b a ckg ro u n d "
alt Esito
[P ositivo ]
Pa tie n t Re g istry Fin d Ca n di d a te s Q u e ry Re sp o n se (P RP A_ IN2 0 1 3 0 6 UV 0 2 )
Co n fro n to El e n co Assistiti Re vo ca ti vs A ssi sti ti S ce lti ()
loop Per ogni paziente Rev ocato rilev ato dalla fase di confronto
opt Non Presente su DB Locale
« Ig no ra »
opt Presente su DB Locale
alt
[NO N PRE SE NT E i n El e n co Assistiti Sce lti d a AP S]
A ll in e a Revo ca Iscri zio n e P iù Re ce n te ()
[PRESE NT E i n El e n co Assistiti Sce lti d a APS ]
« Ig no ra »
[Neg ativo ]
Acce p t Ack (M CCI_ IN0 0 0 0 02 UV0 1 )
V isu a li zza M e ssa g g io Erro re ()
Figura 9 - UML Sequence Diagram "Allineamento Iscrizioni Revocate Assistiti"
29 of 37
5.4
Allineamento Puntuale Anagrafica Assistito (ANA_UC_004)
sd ANA_UC_004 Allineamento Puntuale Anagrafica Assistito
Ap pli cati vo Ge sti on e
S tudi o M e di co
Add On CSE
M e dico
opt Av v io Allineamento Puntuale
[A pe rtura S cheda Pa zi en te]
alt Esito
[P osi ti vo]
A p rire Sched a Pazie nte()
A vvi o Al l inea m ento P untua le Ana grafi ca Assi sti to()
In cl ud e: Ide nti fi ca zi on e S ogge tto A ssi sti to (ANA _ UC_ 005 )
Inclu de : Co nsul ta re Posizio ne T icke t (T CK_ UC_ 001)
[M oda l ità on -dem a nd ]
A lli nea re A nagrafi ca A ssi sti to()
Incl ud e: Id enti ficazi on e So gge tto A ssistito (ANA_ UC_00 5)
Inclu de: Con sulta re P osizio ne T i cket (T CK_ UC_ 001 )
[Negati vo]
Vi sual i zza M essa ggi o E rrore()
Figura 10 - UML Sequence Diagram "Allineamento Puntuale Anagrafica Assistito"
30 of 37
5.5
Identificazione Soggetto Assistito (ANA_UC_005)
sd ANA_UC_005 Identificazione Soggetto Assistito
Da taBase
APS
A ddO n CSE
Perso n Re gistry Fin d Ca ndid ate s Query(PRPA_ IN101 30 5UV02 )
«req uest»
alt Esito
[Po sitivo]
Person Reg istry Fin d Can did ates Query Respo nse(PRPA_IN1013 06UV02 )
« respo nse»
Registra Da ti An agra fici Assistito ()
[Ne gati vo ]
Accept Ack(M CCI_IN0 000 02UV0 1)
Gestion e M essagg io Errore ()
Figura 11 - UML Sequence Diagram "Identificazione Soggetto Assistito"
5.6
Identificazione Soggetto Medico (ANA_UC_006)
sd ANA_UC_006 Identificazione Soggetto Medi...
DataBa se
AP S
Add On CS E
Pe rson Re gi stry Fi nd Cand id a te s Qu ery(P RP A_ IN1 01 3 05UV0 2 )
«req u est»
alt Esito
[P o sitivo]
P e rso n Reg istry Fin d Can di da te s Que ry Respon se (PRPA_ IN10 1 30 6 UV0 2)
« resp o nse»
Reg istra ID Un iversa le ()
[Ne gati vo ]
Acce pt Ack (M CCI_ IN00 0 00 2 UV0 1)
Gestio n e M essagg io Errore()
Figura 12 - UML Sequence Diagram "Identificazione Soggetto Medico"
31 of 37
5.7
Richiesta Assegnazione Lotto NRE (NRE_UC_001)
sd NRE_UC_001 Richiesta Assegnazione Lotto NRE
Da taBase
AP S
A dd On CSE
Ve rifi ca disp onib ilità NRE ()
Resu lt DB Loca le ()
opt NRE
[NRE < 3 00]
G esti on eNre Servi ce_ Ge sti on eAsseg nazi on eNre(RichiestaNreM e ssage)
« re quest»
G estio neNreSe rvice_ Gestion eA ssegna zio neNre(Ri spostaNre M essag e)
« re sponse »
Registra zione lotto NRE ()
Figura 13 - UML Sequence Diagram "Richiesta Assegnazione Lotto NRE"
5.8
Ripristino NRE Assegnati e non ancora utilizzati (NRE_UC_002)
sd NRE_UC_002 Ripristino NRE Assegnati e non ancora utilizzati
AddOn CSE
Da taBase
A PS
M edico
Richi ede re ripristin o NRE()
Gesti oneNreService_ Qu eryNreT NRE(QueryNreReqT NREM essage)
«Ri chi esta co nsul tazi one NRE assegnati»
alt Esito
GestioneNreSe rvi ce_ QueryNreT NRE(Que ryNreResT NREM essage)
[Ok]
Aggi orna m en to DB l oca le()
«Ripristin o NRE a sse gnati»
[Error]
Excepti o nResponse()
re turn()
« response »
Figura 14- UML Sequence Diagram "Ripristino NRE Assegnati e non ancora utilizzati"
32 of 37
5.9
Consultazione Posizione Ticket (TCK_UC_001)
sd TCK_UC_001 Consultazione Posizione Ticket
DataBase
AP S
A ddOn CSE
Co nsultaP osizio neT icket (Requ est)
Co nsul taPosi zi on eT i cket (Response)
opt Esito
[E se nzi oni S IS]
Ag giorna E se nzi oni T i cke t()
[FasciaRed dito]
Agg iorn a Fasci aRed di to ()
[E rrore ]
Gesti one M e ssa ggi o Erro re()
Figura 15 - UML Sequence Diagram "Consultazione Posizione Ticket"
33 of 37
5.10 Invio Prescrizione (PRS_UC_001)
sd PRS_UC_001 Inv io Prescrizio...
A p p li ca ti vo
G e st i o n e S t u d i o
M e d ico
M e d i co
A d d O n CS E
D a t a B a se
APS
A p ri re S ch e d a P a z i e n t e ()
I n c l u d e (E se c u z i o n e A NA _ UC _ 0 0 4 )
« A l l i n e a m e n t o P u n tu a l e A n a g ra f i ca A ssi sti t o »
Co m p i l a re (P re sc ri zi o n e )
Co n f e rm a re (P re sc ri zi o n e )
S t a m p a (P re sc ri z i o n e )
alt Dati Prescrizione
E l a b o ra D a ti P re sc ri z i o n e p e r I n vi o ()
[ O k]
I n c l u d e : V e ri f i c a D a t i A ssi st i to ()
alt Dati Assistito
[ p re se n z a d a ti a ssi st i t o d b l o ca l e ]
re t u rn () : I D U n i v e rsa l e
[ i d e n t i fi ca re a ssi st i t o ]
E x t e n si o n : (E se c u z i o n e A N A _ U C_ 0 0 5 )
« Id e n t i fi ca z i o n e S o g g e tt o A ssi st i to »
In cl u d e V e ri fi c a D a t i M e d i c o ()
alt Dati Medico
[ p re se n z a d a ti m e d i c o d b l o c a l e ]
re t u rn () : I D Un i v e rsa l e
[ i d e n t i fi ca re m e d i c o ]
E x t e n si o n : (E se c u z i o n e A N A _ U C _ 0 0 6 )
« Id e n t i f i ca z i o n e S o g g e tt o M e d i c o »
In cl u d e : V e ri f i c a d i sp o n i b i l i tà N R E ()
alt Dati NRE
[ E si ste a l m e n o 1 N RE ]
re t u rn () : NR E
[ A sse n z a N RE ]
G e st i o n e N re S e rvi c e _ G e st i o n e A sse g n a z i o n e Nre (R i ch i e st a N re M e ssa g e )
« re q u e st »
G e st i o n e N re S e rv i ce _ G e st i o n e A sse g n a zi o n e Nre (Ri sp o st a N re M e ssa g e )
« re sp o n se »
alt Esito richiesta lotto NRE
[A sse g n a z i o n e l o t t o NR E ]
R e g i stra zi o n e D a ti l o tt o N R E ()
[N u m . M a x N RE A sse g n a b i l i ]
« R i p ri st i n o NR E » E x te n si o n ((E se cu z i o n e NR E _ U C_ 0 0 2 ))
[ E x i t E rro r ]
E rro re E l a b o ra z i o n e D a t i P re sc ri zi o n e ()
In te rf a cc i a A n n u l l a m e n t o P re sc ri z i o n e ()
C o n f e rm a A n n u l l a m e n t o ()
« d e st ro y »
V i su a l i z za P re sc ri z i o n e ()
opt
[ co n fe rm a i n vi o ]
C o n fe rm a In v i o ()
P ro d u c i d o c u m e n t o e a cc o d a i n d o cu m e n t i I N U S C I T A (P re scri z i o n e )
[a n n u l la i n vi o ]
A n n u l l a I n vi o ()
re t u rn ()
opt Inv io Documento Clinico
[M o d a l i tà sc h e d u l a ta i n b a ckg ro u n d [ d e f a u l t ]]
R CM R _ A R 0 0 0 0 0 3 U V 0 2 _ R C M R _ I N 0 0 0 0 0 2 U V 0 2 (R C M R _ I N0 0 0 0 0 2 U V 0 2 )
« re q u e st »
A c ce p t A c k(M CC I_ IN 0 0 0 0 0 2 U V 0 1 )
alt Esito
[ O k]
« re sp o n se »
S c ri t t u ra L O G D o c u m e n t i IN V I A T I ()
V i su a l i z z a e si to p o si t i vo ()
[ E rro r]
A cc e p t A c k(M C C I _ I N 0 0 0 0 0 2 U V 0 1 )
S c ri t tu ra L O G I N V I I FA L L I T I ()
V i su a l i z z a e si to n e g a t i v o ()
[ O f f -l i n e ]
S cri t t u ra L O G D o c u m e n ti DA I N V I A R E ()
V i su a l i zz a a l e rt o ff -l i n e ()
[M o d a l i tà o n -d e m a n d ]
In te rfa c c i a l i sta d o c u m e n t i I N U S C IT A ()
S e l e z i o n e d o c u m e n t o P re sc ri zi o n e ()
C o n f e rm a I N V IA O R A ()
RC M R_ A R0 0 0 0 0 3 U V 0 2 _ R CM R _ IN 0 0 0 0 0 2 U V 0 2 (RC M R_ I N0 0 0 0 0 2 U V 0 2 )
I l S D p ro se g u e n e l l a va l u t a zi o n e d e l l a ri sp o st a d a l l 'A P S c o m e d a F ra g m e n t " a l t E si t o M o d a l i t à sc h e d u l a t a i n
b a c kg ro u n d " . P e r se m p l i ci t à e sp o si t i v a , n o n so n o i n d i c a t e l e a l t re o p e ra z i o n i o p zi o n a l i d e l l 'i n te rf a c ci a
d e l l 'A d d O n : " V i su a l i zz a Do c u m e n to S e l e z i o n a t o " , " E l i m i n a D o c u m e n t o " , " A g g i o rn a L i st a D o c u m e n t i "
Figura 16 - UML Sequence Diagram "Invio Prescrizione"
34 of 37
5.11 Annullamento Prescrizione (PRS_UC_002)
sd PRS_UC_002 Annullamento Prescrizione
Add On CSE
DataBase
APS
M edico
Im posta Fi ltro per Ri cerca Prescri zio ne da An nul l are()
Ricerca Pre scrizione()
re tu rn()
Rich iesta Annullam ento()
RCM R_AR000004UV01 _RCM R_IN000023UV02 (RCM R_IN0 000 23UV02)
«request»
alt Esito
RCM R_AR000004UV01_RCM R_IN000 023 UV02(M CCI_IN000002UV01)
[Ok]
«response»
Scrittura Stato LOG Docum e nti ANNULLAT I()
Visu ali zzazi one M essaggio Esito Positivo ()
[Error]
Gesti one Errore()
Vi sualizzazio ne M essaggi o Esi to Negati vo()
Figura 17 - UML Sequence Diagram "Annullamento Prescrizione"
Prevedere an nul l am ento prescrizi one non ancora i nviata?
35 of 37
5.12 Invio Patient Summary (PSS_UC_001)
sd PSS_UC_001 Inv io Patient Summ...
AddO n CSE
DataB ase
AP S
M edico
A pri re Scheda Pazie nte()
A tti vare Invi o P ati ent S um m ary()
Incl ude: Verifica Dati Assi stito()
alt Dati Assistito
[p resen za dati assisti to db locale]
return () :ID Uni ve rsale
[id entifi care a ssistito ]
Extensio n:(Ese cuzio ne ANA_UC_005)
Incl ude: Veri fi ca Dati M ed ico()
alt Dati Medico
[p resen za dati m ed ico d b l oca le]
return () :ID Uni ve rsale
[id entifi care m edi co]
Exten sion:(Esecuzione ANA _UC_ 006)
Interfaccia selezione sezi oni P atien t Su m m ary()
Co nferm a sezi oni P atient Sum m ary()
Acqui sizion e Dati Pati ent Su m m ary()
retu rn()
Visu ali zza Pati ent S um m ary()
opt
[conferm a]
Conferm a In vi o Docum e nto()
P roduci docum ento e accoda i n do cum enti IN USCIT A(Pa tientSum m ary)
[an nulla invio]
An nulla Invio Docu m en to()
retu rn()
opt Inv io Documento Clinico
[M odali tà sch edula ta in background [default]]
Even toCli nico_InvioE ve n to(PatientSu m m ary)
« req ue st»
alt Esito
[Ok]
Eve ntoClini co(Ack)
«resp onse»
Scri ttura L OG Docum e nti INVIAT I()
V isualizzazion e esito po sitivo()
[Erro r]
Faul tE ven toClinico(Faul tM essa ge)
«resp onse»
Scri ttura LOG INVII FALLIT I()
V isual izzazione esito negati vo()
[Off-l ine ]
S crittura LOG Docu m enti DA INV IA RE()
Visua li zzazi one al ert o ff-l ine ()
[M odali tà on-dem a n d]
Interfaccia lista docu m enti IN USCIT A ()
Se le zione docu m ento Pa ti ent S um m ary()
Conferm a INVIA ORA ()
Even toCli nico_InvioE ve n to(PatientSu m m ary)
« req ue st»
Il SD p rose gue ne ll a valutazi one dell a risposta da ll 'AP S com e da Fragm en t "alt Esito M odal ità sche dula ta in
background". P er sem plicità espositiva, non sono i ndi ca te le al tre operazioni o pzio nali de ll'interfaccia
del l'A ddOn : "Vi sualizza Docum en to Se lezio nato", "Elim ina Docum ento" , "Ag giorna L ista Docum enti "
Figura 18 - UML Sequence Diagram "Invio Patient Summary"
36 of 37
6
Documenti RFC di riferimento
[1] RFC85 “Servizi Anagrafe Persone HL7v3”, versione 3 – 6 maggio 2009
[2] RFC87 “Gestione MMG/PLS HL7v3”, versione 3 – 6 maggio 2009
[3] RFC161 “e-prescription”, versione 5 – 21 novembre 2011
[4] RFC123 “Storage Geografico HDIS - Gestione Eventi Sanitari”, versione 3 – 14 luglio 2011
[5] RFC195 “Infrastruttura Comunicazione per la messaggistica HL7v3”, ver. 2 – 18 luglio 2011
[6] RFC207 “Acquisizione del Numero Ricetta Elettronica (NRE)”, versione 3 – 18 novembre 2011
[7] RFC98 “Busta Evento Sanitario”, versione 6 – 16 ottobre 2009
[8] RFC198 “Determinazione fasce di reddito per applicazione dei ticket su erogazione di farmaci e
prestazioni” versione 1 – 6 febbraio 2012
[9] RFC133 “Patient Summary (Profilo Sanitario Sintetico)”, versione 1.02 – 29 marzo 2011
[10] RFC161 - Appendice, Prescrizione SSN/SASN Reg. Toscana - Implementation Guide CDAR2 Ver.02
– 15 luglio 2011
[11] RFC133 “Specifiche di Implementazione” versione 1.0 – 1 luglio 2011
[12] RFC85 “Specifiche di Implementazione” versione 2.0 – 13 aprile 2010
[13] RFC87 “Specifiche di Implementazione” versione 2.4 – 30 ottobre 2012
[14] Medicina Convenzionata – “Manuale Operativo per l’integrazione con i servizi di Regione
Toscana” v1.1 – 20 dicembre 2011
37 of 37

Documentazione Tecnica AddOn CGM CSE

Transcript

Documenti analoghi

pdf - Progetto Edemps

Carta dei Servizi - Medicina in rete Gallarate

calcolo indice h - Università di Bologna

Calcolo indice H su Google Scholar

Mail

Come configurare il mIRC by CrocMax (base o con script che sia)

HR 500

Estensioni di Mozilla Firefox di cui non avevate

Appartamento a prova di ladri.