DICOM-Daten mit DicomTagConfig de-identifizieren

Haftungsausschluss: Dieser Vorgang verarbeitet Daten mit einer Mischung aus regelbasierten und heuristischen Methoden. Die Ergebnisse können aufgrund von Faktoren wie Qualität/Konsistenz der Eingabedaten, heuristikbasierten Algorithmen und anderen Faktoren zwischen Ressourcen und Datasets abweichen. Diese Funktion erfüllt keine bestimmten rechtlichen, behördlichen oder Compliance-Anforderungen, einschließlich der Anforderungen für die De-Identifikation von Daten. Es liegt in der Verantwortung des Nutzers, die entsprechenden Konfigurationsparameter für den Vorgang festzulegen und das Endergebnis auszuwerten, um festzustellen, ob es für seine Anwendungsfälle und etwaige rechtliche, behördliche oder Compliance-Anforderungen geeignet ist.

Vorschau

Auf dieser Seite werden die Vorschaufunktionen beschrieben, die sich ändern können und möglicherweise nur beschränkten Support bieten. Änderungen an pre-GA-Produkten und -Funktionen sind möglicherweise nicht mit anderen pre-GA-Versionen kompatibel. Weitere Informationen finden Sie unter Vorbedingungen des Angebots für die Cloud Healthcare API und in den Beschreibungen der Startphase.

Auf dieser Seite wird erläutert, wie Sie mit der v1beta1-Konfiguration DicomTagConfig in der Cloud Healthcare API vertrauliche Daten in DICOM-Instanzen auf den folgenden Ebenen de-identifizieren:

• Auf Dataset-Ebene mit datasets.deidentify
• Auf DICOM-Speicherebene mit dicomStores.deidentify

Auf dieser Seite wird auch erläutert, wie Sie Filter anwenden, wenn Sie Daten auf DICOM-Speicherebene de-identifizieren.

Sie können die De-Identifikation von DICOM-Objekten entweder mit dem alten V1-Objekt DicomConfig oder dem V1beta1-Objekt DicomTagConfig konfigurieren. Wir empfehlen dringend, DicomTagConfig zu verwenden.

Wenn Sie bereits DicomConfig für Ihre De-Identifikationsvorgänge verwenden, empfehlen wir Ihnen, zu DicomTagConfig zu migrieren. Eine Zusammenfassung der neuen Funktionen finden Sie unter Neue Konfigurationsoptionen in DicomTagConfig. Eine Anleitung zur Migration finden Sie unter Anfragen und Antworten zur Verwendung von DicomTagConfig migrieren.

Neue Konfigurationsoptionen in DicomTagConfig

Text mithilfe der kontextbezogenen De-Identifikation de-identifizieren

Sie können das DicomTagConfig.Options.CleanDescriptorsOption-Objekt so konfigurieren, dass die kontextbezogene De-Identifikation von unstrukturiertem Metadatentext aktiviert wird. Diese Option basiert auf der Option „Beschreibungen bereinigen“. Wenn Sie DicomTagConfig.Options.CleanDescriptorsOption angeben, wird bei der Prüfung ein zusätzlicher „infoType“ verwendet, was sich auf die Abrechnungskosten auswirken kann.

Wenn Sie die Option DicomTagConfig.Options.CleanDescriptorsOption verwenden, wird jeder unstrukturierte Metadatentext umgewandelt, der mit entfernten Tags übereinstimmt. Dadurch wird die Qualität der De-Identifikation verbessert. Angenommen, Sie de-identifizieren eine Röntgenaufnahme und der Patient hat einen Nachnamen, der auch ein Nomen ist, z. B. Wall. Wenn Metadaten in der Instanz, z. B. der Text in StudyDescription, das Wort Wall enthalten, wird der Text transformiert.

Mit der Option CleanDescriptorsOption werden kontextbezogene Wortgruppen entfernt, die mit Tags übereinstimmen, die im DICOM-Basisprofil zum Entfernen markiert sind, sofern die Tags mit einem der folgenden Aktionscodes übereinstimmen:

• D
• Z
• X
• U

Übereinstimmende kontextbezogene Wortgruppen werden durch das Token [CTX] ersetzt.

Sie können konfigurieren, welche Tags entfernt werden sollen, indem Sie Folgendes angeben:

• Ein Enum im ProfileType-Objekt. Die Angabe eines Enumerationstyps ist nicht erforderlich.
• Mit CleanTextTag können Sie nach bestimmten Tags filtern.

Die im DICOM-Basisprofil verwendeten Tags können jedoch nicht geändert werden.

Eingebrannten Text mit kontextueller De-Identifikation entfernen

Sie können das TextRedactionMode.REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS-Enum angeben, um die kontextbezogene De-Identifikation von eingebranntem Text in einem Bild zu aktivieren. Diese Option basiert auf der Option „Beschreibungen bereinigen“. Wenn Sie das TextRedactionMode.REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS-Enum angeben, wird bei der Prüfung ein zusätzlicher infoType verwendet, was sich auf die Abrechnungskosten auswirken kann.

Sie können das TextRedactionMode.REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS-Enum auf folgende Arten angeben:

• In einem Options.ImageConfig-Objekt mit DicomTagConfig.Options.ImageConfig.TextRedactionMode Wenn Sie diese Option angeben, wird das Tag PixelData (7FE0,0010) automatisch der Liste der zu entfernenden Tags hinzugefügt.

• In einem Action.CleanImageTag-Objekt mit DicomTagConfig.Action.CleanImageTag.TextRedactionMode Wenn Sie diese Option angeben, müssen Sie das PixelData-Tag manuell dem Array Action.queries[] hinzufügen. Das PixelData-Tag ist das einzige unterstützte Tag bei Verwendung von Action.CleanImageTag.

Mit der Option TextRedactionMode.REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS wird eingebrannter Text entfernt, der mit Tags übereinstimmt, die im DICOM-Basisprofil zum Entfernen markiert sind, sofern die Tags mit einem der folgenden Aktionscodes übereinstimmen:

• D
• Z
• X
• U

Für die kontextbezogene De-Identifikation von eingebrannten Texten ist keine zusätzliche Konfiguration erforderlich. Sie können sie nur über ein Enum im Objekt ProfileType aktivieren oder deaktivieren. Die Angabe eines Enum ist nicht erforderlich.

Zusätzliche infoTypes bei der De-Identifikation von Bildern

Sie können Informationstypen verwenden, um anzugeben, nach welchen Daten bei der De-Identifikation von Tags gesucht werden soll. Ein infoType ist ein Typ sensibler Daten wie Patientenname, E-Mail-Adresse, Telefonnummer, Sozialversicherungsnummer oder Kreditkartennummer.

Sie können die folgenden Felder im Objekt DicomTagConfig.Options.ImageConfig konfigurieren, um festzulegen, welche infoTypes bei der De-Identifikation von DICOM-Bildern verwendet werden sollen:

• additionalInfoTypes
• excludeInfoTypes

Diese Felder werden nur wirksam, wenn DicomTagConfig.Options.ImageConfig.TextRedactionMode auf einen der folgenden Werte festgelegt ist:

• REDACT_SENSITIVE_TEXT
• REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS
• TEXT_REDACTION_MODE_UNSPECIFIED

Anfragen und Antworten für die Verwendung von DicomTagConfig migrieren

Sie können die De-Identifikation von DICOM-Daten mit DicomTagConfig konfigurieren. Diese Option ist in der Cloud Healthcare API v1beta1 verfügbar und eine Alternative zur Verwendung des älteren DicomConfig. Sie können bei einer Anfrage nicht sowohl DicomConfig als auch DicomTagConfig angeben.

In den folgenden Abschnitten werden Konfigurationen in DicomConfig und die Migration zu DicomTagConfig beschrieben.

TagFilterProfile bis ProfileType

Ersetzen Sie das Objekt DicomConfig TagFilterProfile durch das Objekt DicomTagConfig ProfileType. Dieselben vier Profile, die in TagFilterProfileType verfügbar sind, sind auch in ProfileType verfügbar.

Das folgende Beispiel zeigt, wie eine Anfrage von TagFilterProfile zu ProfileType migriert wird:

DicomConfig	DicomTagConfig
"config": { "dicom": { "filterProfile": enum(TagFilterProfile) } }	"config": { "dicomTagConfig": { "profileType": enum(ProfileType) } }

keepList und removeList

Die Felder DicomConfig keepList und removeList sind in DicomTagConfig nicht mehr verfügbar. Wenn Sie anstelle eines Profils keepList und removeList verwendet haben, um Tags anzugeben, die beibehalten oder entfernt werden sollen, müssen Sie zum neuen Objekt Action migrieren, in dem Sie das Tag-Verhalten angeben. Das Action-Objekt bietet zusätzliche Optionen zum Transformieren von Tags.

Das folgende Beispiel zeigt, wie eine Anfrage von keepList auf Action.keepTag migriert wird. In der Anfrage wird angegeben, dass der Wert des PatientID-Tags während des Vorgangs zur De-Identifikation beibehalten werden soll.

DicomConfig	DicomTagConfig
"config": { "dicom": { "keepList": { "tags": [ "PatientID" ] } } }	"config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientID" ], "keepTag": {} } ] } }

Merklisten, Entfernen-Listen und Profile kombinieren

Im DicomConfig-Objekt können Sie anhand von Beibehaltungslisten, Entfernungslisten und Profilen festlegen, ob Daten beibehalten oder entfernt werden sollen. Diese Optionen schließen sich gegenseitig aus.

Wenn Sie das DicomTagConfig-Objekt verwenden, können Sie diese Optionen kombinieren, indem Sie in einem Action-Objekt angeben, welche Tags beibehalten und welche entfernt werden sollen, und gleichzeitig ein Profil in ProfileType angeben.

Optionen, die im Action-Objekt konfiguriert sind, überschreiben die im ProfileType-Profil konfigurierten Optionen. Die Optionen im Action-Objekt werden in der Reihenfolge angewendet, in der sie in der Anfrage angegeben sind.

skipIdRedaction bis Objects.primaryIds

Ersetzen Sie das Feld skipIdRedaction im DicomConfig-Objekt durch das Feld primaryIds im DicomTagConfig-Objekt. Das Feld primaryIds im Objekt Options enthält ein PrimaryIdsOption-Objekt, in dem Sie eines der folgenden Enumerationen angeben:

• PRIMARY_IDS_OPTION_UNSPECIFIED: Standardverhalten, wenn für PrimaryIdsOption kein Wert angegeben wird. Die Standardeinstellung ist die in ProfileType angegebene Option.
• KEEP: Lassen Sie die primären IDs unverändert.
• REGEN: Die primären IDs neu generieren.

Das folgende Beispiel zeigt, wie eine Anfrage von skipIdRedaction zu Options.primaryIds migriert wird. In der Anfrage wird angegeben, dass die Werte der primären IDs während des Vorgangs zur De-Identifikation beibehalten werden:

DicomConfig	DicomTagConfig
"config": { "dicom": { "skipIdRedaction": true } }	"config": { "dicomTagConfig": { "options": { "primaryIds": "KEEP" } } }

DeidentifyConfig.ImageConfig bis DicomTagConfig.Options.ImageConfig

Ersetzen Sie das Objekt DeidentifyConfig.ImageConfig durch das Objekt DicomTagConfig.Options.ImageConfig. Die Optionen im ImageConfig-Objekt sind in beiden Versionen identisch.

Im folgenden Beispiel wird gezeigt, wie eine Anfrage von der Verwendung einer ImageConfig in DeidentifyConfig.image zur Verwendung einer ImageConfig in DeidentifyConfig.DicomTagConfig.Options.cleanImage migriert wird. In der Anfrage wird angegeben, dass beim Vorgang der De-Identifikation der gesamte Text in einem Bild entfernt werden soll:

DeidentifyConfig.image	DeidentifyConfig.DicomTagConfig.Options.cleanImage
"config": { "image": { "textRedactionMode": "REDACT_ALL_TEXT" } }	"config": { "dicomTagConfig": { "options": { "cleanImage": { "textRedactionMode": "REDACT_ALL_TEXT" } } } }

Übersicht über die De-Identifikation

De-Identifikation auf Dataset-Ebene

Rufen Sie die Methode datasets.deidentify auf, um DICOM-Daten auf Dataset-Ebene zu de-identifizieren. Die datasets.deidentify-Methode hat die folgenden Komponenten:

• Das Quell-Dataset: Ein Dataset, das DICOM-Speicher mit einer oder mehreren Instanzen enthält, die sensible Daten enthalten. Wenn Sie die Methode datasets.deidentify aufrufen, werden alle Instanzen in allen DICOM-Speichern im Dataset de-identifiziert.
• Das Ziel-Dataset: Die De-Identifikation wirkt sich nicht auf das ursprüngliche Dataset oder seine Daten aus. Stattdessen werden de-identifizierte Kopien der ursprünglichen Daten in ein neues Dataset geschrieben, das als Ziel-Dataset bezeichnet wird.
• Was zu de-identifizieren ist: Konfigurationsparameter, die angeben, wie die DICOM-Daten im Datensatz verarbeitet werden sollen. Sie können die DICOM-De-Identifikation so konfigurieren, dass DICOM-Instanzmetadaten (mithilfe von Tag-Keywords) oder eingebrannter Text in DICOM-Bildern de-identifiziert werden, indem Sie diese Parameter in einem DeidentifyConfig-Objekt angeben.

Die meisten Beispiele in diesem Leitfaden zeigen, wie DICOM-Daten auf Dataset-Ebene de-identifiziert werden.

DICOM-De-Identifikation auf Speicherebene

Wenn Sie DICOM-Daten auf DICOM-Speicherebene de-identifizieren, können Sie besser steuern, welche Daten de-identifiziert werden. Wenn Sie beispielsweise ein Dataset mit mehreren DICOM-Speichern haben, können Sie die De-Identifikation jedes DICOM-Speichers entsprechend dem jeweiligen Datentyp aufheben.

Rufen Sie die Methode dicomStores.deidentify auf, um DICOM-Daten in einem DICOM-Speicher zu de-identifizieren. Die dicomStores.deidentify-Methode hat die folgenden Komponenten:

• Der DICOM-Speicher für Quellen: Ein DICOM-Speicher mit einer oder mehreren Instanzen, die vertrauliche Daten enthalten. Wenn Sie den Vorgang dicomStores.deidentify aufrufen, werden alle Instanzen im DICOM-Speicher de-identifiziert.
• Der Ziel-DICOM-Speicher: Die De-Identifikation wirkt sich nicht auf den ursprünglichen DICOM-Speicher oder seine Daten aus. Stattdessen werden de-identifizierte Kopien der Originaldaten in den DICOM-Zielspeicher geschrieben. Der DICOM-Zielspeicher muss bereits vorhanden sein.
• Welche Elemente de-identifiziert werden sollen: Konfigurationsparameter, die angeben, wie der DICOM-Speicher verarbeitet werden soll. Sie können die DICOM-De-Identifikation so konfigurieren, dass DICOM-Instanzmetadaten (mithilfe von Tag-Keywords) oder eingebrannter Text in DICOM-Bildern de-identifiziert werden, indem Sie diese Parameter in einem DeidentifyConfig-Objekt angeben.

Ein Beispiel zum De-Identifizieren von DICOM-Daten auf DICOM-Speicherebene finden Sie unter Daten auf DICOM-Speicherebene de-identifizieren.

Filter

Wenn Sie DICOM-Daten auf DICOM-Speicherebene de-identifizieren, können Sie einen Teil der Daten im DICOM-Speicher de-identifizieren, indem Sie eine Filterdatei konfigurieren und die Datei in der dicomStores.deidentify-Anfrage angeben. Ein Beispiel finden Sie unter Teilmenge eines DICOM-Speichers de-identifizieren.

Beispiele – Übersicht

Die Beispiele in diesem Leitfaden verwenden eine einzelne DICOM-Instanz mit dem Namen dicom_deid_instance_sample.dcm. Sie können jedoch auch mehrere Instanzen de-identifizieren. Wenn Sie die Beispiel-DICOM-Instanz in den Beispielen auf dieser Seite verwenden möchten, laden Sie die Datei auf Ihren lokalen Computer herunter und folgen Sie der Anleitung unter DICOM-Daten speichern, um sie in einem DICOM-Speicher zu speichern.

In den folgenden Abschnitten sehen Sie, wie das Bild in der DICOM-Instanz und die Metadaten in der Instanz aussehen.

Beispielbild

Einige Beispiele auf dieser Seite enthalten eine Ausgabe des de-identifizierten Bildes. In jedem Beispiel wird das folgende Originalbild als Eingabe verwendet. Sie können das Ausgabebild jedes De-Identifizierungsvorgangs mit diesem Originalbild vergleichen, um die Auswirkungen des Vorgangs zu sehen:

Beispielmetadaten

Die meisten Beispiele auf dieser Seite enthalten eine Ausgabe der geänderten Metadaten in der DICOM-Instanz. Für jedes Beispiel werden die folgenden ursprünglichen Metadaten als Eingabe verwendet. Sie können die Ausgabemetadaten jedes De-Identifizierungsvorgangs mit diesen ursprünglichen Metadaten vergleichen, um die Auswirkungen der De-Identifizierung zu sehen:

[
  {
    "00020002": {
      "vr": "UI",
      "Value": [
        "1.2.840.10008.5.1.4.1.1.7"
      ]
    },
    "00020003": {
      "vr": "UI",
      "Value": [
        "1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695"
      ]
    },
    "00020010": {
      "vr": "UI",
      "Value": [
        "1.2.840.10008.1.2.4.50"
      ]
    },
    "00020012": {
      "vr": "UI",
      "Value": [
        "1.2.276.0.7230010.3.0.3.6.1"
      ]
    },
    "00020013": {
      "vr": "SH",
      "Value": [
        "OFFIS_DCMTK_361"
      ]
    },
    "00080005": {
      "vr": "CS",
      "Value": [
        "ISO_IR 100"
      ]
    },
    "00080016": {
      "vr": "UI",
      "Value": [
        "1.2.840.10008.5.1.4.1.1.7"
      ]
    },
    "00080018": {
      "vr": "UI",
      "Value": [
        "1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695"
      ]
    },
    "00080020": {
      "vr": "DA",
      "Value": [
        "20110909"
      ]
    },
    "00080030": {
      "vr": "TM",
      "Value": [
        "110032"
      ]
    },
    "00080050": {
      "vr": "SH"
    },
    "00080064": {
      "vr": "CS",
      "Value": [
        "WSD"
      ]
    },
    "00080070": {
      "vr": "LO",
      "Value": [
        "Manufacturer"
      ]
    },
    "00080090": {
      "vr": "PN",
      "Value": [
        {
          "Alphabetic": "John Doe"
        }
      ]
    },
    "00081090": {
      "vr": "LO",
      "Value": [
        "ABC1"
      ]
    },
    "00100010": {
      "vr": "PN",
      "Value": [
        {
          "Alphabetic": "Ann Johnson"
        }
      ]
    },
    "00100020": {
      "vr": "LO",
      "Value": [
        "S1214223-1"
      ]
    },
    "00100030": {
      "vr": "DA",
      "Value": [
        "19880812"
      ]
    },
    "00100040": {
      "vr": "CS",
      "Value": [
        "F"
      ]
    },
    "0020000D": {
      "vr": "UI",
      "Value": [
        "2.25.70541616638819138568043293671559322355"
      ]
    },
    "0020000E": {
      "vr": "UI",
      "Value": [
        "1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694"
      ]
    },
    "00200010": {
      "vr": "SH"
    },
    "00200011": {
      "vr": "IS"
    },
    "00200013": {
      "vr": "IS"
    },
    "00200020": {
      "vr": "CS"
    },
    "00280002": {
      "vr": "US",
      "Value": [
        3
      ]
    },
    "00280004": {
      "vr": "CS",
      "Value": [
        "YBR_FULL_422"
      ]
    },
    "00280006": {
      "vr": "US",
      "Value": [
        0
      ]
    },
    "00280010": {
      "vr": "US",
      "Value": [
        1024
      ]
    },
    "00280011": {
      "vr": "US",
      "Value": [
        1024
      ]
    },
    "00280100": {
      "vr": "US",
      "Value": [
        8
      ]
    },
    "00280101": {
      "vr": "US",
      "Value": [
        8
      ]
    },
    "00280102": {
      "vr": "US",
      "Value": [
        7
      ]
    },
    "00280103": {
      "vr": "US",
      "Value": [
        0
      ]
    },
    "00282110": {
      "vr": "CS",
      "Value": [
        "01"
      ]
    },
    "00282114": {
      "vr": "CS",
      "Value": [
        "ISO_10918_1"
      ]
    }
  }
]

Eingebrannten Text aus Bildern entfernen

Sie können eingebrannten Text in DICOM-Bildern mit dem ImageConfig-Objekt in einem Action-Objekt de-identifizieren. Innerhalb von ImageConfig können Sie angeben, welche infoTypes ein- oder ausgeschlossen werden sollen, und wie Text mit dem Objekt TextRedactionMode entfernt werden soll.

Gesamten Text entfernen

In den folgenden Beispielen wird gezeigt, wie eine DICOM-Instanz de-identifiziert wird, indem TextRedactionMode auf REDACT_ALL_TEXT gesetzt wird. Bei dieser Konfiguration wird der gesamte eingebrannte Text im Bild entfernt.

REST

1. De-identifizieren Sie das Dataset.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden

   JSON-Text der Anfrage:

   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "options": {
           "cleanImage": {
             "textRedactionMode": "REDACT_ALL_TEXT"
           }
         }
       }
     }
   }
   

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   cat > request.json << 'EOF'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "options": {
           "cleanImage": {
             "textRedactionMode": "REDACT_ALL_TEXT"
           }
         }
       }
     }
   }
   EOF

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   @'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "options": {
           "cleanImage": {
             "textRedactionMode": "REDACT_ALL_TEXT"
           }
         }
       }
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content

   Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen zusätzliche Zeit in Anspruch nehmen kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
   }
   

2. Mit der Methode projects.locations.datasets.operations.get können Sie den Status des Vorgangs mit langer Ausführungszeit abrufen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe sieht so aus. Wenn die Antwort "done": true enthält, ist der lang andauernde Vorgang abgeschlossen.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
       "apiMethodName": "google.cloud.healthcare.v1beta1.dataset.DatasetService.DeidentifyDataset",
       "createTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "endTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "logsUrl": "https://console.cloud.google.com/CLOUD_LOGGING_URL"
       "counter": {
         "success": "SUCCESS_COUNT",
         // If there were any failures, they display in the `failure` field.
         "failure": "FAILURE_COUNT"
       }
     },
     "done": true,
     // The `response` field only displays if there were no errors.
     "response": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.deidentify.DeidentifySummary",
       
     },
     // If there were any errors, an `error` field displays instead of a `response` field.
     // See Troubleshooting long-running operations for a list of response codes.
     "error": {
       "code": ERROR_CODE,
       "message": "DESCRIPTION",
       "details": [
         {
           "@type": "...",
           FIELD1: ...,
           ...
         }
       ]
     }
   }
   

3. Nach erfolgreicher De-Identifikation können Sie die Metadaten für die de-identifizierte Instanz abrufen, um zu sehen, wie sie geändert wurde. Die de-identifizierte Instanz hat eine neue Studien-UID, eine Serien-UID und eine Instanz-UID. Daher müssen Sie zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content

   Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

   Antwort

   [
     {
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080090": {
         "vr": "PN"
       },
       "00100010": {
         "vr": "PN"
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200013": {
         "vr": "IS"
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       }
     }
   ]
   

   Die folgende Tabelle zeigt, wie sich die Studien-UID, die Serien-UID und die Instanz-UID geändert haben:

   	Metadaten der ursprünglichen Instanz	De-identifizierte Instanzmetadaten
   Studien-UID (0020000D)	2.25.70541616638819138568043293671559322355	1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
   Serien-UID (0020000E)	1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694	1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
   Instanz-UID (00080018)	1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695	1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029

4. Rufen Sie mit den neuen Werten die Metadaten für die Instanz ab.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe enthält die neuen Metadaten. Sie können die neuen Metadaten mit den ursprünglichen Metadaten vergleichen, um die Auswirkungen der Transformation zu sehen.

   Antwort

   [
     {
       "00020002": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00020003": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00020010": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.1.2.4.50"
         ]
       },
       "00020012": {
         "vr": "UI",
         "Value": [
           "1.2.40.0.13.1.3"
         ]
       },
       "00020013": {
         "vr": "SH",
         "Value": [
           "dcm4che-null"
         ]
       },
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080064": {
         "vr": "CS",
         "Value": [
           "WSD"
         ]
       },
       "00080070": {
         "vr": "LO",
         "Value": [
           "Manufacturer"
         ]
       },
       "00080090": {
         "vr": "PN"
       },
       "00081090": {
         "vr": "LO",
         "Value": [
           "ABC1"
         ]
       },
       "00100010": {
         "vr": "PN"
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200011": {
         "vr": "IS"
       },
       "00200013": {
         "vr": "IS"
       },
       "00200020": {
         "vr": "CS"
       },
       "00280002": {
         "vr": "US",
         "Value": [
           3
         ]
       },
       "00280004": {
         "vr": "CS",
         "Value": [
           "YBR_FULL_422"
         ]
       },
       "00280006": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280101": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280102": {
         "vr": "US",
         "Value": [
           7
         ]
       },
       "00280103": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00282110": {
         "vr": "CS",
         "Value": [
           "01"
         ]
       },
       "00282114": {
         "vr": "CS",
         "Value": [
           "ISO_10918_1"
         ]
       }
     }
   ]
   

