Bagikan melalui


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

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

Dalam tutorial ini, Anda akan mempelajari cara:

  • Siapkan Postman untuk menggunakan koleksi Wellbore DDMS.
  • Siapkan Postman untuk menggunakan lingkungan Wellbore DDMS.
  • Kirim permintaan melalui Postman.
  • Membuat token otorisasi.
  • Gunakan API DDMS Wellbore untuk bekerja dengan rekaman 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
base_url URL https://<instance>.energy.azure.com
data-partition-id Partisi data <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. Pilih Impor di Postman.

      Screenshot that shows the Import button in Postman.

    2. Tempelkan URL setiap file ke dalam kotak pencarian.

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

  3. Di lingkungan Postman, perbarui Nilai saat ini dengan informasi dari Azure Data Manager untuk detail instans Energy Anda:

    1. Di Postman, di menu sebelah kiri, pilih Lingkungan, lalu pilih Wellbore DDMS 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 Wellbore DDMS environment.

Mengirim contoh permintaan Postman

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

  1. Di Postman, di menu sebelah kiri, pilih Koleksi, lalu pilih Wellbore DDMS. Di bawah Penyetelan, pilih Dapatkan Token SPN.

  2. Di daftar dropdown lingkungan di sudut kanan atas, pilih Wellbore DDMS Environment.

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

  3. Untuk mengirim permintaan, pilih Kirim.

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

  4. Permintaan memvalidasi kode respons API aktual terhadap kode respons yang diharapkan. Pilih tab Hasil Pengujian untuk melihat apakah permintaan berhasil atau gagal.

    Berikut adalah contoh panggilan Postman yang berhasil:

    Screenshot that shows success for a Postman call.

    Berikut adalah contoh panggilan Postman yang gagal:

    Screenshot that shows failure for a Postman call.

Gunakan API DDMS Wellbore untuk bekerja dengan catatan data yang baik

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

Buat tag hukum yang secara otomatis ditambahkan ke lingkungan Wellbore DDMS Anda untuk kepatuhan data.

API: Penyiapan>Buat Tag Hukum untuk WDMS

Metode: POST

Screenshot that shows the API that creates a legal tag.

Untuk informasi selengkapnya, lihat Mengelola tag hukum.

Membuat rekaman dengan baik

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

API: Well>Create Well

Metode: POST

Screenshot that shows the API that creates a well record.

Dapatkan catatan yang baik

Dapatkan data rekaman yang baik untuk instans Azure Data Manager for Energy Anda.

API: Well>by ID

Metode: GET

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

Mendapatkan versi yang baik

Dapatkan versi setiap rekaman yang diserap dengan baik di instans Azure Data Manager for Energy Anda.

API: Versi Yang Baik>

Metode: GET

Screenshot that shows the API that gets all well versions.

Dapatkan versi sumur tertentu

Dapatkan detail versi tertentu untuk catatan sumur tertentu di instans Azure Data Manager for Energy Anda.

API: Versi Khusus yang Baik>

Metode: GET

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

Menghapus rekaman dengan baik

Hapus catatan sumur tertentu dari instans Azure Data Manager for Energy Anda.

API: Bersihkan>Catatan Baik

Metode: DELETE

Screenshot that shows the API that deletes a well record.

Langkah selanjutnya

Baca tutorial berikut untuk mempelajari cara menggunakan alat baris perintah sdutil untuk memuat data seismik ke Seismic Store: