Share via


Zelfstudie: Werken met brongegevensrecords met behulp van Wellbore DDMS-API's

Gebruik DDMS-API's (Wellbore Domain Gegevensbeheer Services) in Postman om te werken met brongegevens in uw exemplaar van Azure Data Manager for Energy.

In deze zelfstudie leert u het volgende:

  • Stel Postman in voor het gebruik van een Wellbore DDMS-verzameling.
  • Stel Postman in voor het gebruik van een Wellbore DDMS-omgeving.
  • Verzend aanvragen via Postman.
  • Genereer een autorisatietoken.
  • Gebruik Wellbore DDMS-API's om te werken met brongegevensrecords.

Zie DDMS-concepten voor meer informatie over DDMS.

Vereisten

De details van uw Azure Data Manager for Energy-exemplaar ophalen

De eerste stap is het ophalen van de volgende informatie uit uw Azure Data Manager for Energy-exemplaar in Azure Portal:

Parameter Weergegeven als Opmerking
client_id Client-id van toepassing 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
client_secret Clientgeheimen _fl******************
tenant_id Id van directory (tenant) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
base_url URL https://<instance>.energy.azure.com
data-partition-id Gegevenspartities <data-partition-name>

U gebruikt deze informatie verderop in de zelfstudie.

Postman instellen

  1. Download en installeer de Postman-bureaublad-app .

  2. Importeer de volgende bestanden in Postman:

    De bestanden importeren:

    1. Selecteer Importeren in Postman.

      Screenshot that shows the Import button in Postman.

    2. Plak de URL van elk bestand in het zoekvak.

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

  3. Werk in de Postman-omgeving de huidige waarde bij met de informatie van uw Azure Data Manager for Energy-exemplaargegevens:

    1. Selecteer in Postman in het linkermenu Omgevingen en selecteer vervolgens Wellbore DDMS Environment.

    2. Voer in de kolom Huidige waarde de gegevens uit de tabel in in de sectie Details van uw Azure Data Manager for Energy-exemplaar ophalen van deze zelfstudie.

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

Een voorbeeld van een Postman-aanvraag verzenden

De Postman-verzameling voor Wellbore DDMS bevat aanvragen die u kunt gebruiken om te communiceren met gegevens over wells, wellbores, well logs en een goed traject in uw Azure Data Manager for Energy-exemplaar.

  1. Selecteer In Postman in het linkermenu Verzamelingen en selecteer vervolgens Wellbore DDMS. Selecteer onder Setup een SPN-token ophalen.

  2. Selecteer Wellbore DDMS Environment in de vervolgkeuzelijst omgeving in de rechterbovenhoek.

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

  3. Selecteer Verzenden om de aanvraag te verzenden.

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

  4. De aanvraag valideert de werkelijke API-antwoordcode op basis van de verwachte antwoordcode. Selecteer het tabblad Testresultaten om te zien of de aanvraag is geslaagd of mislukt.

    Hier volgt een voorbeeld van een geslaagde Postman-aanroep:

    Screenshot that shows success for a Postman call.

    Hier volgt een voorbeeld van een mislukte Postman-aanroep:

    Screenshot that shows failure for a Postman call.

Wellbore DDMS-API's gebruiken om te werken met brongegevensrecords

Het voltooien van de Postman-aanvragen die worden beschreven in de volgende Wellbore DDMS-API's geeft aan dat het opnemen en ophalen van bronrecords in uw Azure Data Manager for Energy-exemplaar is geslaagd.

Maak een juridische tag die automatisch wordt toegevoegd aan uw Wellbore DDMS-omgeving voor gegevenscompatibiliteit.

API: Juridische tag maken voor WDMS instellen>

Methode: POST

Screenshot that shows the API that creates a legal tag.

Zie Juridische tags beheren voor meer informatie.

Een bronrecord maken

Maak een bronrecord in uw Azure Data Manager for Energy-exemplaar.

API: Well>Create Well

Methode: POST

Screenshot that shows the API that creates a well record.

Een goede record ophalen

Haal de brongegevens voor uw Azure Data Manager for Energy-exemplaar op.

API: Well>by ID

Methode: GET

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

Goed presterende versies

Haal de versies van elke opgenomen bronrecord op in uw Azure Data Manager for Energy-exemplaar.

API: Bronversies>

Methode: GET

Screenshot that shows the API that gets all well versions.

Een specifieke bronversie ophalen

Haal de details op van een specifieke versie voor een specifieke bronrecord in uw Exemplaar van Azure Data Manager for Energy.

API: Well Well>Specific Version

Methode: GET

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

Een bronrecord verwijderen

Verwijder een specifieke bronrecord uit uw Azure Data Manager for Energy-exemplaar.

API: Bronrecord opschonen>

Methode: DELETE

Screenshot that shows the API that deletes a well record.

Volgende stap

Lees de volgende zelfstudie voor meer informatie over het gebruik van het opdrachtregelprogramma sdutil om seismische gegevens te laden in Seismic Store: