البرنامج التعليمي: العمل مع سجلات بيانات جيدة باستخدام واجهات برمجة تطبيقات DDMS للتسليم الجيد
استخدم واجهات برمجة تطبيقات خدمات إدارة بيانات مجال التسليم الجيد (DDMS) في Postman للعمل مع بيانات جيدة في مثيل Azure Data Manager for Energy.
في هذا البرنامج التعليمي، تتعلم كيفية:
- إعداد Postman لاستخدام مجموعة Well Delivery DDMS.
- إعداد Postman لاستخدام بيئة DDMS للتسليم الجيد.
- إرسال الطلبات عبر Postman.
- إنشاء رمز مميز للتخويل.
- استخدم واجهات برمجة تطبيقات DDMS للتسليم الجيد للعمل مع سجلات بيانات جيدة.
لمزيد من المعلومات حول DDMS، راجع مفاهيم DDMS.
المتطلبات الأساسية
- اشتراك Azure
- مثيل ل Azure Data Manager for Energy تم إنشاؤه في اشتراك Azure
الحصول على 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
قم بتنزيل تطبيق Postman لسطح المكتب وتثبيته.
استيراد الملفات التالية في Postman:
لاستيراد الملفات:
في بيئة Postman، قم بتحديث CURRENT VALUE بالمعلومات من Azure Data Manager لمثيل الطاقة:
في Postman، في القائمة اليمنى، حدد Environments، ثم حدد WellDelivery Environment.
في العمود CURRENT VALUE ، أدخل المعلومات من الجدول في قسم Get your Azure Data Manager for Energy instance details من هذا البرنامج التعليمي.
إرسال طلب Postman
تحتوي مجموعة Postman ل Well Delivery DDMS على طلبات يمكنك استخدامها للتفاعل مع البيانات حول الآبار، والبئر، وسجلات الآبار، ومسار جيد في Azure Data Manager for Energy instance.
للحصول على مثال حول كيفية إرسال طلب Postman، راجع البرنامج التعليمي Wellbore DDMS.
إنشاء رمز مميز لواجهات برمجة التطبيقات
إنشاء رمز مميز يمكنك استخدامه للعمل مع واجهات برمجة تطبيقات DDMS للتسليم الجيد:
استيراد الأمر 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}}'
استخدم إخراج الرمز المميز للتحديث
access_token
في بيئة Well Delivery DDMS. بعد ذلك، يمكنك استخدام الرمز المميز للحامل كنوع تخويل في استدعاءات واجهة برمجة التطبيقات الأخرى.
استخدام واجهات برمجة تطبيقات DDMS للتسليم الجيد للعمل مع سجلات بيانات جيدة
نجاح إكمال طلبات Postman الموضحة في واجهات برمجة تطبيقات Well Delivery DDMS التالية يشير إلى نجاح استيعاب واسترداد سجلات جيدة في Azure Data Manager لمثيل الطاقة.
إنشاء سجل جيد
إنشاء سجل جيد في Azure Data Manager لمثيل الطاقة.
واجهة برمجة التطبيقات: entity_create UC1>بشكل جيد
الاسلوب: PUT
إنشاء سجل تم إجهاضه بشكل جيد
إنشاء سجل جيد في Azure Data Manager لمثيل الطاقة.
API: UC1>entity_create wellbore
الاسلوب: PUT
الحصول على إصدار جيد
احصل على سجل جيد استنادا إلى معرف جيد محدد.
واجهة برمجة التطبيقات: entity_create UC1>نسخا جيدا
الاسلوب: GET
إنشاء خطة نشاط
إنشاء خطة نشاط.
API: UC1>entity_create activityplan
الاسلوب: PUT
الحصول على خطة نشاط حسب معرف جيد
احصل على كائن خطة النشاط لمعرف جيد معين.
واجهة برمجة التطبيقات: UC2>activity_plans_by_well
الاسلوب: GET
حذف سجل تم إجهاضه بشكل جيد
يمكنك حذف سجل wellbore في مثيل Azure Data Manager for Energy باستخدام واجهات برمجة تطبيقات Well Delivery DDMS. تعرض لقطة الشاشة التالية مثالاً لهذه التحذيرات.
حذف سجل جيد
يمكنك حذف سجل جيد في مثيل Azure Data Manager for Energy باستخدام واجهات برمجة تطبيقات DDMS للتسليم الجيد. تعرض لقطة الشاشة التالية مثالاً لهذه التحذيرات.
الخطوات التالية
انتقل إلى البرنامج التعليمي التالي لمعرفة كيفية العمل مع بيانات جيدة باستخدام واجهات برمجة تطبيقات Wellbore DDMS: