Compartir a través de


Tutorial: Uso de registros de datos correctos mediante las API de DDMS de Well Delivery

Use las API de Well Delivery Domain Data Management Services (DDMS) en Postman para trabajar con los datos de pozos de su instancia de Azure Data Manager for Energy.

En este tutorial, aprenderá a:

  • Configurar Postman para usar una colección DDMS de Well Delivery.
  • Configurar Postman para usar un entorno DDMS de Well Delivery.
  • Enviar solicitudes a través de Postman.
  • Generar un token de autorización.
  • Utilizar las API de DDMS de Well Delivery para trabajar con registros de datos de Well.

Para más información sobre DDMS, consulte Conceptos de DDMS.

Requisitos previos

Obtener los detalles de la instancia de Azure Data Manager for Energy

El primer paso es obtener la siguiente información de la instancia de Azure Data Manager for Energy en Azure Portal:

Parámetro Valor Ejemplo
CLIENT_ID Id. de aplicación (cliente) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
CLIENT_SECRET Secretos de cliente _fl******************
TENANT_ID Id. de directorio (inquilino) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
SCOPE Id. de aplicación (cliente) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
base_uri URI <instance>.energy.azure.com
data-partition-id Particiones de datos <instance>-<data-partition-name>

Esta información se usará más adelante en el tutorial.

Configuración de Postman

  1. Descargue e instale la aplicación de escritorio Postman.

  2. Importe los archivos siguientes a Postman:

    Para importar los archivos:

    1. Cree dos archivos JSON en el equipo copiando los datos que se incluyen en los archivos de la colección y el entorno.

    2. En Postman, seleccione Importar>Archivos>Elegir archivos y, a continuación, seleccione los dos archivos JSON en el equipo.

    3. En Importar entidades en Postman, seleccione Importar.

      Screenshot that shows importing collection and environment files in Postman.

  3. En el entorno de Postman, actualice CURRENT VALUE con la información de la instancia de Azure Data Manager for Energy:

    1. En Postman, en el menú de la izquierda, seleccione Entornos y, a continuación, seleccione WellDelivery Environment ( Entorno de entrega).

    2. En la columna CURRENT VALUE, escriba la información de la tabla en la sección Obtención de los detalles de la instancia de Azure Data Manager for Energy de este tutorial.

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

Envío de una solicitud de Postman

La colección de Postman para Well Delivery DDMS contiene solicitudes que puede usar para interactuar con datos sobre pozos, recintos de pozos, registros de pozos y trayectoria de pozos en la instancia de Azure Data Manager for Energy.

Para obtener un ejemplo de cómo enviar una solicitud de Postman, consulte el tutorial de DDMS de Wellbore.

Generación de un token para API

Genere un token que puede usar para trabajar con las API de DDMS de Well Delivery:

  1. Importe el siguiente comando cURL a Postman para generar un token de portador. Use los valores de la instancia de Azure Data Manager for Energy.

     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. Use la salida del token para actualizar access_token en el entorno de Well Delivery DDMS. A continuación, puede usar el token de portador como un tipo de autorización en otras llamadas API.

Utilizar las API de DDMS de Well Delivery para trabajar con registros de datos de Well

La finalización correcta de las solicitudes de Postman que se describen en las siguientes API de Well Delivery DDMS indica una ingesta y recuperación correctas de los registros de pozos en la instancia de Azure Data Manager for Energy.

Creación de un registro de pozo

Cree un registro de los pozos en la instancia de Azure Data Manager for Energy.

API: UC1>entity_create well

Método: PUT

Screenshot that shows the API that creates a well record.

Creación de un registro de wellbore

Cree un registro de wellbore en la instancia de Azure Data Manager for Energy.

API: UC1>entity_create wellbore

Método: PUT

Screenshot that shows the API that creates a wellbore record.

Obtención de una versión de well

Obtenga un registro de well basado en un identificador de well específico.

API: UC1>entity_create well Copy

Método: GET

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

Creación de un grupo de actividad

Creación de un grupo de actividad.

API: UC1>entity_create activityplan

Método: PUT

Screenshot that shows the API that creates an activity plan.

Obtención de un plan de actividad por identificador correcto

Obtenga el objeto del plan de actividad para un identificador de well específico.

API: UC2>activity_plans_by_well

Método: GET

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

Eliminación de un registro de wellbore

Puede eliminar un registro de recinto de pozo en la instancia de Azure Data Manager for Energy mediante las API de Well Delivery DDMS. La siguiente captura de pantalla muestra un ejemplo.

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

Eliminar un registro de well

Puede eliminar un registro de pozo en la instancia de Azure Data Manager for Energy mediante las API de Well Delivery DDMS. La siguiente captura de pantalla muestra un ejemplo.

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

Pasos siguientes

Vaya al siguiente tutorial para aprender a trabajar con datos de well mediante las API de DDMS de Wellbore: