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

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

In deze zelfstudie leert u het volgende:

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

Zie DDMS-concepten voor meer informatie over DDMS.

Vereisten

• Een Azure-abonnement
• Een exemplaar van Azure Data Manager for Energy dat is gemaakt in uw Azure-abonnement

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	00001111-aaaa-2222-bbbb-3333cccc4444
CLIENT_SECRET	Clientgeheimen	_fl******************
TENANT_ID	Id van directory (tenant)	72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
SCOPE	Client-id van toepassing	00001111-aaaa-2222-bbbb-3333cccc4444
base_uri	URI	<instance>.energy.azure.com
data-partition-id	Gegevenspartities	<instance>-<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:

   • Well Delivery DDMS Postman collectie
   • Well Delivery DDMS Postman-omgeving

   De bestanden importeren:

   1. Maak twee JSON-bestanden op uw computer door de gegevens in de verzameling en omgevingsbestanden te kopiëren.

   2. Selecteer in Postman Import>Files>Choose Files en selecteer vervolgens de twee JSON-bestanden op uw computer.

   3. Selecteer Importeren in Entiteiten importeren in Postman.

      

3. Werk in de Postman-omgeving CURRENT VALUE bij met de informatie van uw Azure Data Manager for Energy-exemplaar:

   1. Selecteer in Postman in het linkermenu Omgevingen en selecteer Vervolgens WellDelivery Environment.

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

   

Een Postman-aanvraag verzenden

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

Zie de zelfstudie Wellbore DDMS voor een voorbeeld van het verzenden van een Postman-aanvraag.

Een token genereren voor API's

Genereer een token dat u kunt gebruiken om te werken met Well Delivery DDMS-API's:

1. Importeer de volgende cURL-opdracht in Postman om een bearer-token te genereren. Gebruik de waarden van uw Azure Data Manager for Energy-exemplaar.

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

   

2. Gebruik de tokenuitvoer om bij te werken access_token in uw Well Delivery DDMS-omgeving. Vervolgens kunt u het Bearer-token gebruiken als autorisatietype in andere API-aanroepen.

Well Delivery DDMS-API's gebruiken om te werken met brongegevensrecords

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

Een bronrecord maken

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

API: UC1>entity_create bron

Methode: PUT

Een wellbore-record maken

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

API: UC1>entity_create wellbore

Methode: PUT

Een goed versie downloaden

Haal een bronrecord op op basis van een specifieke bron-id.

API: UC1>entity_create well Copy

Methode: GET

Een activiteitenplan maken

Maak een activiteitenplan.

API: UC1>entity_create activityplan

Methode: PUT

Een activiteitenplan ophalen op bron-id

Haal het activiteitsplanobject op voor een specifieke bron-id.

API: UC2>activity_plans_by_well

Methode: GET

Een wellbore-record verwijderen

U kunt een bronrecord in uw Azure Data Manager for Energy-exemplaar verwijderen met behulp van Well Delivery DDMS-API's. In de volgende schermopname ziet u een voorbeeld.

Een bronrecord verwijderen

U kunt een bronrecord in uw Exemplaar van Azure Data Manager for Energy verwijderen met behulp van Well Delivery DDMS-API's. In de volgende schermopname ziet u een voorbeeld.

Volgende stappen

Ga naar de volgende zelfstudie voor meer informatie over het werken met brongegevens met behulp van Wellbore DDMS-API's:

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