Nach der De-Identifikation des Bildes mit REDACT_ALL_TEXT sieht es so aus: Der eingebrannte Text am unteren Rand des Bildes wurde entfernt.

Abbildung 1. Die DICOM-Instanz nach der De-Identifikation mit REDACT_ALL_TEXT.

Vertraulichen Text mit der Option „Beschreibungen entfernen“ entfernen

In den folgenden Beispielen wird gezeigt, wie eine DICOM-Instanz de-identifiziert wird, indem TextRedactionMode auf REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS gesetzt wird.

Weitere Informationen zur Option CleanDescriptorsOption finden Sie unter Text mithilfe der kontextbezogenen De-Identifikation de-identifizieren.

REST

1. De-identifizieren Sie das Dataset.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden

   JSON-Text der Anfrage:

   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "options": {
           "cleanImage": {
             "textRedactionMode": "REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS"
           }
         }
       }
     }
   }
   

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   cat > request.json << 'EOF'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "options": {
           "cleanImage": {
             "textRedactionMode": "REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS"
           }
         }
       }
     }
   }
   EOF

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   @'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "options": {
           "cleanImage": {
             "textRedactionMode": "REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS"
           }
         }
       }
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content

   Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen zusätzliche Zeit in Anspruch nehmen kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
   }
   

2. Mit der Methode projects.locations.datasets.operations.get können Sie den Status des Vorgangs mit langer Ausführungszeit abrufen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe sieht so aus. Wenn die Antwort "done": true enthält, ist der lang andauernde Vorgang abgeschlossen.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
       "apiMethodName": "google.cloud.healthcare.v1beta1.dataset.DatasetService.DeidentifyDataset",
       "createTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "endTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "logsUrl": "https://console.cloud.google.com/CLOUD_LOGGING_URL"
       "counter": {
         "success": "SUCCESS_COUNT",
         // If there were any failures, they display in the `failure` field.
         "failure": "FAILURE_COUNT"
       }
     },
     "done": true,
     // The `response` field only displays if there were no errors.
     "response": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.deidentify.DeidentifySummary",
       
     },
     // If there were any errors, an `error` field displays instead of a `response` field.
     // See Troubleshooting long-running operations for a list of response codes.
     "error": {
       "code": ERROR_CODE,
       "message": "DESCRIPTION",
       "details": [
         {
           "@type": "...",
           FIELD1: ...,
           ...
         }
       ]
     }
   }
   

3. Nach erfolgreicher De-Identifikation können Sie die Metadaten für die de-identifizierte Instanz abrufen, um zu sehen, wie sie geändert wurde. Die de-identifizierte Instanz hat eine neue Studien-UID, eine Serien-UID und eine Instanz-UID. Daher müssen Sie zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content

   Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

   Antwort

   [
     {
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080090": {
         "vr": "PN"
       },
       "00100010": {
         "vr": "PN"
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200013": {
         "vr": "IS"
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       }
     }
   ]
   

   Die folgende Tabelle zeigt, wie sich die Studien-UID, die Serien-UID und die Instanz-UID geändert haben:

   	Metadaten der ursprünglichen Instanz	De-identifizierte Instanzmetadaten
   Studien-UID (0020000D)	2.25.70541616638819138568043293671559322355	1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
   Serien-UID (0020000E)	1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694	1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
   Instanz-UID (00080018)	1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695	1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029

4. Rufen Sie mit den neuen Werten die Metadaten für die Instanz ab.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe enthält die neuen Metadaten. Sie können die neuen Metadaten mit den ursprünglichen Metadaten vergleichen, um die Auswirkungen der Transformation zu sehen.

   Antwort

   [
     {
       "00020002": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00020003": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00020010": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.1.2.4.50"
         ]
       },
       "00020012": {
         "vr": "UI",
         "Value": [
           "1.2.40.0.13.1.3"
         ]
       },
       "00020013": {
         "vr": "SH",
         "Value": [
           "dcm4che-null"
         ]
       },
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080064": {
         "vr": "CS",
         "Value": [
           "WSD"
         ]
       },
       "00080070": {
         "vr": "LO",
         "Value": [
           "Manufacturer"
         ]
       },
       "00080090": {
         "vr": "PN"
       },
       "00081090": {
         "vr": "LO",
         "Value": [
           "ABC1"
         ]
       },
       "00100010": {
         "vr": "PN"
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200011": {
         "vr": "IS"
       },
       "00200013": {
         "vr": "IS"
       },
       "00200020": {
         "vr": "CS"
       },
       "00280002": {
         "vr": "US",
         "Value": [
           3
         ]
       },
       "00280004": {
         "vr": "CS",
         "Value": [
           "YBR_FULL_422"
         ]
       },
       "00280006": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280101": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280102": {
         "vr": "US",
         "Value": [
           7
         ]
       },
       "00280103": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00282110": {
         "vr": "CS",
         "Value": [
           "01"
         ]
       },
       "00282114": {
         "vr": "CS",
         "Value": [
           "ISO_10918_1"
         ]
       }
     }
   ]
   

Nach der De-Identifikation des Bildes mit REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS sieht es so aus: Beachten Sie, dass nicht der gesamte eingebrannte Text am unteren Rand des Bildes entfernt wurde. Der Text Female wird weiterhin angezeigt, da PatientSex (0010,0040) nicht zu den Standard-DICOM-infoTypes gehört.

Abbildung 2. Die DICOM-Instanz nach der De-Identifikation mit REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS.

DICOM-Tags de-identifizieren

Sie können DICOM-Instanzen anhand von Tag-Keywords in den DICOM-Metadaten de-identifizieren.

Die folgenden Tag-Filtermethoden stehen im Objekt DicomTagConfig Action verfügbar:

• KeepTag
• RemoveTag
• DeleteTag
• ResetTag
• CleanTextTag
• cleanImageTag
• RegenUidTag
• RecurseTag

Sie geben jede Action-Option als Liste von DICOM-Tag-IDs, -Namen oder -Wertdarstellungen (Value Representations, VRs) an. Die Option führt dann eine Aktion auf die Tags in der Liste aus. Sie können für eine Liste von Tags nicht mehr als eine Action-Option angeben.

Jedes Action-Objekt enthält eine queries[]-Liste, in der Sie eine Liste von Tags angeben. Die folgenden Tag-Formate werden unterstützt:

• Tag-IDs, z. B. "00100010"
• Tag-Namen wie "PatientName"
• Wertedarstellungen (Value Representations, VR), z. B. "PN"

Die Anzahl der Tags, die in der Liste queries[] angegeben werden können, ist nicht begrenzt. Auf jedes Tag kann jedoch nur eine Action-Option angewendet werden. Wenn Sie verschiedene Tags mit unterschiedlichen Action-Optionen angeben möchten, müssen Sie mehrere Action-Objekte angeben.

Tags beibehalten

Sie können verhindern, dass die Werte von Tags entfernt werden, indem Sie die Tags in einem KeepTag-Objekt im DicomTagConfig-Objekt angeben.

Wenn du ein gültiges DICOM-Objekt mit einem KeepTag-Objekt erstellen möchtest, gib die Werte MINIMAL_KEEP_LIST_PROFILE oder DEIDENTIFY_TAG_CONTENTS im ProfileType-Objekt an.

Wenn Sie eines dieser Profile angeben, werden die folgenden Tags automatisch beibehalten, damit die de-identifizierte DICOM-Instanz ein gültiges DICOM-Format hat:

• StudyInstanceUID
• SeriesInstanceUID
• SOPInstanceUID
• TransferSyntaxUID
• MediaStorageSOPInstanceUID
• MediaStorageSOPClassUID
• PixelData
• Rows
• Columns
• SamplesPerPixel
• BitsAllocated
• BitsStored
• Highbit
• PhotometricInterpretation
• PixelRepresentation
• NumberOfFrames
• PlanarConfiguration
• PixelAspectRatio
• SmallestImagePixelValue
• LargestImagePixelValue
• RedPaletteColorLookupTableDescriptor
• GreenPaletteColorLookupTableDescriptor
• BluePaletteColorLookupTableDescriptor
• RedPaletteColorLookupTableData
• GreenPaletteColorLookupTableData
• BluePaletteColorLookupTableData
• ICCProfile
• ColorSpace
• WindowCenter
• WindowWidth
• VOILUTFunction

Die Werte für einige der vorherigen Tags werden neu generiert, d. h., die Werte werden durch eine deterministische Transformation durch einen anderen Wert ersetzt. Weitere Informationen finden Sie unter Option „UIDs beibehalten“ im DICOM-Standard.

Die Werte StudyInstanceUID, SeriesInstanceUID, SOPInstanceUID und MediaStorageSOPInstanceUID werden als „primäre IDs“ bezeichnet. Um festzulegen, wie Primär-IDs transformiert werden, geben Sie einen Wert in PrimaryIdsOption an.

In den folgenden Beispielen wird gezeigt, wie Sie mit dem KeepTag-Objekt die Werte bestimmter Tags bei der De-Identifikation unverändert lassen. Das PatientName-Tag wird der Liste queries[] hinzugefügt, damit der PatientName-Wert bei der De-Identifikation nicht entfernt wird.

Da PrimaryIdsOption im Beispiel nicht angegeben ist, wird für das Feld primaryIds standardmäßig PRIMARY_IDS_OPTION_UNSPECIFIED festgelegt, was dem Wert in ProfileType entspricht. Da auch ProfileType nicht angegeben ist, wird für das Feld profileType standardmäßig PROFILE_TYPE_UNSPECIFIED verwendet. Dadurch werden Tags basierend auf dem Basisprofil für Attributvertraulichkeit (DICOM-Standard Version 2018e) entfernt.

REST

1. De-identifizieren Sie das Dataset.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden

   JSON-Text der Anfrage:

   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PatientName"
             ],
             "keepTag": {}
           }
         ]
       }
     }
   }
   

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   cat > request.json << 'EOF'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PatientName"
             ],
             "keepTag": {}
           }
         ]
       }
     }
   }
   EOF

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   @'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PatientName"
             ],
             "keepTag": {}
           }
         ]
       }
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content

   Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen zusätzliche Zeit in Anspruch nehmen kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
   }
   

2. Mit der Methode projects.locations.datasets.operations.get können Sie den Status des Vorgangs mit langer Ausführungszeit abrufen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe sieht so aus. Wenn die Antwort "done": true enthält, ist der lang andauernde Vorgang abgeschlossen.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
       "apiMethodName": "google.cloud.healthcare.v1beta1.dataset.DatasetService.DeidentifyDataset",
       "createTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "endTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "logsUrl": "https://console.cloud.google.com/CLOUD_LOGGING_URL"
       "counter": {
         "success": "SUCCESS_COUNT",
         // If there were any failures, they display in the `failure` field.
         "failure": "FAILURE_COUNT"
       }
     },
     "done": true,
     // The `response` field only displays if there were no errors.
     "response": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.deidentify.DeidentifySummary",
       
     },
     // If there were any errors, an `error` field displays instead of a `response` field.
     // See Troubleshooting long-running operations for a list of response codes.
     "error": {
       "code": ERROR_CODE,
       "message": "DESCRIPTION",
       "details": [
         {
           "@type": "...",
           FIELD1: ...,
           ...
         }
       ]
     }
   }
   

3. Nach erfolgreicher De-Identifikation können Sie die Metadaten für die de-identifizierte Instanz abrufen, um zu sehen, wie sie geändert wurde. Die de-identifizierte Instanz hat eine neue Studien-UID, eine Serien-UID und eine Instanz-UID. Daher müssen Sie zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content

   Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

   Antwort

   [
     {
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080090": {
         "vr": "PN"
       },
       "00100010": {
         "vr": "PN",
         "Value": [
           {
             "Alphabetic": "Ann Johnson"
           }
         ]
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200013": {
         "vr": "IS"
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       }
     }
   ]
   

   Die folgende Tabelle zeigt, wie sich die Studien-UID, die Serien-UID und die Instanz-UID geändert haben:

   	Metadaten der ursprünglichen Instanz	De-identifizierte Instanzmetadaten
   Studien-UID (0020000D)	2.25.70541616638819138568043293671559322355	1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
   Serien-UID (0020000E)	1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694	1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
   Instanz-UID (00080018)	1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695	1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029

4. Rufen Sie mit den neuen Werten die Metadaten für die Instanz ab.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe enthält die neuen Metadaten. Sie können die neuen Metadaten mit den ursprünglichen Metadaten vergleichen, um die Auswirkungen der Transformation zu sehen.

   Antwort

   [
     {
       "00020002": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00020003": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00020010": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.1.2.4.50"
         ]
       },
       "00020012": {
         "vr": "UI",
         "Value": [
           "1.2.40.0.13.1.3"
         ]
       },
       "00020013": {
         "vr": "SH",
         "Value": [
           "dcm4che-null"
         ]
       },
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080064": {
         "vr": "CS",
         "Value": [
           "WSD"
         ]
       },
       "00080070": {
         "vr": "LO",
         "Value": [
           "Manufacturer"
         ]
       },
       "00080090": {
         "vr": "PN"
       },
       "00081090": {
         "vr": "LO",
         "Value": [
           "ABC1"
         ]
       },
       "00100010": {
         "vr": "PN",
         "Value": [
           {
             "Alphabetic": "Ann Johnson"
           }
         ]
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200011": {
         "vr": "IS"
       },
       "00200013": {
         "vr": "IS"
       },
       "00200020": {
         "vr": "CS"
       },
       "00280002": {
         "vr": "US",
         "Value": [
           3
         ]
       },
       "00280004": {
         "vr": "CS",
         "Value": [
           "YBR_FULL_422"
         ]
       },
       "00280006": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280101": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280102": {
         "vr": "US",
         "Value": [
           7
         ]
       },
       "00280103": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00282110": {
         "vr": "CS",
         "Value": [
           "01"
         ]
       },
       "00282114": {
         "vr": "CS",
         "Value": [
           "ISO_10918_1"
         ]
       }
     }
   ]
   

Tags entfernen

In den folgenden Beispielen wird gezeigt, wie Sie mit dem RemoveTag-Objekt die Werte bestimmter Tags bei der De-Identifizierung entfernen. Ein entferntes Tag wird durch einen leeren Wert ersetzt.

In den folgenden Beispielen wird das PatientName-Tag der Liste queries[] hinzugefügt. Daher wird sein Wert bei der De-Identifikation durch einen leeren Wert ersetzt.

REST

1. De-identifizieren Sie das Dataset.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden

   JSON-Text der Anfrage:

   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
                "PatientName"
             ],
             "removeTag": {}
           }
         ]
       }
     }
   }
   

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   cat > request.json << 'EOF'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
                "PatientName"
             ],
             "removeTag": {}
           }
         ]
       }
     }
   }
   EOF

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   @'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
                "PatientName"
             ],
             "removeTag": {}
           }
         ]
       }
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content

   Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen zusätzliche Zeit in Anspruch nehmen kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
   }
   

2. Mit der Methode projects.locations.datasets.operations.get können Sie den Status des Vorgangs mit langer Ausführungszeit abrufen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe sieht so aus. Wenn die Antwort "done": true enthält, ist der lang andauernde Vorgang abgeschlossen.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
       "apiMethodName": "google.cloud.healthcare.v1beta1.dataset.DatasetService.DeidentifyDataset",
       "createTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "endTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "logsUrl": "https://console.cloud.google.com/CLOUD_LOGGING_URL"
       "counter": {
         "success": "SUCCESS_COUNT",
         // If there were any failures, they display in the `failure` field.
         "failure": "FAILURE_COUNT"
       }
     },
     "done": true,
     // The `response` field only displays if there were no errors.
     "response": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.deidentify.DeidentifySummary",
       
     },
     // If there were any errors, an `error` field displays instead of a `response` field.
     // See Troubleshooting long-running operations for a list of response codes.
     "error": {
       "code": ERROR_CODE,
       "message": "DESCRIPTION",
       "details": [
         {
           "@type": "...",
           FIELD1: ...,
           ...
         }
       ]
     }
   }
   

3. Nach erfolgreicher De-Identifikation können Sie die Metadaten für die de-identifizierte Instanz abrufen, um zu sehen, wie sie geändert wurde. Die de-identifizierte Instanz hat eine neue Studien-UID, eine Serien-UID und eine Instanz-UID. Daher müssen Sie zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content

   Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

   Antwort

   [
     {
       "00080005": {
         "vr": "CS"
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080090": {
         "vr": "PN"
       },
       "00100010": {
         "vr": "PN"
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200013": {
         "vr": "IS"
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       }
     }
   ]
   

   Die folgende Tabelle zeigt, wie sich die Studien-UID, die Serien-UID und die Instanz-UID geändert haben:

   	Metadaten der ursprünglichen Instanz	De-identifizierte Instanzmetadaten
   Studien-UID (0020000D)	2.25.70541616638819138568043293671559322355	1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
   Serien-UID (0020000E)	1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694	1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
   Instanz-UID (00080018)	1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695	1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029

4. Rufen Sie mit den neuen Werten die Metadaten für die Instanz ab.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe enthält die neuen Metadaten. Sie können die neuen Metadaten mit den ursprünglichen Metadaten vergleichen, um die Auswirkungen der Transformation zu sehen.

   Antwort

   [
     {
       "00020002": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00020003": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00020010": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.1.2.4.50"
         ]
       },
       "00020012": {
         "vr": "UI",
         "Value": [
           "1.2.40.0.13.1.3"
         ]
       },
       "00020013": {
         "vr": "SH",
         "Value": [
           "dcm4che-null"
         ]
       },
       "00080005": {
         "vr": "CS"
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080064": {
         "vr": "CS",
         "Value": [
           "WSD"
         ]
       },
       "00080070": {
         "vr": "LO",
         "Value": [
           "Manufacturer"
         ]
       },
       "00080090": {
         "vr": "PN"
       },
       "00081090": {
         "vr": "LO",
         "Value": [
           "ABC1"
         ]
       },
       "00100010": {
         "vr": "PN"
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200011": {
         "vr": "IS"
       },
       "00200013": {
         "vr": "IS"
       },
       "00200020": {
         "vr": "CS"
       },
       "00280002": {
         "vr": "US",
         "Value": [
           3
         ]
       },
       "00280004": {
         "vr": "CS",
         "Value": [
           "YBR_FULL_422"
         ]
       },
       "00280006": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280101": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280102": {
         "vr": "US",
         "Value": [
           7
         ]
       },
       "00280103": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00282110": {
         "vr": "CS",
         "Value": [
           "01"
         ]
       },
       "00282114": {
         "vr": "CS",
         "Value": [
           "ISO_10918_1"
         ]
       }
     }
   ]
   

Tags löschen

In den folgenden Beispielen wird gezeigt, wie Sie mit dem Objekt DeleteTag bestimmte Tags während der De-Identifizierung löschen.

REST

1. De-identifizieren Sie das Dataset.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden

   JSON-Text der Anfrage:

   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PatientName"
             ],
             "deleteTag": {}
           }
         ]
       }
     }
   }
   

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   cat > request.json << 'EOF'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PatientName"
             ],
             "deleteTag": {}
           }
         ]
       }
     }
   }
   EOF

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   @'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PatientName"
             ],
             "deleteTag": {}
           }
         ]
       }
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content

   Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen zusätzliche Zeit in Anspruch nehmen kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
   }
   

2. Mit der Methode projects.locations.datasets.operations.get können Sie den Status des Vorgangs mit langer Ausführungszeit abrufen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe sieht so aus. Wenn die Antwort "done": true enthält, ist der lang andauernde Vorgang abgeschlossen.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
       "apiMethodName": "google.cloud.healthcare.v1beta1.dataset.DatasetService.DeidentifyDataset",
       "createTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "endTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "logsUrl": "https://console.cloud.google.com/CLOUD_LOGGING_URL"
       "counter": {
         "success": "SUCCESS_COUNT",
         // If there were any failures, they display in the `failure` field.
         "failure": "FAILURE_COUNT"
       }
     },
     "done": true,
     // The `response` field only displays if there were no errors.
     "response": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.deidentify.DeidentifySummary",
       
     },
     // If there were any errors, an `error` field displays instead of a `response` field.
     // See Troubleshooting long-running operations for a list of response codes.
     "error": {
       "code": ERROR_CODE,
       "message": "DESCRIPTION",
       "details": [
         {
           "@type": "...",
           FIELD1: ...,
           ...
         }
       ]
     }
   }
   

3. Nach erfolgreicher De-Identifikation können Sie die Metadaten für die de-identifizierte Instanz abrufen, um zu sehen, wie sie geändert wurde. Die de-identifizierte Instanz hat eine neue Studien-UID, eine Serien-UID und eine Instanz-UID. Daher müssen Sie zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content

   Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

   Antwort

   [
     {
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080090": {
         "vr": "PN"
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200013": {
         "vr": "IS"
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       }
     }
   ]
   

   Die folgende Tabelle zeigt, wie sich die Studien-UID, die Serien-UID und die Instanz-UID geändert haben:

   	Metadaten der ursprünglichen Instanz	De-identifizierte Instanzmetadaten
   Studien-UID (0020000D)	2.25.70541616638819138568043293671559322355	1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
   Serien-UID (0020000E)	1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694	1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
   Instanz-UID (00080018)	1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695	1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029

4. Rufen Sie mit den neuen Werten die Metadaten für die Instanz ab.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe enthält die neuen Metadaten. Sie können die neuen Metadaten mit den ursprünglichen Metadaten vergleichen, um die Auswirkungen der Transformation zu sehen.

   Antwort

   [
     {
       "00020002": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00020003": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00020010": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.1.2.4.50"
         ]
       },
       "00020012": {
         "vr": "UI",
         "Value": [
           "1.2.40.0.13.1.3"
         ]
       },
       "00020013": {
         "vr": "SH",
         "Value": [
           "dcm4che-null"
         ]
       },
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080064": {
         "vr": "CS",
         "Value": [
           "WSD"
         ]
       },
       "00080070": {
         "vr": "LO",
         "Value": [
           "Manufacturer"
         ]
       },
       "00080090": {
         "vr": "PN"
       },
       "00081090": {
         "vr": "LO",
         "Value": [
           "ABC1"
         ]
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200011": {
         "vr": "IS"
       },
       "00200013": {
         "vr": "IS"
       },
       "00200020": {
         "vr": "CS"
       },
       "00280002": {
         "vr": "US",
         "Value": [
           3
         ]
       },
       "00280004": {
         "vr": "CS",
         "Value": [
           "YBR_FULL_422"
         ]
       },
       "00280006": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280101": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280102": {
         "vr": "US",
         "Value": [
           7
         ]
       },
       "00280103": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00282110": {
         "vr": "CS",
         "Value": [
           "01"
         ]
       },
       "00282114": {
         "vr": "CS",
         "Value": [
           "ISO_10918_1"
         ]
       }
     }
   ]
   

Tags auf einen Platzhalterwert zurücksetzen

In den folgenden Beispielen wird gezeigt, wie Sie mit dem ResetTag-Objekt den Wert von Tags während der De-Identifikation auf den String PLACEHOLDER festlegen.

REST

1. De-identifizieren Sie das Dataset.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden

   JSON-Text der Anfrage:

   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PatientName"
             ],
             "resetTag": {}
           }
         ]
       }
     }
   }
   

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   cat > request.json << 'EOF'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PatientName"
             ],
             "resetTag": {}
           }
         ]
       }
     }
   }
   EOF

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   @'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PatientName"
             ],
             "resetTag": {}
           }
         ]
       }
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content

   Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen zusätzliche Zeit in Anspruch nehmen kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
   }
   

2. Mit der Methode projects.locations.datasets.operations.get können Sie den Status des Vorgangs mit langer Ausführungszeit abrufen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe sieht so aus. Wenn die Antwort "done": true enthält, ist der lang andauernde Vorgang abgeschlossen.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
       "apiMethodName": "google.cloud.healthcare.v1beta1.dataset.DatasetService.DeidentifyDataset",
       "createTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "endTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "logsUrl": "https://console.cloud.google.com/CLOUD_LOGGING_URL"
       "counter": {
         "success": "SUCCESS_COUNT",
         // If there were any failures, they display in the `failure` field.
         "failure": "FAILURE_COUNT"
       }
     },
     "done": true,
     // The `response` field only displays if there were no errors.
     "response": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.deidentify.DeidentifySummary",
       
     },
     // If there were any errors, an `error` field displays instead of a `response` field.
     // See Troubleshooting long-running operations for a list of response codes.
     "error": {
       "code": ERROR_CODE,
       "message": "DESCRIPTION",
       "details": [
         {
           "@type": "...",
           FIELD1: ...,
           ...
         }
       ]
     }
   }
   

