في مقال كيف تعمل أنظمة الصور الطبية شغلنا Orthanc مع عارض OHIF، ورفعنا إليه فحص أشعة مقطعية عبر HTTP، وقرأنا وسوم الملف بأنفسنا، واختبرنا صيغ النقل على شريحة واحدة. وكان ذلك كافياً لنفهم ملف DICOM من الداخل، ولكنه ليس أرشيفاً يعمل في مركز أشعة. فالجهاز في الواقع لا يرفع الملفات عبر HTTP، وإنما يرسلها ببروتوكول DICOM على الشبكة فور انتهاء التصوير، ويسأل الأرشيف قبل ذلك عن قائمة المرضى المجدولين له اليوم حتى لا يكتب الفني الاسم بيده، والطبيب في غرفة القراءة يطلب الفحص القديم للمريض ليقارنه بالجديد، والفهرس الذي كان في ملف SQLite صغير يجب أن ينتقل إلى قاعدة بيانات تحتمل سنوات من الفحوص، والقرص يمتلئ أسرع مما تتوقع.
لنفرض أنك مسؤول تقنية المعلومات في مركز أشعة صغير فيه جهاز أشعة مقطعية CT وجهاز أشعة سينية رقمية، وطلب منك المدير أرشيفاً مفتوح المصدر بدل الأرشيف التجاري الذي انتهى عقده. هذا المقال هو المختبر الذي تحتاجه قبل أن تقول نعم أو لا. وسوف نناقش فيه ما يلي:
- خدمات DICOM على الشبكة DIMSE، وأسماء الأجهزة AET، ولماذا يختلف C-MOVE عن بقية الخدمات.
- تشغيل Orthanc مع فهرس PostgreSQL، وجهاز أشعة نحاكيه بأدوات dcmtk، وغرفة قراءة فيها Orthanc ثان.
- إرسال الصور بالأمر C-STORE من بيانات عامة مرخصة، والبحث C-FIND، والاسترجاع C-MOVE، وأخطاء حقيقية في كل منها.
- قائمة العمل Modality Worklist من الطلب إلى الجهاز، ومشكلة الأسماء العربية التي وصلت إلى الجهاز علامة ^ فقط، وكيف حللناها.
- كم يأخذ فحص من القرص دون ضغط ومع zlib وJPEG-LS وJPEG 2000، بأرقام قسناها.
- إخفاء الهوية Anonymization لفحص كامل، والأقفال التي تمنع أي جهاز من الإرسال إلى الأرشيف.
- النسخ الاحتياطي، وماذا يحدث للأرشيف عندما تتوقف قاعدة البيانات، ولماذا لم يرجع إلى العمل وحده.
ما الذي يتغير عندما يصبح Orthanc أرشيفاً حقيقياً؟
شرحنا في المقال السابق ملف DICOM والهرم المريض والفحص والسلسلة والصورة، وصيغ النقل Transfer Syntax، وواجهات DICOMweb الثلاث QIDO وWADO وSTOW، وإزالة الهوية من الوسوم، فلن نعيدها هنا. وما يضيفه هذا المقال هو الجزء الذي لا تراه عندما ترفع ملفاً من المتصفح، وهو أن الأرشيف في مستشفى أو مركز أشعة عقدة في شبكة من الأجهزة، وكل جهاز له اسم ودور. والجدول التالي يلخص الفرق:
| الموضوع | في مختبر المقال السابق | في أرشيف يعمل |
|---|---|---|
| وصول الصور | رفع عبر HTTP أو STOW | الجهاز يرسل بالأمر C-STORE على المنفذ 4242 أو 104 |
| بيانات المريض في الجهاز | موجودة في الملفات مسبقاً | الجهاز يأخذها من قائمة العمل Worklist قبل التصوير |
| الفهرس Index | SQLite داخل الـ Container | PostgreSQL أو MySQL بنسخ احتياطي |
| القراءة | عارض في المتصفح | محطات قراءة تطلب الفحوص بالأمر C-MOVE أو C-GET |
| الحماية | المنفذ على 127.0.0.1 فقط | أجهزة كثيرة على الشبكة، وكل منها يجب أن يعرف |
| التخزين | 90 ميغابايت لفحص واحد | تيرابايتات تتراكم سنوياً |
والمشروع نفسه هو Orthanc، سيرفر DICOM خفيف مكتوب بلغة C++ برخصة GPLv3، وتوزعه شركة Orthanc Team في Docker Image جاهزة فيها أغلب الإضافات Plugins، وكل إضافة تفعل بمتغير بيئة أو بقسم في ملف الإعداد كما يشرح توثيق الـ Image. وقد تحدثنا عن رخص الإضافات (وبعضها AGPLv3) في المقال السابق، فراجعها قبل أن تبني عليها خدمة تبيعها.
أي أرشيف مفتوح المصدر تختار؟
قبل أن نركز على Orthanc من الإنصاف أن ترى الخيارات الأخرى، لأن مركزك قد يحتاج غيره. فالأرشيفات مفتوحة المصدر الشائعة اثنان، ولكل منهما فلسفة مختلفة:
| Orthanc | dcm4chee Archive | |
|---|---|---|
| اللغة والتشغيل | C++، عملية واحدة خفيفة، وتبدأ في ثوان | Java على خادم WildFly، ومعه LDAP لإعداد الأجهزة وقاعدة بيانات |
| الإعداد | ملف JSON أو متغيرات بيئة | واجهة إدارة وسجلات LDAP، وإعداد أكثر تفصيلاً |
| القوة | سهل التشغيل والتطوير عليه، وواجهة REST شاملة، وإضافات بلغة Python وLua | مصمم للمستشفيات الكبيرة، ويدعم كثيراً من ملفات IHE وسير العمل المعقد |
| الضعف | بعض المزايا المؤسسية تأتي كإضافات منفصلة أو بلغة برمجة تكتبها بنفسك | منحنى تعلم أعلى، ويحتاج ذاكرة وخبرة Java |
وdcm4chee-arc-light هو الإصدار الحالي من مشروع dcm4che الذي بدأ قبل أكثر من عشرين سنة، وتجده خلف كثير من الأنظمة الوطنية والتجارية. أما Orthanc فهو الأنسب لمركز صغير أو متوسط، ولمطور يريد أن يبني خدمة فوق الأرشيف، ولمن يريد جسراً بين الأجهزة القديمة والتطبيقات الحديثة، ولذلك اخترناه لهذا المختبر. وإذا كان مركزك جزءاً من شبكة مستشفيات تلتزم بملفات IHE مثل مشاركة الصور بين المنشآت، فاقرأ وثيقة المطابقة لكل خيار قبل أن تقرر، فهذا ما سوف تسأل عنه الجهة التي تربطك بالشبكة.
خدمات DICOM على الشبكة DIMSE: الأسماء AET والاتفاق Association
معيار DICOM لا يعرف الملف فقط، وإنما يعرف أيضاً كيف يتكلم جهازان على الشبكة، وهذا هو الجزء الذي يسمى خدمات الرسائل DIMSE ويشرحه الجزء PS3.7 من المعيار. وقبل أي خدمة يفتح الطرفان اتفاقاً يسمى Association على TCP، يقدم فيه كل طرف اسمه، ويقترح الطالب أنواع البيانات وصيغ النقل التي يريدها، ويقبل الآخر بعضها أو يرفض الاتفاق كله.
واسم الجهاز في DICOM يسمى عنوان الكيان التطبيقي Application Entity Title واختصاراً AET، وهو نص لا يزيد عن 16 حرفاً مثل CT1 أو HI2PACS. وفي كل اتفاق اسمان: اسم الطالب Calling AET، واسم من يناديه Called AET. فإذا اتصل جهاز الأشعة المقطعية بالأرشيف فهو يقول: أنا CT1 وأنادي HI2PACS. وقد يتساءل البعض: لماذا لا يكفي عنوان IP كما في أي خدمة شبكة؟ والإجابة أن المعيار صمم في التسعينات لأجهزة تتغير عناوينها وتعمل خلف أنظمة وسيطة، فاختار الاسم كهوية منطقية للجهاز، وهذا القرار له أثر أمني كبير سوف نراه في قسم الحماية.
والخدمات التي سوف نستخدمها أربع، والصورة التالية تبين من يبدأ كل واحدة منها:
- C-ECHO: اختبار اتصال، مثل ping ولكن على مستوى DICOM.
- C-STORE: إرسال صورة واحدة لتحفظ، والجهاز يرسل صور الفحص صورة صورة بعد التصوير.
- C-FIND: البحث، على مستوى المريض أو الفحص أو السلسلة أو الصورة، وهو نفسه الذي تستخدمه قائمة العمل بشكل خاص.
- C-MOVE: طلب نقل فحص إلى جهاز ثالث، وهنا يقع أكثر الناس في الخطأ.

