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 Vorschaufunktionen beschrieben, die sich ändern können und möglicherweise nur eingeschränkt unterstützt werden. Änderungen an pre-GA-Produkten und -Funktionen sind möglicherweise nicht mit anderen pre-GA-Versionen kompatibel. Weitere Informationen finden Sie unter Pre-GA-Angebotsbedingungen für die Cloud Healthcare API und in den Beschreibungen der Einführungsphasen.

Auf dieser Seite wird erläutert, wie Sie mit der v1beta1-Konfiguration DicomTagConfig in der Cloud Healthcare API sensible 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 DICOM-De-Identifikationsvorgänge entweder mit dem Legacy-v1-Objekt DicomConfig oder dem v1beta1-Objekt DicomTagConfig konfigurieren. Wir empfehlen dringend die Verwendung von DicomTagConfig.

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 mit kontextbezogener De-Identifikation de-identifizieren

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

Mit der Option DicomTagConfig.Options.CleanDescriptorsOption wird jeder unstrukturierte Metadatentext umgewandelt, der mit entfernten Tags übereinstimmt. Dadurch wird die Qualität der De-Identifikation verbessert. Angenommen, Sie de-identifizieren ein Röntgenbild und der Röntgenpatient hat einen Nachnamen, der auch ein Substantiv 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, indem Sie Folgendes angeben:

• Ein Enum im Objekt ProfileType. Es ist nicht erforderlich, eine Aufzählung anzugeben.
• Mit dem Filter CleanTextTag können Sie nach bestimmten Tags filtern.

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

Eingebrannten Text mit kontextabhängiger De-Identifikation entfernen

Sie können die Enum TextRedactionMode.REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS angeben, um die kontextabhängige De-Identifikation von eingebrannten Text in einem Bild zu aktivieren. Diese Option basiert auf der Option „Clean Descriptors“. Wenn Sie die Aufzählung TextRedactionMode.REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS angeben, wird während der Prüfung ein zusätzlicher infoType verwendet, der sich auf die Abrechnungskosten auswirken kann.

Sie können die Aufzählung TextRedactionMode.REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS 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 Action.queries[]-Array hinzufügen. Bei Verwendung von Action.CleanImageTag wird nur das Tag PixelData unterstützt.

Mit der Option TextRedactionMode.REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS wird der eingebrannte Text entfernt, der mit allen 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 eingebranntem Text ist nur eine Aktivierung oder Deaktivierung mit einer Aufzählung im ProfileType-Objekt erforderlich. Es ist nicht erforderlich, eine Aufzählung anzugeben.

Zusätzliche infoTypes bei der De-Identifikation von Bildern

Sie können mit Informationstypen (infoTypes) angeben, 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 zu bestimmen, welche infoTypes bei der De-Identifikation von DICOM-Bildern verwendet werden sollen:

• additionalInfoTypes
• excludeInfoTypes

Diese Felder sind 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 zur Verwendung von DicomTagConfig migrieren

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

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

TagFilterProfile bis ProfileType

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

Das folgende Beispiel zeigt, wie Sie eine Anfrage von TagFilterProfile zu ProfileType migrieren:

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 Action-Objekt migrieren, in dem Sie das Tag-Verhalten festlegen. Das Action-Objekt bietet zusätzliche Optionen zum Transformieren von Tags.

Das folgende Beispiel zeigt, wie Sie eine Anfrage von keepList zu Action.keepTag migrieren. Die Anfrage gibt an, dass der Wert des Tags PatientID während des De-Identifikationsvorgangs beibehalten wird.

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

Keep-Listen, Entfernungslisten und Profile kombinieren

Im Objekt DicomConfig können Sie anhand von Keeplists, 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. Geben Sie dazu an, welche Tags in einem Action-Objekt beibehalten und entfernt werden sollen, und geben Sie gleichzeitig ein Profil in ProfileType an.

Optionen, die im Objekt Action konfiguriert sind, überschreiben die im Profil ProfileType 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 Objekt DicomConfig durch das Feld primaryIds im Objekt DicomTagConfig. Das Feld primaryIds im Objekt Options enthält ein Objekt PrimaryIdsOption, in dem Sie eine der folgenden Enums 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: Generieren Sie die primären IDs neu.

