پروتکل Medix
این سند، پروتکل ارتباطی بین Kelishe و PACS را مشخص می کند که MEDIX نام دارد و حاوی دستورات مورد نیاز برای صدور و مدیریت کدهای کلیشه است. در این پروتکل، بررسی و ارائه فایل های Dicom بین سیستم های Kelishe و PACS بر اساس پروتکل شناخته شده DicomWeb است و شامل دو بخش لیست API های پکس و لیست API های کلیشه میباشد که مراکز تصویربرداری لازم است به لیست API های پکس مراجعه کرده و آنها را پیاده سازی کنند.
در نظر داشته باشید پروتکل DicomWeb به تنهایی پاسخگوی نیازهای کلیشه نمی باشد و قابلیت فعالسازی تمامی فیچرهای کلیشه را ندارد. به همین منظور برقراری ارتباط با سامانه کلیشه از طریق پروتکلی به نام Medix صورت می پذیرد. این پروتکل شرایطی را فراهم می آورد تا تمامی فیچرهای سامانه برای مرکز شما فعال شود ، به عنوان نمونه مشاهده ی تصاویر پزشکی به صورت دایکام، برقراری ارتباط با گزارش تصاویر و به نمایش گذاشتن آنها در سامانه، قابلیت دانلود تصاویر دایکام و……..
در صورتی که به هر دلیلی امکان پیاده سازی پروتکل Medix در سرویس پکس مرکز مربوطه وجود نداشت، میتوانید از طریق سرویس افرا به راحتی ارتباط بین مرکز و کلیشه را برقرار کنید.
تشریح برخی API های موجود
تشریح API دانلود در پکس:
پروسه دانلود در پکس می‌تواند شامل چندین عملیات مختلف باشد از جمله آماده سازی آزمایه مربوطه و فرایند فشرده سازی و zip کردن.
زمانی که API دانلود trigger میشود، پکس باید بتواند از طریق APIایی که کلیشه در اختیارش میگذارد فرایند دانلود را گزارش کند؛ چرا که نیاز هست سمت کلیشه کاربر از فرایند دانلود مطلع شود.
بعنوان مثال: فرض کنیم فرایند دانلود شامل بخش‌های زیر باشد.
RequestSent // RequestFailed
ExportStarted // ExportFailed
CompressStarted
CompressFinished
ExportCompleted
DownloadStarted // DownloadFailed
DownloadSaved
وضعیت دانلود در پکس از طریق پارامتر WebhookUri انجام میشود که در واقع یک آدرس API سمت کلیشه هست که وضعیت دانلود را از پکس میگیرد و سمت UI نمایش می‌دهد.
پیاده سازی یک مثال کاربردی :
Step 1: Request from KELISHE to PACS download
POST /api/study/download
}
, "StudyInstanceUID":"1.3.12.2.1107.5.1.4.93005.30000022021906440899400000064"
, "WebhookUri": "https://kelishe.ir/webhook/v1/pacs/faraabeen"
}:"WebhookHeaders"
, "authorization":PACS_TOKEN
, "userid":userid
, "kcode":kcode
{
{
______________________________________________________________________________
Step 2 : Response from PACS
این مرحله تا زمان آماده سازی فایل، با ارسال پارامتر status تکرار می شود و وضعیت پروسه دانلود را به کلیشه ارسال می کند
POST https://kelishe.ir/webhook/v1/pacs/faraabeen
}
, "Status" : "2"
}:"headers"
, "authorization":PACS_TOKEN
, "userid":userid
, "kcode":kcode
,{
, "File" : "File address when ready to download"
}
______________________________________________________________________________
Status Items :
RequestFailed= -4
ExportFailed= -3
DownloadFailed= -2
MergeFailed= -1
ProcessStarted= 0
RequestSent= 1
ExportStarted= 2
CompressStarted= 3
CompressFinished= 4
ExportCompleted= 5
DownloadStarted= 6
DownloadSaved= 7
MergeStarted= 8
MergeCompleted= 10
تشریح API وضعیت ریپورت در پکس:
این API که سمت پکس پیاده سازی می شود مشخص میکند که برای آزمایه های درخواست شده آیا گزارشی ثبت شده است یا خیر. این وضعیت برای کلیشه لازم هست که مشخص شود آزمایه ها گزارش دارند یا خیر.
درخواست دمو و فعالسازی سامانه کلیشه
جهت فعالسازی سامانه کلیشه به صورت رایگان برای مرکز تصویربرداری شما، اطلاعات خود را وارد کنید تا کارشناسان تیم کلیشه با شما تماس حاصل کنند.