3. Nach erfolgreicher De-Identifikation können Sie die Metadaten für die de-identifizierte Instanz abrufen, um zu sehen, wie sie geändert wurde. Die de-identifizierte Instanz hat eine neue Studien-UID, eine Serien-UID und eine Instanz-UID. Daher müssen Sie zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content

   Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

   Antwort

   [
     {
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080090": {
         "vr": "PN"
       },
       "00100010": {
         "vr": "PN",
         "Value": [
           {
             "Alphabetic": "PLACEHOLDER"
           }
         ]
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200013": {
         "vr": "IS"
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       }
     }
   ]
   

   Die folgende Tabelle zeigt, wie sich die Studien-UID, die Serien-UID und die Instanz-UID geändert haben:

   	Metadaten der ursprünglichen Instanz	De-identifizierte Instanzmetadaten
   Studien-UID (0020000D)	2.25.70541616638819138568043293671559322355	1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
   Serien-UID (0020000E)	1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694	1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
   Instanz-UID (00080018)	1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695	1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029

4. Rufen Sie mit den neuen Werten die Metadaten für die Instanz ab.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe enthält die neuen Metadaten. Sie können die neuen Metadaten mit den ursprünglichen Metadaten vergleichen, um die Auswirkungen der Transformation zu sehen.

   Antwort

   [
     {
       "00020002": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00020003": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00020010": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.1.2.4.50"
         ]
       },
       "00020012": {
         "vr": "UI",
         "Value": [
           "1.2.40.0.13.1.3"
         ]
       },
       "00020013": {
         "vr": "SH",
         "Value": [
           "dcm4che-null"
         ]
       },
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080064": {
         "vr": "CS",
         "Value": [
           "WSD"
         ]
       },
       "00080070": {
         "vr": "LO",
         "Value": [
           "Manufacturer"
         ]
       },
       "00080090": {
         "vr": "PN"
       },
       "00081090": {
         "vr": "LO",
         "Value": [
           "ABC1"
         ]
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200011": {
         "vr": "IS"
       },
       "00200013": {
         "vr": "IS"
       },
       "00200020": {
         "vr": "CS"
       },
       "00280002": {
         "vr": "US",
         "Value": [
           3
         ]
       },
       "00280004": {
         "vr": "CS",
         "Value": [
           "YBR_FULL_422"
         ]
       },
       "00280006": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280101": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280102": {
         "vr": "US",
         "Value": [
           7
         ]
       },
       "00280103": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00282110": {
         "vr": "CS",
         "Value": [
           "01"
         ]
       },
       "00282114": {
         "vr": "CS",
         "Value": [
           "ISO_10918_1"
         ]
       }
     }
   ]
   

   Beachten Sie insbesondere, dass der Wert des PatientName-Tags auf PLACEHOLDER gesetzt ist:

   Original metadata	Metadaten nach Ausführung von ResetTag
   "00100010": { "vr": "PN", "Value": [ { "Alphabetic": "Ann Johnson" } ] }	"00100010": { "vr": "PN", "Value": [ { "Alphabetic": "PLACEHOLDER" } ] }

Sensiblen Text in Tags prüfen und umwandeln

In den folgenden Beispielen wird gezeigt, wie du mit dem CleanTextTag-Objekt Tags prüfen und die Werte der Tags gemäß der Konfiguration im TextConfig-Objekt transformieren kannst.

In diesen Beispielen sind im Actions-Objekt die folgenden Optionen festgelegt:

• Ein CleanTextTag-Objekt.
• Eine queries[]-Liste mit dem DICOM-Tag PatientName.

Im TextConfig-Objekt werden die folgenden Optionen festgelegt:

• Ein InfoTypeTransformation-Objekt, das Text transformiert, der mit einem bestimmten infoType übereinstimmt.
• Ein ReplaceWithInfoTypeConfig-Objekt, das jeden übereinstimmenden Text durch den Namen des infoType ersetzt.
• Eine infoTypes[]-Liste mit dem PERSON_NAME-InfoType.

Bei diesen Konfigurationen wird beim De-Identifikationsvorgang das PatientName-Tag geprüft, mit dem PERSON_NAME-infoType abgeglichen und der Wert des Tags durch den PERSON_NAME-infoType ersetzt. Das PatientName-Tag hat die Wertedarstellung PN, eine der unterstützten Wertedarstellungen im CleanTextTag-Objekt.

REST

1. De-identifizieren Sie das Dataset.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden

   JSON-Text der Anfrage:

   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
               "PatientName"
             ],
             "cleanTextTag": {}
           }
         ]
       },
       "text": {
         "additionalTransformations": [
           {
             "infoTypes": [
               "PERSON_NAME"
             ],
             "replaceWithInfoTypeConfig": {}
           }
         ]
       }
     }
   }
   

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   cat > request.json << 'EOF'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
               "PatientName"
             ],
             "cleanTextTag": {}
           }
         ]
       },
       "text": {
         "additionalTransformations": [
           {
             "infoTypes": [
               "PERSON_NAME"
             ],
             "replaceWithInfoTypeConfig": {}
           }
         ]
       }
     }
   }
   EOF

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   @'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
               "PatientName"
             ],
             "cleanTextTag": {}
           }
         ]
       },
       "text": {
         "additionalTransformations": [
           {
             "infoTypes": [
               "PERSON_NAME"
             ],
             "replaceWithInfoTypeConfig": {}
           }
         ]
       }
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content

   Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen zusätzliche Zeit in Anspruch nehmen kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
   }
   

2. Mit der Methode projects.locations.datasets.operations.get können Sie den Status des Vorgangs mit langer Ausführungszeit abrufen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe sieht so aus. Wenn die Antwort "done": true enthält, ist der lang andauernde Vorgang abgeschlossen.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
       "apiMethodName": "google.cloud.healthcare.v1beta1.dataset.DatasetService.DeidentifyDataset",
       "createTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "endTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "logsUrl": "https://console.cloud.google.com/CLOUD_LOGGING_URL"
       "counter": {
         "success": "SUCCESS_COUNT",
         // If there were any failures, they display in the `failure` field.
         "failure": "FAILURE_COUNT"
       }
     },
     "done": true,
     // The `response` field only displays if there were no errors.
     "response": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.deidentify.DeidentifySummary",
       
     },
     // If there were any errors, an `error` field displays instead of a `response` field.
     // See Troubleshooting long-running operations for a list of response codes.
     "error": {
       "code": ERROR_CODE,
       "message": "DESCRIPTION",
       "details": [
         {
           "@type": "...",
           FIELD1: ...,
           ...
         }
       ]
     }
   }
   

3. Nach erfolgreicher De-Identifikation können Sie die Metadaten für die de-identifizierte Instanz abrufen, um zu sehen, wie sie geändert wurde. Die de-identifizierte Instanz hat eine neue Studien-UID, eine Serien-UID und eine Instanz-UID. Daher müssen Sie zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content

   Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

   Antwort

   [
     {
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080090": {
         "vr": "PN"
       },
       "00100010": {
         "vr": "PN",
         "Value": [
           {
             "Alphabetic": "[PERSON_NAME]"
           }
         ]
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200013": {
         "vr": "IS"
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       }
     }
   ]
   

   Die folgende Tabelle zeigt, wie sich die Studien-UID, die Serien-UID und die Instanz-UID geändert haben:

   	Metadaten der ursprünglichen Instanz	De-identifizierte Instanzmetadaten
   Studien-UID (0020000D)	2.25.70541616638819138568043293671559322355	1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
   Serien-UID (0020000E)	1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694	1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
   Instanz-UID (00080018)	1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695	1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029

4. Rufen Sie mit den neuen Werten die Metadaten für die Instanz ab.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe enthält die neuen Metadaten. Sie können die neuen Metadaten mit den ursprünglichen Metadaten vergleichen, um die Auswirkungen der Transformation zu sehen.

   Antwort

   [
     {
       "00020002": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00020003": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00020010": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.1.2.4.50"
         ]
       },
       "00020012": {
         "vr": "UI",
         "Value": [
           "1.2.40.0.13.1.3"
         ]
       },
       "00020013": {
         "vr": "SH",
         "Value": [
           "dcm4che-null"
         ]
       },
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080064": {
         "vr": "CS",
         "Value": [
           "WSD"
         ]
       },
       "00080070": {
         "vr": "LO",
         "Value": [
           "Manufacturer"
         ]
       },
       "00080090": {
         "vr": "PN"
       },
       "00081090": {
         "vr": "LO",
         "Value": [
           "ABC1"
         ]
       },
       "00100010": {
         "vr": "PN",
         "Value": [
           {
             "Alphabetic": "[PERSON_NAME]"
           }
         ]
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200011": {
         "vr": "IS"
       },
       "00200013": {
         "vr": "IS"
       },
       "00200020": {
         "vr": "CS"
       },
       "00280002": {
         "vr": "US",
         "Value": [
           3
         ]
       },
       "00280004": {
         "vr": "CS",
         "Value": [
           "YBR_FULL_422"
         ]
       },
       "00280006": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280101": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280102": {
         "vr": "US",
         "Value": [
           7
         ]
       },
       "00280103": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00282110": {
         "vr": "CS",
         "Value": [
           "01"
         ]
       },
       "00282114": {
         "vr": "CS",
         "Value": [
           "ISO_10918_1"
         ]
       }
     }
   ]
   

   Beachten Sie insbesondere, dass der Wert des PatientName-Tags auf [PERSON_NAME] gesetzt ist:

   Original metadata	Metadaten nach Ausführung von CleanTextTag
   "00100010": { "vr": "PN", "Value": [ { "Alphabetic": "Ann Johnson" } ] }	"00100010": { "vr": "PN", "Value": [ { "Alphabetic": "[PERSON_NAME]" } ] }

UID durch eine generierte UID ersetzen

In den folgenden Beispielen wird gezeigt, wie Sie mit dem RegenUidTag-Objekt eine UID durch eine neu generierte UID ersetzen. Das RegenUidTag-Objekt unterstützt nur UI.

Standardmäßig wird bei jedem Tag in den Metadaten des Samples mit einer VR von UI während der De-Identifikation eine UID generiert. Um zu zeigen, wie eine UID für ein bestimmtes Tag generiert wird, sind im Beispiel die folgenden Optionen festgelegt:

• ProfileType ist auf das Enum KEEP_ALL festgelegt, wodurch verhindert wird, dass DICOM-Metadaten de-identifiziert werden.

• PrimaryIdsOption ist auf das Enum KEEP festgelegt, wodurch die primären IDs (StudyInstanceUID, SeriesInstanceUID, SOPInstanceUID und MediaStorageSOPInstanceUID) unverändert bleiben.

Wenn diese Optionen festgelegt sind, werden keine der primären ID-UIDs in den Beispieldaten durch neu generierte Werte ersetzt. Wenn Sie dem Array Action.queries[] jedoch SOPInstanceUID hinzufügen, können Sie eine neue UID speziell für das SOPInstanceUID-Tag generieren.

REST

1. De-identifizieren Sie das Dataset.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden

   JSON-Text der Anfrage:

   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "options": {
           "primaryIds": "KEEP"
         },
         "actions": [
           {
             "queries": [
               "00080018"
             ],
             "regenUidTag": {}
           }
         ],
         "profileType": "KEEP_ALL_PROFILE"
       }
     }
   }
   

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   cat > request.json << 'EOF'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "options": {
           "primaryIds": "KEEP"
         },
         "actions": [
           {
             "queries": [
               "00080018"
             ],
             "regenUidTag": {}
           }
         ],
         "profileType": "KEEP_ALL_PROFILE"
       }
     }
   }
   EOF

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   @'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "options": {
           "primaryIds": "KEEP"
         },
         "actions": [
           {
             "queries": [
               "00080018"
             ],
             "regenUidTag": {}
           }
         ],
         "profileType": "KEEP_ALL_PROFILE"
       }
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content

   Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen zusätzliche Zeit in Anspruch nehmen kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
   }
   

