Importar mensajes HL7v2 desde Cloud Storage

Consola

Para importar mensajes HL7v2 desde un segmento de Cloud Storage, sigue estos pasos:

1. En la Google Cloud consola, ve a la página Conjuntos de datos.

   Ve a Conjuntos de datos.

2. Haga clic en el conjunto de datos que contiene el almacén HL7v2 al que va a importar mensajes HL7v2.

3. En la lista de almacenes de datos, elige Importar en la lista Acciones del almacén HL7v2.

   Aparecerá la página Importar a almacén HL7v2.

4. En la lista Proyecto, selecciona un proyecto de Cloud Storage.

5. En la lista Ubicación, selecciona un segmento de Cloud Storage.

6. Para definir una ubicación específica para importar archivos, sigue estos pasos:

   1. Despliega Opciones avanzadas.
   2. Selecciona Reemplazar ruta de Cloud Storage.

   3. Para definir una fuente específica para importar archivos, indica la ruta en el cuadro de texto Ubicación. Puedes usar comodines para importar varios archivos desde uno o más directorios. Para obtener más información sobre la nomenclatura de objetos, consulta las directrices de nomenclatura de objetos.

      Se admiten los siguientes comodines:
      • Usa * para hacer coincidir 0 o más caracteres que no sean de separación. Por ejemplo, gs://BUCKET/DIRECTORY/Example*.ndjson coincide con Example.ndjson y Example22.ndjson en DIRECTORY.
      • Usa ** para hacer coincidir 0 o más caracteres (incluidos los de separación). Se debe usar al final de una ruta y no debe haber otros comodines en la ruta. También se puede usar con una extensión de nombre de archivo (como .ndjson), que importa todos los archivos con la extensión de nombre de archivo del directorio especificado y sus subdirectorios. Por ejemplo, gs://BUCKET/DIRECTORY/**.ndjson importa todos los archivos con la extensión .ndjson de DIRECTORY y sus subdirectorios.
      • Usa ? para hacer que coincida 1 carácter. Por ejemplo, gs://BUCKET/DIRECTORY/Example?.ndjson coincide con Example1.ndjson, pero no con Example.ndjson ni con Example01.ndjson.

7. Haz clic en Importar para importar mensajes HL7v2 desde la fuente definida.

8. Para hacer un seguimiento del estado de la operación, haga clic en la pestaña Operaciones. Una vez que se haya completado la operación, aparecerán las siguientes indicaciones:
   • La sección Estado de la operación de larga duración tiene una marca de verificación verde en el encabezado OK.
   • La sección Resumen tiene una marca de verificación verde y un indicador OK en la misma fila que el ID de operación.
   Si se produce algún error, haz clic en Acciones y, a continuación, en Ver detalles en Cloud Logging.

API

En los siguientes ejemplos se muestra cómo importar mensajes HL7v2 desde Cloud Storage mediante el método projects.locations.datasets.hl7V2Stores.import.

Cuando llames a la operación de importación, ten en cuenta lo siguiente:

• La ubicación del archivo dentro del segmento es arbitraria y no tiene por qué coincidir exactamente con el formato especificado en los siguientes ejemplos.
• Al especificar la ubicación de los mensajes HL7v2 en Cloud Storage, puedes utilizar comodines para importar varios archivos desde uno o más directorios. Se admiten los siguientes comodines:
  • Usa * para hacer coincidir 0 o más caracteres que no sean de separación. Por ejemplo, gs://BUCKET/DIRECTORY/Example*.ndjson coincide con Example.ndjson y Example22.ndjson en DIRECTORY.
  • Usa ** para hacer coincidir 0 o más caracteres (incluidos los de separación). Se debe usar al final de una ruta y no debe haber otros comodines en la ruta. También se puede usar con una extensión de nombre de archivo (como .ndjson), que importa todos los archivos con la extensión de nombre de archivo del directorio especificado y sus subdirectorios. Por ejemplo, gs://BUCKET/DIRECTORY/**.ndjson importa todos los archivos con la extensión .ndjson de DIRECTORY y sus subdirectorios.
  • Usa ? para hacer que coincida 1 carácter. Por ejemplo, gs://BUCKET/DIRECTORY/Example?.ndjson coincide con Example1.ndjson, pero no con Example.ndjson ni con Example01.ndjson.

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data "{
      'gcsSource': {
        'uri': 'gs://BUCKET/DIRECTORY/HL7V2_MESSAGE_FILE'
      }
    }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID:import"

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

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

{
  "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.ImportMessages",
    "createTime": "CREATE_TIME",
    "endTime": "END_TIME"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.healthcare.v1.hl7v2.ImportMessagesResponse"
  }
}

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

Invoke-WebRequest `
  -Method Post `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -Body "{
    'gcsSource': {
      'uri': 'gs://BUCKET/DIRECTORY/HL7V2_MESSAGE_FILE'
    }
  }" `
  -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID:import" | Select-Object -Expand Content

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

$cred = gcloud auth application-default 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

{
  "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.ImportMessages",
    "createTime": "CREATE_TIME",
    "endTime": "END_TIME"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.healthcare.v1.hl7v2.ImportMessagesResponse"
  }
}