Aracılığıyla paylaş


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

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 00001111-aaaa-2222-bbbb-3333cccc4444
CLIENT_SECRET İstemci gizli dizileri _fl******************
TENANT_ID Dizin (kiracı) kimliği 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
SCOPE Uygulama (istemci) kimliği 00001111-aaaa-2222-bbbb-3333cccc4444
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.

      Koleksiyon ve ortam dosyalarını içeri aktarmayı gösteren ekran görüntüsü.

  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.

    Well Delivery DDMS ortamında geçerli değerlerin girileceği yeri gösteren ekran görüntüsü.

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}}'  
    

    Well Delivery DDMS belirtecindeki cURL kodunun ekran görüntüsü.

  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

İyi bir kayıt oluşturan API'yi gösteren ekran görüntüsü.

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

Wellbore kaydı oluşturan API'yi gösteren ekran görüntüsü.

İ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

Belirli bir kuyu kimliğine göre iyi bir kayıt alan API'yi gösteren ekran görüntüsü.

Etkinlik planı oluşturma

Etkinlik planı oluşturma.

API: UC1>entity_create etkinlik planı

Yöntem: PUT

Etkinlik planı oluşturan API'yi gösteren ekran görüntüsü.

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

Well Id'ye göre etkinlik planı alan API'nin ekran görüntüsü.

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.

Wellbore kaydını silmek için API'nin nasıl kullanılacağını gösteren ekran görüntüsü.

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.

İyilik kaydını silmek için API'nin nasıl kullanılacağını gösteren ekran görüntüsü.

Sonraki adımlar

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