Oktatóanyag: Well Delivery DDMS API-k használatával végzett adatrekordok kezelése

  • Cikk

Használja a Well Delivery Domain adatkezelés Services (DDMS) API-kat a Postmanben, hogy az Azure Data Manager for Energy példányában jól használható adatokat használjon.

Ebben az oktatóanyagban az alábbiakkal fog megismerkedni:

  • Állítsa be a Postmant egy Well Delivery DDMS-gyűjtemény használatára.
  • Állítsa be a Postmant a Well Delivery DDMS-környezet használatára.
  • Kérések küldése a Postmanen keresztül.
  • Hozzon létre egy engedélyezési jogkivonatot.
  • A Well Delivery DDMS API-kkal jól használható adatrekordokkal dolgozhat.

A DDMS-ről további információt a DDMS-fogalmakban talál.

Előfeltételek

  • Azure-előfizetés
  • Az Azure Data Manager for Energy egy példánya, amelyet az Azure-előfizetésben hoztak létre

Az Azure Data Manager for Energy-példány részleteinek lekérése

Az első lépés a következő információk lekérése az Azure Data Manager for Energy-példányból az Azure Portalon:

Paraméter Érték Példa
CLIENT_ID Alkalmazás (ügyfél) azonosítója 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
CLIENT_SECRET Ügyfél titkos kódja _fl******************
TENANT_ID Címtár (bérlő) azonosítója 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
SCOPE Alkalmazás (ügyfél) azonosítója 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
base_uri URI <instance>.energy.azure.com
data-partition-id Adatpartíciók <instance>-<data-partition-name>

Ezeket az információkat az oktatóanyag későbbi részében fogja használni.

A Postman beállítása

  1. Töltse le és telepítse az asztali Postman alkalmazást.

  2. Importálja a következő fájlokat a Postmanben:

    A fájlok importálása:

    1. Hozzon létre két JSON-fájlt a számítógépen a gyűjteményben és a környezeti fájlokban található adatok másolásával.

    2. A Postmanben válassza a Fájlok>importálása>fájlok kiválasztása lehetőséget, majd válassza ki a két JSON-fájlt a számítógépen.

    3. A Postman Entitások importálása területén válassza az Importálás lehetőséget.

      Screenshot that shows importing collection and environment files in Postman.

  3. A Postman-környezetben frissítse a CURRENT VALUE értéket az Azure Data Manager for Energy-példány adataival:

    1. A Postman bal oldali menüjében válassza a Környezetek, majd a WellDelivery Environment lehetőséget.

    2. Az AKTUÁLIS ÉRTÉK oszlopban adja meg az oktatóanyag Az Azure Data Manager for Energy-példány adatainak lekérése szakaszában található táblázat adatait.

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

Postman-kérés küldése

A Well Delivery DDMS Postman-gyűjteménye olyan kéréseket tartalmaz, amelyekkel kezelheti az Azure Data Manager for Energy-példányban lévő kutak, kútfúrások, kútnaplók és kútnaplók adatait.

A Postman-kérések küldésére vonatkozó példát a Wellbore DDMS oktatóanyagában talál.

Jogkivonat létrehozása API-khoz

Hozzon létre egy jogkivonatot, amellyel a Well Delivery DDMS API-kkal dolgozhat:

  1. Importálja a következő cURL-parancsot a Postmanben egy tulajdonosi jogkivonat létrehozásához. Használja az Azure Data Manager for Energy-példány értékeit.

     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. A tokenkimenettel frissíthet access_token a Well Delivery DDMS-környezetben. Ezt követően a tulajdonosi jogkivonatot más API-hívások engedélyezési típusaként használhatja.

Well Delivery DDMS API-k használata a jól használható adatrekordok kezeléséhez

Az alábbi Well Delivery DDMS API-kban leírt Postman-kérések sikeres végrehajtása azt jelzi, hogy az Azure Data Manager for Energy-példányban sikeres volt a kútrekordok betöltése és lekérése.

Kútrekord létrehozása

Hozzon létre egy jól rögzített rekordot az Azure Data Manager for Energy-példányban.

API: UC1>entity_create jól

Módszer: PUT

Screenshot that shows the API that creates a well record.

Kútfúrási rekord létrehozása

Hozzon létre egy wellbore rekordot az Azure Data Manager for Energy-példányban.

API: UC1>entity_create kútfúrás

Módszer: PUT

Screenshot that shows the API that creates a wellbore record.

Kútverzió lekérése

Kútrekord lekérése egy adott kútazonosító alapján.

API: UC1>entity_create is Copy

Módszer: GET

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

Tevékenységterv létrehozása

Tevékenységterv létrehozása.

API: UC1>entity_create activityplan

Módszer: PUT

Screenshot that shows the API that creates an activity plan.

Tevékenységterv lekérése kútazonosító alapján

Szerezze be a tevékenységterv objektumát egy adott kútazonosítóhoz.

API: UC2>activity_plans_by_well

Módszer: GET

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

Wellbore rekord törlése

Well Delivery DDMS API-k használatával törölheti a wellbore rekordot az Azure Data Manager for Energy-példányban. Az alábbi képernyőképen egy példa látható.

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

Kútrekord törlése

A Well Delivery DDMS API-k használatával törölheti a well delivery DDMS API-kat az Azure Data Manager for Energy-példányban. Az alábbi képernyőképen egy példa látható.

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

Következő lépések

A következő oktatóanyagban megtudhatja, hogyan használhatja a wellbore DDMS API-kat a wellbore-beli DDMS API-k használatával:

Oktatóanyag: A well data records használata Wellbore DDMS API-k használatával