مشاركة عبر

البرنامج التعليمي: العمل مع سجلات بيانات جيدة باستخدام واجهات برمجة تطبيقات Wellbore DDMS

  • مقالة

استخدم واجهات برمجة تطبيقات Wellbore Domain Data Management Services (DDMS) في Postman للعمل مع بيانات جيدة في مثيل Azure Data Manager for Energy.

في هذا البرنامج التعليمي، تتعلم كيفية:

  • إعداد Postman لاستخدام مجموعة Wellbore DDMS.
  • إعداد Postman لاستخدام بيئة Wellbore DDMS.
  • إرسال الطلبات عبر Postman.
  • إنشاء رمز مميز للتخويل.
  • استخدم واجهات برمجة تطبيقات Wellbore DDMS للعمل مع سجلات بيانات جيدة.

لمزيد من المعلومات حول DDMS، راجع مفاهيم DDMS.

المتطلبات الأساسية

الحصول على Azure Data Manager لتفاصيل مثيل الطاقة

الخطوة الأولى هي الحصول على المعلومات التالية من Azure Data Manager لمثيل الطاقة في مدخل Microsoft Azure:

المعلمة القيمة مثال
client_id معرف التطبيق (العميل) 00001111-aaaa-2222-bbbb-3333cccc4444
client_secret أسرار العميل _fl******************
tenant_id معرف الدليل (المستأجر) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
base_url عنوان URL https://<instance>.energy.azure.com
data-partition-id أقسام البيانات <data-partition-name>

ستستخدم هذه المعلومات لاحقا في البرنامج التعليمي.

إعداد أداة Postman

  1. قم بتنزيل تطبيق Postman لسطح المكتب وتثبيته.

  2. استيراد الملفات التالية في Postman:

    لاستيراد الملفات:

    1. حدد استيراد في Postman.

      Screenshot that shows the Import button in Postman.

    2. الصق عنوان URL لكل ملف في مربع البحث.

      Screenshot that shows importing collection and environment files in Postman via URL.

  3. في بيئة Postman، قم بتحديث القيمة الحالية بالمعلومات من Azure Data Manager لتفاصيل مثيل الطاقة:

    1. في Postman، في القائمة اليمنى، حدد Environments، ثم حدد Wellbore DDMS Environment.

    2. في عمود القيمة الحالية، أدخل المعلومات من الجدول في قسم Get your Azure Data Manager for Energy instance details من هذا البرنامج التعليمي.

    Screenshot that shows where to enter current values in the Wellbore DDMS environment.

إرسال مثال لطلب Postman

تحتوي مجموعة Postman ل Wellbore DDMS على الطلبات التي يمكنك استخدامها للتفاعل مع البيانات حول الآبار، والبئر، وسجلات الآبار، ومسار جيد في Azure Data Manager لمثيل الطاقة.

  1. في Postman، في القائمة اليسرى، حدد Collections، ثم حدد Wellbore DDMS. ضمن Setup، حدد Get an SPN Token.

  2. في القائمة المنسدلة للبيئة في الزاوية العلوية اليسرى، حدد Wellbore DDMS Environment.

    Screenshot that shows selections for getting an SPN token and choosing an environment.

  3. لإرسال الطلب، حدد إرسال.

    Screenshot that shows the Send button for a request in Postman.

  4. يتحقق الطلب من صحة رمز استجابة واجهة برمجة التطبيقات الفعلي مقابل رمز الاستجابة المتوقع. حدد علامة التبويب نتائج الاختبار لمعرفة ما إذا كان الطلب قد نجح أو فشل.

    فيما يلي مثال على مكالمة Postman ناجحة:

    Screenshot that shows success for a Postman call.

    فيما يلي مثال على مكالمة Postman فاشلة:

    Screenshot that shows failure for a Postman call.

استخدام واجهات برمجة تطبيقات Wellbore DDMS للعمل مع سجلات بيانات جيدة

إكمال طلبات Postman الموضحة في واجهات برمجة تطبيقات Wellbore DDMS التالية بنجاح يشير إلى استيعاب واسترداد سجلات جيدة في Azure Data Manager لمثيل الطاقة.

إنشاء علامة قانونية تتم إضافتها تلقائيا إلى بيئة Wellbore DDMS الخاصة بك لتوافق البيانات.

واجهة برمجة التطبيقات: إعداد>إنشاء علامة قانونية ل WDMS

الاسلوب: POST

Screenshot that shows the API that creates a legal tag.

لمزيد من المعلومات، راجع إدارة العلامات القانونية.

إنشاء سجل جيد

إنشاء سجل جيد في Azure Data Manager لمثيل الطاقة.

واجهة برمجة التطبيقات: إنشاء جيد>

الاسلوب: POST

Screenshot that shows the API that creates a well record.

الحصول على سجل جيد

احصل على بيانات السجل الجيد لمثيل Azure Data Manager for Energy.

واجهة برمجة التطبيقات: جيد>حسب المعرف

الاسلوب: GET

Screenshot that shows the API that gets a well record by ID.

الحصول على إصدارات جيدة

احصل على إصدارات كل سجل تم استيعابه جيدا في Azure Data Manager لمثيل الطاقة.

واجهة برمجة التطبيقات: إصدارات جيدة>

الاسلوب: GET

Screenshot that shows the API that gets all well versions.

الحصول على إصدار جيد محدد

احصل على تفاصيل إصدار معين لسجل جيد محدد في Azure Data Manager لمثيل الطاقة.

واجهة برمجة التطبيقات: إصدار محدد بشكل جيد>

الاسلوب: GET

Screenshot that shows the API that gets a specific well version.

حذف سجل جيد

احذف سجلا جيدا محددا من Azure Data Manager لمثيل الطاقة.

API: تنظيف>سجل جيد

الاسلوب: DELETE

Screenshot that shows the API that deletes a well record.

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

اقرأ البرنامج التعليمي التالي لمعرفة كيفية استخدام أداة سطر الأوامر sdutil لتحميل البيانات الزلزالية في Seismic Store:

البرنامج التعليمي: استخدام sdutil لتحميل البيانات في Seismic Store