Bagikan melalui

Tutorial: Bekerja dengan catatan data yang baik dengan menggunakan API DDMS Pengiriman Yang Baik

  • Artikel

Gunakan API Well Delivery Domain Data Management Services (DDMS) di Postman untuk bekerja dengan baik dalam instans Azure Data Manager for Energy Anda.

Dalam tutorial ini, Anda akan mempelajari cara:

  • Siapkan Postman untuk menggunakan koleksi Well Delivery DDMS.
  • Siapkan Postman untuk menggunakan lingkungan Well Delivery DDMS.
  • Kirim permintaan melalui Postman.
  • Membuat token otorisasi.
  • Gunakan WELL Delivery DDMS API untuk bekerja dengan catatan data yang baik.

Untuk informasi selengkapnya tentang DDMS, lihat konsep DDMS.

Prasyarat

Mendapatkan detail instans Azure Data Manager for Energy Anda

Langkah pertama adalah mendapatkan informasi berikut dari instans Azure Data Manager for Energy Anda di portal Azure:

Parameter Value Contoh
CLIENT_ID Aplikasi (ID klien) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
CLIENT_SECRET Rahasia klien _fl******************
TENANT_ID ID (tenant) direktori 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
SCOPE Aplikasi (ID klien) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
base_uri URI <instance>.energy.azure.com
data-partition-id Partisi data <instance>-<data-partition-name>

Anda akan menggunakan informasi ini nanti dalam tutorial.

Menyiapkan Postman

  1. Unduh dan instal aplikasi desktop Postman .

  2. Impor file berikut di Postman:

    Untuk mengimpor file:

    1. Buat dua file JSON di komputer Anda dengan menyalin data yang ada di file koleksi dan lingkungan.

    2. Di Postman, pilih Impor>File>Pilih File, lalu pilih dua file JSON di komputer Anda.

    3. Di Impor Entitas di Postman, pilih Impor.

      Screenshot that shows importing collection and environment files in Postman.

  3. Di lingkungan Postman, perbarui NILAI SAAT INI dengan informasi dari instans Azure Data Manager for Energy Anda:

    1. Di Postman, di menu sebelah kiri, pilih Lingkungan, lalu pilih WellDelivery Environment.

    2. Di kolom NILAI SAAT INI, masukkan informasi dari tabel di bagian Dapatkan detail instans Azure Data Manager for Energy Anda di tutorial ini.

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

Mengirim permintaan Postman

Koleksi Postman untuk Well Delivery DDMS berisi permintaan yang dapat Anda gunakan untuk berinteraksi dengan data tentang wells, wellbores, well log, dan well trajectory di Instans Azure Data Manager for Energy Anda.

Untuk contoh cara mengirim permintaan Postman, lihat tutorial Wellbore DDMS.

Membuat token untuk API

Buat token yang dapat Anda gunakan untuk bekerja dengan API DDMS Pengiriman Sumur:

  1. Impor perintah cURL berikut di Postman untuk menghasilkan token pembawa. Gunakan nilai dari Instans Azure Data Manager for Energy Anda.

     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. Gunakan output token untuk memperbarui access_token di lingkungan Well Delivery DDMS Anda. Kemudian, Anda dapat menggunakan token pembawa sebagai jenis otorisasi dalam panggilan API lainnya.

Gunakan API DDMS Pengiriman Dengan Baik untuk bekerja dengan catatan data yang baik

Berhasil menyelesaikan permintaan Postman yang dijelaskan dalam API DDMS Well Delivery berikut menunjukkan keberhasilan penyerapan dan pengambilan rekaman sumur di Instans Azure Data Manager for Energy Anda.

Membuat rekaman dengan baik

Buat catatan yang baik di Instans Azure Data Manager for Energy Anda.

API: UC1>entity_create dengan baik

Metode: PUT

Screenshot that shows the API that creates a well record.

Membuat catatan wellbore

Buat catatan wellbore di Instans Azure Data Manager for Energy Anda.

API: UC1>entity_create wellbore

Metode: PUT

Screenshot that shows the API that creates a wellbore record.

Dapatkan versi yang baik

Dapatkan catatan yang baik berdasarkan ID sumur tertentu.

API: UC1>entity_create baik Salin

Metode: GET

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

Membuat rencana aktivitas

Buat rencana aktivitas.

API: UC1>entity_create activityplan

Metode: PUT

Screenshot that shows the API that creates an activity plan.

Dapatkan rencana aktivitas dengan ID yang baik

Dapatkan objek rencana aktivitas untuk ID sumur tertentu.

API: UC2>activity_plans_by_well

Metode: GET

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

Menghapus catatan wellbore

Anda dapat menghapus catatan wellbore di instans Azure Data Manager for Energy dengan menggunakan API DDMS Well Delivery. Cuplikan layar berikut ini menampilkan sebuah contoh.

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

Menghapus rekaman dengan baik

Anda dapat menghapus catatan dengan baik di instans Azure Data Manager for Energy dengan menggunakan API DDMS Well Delivery. Cuplikan layar berikut ini menampilkan sebuah contoh.

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

Langkah berikutnya

Buka tutorial berikutnya untuk mempelajari cara bekerja dengan data yang baik dengan menggunakan API DDMS Wellbore:

Tutorial: Bekerja dengan catatan data yang baik dengan menggunakan API Wellbore DDMS