بيان توافق DICOM الإصدار 1

إشعار

إصدار واجهة برمجة التطبيقات 2 هو أحدث إصدار من واجهة برمجة التطبيقات ويجب استخدامه بدلا من الإصدار 1. راجع بيان توافق DICOM الإصدار 2 للحصول على التفاصيل.

يدعم خادم التصوير الطبي ل DICOM® مجموعة فرعية من معيار DICOMweb. يتضمن الدعم ما يلي:

• خدمة الدراسات
  • المتجر (STOW-RS)
  • استرداد (WADO-RS)
  • البحث (QIDO-RS)
  • حذف
• خدمة قائمة العمل (UPS Push and Pull SOPs)
  • إنشاء Workitem
  • استرداد Workitem
  • تحديث Workitem
  • تغيير حالة Workitem
  • طلب الإلغاء
  • البحث في Workitems

بالإضافة إلى ذلك، يتم دعم واجهات برمجة التطبيقات غير المتوافقة التالية:

• موجز التغيير
• علامات الاستعلام الموسعة
• تحديث مجمع
• استيراد مجمع
• تصدير

تستخدم الخدمة إصدار واجهة برمجة تطبيقات REST. يجب تحديد إصدار واجهة برمجة تطبيقات REST بشكل صريح كجزء من عنوان URL الأساسي، كما في المثال التالي:

https://<service_url>/v<version>/studies

يتوافق هذا الإصدار من بيان التوافق مع إصدار واجهات v1 برمجة تطبيقات REST.

للحصول على معلومات حول كيفية تحديد الإصدار عند تقديم الطلبات، راجع وثائق إصدار واجهة برمجة التطبيقات.

يمكنك العثور على أمثلة على طلبات المعاملات المدعومة في مجموعة Postman.

تعقيم الديباجة

تتجاهل الخدمة ديباجة ملف 128 بايت، وتستبدل محتوياتها بأحرف فارغة. يضمن هذا السلوك عدم تعرض أي ملفات تم تمريرها عبر الخدمة للثغرة الأمنية الضارة في الديباجة. ومع ذلك، فإن تعقيم الديباجة هذا يعني أيضا أنه لا يمكن استخدام الديباجات المستخدمة لترميز محتوى التنسيق المزدوج مثل TIFF مع الخدمة.

خدمة الدراسات

تسمح خدمة الدراسات للمستخدمين بتخزين DICOM Studies و Series و Instances واستردادها والبحث فيها. أضفنا معاملة حذف غير قياسية لتمكين دورة حياة الموارد الكاملة.

المتجر (STOW-RS)

تستخدم هذه المعاملة أسلوب POST أو PUT لتخزين تمثيلات الدراسات والسلاسل والمثيلات المضمنة في حمولة الطلب.

الأسلوب	المسار	‏‏الوصف
ترحيل	.. /الدراسات	تخزين المثيلات.
POST	.. /studies/{study}	تخزين مثيلات لدراسة معينة.
PUT	.. /الدراسات	مثيلات Upsert.
PUT	.. /studies/{study}	مثيلات Upsert لدراسة محددة.

تتوافق المعلمة study مع سمة StudyInstanceUIDDICOM . إذا تم تحديده، يتم رفض أي مثيل لا ينتمي إلى الدراسة المقدمة 43265 برمز تحذير.

يتم دعم العنوان التالي Accept للاستجابة:

• application/dicom+json

العناوين التالية Content-Type مدعومة:

• multipart/related; type="application/dicom"
• application/dicom

إشعار

لن يفرض الخادم أو يستبدل السمات التي تتعارض مع البيانات الموجودة لطلبات POST. يتم تخزين جميع البيانات كما هو متوفر. بالنسبة لطلبات upsert (PUT)، يتم استبدال البيانات الموجودة بالبيانات الجديدة المستلمة.

تخزين السمات المطلوبة

يجب أن تكون عناصر DICOM التالية موجودة في كل ملف DICOM يحاول تخزينه:

• StudyInstanceUID
• SeriesInstanceUID
• SOPInstanceUID
• SOPClassUID
• PatientID

إشعار

يجب أن يتراوح طول جميع واجهات المستخدم بين 1 و64 حرفا، وأن تحتوي فقط على أحرف رقمية أبجدية أو الأحرف الخاصة التالية: .، . - PatientID يتم التحقق من صحته استنادا LO VR إلى نوعه.

يجب أن يحتوي كل ملف مخزن على مجموعة فريدة من StudyInstanceUIDو SeriesInstanceUIDو.SopInstanceUID يتم إرجاع رمز 45070 التحذير إذا كان هناك ملف بنفس المعرفات موجود بالفعل.

يتم قبول بناء جملة النقل فقط مع تمثيلات القيمة الصريحة.

تخزين رموز حالة الاستجابة

الرمز	‏‏الوصف
200 (OK)	يتم تخزين جميع مثيلات SOP في الطلب.
202 (Accepted)	يتم تخزين بعض المثيلات في الطلب ولكن فشل البعض الآخر.
204 (No Content)	لم يتم توفير أي محتوى في طلب معاملة المتجر.
400 (Bad Request)	تم تنسيق الطلب بشكل سيئ. على سبيل المثال، لم يتوافق معرف مثيل الدراسة المقدم مع تنسيق UID المتوقع.
401 (Unauthorized)	لم تتم مصادقة العميل.
403 (Forbidden)	المستخدم غير مصرح به.
406 (Not Acceptable)	الرأس المحدد Accept غير معتمد.
409 (Conflict)	لم يتم تخزين أي من المثيلات في طلب معاملة المتجر.
415 (Unsupported Media Type)	Content-Type المقدم غير مدعوم.
503 (Service Unavailable)	الخدمة غير متوفرة أو مشغولة. حاول مرة أخرى في وقت لاحق.

حمولة استجابة المتجر

تملأ حمولة الاستجابة مجموعة بيانات DICOM بالعناصر التالية.

العلامة	Name	‏‏الوصف
(0008, 1190)	RetrieveURL	استرداد عنوان URL للدراسة، إذا StudyInstanceUID تم توفيره في طلب المتجر وتم تخزين مثيل واحد على الأقل بنجاح
(0008, 1198)	FailedSOPSequence	تسلسل المثيلات التي فشلت في تخزينها
(0008, 1199)	ReferencedSOPSequence	تسلسل المثيلات المخزنة

تحتوي كل مجموعة بيانات في FailedSOPSequence على العناصر التالية (إذا كان يمكن قراءة ملف DICOM الذي يحاول تخزينه).

