Diese Seite wurde von der Cloud Translation API übersetzt.

HL7v2-Nachrichten nach Cloud Storage exportieren

Auf dieser Seite wird beschrieben, wie Sie HL7v2-Nachrichten aus einem HL7v2-Speicher nach Cloud Storage exportieren. Sie können HL7v2-Nachrichten im Bulk-Verfahren nach Cloud Storage exportieren, um sie anschließend weiterzuverarbeiten.

Hinweise

Weitere Informationen zu den Rollen, die Sie dem Cloud Healthcare Service Agent-Dienstkonto zuweisen müssen, finden Sie unter HL7v2-Nachrichten aus Cloud Storage exportieren.

HL7v2-Nachrichten nach Cloud Storage exportieren

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen oder die folgenden IAM-Rollen (Identity and Access Management):

Berechtigungen

healthcare.hl7V2Stores.export im angeforderten HL7v2-Speicher

Rollen

Healthcare-HL7v2-Speicher-Administrator (roles/healthcare.hl7V2StoreAdmin)

Die Cloud Healthcare API exportiert jede HL7v2-Nachricht als in einer NDJSON-.ndjson-Datei. Die HL7v2-Nachrichten werden chronologisch nach ihrem sendTime-Wert sortiert.

In einen Cloud Storage-Bucket oder -Ordner statt in ein Objekt exportieren da die Cloud Healthcare API möglicherweise mehrere NDJSON-Dateien erstellt, wenn Es gibt viele HL7v2-Nachrichten.

Wenn Sie in einen nicht vorhandenen Cloud Storage-Ordner exportieren, wird der Ordner erstellt.

Console

So exportieren Sie HL7v2-Nachrichten nach Cloud Storage:

Rufen Sie in der Google Cloud Console die Seite Datasets auf.

Zu „Datasets“
Klicken Sie auf das Dataset mit dem HL7v2-Speicher, aus dem Sie HL7v2-Nachrichten exportieren.
Wählen Sie in der Liste der Datenspeicher aus der Liste Aktionen für den HL7v2-Speicher Exportieren aus.

Die Seite HL7v2-Nachrichten exportieren wird angezeigt.
Wählen Sie in der Liste Projekt ein Cloud Storage-Projekt aus.
Wählen Sie in der Liste Standort einen Cloud Storage-Bucket aus.
Klicken Sie auf Exportieren, um HL7v2-Instanzen an den definierten Speicherort in Cloud Storage zu exportieren.
Klicken Sie auf den Tab Vorgänge, um den Status des Vorgangs zu verfolgen. Wenn der Vorgang abgeschlossen ist, werden folgende Hinweise angezeigt:
- Im Abschnitt Status: Lang andauernder Vorgang befindet sich unter der Überschrift OK ein grünes Häkchen.
- Der Abschnitt Übersicht hat ein grünes Häkchen und einen OK-Indikator in der Zeile, in der sich auch die Vorgangs-ID befindet.
Falls Fehler auftreten, klicken Sie auf Aktionen und dann auf Details in Cloud Logging ansehen.

HL7v2-Nachrichten mithilfe von Filtern nach Cloud Storage exportieren

Beim Exportieren von HL7v2-Nachrichten nach Cloud Storage werden standardmäßig alle HL7v2-Nachrichten in einem HL7v2-Speicher und alle Felder in jedem Message-Objekt exportiert.

Sie können die exportierten HL7v2-Nachrichten so filtern:

Mithilfe von Filtern können Sie einen Teil der HL7v2-Nachrichten exportieren, die mit den Filterkriterien übereinstimmen. Weitere Informationen finden Sie unter Untergruppe von HL7v2-Nachrichten mithilfe eines Filters exportieren.
Verwenden Sie das Objekt MessageView, um die Felder in jedem Message auszuwählen, die exportiert werden sollen. Weitere Informationen findest du im Abschnitt zum Export von HL7v2-Nachrichten nach Message.

Teilmenge von HL7v2-Nachrichten mit einem Filter exportieren

Sie können die folgenden Felder in Ihren Filterkriterien verwenden:

Sie können die folgenden Filterparameter als Filterkriterien im Feld filter angeben. Informationen zur Filtersyntax und zum Erstellen von Abfragen finden Sie unter Abfragestrings.

message_type aus dem Feld MSH.9.1. Beispiel: NOT message_type = "ADT".
send_date: Das Datum YYYY-MM-DD, an dem die Nachricht aus dem MSH.7-Segment gesendet wurde, angegeben in der Zeitzone des Datensatzes. Beispiel: send_date < "2017-01-02"
send_time: den Zeitstempel, der angibt, wann die Nachricht gesendet wurde. Dieser Parameter stammt von MSH.7-Segment der Nachricht. Dieser Parameter verwendet den Parameter RFC 3339-Zeitformat für Vergleiche. Beispiel: send_time < "2017-01-02T00:00:00-05:00"
create_time ist der Zeitstempel, zu dem die Nachricht in der Cloud Healthcare API erstellt wurde, unter Verwendung des RFC 3339-Zeitformats für Vergleiche. Beispiel: create_time < "2017-01-02T00:00:00-05:00"
send_facility: Das Pflegezentrum, von dem die Nachricht stammt, aus dem MSH.4-Segment. Beispiel: send_facility = "ABC".

In den folgenden Beispielen wird gezeigt, wie ein Filter angegeben wird, um nur HL7v2-Nachrichten vom Typ ADT zu exportieren.

REST

Verwenden Sie den hl7V2Stores.export. Methode zum Exportieren der HL7v2-Nachrichten:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID ist die ID Ihres Google Cloud-Projekts
- LOCATION ist der Standort des Datasets
- DATASET_ID ist das übergeordnete Dataset des HL7v2-Speichers
- HL7V2_STORE_ID ist die HL7v2-Speicher-ID
- CLOUD_STORAGE_LOCATION: Der Name eines Cloud Storage-Buckets oder -Ordners, in den exportierte HL7v2-Nachrichten geschrieben werden
JSON-Text anfordern:
```
{
  "gcsDestination": {
    "uriPrefix": "gs://CLOUD_STORAGE_LOCATION"
  },
  "filter": "message_type = \"ADT\""
}
```
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl

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

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
```
cat > request.json << 'EOF'
{
  "gcsDestination": {
    "uriPrefix": "gs://CLOUD_STORAGE_LOCATION"
  },
  "filter": "message_type = \"ADT\""
}
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/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID:export"
PowerShell

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

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
```
@'
{
  "gcsDestination": {
    "uriPrefix": "gs://CLOUD_STORAGE_LOCATION"
  },
  "filter": "message_type = \"ADT\""
}
'@  | 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/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID:export" | 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/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
}
```

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

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: die ID Ihres Google Cloud-Projekts
DATASET_ID: die Dataset-ID
LOCATION: der Standort des Datasets
OPERATION_ID: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde

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

curl

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

Führen Sie folgenden Befehl aus:

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

PowerShell

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

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

APIs Explorer

Öffnen Sie das 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, wird der lang andauernden Vorgang abgeschlossen ist.

Antwort

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
    "apiMethodName": "google.cloud.healthcare.v1.hl7v2.Hl7V2Service.ExportMessages",
    "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.v1.hl7v2.ExportMessagesResponse",
    
  },
  // 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: ...,
        ...
      }
    ]
  }
}

HL7v2-Nachrichten nach Feld `Message` exportieren

In der Cloud Healthcare API werden HL7v2-Nachrichten in Message-Ressourcen gespeichert. Mit dem Enum MessageView können Sie festlegen, welche Felder in der Message-Ressource in jeder exportierten HL7v2-Nachricht enthalten sind.

In den folgenden Beispielen wird gezeigt, wie Sie mit dem Wert BASIC in MessageView nur das Feld name in die exportierten HL7v2-Nachrichten aufnehmen.

REST

Verwenden Sie den hl7V2Stores.export. Methode zum Exportieren der HL7v2-Nachrichten:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID ist die ID Ihres Google Cloud-Projekts
- LOCATION ist der Standort des Datasets
- DATASET_ID ist das übergeordnete Dataset des HL7v2-Speichers
- HL7V2_STORE_ID ist die HL7v2-Speicher-ID
- CLOUD_STORAGE_LOCATION: Der Name eines Cloud Storage-Buckets oder -Ordners, in den exportierte HL7v2-Nachrichten geschrieben werden
JSON-Text anfordern:
```
{
  "gcsDestination": {
    "uriPrefix": "gs://CLOUD_STORAGE_LOCATION",
    "messageView": "BASIC"
  }
}
```
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl

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

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
```
cat > request.json << 'EOF'
{
  "gcsDestination": {
    "uriPrefix": "gs://CLOUD_STORAGE_LOCATION",
    "messageView": "BASIC"
  }
}
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/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID:export"
PowerShell

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

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
```
@'
{
  "gcsDestination": {
    "uriPrefix": "gs://CLOUD_STORAGE_LOCATION",
    "messageView": "BASIC"
  }
}
'@  | 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/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID:export" | 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/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
}
```

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

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: die ID Ihres Google Cloud-Projekts
DATASET_ID: die Dataset-ID
LOCATION: der Standort des Datasets
OPERATION_ID: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde

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

curl

Führen Sie folgenden Befehl aus:

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

PowerShell

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/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

APIs Explorer

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

Antwort

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
    "apiMethodName": "google.cloud.healthcare.v1.hl7v2.Hl7V2Service.ExportMessages",
    "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.v1.hl7v2.ExportMessagesResponse",
    
  },
  // 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: ...,
        ...
      }
    ]
  }
}

Fehlerbehebung bei HL7v2-Exportanfragen

Wenn beim Exportieren von HL7v2-Nachrichten Fehler auftreten, werden diese in Cloud Logging protokolliert. Weitere Informationen finden Sie unter Fehlerlogs in Cloud Logging ansehen.

Wenn bei einem Vorgang mit langer Ausführungszeit ein Fehler zurückgegeben wird, lesen Sie die Informationen unter Fehlerbehebung bei lang andauernden Vorgängen.

HL7v2-Nachrichten nach Cloud Storage exportieren

Hinweise

HL7v2-Nachrichten nach Cloud Storage exportieren

Erforderliche Berechtigungen für diese Aufgabe

Console

HL7v2-Nachrichten mithilfe von Filtern nach Cloud Storage exportieren

Teilmenge von HL7v2-Nachrichten mit einem Filter exportieren

REST

curl

PowerShell

Antwort

curl

PowerShell

APIs Explorer

Antwort

HL7v2-Nachrichten nach Feld Message exportieren

REST

curl

PowerShell

Antwort

curl

PowerShell

APIs Explorer

Antwort

Fehlerbehebung bei HL7v2-Exportanfragen

HL7v2-Nachrichten nach Feld `Message` exportieren