Dela via

Självstudie: Arbeta med väldataposter med hjälp av DDMS-API:er för well delivery

  • Artikel

Använd DDMS-API:er (Well Delivery Domain Datahantering Services) i Postman för att arbeta med bra data i din instans av Azure Data Manager for Energy.

I den här självstudien lär du dig att:

  • Konfigurera Postman för att använda en DDMS-samling för brunnsleverans.
  • Konfigurera Postman för att använda en DDMS-miljö för brunnsleverans.
  • Skicka begäranden via Postman.
  • Generera en auktoriseringstoken.
  • Använd DDMS-API:er för brunnsleverans för att arbeta med väldataposter.

Mer information om DDMS finns i DDMS-begrepp.

Förutsättningar

Hämta information om Azure Data Manager for Energy-instansen

Det första steget är att hämta följande information från din Azure Data Manager for Energy-instans i Azure Portal:

Parameter Värde Exempel
CLIENT_ID App-ID (klient-ID) 00001111-aaaa-2222-bbbb-3333cccc4444
CLIENT_SECRET Klienthemligheter _fl******************
TENANT_ID Katalog-ID (klientorganisation) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
SCOPE App-ID (klient-ID) 00001111-aaaa-2222-bbbb-3333cccc4444
base_uri URI <instance>.energy.azure.com
data-partition-id Datapartitioner <instance>-<data-partition-name>

Du använder den här informationen senare i självstudien.

Konfigurera Postman

  1. Ladda ned och installera Postman-skrivbordsappen.

  2. Importera följande filer i Postman:

    Så här importerar du filerna:

    1. Skapa två JSON-filer på datorn genom att kopiera data som finns i samlingen och miljöfilerna.

    2. I Postman väljer du Importera>filer>Välj filer och sedan de två JSON-filerna på datorn.

    3. I Importera entiteter i Postman väljer du Importera.

      Skärmbild som visar import av samlings- och miljöfiler.

  3. I Postman-miljön uppdaterar du AKTUELLT VÄRDE med informationen från din Azure Data Manager for Energy-instans:

    1. I Postman går du till den vänstra menyn och väljer Miljöer och sedan WellDelivery Environment.

    2. I kolumnen AKTUELLT VÄRDE anger du informationen från tabellen i avsnittet Hämta information om Azure Data Manager for Energy-instansen i den här självstudien.

    Skärmbild som visar var du anger aktuella värden i DDMS-miljön för brunnsleverans.

Skicka en Postman-begäran

Postman-samlingen för DDMS för brunnsleverans innehåller begäranden som du kan använda för att interagera med data om brunnar, wellbores, brunnsloggar och brunnsbana i din Azure Data Manager for Energy-instans.

Ett exempel på hur du skickar en Postman-begäran finns i självstudiekursen om Wellbore DDMS.

Generera en token för API:er

Generera en token som du kan använda för att arbeta med DDMS-API:er för well delivery:

  1. Importera följande cURL-kommando i Postman för att generera en ägartoken. Använd värdena från din Azure Data Manager for Energy-instans.

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

    Skärmbild av cURL-kod i en DDMS-token för brunnsleverans.

  2. Använd tokenutdata för att uppdatera access_token i din DDMS-miljö för brunnsleverans. Sedan kan du använda ägartoken som auktoriseringstyp i andra API-anrop.

Använda DDMS-API:er för well delivery för att arbeta med väldataposter

Att slutföra Postman-begäranden som beskrivs i följande DDMS-API:er för brunnsleverans indikerar lyckad inmatning och hämtning av brunnsposter i din Azure Data Manager for Energy-instans.

Skapa en brunnspost

Skapa en brunnspost i din Azure Data Manager for Energy-instans.

API: UC1>entity_create bra

Metod: PUT

Skärmbild som visar API:et som skapar en brunnspost.

Skapa en wellbore-post

Skapa en wellbore-post i din Azure Data Manager for Energy-instans.

API: UC1>entity_create wellbore

Metod: PUT

Skärmbild som visar API:et som skapar en wellbore-post.

Hämta en bra version

Hämta en brunnspost baserat på ett specifikt brunns-ID.

API: UC1>entity_create väl kopiera

Metod: GET

Skärmbild som visar API:et som hämtar en brunnspost baserat på ett specifikt brunns-ID.

Skapa en aktivitetsplan

Skapa en aktivitetsplan.

API: UC1>entity_create activityplan

Metod: PUT

Skärmbild som visar API:et som skapar en aktivitetsplan.

Hämta en aktivitetsplan efter väl-ID

Hämta aktivitetsplanobjektet för ett specifikt brunns-ID.

API: UC2>activity_plans_by_well

Metod: GET

Skärmbild av API:et som hämtar en aktivitetsplan efter väl-ID.

Ta bort en wellbore-post

Du kan ta bort en wellbore-post i din Azure Data Manager for Energy-instans med hjälp av DDMS-API:er för well delivery. Följande skärmbild visar ett exempel.

Skärmbild som visar hur du använder ett API för att ta bort en wellbore-post.

Ta bort en brunnspost

Du kan ta bort en brunnspost i din Azure Data Manager for Energy-instans med hjälp av DDMS-API:er för well delivery. Följande skärmbild visar ett exempel.

Skärmbild som visar hur du använder ett API för att ta bort en brunnspost.

Nästa steg

Gå till nästa självstudie för att lära dig hur du arbetar med bra data med hjälp av Wellbore DDMS-API:er:

Självstudie: Arbeta med bra dataposter med hjälp av Wellbore DDMS-API:er