Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- versione_2.0 [2025/11/03 15:10] – mirko_giulianini
+++ versione_2.0 [2025/11/03 16:19] (versione attuale) – Imported from DOCX mirko_giulianini
@@ Linea 1: / Linea 1: @@
-tbd
+===== 1. Introduzione e Scopo =====
+Questo strumento permette di **importare studi DICOM** provenienti da supporti esterni (come CD medicali o chiavette USB) nel sistema PACS aziendale. Durante l'importazione, lo studio viene **associato a un paziente e a un ordine specifico** presenti nel sistema informativo RIS.\\
+===== 2. Accesso allo Strumento =====
+Normalmente, **non accederai a questo strumento direttamente**. Sarà avviato automaticamente dal sistema RIS (o da un'applicazione simile) quando selezioni l'opzione per importare uno studio esterno relativo a un paziente e a un ordine specifico.\\
+{{versione_2.0:rid7.png|}}
+{{versione_2.0:rid8.png|}}
+===== 3. Schermata Principale di Importazione =====
+Una volta avviato, vedrai la schermata principale che presenta diverse sezioni:
+**A. Informazioni sul Paziente (Ordine RIS)**
+Nella parte superiore della schermata, è presente un riquadro dedicato alle "Informazioni sul Paziente". Questa sezione visualizza i dati anagrafici del paziente, esattamente come sono registrati nell'ordine selezionato all'interno del Sistema Informativo Radiologico (RIS). È di cruciale importanza che l'operatore verifichi attentamente che questi dati corrispondano inequivocabilmente al paziente per il quale si sta procedendo all'importazione dello studio, al fine di evitare errori di attribuzione.
+**B. Importazioni Precedenti (con Log)**
+Immediatamente sotto i dati del paziente, può comparire una tabella denominata "Importazioni Precedenti (con Log)". Questa tabella offre una panoramica storica dei tentativi di importazione già eseguiti per lo stesso paziente e per il medesimo numero d'ordine RIS. Vengono elencati solo i tentativi che hanno generato almeno un log all'interno del sistema di audit, garantendo la tracciabilità delle operazioni.
+Le colonne della tabella forniscono dettagli specifici su ciascun tentativo di importazione:
+**Data/Ora Richiesta**: Indica con precisione la data e l'ora in cui è stato avviato il tentativo di importazione.
+**Study UID**: Rappresenta l'Identificativo Univoco DICOM dello studio importato, se tale identificativo è disponibile nel set di dati.
+**Descrizione**: Fornisce una breve descrizione dello studio, anch'essa se disponibile all'interno dei metadati DICOM.
+**Stato Elaborazione**: Questa colonna è fondamentale per comprendere l'avanzamento del processo e può assumere diversi valori, ognuno indicato da un badge colorato per una rapida identificazione visiva:
+**Richiesta creata** (badge grigio/muto): L'importazione è stata correttamente avviata dal sistema ma non è ancora stata presa in carico per l'elaborazione.
+**In attesa processo** (badge giallo/warning): Lo studio è stato ricevuto con successo dal sistema, ma il processo di elaborazione non è ancora iniziato, probabilmente in attesa di risorse o della coda di elaborazione.
+**In corso** (badge blu/primary): L'elaborazione dello studio è attualmente in progresso. Questo stato indica che non sono stati rilevati errori noti fino a quel momento.
+**Completato** / **In Corso / OK** (badge verde/success): Questo stato indica che l'elaborazione è terminata con successo, oppure che è ancora in corso ma senza alcun errore rilevato. Rappresenta un esito positivo dell'operazione.
+**Errore** (badge rosso/danger): Si è verificato un errore significativo durante una fase qualsiasi dell'elaborazione dello studio. Questo richiede attenzione e potenziale intervento.
+**Link**: Se l'elaborazione dello studio è iniziata (ovvero lo "Stato Elaborazione" è diverso da "Richiesta creata"), nella colonna "Link" apparirà un pulsante "Apri" (con un'icona di collegamento esterno). Cliccando su questo pulsante, si aprirà una nuova finestra del browser che fornirà dettagli passo-passo e log specifici sullo stato di quella particolare importazione, permettendo un'analisi approfondita in caso di problemi.
+**C. Metodi di Importazione (Tabs)**
+La sezione "Metodi di Importazione" offre all'utente due schede distinte (tab) per scegliere la modalità più appropriata per l'importazione dei file, in base alla struttura del supporto dati (CD, chiavetta USB, ecc.).
+**1. CARICO STUDIO DA CD o DIRECTORY**
+Questa opzione consente di caricare il contenuto quando il supporto di importazione (CD o chiavetta USB) contiene un file denominato DICOMDIR nella sua cartella principale (root). Il file DICOMDIR funge da indice strutturato dello studio, fornendo metadati essenziali e un'organizzazione gerarchica dei file DICOM, facilitando un'importazione più efficiente e accurata. In assenza del file denominato DICOMDIR, il sistema caricherà le singole immagini dicom che verranno trovate nel percorso selezionato.
+**Come usarlo**:
+L'utente deve cliccare sul pulsante "Seleziona Cartella" (o testo equivalente configurato nella lingua corrente).
+Si aprirà una finestra di dialogo per la selezione della cartella. È fondamentale selezionare la **cartella principale (root)** del CD o della chiavetta USB, quella che contiene direttamente il file DICOMDIR.
+Una volta che la cartella contenente il DICOMDIR è stata selezionata correttamente, il pulsante "Comprimi e Invia Studio" diventerà visibile e attivo.
+Cliccando su "Comprimi e Invia Studio", il sistema avvierà una serie di operazioni automatizzate:
+**Lettura del DICOMDIR**: Il sistema analizzerà il file DICOMDIR per identificare con precisione tutti i file DICOM pertinenti e necessari per lo studio.
+**Compressione automatica in ZIP**: I file identificati verranno automaticamente compressi in un singolo archivio ZIP direttamente all'interno del browser dell'utente. Questa fase potrebbe richiedere un tempo variabile, specialmente per studi di grandi dimensioni, e sarà visibile un indicatore di progresso come "Compressione ZIP...".
+**Invio del file ZIP al server**: Una volta completata la compressione, il file ZIP verrà inviato al server. Durante questa operazione, verrà visualizzato il messaggio "TRASFERIMENTO DELLO STUDIO..." accompagnato da una barra di avanzamento che mostrerà lo stato dell'upload.
+**Attesa conferma dal server**: Il sistema attenderà una conferma di ricezione e avvio dell'elaborazione da parte del server.
+Se l'invio e l'avvio dell'elaborazione sul server hanno successo, l'utente verrà automaticamente reindirizzato a una schermata di conferma, indicando il buon esito dell'operazione.
+{{versione_2.0:rid9.png |}}
+===== 4. Schermata di Conferma =====
+Dopo aver caricato i file DICOM, indipendentemente dal metodo utilizzato (trascinamento o selezione manuale), il sistema ti reindirizzerà automaticamente alla schermata di conferma. Questa è una fase cruciale del processo di importazione, dove vengono presentati tutti i dettagli rilevanti per una verifica approfondita prima della finalizzazione.
+A. Verifica Corrispondenza Paziente
+Questa sezione è dedicata a un controllo incrociato meticoloso dei dati del paziente. Vengono visualizzati i dati anagrafici del paziente recuperati dall'Ordine RIS e, contemporaneamente, vengono confrontati con i dati del paziente estratti dai file DICOM che hai appena importato.
+Durante questa fase, il sistema genererà messaggi specifici per indicare lo stato della corrispondenza:
+**Paziente Corrisponde**: Se il Nome, la Data di Nascita e il Sesso del paziente combaciano perfettamente tra i dati RIS e quelli DICOM, apparirà il messaggio PAZIENTE CORRISPONDE. Questo indica un'alta probabilità di corretta associazione.
+**Nome Paziente Non Corrisponde**: Se il nome del paziente differisce, verrà mostrato NOME PAZIENTE NON CORRISPONDE. Questo è un avviso critico che richiede la massima attenzione.
+**Formato Diverso**: In alcuni casi, i dati potrebbero essere simili ma presentare leggere differenze di formattazione (es. "ROSSI MARIO" vs "MARIO ROSSI"). In questo scenario, potrebbe apparire un messaggio come FORMATO DIVERSO. Anche se meno grave di un'incongruenza totale, richiede comunque una verifica visiva per confermare l'identità del paziente.
+**Altre Non Corrispondenze**: Potrebbero esserci altri messaggi di avviso che segnalano discrepanze nella data di nascita.
+**Attenzione!** È fondamentale prestare la massima attenzione a questi messaggi. Ignorare un avviso di non corrispondenza potrebbe portare all'associazione di uno studio al paziente sbagliato, con gravi conseguenze cliniche e legali.
+B. Elenco Studi Importati
+In questa sezione, viene fornito un elenco dettagliato di tutti gli studi DICOM che sono stati rilevati e analizzati all'interno dei file caricati. Per ogni studio, verranno visualizzate informazioni essenziali come:
+**Descrizione**: Una breve descrizione dello studio.
+**Data**: La data in cui lo studio è stato eseguito.
+**Study UID (Unique Identifier)**: Un identificatore univoco globale per lo studio, garantendo la sua individualità nel sistema.
+**Accession Number**: Un numero di accesso, spesso utilizzato per collegare lo studio al sistema RIS.
+È importante notare che potrebbe apparire un messaggio di avviso specifico:
+Già presente su PACS, rimosso da importazione. Questo messaggio indica che il sistema ha rilevato uno studio con lo stesso Study UID già esistente nel PACS di destinazione. In tal caso, per evitare duplicazioni, lo studio specifico verrà automaticamente ignorato dal processo di importazione finale e rimosso dalla lista di importazione temporanea. Non è richiesta alcuna azione da parte dell'utente, se non una consapevolezza che lo studio in questione non verrà nuovamente archiviato.
+C. Conferma o Annulla
+Nella parte inferiore della schermata di conferma, troverai due pulsanti chiari e distinti che ti permettono di prendere una decisione finale sull'importazione:
+**CONFERMA IMPORTAZIONE**:
+**Quando usarlo**: Clicca questo pulsante //solo// se hai verificato attentamente tutti i dati e sei assolutamente certo che i dati del paziente corrispondano o, nel caso di avvisi minori (es. "FORMATO DIVERSO"), hai confermato visivamente che si tratta comunque del paziente corretto.
+**Comportamento in caso di studio già presente**: Anche se confermi, se uno studio è stato precedentemente marcato con il messaggio "Già presente su PACS", esso verrà comunque ignorato e non re-importato.
+**Esito della conferma**: Cliccando su "CONFERMA IMPORTAZIONE", lo studio (o gli studi validi e non duplicati) verranno instradati al processo di archiviazione finale.
+**Reindirizzamento**: Successivamente, verrai automaticamente reindirizzato alla schermata di monitoraggio, dove potrai seguire lo stato di avanzamento dell'elaborazione.
+**ANNULLA IMPORTAZIONE**:
+**Quando usarlo**: Clicca questo pulsante se i dati del paziente non corrispondono in modo significativo, se ti rendi conto di aver importato lo studio sbagliato per errore, o per qualsiasi altro motivo che ti induca a non procedere con l'archiviazione.
+**Esito dell'annullamento**: L'intera importazione verrà annullata. Tutti gli studi caricati temporaneamente verranno eliminati dal server, e potrai tranquillamente chiudere la finestra.
+**Reindirizzamento**: Verrai reindirizzato a una schermata di conferma che attesta l'avvenuto annullamento.
+**Nota Importante sulle Scelte Visive**: Per enfatizzare l'importanza della verifica dei dati del paziente, il sistema adotta un accorgimento visivo: se i dati del paziente non corrispondono, il pulsante "CONFERMA IMPORTAZIONE" diventerà più piccolo e rosso, mentre il pulsante "ANNULLA IMPORTAZIONE" sarà più grande e blu. Questa modifica cromatica e dimensionale serve a rendere immediatamente percepibile il rischio e a incoraggiare l'utente a procedere con cautela o ad annullare l'operazione in caso di dubbi
+===== 5. Monitoraggio Elaborazione =====
+Dopo aver cliccato "CONFERMA IMPORTAZIONE", il sistema ti reindirizzerà alla pagina finale, dedicata al monitoraggio dello stato di avanzamento dell'elaborazione in background. Questa pagina ti offre una visione in tempo reale del processo di archiviazione.
+Vedrai una tabella che si aggiorna automaticamente ogni pochi secondi, mostrando lo stato delle diverse fasi per ogni studio che hai confermato:
+**Verifica**: Questa è la fase iniziale in cui il sistema esegue una verifica interna dell'integrità e della completezza dei file DICOM ricevuti. Assicura che i dati siano pronti per le fasi successive.
+**Archiviazione (Store)**: Durante questa fase, lo studio DICOM viene effettivamente inviato e archiviato nel PACS principale. È il momento in cui i dati vengono trasferiti e indicizzati nel sistema di archiviazione.
+**Merge Paziente**: (Questa fase è attiva solo se configurata nel sistema). Se abilitata, questa operazione mira a unificare l'anagrafica del paziente sul PACS. Ciò è particolarmente utile in scenari dove un paziente potrebbe avere record duplicati o frammentati e si desidera consolidare le informazioni.
+**Invio Ordine RIS**: (Anche questa fase è attiva solo se configurata). Se abilitata, il sistema aggiorna automaticamente lo stato dell'ordine nel sistema RIS (Radiology Information System), comunicando che l'importazione dello studio è stata completata o è in corso.
+**Stato Finale**: Questa colonna indica lo stato complessivo del processo per ciascuno studio. Potrebbe mostrare "In corso..." mentre l'elaborazione è attiva, o "Completato" una volta che tutte le fasi sono state portate a termine con successo. In caso di problemi, eventuali errori specifici verranno dettagliati qui, fornendo indicazioni per la risoluzione.
+{{versione_2.0:rid10.png |}}
+{{versione_2.0:rid11.png |}}
+**Importante**: Puoi chiudere questa finestra in qualsiasi momento, anche se l'elaborazione è ancora "In corso". Il processo di importazione continuerà autonomamente sul server in background, senza richiedere la tua presenza o l'apertura della pagina.
+**Consultazione delle Importazioni Passate**: Hai sempre la possibilità di controllare lo stato di un'importazione che hai effettuato in precedenza. Per farlo, ti basterà tornare alla schermata principale dell'applicazione (solitamente accessibile tramite un menu o un link dedicato) e navigare nella sezione "Importazioni Precedenti". Lì troverai un elenco delle tue importazioni passate e potrai cliccare sul link "Apri" corrispondente per visualizzare nuovamente la schermata di monitoraggio e i dettagli dello stato di quella specifica importazione.
+===== 6. Problemi Comuni e Messaggi di Errore =====
+Durante l'utilizzo dello strumento di importazione, potresti incontrare alcuni messaggi di errore o situazioni problematiche. Questa sezione descrive i più comuni e le azioni consigliate per risolverli.
+**"Token Not Found or Expired" / "Token Mancante..."**: Questo messaggio indica che l'avvio dello strumento di importazione non è avvenuto correttamente dal sistema RIS. Spesso è dovuto a un timeout o a un errore nella generazione del token di sicurezza.
+**Azione consigliata**: Chiudi la finestra di importazione e riprova ad avviarla direttamente dal sistema RIS principale.
+**"Mancanza dati..." / "Dati in ingresso non validi"**: Questo errore si verifica quando le informazioni iniziali sul paziente o sull'ordine RIS non sono state ricevute correttamente dallo strumento di importazione.
+**Azione consigliata**: Chiudi la finestra e riprova ad avviare il processo di importazione dal sistema RIS. Verifica che tutte le informazioni necessarie siano presenti nell'ordine RIS prima di avviare l'importazione.
+**"Import non possibile. Studio già presente sul PACS..." (Schermata Conferma)**: Questo messaggio, visualizzato nella schermata di conferma, indica che lo studio DICOM che stai tentando di importare è già stato rilevato nel sistema PACS con lo stesso Study UID. Per prevenire duplicazioni e mantenere l'integrità dei dati, l'importazione di quello specifico studio viene automaticamente bloccata.
+**Azione consigliata**: Non è necessaria alcuna azione immediata da parte tua per lo studio bloccato. Tuttavia, è opportuno verificare perché si sta tentando di re-importare uno studio già esistente. Potrebbe essere un errore, o potrebbe esserci un motivo specifico per cui lo studio originale non è più accessibile o è stato erroneamente rimosso.
+**"PAZIENTE NON CORRISPONDE" (Schermata Conferma)**: Questo è un avviso critico che appare nella schermata di conferma quando i dati anagrafici del paziente (Nome, Data di Nascita, Sesso) contenuti nei file DICOM differiscono in modo significativo da quelli associati all'ordine RIS.
+**Azione consigliata**: **NON CONFERMARE L'IMPORTAZIONE** a meno che tu non sia assolutamente sicuro che si tratti dello stesso paziente e che la discrepanza sia dovuta a un problema di formattazione minore (es. nomi invertiti, errori di battitura lievi). In caso di dubbio o di discrepanze evidenti, clicca sempre su "ANNULLA IMPORTAZIONE". La sicurezza del paziente e l'accuratezza dei dati clinici sono prioritarie.
+**"Errore" (Tabella Precedenti / Monitoraggio)**: Se visualizzi "Errore" nella tabella delle importazioni precedenti o nella schermata di monitoraggio, significa che si è verificato un problema durante l'elaborazione dello studio in background sul server.
+**Azione consigliata**:
+Clicca sul link "Apri" (se disponibile accanto all'errore) per accedere alla schermata di stato dettagliata, che potrebbe fornire maggiori informazioni sulla natura dell'errore.
+Se il problema persiste o non riesci a risolverlo, contatta l'assistenza tecnica fornendo l'ID dell'importazione o dello studio che trovi nella pagina di monitoraggio. Questo aiuterà il team di supporto a identificare e risolvere il problema più rapidamente.
+**"Timeout" (Monitoraggio)**: Questo messaggio appare nella schermata di monitoraggio quando la pagina non riceve aggiornamenti dal server per un periodo di tempo prolungato. Ciò può indicare che l'elaborazione si è bloccata o sta procedendo molto lentamente.
+**Azione consigliata**: Contatta immediatamente l'assistenza tecnica. Fornisci tutti i dettagli disponibili, inclusa l'ora del timeout e l'ID dell'importazione. Il team di supporto potrà verificare lo stato del processo sul server e intervenire se necessario.

Gmed Wiki

Strumenti Utente

Strumenti Sito

Differenze

Strumenti Pagina