Distribuzione dati codificati (DDC)

Recupero informazioni relative a L1, L2, L3, Practitioner AFAM e ASAN

Occupazione posti letto

Lo scopo del caso d’uso è ottenere dati aggiornati sull’occupazione dei posti letto delle strutture socio-sanitarie di diversa tipologia, ad esempio: RSA, RSD, ecc., presenti in Regione Lombardia.

Il seguente elenco definisce il principale contenuto informativo che sarà disponibile per questo caso d’uso.

Diagramma UML

La risorsa FHIR cardine di questo caso d’uso è “Observation” che rappresenta, in generale, una qualsiasi misura o asserzione fatta su un paziente, un dispositivo o qualsiasi altro soggetto. L’Observation è referenziata alla risorsa Organization che esprime il soggetto, ossia la struttura, a cui si applica la misura.

Richiesta

Per interrogare un applicativo tramite interfaccia FHIR si utilizza il metodo GET che permette di recuperare una specifica risorsa, indicando il relativo URI, oppure utilizzare il metodo GET combinando una serie di parametri condizionali. Il formato di una ricerca di una risorsa mediante il metodo GET è il seguente:

GET {BASE_URL}/TipoRisorsa?Parametro1=ValoreParametro1&Parametro2=ValoreParametro2&…

Dove BASE_URL è l’endpoint dell’applicativo che espone il servizio, TipoRisorsa è il nome della risorsa FHIR esposta e le coppie Parametro-ValoreParametro esprimono condizioni di ricerca specifiche.

Nella tabella sottostante sono riportati alcuni dei parametri di ricerca che possono essere utilizzati per determinare il comportamento della risposta applicativa. Si noti che tali parametri possono essere combinati tra loro con operatori logici (ad esempio & esprime AND logico).

Nel caso in esame si ha l’obiettivo di recuperare il numero di posti letto occupati dalle strutture socio-sanitarie, quindi bisognerà effettuare una GET avente Observation come tipo di risorsa, in quanto è la risorsa che contiene l’informazione relativa al numero di posti letto occupati per una particolare struttura. Nella risposta del server si vuole ottenere anche un riferimento alla struttura sanitaria a cui il dato fa riferimento quindi è possibile utilizzare il parametro di ricerca _include. Il valore del parametro include presenta due parti separate dal carattere “:”, il primo valore indica il nome della risorsa di partenza da cui proviene il join (in questo caso Observation), mentre il secondo valore è il nome del parametro di ricerca che deve essere di tipo reference (in questo caso performer indica un riferimento ad una Organization di tipo L2).

Risposta

Quando il server risponde ad una HTTP Request, elabora la chiamata a seconda del metodo utilizzato e restituisce al client una HTTP Response che contiene un:

• Body: corpo della risposta in formato JSON che contiene l’informazione richiesta dal client a seguito della richiesta;
• Codice di stato HTTP: restituito dal server in modo da informare il client sul risultato della richiesta (ad esempio 200: indica che la risorsa è stata trovata e il messaggio è stato elaborato con successo);
• Headers: forniscono informazioni extra sulla risposta.

Risposta esito positivo

GET /Observation?_include=Observation:performer&Parametro1=ValoreParametro1&…

Il risultato della precedente GET è un Bundle che contiene tutte le Observation insieme alle Organization L2 referenziate mediante il parametro performer contenuto nella risorsa Observation. Tutte le Organization verranno messe in coda alla fine di tutte le Observation. Il risultato della GET sarà una risorsa di tipo Bundle contenente informazioni relative alle risorse Observation ed Organization.

Stuttura del Bundle

Stuttura di Observation

Nella tabella sottostante si riportano le principali caratteristiche degli attributi della risorsa Observation che aderisce al profilo FHIR “RLObservationPLO”. Maggiori informazioni sul profilo (quali ad esempio cardinalità, formato, ecc…) sono disponibili sul sito di Simplifier.

In aggiunta, grazie all’utilizzo del parametro di ricerca _include, la risposta conterrà anche le informazioni relative all’Organization referenziata dal parametro performer in Observation. In particolare non tutte le informazioni contenute nella risorsa FHIR Organization sono obbligatorie ma è importante che ci siano le informazioni descritte nel paragrafo che segue.

Struttura di Organization

Nella tabella sottostante si riportano le principali caratteristiche degli attributi della risorsa Organization che aderisce al profilo FHIR “RLOrganizationL2”. Maggiori informazioni sul profilo (quali ad esempio cardinalità, formato, ecc…) sono disponibili sul sito di Simplifier.

Di seguito un esempio di Bundle di risposta con esito positivo:

