تصدير بيانات FHIR في واجهة برمجة تطبيقات Azure ل FHIR

تسمح ميزة التصدير المجمع بتصدير البيانات من خادم FHIR® وفقا لمواصفات FHIR.

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

استخدام الأمر $export

بعد تكوين واجهة برمجة تطبيقات Azure ل FHIR للتصدير، يمكنك استخدام $export الأمر لتصدير البيانات خارج الخدمة. يتم تخزين البيانات في حساب التخزين الذي حددته أثناء تكوين التصدير. لمعرفة كيفية استدعاء $export الأمر في خادم FHIR، اقرأ الوثائق في مواصفات $export HL7 FHIR.

الوظائف عالقة في حالة سيئة

في بعض الحالات، قد تتعثر الوظيفة في حالة سيئة. يمكن أن يحدث هذا إذا لم يتم إعداد أذونات حساب التخزين بشكل صحيح. إحدى الطرق للتحقق من صحة التصدير هي التحقق من حساب التخزين الخاص بك لمعرفة ما إذا كانت الحاوية المقابلة (أي ndjson) الملفات موجودة. إذا لم تكن موجودة، ولا توجد مهام تصدير أخرى قيد التشغيل، فمن المحتمل أن تكون المهمة الحالية عالقة في حالة سيئة. يجب إلغاء مهمة التصدير عن طريق إرسال طلب إلغاء ومحاولة إعادة ترتيب المهمة مرة أخرى. وقت التشغيل الافتراضي للتصدير في حالة سيئة هو 10 دقائق قبل أن يتوقف وينتقل إلى مهمة جديدة أو يعيد محاولة التصدير.

تدعم $export واجهة برمجة تطبيقات Azure ل FHIR على المستويات التالية:

• النظام: GET https://<<FHIR service base URL>>/$export>>
• المريض: GET https://<<FHIR service base URL>>/Patient/$export>>
• مجموعة المرضى* - تقوم واجهة برمجة تطبيقات Azure ل FHIR بتصدير جميع الموارد ذات الصلة ولكنها لا تصدر خصائص المجموعة: GET https://<<FHIR service base URL>>/Group/[ID]/$export>>

يتم تصدير البيانات في ملفات متعددة، كل منها يحتوي على موارد من نوع واحد فقط. سيكون عدد الموارد في ملف فردي محدودا. يعتمد الحد الأقصى لعدد الموارد على أداء النظام. تم تعيينه حاليا إلى 5000، ولكن يمكن أن يتغير. والنتيجة هي أنك قد تحصل على ملفات متعددة لنوع مورد. تتبع أسماء الملفات التنسيق 'resourceName-number-number.ndjson'. ترتيب الملفات غير مضمون ليتوافق مع أي ترتيب للموارد في قاعدة البيانات.

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

تصدير بيانات FHIR إلى ADLS Gen2

ندعم $export حاليا حسابات التخزين الممكنة ل ADLS Gen2، مع القيود التالية:

• لا يمكن للمستخدمين الاستفادة من مساحات الأسماء الهرمية - لا توجد طريقة لاستهداف تصدير إلى دليل فرعي معين داخل حاوية. نحن نوفر فقط القدرة على استهداف حاوية معينة (حيث يتم إنشاء مجلد جديد لكل تصدير).
• بمجرد اكتمال التصدير، لا يتم تصدير أي شيء إلى هذا المجلد مرة أخرى. ستكون عمليات التصدير اللاحقة إلى نفس الحاوية داخل مجلد تم إنشاؤه حديثا.

الإعدادات والمعلمات

الرؤوس

هناك معلمتان مطلوبتان للعنوان يجب تعيينهما للوظائف $export . يتم تعريف القيم بواسطة مواصفات $export الحالية.

• Accept - application/fhir+json
• الأفضل - الاستجابة غير المتزامنة

معلمات الاستعلام