2. Mit der Methode projects.locations.datasets.operations.get können Sie den Status des Vorgangs mit langer Ausführungszeit abrufen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe sieht so aus. Wenn die Antwort "done": true enthält, ist der lang andauernde Vorgang abgeschlossen.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
       "apiMethodName": "google.cloud.healthcare.v1beta1.dataset.DatasetService.DeidentifyDataset",
       "createTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "endTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "logsUrl": "https://console.cloud.google.com/CLOUD_LOGGING_URL"
       "counter": {
         "success": "SUCCESS_COUNT",
         // If there were any failures, they display in the `failure` field.
         "failure": "FAILURE_COUNT"
       }
     },
     "done": true,
     // The `response` field only displays if there were no errors.
     "response": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.deidentify.DeidentifySummary",
       
     },
     // If there were any errors, an `error` field displays instead of a `response` field.
     // See Troubleshooting long-running operations for a list of response codes.
     "error": {
       "code": ERROR_CODE,
       "message": "DESCRIPTION",
       "details": [
         {
           "@type": "...",
           FIELD1: ...,
           ...
         }
       ]
     }
   }
   

3. Nach erfolgreicher De-Identifikation können Sie die Metadaten für die de-identifizierte Instanz abrufen, um zu sehen, wie sie geändert wurde. Die de-identifizierte Instanz hat eine neue Instanz-UID, da Sie das SOPInstanceUID-Tag im Action.queries[]-Array angegeben haben. Sie müssen also zuerst im neuen Datensatz nach der de-identifizierten Instanz suchen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content

   Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

   Antwort

   [
     {
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA",
         "Value": [
           "20110909"
         ]
       },
       "00080030": {
         "vr": "TM",
         "Value": [
           "110032"
         ]
       },
       "00080050": {
         "vr": "SH"
       },
       "00080090": {
         "vr": "PN",
         "Value": [
           {
             "Alphabetic": "John Doe"
           }
         ]
       },
       "00100010": {
         "vr": "PN",
         "Value": [
           {
             "Alphabetic": "Ann Johnson"
           }
         ]
       },
       "00100020": {
         "vr": "LO",
         "Value": [
           "S1214223-1"
         ]
       },
       "00100030": {
         "vr": "DA",
         "Value": [
           "19880812"
         ]
       },
       "00100040": {
         "vr": "CS",
         "Value": [
           "F"
         ]
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "2.25.70541616638819138568043293671559322355"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200013": {
         "vr": "IS"
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       }
     }
   ]
   

   In der folgenden Tabelle sehen Sie, wie sich die Instanz-UID geändert hat:

   	Metadaten der ursprünglichen Instanz	De-identifizierte Instanzmetadaten
   Instanz-UID (00080018)	1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695	1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029

4. Rufen Sie mit dem neuen Wert die Metadaten für die Instanz ab.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/2.25.70541616638819138568043293671559322355/series/1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/2.25.70541616638819138568043293671559322355/series/1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe enthält die neuen Metadaten. Sie können die neuen Metadaten mit den ursprünglichen Metadaten vergleichen, um die Auswirkungen der Transformation zu sehen.

   Antwort

   [
     {
       "00020002": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00020003": {
         "vr": "UI",
         "Value": [
           "1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695"
         ]
       },
       "00020010": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.1.2.4.50"
         ]
       },
       "00020012": {
         "vr": "UI",
         "Value": [
           "1.2.40.0.13.1.3"
         ]
       },
       "00020013": {
         "vr": "SH",
         "Value": [
           "dcm4che-null"
         ]
       },
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA",
         "Value": [
           "20110909"
         ]
       },
       "00080030": {
         "vr": "TM",
         "Value": [
           "110032"
         ]
       },
       "00080050": {
         "vr": "SH"
       },
       "00080064": {
         "vr": "CS",
         "Value": [
           "WSD"
         ]
       },
       "00080070": {
         "vr": "LO",
         "Value": [
           "Siemens"
         ]
       },
       "00080090": {
         "vr": "PN",
         "Value": [
           {
             "Alphabetic": "John Doe"
           }
         ]
       },
       "00081090": {
         "vr": "LO",
         "Value": [
           "GGL1"
         ]
       },
       "00100010": {
         "vr": "PN",
         "Value": [
           {
             "Alphabetic": "Ann Johnson"
           }
         ]
       },
       "00100020": {
         "vr": "LO",
         "Value": [
           "S1214223-1"
         ]
       },
       "00100030": {
         "vr": "DA",
         "Value": [
           "19880812"
         ]
       },
       "00100040": {
         "vr": "CS",
         "Value": [
           "F"
         ]
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "2.25.70541616638819138568043293671559322355"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200011": {
         "vr": "IS"
       },
       "00200013": {
         "vr": "IS"
       },
       "00200020": {
         "vr": "CS"
       },
       "00280002": {
         "vr": "US",
         "Value": [
           3
         ]
       },
       "00280004": {
         "vr": "CS",
         "Value": [
           "YBR_FULL_422"
         ]
       },
       "00280006": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280101": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280102": {
         "vr": "US",
         "Value": [
           7
         ]
       },
       "00280103": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00282110": {
         "vr": "CS",
         "Value": [
           "01"
         ]
       },
       "00282114": {
         "vr": "CS",
         "Value": [
           "ISO_10918_1"
         ]
       }
     }
   ]
   

   Beachten Sie, dass nur die SOPInstanceUID eine neu generierte UID hat.

Tags in einem verschachtelten Sequence rekursiv de-identifizieren

In den folgenden Beispielen wird gezeigt, wie Sie mit dem RecurseTag-Objekt verschachtelte DICOM-Tags in einem Sequence rekursiv de-identifizieren. Das RecurseTag-Objekt unterstützt nur die SQ-VR, die VR für eine Sequence.

Informationen zur SQ-VR finden Sie unter 7.5 Verschachtelung von Datensätzen.

Die für diese Seite bereitgestellte DICOM-Beispielinstanz enthält keine DICOM-Tags mit einer SQ-Wertdarstellung. Sie können eine DICOM-Instanz mit gefälschten Daten erstellen und speichern, die die SQ-VR enthält. Führen Sie dazu die folgenden Schritte aus, die auf der Anleitung unter DICOM-Instanzen aus JSON-Metadaten und JPEG-Dateien erstellen basieren. Die DICOM-Instanz, die Sie in den folgenden Schritten erstellen, verwendet fiktive Daten und soll nur das Verhalten vonRecurseTag veranschaulichen.

1. Speichern Sie die folgenden DICOM-Metadaten in einer JSON-Datei mit dem Namen instance.json. Die Metadaten enthalten ein PhysiciansReadingStudyIdentificationSequence-Tag (00081062). Das Tag hat eine SQ-VR und enthält zwei verschachtelte PersonIdentificationCodeSequence-Tags (00401101). Die verschachtelten Tags haben ebenfalls eine SQ-VR und enthalten jeweils die folgenden verschachtelten Tags:

   • CodeValue (00080100)
   • CodingSchemeDesignator (00080102)

   [{
     "00020010": {
       "vr": "UI",
       "Value": [
         "1.2.840.10008.1.2.4.50"
       ]
     },
     "00080005": {
       "vr": "CS",
       "Value": [
         "ISO_IR 192"
       ]
     },
     "00080016": {
       "vr": "UI",
       "Value": [
         "1111111"
       ]
     },
     "00080018": {
       "vr": "UI",
       "Value": [
         "2222222"
       ]
     },
     "0020000D": {
       "vr": "UI",
       "Value": [
         "3333333"
       ]
     },
     "0020000E": {
       "vr": "UI",
       "Value": [
         "4444444"
       ]
     },
     "00280002": {
       "vr": "US",
       "Value": [
         3
       ]
     },
     "00280004": {
       "vr": "CS",
       "Value": [
         "YBR_FULL_422"
       ]
     },
     "00280006": {
       "vr": "US",
       "Value": [
         0
       ]
     },
     "00280008": {
       "vr": "IS",
       "Value": [
         1
       ]
     },
     "00280010": {
       "vr": "US",
       "Value": [
         1024
       ]
     },
     "00280011": {
       "vr": "US",
       "Value": [
         1024
       ]
     },
     "00280100": {
       "vr": "US",
       "Value": [
         8
       ]
     },
     "00280101": {
       "vr": "US",
       "Value": [
         8
       ]
     },
     "00280102": {
       "vr": "US",
       "Value": [
         7
       ]
     },
     "00280103": {
       "vr": "US",
       "Value": [
         0
       ]
     },
     "7FE00010": {
       "vr": "OB",
       "BulkDataURI": "jpeg-image"
     },
     "00081062": {
       "vr": "SQ",
       "Value": [
         {
           "00401101": {
             "vr": "SQ",
             "Value": [
               {
                 "00080100": {
                   "vr": "SH",
                   "Value": [
                     "CodeValue1"
                   ]
                 },
                 "00080102": {
                   "vr": "SH",
                   "Value": [
                     "CodingSchemeDesignator1"
                   ]
                 }
               }
             ]
           }
         },
         {
           "00401101": {
             "vr": "SQ",
             "Value": [
               {
                 "00080100": {
                   "vr": "SH",
                   "Value": [
                     "CodeValue2"
                   ]
                 },
                 "00080102": {
                   "vr": "SH",
                   "Value": [
                     "CodingSchemeDesignator2"
                   ]
                 }
               }
             ]
           }
         }
       ]
     }
   }]
   

2. Laden Sie die Datei google.jpg auf Ihren lokalen Computer herunter. Die Cloud Healthcare API DICOMweb API akzeptiert jedes JPEG-Bild, das mit JSON-Metadaten gekoppelt ist, solange die Metadaten gültig sind.

3. Führen Sie die folgenden Befehle aus, um eine öffnende Grenze (für die JSON-Metadaten), eine mittlere Grenze (für das JPEG-Bild) und eine schließende Grenze im Bild zu erstellen:

   echo -ne "--DICOMwebBoundary\r\nContent-Type: application/dicom+json\r\n\r\n" > opening.file
   echo -ne "\r\n--DICOMwebBoundary\r\nContent-Location: jpeg-image\r\nContent-Type: image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50\r\n\r\n" > middle.file
   echo -ne "\r\n--DICOMwebBoundary--" > closing.file
   

4. Umschließen Sie das google.jpg-Bild mit den mittleren und dem schließenden Grenzen. Die Ausgabedatei, die Sie an die Cloud Healthcare API senden, heißt multipart-request.file:

   cat opening.file instance.json middle.file google.jpg closing.file > multipart-request.file
   

5. Speichern Sie die Datei multipart-request.file:

   REST

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DICOM_STORE_ID: die ID des DICOM-Speichers im Quelldatensatz

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: multipart/related; type=\"application/dicom+json\"; boundary=DICOMwebBoundary" \
        --data-binary @multipart-request.file \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID/dicomWeb/studies"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -InFile multipart-request.file `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID/dicomWeb/studies" | Select-Object -Expand Content

   Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

   Antwort

   
     
       https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID/dicomWeb/studies/3333333
       
     
     
       
         
           1111111
           
         
         
           2222222
         
         
           https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID/dicomWeb/studies/3333333/series/4444444/instances/2222222
           
         
       
     
   
   

Führen Sie die folgenden Schritte aus, um die von Ihnen gespeicherte DICOM-Instanz zu de-identifizieren.

REST

1. De-identifizieren Sie das Dataset.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden

   JSON-Text der Anfrage:

   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PhysiciansReadingStudyIdentificationSequence"
             ],
             "recurseTag": {}
           }
         ]
       }
     }
   }
   

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   cat > request.json << 'EOF'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PhysiciansReadingStudyIdentificationSequence"
             ],
             "recurseTag": {}
           }
         ]
       }
     }
   }
   EOF

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   @'
   {
     "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PhysiciansReadingStudyIdentificationSequence"
             ],
             "recurseTag": {}
           }
         ]
       }
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand Content

   Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen zusätzliche Zeit in Anspruch nehmen kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
   }
   

2. Mit der Methode projects.locations.datasets.operations.get können Sie den Status des Vorgangs mit langer Ausführungszeit abrufen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe sieht so aus. Wenn die Antwort "done": true enthält, ist der lang andauernde Vorgang abgeschlossen.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
       "apiMethodName": "google.cloud.healthcare.v1beta1.dataset.DatasetService.DeidentifyDataset",
       "createTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "endTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "logsUrl": "https://console.cloud.google.com/CLOUD_LOGGING_URL"
       "counter": {
         "success": "SUCCESS_COUNT",
         // If there were any failures, they display in the `failure` field.
         "failure": "FAILURE_COUNT"
       }
     },
     "done": true,
     // The `response` field only displays if there were no errors.
     "response": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.deidentify.DeidentifySummary",
       
     },
     // If there were any errors, an `error` field displays instead of a `response` field.
     // See Troubleshooting long-running operations for a list of response codes.
     "error": {
       "code": ERROR_CODE,
       "message": "DESCRIPTION",
       "details": [
         {
           "@type": "...",
           FIELD1: ...,
           ...
         }
       ]
     }
   }
   