{
    "resourceType": "Bundle",
    "id": "esempio-bundle-PLO-esitopositivo",
    "type": "searchset",
    "timestamp": "2022-07-12T07:15:56Z",
    "total": 1,
    "link":  [
        {
            "relation": "self",
            "url": "http://localhost:52773/csp/healthshare/nprifhirserver/fhir/r4/Observation?_include=Observation:performer"
        }
    ],
    "entry":  [
        {
            "fullUrl": "http://localhost:52773/csp/healthshare/nprifhirserver/fhir/r4/Observation/77533",
            "resource": {
                "resourceType": "Observation",
                "id": "77533",
                "meta": {
                    "versionId": "1",
                    "profile":  [
                        "https://fhir.siss.regione.lombardia.it/StructureDefinition/RLObservationPLOsti"
                    ],
                    "lastUpdated": "2022-07-12T07:15:20Z"
                },
                "identifier":  [
                    {
                        "system": "https://fhir.siss.regione.lombardia.it/Id/RLObservation",
                        "value": "030717-03007800"
                    }
                ],
                "code": {
                    "coding":  [
                        {
                            "system": "https://fhir.siss.regione.lombardia.it/CodeSystem/RLOrganizationMeasures",
                            "code": "01",
                            "display": "Occupazione posti letto"
                        }
                    ]
                },
                "status": "final",
                "performer": {
                    "reference": "Organization/11984",
                    "display": "03007800"
                },
                "effectiveDateTime": "2022-01-23T15:30:10+01:00",
                "component":  [
                    {
                        "code": {
                            "coding":  [
                                {
                                    "system": "http://www.hl7.it/fhir/base/CodeSystem-minsan-hsp.html",
                                    "code": "3",
                                    "display": "Alzheimer"
                                }
                            ]
                        },
                        "valueInteger": 64
                    },
                    {
                        "code": {
                            "coding":  [
                                {
                                    "system": "http://www.hl7.it/fhir/base/CodeSystem-minsan-hsp.html",
                                    "code": "5",
                                    "display": "Ordinario"
                                }
                            ]
                        },
                        "valueInteger": 10
                    }
                ]
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "http://localhost:52773/csp/healthshare/nprifhirserver/fhir/r4/Organization/11984",
            "resource": {
                "resourceType": "Organization",
                "id": "11984",
                "meta": {
                    "profile":  [
                        "https://fhir.siss.regione.lombardia.it/StructureDefinition/RLOrganizationL2"
                    ]
                },
                "identifier":  [
                    {
                        "system": "http://www.hl7.it/fhir/base/CodeSystem-minsan-hsp.html",
                        "value": "03007800"
                    }
                ],
                "type":  [
                    {
                        "coding":  [
                            {
                                "system": "http://www.hl7.it/fhir/base/CodeSystem-minsan-hsp-1.html",
                                "code": "RIC"
                            }
                        ]
                    }
                ],
                "name": "Presidio Ospedaliero di Vimercate"
            },
            "search": {
                "mode": "include"
            }
        }
    ]
}

Risposta esito positivo senza risultati

Nel caso in cui in seguito ad una interrogazione FHIR, l’applicativo risponda con zero risultati, la risposta è comunque di esito positivo in quanto il codice di stato è HTTP 200.

Struttura del Bundle

Di seguito un esempio di Bundle di risposta con esito positivo con zero risultati.

{
    "resourceType": "Bundle",
    "id": "dbb16aa8-02b9-11ed-ac24-02001700b287",
    "type": "searchset",
    "timestamp": "2022-07-13T14:41:19Z",
    "total": 0,
    "link": [
        {
            "relation": "self",
            "url": "http://localhost:52773/csp/healthshare/nprifhirserver/fhir/r4/Observation?_include=Observation:performer"
        }
    ]
}

Risposta esito negativo

Nel caso in cui la risposta ottenuta dall’applicativo del IS è negativa e l’errore è a livello di Web Service, essa conterrà i codici di stato propri del protocollo HTTP; ad esempio:

• 404 Not Found, se la risorsa web non è stata trovata;
• 410 Gone, se la risorsa è stata eliminata;
• Ecc.

Nel caso in cui l’applicativo abbia errori sull’interfaccia FHIR (ad. esempio un parametro non è riconosciuto), verrà restituita come risposta un JSON contente la risorsa Bundle al cui interno è presente la risorsa OperationOutcome.

Struttura di OperationOutcome

Di seguito un esempio di risposta negativa a seguito di un parametro di ricerca non riconosciuto.

{
    "resourceType": "Bundle",
    "id": "f8cd72d2-0460-11ed-aa12-02001700b287",
    "type": "searchset",
    "timestamp": "2022-05-15T17:10:05Z",
    "total": 0,
    "link": [
        {
            "relation": "self",
            "url": "http://localhost:8080/fhirserver/fhir/r4/Observation"
        }
    ],
    "entry": [
        {
            "resource": {
                "resourceType": "OperationOutcome",
                "id": "1",
                "issue": [{
                        "severity": "error",
                        "code": "invalid",
                        "diagnostics": "ParameterNotSupported",
                        "details": {
                            "text": "Unrecognized parameter '_id1'. 123456"
                        }
                    }
                ]
            }
            "search": {
                "mode": "outcome"
            }
        }
    ]
}

Recupero informazioni di dominio del gestore

Nel caso in esame si ha l’obiettivo di recuperare le informazioni di dominio del gestore dalla risorsa FHIR RLHealthcareServiceRSAInfoBase. Per far ciò bisognerà effettuare una GET avente come tipo di risorsa HealthcareService in quanto è la risorsa che descrive i servizi offerti e le informazioni caratteristiche di una specifica RSA.

Nella risposta del server si vuole ottenere tutte le informazioni contenute nella risorsa HealthcareService relative ad una specifica RSA, quindi è possibile utilizzare il parametro di ricerca organization che permette di specificare l’Organization che fornisce il servizio sanitario di cui si vogliono ottenere le informazioni.

Il valore di questo parametro sarà il codice CUDES ovvero il codice dell’Organization L2 di riferimento. Questo codice sarà univoco per ogni RSA in quanto un codice Organization L2 identifica una specifica struttura sanitaria e quindi di conseguenza identifica univocamente una RSA.

GET /HealthcareService?organization=codiceCUDES

È previsto che il server FHIR effettui una richiesta periodica per ottenere queste informazioni. La frequenza di configurazione della richiesta può essere schedulata settimanalmente o mensilmente in quanto le informazioni richieste non sono soggette a cambi frequenti.

Dimissioni protette

Care plan