Dateien importieren
Import aus dem lokalen Dateisystem
- Importieren Sie DICOM-Dateien entweder einzeln oder als Verzeichnis.
- Beim Auswählen einzelner Dateien ist das Standard-Suffix .dcm, dies kann jedoch in den Dateiauswahloptionen geändert werden.
- Beim Auswählen eines Verzeichnisses werden alle Dateien in diesem Verzeichnis und dessen Unterverzeichnissen versucht zu importieren.
- Damit eine Datei akzeptiert und importiert wird, muss sie:
- Eine gültige DICOM-Datei sein (gemäß dem DICOM-Standard) mit gültigen Dateimetainformationen einschließlich DICOM-Präambel im Dateikopf.
- Die Attribute enthalten:
- SOPClassUID
- StudyInstanceUID
- SeriesInstanceUID
- SOPInstanceUID
- Die Speicherklasse muss eine der im Projekt festgelegten Speicherklassen sein. (siehe Modalitäten & Speicherklassen in Hilfe/Projekteinstellungen)
- Erfolgreich sein PHI erfasst haben
- Nicht vorher importiert worden sein, d. h. SOPInstanceUID ist nicht im Anonymizer-Datenspeicher gespeichert.
- Wenn eine Datei die obigen Bedingungen nicht erfüllt, wird sie im Speicherverzeichnis quarantänisiert, d. h. für die ersten 4 Fälle jeweils:
- /privat/quarantäne/Ungültiges_DICOM
- /privat/quarantäne/Fehlende_Attribute
- /privat/quarantäne/Ungültige_Speicherklasse
- /privat/quarantäne/PHI_Erfassungs_Fehler
- Wenn eine Datei bereits importiert wurde, wird sie ignoriert.
- Der Dateiimportdialog zeigt das Ergebnis jedes Dateiimports in jeder Zeile in seinem scrollbaren Textfeld an.
- Wenn eine Datei erfolgreich importiert wird, zeigt sie einen gekürzten Dateipfad gefolgt von PHI-Patienten-ID => Anonymisierte Patienten-ID wie im folgenden Screenshot gezeigt.
- Bei einem Fehler wird ein gekürzter Dateipfad gefolgt von einer passenden Fehlermeldung in der nächsten Zeile angezeigt, wie im Screenshot unten gezeigt.
Import vom Remote-DICOM-Server
Klicken Sie im Dashboard auf die Schaltfläche Abfragen, um zuerst ein DICOM-Echo an den Remote-Server zu senden und bei Erfolg die Ansicht Abfragen, Abrufen & Importieren zu öffnen.
Die Ansicht Abfragen, Abrufen & Importieren
Suche nach Studien
- Ein Remote-DICOM-Server kann abgefragt werden, um passende Studien in der Ansicht Abfrageergebnisse aufzulisten, indem eines oder eine Kombination der Standardabfragefelder verwendet wird:
- Patientenname: Alphabetische Zeichen mit und ohne Akzente, Ziffern, ^-Trennzeichen, ? für Einzelzeichen-Platzhalter, * für Zeichenfolgen-Platzhalter
- Patienten-ID: ASCII-Zeichen und Ziffern, ? für Einzelzeichen-Platzhalter, * für Zeichenfolgen-Platzhalter
- Modalität: Dropdown-Liste mit den in den Projekteinstellungen konfigurierten Modalitäten
- Studien-Datum: Bestimmtes Datum oder Datumsbereich im Format JJJJMMTT-JJJJMMTT
- Zugangsnummer(n): ASCII-Zeichen, Ziffern und "/-_,." ? für Einzelzeichen-Platzhalter, * für Zeichenfolgen-Platzhalter
- Eine durch Kommas getrennte Liste kann in Zugangsnummer(n) eingegeben werden, um mehrere Suchvorgänge durchzuführen.
- Mehrfach-Zugangsnummernsuche über die Schaltfläche Zugangsnummern laden und eine Textdatei mit dem Suffix ".txt" oder ".csv", die eine durch Kommas oder Zeilenumbrüche getrennte Liste enthält.
- Der Schalter Importierte Studien anzeigen oben rechts steuert, ob importierte Studien in der Suchergebnisliste enthalten sind.
- Nur Studien, die Modalitäten enthalten, die für das Projekt festgelegt sind, werden angezeigt und zur Auswahl verfügbar gemacht.
Auswählen und Importieren von Studien
- Studien können einzeln (Mausklick), in Gruppen (CMD- oder CTRL-Taste gedrückt halten) oder in großen Mengen mit der Schaltfläche Alle auswählen ausgewählt werden.
- Studien durch einzelnes Klicken oder mit der Schaltfläche Auswahl löschen abwählen.
- Wählen Sie vor dem Importieren von Studien die Ebene (Studie, Serie, Instanz) aus, die für den Importvorgang (über DICOM C-MOVE) verwendet werden soll, aus dem Dropdown-Menü Bewegungsebene.
- Durch Klicken auf die Schaltfläche Importieren und Anonymisieren wird der Importstudien-Dialog gestartet.
- Der Remote-Server wird zuerst für jede ausgewählte Studie abgefragt, um eine Study-UID-Hierarchie entsprechend der ausgewählten Bewegungsebene zu erstellen.
- Der Import wird dann gestartet und der Importstudien-Dialog zeigt eine Fortschrittsanzeige, die die Anzahl der importierten Bilder aus der Studienhierarchie verfolgt.
- Der Importvorgang endet, sobald alle Studien angefordert wurden und entweder alle Dateien in einer Studie empfangen wurden oder ein Timeout aufgetreten ist.
- Wenn der Remote-Server innerhalb der Projekt-Timeout-Einstellung nicht antwortet: Netzwerk-Timeout für jede Dateiübertragung wird der Importvorgang für diese Studie abgebrochen.
- Der Importstudien-Dialog zeigt das Ergebnis des Importvorgangs bei Abschluss wie im untenstehenden Screenshot:
- Nach dem Schließen des Importstudien-Dialogs mit der Schaltfläche Schließen werden die erfolgreich importierten Studien im Abfrageergebnisfenster grün hervorgehoben, wie unten gezeigt:
Probleme mit dem Download (Retrieve) von DICOM-Daten
- Wenn der Importvorgang nicht alle Studien erfolgreich importiert, passen Sie das Netzwerk-Timeout und die Bewegungsebene an und versuchen Sie es erneut, indem Sie auf die Schaltfläche Importieren klicken.
- Der Anonymizer wurde entwickelt, um C-MOVE nicht konforme DICOM-Server zu unterstützen, insbesondere VNAs, die im asynchronen Modus mit unbekannten Prioritäts- und Timeout-Einstellungen arbeiten.
Dateien exportieren
Klicken Sie im Dashboard auf die Schaltfläche Exportieren, um zuerst ein DICOM-Echo an den Remote-Server zu senden und bei Erfolg die Exportansicht zu öffnen.
Die Exportansicht
- Die Exportansicht funktioniert ähnlich wie die Abfrageansicht, in der importierte und anonymisierte Patienten zur Übertragung an einen Remote-DICOM-Server oder einen AWS S3-Bucket ausgewählt werden können.
- Patienten können mehrere Studien enthalten, die unabhängig vom Importvorgang importiert wurden.
- Vor dem Senden einer Datei prüft der Anonymizer beim Remote-Server (SCP oder AWS), ob sie bereits gesendet wurde und sendet sie nicht erneut.
- Der Exportstatus wird in Echtzeit in der Exportansicht angezeigt.
- Das Datum und die Uhrzeit eines erfolgreichen Patientenexports und eine Fortschrittsanzeige werden wie im untenstehenden Screenshot angezeigt:
Exportieren der Patienten-Such-CSV-Datei
- Eine Patienten-Suchdatei, die die PHI-Daten des Projekts enthält, kann jederzeit während eines Projekts mit der Schaltfläche Patienten-Suche erstellen in der Exportansicht erstellt werden.
- Die PHI-Datendatei wird im CSV-Format im privaten Unterverzeichnis des Speicherverzeichnisses hier gespeichert:
- /privat/phi_export/
- Das Format der Suchdatei folgt der JAVA-Anonymizer-Indexdatei mit den folgenden Feldern, die jeder Studienzeile hinzugefügt werden: Anzahl der Serien, Anzahl der Instanzen
Dashboard
- Das Projekt-Dashboard zeigt relevante Projektmetriken in Bezug auf den aktuell kuratierten Datensatz im Speicherverzeichnis an.
- Die Abfrage- und Exportansichten werden über die entsprechenden Schaltflächen vom Dashboard aus gestartet.
- Die Anzahl der Dateien, die in der Anonymisierungswarteschlange auf die Anonymisierung durch einen Anonymisierungs-Worker-Thread warten, wird unten links im Dashboard angezeigt.
- Der Status eines Vorgangs, der über das Menü oder das Dashboard initiiert wurde, wird unten rechts im Dashboard angezeigt.