Aracılığıyla paylaş

Öğretici: Well Delivery DDMS API'lerini kullanarak iyi veri kayıtlarıyla çalışma

  • Makale

Enerji için Azure Data Manager örneğinizdeki iyi verilerle çalışmak için Postman'daki Well Delivery Domain Veri Yönetimi Services (DDMS) API'lerini kullanın.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

  • Postman'i Well Delivery DDMS koleksiyonunu kullanacak şekilde ayarlayın.
  • Postman'i Well Delivery DDMS ortamını kullanacak şekilde ayarlayın.
  • Postman aracılığıyla istek gönderin.
  • Yetkilendirme belirteci oluşturun.
  • İyi veri kayıtlarıyla çalışmak için Well Delivery DDMS API'lerini kullanın.

DDMS hakkında daha fazla bilgi için bkz . DDMS kavramları.

Önkoşullar

Enerji için Azure Data Manager örneğinizin ayrıntılarını alma

İlk adım, Azure portalında Enerji için Azure Data Manager örneğinizden aşağıdaki bilgileri almaktır:

Parametre Value Örnek
CLIENT_ID Uygulama (istemci) kimliği 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
CLIENT_SECRET İstemci gizli dizileri _fl******************
TENANT_ID Dizin (kiracı) kimliği 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
SCOPE Uygulama (istemci) kimliği 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
base_uri URI <instance>.energy.azure.com
data-partition-id Veri bölümleri <instance>-<data-partition-name>

Bu bilgileri öğreticinin ilerleyen bölümlerinde kullanacaksınız.

Postman’i ayarlama

  1. Postman masaüstü uygulamasını indirin ve yükleyin.

  2. Postman'da aşağıdaki dosyaları içeri aktarın:

    Dosyaları içeri aktarmak için:

    1. Koleksiyon ve ortam dosyalarındaki verileri kopyalayarak bilgisayarınızda iki JSON dosyası oluşturun.

    2. Postman'de Dosyaları >İçeri Aktar>Dosya Seç'i ve ardından bilgisayarınızdaki iki JSON dosyasını seçin.

    3. Postman'de Varlıkları İçeri Aktar'da İçeri Aktar'ı seçin.

      Screenshot that shows importing collection and environment files in Postman.

  3. Postman ortamında CURRENT VALUE değerini Enerji için Azure Data Manager örneğinizdeki bilgilerle güncelleştirin:

    1. Postman'de, soldaki menüde Ortamlar'ı ve ardından WellDelivery Ortamı'nı seçin.

    2. GÜNCEL DEĞER sütununda, bu öğreticinin Enerji için Azure Data Manager örneği ayrıntılarını alma bölümündeki tablodan bilgileri girin.

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

Postman isteği gönderme

Well Delivery DDMS için Postman koleksiyonu, Enerji için Azure Data Manager örneğinizdeki kuyular, kuyular, kuyu günlükleri ve iyi yörünge hakkındaki verilerle etkileşimde bulunmak için kullanabileceğiniz istekler içerir.

Postman isteği gönderme örneği için Wellbore DDMS öğreticisine bakın.

API'ler için belirteç oluşturma

Well Delivery DDMS API'leriyle çalışmak için kullanabileceğiniz bir belirteç oluşturun:

  1. Taşıyıcı belirteci oluşturmak için Postman'da aşağıdaki cURL komutunu içeri aktarın. Enerji için Azure Data Manager örneğinizdeki değerleri kullanın.

     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. Well Delivery DDMS ortamınızda güncelleştirmek access_token için belirteç çıkışını kullanın. Ardından taşıyıcı belirtecini diğer API çağrılarında yetkilendirme türü olarak kullanabilirsiniz.

İyi veri kayıtlarıyla çalışmak için Well Delivery DDMS API'lerini kullanma

Aşağıdaki Well Delivery DDMS API'lerinde açıklanan Postman isteklerinin başarıyla tamamlanması, Enerji için Azure Data Manager örneğinizdeki well kayıtlarının başarıyla alındığını ve alındığını gösterir.

İyi kayıt oluşturma

Enerji için Azure Data Manager örneğinizde iyi bir kayıt oluşturun.

API: UC1>iyi entity_create

Yöntem: PUT

Screenshot that shows the API that creates a well record.

wellbore kaydı oluşturma

Enerji için Azure Data Manager örneğinizde bir wellbore kaydı oluşturun.

API: UC1>entity_create wellbore

Yöntem: PUT

Screenshot that shows the API that creates a wellbore record.

İyi bir sürüm edinin

Belirli bir kuyu kimliğine göre iyi bir kayıt alın.

API: UC1>entity_create well Copy

Yöntem: GET

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

Etkinlik planı oluşturma

Etkinlik planı oluşturma.

API: UC1>entity_create etkinlik planı

Yöntem: PUT

Screenshot that shows the API that creates an activity plan.

Well ID'ye göre etkinlik planı alma

Belirli bir kuyu kimliği için etkinlik planı nesnesini alın.

API: UC2>activity_plans_by_well

Yöntem: GET

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

Wellbore kaydını silme

Well Delivery DDMS API'lerini kullanarak Enerji için Azure Data Manager örneğinizdeki bir wellbore kaydını silebilirsiniz. Aşağıdaki ekran görüntüsünde bir örnek gösterilmektedir.

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

Kuyu kaydını silme

Well Delivery DDMS API'lerini kullanarak Enerji için Azure Data Manager örneğinizdeki bir kuyu kaydını silebilirsiniz. Aşağıdaki ekran görüntüsünde bir örnek gösterilmektedir.

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

Sonraki adımlar

Wellbore DDMS API'lerini kullanarak iyi verilerle çalışmayı öğrenmek için sonraki öğreticiye gidin:

Öğretici: Wellbore DDMS API'lerini kullanarak iyi veri kayıtlarıyla çalışma