العلامة	Name	‏‏الوصف
(0008, 1150)	ReferencedSOPClassUID	المعرف الفريد لفئة SOP للمثيل الذي فشل في تخزينه
(0008, 1155)	ReferencedSOPInstanceUID	المعرف الفريد لمثيل SOP للمثيل الذي فشل في تخزينه
(0008, 1197)	FailureReason	رمز السبب في فشل تخزين هذا المثيل
(0074, 1048)	FailedAttributesSequence	يتضمن تسلسل ErrorComment ذلك سبب كل سمة فاشلة

تحتوي كل مجموعة بيانات في على ReferencedSOPSequence العناصر التالية.

العلامة	Name	‏‏الوصف
(0008, 1150)	ReferencedSOPClassUID	المعرف الفريد لفئة SOP للمثيل الذي فشل في تخزينه
(0008, 1155)	ReferencedSOPInstanceUID	المعرف الفريد لمثيل SOP للمثيل الذي فشل في تخزينه
(0008, 1190)	RetrieveURL	عنوان URL لاسترداد هذا المثيل على خادم DICOM

مثال على الاستجابة مع Accept العنوان application/dicom+json:

{
  "00081190":
  {
    "vr":"UR",
    "Value":["http://localhost/studies/d09e8215-e1e1-4c7a-8496-b4f6641ed232"]
  },
  "00081198":
  {
    "vr":"SQ",
    "Value":
    [{
      "00081150":
      {
        "vr":"UI","Value":["cd70f89a-05bc-4dab-b6b8-1f3d2fcafeec"]
      },
      "00081155":
      {
        "vr":"UI",
        "Value":["22c35d16-11ce-43fa-8f86-90ceed6cf4e7"]
      },
      "00081197":
      {
        "vr":"US",
        "Value":[43265]
      }
    }]
  },
  "00081199":
  {
    "vr":"SQ",
    "Value":
    [{
      "00081150":
      {
        "vr":"UI",
        "Value":["d246deb5-18c8-4336-a591-aeb6f8596664"]
      },
      "00081155":
      {
        "vr":"UI",
        "Value":["4a858cbb-a71f-4c01-b9b5-85f88b031365"]
      },
      "00081190":
      {
        "vr":"UR",
        "Value":["http://localhost/studies/d09e8215-e1e1-4c7a-8496-b4f6641ed232/series/8c4915f5-cc54-4e50-aa1f-9b06f6e58485/instances/4a858cbb-a71f-4c01-b9b5-85f88b031365"]
      }
    }]
  }
}

تخزين رموز أسباب الفشل

الرمز	‏‏الوصف
272	لم تخزن معاملة المتجر المثيل بسبب فشل عام في معالجة العملية.
43264	فشل مثيل DICOM في التحقق من الصحة.
43265	لم يتطابق المثيل StudyInstanceUID المتوفر مع المحدد StudyInstanceUID في طلب المتجر.
45070	مثيل DICOM بنفس StudyInstanceUIDو SeriesInstanceUIDو SopInstanceUID مخزن بالفعل. إذا كنت تريد تحديث المحتويات، فاحذف هذا المثيل أولا.
45071	يتم إنشاء مثيل DICOM بواسطة عملية أخرى، أو فشلت المحاولة السابقة لإنشاء ولم تكتمل عملية التنظيف. احذف المثيل أولا قبل محاولة الإنشاء مرة أخرى.

تخزين رموز سبب التحذير

الرمز	‏‏الوصف
45063	لا تتطابق مجموعة بيانات مثيل DICOM مع فئة SOP. لاحظت معاملة مخزن الدراسات (القسم 10.5) أن مجموعة البيانات لم تتطابق مع قيود فئة SOP أثناء تخزين المثيل.

تخزين رموز الخطأ

الرمز	‏‏الوصف
100	لم تفي سمات المثيل المتوفرة بمعايير التحقق من الصحة.

استرداد (WADO-RS)

تقدم معاملة الاسترداد هذه دعما لاسترداد الدراسات المخزنة والسلسلة والمثيلات والإطارات حسب المرجع.

الأسلوب	المسار	‏‏الوصف
GET	.. /studies/{study}	استرداد جميع المثيلات داخل دراسة
GET	.. /studies/{study}/metadata	استرداد بيانات التعريف لجميع المثيلات داخل دراسة
GET	.. /studies/{study}/series/{series}	استرداد كافة المثيلات ضمن سلسلة
GET	.. /studies/{study}/series/{series}/metadata	استرداد بيانات التعريف لجميع المثيلات داخل سلسلة
GET	.. /studies/{study}/series/{series}/instances/{instance}	استرداد مثيل واحد
GET	.. /studies/{study}/series/{series}/instances/{instance}/metadata	استرداد بيانات التعريف لمثيل واحد
GET	.. /studies/{study}/series/{series}/instances/{instance}/rendered	استرداد مثيل تم تقديمه في تنسيق صورة
GET	.. /studies/{study}/series/{series}/instances/{instance}/frames/{frames}	استرداد إطار واحد أو عدة إطارات من مثيل واحد؛ لتحديد أكثر من إطار واحد، استخدم فاصلة لفصل كل إطار لإرجاعه. على سبيل المثال، /studies/1/series/2/instance/3/frames/4,5,6
GET	.. /studies/{study}/series/{series}/instances/{instance}/frames/{frame}/rendered	استرداد إطار واحد تم عرضه في تنسيق صورة

استرداد المثيلات داخل الدراسة أو السلسلة

يتم دعم العناوين التالية Accept لاسترداد المثيلات ضمن دراسة أو سلسلة.

• multipart/related; type="application/dicom"; transfer-syntax=*
• multipart/related; type="application/dicom"; (عند عدم تحديد بناء جملة النقل، يتم استخدام 1.2.840.10008.1.2.1 كافتراضي)
• multipart/related; type="application/dicom"; transfer-syntax=1.2.840.10008.1.2.1
• multipart/related; type="application/dicom"; transfer-syntax=1.2.840.10008.1.2.4.90

• */* (عندما لا يتم تحديد بناء جملة النقل، * يتم استخدامه كافتراضي ويتم تعيين mediaType افتراضيا إلى application/dicom)

استرداد مثيل

يتم دعم العناوين التالية Accept لاسترداد مثيل معين:

• application/dicom; transfer-syntax=*
• multipart/related; type="application/dicom"; transfer-syntax=*
• application/dicom; (عندما لا يتم تحديد بناء جملة النقل، 1.2.840.10008.1.2.1 يتم استخدامه كافتراضي)
• multipart/related; type="application/dicom" (عندما لا يتم تحديد بناء جملة النقل، 1.2.840.10008.1.2.1 يتم استخدامه كافتراضي)
• application/dicom; transfer-syntax=1.2.840.10008.1.2.1
• multipart/related; type="application/dicom"; transfer-syntax=1.2.840.10008.1.2.1
• application/dicom; transfer-syntax=1.2.840.10008.1.2.4.90
• multipart/related; type="application/dicom"; transfer-syntax=1.2.840.10008.1.2.4.90

• */* (عندما لا يتم تحديد بناء جملة النقل، * يتم استخدامه كافتراضي ويتم تعيين mediaType افتراضيا إلى application/dicom)

استرداد الإطارات

يتم اعتماد العناوين التالية Accept لاسترداد الإطارات.

• multipart/related; type="application/octet-stream"; transfer-syntax=*
• multipart/related; type="application/octet-stream"; (عندما لا يتم تحديد بناء جملة النقل، 1.2.840.10008.1.2.1 يتم استخدامه كافتراضي)
• multipart/related; type="application/octet-stream"; transfer-syntax=1.2.840.10008.1.2.1
• multipart/related; type="image/jp2"; (عندما لا يتم تحديد بناء جملة النقل، 1.2.840.10008.1.2.4.90 يتم استخدامه كافتراضي)
• multipart/related; type="image/jp2";transfer-syntax=1.2.840.10008.1.2.4.90

• */* (عندما لا يتم تحديد بناء جملة النقل، * يتم استخدامه كافتراضي ويتم تعيين mediaType افتراضيا إلى application/octet-stream)

استرداد بناء جملة النقل

عندما يختلف بناء جملة النقل المطلوب عن الملف الأصلي، يتم تحويل الملف الأصلي إلى بناء جملة النقل المطلوب. يجب أن يكون الملف الأصلي أحد التنسيقات التالية لتنجح عملية تحويل الترميز، وإلا فقد يفشل تحويل الترميز.

• 1.2.840.10008.1.2 (الضمني ل Little Endian)
• 1.2.840.10008.1.2.1 (Little Endian صريح)
• 1.2.840.10008.1.2.2 (صريح VR Big Endian)
• 1.2.840.10008.1.2.4.50 (العملية الأساسية ل JPEG 1)
• 1.2.840.10008.1.2.4.57 (JPEG Lossless)
• 1.2.840.10008.1.2.4.70 (قيمة التحديد بدون فقدان JPEG 1)
• 1.2.840.10008.1.2.4.90 (JPEG 2000 Lossless Only)
• 1.2.840.10008.1.2.4.91 (JPEG 2000)
• 1.2.840.10008.1.2.5 (RLE Lossless)

ينتج عن غير معتمدة transfer-syntax في 406 Not Acceptable.

استرداد بيانات التعريف (للدراسة أو السلسلة أو المثيل)

يتم دعم العنوان التالي Accept لاسترداد بيانات التعريف لدراسة أو سلسلة أو مثيل.

• application/dicom+json

لا يرجع استرداد بيانات التعريف السمات بتمثيلات القيمة التالية.

اسم الواقع الافتراضي	‏‏الوصف
OB	بايت آخر
OD	مزدوج آخر
من	عائمة أخرى
را	طويل آخر
OV	أخرى 64 بت طويلة جدا
اه	Word آخر
الدولي	‏‏غير معروف

استرداد التحقق من صحة ذاكرة التخزين المؤقت لبيانات التعريف (للدراسة أو السلسلة أو المثيل)

يتم دعم التحقق من صحة ذاكرة التخزين المؤقت باستخدام الآلية ETag . في الاستجابة لطلب بيانات التعريف، يتم إرجاع ETag كأحد العناوين. يمكن تخزين ETag هذا مؤقتا وإضافته كعنوان If-None-Match في الطلبات اللاحقة لنفس بيانات التعريف. يمكن وجود نوعين من الاستجابات إذا كانت البيانات موجودة:

• لم تتغير البيانات منذ الطلب الأخير: يتم إرسال الاستجابة HTTP 304 (Not Modified) بدون نص استجابة.
• تغيرت البيانات منذ الطلب الأخير: يتم إرسال الاستجابة HTTP 200 (OK) باستخدام ETag المحدث. يتم إرجاع البيانات المطلوبة أيضا كجزء من النص الأساسي.

استرداد الصورة المعروضة (على سبيل المثال أو الإطار)

يتم دعم العناوين التالية Accept لاسترداد صورة معروضة مثيل أو إطار.

• image/jpeg
• image/png

في حالة عدم Accept تحديد عنوان، تعرض image/jpeg الخدمة بشكل افتراضي.

تدعم الخدمة عرض إطار واحد فقط. إذا تم طلب العرض لمثيل ذي إطارات متعددة، عرض الإطار الأول كصورة بشكل افتراضي.

عند تحديد إطار معين لإرجاعه، تبدأ فهرسة الإطار في 1.

معلمة quality الاستعلام مدعومة أيضا. قد يتم تمرير قيمة عدد صحيح من 1 إلى 100 شاملة (1 هي أسوأ جودة، و100 هي أفضل جودة) كقيمة لمعلمة الاستعلام. يتم استخدام هذه المعلمة للصور المعروضة ك jpeg، ويتم تجاهلها لطلبات png العرض. إذا لم يتم تحديدها، يتم تعيين المعلمة افتراضيا إلى 100.

استرداد رموز حالة الاستجابة

الرمز	‏‏الوصف
200 (OK)	تم استرداد جميع البيانات المطلوبة.
304 (Not Modified)	لم يتم تعديل البيانات المطلوبة منذ الطلب الأخير. في هذه الحالة، لا تتم إضافة المحتوى إلى نص الاستجابة. لمزيد من المعلومات، راجع القسم السابق استرداد التحقق من صحة ذاكرة التخزين المؤقت لبيانات التعريف (للدراسة أو السلسلة أو المثيل).
400 (Bad Request)	تم تنسيق الطلب بشكل سيئ. على سبيل المثال، لم يتوافق معرف مثيل الدراسة المقدم مع تنسيق UID المتوقع، أو ترميز بناء جملة النقل المطلوب غير مدعوم.
401 (Unauthorized)	لم تتم مصادقة العميل.
403 (Forbidden)	المستخدم غير مصرح به.
404 (Not Found)	تعذر العثور على مورد DICOM المحدد، أو لطلب معروض لم يحتوي المثيل على بيانات بكسل.
406 (Not Acceptable)	العنوان المحدد Accept غير مدعوم، أو لطلبات العرض وفك التشفير التي كان الملف المطلوب كبيرا جدا.
503 (Service Unavailable)	الخدمة غير متوفرة أو مشغولة. حاول مرة أخرى في وقت لاحق.

البحث (QIDO-RS)

يمكنك الاستعلام المستند إلى معرف عناصر DICOM (QIDO) من البحث عن الدراسات والسلاسل والمثيلات حسب السمات.

الأسلوب	المسار	‏‏الوصف
البحث عن الدراسات
GET	.. /الدراسات؟...	البحث عن دراسات
البحث عن سلسلة
GET	.. /سلسلة؟...	البحث عن سلسلة
GET	.. /studies/{study}/series?...	البحث عن سلسلة في دراسة
البحث عن مثيلات
GET	.. /الحالات؟...	البحث عن مثيلات
GET	.. /studies/{study}/instances?...	البحث عن مثيلات في دراسة
GET	.. /studies/{study}/series/{series}/instances?...	البحث عن مثيلات في سلسلة

يتم اعتماد العنوان التالي Accept للبحث:

• application/dicom+json

معلمات البحث المدعومة

المعلمات التالية لكل استعلام مدعومة.

مفتاح	قيم الدعم	العدد المسموح به	‏‏الوصف
{attributeID}=	{value}	0...N	البحث عن سمة/ قيمة مطابقة في الاستعلام
includefield=	{attributeID} all	0...N	السمات الأخرى التي يجب إرجاعها في الاستجابة؛ يتم دعم كل من العلامات العامة والخاصة. متى all يتم توفيرها. راجع استجابة البحث للحصول على مزيد من المعلومات حول السمات التي يتم إرجاعها لكل نوع استعلام. إذا تم توفير مزيج من {attributeID} و all ، فإن الخادم افتراضيا لاستخدام all.
limit=	{value}	0..1	قيمة عدد صحيح للحد من عدد القيم التي تم إرجاعها في الاستجابة؛ يمكن أن تكون القيمة بين النطاق 1 >= x <= 200، افتراضيا إلى 100.
offset=	{value}	0..1	تخطي {value} النتائج؛ إذا تم توفير إزاحة أكبر من عدد نتائج استعلام البحث، 204 (no content) يتم إرجاع استجابة.
fuzzymatching=	true / false	0..1	إذا تم تطبيق المطابقة الغامضة الحقيقية على سمة PatientName؛ تقوم بمطابقة كلمة بادئة لأي جزء اسم داخل قيمة PatientName. على سبيل المثال، إذا كان PatientName هو "John^Doe"، فإن "joh" و"do" و"jo do" و"Doe" و"John Doe" كلها متطابقة. ومع ذلك، "ohn" لا يتطابق.

سمات قابلة للبحث

ندعم البحث في السمات وأنواع البحث التالية.

الكلمة الأساسية للسمة	جميع الدراسات	كافة السلاسل	كافة المثيلات	سلسلة الدراسة	مثيلات الدراسة	مثيلات سلسلة الدراسة
StudyInstanceUID	X	X	X
PatientName	X	X	X
PatientID	X	X	X
PatientBirthDate	X	X	X
AccessionNumber	X	X	X
ReferringPhysicianName	X	X	X
StudyDate	X	X	X
StudyDescription	X	X	X
ModalitiesInStudy	X	X	X
SeriesInstanceUID		X	X	X	X
Modality		X	X	X	X
PerformedProcedureStepStartDate		X	X	X	X
ManufacturerModelName		X	X	X	X
SOPInstanceUID			X		X	X

مطابقة البحث

نحن ندعم الأنواع المطابقة التالية.

نوع البحث	السمة المدعومة	مثال
استعلام النطاق	StudyDate/PatientBirthDate	{attributeID}={value1}-{value2}. بالنسبة لقيم التاريخ/الوقت، ندعم نطاقا شاملا على العلامة، والذي تم تعيينه إلى attributeID >= {value1} AND attributeID <= {value2}. إذا {value1} لم يتم تحديده، يتم مطابقة جميع تكرارات التواريخ/الأوقات السابقة لها وتضمينها {value2} . وبالمثل، إذا {value2} لم يتم تحديد، يتم مطابقة جميع تكرارات {value1} التواريخ/الأوقات اللاحقة. ومع ذلك، يجب أن تكون إحدى هذه القيم موجودة. {attributeID}={value1}-ومع ذلك، {attributeID}=- فإن و {attributeID}=-{value2} صالحين غير صالحين.
تطابق تام	كافة السمات المدعومة	{attributeID}={value1}
مطابقة غامضة	PatientName, ReferringPhysicianName	يطابق أي مكون من الاسم الذي يبدأ بالقيمة.

معرف السمة

يمكن ترميز العلامات بعدة طرق لمعلمة الاستعلام. لقد طبقنا جزئيا المعيار كما هو محدد في PS3.18 6.7.1.1.1. يتم دعم الترميزات التالية لعلامة.

القيمة‬	مثال
{group}{element}	0020000D
{dicomKeyword}	StudyInstanceUID

فيما يلي مثال استعلام يبحث عن مثيلات:

../instances?Modality=CT&00280011=512&includefield=00280010&limit=5&offset=0

استجابة البحث

الاستجابة هي صفيف من مجموعات بيانات DICOM. اعتمادا على المورد، يتم إرجاع السمات التالية بشكل افتراضي.

علامات الدراسة الافتراضية

العلامة	اسم السمة
(0008, 0005)	SpecificCharacterSet
(0008, 0020)	StudyDate
(0008, 0030)	StudyTime
(0008, 0050)	AccessionNumber
(0008, 0056)	InstanceAvailability
(0008, 0090)	ReferringPhysicianName
(0008, 0201)	TimezoneOffsetFromUTC
(0010, 0010)	PatientName
(0010, 0020)	PatientID
(0010, 0030)	PatientBirthDate
(0010, 0040)	PatientSex
(0020, 0010)	StudyID
(0020, 000D)	StudyInstanceUID

علامات السلسلة الافتراضية

العلامة	اسم السمة
(0008, 0005)	SpecificCharacterSet
(0008, 0060)	Modality
(0008, 0201)	TimezoneOffsetFromUTC
(0008، 103E)	SeriesDescription
(0020، 000E)	SeriesInstanceUID
(0040, 0244)	PerformedProcedureStepStartDate
(0040, 0245)	PerformedProcedureStepStartTime
(0040, 0275)	RequestAttributesSequence

علامات المثيل الافتراضي

العلامة	اسم السمة
(0008, 0005)	SpecificCharacterSet
(0008, 0016)	SOPClassUID
(0008, 0018)	SOPInstanceUID
(0008, 0056)	InstanceAvailability
(0008, 0201)	TimezoneOffsetFromUTC
(0020, 0013)	InstanceNumber
(0028, 0010)	Rows
(0028, 0011)	Columns
(0028, 0100)	BitsAllocated
(0028, 0008)	NumberOfFrames

إذا includefield=all، يتم تضمين السمات التالية مع السمات الافتراضية. جنبا إلى جنب مع السمات الافتراضية، هذه هي القائمة الكاملة للسمات المدعومة على كل مستوى من مستويات الموارد.

علامات الدراسة الإضافية

العلامة	اسم السمة
(0008, 1030)	Study Description
(0008, 0063)	AnatomicRegionsInStudyCodeSequence
(0008, 1032)	ProcedureCodeSequence
(0008, 1060)	NameOfPhysiciansReadingStudy
(0008, 1080)	AdmittingDiagnosesDescription
(0008, 1110)	ReferencedStudySequence
(0010, 1010)	PatientAge
(0010, 1020)	PatientSize
(0010, 1030)	PatientWeight
(0010, 2180)	Occupation
(0010، 21B0)	AdditionalPatientHistory

علامات السلسلة الأخرى

العلامة	اسم السمة
(0020, 0011)	SeriesNumber
(0020, 0060)	Laterality
(0008, 0021)	SeriesDate
(0008, 0031)	SeriesTime

يتم إرجاع السمات التالية:

• جميع معلمات استعلام المطابقة وواجهة المستخدم في عنوان URL للمورد.
• IncludeField السمات المدعومة على مستوى المورد هذا.
• إذا كان المورد الهدف هو All Series، Study أيضا إرجاع سمات المستوى.
• إذا كان المورد الهدف هو All Instances، Study أيضا إرجاع سمات المستوى.Series
• إذا كان المورد الهدف هو Study's Instances، Series أيضا إرجاع سمات المستوى.
• NumberOfStudyRelatedInstances السمة المجمعة مدعومة في Study المستوى includeField.
• NumberOfSeriesRelatedInstances السمة المجمعة مدعومة في Series المستوى includeField.

رموز استجابة البحث

ترجع واجهة برمجة تطبيقات الاستعلام أحد رموز الحالة التالية في الاستجابة.

الرمز	‏‏الوصف
200 (OK)	تحتوي حمولة الاستجابة على جميع الموارد المطابقة.
204 (No Content)	اكتمل البحث بنجاح ولكنه لم يرجع أي نتائج.
400 (Bad Request)	تعذر على الخادم تنفيذ الاستعلام لأن مكون الاستعلام غير صالح. يحتوي نص الاستجابة على تفاصيل الفشل.
401 (Unauthorized)	لم تتم مصادقة العميل.
403 (Forbidden)	المستخدم غير مصرح به.
503 (Service Unavailable)	الخدمة غير متوفرة أو مشغولة. حاول مرة أخرى في وقت لاحق.

الإشعارات الأخرى

• الاستعلام باستخدام TimezoneOffsetFromUTC (00080201) غير مدعوم.
• لا ترجع 413 (request entity too large)واجهة برمجة تطبيقات الاستعلام . إذا كان حد استجابة الاستعلام المطلوب خارج النطاق المقبول، يتم إرجاع طلب غير صحيح. يتم حل أي شيء مطلوب ضمن النطاق المقبول.
• عندما يكون المورد المستهدف هو Study/Series، هناك احتمال لبيانات تعريف غير متسقة على مستوى الدراسة/السلسلة عبر مثيلات متعددة. على سبيل المثال، يمكن أن يكون لمثيلين اسم مريض مختلف. في هذه الحالة، يفوز الأحدث، ويمكنك البحث فقط عن أحدث البيانات.
• تم تحسين النتائج المصفحة لإرجاع المثيل الأحدث المطابق أولا، وقد يؤدي ذلك إلى تكرار السجلات في الصفحات اللاحقة إذا تمت إضافة بيانات أحدث مطابقة للاستعلام.
• المطابقة ليست حساسة لحالة الأحرف، وليست حساسة للهجة بالنسبة إلى أنواع PN VR.
• المطابقة ليست حساسة لحالة الأحرف، وهي حساسة للتسليط بالنسبة إلى أنواع الواقع الافتراضي للسلسلة الأخرى.
• تتم فهرسة القيمة الأولى فقط إذا كان عنصر بيانات واحد ذي قيمة بشكل غير صحيح يحتوي على قيم متعددة.

حذف

هذه المعاملة ليست جزءا من معيار DICOMwe الرسمي. يستخدم أسلوب DELETE لإزالة تمثيلات الدراسات والسلاسل والمثيلات من المتجر.

الأسلوب	المسار	‏‏الوصف
حذف	.. /studies/{study}	حذف جميع مثيلات دراسة معينة
حذف	.. /studies/{study}/series/{series}	حذف جميع المثيلات لسلسلة معينة ضمن دراسة
حذف	.. /studies/{study}/series/{series}/instances/{instance}	حذف مثيل معين ضمن سلسلة

تتوافق المعلمات studyseriesو و مع instance سمات StudyInstanceUIDDICOM و SeriesInstanceUIDو على SopInstanceUID التوالي.

لا توجد قيود على عنوان الطلب Accept أو Content-Type عنوانه أو محتوى نصه.

إشعار

بعد عملية حذف، لن تكون المثيلات المحذوفة قابلة للاسترداد.

رموز حالة الاستجابة

الرمز	‏‏الوصف
204 (No Content)	عند حذف جميع مثيلات SOP
400 (Bad Request)	تم تنسيق الطلب بشكل سيئ
401 (Unauthorized)	لم تتم مصادقة العميل
403 (Forbidden)	المستخدم غير مصرح به
404 (Not Found)	عندما لم يتم العثور على السلسلة المحددة داخل دراسة، أو لم يتم العثور على المثيل المحدد داخل السلسلة
503 (Service Unavailable)	الخدمة غير متوفرة أو مشغولة. حاول مرة أخرى في وقت لاحق.

حذف حمولة الاستجابة

نص الاستجابة فارغ. رمز الحالة هو المعلومات المفيدة الوحيدة التي تم إرجاعها.

خدمة قائمة العمل (UPS-RS)

تدعم خدمة DICOM برامج SOPs للدفع والسحب لخدمة قائمة العمل (UPS-RS). توفر خدمة قائمة العمل الوصول إلى قائمة عمل واحدة تحتوي على Workitems، يمثل كل منها خطوة إجراء موحد (UPS).

طوال الوقت، {workitem} المتغير في قالب URI يرمز إلى Workitem UID.

تتضمن نقاط نهاية UPS-RS المتوفرة ما يلي:

الفعل	المسار	‏‏الوصف
ترحيل	{s}/workitems{؟ AffectedSOPInstanceUID}	إنشاء عنصر عمل
POST	{s}/workitems/{instance}{?transaction}	تحديث عنصر عمل
GET	{s}/workitems{?query*}	البحث عن عناصر العمل
GET	{s}/workitems/{instance}	استرداد عنصر عمل
PUT	{s}/workitems/{instance}/state	تغيير حالة عنصر العمل
POST	{s}/workitems/{instance}/cancelrequest	إلغاء عنصر العمل
POST	{s}/workitems/{instance}/subscribers/{AETitle}{?deletionlock}	إنشاء اشتراك
POST	{s}/workitems/1.2.840.10008.5.1.4.34.5/	تعليق الاشتراك
حذف	{s}/workitems/{instance}/subscribers/{AETitle}	حذف الاشتراك
GET	{s}/المشتركون/{AETitle}	فتح قناة الاشتراك

إنشاء Workitem

تستخدم هذه المعاملة أسلوب POST لإنشاء Workitem جديد.

الأسلوب	المسار	‏‏الوصف
ترحيل	.. /عناصر العمل	إنشاء Workitem
POST	.. /workitems؟ {workitem}	إنشاء Workitem باستخدام UID المحدد.

إذا لم يتم تحديدها في URI، يجب أن تحتوي مجموعة بيانات الحمولة على Workitem في السمة SOPInstanceUID .

Accept العناوين و Content-Type مطلوبة في الطلب، ويجب أن يكون لكل منهما القيمة application/dicom+json.

هناك العديد من المتطلبات المتعلقة بسمات بيانات DICOM في سياق معاملة معينة. قد تكون السمات مطلوبة لتكون موجودة، أو مطلوبة لعدم الحضور، أو مطلوبة لتكون فارغة، أو مطلوبة لتكون فارغة. يمكن العثور على هذه المتطلبات في هذا الجدول.

إشعار

على الرغم من أن الجدول المرجعي يشير إلى أنه لا يجب أن يكون معرف UID لمثيل SOP موجودا، فإن هذا التوجيه خاص ببروتوكول DIMSE ويتم التعامل معه بشكل مختلف في DICOMWeb. يجب أن يكون معرف المستخدم لمثيل SOP موجودا في مجموعة البيانات إذا لم يكن في URI.

إشعار

يتم التعامل مع جميع رموز المتطلبات الشرطية بما في ذلك 1C و2C على أنها اختيارية.

إنشاء رموز حالة الاستجابة

الرمز	‏‏الوصف
201 (Created)	تم إنشاء Workitem الهدف بنجاح.
400 (Bad Request)	حدثت مشكلة في الطلب. على سبيل المثال، لم تفي حمولة الطلب بالمتطلبات.
401 (Unauthorized)	لم تتم مصادقة العميل.
403 (Forbidden)	المستخدم غير مصرح به.
409 (Conflict)	Workitem موجود بالفعل.
415 (Unsupported Media Type)	Content-Type المقدم غير مدعوم.
503 (Service Unavailable)	الخدمة غير متوفرة أو مشغولة. حاول مرة أخرى في وقت لاحق.

إنشاء حمولة الاستجابة

لا تحتوي الاستجابة الناجحة على حمولة. Location تحتوي رؤوس الاستجابة و Content-Location على مرجع URI إلى Workitem الذي تم إنشاؤه.

تحتوي حمولة استجابة الفشل على رسالة تصف الفشل.

طلب الإلغاء

تمكن هذه المعاملة المستخدم من طلب إلغاء Workitem غير مالك.

هناك أربع حالات Workitem صالحة.

• SCHEDULED
• IN PROGRESS
• CANCELED
• COMPLETED

تنجح هذه المعاملة فقط مقابل Workitems في SCHEDULED الحالة . يمكن لأي مستخدم المطالبة بملكية Workitem عن طريق تعيين معرف المستخدم للمعاملات الخاص به وتغيير حالته إلى IN PROGRESS. من ذلك الحين فصاعدا، يمكن للمستخدم تعديل Workitem فقط عن طريق توفير معرف المستخدم الصحيح للمعاملة. بينما يعرف UPS فئات Watch and Event SOP التي تسمح بإعادة توجيه طلبات الإلغاء والأحداث الأخرى، لا تقوم خدمة DICOM هذه بتنفيذ هذه الفئات، وبالتالي فإن طلبات الإلغاء على مواقع العمل التي يتم IN PROGRESS إرجاعها فشل. يمكن إلغاء Workitem المملوك عبر معاملة تغيير حالة Workitem.

الأسلوب	المسار	‏‏الوصف
ترحيل	.. /workitems/{workitem}/cancelrequest	طلب إلغاء Workitem مجدول

Content-Type الرأس مطلوب، ويجب أن يكون له القيمة application/dicom+json.

قد تتضمن حمولة الطلب معلومات الإجراء كما هو محدد في معيار DICOM.

طلب رموز حالة استجابة الإلغاء

الرمز	‏‏الوصف
202 (Accepted)	تم قبول الطلب من قبل الخادم، ولكن حالة Target Workitem لم تتغير.
400 (Bad Request)	حدثت مشكلة في بناء جملة الطلب.
401 (Unauthorized)	لم تتم مصادقة العميل.
403 (Forbidden)	المستخدم غير مصرح به.
404 (Not Found)	لم يتم العثور على Target Workitem.
409 (Conflict)	الطلب غير متناسق مع الحالة الحالية ل Target Workitem. على سبيل المثال، يكون Target Workitem في SCHEDULED الحالة أو COMPLETED .
415 (Unsupported Media Type)	Content-Type المقدم غير مدعوم.

طلب حمولة استجابة الإلغاء

لا تحتوي استجابة النجاح على حمولة، وتحتوي حمولة استجابة الفشل على رسالة تصف الفشل. إذا كان مثيل Workitem في حالة إلغاء بالفعل، تتضمن الاستجابة عنوان تحذير HTTP التالي: 299: The UPS is already in the requested state of CANCELED.

استرداد Workitem

تسترد هذه المعاملة Workitem. وهو يتوافق مع عملية UPS DIMSE N-GET.

راجع: https://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_11.5

إذا كان Workitem موجودا على خادم الأصل، يتم إرجاع Workitem في نوع وسائط مقبولة. لن يحتوي Workitem الذي تم إرجاعه على السمة Transaction UID (0008,1195). هذا ضروري للحفاظ على دور السمة كقفل وصول.

الأسلوب	المسار	‏‏الوصف
GET	.. /workitems/{workitem}	طلب استرداد Workitem

Accept الرأس مطلوب ويجب أن يكون له القيمة application/dicom+json.

استرداد رموز حالة استجابة Workitem

الرمز	‏‏الوصف
200 (حسنًا)	تم استرداد مثيل Workitem بنجاح.
400 (طلب غير صحيح)	حدثت مشكلة في الطلب.
401 (غير مصرح به)	لم تتم مصادقة العميل.
403 (محظور)	المستخدم غير مصرح به.
404 (غير موجود)	لم يتم العثور على Target Workitem.

استرداد حمولة استجابة Workitem

• تحتوي استجابة النجاح على حمولة جزء واحد تحتوي على Workitem المطلوب في نوع الوسائط المحدد.
• لن يحتوي Workitem الذي تم إرجاعه على السمة Transaction UID (0008, 1195) ل Workitem، حيث يجب أن يكون ذلك معروفا فقط للمالك.

تحديث Workitem

تعدل هذه المعاملة سمات Workitem موجود. وهو يتوافق مع عملية UPS DIMSE N-SET.

راجع: https://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_11.6

لتحديث Workitem حاليا في SCHEDULED الحالة، يجب ألا تكون السمة Transaction UID موجودة. بالنسبة إلى Workitem في IN PROGRESS الحالة، يجب أن يتضمن الطلب معرف المستخدم الحالي للمعاملة كمعلمة استعلام. إذا كان Workitem موجودا بالفعل في COMPLETED الحالات أو CANCELED ، فإن الاستجابة هي 400 (Bad Request).

الأسلوب	المسار	‏‏الوصف
ترحيل	.. /workitems/{workitem}؟ {transaction-uid}	تحديث معاملة Workitem

Content-Type الرأس مطلوب، ويجب أن يكون له القيمة application/dicom+json.

تحتوي حمولة الطلب على مجموعة بيانات مع التغييرات التي سيتم تطبيقها على Workitem الهدف. عند تعديل تسلسل، يجب أن يتضمن الطلب كافة العناصر في التسلسل، وليس فقط العناصر التي سيتم تعديلها. عندما تحتاج سمات متعددة إلى التحديث كمجموعة، قم بتحديث كسمات متعددة في طلب واحد، وليس كطلبات متعددة.

هناك العديد من المتطلبات المتعلقة بسمات بيانات DICOM في سياق معاملة معينة. قد تكون السمات مطلوبة لتكون موجودة، أو مطلوبة لعدم الحضور، أو مطلوبة لتكون فارغة، أو مطلوبة لتكون فارغة. يمكن العثور على هذه المتطلبات في هذا الجدول.

إشعار

يتم التعامل مع جميع رموز المتطلبات الشرطية بما في ذلك 1C و2C على أنها اختيارية.

إشعار

لا يمكن للطلب تعيين قيمة السمة Procedure Step State (0074,1000). تتم إدارة حالة خطوة الإجراء باستخدام معاملة تغيير الحالة أو معاملة إلغاء الطلب.

تحديث رموز حالة استجابة معاملة Workitem

الرمز	‏‏الوصف
200 (OK)	تم تحديث Target Workitem.
400 (Bad Request)	حدثت مشكلة في الطلب. على سبيل المثال: (1) كان Target Workitem في COMPLETED الحالة أو CANCELED . (2) معرف UID الخاص بالمعاملة مفقود. (3) معرف UID للمعاملة غير صحيح. (4) لم تتوافق مجموعة البيانات مع المتطلبات.
401 (Unauthorized)	لم تتم مصادقة العميل.
403 (Forbidden)	المستخدم غير مصرح به.
404 (Not Found)	لم يتم العثور على Target Workitem.
409 (Conflict)	الطلب غير متناسق مع الحالة الحالية ل Target Workitem.
415 (Unsupported Media Type)	Content-Type المقدم غير مدعوم.

تحديث البيانات الأساسية للاستجابة لمعاملات Workitem

يدعم خادم الأصل حقول الرأس كما هو مطلوب في الجدول 11.6.3-2.

لا تحتوي استجابة النجاح على حمولة أو حمولة تحتوي على مستند تقرير الحالة.

قد تحتوي حمولة استجابة الفشل على تقرير حالة يصف أي حالات فشل أو تحذيرات أو معلومات مفيدة أخرى.

تغيير حالة Workitem

يتم استخدام هذه المعاملة لتغيير حالة Workitem. وهو يتوافق مع عملية UPS DIMSE N-ACTION "تغيير حالة UPS". يتم استخدام تغييرات الحالة للمطالبة بالملكية أو إكمال أو إلغاء Workitem.

راجع: https://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_11.7

إذا كان Workitem موجودا على خادم الأصل، يتم إرجاع Workitem في نوع وسائط مقبولة. لن يحتوي Workitem الذي تم إرجاعه على السمة Transaction UID (0008,1195). هذا ضروري للحفاظ على دور هذه السمة كقفل وصول كما هو موضح هنا.

الأسلوب	المسار	‏‏الوصف
PUT	.. /workitems/{workitem}/state	تغيير حالة Workitem

Accept الرأس مطلوب، ويجب أن يكون له القيمة application/dicom+json.

تحتوي حمولة الطلب على Change UPS State Data Elements. عناصر البيانات هذه هي:

• معرف UID للمعاملة (0008، 1195). تتضمن حمولة الطلب معرف UID للمعاملة. يقوم عامل المستخدم بإنشاء معرف المستخدم للمعاملات عند طلب الانتقال إلى IN PROGRESS الحالة ل Workitem معين. يوفر عامل المستخدم معرف المستخدم (UID) للمعاملة في المعاملات اللاحقة مع Workitem هذا.
• حالة خطوة الإجراء (0074، 1000). تتوافق القيم القانونية مع انتقال الحالة المطلوب. وهي: IN PROGRESSأو COMPLETEDأو .CANCELED

تغيير رموز حالة استجابة حالة Workitem

الرمز	‏‏الوصف
200 (OK)	تم استرداد مثيل Workitem بنجاح.
400 (Bad Request)	لا يمكن تنفيذ الطلب لأحد الأسباب التالية. (1) الطلب غير صالح نظرا للحالة الحالية ل Target Workitem. (2) معرف UID الخاص بالمعاملة مفقود. (3) معرف UID للمعاملة غير صحيح
401 (Unauthorized)	لم تتم مصادقة العميل.
403 (Forbidden)	المستخدم غير مصرح به.
404 (Not Found)	لم يتم العثور على Target Workitem.
409 (Conflict)	الطلب غير متناسق مع الحالة الحالية ل Target Workitem.

تغيير حمولة استجابة حالة Workitem

• تتضمن الاستجابات حقول الرأس المحددة في القسم 11.7.3.2.
• لا تحتوي الاستجابة الناجحة على حمولة.
• قد تحتوي حمولة استجابة الفشل على تقرير حالة يصف أي حالات فشل أو تحذيرات أو معلومات مفيدة أخرى.

البحث في Workitems

تمكنك هذه المعاملة من البحث عن Workitems حسب السمات.

الأسلوب	المسار	‏‏الوصف
GET	.. /workitems؟	البحث عن Workitems

يتم اعتماد العنوان التالي Accept للبحث.

• application/dicom+json

معلمات البحث المدعومة

المعلمات التالية لكل استعلام مدعومة.

مفتاح	قيم الدعم	العدد المسموح به	‏‏الوصف
{attributeID}=	{value}	0...N	البحث عن سمة/ قيمة مطابقة في الاستعلام
includefield=	{attributeID} all	0...N	السمات الأخرى التي يجب إرجاعها في الاستجابة؛ يمكن تضمين سمات المستوى الأعلى فقط - وليس السمات التي تعد جزءا من التسلسلات. يتم دعم كل من العلامات العامة والخاصة. عند all توفيرها، راجع استجابة البحث للحصول على مزيد من المعلومات حول السمات التي يتم إرجاعها لكل نوع استعلام. إذا تم توفير مزيج من {attributeID} و all ، تعيين الخادم افتراضيا على استخدام "الكل".
limit=	{value}	0...1	قيمة عدد صحيح للحد من عدد القيم التي تم إرجاعها في الاستجابة؛ يمكن أن تكون القيمة بين النطاق 1 >= x <= 200، ويتم تعيينها افتراضيا إلى 100.
offset=	{value}	0...1	تخطي {value} من النتائج؛ إذا تم توفير إزاحة أكبر من عدد نتائج استعلام البحث، 204 (no content) يتم إرجاع استجابة.
fuzzymatching=	true | false	0...1	إذا تم تطبيق المطابقة الغامضة الحقيقية على أي سمات مع تمثيل قيمة اسم الشخص (PN) (VR)؛ يتم تنفيذ تطابق كلمة بادئة لأي جزء اسم داخل هذه السمات. على سبيل المثال، إذا كان PatientName هو ، ثم joh، do، jo doDoe ، وجميع التطابقات John Doe John^Doe. ومع ذلك ohn لا يتطابق.

سمات قابلة للبحث

نحن ندعم البحث في هذه السمات.

الكلمة الأساسية للسمة
PatientName
PatientID
ReferencedRequestSequence.AccessionNumber
ReferencedRequestSequence.RequestedProcedureID
ScheduledProcedureStepStartDateTime
ScheduledStationNameCodeSequence.CodeValue
ScheduledStationClassCodeSequence.CodeValue
ScheduledStationGeographicLocationCodeSequence.CodeValue
ProcedureStepState
StudyInstanceUID

مطابقة البحث

نحن ندعم هذه الأنواع المتطابقة.

نوع البحث	السمة المدعومة	مثال
استعلام النطاق	Scheduled​Procedure​Step​Start​Date​Time	{attributeID}={value1}-{value2}. بالنسبة لقيم التاريخ/الوقت، ندعم نطاقا شاملا على العلامة. تم تعيين هذا إلى attributeID >= {value1} AND attributeID <= {value2}. إذا {value1} لم يتم تحديده، يتم مطابقة جميع تكرارات التواريخ/الأوقات السابقة لها وتضمينها {value2} . وبالمثل، إذا {value2} لم يتم تحديد، يتم مطابقة جميع تكرارات {value1} التواريخ/الأوقات اللاحقة. ومع ذلك، يجب أن تكون إحدى هذه القيم موجودة. {attributeID}={value1}-ومع ذلك، {attributeID}=- فإن و {attributeID}=-{value2} صالحين غير صالحين.
تطابق تام	كافة السمات المدعومة	{attributeID}={value1}
مطابقة غامضة	PatientName	يطابق أي مكون من الاسم الذي يبدأ بالقيمة

إشعار

على الرغم من أننا لا ندعم مطابقة التسلسل الكامل، فإننا ندعم المطابقة الدقيقة للسمات المدرجة في تسلسل.

معرف السمة

يمكن ترميز العلامات بعدة طرق لمعلمة الاستعلام. طبقنا جزئيا المعيار كما هو محدد في PS3.18 6.7.1.1.1. يتم دعم الترميزات التالية لعلامة.

القيمة‬	مثال
{group}{element}	00100010
{dicomKeyword}	PatientName

مثال الاستعلام:

../workitems?PatientID=K123&0040A370.00080050=1423JS&includefield=00404005&limit=5&offset=0

استجابة البحث

الاستجابة هي صفيف من 0...N مجموعات بيانات DICOM مع السمات التالية التي تم إرجاعها:

• كافة السمات في DICOM PowerShell 3.4 Table CC.2.5-3 مع نوع مفتاح الإرجاع من 1 أو 2.
• كافة السمات في DICOM PowerShell 3.4 Table CC.2.5-3 مع نوع مفتاح الإرجاع 1C الذي يتم استيفاء المتطلبات الشرطية له.
• تم تمرير جميع سمات Workitem الأخرى كمعلمات مطابقة.
• تم تمرير كافة سمات Workitem الأخرى كقيم includefield معلمات.

رموز استجابة البحث

ترجع واجهة برمجة تطبيقات الاستعلام أحد رموز الحالة التالية في الاستجابة.

الرمز	‏‏الوصف
200 (OK)	تحتوي حمولة الاستجابة على جميع الموارد المطابقة.
206 (Partial Content)	تحتوي حمولة الاستجابة على بعض نتائج البحث فقط، ويمكن طلب الباقي من خلال الطلب المناسب.
204 (No Content)	اكتمل البحث بنجاح ولكنه لم يرجع أي نتائج.
400 (Bad Request)	حدثت مشكلة في الطلب. على سبيل المثال، بناء جملة معلمة الاستعلام غير صالح. يحتوي نص الاستجابة على تفاصيل الفشل.
401 (Unauthorized)	لم تتم مصادقة العميل.
403 (Forbidden)	المستخدم غير مصرح به.
503 (Service Unavailable)	الخدمة غير متوفرة أو مشغولة. حاول مرة أخرى في وقت لاحق.

ملاحظات أخرى

لا ترجع 413 (request entity too large)واجهة برمجة تطبيقات الاستعلام . إذا كان حد استجابة الاستعلام المطلوب خارج النطاق المقبول، يتم إرجاع طلب غير صحيح. يتم حل أي شيء مطلوب ضمن النطاق المقبول.

• يتم تحسين النتائج المصفحة لإرجاع أحدث مثيل مطابق أولا، مما قد يؤدي إلى سجلات مكررة في الصفحات اللاحقة إذا تمت إضافة بيانات أحدث مطابقة للاستعلام.
• المطابقة ليست حساسة لحالة الأحرف، وليست حساسة للهجة بالنسبة إلى أنواع PN VR.
• المطابقة ليست حساسة لحالة الأحرف، وهي حساسة للتسليط بالنسبة إلى أنواع الواقع الافتراضي للسلسلة الأخرى.
• إذا كان هناك سيناريو يحدث فيه إلغاء Workitem والاستعلام عن Workitem نفسه في نفس الوقت، فمن المحتمل أن يستبعد الاستعلام Workitem الذي يتم تحديثه، ورمز الاستجابة هو 206 (Partial Content).

إشعار

DICOM® هي العلامة التجارية المسجلة للجمعية الوطنية لمصنعي الكهرباء لمنشورات المعايير المتعلقة بالاتصالات الرقمية للمعلومات الطبية.