Share via

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

  • مقالة

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

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

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

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

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

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

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

المعلمة القيمة مثال
CLIENT_ID معرف التطبيق (العميل) 3dfxxxxxxxxxxxxxxxxxxxxxx
CLIENT_SECRET أسرار العميل _fl******************
TENANT_ID معرف الدليل (المستأجر) 72fxxxxxxxxxxxx
SCOPE معرف التطبيق (العميل) 3dfxxxxxxxxxxxxxxxxxxxxxxx
HOSTNAME URI <instance>.energy.azure.com
DATA_PARTITION_ID أقسام البيانات <instance>-<data-partition-name>

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

إعداد أداة Postman

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

  2. استيراد الملف التالي في Postman: مجموعة Petrel DDMS Postman.

  3. إنشاء بيئة Postman باستخدام القيم التي حصلت عليها سابقا. يجب أن تبدو البيئة مثل هذا المثال:

    Screenshot that shows an example Postman environment.

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

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

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

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

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

ينشئ هذا الطلب رمزا مميزا للوصول ويعينه كطريقة تخويل للطلبات المستقبلية.

يمكنك أيضا إنشاء رمز مميز باستخدام الأمر 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}}'

لاستخدام هذا الرمز المميز الذي تم إنشاؤه بواسطة cURL، يجب عليك التحديث access_token في المتغيرات الخاصة بك Collection بالقيمة بعد Bearer في الاستجابة.

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

إكمال طلبات Postman الموضحة في واجهات برمجة تطبيقات Petrel DDMS التالية بنجاح يشير إلى التفاعل الناجح مع مشاريع Petrel المحفوظة. على الرغم من أن واجهة برمجة التطبيقات توفر طريقة لتحميل البيانات، فإننا نوصي بتحميل مشاريعك عبر DELFI Petrel Project Explorer. تفترض جميع استدعاءات واجهة برمجة التطبيقات التالية أن لديك مشروعا تم تحميله إلى Petrel Project Explorer.

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

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

الاسلوب: POST

Screenshot that shows the API that creates a legal tag.

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

إضافة مستخدمين إلى مجموعة استحقاق

لكي يكون لدى المستخدمين الأذونات المناسبة لإجراء استدعاءات Petrel DDMS API، يجب أن يكونوا جزءا من users.datalake.admins@{data-partition-id}.dataservices.energy مجموعة الاستحقاق. يضيف هذا الاستدعاء مستخدما إلى المجموعة المناسبة.

المستخدم في هذه الحالة هو معرف العميل أو OID في الرمز المميز المستخدم للمصادقة. على سبيل المثال، إذا قمت بإنشاء رمز مميز باستخدام معرف عميل ل 8cdxxxxxxxxxxxx، يجب إضافة 8cdxxxxxxxxxxxx إلى users.datalake.admins المجموعة.

واجهة برمجة التطبيقات: إعداد>إضافة مستخدم إلى مسؤول DATALAKE

الاسلوب: POST

Screenshot that shows the API that adds user to entitlements.

الحصول على مشروع

استخدم معرف مشروع لإرجاع سجل مشروع Petrel المطابق في Azure Data Manager لمثيل الطاقة.

API: Project>Get Project

الاسلوب: GET

Screenshot that shows the API that gets a project.

حذف مشروع

استخدم معرف مشروع لحذف مشروع وبيانات سجل مشروع Petrel المقترنة في مثيل Azure Data Manager for Energy.

API: Project>Delete Project

الاسلوب: DELETE

Screenshot that shows the API that deletes a project.

الحصول على إصدار مشروع

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

API: Project>Get Project Version

الاسلوب: GET

Screenshot that shows the API that gets a project version.

الحصول على عنوان URL لتنزيل المشروع

استخدم معرف المشروع للحصول على عنوان URL لتوقيع الوصول المشترك (SAS) حتى تتمكن من تنزيل بيانات المشروع المقابل من Azure Data Manager لمثيل الطاقة.

API: Project>Get Project Download

الاسلوب: GET

Screenshot that shows the API that gets a project download URL.

الحصول على عنوان URL لتحميل المشروع

استخدم معرف مشروع للحصول على عنواني URL ل SAS. يقوم عنوان URL واحد بتحميل البيانات إلى المشروع المقابل في Azure Data Manager لمثيل الطاقة. يقوم عنوان URL الآخر بتنزيل البيانات من المشروع المقابل في Azure Data Manager لمثيل الطاقة.

واجهة برمجة التطبيقات: عنوان URL للتحميل الموقع من Project>

الاسلوب: POST

Screenshot that shows the API that gets a project upload URL.

يجب أن يبدو عنوان URL لتحميل SAS مثل هذا المثال:

https://{storage-account}.z15.blob.storage.azure.net/projects/{data-partition-id}/{projectID}.staging/{versionID}?{SAS-token-info}

يمكنك تعديل عنوان URL هذا لاحتواء اسم ملف البيانات التي تريد تحميلها:

https://{storage-account}.z15.blob.storage.azure.net/projects/{data-partition-id}/{projectID}.staging/{versionID}/{FILENAME}?{SAS-token-info}

يؤدي إجراء استدعاء PUT إلى عنوان URL هذا إلى تحميل محتويات body إلى تخزين الكائن الثنائي كبير الحجم ضمن القيمة المتوفرة FILENAME .

تحديث مشروع

استخدم معرف مشروع وعنوان URL لتحميل SAS لتحديث سجل مشروع Petrel في Azure Data Manager for Energy بالقيم الجديدة. يمكنك أيضا تحميل البيانات إلى مشروع إذا أردت ذلك.

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

الاسلوب: PUT

Screenshot that shows the API that updates a project.

البحث من خلال المشاريع

يمكنك البحث من خلال مشاريع Petrel باستخدام العديد من الحقول. ترجع المكالمة جميع معرفات المشروع المطابقة. تدعم واجهة برمجة التطبيقات ما يلي:

  • البحث عن النص الكامل في حقول السلسلة.
  • استعلامات النطاق استنادا إلى حقول التاريخ أو العدد أو السلسلة.
  • البحث الجيوفضائي.

API: Project>Search Projects

الاسلوب: POST

Screenshot that shows the API that deletes a well record.

المحتوى ذو الصلة

استخدم ارتباطات DELFI التالية لقراءة البرامج التعليمية الأخرى التي تتضمن مهام سير عمل Petrel Project Explorer و Petrel: