Share via

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

  • مقالة

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

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

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

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

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

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

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

المعلمة القيمة مثال
CLIENT_ID معرف التطبيق (العميل) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
CLIENT_SECRET أسرار العميل _fl******************
TENANT_ID معرف الدليل (المستأجر) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
SCOPE معرف التطبيق (العميل) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
base_uri URI <instance>.energy.azure.com
data-partition-id أقسام البيانات <instance>-<data-partition-name>

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

إعداد أداة Postman

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

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

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

    1. قم بإنشاء ملفين JSON على الكمبيوتر الخاص بك عن طريق نسخ البيانات الموجودة في ملفات المجموعة والبيئة.

    2. في Postman، حدد Import>Files>Choose Files، ثم حدد ملفي JSON على جهاز الكمبيوتر الخاص بك.

    3. في Import Entities in Postman، حدد Import.

      Screenshot that shows importing collection and environment files in Postman.

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

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

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

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

إرسال طلب Postman

تحتوي مجموعة Postman ل Well Delivery DDMS على طلبات يمكنك استخدامها للتفاعل مع البيانات حول الآبار، والبئر، وسجلات الآبار، ومسار جيد في Azure Data Manager for Energy instance.

للحصول على مثال حول كيفية إرسال طلب Postman، راجع البرنامج التعليمي Wellbore DDMS.

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

إنشاء رمز مميز يمكنك استخدامه للعمل مع واجهات برمجة تطبيقات DDMS للتسليم الجيد:

  1. استيراد الأمر cURL التالي في Postman لإنشاء رمز مميز للحامل. استخدم القيم من Azure Data Manager لمثيل الطاقة.

     curl --location --request POST 'https://login.microsoftonline.com/{{TENANT_ID}}/oauth2/v2.0/token' \
     --header 'Content-Type: application/x-www-form-urlencoded' \
     --data-urlencode 'grant_type=client_credentials' \
     --data-urlencode 'client_id={{CLIENT_ID}}' \
     --data-urlencode 'client_secret={{CLIENT_SECRET}}' \
     --data-urlencode 'scope={{SCOPE}}'

    Screenshot of cURL code in a Well Delivery DDMS token.

  2. استخدم إخراج الرمز المميز للتحديث access_token في بيئة Well Delivery DDMS. بعد ذلك، يمكنك استخدام الرمز المميز للحامل كنوع تخويل في استدعاءات واجهة برمجة التطبيقات الأخرى.

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

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

إنشاء سجل جيد

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

واجهة برمجة التطبيقات: entity_create UC1>بشكل جيد

الاسلوب: PUT

Screenshot that shows the API that creates a well record.

إنشاء سجل تم إجهاضه بشكل جيد

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

API: UC1>entity_create wellbore

الاسلوب: PUT

Screenshot that shows the API that creates a wellbore record.

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

احصل على سجل جيد استنادا إلى معرف جيد محدد.

واجهة برمجة التطبيقات: entity_create UC1>نسخا جيدا

الاسلوب: GET

Screenshot that shows the API that gets a well record based on a specific well ID.

إنشاء خطة نشاط

إنشاء خطة نشاط.

API: UC1>entity_create activityplan

الاسلوب: PUT

Screenshot that shows the API that creates an activity plan.

الحصول على خطة نشاط حسب معرف جيد

احصل على كائن خطة النشاط لمعرف جيد معين.

واجهة برمجة التطبيقات: UC2>activity_plans_by_well

الاسلوب: GET

Screenshot of the API that gets an activity plan by well ID.

حذف سجل تم إجهاضه بشكل جيد

يمكنك حذف سجل wellbore في مثيل Azure Data Manager for Energy باستخدام واجهات برمجة تطبيقات Well Delivery DDMS. تعرض لقطة الشاشة التالية مثالاً لهذه التحذيرات.

Screenshot that shows how to use an API to delete a wellbore record.

حذف سجل جيد

يمكنك حذف سجل جيد في مثيل Azure Data Manager for Energy باستخدام واجهات برمجة تطبيقات DDMS للتسليم الجيد. تعرض لقطة الشاشة التالية مثالاً لهذه التحذيرات.

Screenshot that shows how to use an API to delete a well record.

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

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

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