בדף הזה מוסבר איך ליצור, לעדכן, לתקן, לראות, להציג ברשימה, לאחזר ולמחוק משאבי FHIR.
משאב FHIR יכול להכיל נתונים על מטופל, על מכשיר, על תצפית ועוד. רשימה מלאה של משאבי FHIR זמינה במדד משאבי FHIR (DSTU2, STU3, R4 או R5).
הדוגמאות של REST שבדף הזה פועלות עם מאגר R4 FHIR, ולא מובטח שהן יפעלו אם אתם משתמשים במאגר DSTU2 או STU3 FHIR. אם אתם משתמשים בחנות FHIR בגרסה DSTU2 או STU3, תוכלו לעיין במסמכי ה-FHIR הרשמיים כדי לקבל מידע על המרת הדוגמאות לגרסת ה-FHIR שבה אתם משתמשים.
הדוגמאות של Go, Java, Node.js ו-Python פועלות עם מאגר STU3 FHIR.
יצירת משאב FHIR
כדי ליצור משאבי FHIR, צריך קודם ליצור מאגר FHIR.
בדוגמאות של REST ו-Python אפשר לראות איך ליצור את משאבי ה-FHIR הבאים:
- משאב Patient (DSTU2, STU3, R4, and R5)
- An Encounter (DSTU2, STU3, R4, and R5) resource for the Patient
- משאב Observation (DSTU2, STU3, R4 ו-R5) של Encounter
בדוגמאות לכל שאר השפות מוסבר איך ליצור משאב FHIR כללי.
מידע נוסף זמין במאמר projects.locations.datasets.fhirStores.fhir.create.
דוגמאות ה-REST הבאות פועלות עם מאגרי R4 FHIR. הדוגמאות של Go, Java, Node.js ו-Python פועלות עם מאגרי STU3 FHIR.
המסוף
כדי להעלות משאבי FHIR באמצעות JSON למאגר FHIR, מבצעים את השלבים הבאים:
- במסוף Google Cloud , פותחים את הדף FHIR Viewer.
- בתפריט הנפתח FHIR Store, בוחרים מערך נתונים ואז בוחרים FHIR Store במערך הנתונים.
- לוחצים על הכרטיסייה העלאה.
-
באזור הטקסט, מזינים משאב FHIR תקין בפורמט JSON. לדוגמה:
הערה: אפשר גם להזין מערך JSON של כמה אובייקטים של משאבי FHIR.{ "name": [ { "use": "official", "family": "Smith", "given": [ "Darcy" ] } ], "gender": "female", "birthDate": "1970-01-01", "resourceType": "Patient" } - לוחצים על Save. אחרי שההעלאה מסתיימת, אפשר לראות את המשאבים ב-FHIR Viewer. איך מקבלים משאב FHIR
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DATASET_ID: מערך הנתונים הראשי של מאגר FHIR
- FHIR_STORE_ID: מזהה מאגר ה-FHIR
תוכן בקשת JSON:
{
"name": [
{
"use": "official",
"family": "Smith",
"given": [
"Darcy"
]
}
],
"gender": "female",
"birthDate": "1970-01-01",
"resourceType": "Patient"
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
cat > request.json << 'EOF'
{
"name": [
{
"use": "official",
"family": "Smith",
"given": [
"Darcy"
]
}
],
"gender": "female",
"birthDate": "1970-01-01",
"resourceType": "Patient"
}
EOFלאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/fhir+json" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
@'
{
"name": [
{
"use": "official",
"family": "Smith",
"given": [
"Darcy"
]
}
],
"gender": "female",
"birthDate": "1970-01-01",
"resourceType": "Patient"
}
'@ | Out-File -FilePath request.json -Encoding utf8לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/fhir+json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
Go
Java
Node.js
Python
אחרי שיוצרים את משאב המטופל, יוצרים משאב Encounter כדי לתאר אינטראקציה בין המטופל לבין איש מקצוע.
בשדה PATIENT_ID, מחליפים את המזהה מהתגובה שהוחזרה על ידי השרת כשיוצרים את מקור המידע של המטופל.
דוגמאות ה-REST הבאות פועלות עם מאגרי R4 FHIR. דוגמת ה-Python פועלת עם מאגרי STU3 FHIR.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DATASET_ID: מערך הנתונים הראשי של מאגר FHIR
- FHIR_STORE_ID: מזהה מאגר ה-FHIR
- PATIENT_ID: התגובה שהוחזרה על ידי השרת כשנוצר משאב המטופל
תוכן בקשת JSON:
{
"status": "finished",
"class": {
"system": "http://hl7.org/fhir/v3/ActCode",
"code": "IMP",
"display": "inpatient encounter"
},
"reasonCode": [
{
"text": "The patient had an abnormal heart rate. She was concerned about this."
}
],
"subject": {
"reference": "Patient/PATIENT_ID"
},
"resourceType": "Encounter"
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
cat > request.json << 'EOF'
{
"status": "finished",
"class": {
"system": "http://hl7.org/fhir/v3/ActCode",
"code": "IMP",
"display": "inpatient encounter"
},
"reasonCode": [
{
"text": "The patient had an abnormal heart rate. She was concerned about this."
}
],
"subject": {
"reference": "Patient/PATIENT_ID"
},
"resourceType": "Encounter"
}
EOFלאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/fhir+json" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Encounter"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
@'
{
"status": "finished",
"class": {
"system": "http://hl7.org/fhir/v3/ActCode",
"code": "IMP",
"display": "inpatient encounter"
},
"reasonCode": [
{
"text": "The patient had an abnormal heart rate. She was concerned about this."
}
],
"subject": {
"reference": "Patient/PATIENT_ID"
},
"resourceType": "Encounter"
}
'@ | Out-File -FilePath request.json -Encoding utf8לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/fhir+json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Encounter" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Python הוראות ההגדרה במאמר מדריך למתחילים לעבודה עם Cloud Healthcare API באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Cloud Healthcare API Python API.
כדי לבצע אימות ב-Cloud Healthcare API, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
אחרי שיוצרים את משאב Encounter, יוצרים משאב Observation שמשויך למשאב Encounter. משאב התצפית מספק מדידה של הדופק של המטופל בפעימות לדקה (BPM) (80 ב-bpm).
דוגמאות ה-REST הבאות פועלות עם מאגרי R4 FHIR. דוגמת ה-Python פועלת עם מאגרי STU3 FHIR.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DATASET_ID: מערך הנתונים הראשי של מאגר FHIR
- FHIR_STORE_ID: מזהה מאגר ה-FHIR
- PATIENT_ID: המזהה בתגובה שהוחזרה מהשרת כשיוצרים את משאב המטופל
- ENCOUNTER_ID: המזהה בתגובה שמוחזרת מהשרת כשיוצרים את משאב המפגש
תוכן בקשת JSON:
{
"resourceType": "Observation",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"identifier": [
{
"system": "my-code-system",
"value": "ABC-12345"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8867-4",
"display": "Heart rate"
}
]
},
"valueQuantity": {
"value": 80,
"unit": "bpm"
},
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
}
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
cat > request.json << 'EOF'
{
"resourceType": "Observation",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"identifier": [
{
"system": "my-code-system",
"value": "ABC-12345"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8867-4",
"display": "Heart rate"
}
]
},
"valueQuantity": {
"value": 80,
"unit": "bpm"
},
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
}
}
EOFלאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/fhir+json" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
@'
{
"resourceType": "Observation",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"identifier": [
{
"system": "my-code-system",
"value": "ABC-12345"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8867-4",
"display": "Heart rate"
}
]
},
"valueQuantity": {
"value": 80,
"unit": "bpm"
},
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
}
}
'@ | Out-File -FilePath request.json -Encoding utf8לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/fhir+json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
Python
לפני שמנסים את הדוגמה הזו, צריך לפעול לפי Python הוראות ההגדרה במאמר מדריך למתחילים לעבודה עם Cloud Healthcare API באמצעות ספריות לקוח. מידע נוסף מופיע במאמרי העזרה של Cloud Healthcare API Python API.
כדי לבצע אימות ב-Cloud Healthcare API, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
יצירה מותנית של משאב FHIR
בדוגמה הבאה של curl אפשר לראות איך משתמשים בשיטה projects.locations.datasets.fhirStores.fhir.create כדי ליצור משאב FHIR באופן מותנה. השיטה מיישמת את האינטראקציה המותנית של FHIR create (DSTU2, STU3, R4, R5).
אפשר להשתמש ביצירה מותנית כדי להימנע מיצירה של משאבי FHIR כפולים. לדוגמה, לכל משאב Patient בשרת FHIR יש בדרך כלל מזהה ייחודי, כמו מספר תיק רפואי (MRN). כדי ליצור משאב חדש מסוג Patient (מטופל) ולוודא שלא קיים משאב מסוג Patient עם אותו מספר רשומה רפואית (MRN), יוצרים את המשאב החדש באופן מותנה באמצעות שאילתת חיפוש. Cloud Healthcare API יוצר את המשאב החדש רק אם אין התאמות לשאילתת החיפוש.
התגובה של השרת תלויה במספר המשאבים שתאמו לשאילתת החיפוש:
| התאמות | קוד תגובת HTTP | התנהגות |
|---|---|---|
| אפס | 201 CREATED |
יוצר את המשאב החדש. |
| אחד | 200 OK |
לא יוצר משאב חדש. |
| יותר מאחד | 412 Precondition Failed |
לא נוצר משאב חדש ומוחזרת שגיאה "search criteria are not selective enough". |
כדי להשתמש באינטראקציה create עם תנאי במקום באינטראקציה create, צריך לציין בבקשה כותרת HTTP If-None-Exist שמכילה שאילתת חיפוש ב-FHIR:
If-None-Exist: FHIR_SEARCH_QUERY
ב-Cloud Healthcare API v1, פעולות מותנות משתמשות באופן בלעדי בפרמטר החיפוש identifier, אם הוא קיים עבור סוג משאב FHIR, כדי לקבוע אילו משאבי FHIR תואמים לשאילתת חיפוש מותנית.
REST
בדוגמה הבאה מוצג אופן היצירה של משאב Observation באמצעות כותרת HTTP If-None-Exist: identifier=my-code-system|ABC-12345. Cloud Healthcare API יוצר את המשאב רק אם אין משאב Observation קיים שתואם לשאילתה identifier=my-code-system|ABC-12345.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/fhir+json" \ -H "If-None-Exist: identifier=my-code-system|ABC-12345" \ -d @request.json \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation"
בדוגמה הבאה של פלט מוצגת בכוונה בקשה שנכשלה. כדי לראות את התגובה מבקשה שהצליחה, אפשר לעיין במאמר בנושא יצירת משאב FHIR.
אם כמה משאבי Observation תואמים לשאילתה, Cloud Healthcare API מחזיר את התגובה הבאה, והבקשה ליצירה מותנית נכשלת:
{
"issue": [
{
"code": "conflict",
"details": {
"text": "ambiguous_query"
},
"diagnostics": "search criteria are not selective enough",
"severity": "error"
}
],
"resourceType": "OperationOutcome"
}
עדכון משאב FHIR
בדוגמאות הבאות אפשר לראות איך משתמשים בשיטה projects.locations.datasets.fhirStores.fhir.update כדי לעדכן משאב FHIR. השיטה מטמיעה את תקן FHIR
לעדכון אינטראקציה
(DSTU2,
STU3,
R4,
ו-R5).
כשמעדכנים משאב, מעדכנים את כל התוכן שלו. זה שונה מתיקון משאב, שבו מתעדכן רק חלק מהמשאב.
אם המאגר של FHIR כולל את הערך enableUpdateCreate, הבקשה מטופלת כבקשת upsert (עדכון או הוספה) שמעדכנת את המשאב אם הוא קיים, או מוסיפה אותו באמצעות המזהה שצוין בבקשה אם הוא לא קיים.
גוף הבקשה חייב להכיל משאב FHIR מקודד באמצעות JSON, וכותרות הבקשה חייבות להכיל את הערך Content-Type: application/fhir+json. המשאב צריך לכלול את הרכיב id עם ערך זהה למזהה בנתיב REST של הבקשה.
דוגמאות ה-REST הבאות פועלות עם מאגרי R4 FHIR. הדוגמאות של Go, Java, Node.js ו-Python פועלות עם מאגרי STU3 FHIR.
REST
בדוגמאות הבאות אפשר לראות איך מעדכנים את מספר הפעימות בדקה (BPM) במשאב Observation.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DATASET_ID: מערך הנתונים הראשי של מאגר FHIR
- FHIR_STORE_ID: מזהה מאגר ה-FHIR
- OBSERVATION_ID: מזהה משאב ה-Observation
- PATIENT_ID: מזהה משאב המטופל
- ENCOUNTER_ID: מזהה משאב המפגש
- BPM_VALUE: הערך של פעימות לדקה (BPM) במשאב Observation המעודכן
תוכן בקשת JSON:
{
"resourceType": "Observation",
"id": "OBSERVATION_ID",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"identifier": [
{
"system": "my-code-system",
"value": "ABC-12345"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8867-4",
"display": "Heart rate"
}
]
},
"valueQuantity": {
"value": BPM_VALUE,
"unit": "bpm"
},
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
}
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
cat > request.json << 'EOF'
{
"resourceType": "Observation",
"id": "OBSERVATION_ID",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"identifier": [
{
"system": "my-code-system",
"value": "ABC-12345"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8867-4",
"display": "Heart rate"
}
]
},
"valueQuantity": {
"value": BPM_VALUE,
"unit": "bpm"
},
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
}
}
EOFלאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
curl -X PUT \
-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/fhirStores/FHIR_STORE_ID/fhir/Observation/OBSERVATION_ID"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
@'
{
"resourceType": "Observation",
"id": "OBSERVATION_ID",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"identifier": [
{
"system": "my-code-system",
"value": "ABC-12345"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8867-4",
"display": "Heart rate"
}
]
},
"valueQuantity": {
"value": BPM_VALUE,
"unit": "bpm"
},
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
}
}
'@ | Out-File -FilePath request.json -Encoding utf8לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PUT `
-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/fhirStores/FHIR_STORE_ID/fhir/Observation/OBSERVATION_ID" | Select-Object -Expand Content
APIs Explorer
מעתיקים את גוף הבקשה ופותחים את דף העזר של השיטה. החלונית של API Explorer תיפתח בצד שמאל של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. מדביקים את גוף הבקשה בכלי הזה, ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
Go
Node.js
Python
עדכון משאב FHIR באופן מותנה
הדוגמאות הבאות מראות איך להפעיל את השיטה projects.locations.datasets.fhirStores.fhir.conditionalUpdate כדי לעדכן משאב FHIR שתואם לשאילתת חיפוש, במקום לזהות את המשאב לפי המזהה שלו. השיטה מטמיעה את האינטראקציה של עדכון מותנה בתקן FHIR (DSTU2, STU3, R4 ו-R5).
אפשר להחיל עדכון מותנה רק על משאב FHIR אחד בכל פעם.
התגובה שמוחזרת מהשרת תלויה במספר ההתאמות שמתקבלות על סמך קריטריוני החיפוש:
- התאמה אחת: המשאב עודכן בהצלחה או שהוחזרה שגיאה.
- יותר מהתאמה אחת: הבקשה מחזירה שגיאה
412 Precondition Failed. - אפס התאמות עם
id: אם הקריטריונים לחיפוש לא מזהים התאמות, גוף הבקשה שסופק מכילid, ובמאגר FHIR מוגדרenableUpdateCreateעם הערךtrue, משאב FHIR נוצר עםidבגוף הבקשה. - אפס התאמות ללא
id: אם קריטריוני החיפוש מזהים אפס התאמות וגוף הבקשה שסופק לא מכילid, משאב ה-FHIR נוצר עם מזהה שהוקצה על ידי השרת כאילו המשאב נוצר באמצעותprojects.locations.datasets.fhirStores.fhir.create.
גוף הבקשה חייב להכיל משאב FHIR מקודד באמצעות JSON, וכותרות הבקשה חייבות להכיל את הערך Content-Type: application/fhir+json.
ב-Cloud Healthcare API v1, פעולות מותנות משתמשות באופן בלעדי בפרמטר החיפוש identifier, אם הוא קיים עבור סוג משאב FHIR, כדי לקבוע אילו משאבי FHIR תואמים לשאילתת חיפוש מותנית.
REST
בדוגמה הבאה מוצגות בקשת PUT באמצעות curl ו-PowerShell לעריכת משאב Observation באמצעות המזהה של ה-Observation (ABC-12345 ב-my-code-system). ה-Observation מספק מדידה של פעימות הלב לדקה (BPM) של המטופל.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DATASET_ID: מערך הנתונים הראשי של מאגר FHIR
- FHIR_STORE_ID: מזהה מאגר ה-FHIR
- PATIENT_ID: מזהה משאב המטופל
- ENCOUNTER_ID: מזהה משאב המפגש
- BPM_VALUE: הערך של פעימות לדקה (BPM) במשאב Observation
תוכן בקשת JSON:
{
"resourceType": "Observation",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"identifier": [
{
"system": "my-code-system",
"value": "ABC-12345"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8867-4",
"display": "Heart rate"
}
]
},
"valueQuantity": {
"value": BPM_VALUE,
"unit": "bpm"
},
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
}
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
cat > request.json << 'EOF'
{
"resourceType": "Observation",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"identifier": [
{
"system": "my-code-system",
"value": "ABC-12345"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8867-4",
"display": "Heart rate"
}
]
},
"valueQuantity": {
"value": BPM_VALUE,
"unit": "bpm"
},
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
}
}
EOFלאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
curl -X PUT \
-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/fhirStores/FHIR_STORE_ID/fhir/Observation?identifier=my-code-system|ABC-12345"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
@'
{
"resourceType": "Observation",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"identifier": [
{
"system": "my-code-system",
"value": "ABC-12345"
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8867-4",
"display": "Heart rate"
}
]
},
"valueQuantity": {
"value": BPM_VALUE,
"unit": "bpm"
},
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
}
}
'@ | Out-File -FilePath request.json -Encoding utf8לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PUT `
-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/fhirStores/FHIR_STORE_ID/fhir/Observation?identifier=my-code-system|ABC-12345" | Select-Object -Expand Content
APIs Explorer
מעתיקים את גוף הבקשה ופותחים את דף העזר של השיטה. החלונית של API Explorer תיפתח בצד שמאל של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. מדביקים את גוף הבקשה בכלי הזה, ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
תיקון משאב FHIR
בדוגמאות הבאות אפשר לראות איך מפעילים את השיטה projects.locations.datasets.fhirStores.fhir.patch כדי לעדכן משאב FHIR. השיטה מיישמת את אינטראקציית התיקון בתקן FHIR (DSTU2, STU3, R4 ו-R5).
כשמבצעים תיקון של משאב, מעדכנים חלק מהמשאב על ידי הפעלת הפעולות שמצוינות במסמך JSON Patch.
הבקשה חייבת להכיל מסמך JSON patch, וכותרות הבקשה חייבות להכיל את הערך Content-Type: application/json-patch+json.
בדוגמאות הבאות אפשר לראות איך מעדכנים משאב מסוג Observation. התצפית על פעימות הלב של המטופל לדקה (BPM) מתעדכנת באמצעות פעולת התיקון replace.
דוגמאות ה-REST הבאות פועלות עם מאגרי R4 FHIR. הדוגמאות של Go, Java, Node.js ו-Python פועלות עם מאגרי STU3 FHIR.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DATASET_ID: מערך הנתונים הראשי של מאגר FHIR
- FHIR_STORE_ID: מזהה מאגר ה-FHIR
- OBSERVATION_ID: מזהה משאב ה-Observation
- BPM_VALUE: הערך של פעימות לדקה (BPM) במשאב Observation שעבר תיקון
תוכן בקשת JSON:
[
{
"op": "replace",
"path": "/valueQuantity/value",
"value": BPM_VALUE
}
]
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
cat > request.json << 'EOF'
[
{
"op": "replace",
"path": "/valueQuantity/value",
"value": BPM_VALUE
}
]
EOFלאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json-patch+json" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation/OBSERVATION_ID"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
@'
[
{
"op": "replace",
"path": "/valueQuantity/value",
"value": BPM_VALUE
}
]
'@ | Out-File -FilePath request.json -Encoding utf8לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json-patch+json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation/OBSERVATION_ID" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
Go
Java
Node.js
Python
ביצוע בקשת PATCH בחבילת FHIR
אפשר לציין בקשה ב-FHIR bundle (רק FHIR R4).PATCH
ביצוע בקשת PATCH בחבילת FHIR מאפשר לתקן הרבה משאבי FHIR בבת אחת, במקום לשלוח בקשות תיקון נפרדות לכל משאב FHIR.
כדי לשלוח בקשת PATCH בחבילה, צריך לציין את הפרטים הבאים באובייקט resource בבקשה:
- שדה
resourceTypeמוגדר לערךBinary - שדה
contentTypeמוגדר לערךapplication/json-patch+json - גוף התיקון בקידוד base64
מוודאים שאובייקט resource נראה כך:
"resource": {
"resourceType": "Binary",
"contentType": "application/json-patch+json",
"data": "WyB7ICJvcCI6ICJyZXBsYWNlIiwgInBhdGgiOiAiL2JpcnRoRGF0ZSIsICJ2YWx1ZSI6ICIxOTkwLTAxLTAxIiB9IF0K"
}
הדוגמה הבאה מציגה את גוף התיקון שקודד ל-base64 בשדה data:
[
{
"op": "replace",
"path": "/birthdate",
"value": "1990-01-01"
}
]
בדוגמאות הבאות אפשר לראות איך משתמשים בבקשת PATCH בחבילה כדי לתקן את משאב המטופל שיצרתם במאמר יצירת משאב FHIR כך שערך birthDate יהיה 1990-01-01:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים הראשי
- DATASET_ID: מערך הנתונים הראשי של מאגר FHIR
- FHIR_STORE_ID: מזהה מאגר ה-FHIR
- PATIENT_ID: המזהה של משאב Patient קיים
תוכן בקשת JSON:
{
"type": "transaction",
"resourceType": "Bundle",
"entry": [
{
"request": {
"method": "PATCH",
"url": "Patient/PATIENT_ID"
},
"resource": {
"resourceType": "Binary",
"contentType": "application/json-patch+json",
"data": "WyB7ICJvcCI6ICJyZXBsYWNlIiwgInBhdGgiOiAiL2JpcnRoRGF0ZSIsICJ2YWx1ZSI6ICIxOTkwLTAxLTAxIiB9IF0K"
}
}
]
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
cat > request.json << 'EOF'
{
"type": "transaction",
"resourceType": "Bundle",
"entry": [
{
"request": {
"method": "PATCH",
"url": "Patient/PATIENT_ID"
},
"resource": {
"resourceType": "Binary",
"contentType": "application/json-patch+json",
"data": "WyB7ICJvcCI6ICJyZXBsYWNlIiwgInBhdGgiOiAiL2JpcnRoRGF0ZSIsICJ2YWx1ZSI6ICIxOTkwLTAxLTAxIiB9IF0K"
}
}
]
}
EOFלאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/fhir+json" \
-d @request.json \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
@'
{
"type": "transaction",
"resourceType": "Bundle",
"entry": [
{
"request": {
"method": "PATCH",
"url": "Patient/PATIENT_ID"
},
"resource": {
"resourceType": "Binary",
"contentType": "application/json-patch+json",
"data": "WyB7ICJvcCI6ICJyZXBsYWNlIiwgInBhdGgiOiAiL2JpcnRoRGF0ZSIsICJ2YWx1ZSI6ICIxOTkwLTAxLTAxIiB9IF0K"
}
}
]
}
'@ | Out-File -FilePath request.json -Encoding utf8לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/fhir+json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
החלת תיקון על משאב FHIR באופן מותנה
בדוגמאות הבאות אפשר לראות איך מפעילים את השיטה projects.locations.datasets.fhirStores.fhir.conditionalPatch כדי לשנות משאב FHIR שתואם לשאילתת חיפוש, במקום לזהות את המשאב לפי המזהה שלו. השיטה מטמיעה את תקן FHIR
conditional patch interaction
(DSTU2,
STU3,
R4,
and R4).
אפשר להחיל תיקון מותנה רק על משאב אחד בכל פעם. אם קריטריוני החיפוש מזהים יותר מהתאמה אחת, הבקשה מחזירה שגיאת 412 Precondition Failed. אם קריטריון החיפוש לא מזהה התאמות, הבקשה מחזירה שגיאת 404 Not Found.
ב-Cloud Healthcare API v1, פעולות מותנות משתמשות באופן בלעדי בפרמטר החיפוש identifier, אם הוא קיים עבור סוג משאב FHIR, כדי לקבוע אילו משאבי FHIR תואמים לשאילתת חיפוש מותנית.
REST
בדוגמאות הבאות אפשר לראות איך לשלוח בקשת PATCH לעריכת משאב Observation אם המזהה של ה-Observation הוא ABC-12345 ב-my-code-system.
התצפית על פעימות הלב של המטופל בדקה (BPM) מתעדכנת באמצעות פעולת התיקון replace.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DATASET_ID: מערך הנתונים הראשי של מאגר FHIR
- FHIR_STORE_ID: מזהה מאגר ה-FHIR
- BPM_VALUE: הערך של פעימות לדקה (BPM) במשאב Observation
תוכן בקשת JSON:
[
{
"op": "replace",
"path": "/valueQuantity/value",
"value": BPM_VALUE
}
]
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
cat > request.json << 'EOF'
[
{
"op": "replace",
"path": "/valueQuantity/value",
"value": BPM_VALUE
}
]
EOFלאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json-patch+json" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation?identifier=my-code-system|ABC-12345"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
@'
[
{
"op": "replace",
"path": "/valueQuantity/value",
"value": BPM_VALUE
}
]
'@ | Out-File -FilePath request.json -Encoding utf8לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json-patch+json" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation?identifier=my-code-system|ABC-12345" | Select-Object -Expand Content
APIs Explorer
מעתיקים את גוף הבקשה ופותחים את דף העזר של השיטה. החלונית של API Explorer תיפתח בצד שמאל של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. מדביקים את גוף הבקשה בכלי הזה, ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
קבלת משאב FHIR
בדוגמאות הבאות אפשר לראות איך מקבלים את התוכן של משאב FHIR.
דוגמאות ה-REST הבאות פועלות עם מאגרי R4 FHIR. הדוגמאות של Go, Java, Node.js ו-Python פועלות עם מאגרי STU3 FHIR.
המסוף
נכנסים לדף FHIR viewer במסוף Google Cloud .
ברשימה הנפתחת FHIR Store (מאגר FHIR), בוחרים מערך נתונים ואז בוחרים מאגר FHIR במערך הנתונים.
כדי לסנן את רשימת סוגי המשאבים, מחפשים את סוגי המשאבים שרוצים להציג.
לוחצים על השדה סוג המשאב.
ברשימה הנפתחת Properties שמופיעה, בוחרים באפשרות Resource Type.
מזינים סוג משאב.
כדי לחפש סוג משאב אחר, בוחרים באפשרות OR מהרשימה הנפתחת Operators שמופיעה, ואז מזינים סוג משאב אחר.
ברשימת סוגי המשאבים, בוחרים את סוג המשאב שרוצים לקבל את התוכן שלו.
בטבלת המשאבים שמופיעה, בוחרים משאב או מחפשים משאב.
REST
בדוגמאות הבאות מוצגות דרכים להשתמש בשיטה projects.locations.datasets.fhirStores.fhir.read כדי לקבל את הפרטים של משאב ה-Observation שנוצר בקטע הקודם.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DATASET_ID: מערך הנתונים הראשי של מאגר FHIR
- FHIR_STORE_ID: מזהה מאגר ה-FHIR
- OBSERVATION_ID: מזהה משאב ה-Observation
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
curl
מריצים את הפקודה הבאה:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation/OBSERVATION_ID"
PowerShell
מריצים את הפקודה הבאה:
$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/fhirStores/FHIR_STORE_ID/fhir/Observation/OBSERVATION_ID" | Select-Object -Expand Content
APIs Explorer
פותחים את דף העזר של ה-method. החלונית של API Explorer תיפתח בצד שמאל של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
Go
Java
Node.js
Python
קבלת כל הפרטים של משאב Encounter
בדוגמאות הבאות אפשר לראות איך צופים בפרטים על משאב Encounter ובכל המשאבים שקשורים אליו.
השיטה מטמיעה את הפעולה המורחבת של FHIR Encounter-everything שמוגדרת בגרסאות הבאות של FHIR:
REST
משתמשים בשיטה projects.locations.datasets.fhirStores.fhir.Encounter-everything.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מזהה קבוצת הנתונים -
FHIR_STORE_ID: מזהה מאגר ה-FHIR -
ENCOUNTER_ID: מזהה משאב המפגש
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
curl
מריצים את הפקודה הבאה:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Encounter/ENCOUNTER_ID/\$everything"
PowerShell
מריצים את הפקודה הבאה:
$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/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Encounter/ENCOUNTER_ID/\$everything" | Select-Object -Expand Content
c427ce3e-7677-400e-bc06-33a8cecfdd77, שהוא משאב סינתטי בקטגוריה הציבורית של Cloud Storage gs://gcp-public-data--synthea-fhir-data-10-patients/fhir_r4_ndjson/.
קבלת כל משאבי תא המטופל
בדוגמאות הבאות מוצגות דרכים לאחזור כל המשאבים שמשויכים לתא מטופל מסוים (DSTU2, STU3, R4 ו-R5).
מידע נוסף זמין במאמר projects.locations.datasets.fhirStores.fhir.Patient-everything.
דוגמאות ה-REST הבאות פועלות עם מאגרי R4 FHIR. הדוגמאות של Go, Java, Node.js ו-Python פועלות עם מאגרי STU3 FHIR.
המסוף
כדי לראות משאבים בתא של מטופל ב-FHIR Viewer, פועלים לפי השלבים הבאים:
- במסוף Google Cloud , פותחים את הדף FHIR Viewer.
- בתפריט הנפתח FHIR Store, בוחרים מערך נתונים ואז בוחרים FHIR Store במערך הנתונים.
-
כדי לסנן את רשימת סוגי המשאבים לפי משאבי
Patient, לוחצים על השדה Resource Type ובוחרים באפשרות Resource Type בתפריט הנפתח Properties. מזיניםPatientבתור ערך המסנן. - לוחצים על הקישור של סוג המשאב
Patientבשורה בטבלה. - בטבלת המקורות שמופיעה, בוחרים מטופל או מחפשים מטופל.
- בפינה השמאלית העליונה מופיע הלחצן Explore patient (ניתוח נתוני המטופל). לוחצים עליו כדי לראות את נתוני המטופל.
curl
כדי לקבל את המשאבים במחיצה של מטופל, צריך לשלוח בקשת GET ולציין את הפרטים הבאים:
- השם של קבוצת הנתונים הראשית
- השם של מאגר FHIR
- מזהה המטופל
- טוקן גישה
בדוגמה הבאה מוצגת בקשת GET באמצעות curl:
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/fhirStores/FHIR_STORE_ID/fhir/Patient/PATIENT_ID/\$everything"
אם הבקשה מצליחה, השרת מחזיר תגובה שדומה לדוגמה הבאה בפורמט JSON:
{
"entry": [
{
"resource": {
"birthDate": "1970-01-01",
"gender": "female",
"id": "PATIENT_ID",
"name": [
{
"family": "Smith",
"given": [
"Darcy"
],
"use": "official"
}
],
"resourceType": "Patient"
}
},
{
"resource": {
"class": {
"code": "IMP",
"display": "inpatient encounter",
"system": "http://hl7.org/fhir/v3/ActCode"
},
"id": "ENCOUNTER_ID",
"reasonCode": [
{
"text": "The patient had an abnormal heart rate. She was concerned about this."
}
],
"resourceType": "Encounter",
"status": "finished",
"subject": {
"reference": "Patient/PATIENT_ID"
}
}
},
{
"resource": {
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"id": "OBSERVATION_ID",
"resourceType": "Observation",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"valueQuantity": {
"unit": "bpm",
"value": BPM_VALUE
}
}
}
],
"resourceType": "Bundle",
"type": "searchset"
}
PowerShell
כדי לקבל את המשאבים במחיצה של מטופל, צריך לשלוח בקשת GET ולציין את הפרטים הבאים:
- השם של קבוצת הנתונים הראשית
- השם של מאגר FHIR
- מזהה המטופל
- טוקן גישה
בדוגמה הבאה מוצגת בקשת GET באמצעות PowerShell:
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -Uri 'https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/RESOURCE_ID/$everything' | ConvertTo-Json
אם הבקשה מצליחה, השרת מחזיר תגובה שדומה לדוגמה הבאה בפורמט JSON:
{
"entry": [
{
"resource": {
"birthDate": "1970-01-01",
"gender": "female",
"id": "PATIENT_ID",
"name": [
{
"family": "Smith",
"given": [
"Darcy"
],
"use": "official"
}
],
"resourceType": "Patient"
}
},
{
"resource": {
"class": {
"code": "IMP",
"display": "inpatient encounter",
"system": "http://hl7.org/fhir/v3/ActCode"
},
"id": "ENCOUNTER_ID",
"reasonCode": [
{
"text": "The patient had an abnormal heart rate. She was concerned about this."
}
],
"resourceType": "Encounter",
"status": "finished",
"subject": {
"reference": "Patient/PATIENT_ID"
}
}
},
{
"resource": {
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"id": "OBSERVATION_ID",
"resourceType": "Observation",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"valueQuantity": {
"unit": "bpm",
"value": BPM_VALUE
}
}
}
],
"resourceType": "Bundle",
"type": "searchset"
}
Go
Java
Node.js
Python
קבלת משאבים של תאים של מטופלים שסוננו לפי סוג או תאריך
בדוגמאות הבאות מוצגות דרכים לאחזר את כל המשאבים שמשויכים לתא מטופל (R4) מסוים, מסוננים לפי רשימת סוגים ומאז תאריך ושעה ספציפיים.
מידע נוסף זמין במאמר projects.locations.datasets.fhirStores.fhir.Patient-everything.
דוגמאות ה-REST הבאות פועלות עם מאגרי R4 FHIR.
curl
כדי לקבל את המשאבים בתא של מטופל מסוג מסוים ומאז תאריך מסוים, שולחים בקשת GET ומציינים את הפרטים הבאים:
- השם של קבוצת הנתונים הראשית
- השם של מאגר FHIR
- מזהה המטופל
- מחרוזת שאילתה שמכילה רשימה מופרדת בפסיקים של סוגי משאבים ותאריך התחלה
- טוקן גישה
בדוגמה הבאה מוצגת בקשת GET באמצעות curl:
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/fhirStores/FHIR_STORE_ID/fhir/Patient/PATIENT_ID/\$everything?_type=RESOURCE_TYPES&_since=DATE"
אם הבקשה תצליח, השרת יחזיר את כל המשאבים שתואמים לקריטריונים שצוינו בפורמט JSON.
PowerShell
כדי לקבל את המשאבים בתא של מטופל מסוג מסוים ומאז תאריך מסוים, שולחים בקשת GET ומציינים את הפרטים הבאים:
- השם של קבוצת הנתונים הראשית
- השם של מאגר FHIR
- מזהה המטופל
- מחרוזת שאילתה שמכילה רשימה מופרדת בפסיקים של סוגי משאבים ותאריך התחלה
- טוקן גישה
בדוגמה הבאה מוצגת בקשת GET באמצעות PowerShell:
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-RestMethod ` -Method Get ` -Headers $headers ` -Uri 'https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Patient/RESOURCE_ID/$everything?_type=RESOURCE_TYPES&_since=DATE' | ConvertTo-Json
אם הבקשה תצליח, השרת יחזיר את כל המשאבים שתואמים לקריטריונים שצוינו בפורמט JSON.
הצגת רשימה של גרסאות של משאבי FHIR
אפשר לראות את הגרסאות ההיסטוריות של משאב FHIR, כולל הגרסה הנוכחית וכל הגרסאות שנמחקו. כך תוכלו:
- מעקב אחרי שינויים בתיקים רפואיים של מטופלים, בתרופות או בתוכניות טיפול.
- אם משאב FHIR מכיל נתונים שגויים, אפשר להציג גרסאות קודמות כדי לגלות מתי הוזנו הנתונים השגויים ולשחזר את המידע הנכון.
- כדי לעמוד בדרישות הרגולטוריות, צריך לספק נתוני ביקורת מלאים.
דוגמאות ה-REST הבאות פועלות עם מאגרי R4 FHIR. הדוגמאות של Go, Java, Node.js ו-Python פועלות עם מאגרי STU3 FHIR.
המסוף
נכנסים לדף FHIR viewer במסוף Google Cloud .
בתפריט FHIR store, בוחרים מערך נתונים ואז בוחרים FHIR store במערך הנתונים.
כדי לסנן את רשימת סוגי משאבי FHIR, מחפשים את סוגי המשאבים שרוצים להציג.
לוחצים על השדה סוג המשאב.
ברשימה הנפתחת Properties שמופיעה, בוחרים באפשרות Resource Type.
מזינים סוג משאב FHIR.
ברשימת סוגי משאבי FHIR, בוחרים סוג משאב.
בטבלה של משאבי FHIR שמופיעה, בוחרים משאב או מחפשים משאב.
כדי לראות ולהשוות בין גרסאות היסטוריות של משאב FHIR, לוחצים על הכרטיסייה סקירה כללית ופועלים לפי השלבים הבאים:
- כדי לראות גרסאות היסטוריות של משאב FHIR, לוחצים על הצגת גרסאות היסטוריות באותה שורה של מזהה הגרסה. בחלונית בחירת גרסת משאב, בוחרים את הגרסה ולוחצים על אישור. הנתונים בגרסה מאוכלסים בכרטיסיות סקירה כללית, רכיבים ו-JSON.
- כדי להשוות בין שתי גרסאות של משאב FHIR, באותה שורה של מזהה גרסה, לוחצים על השוואת גרסאות של משאב. בחלונית בחירת גרסאות של משאבים להשוואה, בוחרים שתי גרסאות של משאבים ולוחצים על אישור. שתי הגרסאות של המשאב מוצגות בתצוגת השוואה. הגרסה הראשונה שבחרתם מוצגת בצד ימין והגרסה השנייה מוצגת בצד שמאל.
REST
משתמשים בשיטה projects.locations.datasets.fhirStores.fhir.history.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר FHIR -
FHIR_STORE_ID: מזהה מאגר ה-FHIR -
RESOURCE_TYPE: סוג משאב FHIR -
RESOURCE_ID: מזהה משאב FHIR
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
curl
בדוגמאות הבאות אפשר לראות איך מציגים את כל הגרסאות של משאב Observation. התצפית עודכנה פעם אחת אחרי היצירה המקורית שלה כדי לשנות את קצב פעימות הלב של המטופל (BPM).מריצים את הפקודה הבאה:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/RESOURCE_TYPE/RESOURCE_ID/_history"
PowerShell
בדוגמאות הבאות אפשר לראות איך מציגים את כל הגרסאות של משאב Observation. התצפית עודכנה פעם אחת אחרי היצירה המקורית שלה כדי לשנות את קצב פעימות הלב של המטופל (BPM).מריצים את הפקודה הבאה:
$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/fhirStores/FHIR_STORE_ID/fhir/RESOURCE_TYPE/RESOURCE_ID/_history" | Select-Object -Expand Content
{
"entry": [
{
"resource": {
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"id": "OBSERVATION_ID",
"meta": {
"lastUpdated": "2020-01-02T00:00:00+00:00",
"versionId": "MTU0MTE5MDk5Mzk2ODcyODAwMA"
},
"resourceType": "Observation",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"valueQuantity": {
"unit": "bpm",
"value": 85
}
}
},
{
"resource": {
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"id": "OBSERVATION_ID",
"meta": {
"lastUpdated": "2020-01-01T00:00:00+00:00",
"versionId": "MTU0MTE5MDg4MTY0MzQ3MjAwMA"
},
"resourceType": "Observation",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"valueQuantity": {
"unit": "bpm",
"value": 75
}
}
}
],
"resourceType": "Bundle",
"type": "history"
}
Go
Java
Node.js
Python
אחזור של גרסת משאב FHIR
בדוגמאות הבאות אפשר לראות איך מאחזרים גרסה ספציפית של משאב FHIR.
כדי למצוא גרסה ספציפית, אפשר לרשום את הגרסאות של משאב FHIR ואז להציג את המידע של הגרסה הזו. מזהה הגרסה מופיע בשדה "versionId". לדוגמה, אפשר לראות את גוף ה-JSON הבא שבו מודגשים מזהי הגרסה של משאב ה-Observation ברשימת גרסאות של משאבי FHIR:
{
"entry": [
{
"resource": {
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"id": "OBSERVATION_ID",
"meta": {
"lastUpdated": "2020-01-02T00:00:00+00:00",
"versionId": "MTU0MTE5MDk5Mzk2ODcyODAwMA"
},
...
{
"resource": {
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"id": "OBSERVATION_ID",
"meta": {
"lastUpdated": "2020-01-01T00:00:00+00:00",
"versionId": "MTU0MTE5MDg4MTY0MzQ3MjAwMA"
},
...
}
בדוגמאות הבאות נעשה שימוש במשאבים שנוצרו בקטע יצירת משאב FHIR, ומוצגות בהן דרכים לצפייה במשאב Observation. הדוגמאות של REST פועלות עם חנויות FHIR R4. הדוגמאות של Go, Node.js ו-Python פועלות עם מאגרי STU3 FHIR.
המסוף
נכנסים לדף FHIR viewer במסוף Google Cloud .
בתפריט FHIR store, בוחרים מערך נתונים ואז בוחרים FHIR store במערך הנתונים.
כדי לסנן את רשימת סוגי משאבי FHIR, מחפשים את סוגי המשאבים שרוצים להציג.
לוחצים על השדה סוג המשאב.
ברשימה הנפתחת Properties שמופיעה, בוחרים באפשרות Resource Type.
מזינים סוג משאב FHIR.
ברשימת סוגי משאבי FHIR, בוחרים סוג משאב.
בטבלה של משאבי FHIR שמופיעה, בוחרים משאב או מחפשים משאב.
כדי לראות גרסה ספציפית של משאב FHIR:
- לוחצים על הכרטיסייה סקירה כללית.
- באותה שורה של מזהה גרסה, לוחצים על הצגת גרסאות היסטוריות.
- בחלונית בחירת גרסת משאב, בוחרים את הגרסה ולוחצים על אישור. הנתונים בגרסה מאוכלסים בכרטיסיות סקירה כללית, רכיבים ו-JSON.
REST
משתמשים בשיטה projects.locations.datasets.fhirStores.fhir.vread.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר FHIR -
FHIR_STORE_ID: מזהה מאגר ה-FHIR -
RESOURCE_TYPE: סוג משאב FHIR -
RESOURCE_ID: מזהה משאב FHIR -
RESOURCE_VERSION: גרסת משאב ה-FHIR
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
curl
בדוגמאות הבאות אפשר לראות איך מציגים את כל הגרסאות של משאב Observation. התצפית עודכנה פעם אחת אחרי היצירה המקורית שלה כדי לשנות את קצב פעימות הלב של המטופל (BPM).מריצים את הפקודה הבאה:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/RESOURCE_TYPE/RESOURCE_ID/_history/RESOURCE_VERSION"
PowerShell
בדוגמאות הבאות אפשר לראות איך מציגים את כל הגרסאות של משאב Observation. התצפית עודכנה פעם אחת אחרי היצירה המקורית שלה כדי לשנות את קצב פעימות הלב של המטופל (BPM).מריצים את הפקודה הבאה:
$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/fhirStores/FHIR_STORE_ID/fhir/RESOURCE_TYPE/RESOURCE_ID/_history/RESOURCE_VERSION" | Select-Object -Expand Content
{
"encounter": {
"reference": "Encounter/ENCOUNTER_ID"
},
"effectiveDateTime": "2020-01-01T00:00:00+00:00",
"id": "OBSERVATION_ID",
"meta": {
"lastUpdated": "2020-01-01T00:00:00+00:00",
"versionId": "MTU0MTE5MDg4MTY0MzQ3MjAwMA"
},
"resourceType": "Observation",
"status": "final",
"subject": {
"reference": "Patient/PATIENT_ID"
},
"valueQuantity": {
"unit": "bpm",
"value": 75
}
}
Go
Java
Node.js
Python
מחיקת משאב FHIR
בדוגמאות הבאות אפשר לראות איך מפעילים את השיטה projects.locations.datasets.fhirStores.fhir.delete כדי למחוק משאב מסוג Observation FHIR.
לא משנה אם הפעולה הצליחה או נכשלה, השרת מחזיר קוד סטטוס 200 OK של HTTP. כדי לוודא שהמשאב נמחק בהצלחה, מחפשים או מקבלים את המשאב ובודקים אם הוא קיים.
דוגמאות ה-REST הבאות פועלות עם מאגרי R4 FHIR. הדוגמאות של Go, Java, Node.js ו-Python פועלות עם מאגרי STU3 FHIR.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Google Cloud
- LOCATION: המיקום של מערך הנתונים
- DATASET_ID: מערך הנתונים הראשי של מאגר FHIR
- FHIR_STORE_ID: מזהה מאגר ה-FHIR
- OBSERVATION_ID: מזהה משאב ה-Observation
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
curl
מריצים את הפקודה הבאה:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation/OBSERVATION_ID"
PowerShell
מריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation/OBSERVATION_ID" | Select-Object -Expand Content
APIs Explorer
פותחים את דף העזר של ה-method. החלונית של API Explorer תיפתח בצד שמאל של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
Go
Java
Node.js
Python
מחיקה מותנית של משאב FHIR
ב-Cloud Healthcare API v1, פעולות מותנות משתמשות באופן בלעדי בפרמטר החיפוש identifier, אם הוא קיים בסוג המשאב FHIR, כדי לקבוע אילו משאבי FHIR תואמים לשאילתת חיפוש מותנה.
משאב FHIR תואם לשאילתה ?identifier=my-code-system|ABC-12345 אם ורק אם הערך של identifier.system במשאב הוא my-code-system והערך של identifier.value הוא ABC-12345. אם משאב FHIR תואם לשאילתה, Cloud Healthcare API מוחק את המשאב.
אם בשאילתה נעשה שימוש בפרמטר החיפוש identifier והיא תואמת לכמה משאבי FHIR, Cloud Healthcare API מחזיר שגיאה "412 - Condition not selective enough".
כדי למחוק את המשאבים בנפרד, פועלים לפי השלבים הבאים:
הדוגמאות הבאות מראות איך למחוק באופן מותנה משאב FHIR שתואם לשאילתת חיפוש, במקום לזהות את משאב FHIR לפי המזהה שלו.
שאילתת החיפוש תואמת למשאב Observation ותמחק אותו באמצעות המזהה של Observation (ABC-12345 ב-my-code-system).
REST
משתמשים בשיטה projects.locations.datasets.fhirStores.fhir.conditionalDelete.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר FHIR -
FHIR_STORE_ID: מזהה מאגר ה-FHIR
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
curl
מריצים את הפקודה הבאה:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation?identifier=my-code-system|ABC-12345"
PowerShell
מריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/Observation?identifier=my-code-system|ABC-12345" | Select-Object -Expand Content
APIs Explorer
פותחים את דף העזר של ה-method. החלונית של API Explorer תיפתח בצד שמאל של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.
מחיקה של גרסאות היסטוריות של משאב FHIR
בדוגמאות הבאות מוצג איך למחוק את כל הגרסאות הקודמות של משאב FHIR באמצעות השיטה projects.locations.datasets.fhirStores.fhir.Resource-purge.
השימוש במתודה projects.locations.datasets.fhirStores.fhir.Resource-purge
מוגבל למשתמשים (מתקשרים) עם התפקיד roles/healthcare.fhirStoreAdmin. משתמשים עם התפקיד roles/healthcare.fhirResourceEditor לא יכולים להשתמש במתודה. כדי לאפשר למתקשר למחוק גרסאות היסטוריות של משאב FHIR, אפשר:
- מוודאים שלמתקשר מוקצה התפקיד
roles/healthcare.fhirStoreAdmin. - יוצרים תפקיד IAM בהתאמה אישית עם ההרשאה
healthcare.fhirResources.purgeומקצים את התפקיד לקורא.
בדוגמאות נעשה שימוש במשאבים שנוצרו במאמר יצירת משאב FHIR, ומוצגות בהן דרכים למחיקת הגרסאות ההיסטוריות של משאב Observation.
דוגמאות ה-REST הבאות פועלות עם מאגרי R4 FHIR. הדוגמאות של Go, Java, Node.js ו-Python פועלות עם מאגרי STU3 FHIR.
REST
משתמשים בשיטה projects.locations.datasets.fhirStores.fhir.Resource-purge.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר FHIR -
FHIR_STORE_ID: מזהה מאגר ה-FHIR -
RESOURCE_TYPE: סוג משאב FHIR -
RESOURCE_ID: מזהה משאב FHIR
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
curl
מריצים את הפקודה הבאה:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/RESOURCE_TYPE/RESOURCE_ID/$purge"
PowerShell
מריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/RESOURCE_TYPE/RESOURCE_ID/$purge" | Select-Object -Expand Content
אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.