تدعم واجهة برمجة تطبيقات Azure ل FHIR معلمات الاستعلام التالية. كل هذه المعلمات اختيارية.

تصدير آمن إلى Azure Storage

تدعم واجهة برمجة تطبيقات Azure ل FHIR عملية تصدير آمنة. اختر أحد الخيارين التاليين.

• السماح لواجهة برمجة تطبيقات Azure ل FHIR كخدمة موثوق بها من Microsoft بالوصول إلى حساب تخزين Azure.

• السماح لعناوين IP معينة مقترنة بواجهة برمجة تطبيقات Azure ل FHIR بالوصول إلى حساب تخزين Azure. يوفر هذا الخيار تكوينين مختلفين اعتمادا على ما إذا كان حساب التخزين في نفس الموقع أو في موقع مختلف مثل واجهة برمجة تطبيقات Azure ل FHIR.

السماح لواجهة برمجة تطبيقات Azure ل FHIR كخدمة موثوق بها من Microsoft

حدد حساب تخزين من مدخل Microsoft Azure، ثم حدد جزء Networking . حدد Selected networks ضمن علامة التبويب Firewalls and virtual networks .

ضمن قسم Exceptions، حدد المربع Allow trusted خدمات Microsoft للوصول إلى حساب التخزين هذا وحفظ الإعداد.

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

السماح لعناوين IP محددة بالوصول إلى حساب تخزين Azure من مناطق Azure الأخرى

1. في مدخل Microsoft Azure، انتقل إلى حساب Azure Data Lake Storage Gen2.

2. في القائمة اليسرى، حدد Networking.

3. حدد Enabled من الشبكات الظاهرية المحددة وعناوين IP.

4. في قسم جدار الحماية، في المربع نطاق العنوان، حدد عنوان IP. أضف نطاقات IP للسماح بالوصول من الإنترنت أو الشبكات المحلية. يمكنك العثور على عنوان IP في الجدول التالي لمنطقة Azure حيث يتم توفير خدمة FHIR.

   منطقة Azure	عنوان IP العام
   شرق أستراليا	20.53.44.80
   وسط كندا	20.48.192.84
   Central US	52.182.208.31
   شرق الولايات المتحدة	20.62.128.148
   East US 2	20.49.102.228
   شرق الولايات المتحدة 2 EUAP	20.39.26.254
   منطقة شمال ألمانيا	51.116.51.33
   وسط غرب ألمانيا	51.116.146.216
   شرق اليابان	20.191.160.26
   وسط كوريا	20.41.69.51
   وسط شمال الولايات المتحدة	20.49.114.188
   أوروبا الشمالية	52.146.131.52
   جنوب أفريقيا	102.133.220.197
   South Central US	13.73.254.220
   جنوب شرق آسيا	23.98.108.42
   شمال سويسرا	51.107.60.95
   جنوب المملكة المتحدة	51.104.30.170
   غرب المملكة المتحدة	51.137.164.94
   غرب وسط الولايات المتحدة	52.150.156.44
   أوروبا الغربية	20.61.98.66
   West US 2	40.64.135.77

السماح لعناوين IP محددة بالوصول إلى حساب تخزين Azure في نفس المنطقة

تشبه عملية التكوين لعناوين IP في نفس المنطقة الإجراء السابق، باستثناء أنك تستخدم نطاق عناوين IP محددا بتنسيق التوجيه بين المجالات (CIDR) بدون فئة (CIDR) بدلا من ذلك (أي 100.64.0.0/10). يجب تحديد نطاق عناوين IP (100.64.0.0 إلى 100.127.255.255) لأنه يتم تخصيص عنوان IP لخدمة FHIR في كل مرة تقوم فيها بإجراء طلب عملية.

الخطوات التالية

في هذه المقالة، تعلمت كيفية تصدير موارد FHIR باستخدام $export الأمر . بعد ذلك، لمعرفة كيفية تصدير بيانات غير محددة الهوية، راجع