3. Nach erfolgreicher De-Identifikation können Sie die Metadaten für die de-identifizierte Instanz abrufen, um zu sehen, wie sie geändert wurde. Die de-identifizierte Instanz hat eine neue Studien-UID, eine Serien-UID und eine Instanz-UID. Daher müssen Sie zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content

   Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

   Antwort

   [
     {
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 192"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1111111"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.286710307126045768765142714621897494633"
         ]
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.222168347996079463826250565085126257314"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.25205702030237830896398173746777399347"
         ]
       },
       "00280008": {
         "vr": "IS",
         "Value": [
           1
         ]
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       }
     }
   ]
   

   Die folgende Tabelle zeigt, wie sich die Studien-UID, die Serien-UID und die Instanz-UID geändert haben:

   	Metadaten der ursprünglichen Instanz	De-identifizierte Instanzmetadaten
   Studien-UID (0020000D)	3333333	1.3.6.1.4.1.11129.5.1.222168347996079463826250565085126257314
   Serien-UID (0020000E)	4444444	1.3.6.1.4.1.11129.5.1.25205702030237830896398173746777399347
   Instanz-UID (00080018)	2222222	1.3.6.1.4.1.11129.5.1.286710307126045768765142714621897494633

4. Rufen Sie mit den neuen Werten die Metadaten für die Instanz ab.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.222168347996079463826250565085126257314/series/1.3.6.1.4.1.11129.5.1.25205702030237830896398173746777399347/instances/1.3.6.1.4.1.11129.5.1.286710307126045768765142714621897494633/metadata"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.222168347996079463826250565085126257314/series/1.3.6.1.4.1.11129.5.1.25205702030237830896398173746777399347/instances/1.3.6.1.4.1.11129.5.1.286710307126045768765142714621897494633/metadata" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe enthält die neuen Metadaten. Sie können die neuen Metadaten mit den ursprünglichen Metadaten in Schritt 1 vergleichen, um die Auswirkungen der Transformation zu sehen.

   Antwort

   [
     {
       "00020002": {
         "vr": "UI",
         "Value": [
           "1111111"
         ]
       },
       "00020003": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.286710307126045768765142714621897494633"
         ]
       },
       "00020010": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.1.2.4.50"
         ]
       },
       "00020012": {
         "vr": "UI",
         "Value": [
           "1.2.40.0.13.1.3"
         ]
       },
       "00020013": {
         "vr": "SH",
         "Value": [
           "dcm4che-null"
         ]
       },
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 192"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1111111"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.286710307126045768765142714621897494633"
         ]
       },
       "00081062": {
         "vr": "SQ",
         "Value": [
           {
             "00401101": {
               "vr": "SQ",
               "Value": [
                 {
                   "00080100": {
                     "vr": "SH",
                     "Value": [
                       "PLACEHOLDER"
                     ]
                   },
                   "00080102": {
                     "vr": "SH",
                     "Value": [
                       "PLACEHOLDER"
                     ]
                   }
                 }
               ]
             }
           },
           {
             "00401101": {
               "vr": "SQ",
               "Value": [
                 {
                   "00080100": {
                     "vr": "SH",
                     "Value": [
                       "PLACEHOLDER"
                     ]
                   },
                   "00080102": {
                     "vr": "SH",
                     "Value": [
                       "PLACEHOLDER"
                     ]
                   }
                 }
               ]
             }
           }
         ]
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.222168347996079463826250565085126257314"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.25205702030237830896398173746777399347"
         ]
       },
       "00280002": {
         "vr": "US",
         "Value": [
           3
         ]
       },
       "00280004": {
         "vr": "CS",
         "Value": [
           "YBR_FULL_422"
         ]
       },
       "00280006": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00280008": {
         "vr": "IS",
         "Value": [
           1
         ]
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280101": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280102": {
         "vr": "US",
         "Value": [
           7
         ]
       },
       "00280103": {
         "vr": "US",
         "Value": [
           0
         ]
       }
     }
   ]
   

   Beachten Sie insbesondere, dass die Werte der verschachtelten CodeValue- und CodingSchemaDesignator-Tags auf PLACEHOLDER gesetzt sind:

   Original metadata	Metadaten nach Ausführung von RecurseTag
   { "00081062": { "vr": "SQ", "Value": [ { "00401101": { "vr": "SQ", "Value": [ { "00080100": { "vr": "SH", "Value": [ "CodeValue1" ] }, "00080102": { "vr": "SH", "Value": [ "CodingSchemeDesignator1" ] } } ] } }, { "00401101": { "vr": "SQ", "Value": [ { "00080100": { "vr": "SH", "Value": [ "CodeValue2" ] }, "00080102": { "vr": "SH", "Value": [ "CodingSchemeDesignator2" ] } } ] } } ] } }	{ "00081062": { "vr": "SQ", "Value": [ { "00401101": { "vr": "SQ", "Value": [ { "00080100": { "vr": "SH", "Value": [ "PLACEHOLDER" ] }, "00080102": { "vr": "SH", "Value": [ "PLACEHOLDER" ] } } ] } }, { "00401101": { "vr": "SQ", "Value": [ { "00080100": { "vr": "SH", "Value": [ "PLACEHOLDER" ] }, "00080102": { "vr": "SH", "Value": [ "PLACEHOLDER" ] } } ] } } ] } }

Daten auf DICOM-Speicherebene de-identifizieren

Die vorherigen Beispiele zeigen, wie DICOM-Daten auf Dataset-Ebene de-identifiziert werden. In diesem Abschnitt wird beschrieben, wie Sie Daten auf der DICOM-Speicherebene de-identifizieren.

Nehmen Sie die folgenden Änderungen vor, um eine Dataset-De-Identifizierungsanfrage in eine DICOM-Store-De-Identifizierungsanfrage zu ändern:

• Ersetzen Sie destinationDataset im Anfragetext durch destinationStore.
• Fügen Sie dicomStores/DESTINATION_DICOM_STORE_ID am Ende des Werts in destinationStore hinzu, wenn Sie das Ziel angeben.
• Fügen Sie dicomStores/SOURCE_DICOM_STORE_ID hinzu, wenn Sie den Speicherort der Quelldaten angeben.

In den folgenden Beispielen wird eine De-Identifizierungsanfrage auf Datasetebene und die Änderung der Anfrage für eine De-Identifizierung auf DICOM-Speicherebene gezeigt:

De-Identifikation auf Dataset-Ebene

"destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID"
...
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"

DICOM-De-Identifikation auf Speicherebene

"destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID"
...
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID:deidentify"

In den folgenden Beispielen wird gezeigt, wie eine DICOM-Instanz in einem DICOM-Speicher de-identifiziert und die de-identifizierten Daten in einen neuen DICOM-Speicher geschrieben werden. Bevor Sie die Beispiele ausführen, muss die ID des Ziel-DICOM-Speichers bereits vorhanden sein.

REST

1. De-identifizieren Sie das Dataset.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • DESTINATION_DATASET_ID: Die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden. Muss bereits vorhanden sein, bevor der Vorgang zur De-Identifikation ausgeführt wird.
   • DESTINATION_DICOM_STORE_ID: Der DICOM-Speicher im Ziel-Dataset. Muss bereits vorhanden sein, bevor der Vorgang zur De-Identifikation ausgeführt wird.

   JSON-Text der Anfrage:

   {
     "destinationStore": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PatientName"
             ],
             "keepTag": {}
           }
         ]
       }
     }
   }
   

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   cat > request.json << 'EOF'
   {
     "destinationStore": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PatientName"
             ],
             "keepTag": {}
           }
         ]
       }
     }
   }
   EOF

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID:deidentify"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   @'
   {
     "destinationStore": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID",
     "config": {
       "dicomTagConfig": {
         "actions": [
           {
             "queries": [
              "PatientName"
             ],
             "keepTag": {}
           }
         ]
       }
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID:deidentify" | Select-Object -Expand Content

   Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen zusätzliche Zeit in Anspruch nehmen kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"
   }
   

2. Mit der Methode projects.locations.datasets.operations.get können Sie den Status des Vorgangs mit langer Ausführungszeit abrufen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe sieht so aus. Wenn die Antwort "done": true enthält, ist der lang andauernde Vorgang abgeschlossen.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
       "apiMethodName": "google.cloud.healthcare.v1beta1.dataset.DatasetService.DeidentifyDataset",
       "createTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "endTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "logsUrl": "https://console.cloud.google.com/CLOUD_LOGGING_URL"
       "counter": {
         "success": "SUCCESS_COUNT",
         // If there were any failures, they display in the `failure` field.
         "failure": "FAILURE_COUNT"
       }
     },
     "done": true,
     // The `response` field only displays if there were no errors.
     "response": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.deidentify.DeidentifySummary",
       
     },
     // If there were any errors, an `error` field displays instead of a `response` field.
     // See Troubleshooting long-running operations for a list of response codes.
     "error": {
       "code": ERROR_CODE,
       "message": "DESCRIPTION",
       "details": [
         {
           "@type": "...",
           FIELD1: ...,
           ...
         }
       ]
     }
   }
   

3. Nach erfolgreicher De-Identifikation können Sie die Metadaten für die de-identifizierte Instanz abrufen, um zu sehen, wie sie geändert wurde. Die de-identifizierte Instanz hat eine neue Studien-UID, eine Serien-UID und eine Instanz-UID. Daher müssen Sie zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content

   Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

   Antwort

   [
     {
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080090": {
         "vr": "PN"
       },
       "00100010": {
         "vr": "PN",
         "Value": [
           {
             "Alphabetic": "[PERSON_NAME]"
           }
         ]
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200013": {
         "vr": "IS"
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       }
     }
   ]
   

   Die folgende Tabelle zeigt, wie sich die Studien-UID, die Serien-UID und die Instanz-UID geändert haben:

   	Metadaten der ursprünglichen Instanz	De-identifizierte Instanzmetadaten
   Studien-UID (0020000D)	2.25.70541616638819138568043293671559322355	1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
   Serien-UID (0020000E)	1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694	1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
   Instanz-UID (00080018)	1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695	1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029

4. Rufen Sie mit den neuen Werten die Metadaten für die Instanz ab.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe enthält die neuen Metadaten. Sie können die neuen Metadaten mit den ursprünglichen Metadaten vergleichen, um die Auswirkungen der Transformation zu sehen.

   Antwort

   [
     {
       "00020002": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00020003": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00020010": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.1.2.4.50"
         ]
       },
       "00020012": {
         "vr": "UI",
         "Value": [
           "1.2.40.0.13.1.3"
         ]
       },
       "00020013": {
         "vr": "SH",
         "Value": [
           "dcm4che-null"
         ]
       },
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080064": {
         "vr": "CS",
         "Value": [
           "WSD"
         ]
       },
       "00080070": {
         "vr": "LO",
         "Value": [
           "Manufacturer"
         ]
       },
       "00080090": {
         "vr": "PN"
       },
       "00081090": {
         "vr": "LO",
         "Value": [
           "ABC1"
         ]
       },
       "00100010": {
         "vr": "PN",
         "Value": [
           {
             "Alphabetic": "[PERSON_NAME]"
           }
         ]
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200011": {
         "vr": "IS"
       },
       "00200013": {
         "vr": "IS"
       },
       "00200020": {
         "vr": "CS"
       },
       "00280002": {
         "vr": "US",
         "Value": [
           3
         ]
       },
       "00280004": {
         "vr": "CS",
         "Value": [
           "YBR_FULL_422"
         ]
       },
       "00280006": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280101": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280102": {
         "vr": "US",
         "Value": [
           7
         ]
       },
       "00280103": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00282110": {
         "vr": "CS",
         "Value": [
           "01"
         ]
       },
       "00282114": {
         "vr": "CS",
         "Value": [
           "ISO_10918_1"
         ]
       }
     }
   ]
   

Teilmenge eines DICOM-Speichers de-identifizieren

Um eine Teilmenge der Daten in einem DICOM-Speicher zu de-identifizieren geben Sie einen Filter an.

Der Filter hat die Form einer Filterdatei, die Sie als Wert für das Feld resourcePathsGcsUri im Objekt DicomFilterConfig angeben. Die Filterdatei muss in einem Cloud Storage-Bucket vorhanden sein. Sie können keine Filterdatei angeben, die auf Ihrem lokalen Computer oder einer anderen Quelle vorhanden ist. Der Speicherort der Datei muss das Format gs://BUCKET/PATH/TO/FILE haben.

Filterdatei erstellen

Eine Filterdatei definiert, welche DICOM-Dateien de-identifiziert werden sollen. Sie können Dateien auf den folgenden Ebenen filtern:

• Auf der Studienebene
• Für die Reihe
• Auf Instanzebene

Die Filterdatei besteht aus einer Zeile pro Studie, Serie oder Instanz, die Sie de-identifizieren möchten. Jede Zeile hat das Format /studies/STUDY_UID[/series/SERIES_UID[/instances/INSTANCE_UID]]. Am Ende jeder Zeile befindet sich ein Zeilenvorschubzeichen: entweder \n oder \r\n.

Wenn in der Filterdatei, die Sie beim Aufrufen des De-Identifizierungsvorgangs übergeben haben, keine Studie, Serie oder Instanz angegeben ist, wird diese Studie, Serie oder Instanz nicht de-identifiziert und sie wird nicht im DICOM-Zielspeicher vorhanden sein.

Nur der Teil /studies/STUDY_UID des Pfads ist erforderlich. Dies bedeutet, dass Sie eine Studie durch Angabe von /studies/STUDY_UID de-identifizieren können, oder Sie können eine Reihe durch Angabe von /studies/STUDY_UID/series/SERIES_UID de-identifizieren.

Betrachten Sie die folgende Filterdatei. Die Filterdatei führt dazu, dass eine Studie, zwei Serien und drei einzelne Instanzen de-identifiziert werden:

/studies/1.123.456.789
/studies/1.666.333.111/series/123.456\n
/studies/1.666.333.111/series/567.890\n
/studies/1.888.999.222/series/123.456/instances/111\n
/studies/1.888.999.222/series/123.456/instances/222\n
/studies/1.888.999.222/series/123.456/instances/333\n

Filterdatei mit BigQuery erstellen

Normalerweise erstellen Sie eine Filterdatei, indem Sie zuerst die Metadaten aus einem DICOM-Speicher in BigQuery exportieren. Sie können BigQuery verwenden, um die Studien-, Series- und Instanz-UIDs der DICOM-Daten in Ihrem DICOM-Speicher anzuzeigen. Danach haben Sie folgende Möglichkeiten:

1. Fragen Sie nach den Studien-, Serien- und Instanz-UIDs, die Sie interessieren. Nachdem Sie beispielsweise die Metadaten in BigQuery exportiert haben, können Sie die folgende Abfrage ausführen, um die Studien-, Serien- und Instanz-UIDs in einem Format zu verketten, das mit den Anforderungen der Filterdatei kompatibel ist:

   SELECT CONCAT
     ('/studies/', StudyInstanceUID, '/series/', SeriesInstanceUID, '/instances/', SOPInstanceUID)
   FROM
     [PROJECT_ID:BIGQUERY_DATASET.BIGQUERY_TABLE]

2. Wenn die Abfrage eine große Ergebnismenge zurückgibt, können Sie eine neue Tabelle materialisieren, indem Sie die Abfrageergebnisse in einer Zieltabelle in BigQuery speichern.

3. Nachdem Sie die Abfrageergebnisse in der Zieltabelle gespeichert haben, können Sie den Inhalt der Zieltabelle in einer Datei speichern und in Cloud Storage exportieren. Die erforderlichen Schritte finden Sie unter Tabellendaten exportieren. Die exportierte Datei ist Ihre Filterdatei. Sie verwenden den Speicherort der Filterdatei in Cloud Storage, wenn Sie den Filter im Exportvorgang angeben.

Filterdatei manuell erstellen

Sie können eine Filterdatei mit benutzerdefinierten Inhalten erstellen und diese in einen Cloud Storage-Bucket hochladen. Sie verwenden den Speicherort der Filterdatei in Cloud Storage, wenn Sie den Filter im De-Identifizierungsvorgang angeben. Im folgenden Beispiel wird gezeigt, wie Sie mit dem Befehl gcloud storage cp eine Filterdatei in einen Cloud Storage-Bucket hochladen:

gcloud storage cp PATH/TO/FILTER_FILE gs://BUCKET/DIRECTORY

Beispiel:

gcloud storage cp /home/user/Desktop/filters.txt gs://my-bucket/my-directory

Filter nutzen

Nachdem Sie die Filterdatei konfiguriert haben, können Sie sie als Wert an das Feld resourcePathsGcsUri im Objekt filterConfig übergeben.

Das folgende Beispiel wird auf die De-Identifikation von Daten auf DICOM-Speicherebene erweitert. In Cloud Storage wird jedoch eine Filterdatei bereitgestellt, die bestimmt, welche DICOM-Ressourcen de-identifiziert werden.

REST

1. De-identifizieren Sie das Dataset.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • LOCATION ist der Standort des Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DICOM_STORE_ID: Die ID des DICOM-Speichers, der die zu de-identifizierenden Daten enthält
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset
   • BUCKET/PATH/TO/FILE ist der Speicherort der Filterdatei in einem Cloud Storage-Bucket

   JSON-Text der Anfrage:

   {
     "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID",
     "config": {
       "dicom": {
         "filterProfile": "DEIDENTIFY_TAG_CONTENTS"
       },
       "image": {
         "textRedactionMode": "REDACT_ALL_TEXT"
       }
     },
     "filterConfig": {
       "resourcePathGcsUri": "gs://BUCKET/PATH/TO/FILE"
     }
   }
   

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   cat > request.json << 'EOF'
   {
     "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID",
     "config": {
       "dicom": {
         "filterProfile": "DEIDENTIFY_TAG_CONTENTS"
       },
       "image": {
         "textRedactionMode": "REDACT_ALL_TEXT"
       }
     },
     "filterConfig": {
       "resourcePathGcsUri": "gs://BUCKET/PATH/TO/FILE"
     }
   }
   EOF

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID:deidentify"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

   @'
   {
     "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID",
     "config": {
       "dicom": {
         "filterProfile": "DEIDENTIFY_TAG_CONTENTS"
       },
       "image": {
         "textRedactionMode": "REDACT_ALL_TEXT"
       }
     },
     "filterConfig": {
       "resourcePathGcsUri": "gs://BUCKET/PATH/TO/FILE"
     }
   }
   '@  | Out-File -FilePath request.json -Encoding utf8

   Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID:deidentify" | Select-Object -Expand Content

   Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen sehr lange dauern kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
   }
   

2. Mit der Methode projects.locations.datasets.operations.get können Sie den Status des Vorgangs mit langer Ausführungszeit abrufen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: Die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe sieht so aus. Wenn die Antwort "done": true enthält, ist der lang andauernde Vorgang abgeschlossen.

   Antwort

   {
     "name": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
       "apiMethodName": "google.cloud.healthcare.v1beta1.dataset.DatasetService.DeidentifyDataset",
       "createTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "endTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ",
       "logsUrl": "https://console.cloud.google.com/CLOUD_LOGGING_URL"
       "counter": {
         "success": "SUCCESS_COUNT",
         // If there were any failures, they display in the `failure` field.
         "failure": "FAILURE_COUNT"
       }
     },
     "done": true,
     // The `response` field only displays if there were no errors.
     "response": {
       "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.deidentify.DeidentifySummary",
       
     },
     // If there were any errors, an `error` field displays instead of a `response` field.
     // See Troubleshooting long-running operations for a list of response codes.
     "error": {
       "code": ERROR_CODE,
       "message": "DESCRIPTION",
       "details": [
         {
           "@type": "...",
           FIELD1: ...,
           ...
         }
       ]
     }
   }
   

3. Nach erfolgreicher De-Identifikation können Sie die Metadaten für die de-identifizierte Instanz abrufen, um zu sehen, wie sie geändert wurde. Die de-identifizierte Instanz hat eine neue Studien-UID, eine Serien-UID und eine Instanz-UID. Daher müssen Sie zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content

   Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

   Antwort

   [
     {
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080090": {
         "vr": "PN"
       },
       "00100010": {
         "vr": "PN",
         "Value": [
           {
             "Alphabetic": "[PERSON_NAME]"
           }
         ]
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200013": {
         "vr": "IS"
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       }
     }
   ]
   

   Die folgende Tabelle zeigt, wie sich die Studien-UID, die Serien-UID und die Instanz-UID geändert haben:

   	Metadaten der ursprünglichen Instanz	De-identifizierte Instanzmetadaten
   Studien-UID (0020000D)	2.25.70541616638819138568043293671559322355	1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763
   Serien-UID (0020000E)	1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694	1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710
   Instanz-UID (00080018)	1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695	1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029

4. Rufen Sie mit den neuen Werten die Metadaten für die Instanz ab.

   Ersetzen Sie diese Werte in den folgenden Anfragedaten:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • DESTINATION_DATASET_ID: die ID des Ziel-Datasets, in das die de-identifizierten Daten geschrieben werden
   • SOURCE_DATASET_LOCATION: Speicherort des Quell-Datasets
   • DESTINATION_DICOM_STORE_ID: die ID des DICOM-Speichers im Ziel-Dataset. Diese ID entspricht der ID des DICOM-Speichers im Quell-Dataset.

   Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie folgenden Befehl aus:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"

   PowerShell

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

   Führen Sie diesen Befehl aus:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand Content

   APIs Explorer

   Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.

   Die Ausgabe enthält die neuen Metadaten. Sie können die neuen Metadaten mit den ursprünglichen Metadaten vergleichen, um die Auswirkungen der Transformation zu sehen.

   Antwort

   [
     {
       "00020002": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00020003": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00020010": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.1.2.4.50"
         ]
       },
       "00020012": {
         "vr": "UI",
         "Value": [
           "1.2.40.0.13.1.3"
         ]
       },
       "00020013": {
         "vr": "SH",
         "Value": [
           "dcm4che-null"
         ]
       },
       "00080005": {
         "vr": "CS",
         "Value": [
           "ISO_IR 100"
         ]
       },
       "00080016": {
         "vr": "UI",
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ]
       },
       "00080018": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029"
         ]
       },
       "00080020": {
         "vr": "DA"
       },
       "00080030": {
         "vr": "TM"
       },
       "00080050": {
         "vr": "SH"
       },
       "00080064": {
         "vr": "CS",
         "Value": [
           "WSD"
         ]
       },
       "00080070": {
         "vr": "LO",
         "Value": [
           "Manufacturer"
         ]
       },
       "00080090": {
         "vr": "PN"
       },
       "00081090": {
         "vr": "LO",
         "Value": [
           "ABC1"
         ]
       },
       "00100010": {
         "vr": "PN",
         "Value": [
           {
             "Alphabetic": "[PERSON_NAME]"
           }
         ]
       },
       "00100020": {
         "vr": "LO"
       },
       "00100030": {
         "vr": "DA"
       },
       "00100040": {
         "vr": "CS"
       },
       "0020000D": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763"
         ]
       },
       "0020000E": {
         "vr": "UI",
         "Value": [
           "1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710"
         ]
       },
       "00200010": {
         "vr": "SH"
       },
       "00200011": {
         "vr": "IS"
       },
       "00200013": {
         "vr": "IS"
       },
       "00200020": {
         "vr": "CS"
       },
       "00280002": {
         "vr": "US",
         "Value": [
           3
         ]
       },
       "00280004": {
         "vr": "CS",
         "Value": [
           "YBR_FULL_422"
         ]
       },
       "00280006": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00280010": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280011": {
         "vr": "US",
         "Value": [
           1024
         ]
       },
       "00280100": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280101": {
         "vr": "US",
         "Value": [
           8
         ]
       },
       "00280102": {
         "vr": "US",
         "Value": [
           7
         ]
       },
       "00280103": {
         "vr": "US",
         "Value": [
           0
         ]
       },
       "00282110": {
         "vr": "CS",
         "Value": [
           "01"
         ]
       },
       "00282114": {
         "vr": "CS",
         "Value": [
           "ISO_10918_1"
         ]
       }
     }
   ]
   

Fehlerbehebung bei DICOM-De-Identifikationsvorgängen

Wenn Fehler während einer DICOM-De-Identifikation auftreten, werden die Fehler in Cloud Logging protokolliert. Weitere Informationen finden Sie unter Fehlerlogs in Cloud Logging ansehen.

Wenn der gesamte Vorgang einen Fehler zurückgibt, finden Sie weitere Informationen unter Fehlerbehebung bei Vorgängen mit langer Ausführungszeit.