والفرق المهم في C-MOVE أن الطالب لا يستقبل الصور على نفس الاتصال، وإنما يقول للأرشيف: أرسل هذا الفحص إلى الجهاز الذي اسمه WS. والأرشيف يبحث عن هذا الاسم في قائمته ليعرف عنوانه ومنفذه، ثم يفتح هو اتصالاً جديداً إليه ويرسل الصور بالأمر C-STORE. وهذا يعني أن كل وجهة يجب أن تكون مسجلة في الأرشيف، وأن جدار الحماية Firewall يجب أن يسمح بالاتصال في الاتجاه المعاكس من الأرشيف إلى الوجهة. وهناك خدمة أحدث اسمها C-GET تستقبل الصور على نفس الاتصال، ولكن كثيراً من الأجهزة القديمة لا تدعمها، لذلك ما زال C-MOVE هو السائد.
تجهيز المختبر: Orthanc مع PostgreSQL وجهاز أشعة وغرفة قراءة
المختبر أربع Containers على شبكة واحدة، والصورة التالية تبينها قبل أن نكتب أي إعداد:

نبدأ بملف Compose. والإعداد التالي هو الشكل النهائي بعد كل ما سوف نصلحه في المقال، وسوف نشير إلى كل سطر غيرناه في موضعه:
name: hi2-pacs
services:
db:
image: postgres:18-alpine
container_name: hi2-pacs-db
environment:
POSTGRES_DB: orthanc
POSTGRES_USER: orthanc
POSTGRES_PASSWORD: ${DB_PASSWORD:?set DB_PASSWORD in .env}
volumes:
- hi2-pacs-pg:/var/lib/postgresql
healthcheck:
test: ["CMD-SHELL", "pg_isready -U orthanc -d orthanc"]
interval: 5s
retries: 10
pacs:
image: orthancteam/orthanc:26.11.1
container_name: hi2-pacs
depends_on:
db:
condition: service_healthy
environment:
ORTHANC__POSTGRESQL__PASSWORD: ${DB_PASSWORD}
ORTHANC__REGISTERED_USERS: '{"admin": "${ADMIN_PASSWORD:?set ADMIN_PASSWORD in .env}"}'
DICOM_WEB_PLUGIN_ENABLED: "true"
STONE_WEB_VIEWER_PLUGIN_ENABLED: "true"
OHIF_PLUGIN_ENABLED: "true"
volumes:
- ./orthanc.json:/etc/orthanc/orthanc.json:ro
- hi2-pacs-files:/var/lib/orthanc/db
ports:
- "127.0.0.1:9581:8042"
modality:
image: hi2-modality:1
container_name: hi2-modality
command: sleep infinity
volumes:
- ../data:/data:ro
- .:/lab
networks:
default:
ipv4_address: 172.31.42.10
ws:
image: orthancteam/orthanc:26.11.1
container_name: hi2-ws
environment:
ORTHANC__NAME: reading-room
ORTHANC__DICOM_AET: WS
ORTHANC__AUTHENTICATION_ENABLED: "false"
ORTHANC__DICOM_MODALITIES: '{"pacs": ["HI2PACS", "hi2-pacs", 4242]}'
DICOM_WEB_PLUGIN_ENABLED: "true"
STONE_WEB_VIEWER_PLUGIN_ENABLED: "true"
OHIF_PLUGIN_ENABLED: "true"
ports:
- "127.0.0.1:9582:8042"
volumes:
hi2-pacs-pg:
name: hi2-pacs-pg
hi2-pacs-files:
name: hi2-pacs-files
networks:
default:
name: hi2-pacs-net
ipam:
config:
- subnet: 172.31.42.0/24في الإعداد أعلاه لاحظ التالي:
- الوسم
26.11.1هو إصدار حزمة Orthanc Team وليس إصدار Orthanc نفسه، وبداخلها Orthanc 1.13.1 كما سوف يظهر في السجل. ولا تستخدمlatestفي أرشيف طبي، فالترقية يجب أن تكون قراراً تختبره قبل أن يحدث. - بيانات الدخول لا تكتب في الملف، وإنما تأتي من ملف
.env، وكلمة مرور واجهة الإدارة تمر بالمتغيرORTHANC__REGISTERED_USERS. والشرطتان السفليتان تعنيان مستوى في ملف الإعداد، فالمتغيرORTHANC__POSTGRESQL__PASSWORDهو الحقلPasswordداخل القسمPostgreSQL. - المنفذ 4242 لبروتوكول DICOM غير منشور خارج شبكة Docker، لأن الجهاز في نفس الشبكة. وفي مركز حقيقي هذا المنفذ يفتح فقط على شبكة الأجهزة الطبية، وليس على شبكة الموظفين ولا على الإنترنت.
- الشبكة لها نطاق ثابت
172.31.42.0/24والجهاز له عنوان ثابت، ولم يكن هذا في الإعداد الأول، وإنما أضفناه بعد مشكلة حقيقية في قسم الحماية. - غرفة القراءة Orthanc ثان دون كلمة مرور ودون قاعدة بيانات خارجية، لأنه محطة مؤقتة على 127.0.0.1 فقط، ولا تقم بذلك على محطة في مستشفى.
والملف الثاني orthanc.json هو إعداد الأرشيف نفسه، وهذه نسخته الأولى قبل أي تعديل:
{
"Name": "hi2-pacs",
"DicomAet": "HI2PACS",
"DicomPort": 4242,
"StorageDirectory": "/var/lib/orthanc/db",
"PostgreSQL": {
"EnableIndex": true,
"EnableStorage": false,
"Host": "hi2-pacs-db",
"Port": 5432,
"Database": "orthanc",
"Username": "orthanc"
},
"DicomModalities": {
"ct1": ["CT1", "hi2-modality", 4243],
"ws": ["WS", "hi2-ws", 4242]
},
"Worklists": {
"Enable": true,
"SaveInOrthancDatabase": true
},
"StableAge": 20
}والقرار المهم هنا هو EnableIndex مع EnableStorage: false، أي أن PostgreSQL يحفظ الفهرس فقط، والملفات نفسها تبقى على القرص في StorageDirectory. وقد يتساءل البعض: لماذا لا نحفظ الصور في القاعدة أيضاً فيصبح النسخ الاحتياطي أمراً واحداً؟ والإجابة أن توثيق إضافة PostgreSQL يسمح بذلك، ولكن قاعدة فيها تيرابايتات من الملفات الثنائية تصبح بطيئة في النسخ والاستعادة والترقية، والقرص أو التخزين الكائني Object Storage أنسب للملفات الكبيرة، فاترك القاعدة للفهرس. أما DicomModalities فهي قائمة الأجهزة التي يعرفها الأرشيف: الاسم الداخلي، ثم AET، ثم المضيف والمنفذ. وStableAge هو عدد الثواني دون صور جديدة الذي بعده يعد الفحص مكتملاً، وقيمته الافتراضية 60 وقللناها لنرى أثرها في المختبر.
جهاز الأشعة: Container فيها dcmtk
لا يوجد لدينا جهاز أشعة، ولكن أدوات dcmtk التي تطورها مؤسسة OFFIS هي المرجع الذي يستخدمه مهندسو الأجهزة أنفسهم لاختبار الاتصال، وفيها أداة لكل خدمة. وهذا ملف بناء الـ Image:
FROM debian:trixie-slim
RUN apt-get update && apt-get install -y --no-install-recommends dcmtk curl jq ca-certificates postgresql-client \
&& rm -rf /var/lib/apt/lists/*
WORKDIR /labdocker build -t hi2-modality:1 -f modality.Dockerfile .
docker run --rm hi2-modality:1 storescu --version | head -1
echo "DB_PASSWORD=$(openssl rand -hex 16)" > .env
echo "ADMIN_PASSWORD=$(openssl rand -hex 12)" >> .env
docker compose up -d
docker logs hi2-pacs 2>&1 | grep -E "Orthanc version|Registering plugin|schema|listening"$dcmtk: storescu v3.6.9 2024-12-11 $
W1118 12:12:08.776456 MAIN main.cpp:2545] Orthanc version: 1.13.1
W1118 12:12:08.972734 MAIN PluginsManager.cpp:287] Registering plugin 'orthanc-explorer-2' (version 1.15.1)
W1118 12:12:09.121874 MAIN PluginsManager.cpp:287] Registering plugin 'dicom-web' (version 1.24)
W1118 12:12:09.123646 MAIN PluginsManager.cpp:287] Registering plugin 'ohif' (version 1.8)
W1118 12:12:09.157787 MAIN PluginsManager.cpp:287] Registering plugin 'gdcm' (version 1.8)
W1118 12:12:09.159380 MAIN PluginsManager.cpp:287] Registering plugin 'postgresql-storage' (version 11.0)
W1118 12:12:09.160605 MAIN PluginsManager.cpp:287] Registering plugin 'postgresql-index' (version 11.0)
W1118 12:12:09.161820 MAIN PluginsManager.cpp:287] Registering plugin 'stone-webviewer' (version mainline)
W1118 12:12:09.164896 MAIN PluginsManager.cpp:287] Registering plugin 'orthanc-worklists' (version 1.0.0)
W1118 12:12:09.227030 MAIN postgresql-index:/PostgreSQLIndex.cpp:138] PostgreSQL is creating the database schema
W1118 12:12:13.168102 MAIN main.cpp:1531] DICOM server listening with AET HI2PACS on port: 4242
W1118 12:12:13.180481 MAIN HttpServer.cpp:2028] HTTP server listening on port: 8042 (HTTPS encryption is disabled, remote access is allowed)في المخرج أعلاه لاحظ التالي:
- الأرشيف جاهز في خمس ثوان، وأنشأ مخطط القاعدة بنفسه في أول تشغيل، فلا توجد سكربتات SQL تشغلها بيدك.
- إضافة PostgreSQL مسجلة مرتين: للفهرس وللتخزين، والثانية معطلة كما طلبنا، وقد كتب السجل ذلك صراحة في سطر لم نعرضه.
- إضافة قوائم العمل
orthanc-worklistsبالإصدار 1.0.0 هي الإضافة الجديدة التي حلت مكان الإضافة التجريبية القديمة، وتحفظ القوائم في قاعدة Orthanc وتقدم لها واجهة REST كما يشرح توثيقها، وسوف نستخدمها بعد قليل. - السطر الأخير يقول إن HTTPS معطل، فواجهة الإدارة يجب أن تكون خلف Reverse Proxy فيه TLS كما شرحنا في مقال تطبيقك خلف Reverse Proxy.
أول اتصال C-ECHO ثم إرسال الصور C-STORE
الصور من أرشيف The Cancer Imaging Archive واختصاراً TCIA، وكلها أزيلت هويتها قبل النشر، واخترنا ثلاثة فحوص من ثلاثة أنواع، وتحققنا من رخصة كل سلسلة في حقل LicenseName الذي ترجعه واجهة الأرشيف:
| النوع | المجموعة | المريض في المجموعة | الصور | الرخصة |
|---|---|---|---|---|
| أشعة مقطعية CT للبطن | Pancreas-CT | PANCREAS_0051 | 185 | CC BY 3.0 |
| أشعة صدر رقمية DX | LIDC-IDRI | LIDC-IDRI-0002 | 1 | CC BY 3.0 |
| رنين مغناطيسي MR للبطن | CMB-CRC | MSB-06489 | 9 | CC BY 4.0 |
والرخصة CC BY تسمح بالاستخدام والتعديل بشرط ذكر المصدر، وكل مجموعة لها طريقة استشهاد في صفحتها، وسياسة الاستخدام تمنع أي محاولة للتعرف على أصحاب الصور. ولا تقم بتجربة أي شيء في هذا المقال على صور مرضى حقيقيين من مركزك، فهي بيانات صحية حساسة. والآن أول اتصال من الجهاز:
docker exec hi2-modality echoscu -v -aet CT1 -aec HI2PACS hi2-pacs 4242I: Requesting Association
I: Association Accepted (Max Send PDV: 16372)
I: Sending Echo Request (MsgID 1)
I: Received Echo Response (Success)
I: Releasing Associationالخيار -aet هو اسم الطالب و-aec اسم الأرشيف. والأسطر الخمسة هي دورة الحياة الكاملة لأي خدمة: طلب اتفاق، وقبوله مع أكبر حجم لكل جزء من البيانات PDV يقبله الأرشيف، ثم الطلب والرد، ثم إنهاء الاتفاق. والآن نرسل الفحوص الثلاثة، والخيار +sd يقرأ كل ملفات المجلد و+r يدخل المجلدات الفرعية:
docker exec hi2-modality storescu -v -aet CT1 -aec HI2PACS +sd +r hi2-pacs 4242 /data/dxI: Received Store Response (Success)
I: Sending file: /data/dx/LICENSE
E: DcmElement: Unknown Tag & Data (694c,6563) larger (543519598) than remaining bytes in file
E: Bad DICOM file: /data/dx/LICENSE: I/O suspension or premature end of stream
E: Store SCU Failed: 0001:000a I/O suspension or premature end of stream
I: Aborting Associationهذا خطأ حقيقي سوف تقابله: أرشيف TCIA يضع ملف LICENSE نصياً مع كل تنزيل، والأداة حاولت قراءته كملف DICOM. والرقم الغريب (694c,6563) ليس وسماً وإنما الحروف Lice من كلمة License قرأتها الأداة كأرقام، وبعد الخطأ أنهت الاتفاق كله، فلو كان الملف النصي في بداية المجلد لما وصلت أي صورة. والحل أن نحدد نمط أسماء الملفات بالخيار +sp، ونقيس الوقت معه:
docker exec hi2-modality bash -c 'time storescu -aet CT1 -aec HI2PACS +sd +r +sp "*.dcm" hi2-pacs 4242 /data/ct /data/dx /data/mr'
curl -s -u admin:$ADMIN_PASSWORD 127.0.0.1:9581/statisticsreal 0m25.526s
user 0m0.327s
sys 0m0.932s
{
"CountInstances" : 195,
"CountPatients" : 3,
"CountSeries" : 3,
"CountStudies" : 3,
"TotalDiskSize" : "105345396",
"TotalDiskSizeMB" : 100,
"TotalUncompressedSize" : "105345396",
"TotalUncompressedSizeMB" : 100
}195 صورة هي 185 و1 و9، أي أن الأرشيف لم يكرر صور الأشعة السينية والرنين التي وصلت في المحاولة الأولى قبل الخطأ، والسبب أن كل صورة لها معرف فريد SOPInstanceUID، والإعداد الافتراضي OverwriteInstances يرفض استبدال صورة موجودة. وهذا سلوك تريده، لأن الأجهزة تعيد الإرسال كثيراً عند انقطاع الشبكة. أما 25 ثانية لمئة ميغابايت فهي بطيئة نسبياً، لأن كل صورة طلب ورد منفصلان، وكل صورة تكتب في القاعدة قبل الرد، وسوف نعود إلى الأداء في جدول الإنتاج.
ماذا يحفظ PostgreSQL في الفهرس Index؟
قبل أن نبحث في الأرشيف من المفيد أن نرى ما وضعه في القاعدة، لأن البحث C-FIND لا يقرأ ملفات DICOM، وإنما يستعلم من الجداول:
docker exec hi2-pacs-db psql -U orthanc -d orthanc -c "select resourcetype, count(*) from resources group by 1 order by 1" \
-c "select filetype, count(*), pg_size_pretty(sum(compressedsize)) from attachedfiles group by 1" \
-c "select count(*) from maindicomtags" -c "select pg_size_pretty(pg_database_size('orthanc'))" resourcetype | count
--------------+-------
0 | 3
1 | 3
2 | 3
3 | 195
filetype | count | pg_size_pretty
----------+-------+----------------
1 | 195 | 100 MB
4301 | 3 | 19 kB
count
-------
1062
pg_size_pretty
----------------
11 MBفي المخرج أعلاه لاحظ التالي:
- الجدول
resourcesفيه سطر لكل عنصر في الهرم: 0 للمريض، و1 للفحص، و2 للسلسلة، و3 للصورة. والعلاقة بين الأب والابن هي ما يجعل حذف فحص يحذف سلاسله وصوره. - الجدول
attachedfilesلا يحفظ الصورة، وإنما يقول إن الصورة الفلانية ملفها على القرص بالمعرف الفلاني وحجمه كذا، والنوع 1 هو ملف DICOM نفسه. أما النوع 4301 فهو بيانات وصفية تحفظها إضافة DICOMweb لكل سلسلة حتى تسرع العارض، وحجمها صغير. - الجدول
maindicomtagsفيه الوسوم الرئيسية فقط مثل الاسم ورقم المريض وتاريخ الفحص والنوع، وليس كل الوسوم. فإذا بحثت بوسم ليس فيه، اضطر Orthanc أن يفتح الملفات نفسها، وقد رأينا في سجله تحذيرات من نوعW001: Accessing DICOM tags from storageعندما طلب العارض وسماً خارج الفهرس، وهذا ما يبطئ البحث في أرشيف كبير. - 11 ميغابايت للقاعدة مقابل 100 ميغابايت للصور، أي أن الفهرس يكبر ببطء، ولكن لا تحكم على النسبة من مختبر صغير، لأن جزءاً من الـ 11 هو المخطط نفسه.
وقد يتساءل البعض: ما الحل إذا كان العارض أو محطة القراءة تبحث دائماً بوسم ليس في الفهرس؟ والإجابة أن Orthanc يسمح بإضافة وسوم إلى الفهرس بالإعداد ExtraMainDicomTags لكل مستوى من الهرم، فتصبح في الجدول ويبحث فيها دون فتح الملفات. ولكن هذا الإعداد يطبق على الصور التي تصل بعد تغييره فقط، أما القديمة فتحتاج إعادة فهرسة تقرأ كل ملف في الأرشيف، وهذه عملية تأخذ ساعات أو أياماً على أرشيف كبير. لذلك قرر الوسوم التي تحتاجها في البداية، قبل أن يصل أول فحص حقيقي، واقرأ تحذيرات W001 في السجل خلال أسبوع التجربة لتعرف ما الذي تطلبه العارضات فعلاً.
البحث في الأرشيف C-FIND
محطة القراءة أو جهاز آخر يريد أن يعرف ما في الأرشيف، فيرسل طلب C-FIND على مستوى الفحص STUDY، والمفاتيح التي تكتبها بالخيار -k نوعان: مفتاح بقيمة للمطابقة، ومفتاح فارغ يعني «أرجع لي هذا الحقل»:
docker exec hi2-modality findscu -S -aet CT1 -aec HI2PACS -k QueryRetrieveLevel=STUDY \
-k PatientName -k PatientID -k StudyDate -k ModalitiesInStudy -k StudyInstanceUID -k NumberOfStudyRelatedInstances hi2-pacs 4242I: Find Response: 1 (Pending)
I: (0008,0020) DA [19590902] # 8, 1 StudyDate
I: (0008,0061) CS [MR] # 2, 1 ModalitiesInStudy
I: (0010,0010) PN [MSB-06489 ] # 10, 1 PatientName
I: (0010,0020) LO [MSB-06489 ] # 10, 1 PatientID
I: (0020,1208) IS [9 ] # 2, 1 NumberOfStudyRelatedInstances
I: Find Response: 2 (Pending)
I: (0008,0020) DA [20000101] # 8, 1 StudyDate
I: (0008,0061) CS [DX] # 2, 1 ModalitiesInStudy
I: (0010,0010) PN (no value available) # 0, 0 PatientName
I: (0010,0020) LO [LIDC-IDRI-0002] # 14, 1 PatientID
I: (0020,1208) IS [1 ] # 2, 1 NumberOfStudyRelatedInstances
I: Find Response: 3 (Pending)
I: (0008,0020) DA [20151124] # 8, 1 StudyDate
I: (0008,0061) CS [CT] # 2, 1 ModalitiesInStudy
I: (0010,0010) PN [PANCREAS_0051 ] # 14, 1 PatientName
I: (0010,0020) LO [PANCREAS_0051 ] # 14, 1 PatientID
I: (0020,1208) IS [185 ] # 4, 1 NumberOfStudyRelatedInstancesحذفنا من المخرج أسطر معرفات الفحوص الطويلة حتى يقرأ. وفيه ثلاث ملاحظات من الواقع: تاريخ فحص الرنين 1959 والأشعة السينية الأول من يناير 2000، والسبب أن أدوات إزالة الهوية في TCIA تزيح التواريخ أو تستبدلها حتى لا تكشف المريض، فلا تبن أي منطق على أن تاريخ الفحص منطقي. واسم مريض الأشعة السينية فارغ تماماً، ومحطة القراءة التي تفترض وجود اسم سوف تعرض سطراً فارغاً. والمسافة بعد القيم مثل [9 ] ليست خطأ، فالمعيار يجعل طول كل قيمة زوجياً ويكمله بمسافة.
والآن بحث بشرط، فيه نجمة للمطابقة الجزئية ونوع الفحص، ثم نزول إلى مستوى السلسلة:
docker exec hi2-modality findscu -S -aet CT1 -aec HI2PACS -k QueryRetrieveLevel=STUDY \
-k "PatientID=PANCREAS*" -k ModalitiesInStudy=CT -k StudyInstanceUID hi2-pacs 4242
docker exec hi2-modality findscu -S -aet CT1 -aec HI2PACS -k QueryRetrieveLevel=SERIES \
-k StudyInstanceUID=1.2.826.0.1.3680043.2.1125.1.26661117508834397948676763221432807 \
-k SeriesInstanceUID -k Modality -k NumberOfSeriesRelatedInstances hi2-pacs 4242I: Find Response: 1 (Pending)
I: (0010,0020) LO [PANCREAS_0051 ] # 14, 1 PatientID
I: (0020,000d) UI [1.2.826.0.1.3680043.2.1125.1.26661117508834397948676763221432807] # 64, 1 StudyInstanceUID
---
I: Find Response: 1 (Pending)
I: (0008,0060) CS [CT] # 2, 1 Modality
I: (0020,000e) UI [1.2.826.0.1.3680043.2.1125.1.77419915248783746629465382576486048] # 64, 1 SeriesInstanceUID
I: (0020,1209) IS [185 ] # 4, 1 NumberOfSeriesRelatedInstancesوهذا النمط هو ما تفعله كل محطة قراءة: تبحث بالمريض أو بالتاريخ على مستوى الفحص، ثم تنزل إلى السلاسل لتعرض قائمة بالصور المصغرة، ثم تطلب ما يختاره الطبيب. والبحث على مستوى المريض PATIENT ما زال في المعيار، ولكن كثيراً من الأجهزة الحديثة تبحث على مستوى الفحص مباشرة.
الاسترجاع C-MOVE إلى غرفة القراءة
الطبيب في غرفة القراءة يريد فحص الرنين. والطلب هنا يأتي من جهاز CT1 لنبين الفكرة، ولكنه في الواقع يأتي من المحطة نفسها أو من نظام الأشعة RIS عندما يجدول المريض ويريد فحوصه القديمة جاهزة قبل وصوله، وهذا ما يسمى الجلب المسبق Prefetching:
docker exec hi2-modality movescu -v -S -aet CT1 -aec HI2PACS -aem WS -k QueryRetrieveLevel=STUDY \
-k StudyInstanceUID=1.3.6.1.4.1.14519.5.2.1.1.22050652398321395965781337593832924983 hi2-pacs 4242I: Sending Move Request (MsgID 1)
I: Received Move Response 1 (Pending)
I: Received Move Response 2 (Pending)
I: Received Move Response 3 (Pending)
I: Received Move Response 4 (Pending)
I: Received Move Response 5 (Pending)
I: Received Move Response 6 (Pending)
I: Received Move Response 7 (Pending)
I: Received Move Response 8 (Pending)
I: Received Final Move Response (Success)
I: Releasing Associationتسع صور، فثمانية ردود Pending بعدد الصور المتبقية في كل مرة ثم رد نهائي، وكل رد يحمل عدد الصور المرسلة والمتبقية والفاشلة. والصور لم تصل إلى CT1، وإنما إلى WS الذي فتح له الأرشيف اتصالاً جديداً. والآن نفس الطلب إلى وجهة لا يعرفها الأرشيف، كأن يكتب طبيب اسم حاسوبه المحمول:
docker exec hi2-modality movescu -v -S -aet CT1 -aec HI2PACS -aem LAPTOP7 -k QueryRetrieveLevel=STUDY \
-k StudyInstanceUID=1.3.6.1.4.1.14519.5.2.1.1.22050652398321395965781337593832924983 hi2-pacs 4242
docker logs hi2-pacs 2>&1 | grep LAPTOP7W: Move response with error status (Failed: UnableToProcess)
I: Received Final Move Response (Failed: UnableToProcess)
E1118 12:14:59.104876 DICOM-3 OrthancException.cpp:144] Accessing an inexistent item: Unknown modality for AET: LAPTOP7الجهاز يرى رسالة عامة UnableToProcess، والسبب الحقيقي في سجل الأرشيف فقط. لذلك عندما يتصل بك فني يقول إن الاسترجاع لا يعمل، فأول ما تفعله هو قراءة سجل الأرشيف وليس إعداد الجهاز. والحل إضافة الجهاز إلى DicomModalities، وهذا تصميم مقصود وليس عيباً، فلو قبل الأرشيف أي اسم وأي عنوان لأمكن لأي أحد على الشبكة أن يطلب نسخة من أي فحص إلى جهازه.
قائمة العمل Modality Worklist: الطلب يصل إلى الجهاز
في المراكز التي لا تستخدم قوائم العمل يكتب الفني اسم المريض ورقمه على شاشة الجهاز قبل التصوير، وهذه أكثر نقطة تدخل منها الأخطاء إلى الأرشيف: اسم بحروف مختلفة، أو رقم ملف ناقص، أو مريض بفحصين لأن الرقم كتب مرتين بشكلين. وقائمة العمل تحل ذلك: نظام الأشعة RIS ينشئ عند حجز الموعد سجلاً فيه بيانات المريض ورقم الطلب Accession Number والجهاز والموعد، والجهاز يسأل بخدمة C-FIND خاصة بقوائم العمل، فيختار الفني المريض من القائمة، وكل الصور تخرج بنفس المعرفات. ويعرف المعيار هذه الخدمة في الملحق K من الجزء PS3.4.
والإضافة الجديدة تقبل إنشاء القائمة بطلب REST، فنكتب ملفاً لمريض وهمي باسم عربي:
{
"Tags": {
"SpecificCharacterSet": "ISO_IR 192",
"PatientID": "MRN-30412",
"PatientName": "الحربي^سلمان",
"PatientBirthDate": "19790214",
"PatientSex": "M",
"AccessionNumber": "ACC-2026-0918",
"RequestedProcedureDescription": "CT abdomen with contrast",
"ScheduledProcedureStepSequence": [
{
"Modality": "CT",
"ScheduledStationAETitle": "CT1",
"ScheduledProcedureStepStartDate": "20261118",
"ScheduledProcedureStepStartTime": "103000",
"ScheduledProcedureStepDescription": "CT ABDOMEN W CONTRAST"
}
]
}
}واسم المريض في DICOM بالشكل العائلة ثم ^ ثم الاسم الأول، وISO_IR 192 هو اسم UTF-8 في المعيار. ثم نرسله ونسأل من الجهاز:
curl -s -u admin:$ADMIN_PASSWORD -X POST 127.0.0.1:9581/worklists/create --data-binary @worklist.json
docker exec hi2-modality findscu -W -aet CT1 -aec HI2PACS -k "ScheduledProcedureStepSequence[0].Modality=CT" \
-k "ScheduledProcedureStepSequence[0].ScheduledProcedureStepStartDate=20261118" \
-k "ScheduledProcedureStepSequence[0].ScheduledStationAETitle=CT1" \
-k PatientName -k PatientID -k PatientBirthDate -k AccessionNumber -k StudyInstanceUID -k SpecificCharacterSet hi2-pacs 4242{
"ID" : "143c093f-7eea-430c-b4fa-996f53c0c7c3",
"Path" : "/worklists/143c093f-7eea-430c-b4fa-996f53c0c7c3"
}
I: Find Response: 1 (Pending)
I: (0008,0005) CS [ISO_IR 100] # 10, 1 SpecificCharacterSet
I: (0008,0050) SH [ACC-2026-0918 ] # 14, 1 AccessionNumber
I: (0010,0010) PN [^ ] # 2, 1 PatientName
I: (0010,0020) LO [MRN-30412 ] # 10, 1 PatientID
I: (0010,0030) DA [19790214] # 8, 1 PatientBirthDate
I: (0020,000d) UI [1.2.276.0.7230010.3.1.2.1684431971.1.1795004116.780192] # 54, 1 StudyInstanceUIDكل شيء وصل إلا الاسم، فقد وصل إلى الجهاز ^ ومسافة فقط. والسبب في السطر الأول من الرد: الأرشيف أجاب بالترميز ISO_IR 100 وهو Latin-1 الذي لا يحتوي حروفاً عربية، فحذفها وأبقى الفاصل. والقائمة نفسها محفوظة صحيحة بالترميز الذي أرسلناه، كما تأكدنا بطلب GET /worklists/، ولكن Orthanc يكتب الرد بترميزه الافتراضي. وجربنا أولاً أن يطلب الجهاز UTF-8 صراحة بالمفتاح SpecificCharacterSet=ISO_IR 192 في الطلب، فرجع نفس الرد. والحل الذي نجح هو الإعداد DefaultEncoding، فأضفناه إلى orthanc.json وأعدنا تشغيل الأرشيف:
"StableAge": 20,
"DefaultEncoding": "Utf8"I: (0008,0005) CS [ISO_IR 192] # 10, 1 SpecificCharacterSet
I: (0010,0010) PN [الحربي^سلمان ] # 24, 1 PatientName
I: (0010,0020) LO [MRN-30412 ] # 10, 1 PatientIDوهذا درس لا يظهر في أي مختبر يكتب الأسماء بالإنجليزية: افحص المسار العربي من أوله إلى آخره، أي من نظام المواعيد إلى قائمة العمل إلى شاشة الجهاز إلى الصور في الأرشيف إلى التقرير. ولاحظ أن بعض الأجهزة القديمة لا تعرض UTF-8 أصلاً، فتظهر علامات استفهام على شاشتها حتى لو كان الأرشيف صحيحاً، لذلك تحقق من وثيقة المطابقة DICOM Conformance Statement للجهاز قبل الشراء، ففيها الترميزات التي يدعمها.
![مخطط قائمة العمل بأربع خطوات: نظام الأشعة ينشئ القائمة بطلب POST /worklists/create للمريض MRN-30412 ورقم الطلب ACC-2026-0918، ثم الجهاز CT1 يسأل بالأمر findscu -W ويأخذ الاسم وتاريخ الميلاد ورقم الطلب ومعرف الفحص، ثم يرسل الصور بنفس StudyInstanceUID ونفس SeriesInstanceUID لكل صور السلسلة، ثم بعد StableAge 20 ثانية يعد الفحص مكتملاً ومهمة الصيانة كل 60 ثانية تحذف القائمة. وتحتها مقارنة: الاسم العربي وصل [^ ] بالترميز ISO_IR 100، وبعد الإعداد DefaultEncoding Utf8 وصل كاملاً بالترميز ISO_IR 192](https://arabroot.io/content/images/2026/11/orthanc-pacs-lab-03-worklist.webp)
الجهاز يصور ويرسل: خطأ السلاسل العشرين
لنحاكي التصوير نأخذ 20 شريحة من فحص البطن، ونكتب عليها بيانات قائمة العمل بالأداة dcmodify، ثم نرسلها. وهذه النسخة الأولى من السكربت:
dcmodify -nb -gse -gin \
-m "(0008,0005)=ISO_IR 192" \
-m "PatientID=MRN-30412" -m "PatientName=الحربي^سلمان" -m "PatientBirthDate=19790214" -m "PatientSex=M" \
-m "AccessionNumber=ACC-2026-0918" \
-m "StudyInstanceUID=$1" -m "StudyDate=20261118" \
/tmp/scan/*.dcm
curl -s -u admin:$ADMIN_PASSWORD 127.0.0.1:9581/tools/find \n -d '{"Level":"Study","Query":{"AccessionNumber":"ACC-2026-0918"},"Expand":true}' \n | jq -c '.[] | {ID, Patient: .PatientMainDicomTags.PatientName, Acc: .MainDicomTags.AccessionNumber, IsStable, Series: (.Series|length)}'sent 20 files
{"ID":"7e7b8002-af86952c-33a94d0b-4cc28d2a-d7d6fac0","Patient":"الحربي^سلمان","Acc":"ACC-2026-0918","IsStable":false,"Series":20}الاسم صحيح ورقم الطلب صحيح، ولكن الفحص فيه 20 سلسلة لكل منها صورة واحدة. والسبب أن الخيار -gse يولد معرف سلسلة جديداً لكل ملف على حدة، وليس معرفاً واحداً لكل الملفات. والنتيجة في الواقع أن العارض يعرض عشرين صورة مصغرة بدل سلسلة واحدة يتنقل الطبيب بين شرائحها، ولا يستطيع بناء مقطع ثلاثي الأبعاد منها. وهذا الخطأ نفسه يحدث في سكربتات التحويل والاستيراد التي يكتبها المطورون من الصفر، لذلك حذفنا الفحص وأنشأنا قائمة عمل جديدة، ثم ولدنا معرف السلسلة مرة واحدة خارج الأمر:
STUDY_UID="$1"
SERIES_UID="$STUDY_UID.$(date +%s)" # one series UID for all the files
dcmodify -nb -gin \
-m "(0008,0005)=ISO_IR 192" \
-m "PatientID=MRN-30412" -m "PatientName=الحربي^سلمان" -m "PatientBirthDate=19790214" -m "PatientSex=M" \
-m "AccessionNumber=ACC-2026-0918" -m "StudyDate=20261118" \
-m "StudyInstanceUID=$STUDY_UID" -m "SeriesInstanceUID=$SERIES_UID" \
/tmp/scan/*.dcmsent 20 files
{"ID":"b48ef293-395fa753-663ad3d0-8d16360f-4d388e55","Patient":"الحربي^سلمان","Acc":"ACC-2026-0918","IsStable":false,"Series":1}سلسلة واحدة الآن. والخيار -gin بقي، لأن كل صورة يجب أن يكون لها معرف SOPInstanceUID جديد، وإلا رفضها الأرشيف كصور موجودة. والطريقة التي بنينا بها معرف السلسلة هنا، أي معرف الفحص ثم الوقت، تكفي لمختبر، أما في الإنتاج فاستخدم جذراً مسجلاً لمؤسستك كما شرحنا في مقال المعرفات الفريدة. وبعد قرابة دقيقة سألنا عن القائمة والفحص:
curl -s -u admin:$ADMIN_PASSWORD "127.0.0.1:9581/worklists/?format=Simplify" | jq length0القائمة اختفت وحدها، لأن الإعداد الافتراضي DeleteWorklistsOnStableStudy يحذف القائمة عندما يجد فحصاً مستقراً بنفس StudyInstanceUID، ومهمة الصيانة تعمل كل 60 ثانية. وهذا يمنع أن يرى الفني غداً مريضاً صوره بالأمس. والصورة التالية من واجهة Orthanc Explorer 2 في قسم قوائم العمل، بعد أن أنشأنا قائمة لمريضة ثانية حتى لا تكون فارغة، ولاحظ أن الاسم العربي يظهر فيها بشكل صحيح:

DICOMweb فوق نفس الأرشيف
شرحنا QIDO وWADO وSTOW في المقال السابق، ونكتفي هنا بشيء واحد يخص هذا الأرشيف: أن نفس الفحص الذي وصل بالبروتوكول التقليدي يقرأ عبر HTTP دون أي نسخ، وأن الاسم العربي يرجع سليماً في JSON:
curl -s -u admin:$ADMIN_PASSWORD "127.0.0.1:9581/dicom-web/studies?PatientID=MRN-30412&includefield=00081030" \
| jq -c '.[] | {acc: .["00080050"].Value[0], name: .["00100010"].Value[0].Alphabetic, n: .["00201208"].Value[0]}'{"acc":"ACC-2026-0918","name":"الحربي^سلمان","n":20}وهذا ما يجعل Orthanc مناسباً كجسر: الأجهزة القديمة تتكلم DIMSE، والتطبيقات الجديدة والعارض في المتصفح وخدمات الذكاء الاصطناعي تتكلم DICOMweb، والأرشيف واحد. ولاحظ في سجل التشغيل تحذيراً من الإضافة نفسها: STOW and WADO chunked transfers will be entirely stored in RAM، أي أن رفع فحص كبير جداً عبر STOW يحمل كله في الذاكرة، فضع حداً لحجم الطلب في الـ Reverse Proxy.
الواجهات والعارض: Orthanc Explorer 2 وOHIF
الواجهة الافتراضية في هذه الـ Image هي Orthanc Explorer 2، وفيها قائمة الفحوص والبحث وإرسال الفحص إلى جهاز مسجل والحذف وقوائم العمل. والصورة التالية منها بعد كل ما أرسلناه، ولاحظ الفحص الذي أرسله «الجهاز» بالاسم العربي ورقم الطلب، وبجانبه الفحوص الثلاثة من TCIA:

أما العارض فقد فعلنا إضافتي OHIF وStone في الأرشيف وفي غرفة القراءة، وفتحنا فحص البطن في OHIF على غرفة القراءة بعد أن وصلها بالأمر C-MOVE. والعارض يعمل في المتصفح ويطلب الصور عبر DICOMweb من نفس الأصل Origin، فلا تحتاج إعداد CORS الذي احتجناه في المقال السابق عندما كان العارض في Container مستقلة:

وتذكر أن هذه العارضات مكتوب عليها صراحة أنها ليست للتشخيص: OHIF يعرض عند فتحه «for investigational use only»، وStone يكتب «Not for diagnostic usage». والعارض الذي يقرأ منه الطبيب التقرير الرسمي جهاز طبي يحتاج اعتماداً من الجهة التنظيمية، وهذا موضوع مقال قادم عن الذكاء الاصطناعي كجهاز طبي.
كم يأخذ الفحص من القرص؟ الضغط Compression بالأرقام
في المقال السابق قسنا الضغط على شريحة واحدة. والسؤال الذي يسأله المدير مختلف: كم قرصاً أحتاج في السنة؟ لذلك أرسلنا نفس فحص البطن كاملاً (185 شريحة) خمس مرات، وفي كل مرة إلى Orthanc جديد بإعداد مختلف، وقرأنا الحجم والوقت. والإعداد IngestTranscoding يجعل Orthanc يحول كل صورة إلى صيغة النقل المحددة عند استلامها، أما StorageCompression فيضغط الملف كله بخوارزمية zlib قبل كتابته دون أن يغير محتوى DICOM:
run() { name=$1; shift
docker rm -f hi2-ctest >/dev/null 2>&1
docker run -d --name hi2-ctest --network hi2-pacs-net -e ORTHANC__AUTHENTICATION_ENABLED=false "$@" orthancteam/orthanc:26.11.1 >/dev/null
sleep 8
docker exec hi2-modality bash -c '
s=$(date +%s%N); storescu -aet CT1 -aec ORTHANC +sd +sp "*.dcm" hi2-ctest 4242 /data/ct; e=$(date +%s%N); sleep 2
st=$(curl -s http://hi2-ctest:8042/statistics | jq -r "\"\(.CountInstances) \(.TotalDiskSize)\"")
id=$(curl -s http://hi2-ctest:8042/instances | jq -r ".[0]")
ts=$(curl -s http://hi2-ctest:8042/instances/$id/metadata/TransferSyntax)
echo "$st $ts $(( (e - s) / 1000000 ))ms"' | sed "s/^/$name /"
}
run none
run zlib -e ORTHANC__STORAGE_COMPRESSION=true
run jpeg-ls -e ORTHANC__INGEST_TRANSCODING=1.2.840.10008.1.2.4.80
run j2k -e ORTHANC__INGEST_TRANSCODING=1.2.840.10008.1.2.4.90
run j2k-lossy -e ORTHANC__INGEST_TRANSCODING=1.2.840.10008.1.2.4.91none 185 97223568 1.2.840.10008.1.2.1 22765ms
zlib 185 56324751 1.2.840.10008.1.2.1 73233ms
jpeg-ls 185 36415638 1.2.840.10008.1.2.4.80 37247ms
j2k 185 36044642 1.2.840.10008.1.2.4.90 20145ms
j2k-lossy 185 36044642 1.2.840.10008.1.2.4.91 25014msوالصورة التالية تضع الأرقام بجانب بعضها:

في النتائج أعلاه لاحظ التالي:
- الصيغة في الحالة الأولى
1.2.840.10008.1.2.1أي Explicit VR Little Endian، مع أن ملفات TCIA الأصلية Implicit كما رأينا في المقال السابق. والسبب أنstorescuيقترح عند الاتفاق صيغة Explicit أولاً، والأرشيف قبلها، فحولت الأداة الملفات أثناء الإرسال. أي أن ما يحفظه الأرشيف يتأثر بما يقترحه الجهاز، وليس بالملف الأصلي فقط. - الضغط دون فقدان Lossless بصيغة JPEG-LS أو JPEG 2000 قلل الحجم إلى 37% تقريباً، أي توفير قرابة 63% دون تغيير أي بكسل. وفي فحوص الأشعة المقطعية ينجح هذا الضغط جيداً لأن مساحة كبيرة من الصورة هواء بقيمة واحدة حول الجسم.
- zlib وفر أقل بكثير، 42% فقط، لأنه لا يعرف أن البيانات صورة، ويضغطها كأي ملف، ومع ذلك يبقى خياراً إذا كانت الأجهزة أو العارضات عندك لا تفهم صيغ JPEG، لأن الأرشيف يفك zlib قبل أن يرسل فلا يراه أحد.
- الرمز
1.2.840.10008.1.2.4.91اسمه في المعيار JPEG 2000 Image Compression وليس «مع فقدان»، فهو يسمح بالنوعين، والبرنامج الذي يضغط يقرر. وفي تجربتنا خرج بنفس حجم الضغط دون فقدان تماماً بالبايت. فلا تفترض من رقم الصيغة وحده أن الصورة فقدت شيئاً أو لم تفقد، واقرأ الوسمLossyImageCompressionفي الملف. - الأوقات على جهاز مشترك ومع شبكة Docker، فلا تعتمد عليها كقياس أداء، ولكن الاتجاه واضح: الضغط يحدث عند الاستلام فيأخذ وقتاً من المعالج، وzlib كان الأبطأ في تجربتنا.
وقد يتساءل البعض: لماذا لا نضغط مع فقدان فنوفر 90% أو أكثر؟ والإجابة أن قرار الضغط مع فقدان في الصور التشخيصية قرار طبي وتنظيمي يتخذه أطباء الأشعة والجهة التنظيمية، وليس قراراً يتخذه فريق التقنية لتوفير المساحة. والأسلوب الشائع أن يحفظ الأصل دون فقدان، وتولد نسخ أصغر للعرض السريع على الهاتف أو للمشاركة. ولحساب القرص لمركزنا الافتراضي: إذا كان يجري 40 فحص أشعة مقطعية يومياً بحجم قريب من فحصنا، فهذه قرابة 3.9 غيغابايت يومياً دون ضغط، أي قرابة 1.4 تيرابايت في السنة، وقرابة 520 غيغابايت مع الضغط دون فقدان، ثم تضاعف ذلك للنسخة الاحتياطية. والفحوص الحديثة بشرائح أرق أكبر بكثير من فحصنا، فاحسب بأرقام أجهزتك أنت.
إخفاء الهوية Anonymization لفحص كامل
شرحنا في المقال السابق لماذا لا يكفي حذف الاسم، وأن المعيار يعرف ملف تعريف لإزالة الهوية في الجزء PS3.15. والحالة العملية هنا: باحث أو شركة ذكاء اصطناعي تطلب فحص المريض الذي صورناه، فننشئ نسخة مخفية الهوية بطلب واحد إلى واجهة الإخفاء في Orthanc:
S=$(curl -s -u admin:$ADMIN_PASSWORD 127.0.0.1:9581/tools/find \
-d '{"Level":"Study","Query":{"AccessionNumber":"ACC-2026-0918"}}' | jq -r '.[0]')
curl -s -u admin:$ADMIN_PASSWORD -X POST 127.0.0.1:9581/studies/$S/anonymize \
-d '{"Keep":["StudyDescription"],"Replace":{"PatientName":"ANON^TEACHING"},"Force":true,"Synchronous":true}' | jq -c '{ID, Path}'{"ID":"86a7a4c3-ebdfb8b9-195bf00c-0990b7c7-1368bf21","Path":"/studies/86a7a4c3-ebdfb8b9-195bf00c-0990b7c7-1368bf21"}ثم نقرأ الفحصين من /studies/{id}، ووسوم أول صورة في النسخة الجديدة من /instances/{id}/tags?simplify:
{"id":"86a7a4c3","pid":"ad0a7afe-6bcb-4df1-912f-947fef0ed064","name":"ANON^TEACHING","birth":"","acc":"","uid":"1.2.276.0.7230010.3.1.2.943141"}
{"id":"b48ef293","pid":"MRN-30412","name":"الحربي^سلمان","birth":"19790214","acc":"ACC-2026-0918","uid":"1.2.276.0.7230010.3.1.2.168443"}
{"PatientIdentityRemoved":"YES","DeidentificationMethod":"Orthanc 1.13.1","PatientName":"ANON^TEACHING","PatientID":"ad0a7afe-6bcb-4df1-912f-947fef0ed064","AccessionNumber":"","StudyDate":"","InstitutionName":null}في المخرج أعلاه لاحظ التالي:
- الأصل بقي كما هو، والنسخة فحص جديد بمعرف فحص جديد، فالإخفاء لا يعدل الأرشيف، وإنما ينسخ منه. وهذا يعني أن كل نسخة مخفية تأخذ مساحة كاملة، فاحذفها بعد التصدير.
- رقم المريض صار معرفاً عشوائياً، ورقم الطلب وتاريخ الفحص فارغان، والوسمان
PatientIdentityRemovedوDeidentificationMethodيسجلان أن الملف أخفي ومن أخفاه، وهذا ما تطلبه أغلب لجان الأخلاقيات. - تاريخ الفحص حذف تماماً، وبعض الأبحاث تحتاج الفاصل الزمني بين فحصين للمريض نفسه، وعندها تحتاج إزاحة التواريخ بثابت لكل مريض بدل حذفها، وهذا ما تفعله أدوات TCIA كما رأينا في تاريخ 1959.
- الإخفاء على الوسوم فقط. فإذا كان اسم المريض محروقاً داخل البكسلات، كما في بعض صور الموجات فوق الصوتية والصور الملتقطة من الشاشة، فلن يحذفه هذا الطلب، ولذلك أضاف Orthanc Team إضافة منفصلة لإخفاء مناطق من البكسلات.
من يحق له أن يرسل إلى الأرشيف؟
قبل أن نغلق شيئاً اختبرنا ما يقبله الأرشيف بإعداده الحالي. فأرسلنا صورة باسم لا يعرفه، وطلبنا قائمة المرضى من واجهة HTTP دون كلمة مرور:
docker exec hi2-modality sh -c 'storescu -v -aet ANYONE -aec HI2PACS hi2-pacs 4242 /data/mr/00000001.dcm 2>&1 | grep -E "Association|Response"
curl -s -o /dev/null -w "no password: %{http_code}\n" http://hi2-pacs:8042/patients'I: Requesting Association
I: Association Accepted (Max Send PDV: 16372)
I: Received Store Response (Success)
I: Releasing Association
no password: 401واجهة HTTP محمية بكلمة المرور، ولكن بروتوكول DICOM قبل صورة من جهاز اسمه ANYONE لم نسجله أبداً، والسبب أن الإعداد الافتراضي DicomAlwaysAllowStore قيمته true. وهذا مفهوم في مختبر، أما في مستشفى فيعني أن أي حاسوب على الشبكة يستطيع أن يضع صوراً باسم أي مريض في الأرشيف، وصورة بمعرف مريض خطأ في أرشيف طبي أخطر من صورة مفقودة. لذلك أضفنا إلى orthanc.json ما يلي وأعدنا التشغيل:
"DicomAlwaysAllowEcho": false,
"DicomAlwaysAllowStore": false,
"DicomAlwaysAllowFind": false,
"DicomAlwaysAllowMove": false,
"DicomCheckModalityHost": true,
"DicomCheckCalledAet": trueثم جربنا ثلاث حالات: الاسم المجهول، والجهاز الصحيح ينادي الأرشيف باسم خطأ، والجهاز الصحيح بالاسم الصحيح:
F: Association Rejected:
F: Result: Rejected Permanent, Source: Service User
F: Reason: Calling AE Title Not Recognized
---
F: Association Rejected:
F: Result: Rejected Permanent, Source: Service User
F: Reason: Called AE Title Not Recognized
---
I: Requesting Association
F: Association Rejected:الأولى والثانية متوقعتان. أما الثالثة فهي الجهاز الصحيح، وقد رفضه الأرشيف أيضاً، والسبب في السجل:
W1118 12:20:26.518817 DICOM-SERVER OrthancConfiguration.cpp:1062] Forbidding access from AET "CT1" given its hostname (172.24.0.5) does not match the "DicomModalities" configuration option (hi2-modality was expected)فالإعداد DicomCheckModalityHost يقارن عنوان IP الذي جاء منه الاتصال بالنص المكتوب في قائمة الأجهزة كما هو، ولا يحول اسم المضيف hi2-modality إلى عنوان. والحل الذي يناسب الواقع هو أن يكون للجهاز عنوان ثابت، وهذا هو الحال في أي جهاز طبي حقيقي، فأعطينا الجهاز في ملف Compose العنوان 172.31.42.10 كما رأيت في البداية، وكتبناه في القائمة بدل الاسم:
"ct1": ["CT1", "172.31.42.10", 4243],I: Requesting Association
I: Association Accepted (Max Send PDV: 16372)
I: Received Store Response (Success)
I: Releasing Association
F: Association Rejected:
F: Result: Rejected Permanent, Source: Service User
F: Reason: Calling AE Title Not Recognized
echo from ANYONE exit=1الجهاز الصحيح يرسل، والاسم المجهول لا يستطيع حتى اختبار الاتصال. والصورة التالية تجمع ما جربناه:

وتذكر أن اسم AET ليس كلمة مرور، فهو مكتوب في إعداد كل جهاز ويستطيع أي فني أن يقرأه، وفحص العنوان أقوى منه ولكنه ليس كافياً على شبكة مسطحة يستطيع فيها أي أحد أن يغير عنوانه. والطبقات التي تكمل الحماية هي شبكة معزولة للأجهزة الطبية، وTLS لبروتوكول DICOM إذا كان الجهاز يدعمه (Orthanc يدعمه بالإعداد DicomTlsEnabled)، وواجهة HTTP خلف Reverse Proxy بشهادة، وإضافة الصلاحيات Authorization التي تربط Orthanc بمزود هوية مثل Keycloak حتى لا تكون هناك كلمة مرور واحدة مشتركة. وقد شرحنا المفهوم في مقال OAuth وOpenID Connect.
النسخ الاحتياطي Backup وماذا يحدث عندما تتوقف القاعدة
الأرشيف الآن في مكانين، والصورة التالية تبين ما في كل منهما:

وأخذنا نسخة من كل منهما:
docker exec hi2-pacs-db sh -c 'pg_dump -U orthanc -Fc orthanc > /tmp/orthanc.dump && ls -l /tmp/orthanc.dump'
docker run --rm -v hi2-pacs-files:/src:ro debian:trixie-slim sh -c 'cd /src && tar -cf - . | wc -c; find . -type f | wc -l'-rw-r--r-- 1 root root 169088 Nov 18 12:39 /tmp/orthanc.dump
126781440
240نسخة القاعدة 169 كيلوبايت بالصيغة المضغوطة لـ pg_dump، ونسخة الملفات 127 ميغابايت و240 ملفاً، وهي أكثر من 195 لأن الأرشيف أصبح فيه الفحص الذي صورناه ونسخته المخفية. والمهم هنا ترتيب النسخ: إذا نسخت الملفات أولاً ثم القاعدة بعد ساعة، فقد تحتوي القاعدة على صور وصلت بعد نسخ الملفات، فتشير بعد الاستعادة إلى ملفات غير موجودة. والترتيب الأسلم هو نسخ القاعدة أولاً ثم الملفات، فتكون في الملفات صور زائدة لا يعرفها الفهرس، وهذه أهون، ويمكن استيرادها مرة أخرى. وقد شرحنا النسخ المتسق في مقال نسخ قواعد البيانات بشكل متسق، وقاعدة النسخ الثلاث في مقال النسخ الاحتياطي بقاعدة 3-2-1.
نجرب العطل: نوقف قاعدة البيانات
ماذا يرى الجهاز إذا توقفت القاعدة أثناء العمل؟ أوقفناها وأرسلنا صورة واختبرنا الاتصال:
docker stop hi2-pacs-db
docker exec hi2-modality sh -c 'storescu -v -aet CT1 -aec HI2PACS hi2-pacs 4242 /data/mr/00000003.dcm 2>&1 | grep -vE "XMIT|checking|Sending"
echoscu -aet CT1 -aec HI2PACS hi2-pacs 4242; echo echo-exit=$?'I: Requesting Association
I: Association Accepted (Max Send PDV: 16372)
I: Received Store Response (Refused: OutOfResources)
I: Releasing Association
echo-exit=0الاختبار C-ECHO نجح، والإرسال رفض بالحالة Refused: OutOfResources، وفي السجل The database is not available, closing the connection. والدرس الأول هنا أن C-ECHO الأخضر لا يعني أن الأرشيف يعمل، فلا تجعله فحص الصحة الوحيد في المراقبة. ثم أعدنا تشغيل القاعدة وانتظرنا حتى أصبحت healthy، وأرسلنا نفس الصورة ثلاث مرات بفاصل 15 ثانية:
I: Received Store Response (Refused: OutOfResources)
I: Received Store Response (Refused: OutOfResources)
I: Received Store Response (Refused: OutOfResources)
E1118 12:40:33.985169 DB HOUSEKEEPING postgresql-index:/PostgreSQLDatabase.cpp:47] PostgreSQL error: no connection to the serverالأرشيف لم يرجع إلى العمل وحده بعد أكثر من دقيقتين من عودة القاعدة، وكتب في سجله 527 سطراً من نوع no connection to the server، وdocker ps يعرضه بالحالة Up طوال الوقت. وبعد docker restart hi2-pacs رجع الإرسال بالحالة Success مباشرة. والدرس الثاني أهم: إذا كانت المراقبة تفحص أن العملية تعمل فقط، فسوف يبقى الأرشيف يرفض صور الأجهزة ساعات دون أن ينبهك أحد، والجهاز في الغالب يحفظ الصور في ذاكرته ويعيد المحاولة، حتى تمتلئ. لذلك افحص المسار الحقيقي، أي إرسال صورة اختبار أو طلب يقرأ من القاعدة مثل /statistics، واجعل فشله يعيد تشغيل الأرشيف أو ينبه المناوب. والـ Image فيها سكربت /probes/test-aliveness.py لهذا الغرض، فاقرأ ما يفحصه قبل أن تعتمد عليه.
من المختبر إلى الإنتاج Production
الجدول التالي يجمع ما رأيناه وما يقابله في مركز حقيقي:
| البند | ما رأيناه في المختبر | ماذا تفعل في الإنتاج |
|---|---|---|
| الفهرس | PostgreSQL 18، و11 MB لـ 195 صورة | قاعدة على قرص سريع، ونسخ يومي، واختبار استعادة |
| الملفات | Volume محلي، 100 MB لثلاثة فحوص | تخزين منفصل يكبر، أو تخزين كائني بإضافة S3، ونسخة في مكان آخر |
| الضغط | JPEG 2000 وJPEG-LS دون فقدان وفرا 63% | ضغط دون فقدان عند الاستلام بعد اختباره مع كل العارضات |
| الترميز | الاسم العربي وصل ^ حتى أضفنا DefaultEncoding | UTF-8، واختبار المسار العربي على شاشة كل جهاز |
| قبول الأجهزة | الافتراضي يقبل أي اسم | قائمة أجهزة بعناوين ثابتة، وDicomAlwaysAllow* معطلة |
| الاسترجاع | وجهة مجهولة رجعت UnableToProcess | كل محطة مسجلة، وجدار الحماية يسمح بالاتجاه المعاكس |
| قوائم العمل | حذفت وحدها بعد استقرار الفحص | RIS ينشئها بالـ REST، ومراقبة القوائم القديمة التي لم تحذف |
| المراقبة | القاعدة عادت والأرشيف بقي يرفض | فحص صحة يرسل أو يقرأ فعلاً، وليس C-ECHO أو حالة الـ Container |
| واجهة HTTP | كلمة مرور واحدة دون TLS | Reverse Proxy بشهادة، وإضافة الصلاحيات مع مزود هوية |
| العارض | OHIF وStone للعرض فقط | عارض معتمد للتشخيص، وهذه للمراجعة والتعليم |
أخطاء شائعة
- ترك
DicomAlwaysAllowStoreعلى الافتراضي: أي جهاز على الشبكة يضع صوراً في الأرشيف، ورأينا ذلك بالاسم ANYONE. - كتابة اسم المضيف في قائمة الأجهزة مع فحص العنوان: Orthanc يقارن العنوان بالنص كما هو، فيرفض الجهاز الصحيح.
- الحكم على الأرشيف بنجاح C-ECHO: نجح الاختبار والقاعدة متوقفة والصور مرفوضة.
- نسخ الملفات دون القاعدة أو العكس: نسخة واحدة منهما لا تستعيد شيئاً.
- توليد معرف سلسلة لكل ملف في سكربت استيراد: فحص واحد بعشرين سلسلة لا يقرأ.
- إرسال مجلد تنزيل كما هو: ملف نصي واحد مثل
LICENSEأنهى الإرسال كله. - اختبار الأسماء بالإنجليزية فقط: مشكلة الترميز لا تظهر إلا مع اسم عربي.
- الضغط مع فقدان على الأصل لتوفير المساحة: قرار طبي وتنظيمي، والضغط دون فقدان يوفر أغلب المساحة دون هذا الخطر.
تنظيف المختبر
docker compose down -v
docker rm -f hi2-ctest 2>/dev/null
docker rmi hi2-modality:1الخيار -v يحذف الـ Volumes وفيها الفهرس والصور، فلا تستخدمه على أرشيف فيه بيانات تريدها.
تدريب عملي
- فعل في غرفة القراءة قائمة أجهزة بالأرشيف، ثم اطلب منها بحثاً C-FIND على الأرشيف من واجهة Orthanc Explorer 2، واقرأ في سجل الأرشيف ما الذي يمنعه أو يسمح به.
- أنشئ قائمة عمل لجهاز الأشعة السينية باسم AET آخر، ثم اسأل من CT1 دون شرط على
ScheduledStationAETitle، وجرب الإعدادFilterIssuerAetفي قسم قوائم العمل. - أعد تجربة الضغط على فحص الأشعة السينية الوحيد، وقارن نسبة التوفير بنسبة الأشعة المقطعية، وفسر الفرق.
- اكتب فحص صحة يرسل صورة اختبار صغيرة كل دقيقة ويحذفها، ثم أوقف القاعدة وتأكد أنه يكتشف المشكلة التي لم يكتشفها C-ECHO.
الخلاصة
وصلنا لنهاية الموضوع، وأهم ما فيه:
- الأرشيف عقدة في شبكة أجهزة، وكل جهاز له اسم AET، والخدمات الأربع C-ECHO وC-STORE وC-FIND وC-MOVE هي ما يتكلم به الجهاز ومحطة القراءة، وC-MOVE يحتاج أن يعرف الأرشيف عنوان الوجهة مسبقاً.
- Orthanc 1.13.1 مع PostgreSQL يحفظ الفهرس في القاعدة والصور على القرص، و195 صورة احتاجت 11 MB في القاعدة و100 MB على القرص.
- قائمة العمل تنقل بيانات المريض من الطلب إلى الجهاز، والاسم العربي وصل علامة ^ حتى ضبطنا
DefaultEncodingعلى UTF-8، والقائمة حذفت وحدها بعد استقرار الفحص. - الضغط دون فقدان بصيغة JPEG-LS أو JPEG 2000 قلل فحص الأشعة المقطعية من 97 إلى 36 ميغابايت، وzlib إلى 56، والرمز 4.91 لا يعني فقداً بالضرورة.
- الإعداد الافتراضي يقبل الصور من أي اسم، والأقفال التي جربناها رفضت كل طلب خطأ بعد أن أعطينا الجهاز عنواناً ثابتاً.
- عندما توقفت القاعدة نجح C-ECHO ورفضت الصور، ولم يرجع الأرشيف وحده بعد عودتها حتى أعدنا تشغيله، فراقب المسار الحقيقي.
دليلكيف تعمل أنظمة الصور الطبية؟ DICOM وPACS من الداخلكيف تحفظ المستشفيات صور الأشعة وتنقلها بمعيار DICOM، وكيف تشغل أرشيفاً وعارضاً على سيرفرك وتجربهما على صور حقيقية.
دليلتبادل البيانات الصحية بين الأنظمة: HL7 وFHIRكيف تنتقل نتائج المختبر وبيانات المريض بين أنظمة المستشفى برسائل HL7 وواجهات FHIR، وكيف تبني ذلك وتختبره بنفسك.
دليلخادم FHIR على سيرفرك: تجربة عملية مع HAPI FHIRكيف تشغل سيرفر FHIR يحفظ في PostgreSQL ويتحقق من البيانات بدليل نفيس، مع البحث بالأسماء العربية والنسخ والمعاملات.
دليلالمستشفى من الداخل: خريطة الأنظمة HIS وEMRما هي أنظمة المستشفى من التسجيل والسجل الطبي إلى المختبر والأشعة والصيدلية والفوترة، وكيف تتصل ببعضها، ومن أين تبدأ.
دليلالسجل الصحي الإلكتروني EMR مع OpenEMR وOpenMRSكيف تشغل سجلاً سريرياً مفتوح المصدر بواجهة عربية، وتسجل فيه مريضاً وزيارة ووصفة، ثم تتكامل معه عبر OAuth2 وFHIR وتعرف ما يتغير في الطريق.
دليلنظام المختبر LIS مفتوح المصدر: SENAITE وOpenELISكيف تمر العينة في نظام مختبر مفتوح المصدر من الطلب والملصق إلى النتيجة والاعتماد والتقرير، وكيف تصل نتائج الأجهزة برسائل HL7 v2 عبر برنامج وسيط.
دليلخصوصية البيانات الصحية وإخفاء الهوية De-identificationما يقوله النظام السعودي عن البيانات الصحية، ومن يحق له أن يراها، وكيف تخفي هوية المرضى وتقيس أن البيانات لم تعد تدل عليهم.
دليلالنسخ الاحتياطي بقاعدة 3-2-1 واختبار الاستعادةكيف تحدد كم بيانات تقبل أن تخسر، وتبني نسخاً لا يستطيع المخترق حذفها، وتتأكد أنك تستطيع استعادتها فعلاً.سجل التحديثات
- 2026-11-18: كتابة المقال، وتنفيذ المختبر على Orthanc 1.13.1 (orthancteam/orthanc:26.11.1) مع إضافات PostgreSQL 11.0 وDICOMweb 1.24 وWorklists 1.0.0 وOHIF 1.8 وOrthanc Explorer 2 1.15.1، وPostgreSQL 18.6، وأدوات dcmtk 3.6.9 على debian:trixie-slim، وصور من TCIA (Pancreas-CT وLIDC-IDRI وCMB-CRC)، على Docker Engine 29.8.0.