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

• Una suscripción de Azure
• Instancia de Azure Data Manager for Energy creada en la suscripción de Azure

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:

   • Colección Postman de Well Delivery DDMS
   • Entorno de Postman de DDMS de entrega

   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.

      

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.

   

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

   

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

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

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

Creación de un grupo de actividad

Creación de un grupo de actividad.

API: UC1>entity_create activityplan

Método: PUT

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

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.

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.

Pasos siguientes

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

Tutorial: Uso de registros de datos de well mediante las API de Wellbore DDMS