בדף הזה מוסבר איך ליצור, לערוך, להציג, לרשום ולמחוק מאגרי תמונות דיגיטליות ותקשורת ברפואה (DICOM).
מאגרי DICOM מכילים מופעי DICOM. אתם יכולים להוסיף ולנהל מופעי DICOM במאגר DICOM באמצעות הטמעה של DICOMweb ב-Cloud Healthcare API, או לייבא ולייצא מופעי DICOM באמצעות שירותי Google Cloud .
למידע נוסף על התאימות של Cloud Healthcare API לתקן DICOM, אפשר לעיין בהצהרת התאימות ל-DICOM.
יצירת מאגר DICOM
כדי ליצור מאגר DICOM, צריך קודם ליצור מערך נתונים.
בדוגמאות הבאות אפשר לראות איך ליצור מאגר DICOM:
המסוף
כדי ליצור מאגר DICOM:
- נכנסים לדף Datasets במסוף Google Cloud .
- בוחרים את מערך הנתונים שבו רוצים ליצור מאגר DICOM.
- לוחצים על יצירת מאגר נתונים.
- בוחרים באפשרות DICOM כסוג מאגר הנתונים.
- מזינים שם לבחירתכם שיהיה ייחודי במערך הנתונים. אם השם לא ייחודי, יצירת מאגר הנתונים תיכשל.
- לוחצים על הבא.
-
אם רוצים להגדיר נושא Pub/Sub למאגר הנתונים, לוחצים על Receive Cloud Pub/Sub notifications (קבלת התראות Cloud Pub/Sub) ובוחרים את שם הנושא.
כשמציינים נושא ב-Pub/Sub, מזינים את ה-URI המלא של הנושא, כמו שמוצג בדוגמה הבאה:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- לוחצים על הבא.
- כדי להוסיף תווית אחת או יותר לחנות, לוחצים על הוספת תוויות לארגון מאגרי הנתונים ומזינים את התווית של המפתח/הערך. מידע נוסף על תוויות משאבים זמין במאמר שימוש בתוויות משאבים.
- לוחצים על יצירה.
מאגר הנתונים החדש מופיע ברשימה.
gcloud
כדי ליצור מאגר DICOM, מריצים את הפקודה gcloud healthcare dicom-stores create.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר DICOM -
DICOM_STORE_ID: מזהה של מאגר DICOM. מזהה מאגר DICOM צריך לכלול את הפרטים הבאים:- מזהה ייחודי במערך הנתונים
- מחרוזת Unicode באורך 1-256 תווים, שכוללת את הרכיבים הבאים:
- Numbers
- מכתבים
- קו תחתון
- מקפים
- פרקי הזמן
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud healthcare dicom-stores create DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores create DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores create DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
אמורים לקבל תגובה שדומה לזו:
תשובה
Created dicomStore [DICOM_STORE_ID].
REST
כדי ליצור מאגר DICOM, משתמשים ב-method projects.locations.datasets.dicomStores.create.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר DICOM -
DICOM_STORE_ID: מזהה של מאגר DICOM. מזהה מאגר DICOM צריך לכלול את הפרטים הבאים:- מזהה ייחודי במערך הנתונים
- מחרוזת Unicode באורך 1-256 תווים, שכוללת את הרכיבים הבאים:
- Numbers
- מכתבים
- קו תחתון
- מקפים
- פרקי הזמן
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
curl
מריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID"
PowerShell
מריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID" | Select-Object -Expand Content
APIs Explorer
פותחים את דף העזר של ה-method. החלונית של API Explorer תיפתח בצד שמאל של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו:
Go
Java
Node.js
Python
עריכה של מאגר DICOM
בדוגמאות הבאות אפשר לראות איך לבצע את השינויים הבאים בחנות DICOM:
- עורכים את נושא Pub/Sub שאליו Cloud Healthcare API שולח התראות על שינויים במאגר DICOM.
מאגר DICOM תומך בשליחת התראות למספר מנויים. בדוגמה הבאה מוצג אופן ההוספה של נושא Pub/Sub אחד למאגר DICOM. אפשר להוסיף עוד נושאים ל-
dicomStore.notificationConfigsבסגנון דומה. - עורכים את התוויות. תוויות הן צמדי מפתח/ערך שעוזרים לכם לארגן את המשאבים ב- Google Cloud .
projects/PROJECT_ID/topics/PUBSUB_TOPIC
המסוף
כדי לערוך מאגר DICOM, מבצעים את השלבים הבאים:
- נכנסים לדף Datasets במסוף Google Cloud .
- בוחרים את מערך הנתונים שמכיל את מאגר ה-DICOM שרוצים לערוך.
- ברשימה מאגרי נתונים, לוחצים על מאגר הנתונים שרוצים לערוך.
- אם רוצים להגדיר נושא Pub/Sub למאגר הנתונים, בוחרים את שם הנושא מתוך Select a Cloud Pub/Sub Topic (בחירת נושא Cloud Pub/Sub).
- כדי להוסיף תווית אחת או יותר לחנות, לוחצים על תוויות, לוחצים על הוספת תווית ומזינים את התווית של המפתח/הערך. מידע נוסף על תוויות משאבים זמין במאמר שימוש בתוויות משאבים.
- לוחצים על Save.
gcloud
כדי לערוך מאגר DICOM, מריצים את הפקודה gcloud healthcare dicom-stores update.
ה-CLI של gcloud לא תומך בעריכת תוויות.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר DICOM -
DICOM_STORE_ID: מזהה מאגר DICOM -
PUBSUB_TOPIC: נושא Pub/Sub שאליו מתפרסמות הודעות כשמתרחש אירוע במאגר נתונים
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud healthcare dicom-stores update DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Windows (PowerShell)
gcloud healthcare dicom-stores update DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Windows (cmd.exe)
gcloud healthcare dicom-stores update DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
אמורים לקבל תגובה שדומה לזו:
תשובה
Updated dicomStore [DICOM_STORE_ID]. ... name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID notificationConfig: pubsubTopic: projects/PROJECT_ID/topics/PUBSUB_TOPIC
REST
כדי לערוך DICOM store, משתמשים בשיטה projects.locations.datasets.dicomStores.patch.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר DICOM -
DICOM_STORE_ID: מזהה מאגר DICOM -
PUBSUB_TOPIC: נושא Pub/Sub שאליו מתפרסמות הודעות כשמתרחש אירוע במאגר נתונים -
KEY_1: מפתח התווית הראשון -
VALUE_1: הערך הראשון של התווית -
KEY_2: מפתח התווית השני -
VALUE_2: הערך השני של התווית
תוכן בקשת JSON:
{
"notificationConfigs": [
{
"pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC"
}
],
"labels": {
"KEY_1": "VALUE_1",
"KEY_2": "VALUE_2"
}
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
cat > request.json << 'EOF'
{
"notificationConfigs": [
{
"pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC"
}
],
"labels": {
"KEY_1": "VALUE_1",
"KEY_2": "VALUE_2"
}
}
EOFלאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:
curl -X PATCH \
-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/dicomStores/DICOM_STORE_ID?updateMask=notificationConfigs,labels"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json.
כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:
@'
{
"notificationConfigs": [
{
"pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC"
}
],
"labels": {
"KEY_1": "VALUE_1",
"KEY_2": "VALUE_2"
}
}
'@ | 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; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID?updateMask=notificationConfigs,labels" | Select-Object -Expand Content
APIs Explorer
מעתיקים את גוף הבקשה ופותחים את דף העזר של השיטה. החלונית של API Explorer תיפתח בצד שמאל של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. מדביקים את גוף הבקשה בכלי הזה, ממלאים את כל שדות החובה ולוחצים על Execute.
אמורה להתקבל תגובה שדומה לזו:
אם הגדרתם שדות כלשהם במשאב DicomStore, הם יופיעו גם בתשובה.
Go
Java
Node.js
Python
קבלת פרטים על מאגר DICOM
בדוגמאות הבאות אפשר לראות איך מקבלים פרטים על מאגר DICOM.
המסוף
כדי לראות את הפרטים של חנות DICOM:
- נכנסים לדף Datasets במסוף Google Cloud .
- בוחרים את מערך הנתונים שמכיל את מאגר DICOM שרוצים להציג.
- לוחצים על השם של מאגר DICOM.
בכרטיסייה סקירה כללית מוצגים הפרטים של מאגר DICOM שנבחר. בכרטיסייה מדדים מוצגים מדדים של DICOM store, DICOM study ו-DICOM series. מידע נוסף זמין במאמר הצגת מדדים של מאגר DICOM, מחקר DICOM וסדרת DICOM.
gcloud
כדי לקבל פרטים על מאגר DICOM, מריצים את הפקודה gcloud healthcare dicom-stores describe.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר DICOM -
DICOM_STORE_ID: מזהה מאגר DICOM
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud healthcare dicom-stores describe DICOM_STORE_ID \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores describe DICOM_STORE_ID ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores describe DICOM_STORE_ID ^ --project=PROJECT_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
אמורה להתקבל תגובה שדומה לזו:
אם הגדרתם שדות כלשהם במשאב DicomStore, הם יופיעו גם בתשובה.
תשובה
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID
REST
כדי לקבל פרטים על מאגר DICOM, משתמשים בשיטה projects.locations.datasets.dicomStores.get.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר DICOM -
DICOM_STORE_ID: מזהה מאגר DICOM
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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/dicomStores/DICOM_STORE_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/dicomStores/DICOM_STORE_ID" | Select-Object -Expand Content
APIs Explorer
פותחים את דף העזר של ה-method. החלונית של API Explorer תיפתח בצד שמאל של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אמורה להתקבל תגובה שדומה לזו:
אם הגדרתם שדות כלשהם במשאב DicomStore, הם יופיעו גם בתשובה.
Go
Java
Node.js
Python
הצגת רשימה של מאגרי DICOM במערך נתונים
בדוגמאות הבאות אפשר לראות איך מציגים רשימה של מאגרי DICOM במערך נתונים:
המסוף
כדי לראות את מאגרי הנתונים במערך נתונים:
- נכנסים לדף Datasets במסוף Google Cloud .
- בוחרים את מערך הנתונים שמכיל את מאגר הנתונים שרוצים להציג.
gcloud
כדי להציג רשימה של חנויות DICOM במערך נתונים, מריצים את הפקודה gcloud healthcare dicom-stores list.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר DICOM
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud healthcare dicom-stores list \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores list ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores list ^ --project=PROJECT_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
אמורה להתקבל תגובה שדומה לזו:
אם הגדרתם שדות כלשהם במשאב DicomStore, הם יופיעו גם בתשובה.
ID LOCATION TOPIC DICOM_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
כדי להציג רשימה של מאגרי DICOM במערך נתונים, משתמשים בשיטה projects.locations.datasets.dicomStores.list.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר DICOM
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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/dicomStores"
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/dicomStores" | Select-Object -Expand Content
APIs Explorer
פותחים את דף העזר של ה-method. החלונית של API Explorer תיפתח בצד שמאל של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אמורה להתקבל תגובה שדומה לזו:
אם הגדרתם שדות כלשהם במשאב DicomStore, הם יופיעו גם בתשובה.
Go
Java
Node.js
Python
מחיקת מאגר DICOM
בדוגמאות הבאות אפשר לראות איך מוחקים מאגר DICOM:
המסוף
כדי למחוק מאגר נתונים:
- נכנסים לדף Datasets במסוף Google Cloud .
- בוחרים את מערך הנתונים שמכיל את מאגר הנתונים שרוצים למחוק.
- ברשימה הנפתחת פעולות, בוחרים באפשרות מחיקה של מאגר הנתונים שרוצים למחוק.
- כדי לאשר, מקלידים את השם של מאגר הנתונים ולוחצים על מחיקה.
gcloud
כדי למחוק מאגר DICOM, מריצים את הפקודה gcloud healthcare dicom-stores delete.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר DICOM -
DICOM_STORE_ID: מזהה מאגר DICOM
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud healthcare dicom-stores delete DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores delete DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores delete DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deleted dicomStore [DICOM_STORE_ID].
REST
כדי למחוק מאגר DICOM, משתמשים בשיטה projects.locations.datasets.dicomStores.delete.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
LOCATION: המיקום של מערך הנתונים -
DATASET_ID: מערך הנתונים הראשי של מאגר DICOM -
DICOM_STORE_ID: מזהה מאגר DICOM
כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:
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/dicomStores/DICOM_STORE_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/dicomStores/DICOM_STORE_ID" | Select-Object -Expand Content
APIs Explorer
פותחים את דף העזר של ה-method. החלונית של API Explorer תיפתח בצד שמאל של הדף. אפשר להשתמש בכלי הזה כדי לשלוח בקשות. ממלאים את כל שדות החובה ולוחצים על Execute.
אתם אמורים לקבל תגובת JSON שדומה לזו: