Aracılığıyla paylaş

Öğretici: Bildirim tabanlı dosya alımı gerçekleştirme

  • Makale

Bildirim alımı, bildirimleri Bir Enerji için Azure Data Manager örneğine alma özelliği sağlar.

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

  • Postman kullanarak örnek bildirimleri Bir Enerji için Azure Data Manager örneğine alın.
  • Postman kullanarak bildirim alımı sırasında oluşturulan depolama meta verisi kayıtlarını arayın.

Önkoşullar

Bu öğreticiye başlamadan önce aşağıdaki önkoşulları tamamlayın.

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

  • Enerji için Azure Data Manager örneğine ihtiyacınız vardır. Henüz bir örneğiniz yoksa, Hızlı Başlangıç: Enerji için Azure Data Manager örneği oluşturma bölümünde yer alan adımları izleyerek bir tane oluşturun.

  • Bu öğretici için aşağıdaki parametrelere ihtiyacınız vardır:

    Parametre Kullanılacak değer Örnek Bu değer nerede bulunur?
    CLIENT_ID Uygulama (istemci) kimliği 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Uygulamayı Microsoft kimlik platformu kaydederken bu uygulamayı veya istemci kimliğini kullanırsınız. Bkz . Uygulama kaydetme.
    CLIENT_SECRET İstemci gizli dizileri _fl****************** Bazen uygulama parolası olarak da adlandırılan istemci gizli dizisi, uygulamanızın kendisini kimlik doğrulaması için sertifika yerine kullanabileceği bir dize değeridir. Bkz. İstemci gizli dizisi ekleme.
    TENANT_ID Dizin (kiracı) kimliği 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx Dizin veya kiracı kimliğini almak için Azure portalında hesap adınızın üzerine gelin. Alternatif olarak, Azure portalında Microsoft Entra ID>Özellikleri>Kiracı Kimliği'ni arayın ve seçin.
    SCOPE Uygulama (istemci) kimliği 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Bu değer, daha önce bahsedilen uygulama veya istemci kimliğiyle aynıdır.
    refresh_token Belirteç değerini yenileme 0.ATcA01-XWHdJ0ES-qDevC6r........... Yenileme belirteci oluşturmak ve kaydetmek için Kimlik doğrulama belirteci oluşturma'yı izleyin. Daha sonra bir kullanıcı belirteci oluşturmak için bu yenileme belirtecine ihtiyacınız vardır.
    DNS URI <instance>.energy.Azure.com Bu değeri Enerji için Azure Data Manager örneğinin genel bakış sayfasında bulabilirsiniz.
    data-partition-id Veri bölümleri <instance>-<data-partition-name> Bu değeri Enerji için Azure Data Manager örneğinin genel bakış sayfasında bulabilirsiniz.

Bu öğreticiyi çalıştıran kullanıcıya uygun yetkilendirmeler eklemek için Kullanıcıları yönetme kılavuzunu izleyin.

Postman'i ayarlama ve istekleri yürütme

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

  2. Aşağıdaki dosyaları Postman'a aktarın:

    Postman koleksiyonunu ve ortam değişkenlerini içeri aktarmak için Postman'a veri aktarma başlığındaki adımları izleyin.

  3. Postman ortamı için GÜNCEL DEĞER'i, Enerji için Azure Data Manager örneğinin ayrıntılarında elde ettiğiniz bilgilerle güncelleştirin.

  4. Bildirim alımı için Postman koleksiyonu, sırayla yürütmeniz gereken birden çok istek içerir.

    Postman koleksiyonunu tetiklemeden önce Alma İş Akışı Ortamı'nı seçtiğinizden emin olun.

    Screenshot of the Postman environment.

  5. Gönder düğmesini seçerek her isteği tetikler.

    Postman, her istekte gerçek API yanıt kodunu beklenen yanıt koduna göre doğrular. Uyuşmazlık varsa, test bölümü hataları gösterir.

Başarılı bir Postman isteği örneği aşağıda verilmişti:

Screenshot of a successful Postman call.

Başarısız bir Postman isteği örneği aşağıda verilmişti:

Screenshot of a failed Postman call.

Postman kullanarak örnek bildirimleri alma

Postman koleksiyonunu kullanarak örnek bildirimleri Enerji için Azure Data Manager örneğine almak için aşağıdaki adımları tamamlayın:

  1. Kullanıcı Erişim Belirteci Alma: Daha fazla API çağrısının kimliğini doğrulamak için kullanılacak kullanıcı belirtecini oluşturun.

  2. Yasal Etiket Oluşturma: Veri uyumluluğu amacıyla bildirim verilerine eklenecek bir yasal etiket oluşturun.

  3. Dosyayı karşıya yüklemek için İmzalı URL alma: Bildirim dosyasının karşıya yüklendiği imzalı URL yolunu alın.

  4. Dosya yükleme: Wellbore.csv örneğini yerel makinenize indirin. CSV, LAS veya JSON gibi herhangi bir dosya türü olabilir. Postman'de Dosya Seç düğmesine tıklayarak bu dosyayı seçin.

    Screenshot of uploading a manifest file.

  5. Dosya Meta Verilerini Karşıya Yükle: Dosya konumu ve diğer ilgili alanlar gibi dosya meta verileri bilgilerini karşıya yükleyin.

  6. Meta verilerin başarıyla oluşturulup oluşturulmadığını doğrulamak için Dosya Meta Verileri: Çağrısı'nı alın.

  7. Ana, Başvuru ve İş Ürün Bileşeni (WPC) verilerini alma: Ana, başvuru ve iş ürün bileşeni (WPC) bildirim meta verilerini alın.

  8. Bildirim Alımı İş Akışı durumunu alma: İş akışı başlatılır ve çalışır durumdadır. Durum tamamlanana kadar sorgulamaya devam edin (genellikle 20 -30 saniye).

Postman kullanarak alınan verileri arama

Postman koleksiyonunu kullanarak bildirim alımı sırasında oluşturulan depolama meta veri kayıtlarını aramak için aşağıdaki adımları tamamlayın:

  1. İş Ürünlerini Ara: İş ürünü meta veri kayıtlarını almak için arama hizmetini çağırın.
  2. İş Ürünü Bileşenlerini Ara: WPC meta veri kayıtlarını almak için arama hizmetini çağırın.
  3. Veri Kümesi Ara: Veri kümesi meta veri kayıtlarını almak için arama hizmetini çağırın.
  4. Ana veri arama: Ana meta veri kayıtlarını almak için arama hizmetini çağırın.
  5. Başvuru Verilerini Ara: Başvuru meta veri kayıtlarını almak için arama hizmetini çağırın.

Sonraki adım

Sonraki öğreticiye ilerleyin:

Öğretici: Sismik Depoya veri yüklemek için sdutil kullanma

Bildirim alımı hakkında daha fazla bilgi için bkz . OSDU İşleci Verileri Yükleme Hızlı Başlangıç Kılavuzu.