Das folgende Beispiel zeigt, wie Sie eine Anfrage von skipIdRedaction zu Options.primaryIds migrieren. Die Anfrage gibt an, dass die Werte der primären IDs während des De-Identifikationsvorgangs 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.

Das folgende Beispiel zeigt, wie Sie eine Anfrage von der Verwendung eines ImageConfig in DeidentifyConfig.image zu einer ImageConfig in DeidentifyConfig.DicomTagConfig.Options.cleanImage migrieren. Die Anfrage gibt an, dass der gesamte Text in einem Bild während des De-Identifikationsvorgangs 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 Methode datasets.deidentify 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.
• 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.
• Zu de-identifizierende Elemente: Konfigurationsparameter, die angeben, wie die DICOM-Daten im Dataset verarbeitet werden sollen. Sie können die DICOM-De-Identifikation konfigurieren, um DICOM-Instanzmetadaten (mithilfe von Tag-Keywords) oder eingebrannten Text in DICOM-Bildern zu de-identifizieren. Dazu geben Sie diese Parameter in einem DeidentifyConfig-Objekt an.

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 Methode dicomStores.deidentify 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.
• Zu de-identifizierende Elemente: Konfigurationsparameter, die angeben, wie der DICOM-Speicher verarbeitet werden soll. Sie können die DICOM-De-Identifikation konfigurieren, um DICOM-Instanzmetadaten (mithilfe von Tag-Keywords) oder eingebrannten Text in DICOM-Bildern zu de-identifizieren. Dazu geben Sie diese Parameter in einem DeidentifyConfig-Objekt an.

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 eine Teilmenge 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

In den Beispielen in diesem Leitfaden wird eine einzelne DICOM-Instanz mit dem Namen dicom_deid_instance_sample.dcm verwendet. Sie können jedoch auch mehrere Instanzen de-identifizieren. Wenn Sie die DICOM-Beispielinstanz 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.

Die folgenden Abschnitte zeigen, wie das Bild in der DICOM-Instanz aussieht und die Metadaten in der Instanz.

Beispielbild

Einige Beispiele auf dieser Seite enthalten eine Ausgabe des de-identifizierten Bilds. In jedem Beispiel wird das folgende Originalbild als Eingabe verwendet. Sie können das Ausgabebild jedes De-Identifikationsvorgangs 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. In jedem Beispiel werden die folgenden ursprünglichen Metadaten als Eingabe verwendet. Sie können die Ausgabemetadaten jedes De-Identifikationsvorgangs mit diesen ursprünglichen Metadaten vergleichen, um die Auswirkungen der De-Identifikation 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 Objekt ImageConfig in einem Action-Objekt de-identifizieren. In ImageConfig können Sie angeben, welche infoTypes ein- oder ausgeschlossen werden sollen und wie Text mithilfe des Objekts TextRedactionMode entfernt werden soll.

Gesamten Text entfernen

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

REST

1. De-identifizieren Sie das Dataset.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der 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 de-identifizierte Daten geschrieben werden

   JSON-Text anfordern:

   {
     "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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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:

   @'
   {
     "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.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID ist die ID, die vom lang andauernden Vorgang 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Vorgang mit langer Ausführungszeit 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, Serien-UID und Instanz-UID. Sie müssen also zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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 mithilfe der neuen Werte die Metadaten für die Instanz ab.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Images mit REDACT_ALL_TEXT sieht das Image so aus. Sie sehen, dass der gesamte eingebrannte Text unten im Bild entfernt wurde.

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

Vertraulichen Text mit der Option „Deskriptoren bereinigen“ entfernen

In den folgenden Beispielen wird gezeigt, wie Sie eine DICOM-Instanz de-identifizieren, indem Sie TextRedactionMode auf REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS setzen.

Weitere Informationen zur Option CleanDescriptorsOption finden Sie unter Text mit kontextbezogener De-Identifikation de-identifizieren.

REST

1. De-identifizieren Sie das Dataset.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der 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 de-identifizierte Daten geschrieben werden

   JSON-Text anfordern:

   {
     "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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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:

   @'
   {
     "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.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID ist die ID, die vom lang andauernden Vorgang 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Vorgang mit langer Ausführungszeit 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, Serien-UID und Instanz-UID. Sie müssen also zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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 mithilfe der neuen Werte die Metadaten für die Instanz ab.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Images mit REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS sieht das Image 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) keiner der Standard-DICOM-infoTypes ist.

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 sind im DicomTagConfig-Objekt 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 an. Anschließend führt die Option eine Aktion für die Tags in der Liste aus. Sie können in einer Liste von Tags nicht mehr als eine Action-Option angeben.

Jedes Action-Objekt stellt eine queries[]-Liste bereit, in der Sie eine Liste von Tags angeben. Folgende Tag-Formate werden unterstützt:

• Tag-IDs, z. B. "00100010"
• Tag-Namen, z. B. "PatientName"
• Wertdarstellungen (VRs), wie "PN"

Die Anzahl der Tags, die in der queries[]-Liste angegeben werden können, ist nicht begrenzt. Für jedes Tag kann jedoch nur eine einzige Action-Option ausgeführt werden. Wenn Sie verschiedene Tags angeben möchten, für die unterschiedliche Action-Optionen ausgeführt werden, müssen Sie mehrere Action-Objekte angeben.

Tags beibehalten

Wenn Sie verhindern möchten, dass Tag-Werte entfernt werden, geben Sie die Tags in einem KeepTag-Objekt im DicomTagConfig-Objekt an.

Damit Sie bei Verwendung eines KeepTag-Objekts ein gültiges DICOM-Objekt erstellen können, geben Sie im Objekt ProfileType die Werte MINIMAL_KEEP_LIST_PROFILE oder DEIDENTIFY_TAG_CONTENTS an.

Wenn Sie eines dieser Profile angeben, werden die folgenden Tags automatisch beibehalten. Dadurch wird sichergestellt, dass die de-identifizierte DICOM-Instanz ein gültiges DICOM-Element ist:

• 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 vorhergehenden Tags werden neu generiert. Dies bedeutet, dass die Werte durch eine deterministische Transformation durch einen anderen Wert ersetzt werden. Weitere Informationen finden Sie unter Option zum Beibehalten von UIDs im DICOM-Standard.

Die Werte von StudyInstanceUID, SeriesInstanceUID, SOPInstanceUID und MediaStorageSOPInstanceUID werden als "primäre IDs" bezeichnet. Geben Sie in PrimaryIdsOption einen Wert an, um zu bestimmen, wie primäre IDs transformiert werden.

Die folgenden Beispiele zeigen, wie das Objekt KeepTag verwendet wird, um die Werte bestimmter Tags während der De-Identifikation unverändert zu lassen. Das Tag PatientName wird der Liste queries[] hinzugefügt, sodass der Wert PatientName bei der De-Identifikation nicht entfernt wird.

Da PrimaryIdsOption im Beispiel nicht angegeben ist, wird standardmäßig für das Feld primaryIds der Wert PRIMARY_IDS_OPTION_UNSPECIFIED verwendet, also der Wert aus ProfileType. Da ProfileType ebenfalls nicht angegeben ist, wird für das Feld profileType standardmäßig PROFILE_TYPE_UNSPECIFIED verwendet. Dadurch werden Tags auf Grundlage des Basisprofils der Attributvertraulichkeit (DICOM-Standardversion 2018) entfernt.

REST

1. De-identifizieren Sie das Dataset.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der 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 de-identifizierte Daten geschrieben werden

   JSON-Text anfordern:

   {
     "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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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:

   @'
   {
     "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.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID ist die ID, die vom lang andauernden Vorgang 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Vorgang mit langer Ausführungszeit 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, Serien-UID und Instanz-UID. Sie müssen also zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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 mithilfe der neuen Werte die Metadaten für die Instanz ab.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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

Die folgenden Beispiele zeigen, wie das Objekt RemoveTag verwendet wird, um die Werte bestimmter Tags während der De-Identifikation zu entfernen. Ein entferntes Tag wird durch einen leeren Wert ersetzt.

In den folgenden Beispielen wird das Tag PatientName der Liste queries[] hinzugefügt, sodass sein Wert während der De-Identifikation durch einen leeren Wert ersetzt wird.

REST

1. De-identifizieren Sie das Dataset.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der 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 de-identifizierte Daten geschrieben werden

   JSON-Text anfordern:

   {
     "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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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:

   @'
   {
     "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.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID ist die ID, die vom lang andauernden Vorgang 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Vorgang mit langer Ausführungszeit 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, Serien-UID und Instanz-UID. Sie müssen also zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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 mithilfe der neuen Werte die Metadaten für die Instanz ab.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 während der De-Identifikation bestimmte Tags löschen.

REST

1. De-identifizieren Sie das Dataset.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der 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 de-identifizierte Daten geschrieben werden

   JSON-Text anfordern:

   {
     "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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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:

   @'
   {
     "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.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID ist die ID, die vom lang andauernden Vorgang 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Vorgang mit langer Ausführungszeit 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, Serien-UID und Instanz-UID. Sie müssen also zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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 mithilfe der neuen Werte die Metadaten für die Instanz ab.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Platzhalterwert zurücksetzen

Die folgenden Beispiele zeigen, wie das Objekt ResetTag verwendet wird, um den Wert von Tags während der De-Identifikation auf den String PLACEHOLDER festzulegen.

REST

1. De-identifizieren Sie das Dataset.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der 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 de-identifizierte Daten geschrieben werden

   JSON-Text anfordern:

   {
     "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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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:

   @'
   {
     "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.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID ist die ID, die vom lang andauernden Vorgang 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Vorgang mit langer Ausführungszeit 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, Serien-UID und Instanz-UID. Sie müssen also zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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 mithilfe der neuen Werte die Metadaten für die Instanz ab.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Tags PatientName auf PLACEHOLDER festgelegt ist:

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

Vertraulichen Text in Tags prüfen und umwandeln

In den folgenden Beispielen wird gezeigt, wie Sie mit dem CleanTextTag-Objekt Tags prüfen und die Werte der Tags entsprechend der Konfiguration im Objekt TextConfig transformieren.

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

• Ein CleanTextTag-Objekt.
• Eine queries[]-Liste, die das DICOM-Tag PatientName enthält.

Die folgenden Optionen werden im TextConfig-Objekt festgelegt:

• Ein InfoTypeTransformation-Objekt, das Text umwandelt, der einem bestimmten infoType entspricht.
• Ein ReplaceWithInfoTypeConfig-Objekt, das übereinstimmende Texte durch den Namen des infoType ersetzt.
• Eine infoTypes[]-Liste, die den infoType PERSON_NAME enthält.

Wenn diese Konfigurationen konfiguriert sind, prüft der De-Identifikationsvorgang das Tag PatientName, gleicht das Tag mit dem infoType PERSON_NAME ab und ersetzt den Wert des Tags durch den infoType PERSON_NAME. Das Tag PatientName hat die Wertdarstellung (VR) PN, eine der unterstützten VRs im CleanTextTag-Objekt.

REST

1. De-identifizieren Sie das Dataset.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der 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 de-identifizierte Daten geschrieben werden

   JSON-Text anfordern:

   {
     "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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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:

   @'
   {
     "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.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID ist die ID, die vom lang andauernden Vorgang 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Vorgang mit langer Ausführungszeit 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, Serien-UID und Instanz-UID. Sie müssen also zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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 mithilfe der neuen Werte die Metadaten für die Instanz ab.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Tags PatientName auf [PERSON_NAME] festgelegt ist:

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

UID durch eine generierte UID ersetzen

Die folgenden Beispiele zeigen, wie das Objekt RegenUidTag verwendet wird, um eine UID durch eine neu generierte UID zu ersetzen. Die einzige VR, die vom RegenUidTag-Objekt unterstützt wird, ist UI.

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

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

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

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

REST

1. De-identifizieren Sie das Dataset.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der 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 de-identifizierte Daten geschrieben werden

   JSON-Text anfordern:

   {
     "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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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:

   @'
   {
     "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.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID ist die ID, die vom lang andauernden Vorgang 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Vorgang mit langer Ausführungszeit 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, weil Sie das Tag SOPInstanceUID im Array Action.queries[] angegeben haben. Sie müssen also zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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
         ]
       }
     }
   ]
   

   Die folgende Tabelle zeigt, wie sich die UID der Instanz 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.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 von den primären IDs nur 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 Objekt RecurseTag unterstützt nur die VR-Funktion SQ, die der VR-Funktion für ein Sequence entspricht.

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

Die für diese Seite bereitgestellte DICOM-Beispielinstanz enthält keine DICOM-Tags mit einer SQ VR. Sie können eine DICOM-Instanz mit fiktiven Daten, die die SQ-VR enthalten, erstellen und speichern. 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 von RecurseTag 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 weist eine SQ-VR auf und enthält zwei verschachtelte PersonIdentificationCodeSequence-Tags (00401101). Die verschachtelten Tags haben auch eine SQ-VR und jedes Tag enthält 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 DICOMweb API der Cloud Healthcare 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 ein öffnendes Bild (für die JSON-Metadaten), ein mittleres Bild (für das JPEG-Bild) und ein schließendes Begrenzungsbild 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 innerhalb der mittleren und schließenden Begrenzungen. 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

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • 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: der Speicherort des Quell-Datasets
   • SOURCE_DICOM_STORE_ID: die ID des DICOM-Speichers im Quell-Dataset

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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 gespeicherte DICOM-Instanz zu de-identifizieren.

REST

1. De-identifizieren Sie das Dataset.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der 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 de-identifizierte Daten geschrieben werden

   JSON-Text anfordern:

   {
     "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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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:

   @'
   {
     "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.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID ist die ID, die vom lang andauernden Vorgang 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Vorgang mit langer Ausführungszeit 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, Serien-UID und Instanz-UID. Sie müssen also zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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 mithilfe der neuen Werte die Metadaten für die Instanz ab.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Tags CodeValue und CodingSchemaDesignator auf PLACEHOLDER festgelegt sind:

   Original metadata	Metadaten nach der 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.

Die folgenden Beispiele zeigen eine De-Identifikationsanfrage auf Dataset-Ebene und wie die Anfrage für eine De-Identifikation auf DICOM-Speicherebene geändert wird:

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 Sie eine DICOM-Instanz in einem DICOM-Speicher de-identifizieren und die de-identifizierten Daten in einen neuen DICOM-Speicher schreiben. Bevor die Beispiele ausgeführt werden, muss die ID des DICOM-Zielspeichers bereits vorhanden sein.

REST

1. De-identifizieren Sie das Dataset.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der 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 de-identifizierte Daten geschrieben werden. Muss vor dem Ausführen des De-Identifikationsvorgangs bereits vorhanden sein.
   • DESTINATION_DICOM_STORE_ID: der DICOM-Speicher im Ziel-Dataset. Muss vor dem Ausführen des De-Identifikationsvorgangs bereits vorhanden sein.

   JSON-Text anfordern:

   {
     "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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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:

   @'
   {
     "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.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID ist die ID, die vom lang andauernden Vorgang 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Vorgang mit langer Ausführungszeit 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, Serien-UID und Instanz-UID. Sie müssen also zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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 mithilfe der neuen Werte die Metadaten für die Instanz ab.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 eine Studie, Serie oder Instanz in der Filterdatei, die Sie beim Aufrufen des De-Identifikationsvorgangs übergeben haben, nicht angegeben ist, wird diese Studie, Serie oder Instanz nicht de-identifiziert und ist nicht im Ziel-DICOM-Speicher vorhanden.

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 die Studien-, Reihen- und Instanz-UIDs ab, an denen Sie interessiert sind. 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 gsutil cp eine Filterdatei in einen Cloud Storage-Bucket hochladen:

gsutil cp PATH/TO/FILTER_FILE gs://BUCKET/DIRECTORY

Beispiel:

gsutil 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 erweitert die De-Identifikation von Daten auf DICOM-Speicherebene. Es wird jedoch eine Filterdatei in Cloud Storage bereitgestellt, um zu bestimmen, welche DICOM-Ressourcen de-identifiziert werden.

REST

1. De-identifizieren Sie das Dataset.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • 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 de-identifizierte 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 anfordern:

   {
     "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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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:

   @'
   {
     "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.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

   • PROJECT_ID ist die ID Ihres Google Cloud-Projekts
   • SOURCE_DATASET_LOCATION: der Speicherort des Quell-Datasets
   • SOURCE_DATASET_ID: die ID des Datasets, das die zu de-identifizierenden Daten enthält
   • OPERATION_ID ist die ID, die vom lang andauernden Vorgang 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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 Vorgang mit langer Ausführungszeit 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, Serien-UID und Instanz-UID. Sie müssen also zuerst im neuen Dataset nach der de-identifizierten Instanz suchen.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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 mithilfe der neuen Werte die Metadaten für die Instanz ab.

   Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

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

   Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

   curl

   Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in 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 in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. 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/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"
         ]
       }
     }
   ]
   

Fehler bei DICOM-De-Identifikationsvorgängen beheben

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.