Esercitazione: Usare record di dati bene usando le API DDMS Well Delivery

Usare le API DDMS (Well Delivery Domain Gestione dati Services) in Postman per lavorare con dati appropriati nell'istanza di Azure Data Manager for Energy.

In questa esercitazione apprenderai a:

• Configurare Postman per l'uso di una raccolta DDMS Well Delivery.
• Configurare Postman per l'uso di un ambiente DDMS Well Delivery.
• Inviare richieste tramite Postman.
• Generare un token di autorizzazione.
• Usare le API DDMS well delivery per lavorare con record di dati validi.

Per altre informazioni su DDMS, vedere Concetti relativi a DDMS.

Prerequisiti

• Una sottoscrizione di Azure
• Istanza di Azure Data Manager for Energy creata nella sottoscrizione di Azure

Ottenere i dettagli dell'istanza di Data Manager di Azure per l'energia

Il primo passaggio consiste nell'ottenere le informazioni seguenti dall'istanza di Data Manager di Azure per l'energia nel portale di Azure:

Parametro	Valore	Esempio
CLIENT_ID	ID applicazione (client)	00001111-aaaa-2222-bbbb-3333cccc4444
CLIENT_SECRET	Segreti client	_fl******************
TENANT_ID	ID della directory (tenant)	72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
SCOPE	ID applicazione (client)	00001111-aaaa-2222-bbbb-3333cccc4444
base_uri	URI	<instance>.energy.azure.com
data-partition-id	Partizioni di dati	<instance>-<data-partition-name>

Queste informazioni verranno usate più avanti nell'esercitazione.

Impostazione di Postman

1. Scaricare e installare l'app desktop Postman.

2. Importare i file seguenti in Postman:

   • Raccolta DDMS Postman per la distribuzione
   • Ambiente Postman DDMS well Delivery

   Per importare i file:

   1. Creare due file JSON nel computer copiando i dati presenti nei file di raccolta e ambiente.

   2. In Postman selezionare Importa>file>Scegli file e quindi selezionare i due file JSON nel computer.

   3. In Importa entità in Postman selezionare Importa.

      

3. Nell'ambiente Postman aggiornare CURRENT VALUE con le informazioni dell'istanza di Azure Data Manager per l'energia:

   1. Nel menu a sinistra in Postman selezionare Ambienti e quindi WellDelivery Environment (Ambiente WellDelivery).

   2. Nella colonna VALORE CORRENTE immettere le informazioni della tabella nella sezione Ottenere i dettagli dell'istanza di Azure Data Manager per l'energia di questa esercitazione.

   

Inviare una richiesta Postman

La raccolta Postman per Well Delivery DDMS contiene richieste che è possibile usare per interagire con i dati relativi a pozzi, benebores, log e traiettoria ottimale nell'istanza di Azure Data Manager per l'energia.

Per un esempio di come inviare una richiesta Postman, vedere l'esercitazione su Wellbore DDMS.

Generare un token per le API

Generare un token che è possibile usare per usare le API DDMS Well Delivery:

1. Importare il comando cURL seguente in Postman per generare un token di connessione. Usare i valori dell'istanza di Azure Data Manager per l'energia.

    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. Usare l'output del token per eseguire l'aggiornamento access_token nell'ambiente DDMS Well Delivery. È quindi possibile usare il token di connessione come tipo di autorizzazione in altre chiamate API.

Usare le API DDMS well delivery per lavorare con record di dati validi

Il completamento delle richieste Postman descritte nelle API DDMS seguenti indica l'inserimento e il recupero di record completi nell'istanza di Azure Data Manager per l'energia.

Creare un record corretto

Creare un record corretto nell'istanza di Azure Data Manager per l'energia.

API: uc1>entity_create bene

Metodo: PUT

Creare un record wellbore

Creare un record wellbore nell'istanza di Azure Data Manager per l'energia.

API: UC1>entity_create wellbore

Metodo: PUT

Ottenere una versione corretta

Ottenere un record corretto in base a un ID specifico.

API: UC1>entity_create well Copy

Metodo: GET

Creare un piano attività

Creare un piano attività.

API: UC1>entity_create activityplan

Metodo: PUT

Ottenere un piano di attività in base all'ID corretto

Ottenere l'oggetto piano attività per un ID specifico dell'area.

API: uc2>activity_plans_by_well

Metodo: GET

Eliminare un record wellbore

È possibile eliminare un record di interruzione nell'istanza di Azure Data Manager per l'energia usando le API DDMS Well Delivery. La schermata seguente mostra un esempio.

Eliminare un record corretto

È possibile eliminare un record corretto nell'istanza di Azure Data Manager per l'energia usando le API DDMS Well Delivery. La schermata seguente mostra un esempio.

Passaggi successivi

Passare all'esercitazione successiva per informazioni su come usare i dati in modo corretto usando le API DDMS Wellbore:

Esercitazione: Usare record di dati con wellbore DDMS