אחזור בכמות גדולה של הודעות HL7v2

בדף הזה מוסבר איך לקרוא הודעות בכמות גדולה ממאגר HL7v2 באמצעות השיטה projects.locations.datasets.hl7V2Stores.messages.batchGet. אפשר להשתמש ב-batchGet כדי לאחזר עד 100 הודעות HL7v2 בשיחה אחת.

אפשר להשתמש בהודעה projects.locations.datasets.hl7V2Stores.messages.get כדי לאחזר הודעת HL7v2 אחת בכל פעם, אבל אם יש לכם הרבה הודעות, יכול להיות שתיתקלו בעלויות רשת גבוהות מדי. כדי לאחזר כמה הודעות בקריאה ל-API אחת, משתמשים ב-batchGet.

קבלת הודעות של HL7v2 בכמות גדולה

בדוגמאות הבאות אפשר לראות איך מקבלים את התוכן של הודעות HL7v2 בכמות גדולה.

מידע נוסף זמין במאמר projects.locations.datasets.hl7V2Stores.messages.batchGet.

curl

כדי לקבל הודעות HL7v2 בכמות גדולה, שולחים GET בקשה ומציינים את הפרטים הבאים:

  • השם של קבוצת הנתונים הראשית
  • השם של מאגר HL7v2
  • טוקן גישה
  • פרמטר השאילתה names עם השמות של הודעות HL7v2 שרוצים לאחזר. לכל ערך names, מזינים את הנתיב המוגדר במלואו להודעה בפורמט: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID

בדוגמה הבאה מוצגת בקשת GET באמצעות curl.

curl -X GET \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID
      /locations/LOCATION/datasets/DATASET_ID
      /hl7V2Stores/HL7V2_STORE_ID/messages:batchGet?names=MESSAGE_NAME_1&names=MESSAGE_NAME_2&names=
      MESSAGE_NAME_3&view=FULL"

אם הבקשה מצליחה, השרת מחזיר את התגובה בפורמט JSON:

{
  "messages" : [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID"
    }
  ]
}

PowerShell

כדי לקבל הודעות HL7v2 בכמות גדולה, שולחים GET בקשה ומציינים את הפרטים הבאים:

  • השם של קבוצת הנתונים הראשית
  • השם של מאגר HL7v2
  • טוקן גישה
  • פרמטר השאילתה names עם השמות של הודעות HL7v2 שרוצים לאחזר. לכל ערך names, מזינים את הנתיב המוגדר במלואו להודעה בפורמט: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID

בדוגמה הבאה מוצגת בקשת GET באמצעות Windows PowerShell.

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

Invoke-WebRequest `
  -Method Get `
  -Headers $headers `
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages:batchGet?names=MESSAGE_NAME_1&names=MESSAGE_NAME_2&names=MESSAGE_NAME_3&view=FULL" | Select-Object -Expand Content

אם הבקשה מצליחה, השרת מחזיר את התגובה בפורמט JSON:

{
  "messages" : [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/MESSAGE_ID"
    }
  ]
}

מידע נוסף