Esercitazione: Usare record di dati con wellbore DDMS

  • Articolo

Usare le API DDMS (Wellbore Domain Gestione dati Services) in Postman per lavorare con dati appropriati nell'istanza di Azure Data Manager per l'energia.

In questa esercitazione apprenderai a:

  • Configurare Postman per usare una raccolta Wellbore DDMS.
  • Configurare Postman per usare un ambiente Wellbore DDMS.
  • Inviare richieste tramite Postman.
  • Generare un token di autorizzazione.
  • Usare le API DDMS wellbore per lavorare con record di dati validi.

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

Prerequisiti

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

Il primo passaggio consiste nel ottenere le informazioni seguenti dall'istanza di Azure Data Manager for Energy nel portale di Azure:

Parametro Valore Esempio
client_id ID applicazione (client) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
client_secret Segreti client _fl******************
tenant_id ID della directory (tenant) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
base_url URL https://<instance>.energy.azure.com
data-partition-id Partizioni di dati <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:

    Per importare i file:

    1. Selezionare Importa in Postman.

      Screenshot that shows the Import button in Postman.

    2. Incollare l'URL di ogni file nella casella di ricerca.

      Screenshot that shows importing collection and environment files in Postman via URL.

  3. Nell'ambiente Postman aggiornare il valore Corrente con le informazioni fornite da Azure Data Manager per i dettagli dell'istanza di Energia:

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

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

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

Inviare una richiesta Postman di esempio

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

  1. Nel menu a sinistra in Postman selezionare Raccolte e quindi selezionare Wellbore DDMS. In Setup (Installazione) selezionare Get an SPN Token (Ottieni un token SPN).

  2. Nell'elenco a discesa ambiente nell'angolo superiore destro selezionare Wellbore DDMS Environment (Ambiente DDMS Wellbore).

    Screenshot that shows selections for getting an SPN token and choosing an environment.

  3. Per inviare la richiesta, selezionare Invia.

    Screenshot that shows the Send button for a request in Postman.

  4. La richiesta convalida il codice di risposta API effettivo rispetto al codice di risposta previsto. Selezionare la scheda Risultati test per verificare se la richiesta ha avuto esito positivo o negativo.

    Di seguito è riportato un esempio di chiamata postman riuscita:

    Screenshot that shows success for a Postman call.

    Di seguito è riportato un esempio di chiamata postman non riuscita:

    Screenshot that shows failure for a Postman call.

Usare le API DDMS wellbore per lavorare con record di dati validi

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

Creare un tag legale aggiunto automaticamente all'ambiente Wellbore DDMS per la conformità dei dati.

API: configurare>il tag legale per WDMS

Metodo: POST

Screenshot that shows the API that creates a legal tag.

Per altre informazioni, vedere Gestire i tag legali.

Creare un record corretto

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

API: Well>Create Well

Metodo: POST

Screenshot that shows the API that creates a well record.

Ottenere un record corretto

Ottenere i dati del record per l'istanza di Azure Data Manager per l'energia.

API: Well Well>by ID

Metodo: GET

Screenshot that shows the API that gets a well record by ID.

Ottenere versioni buone

Ottenere le versioni di ogni record inserito correttamente nell'istanza di Azure Data Manager per l'energia.

API: Well>Well Versions

Metodo: GET

Screenshot that shows the API that gets all well versions.

Ottenere una versione specifica

Ottenere i dettagli di una versione specifica per un record specifico nell'istanza di Azure Data Manager per l'energia.

API: versione ben>specifica

Metodo: GET

Screenshot that shows the API that gets a specific well version.

Eliminare un record corretto

Eliminare un record specifico dall'istanza di Azure Data Manager per l'energia.

API: Pulire>well record

Metodo: DELETE

Screenshot that shows the API that deletes a well record.

Passaggio successivo

Leggere l'esercitazione seguente per informazioni su come usare lo strumento da riga di comando sdutil per caricare i dati sismici in Seismic Store:

Esercitazione: Usare sdutil per caricare i dati nell'archivio Sismico