Sdílet prostřednictvím

Kurz: Práce s datovými záznamy s využitím rozhraní API Well Delivery DDMS

  • Článek

Pomocí rozhraní API služby Well Delivery Domain Správa dat Services (DDMS) v Postmanu můžete pracovat s dobře dostupnými daty ve vaší instanci Azure Data Manageru pro energii.

V tomto kurzu se naučíte:

  • Nastavte Postman pro použití kolekce Well Delivery DDMS.
  • Nastavte Postman pro použití prostředí Well Delivery DDMS.
  • Odešlete žádosti přes Postman.
  • Vygenerujte autorizační token.
  • K práci s dobře datovými záznamy použijte rozhraní API DDMS Pro doručování.

Další informace o DDMS najdete v tématu Koncepty DDMS.

Požadavky

  • Předplatné Azure
  • Instance Azure Data Manageru pro energii vytvořená ve vašem předplatném Azure

Získání podrobností o instanci energie v Azure Data Manageru

Prvním krokem je získání následujících informací z instance Azure Data Manageru pro energii na webu Azure Portal:

Parametr Hodnota Příklad
CLIENT_ID ID aplikace (klienta) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
CLIENT_SECRET Tajné kódy klienta _fl******************
TENANT_ID ID adresáře (klienta) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
SCOPE ID aplikace (klienta) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
base_uri Identifikátor URI <instance>.energy.azure.com
data-partition-id Datové oddíly <instance>-<data-partition-name>

Tyto informace použijete později v tomto kurzu.

Nastavení nástroje Postman

  1. Stáhněte a nainstalujte desktopovou aplikaci Postman .

  2. Naimportujte následující soubory v Nástroji Postman:

    Import souborů:

    1. Ve svém počítači vytvořte dva soubory JSON zkopírováním dat, která jsou v kolekci a souborech prostředí.

    2. V nástroji Postman vyberte Importovat>soubory Zvolit soubory> a pak na počítači vyberte dva soubory JSON.

    3. V nástroji Import Entities in Postman (Importovat entity v nástroji Postman) vyberte Importovat.

      Screenshot that shows importing collection and environment files in Postman.

  3. V prostředí Postman aktualizujte AKTUÁLNÍ HODNOTU informacemi z azure Data Manageru pro instanci energie:

    1. V nástroji Postman v nabídce vlevo vyberte Prostředí a pak vyberte WellDelivery Environment.

    2. Ve sloupci CURRENT VALUE zadejte informace z tabulky v části Získání Azure Data Manageru pro podrobnosti o instanci energie v tomto kurzu.

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

Odeslání požadavku Postman

Kolekce Postman pro Well Delivery DDMS obsahuje požadavky, které můžete použít k interakci s daty o wells, wellbores, wellbores, dobře protokoly a dobře trajektorií ve vaší instanci Azure Data Manageru pro energii.

Příklad odeslání požadavku Postman najdete v kurzu Wellbore DDMS.

Generování tokenu pro rozhraní API

Vygenerujte token, který můžete použít pro práci s rozhraními API Well Delivery DDMS:

  1. Naimportujte následující příkaz cURL v Nástroji Postman a vygenerujte nosný token. Použijte hodnoty z vaší instance Azure Data Manageru pro energii.

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

    Screenshot of cURL code in a Well Delivery DDMS token.

  2. Pomocí výstupu tokenu aktualizujte access_token v prostředí Well Delivery DDMS. Nosný token pak můžete použít jako autorizační typ v jiných voláních rozhraní API.

Použití rozhraní API DDMS pro doručování pro práci s dobře uloženými datovými záznamy

Úspěšné dokončení požadavků Postman popsaných v následujících rozhraních API well delivery DDMS indikuje úspěšné ingestování a načítání záznamů v instanci Azure Data Manageru pro energii.

Vytvoření záznamu dobře

Vytvořte záznam dobře v instanci Azure Data Manageru pro energii.

ROZHRANÍ API: UC1>entity_create dobře

Metoda: PUT

Screenshot that shows the API that creates a well record.

Vytvoření záznamu wellbore

Vytvořte záznam wellbore v instanci Azure Data Manageru pro energii.

ROZHRANÍ API: UC1>entity_create wellbore

Metoda: PUT

Screenshot that shows the API that creates a wellbore record.

Získání dobře známé verze

Získejte záznam o kontejneru na základě konkrétního ID kontejneru.

ROZHRANÍ API: UC1>entity_create dobře kopírovat

Metoda: GET

Screenshot that shows the API that gets a well record based on a specific well ID.

Vytvoření plánu aktivit

Vytvořte plán aktivit.

ROZHRANÍ API: PLÁN aktivity UC1>entity_create

Metoda: PUT

Screenshot that shows the API that creates an activity plan.

Získání plánu aktivit podle ID kontejneru

Získejte objekt plánu aktivity pro konkrétní ID kontejneru.

ROZHRANÍ API: UC2>activity_plans_by_well

Metoda: GET

Screenshot of the API that gets an activity plan by well ID.

Odstranění záznamu wellbore

Záznam wellbore můžete odstranit v instanci Azure Data Manageru pro energii pomocí rozhraní API Well Delivery DDMS. Následující snímek obrazovky ukazuje příklad.

Screenshot that shows how to use an API to delete a wellbore record.

Odstranění záznamu kontejneru

Pomocí rozhraní API Well Delivery DDMS můžete odstranit záznam ve svém Azure Data Manageru pro energii. Následující snímek obrazovky ukazuje příklad.

Screenshot that shows how to use an API to delete a well record.

Další kroky

V dalším kurzu se dozvíte, jak pracovat s daty pomocí rozhraní API Wellbore DDMS:

Kurz: Práce s datovými záznamy pomocí rozhraní API Wellbore DDMS