Tutoriel : Utiliser des enregistrements de données de puits à l’aide des API DDMS Wellbore

  • Article

Servez-vous des API DDMS (Domain Data Management Services) Wellbore dans Postman pour utiliser des données de puits dans votre instance Azure Data Manager for Energy.

Dans ce tutoriel, vous allez apprendre à :

  • Configurez Postman pour utiliser une collection DDMS Wellbore.
  • Configurez Postman pour utiliser un environnement DDMS Wellbore.
  • Envoyez des demandes via Postman.
  • Générez un jeton d’autorisation.
  • Utilisez les API DDMS Wellbore pour travailler avec des enregistrements de données.

Pour plus d’informations sur DDMS, consultez Concepts DDMS.

Prérequis

Obtenir les détails concernant votre instance Azure Data Manager for Energy

La première étape consiste à obtenir les informations suivantes auprès de votre instance Azure Data Manager pour Energy dans le Portail Azure :

Paramètre Valeur Exemple
client_id ID d’application (client) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx
client_secret Clés secrètes client _fl******************
tenant_id ID de l’annuaire (locataire) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx
base_url URL https://<instance>.energy.azure.com
data-partition-id Partitions de données <data-partition-name>

Vous aurez besoin de cette information plus loin dans le didacticiel.

Configurer Postman

  1. Téléchargez et installez l’application bureau Postman.

  2. Importez les fichiers suivants dans Postman :

    Pour importer les fichiers :

    1. Sélectionnez Importer dans Postman.

      Screenshot that shows the Import button in Postman.

    2. Collez l’URL de chaque fichier dans la zone de recherche.

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

  3. Dans l’environnement Postman, mettez à jour Current value avec les détails de votre instance Azure Data Manager for Energy :

    1. Dans Postman, dans le menu de gauche, sélectionnez Environments, puis Wellbore DDMS Environment.

    2. Dans la colonne Current value, entrez les informations de la table dans la section Obtenir les détails de votre instance Azure Data Manager for Energy de ce tutoriel.

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

Envoyer un exemple de requête Postman

La collection Postman pour Wellbore DDMS contient des requêtes que vous pouvez utiliser pour interagir avec des données sur les puits, les forages, les journaux sur les puits et les données de trajectoire de puits dans votre instance Azure Data Manager for Energy.

  1. Dans Postman, dans le menu de gauche, sélectionnez Collections, puis Wellbore DDMS. Sous Configuration, sélectionnez Obtenir un jeton SPN.

  2. Dans la liste déroulante d’environnements en haut à droite, sélectionnez Wellbore DDMS Environment.

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

  3. Pour envoyer la requête, sélectionnez Envoyer.

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

  4. La requête valide le code de réponse d’API réel par rapport au code de réponse attendu. Sélectionnez l’onglet Résultats des tests pour déterminer si la requête a réussi ou échoué.

    Voici un exemple d’appel Postman réussi :

    Screenshot that shows success for a Postman call.

    Voici un exemple d’appel Postman ayant échoué :

    Screenshot that shows failure for a Postman call.

Utiliser les API DDMS Wellbore pour travailler avec des enregistrements de données de puits

La réussite des requêtes Postman décrites dans les API Wellbore DDMS suivantes indique l’ingestion et la récupération réussies des enregistrements sur les puits dans votre instance Azure Data Manager pour Energy.

Créez une étiquette juridique qui est automatiquement ajoutée à votre environnement DDMS Wellbore pour la conformité des données.

API : Configurer>Créer une étiquette juridique pour WDMS

Méthode : POST

Screenshot that shows the API that creates a legal tag.

Pour plus d’informations, consultez Gérer les étiquettes juridiques.

Créer un enregistrement de puits

Créez un enregistrement de puits dans votre instance Azure Data Manager pour Energy.

API : Puits>Créer un puits

Méthode : POST

Screenshot that shows the API that creates a well record.

Obtenir un enregistrement de puits

Obtenez les données d’enregistrement de puits pour votre instance Azure Data Manager pour Energy.

API : Puits>Puits par ID

Méthode : GET

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

Obtenir des versions de puits

Obtenez les versions de chaque enregistrement de puits ingéré dans votre instance Azure Data Manager pour Energy.

API : Puits>Versions de puits

Méthode : GET

Screenshot that shows the API that gets all well versions.

Obtenir une version de puits spécifique

Obtenez les détails d’une version spécifique pour un enregistrement de puits spécifique dans votre instance Azure Data Manager pour Energy.

API : Puits>Version spécifique de puits

Méthode : GET

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

Supprimer un enregistrement de puits

Supprimez un enregistrement de puits spécifique dans votre instance Azure Data Manager pour Energy.

API : Nettoyer>Enregistrement de puits

Méthode : DELETE

Screenshot that shows the API that deletes a well record.

Étape suivante

Lisez le tutoriel suivant afin d’apprendre à utiliser l’outil en ligne de commande sdutil pour charger des données sismiques dans Seismic Store :

Tutoriel : Utiliser sdutil pour charger des données dans Seismic Store