Tutorial: Durchführen der manifestbasierten Dateierfassung

  • Artikel

Mithilfe der Manifesterfassung können Manifeste in einer Instanz von Azure Data Manager for Energy erfasst werden.

In diesem Tutorial lernen Sie Folgendes:

  • Erfassen von Beispielmanifesten in einer Instanz von Azure Data Manager for Energy mithilfe von Postman
  • Suchen nach Datensätzen mit Speichermetadaten, die während der Manifesterfassung erstellt wurden, mithilfe von Postman

Voraussetzungen

Bevor Sie mit diesem Tutorial beginnen, müssen folgende Voraussetzungen erfüllt sein:

Abrufen von Details zur Instanz von Azure Data Manager for Energy

  • Sie benötigen eine Instanz von Azure Data Manager for Energy. Wenn Sie noch nicht über eine Instanz verfügen, erstellen Sie eine mithilfe der Schritte unter Schnellstart: Erstellen einer Azure Data Manager for Energy-Instanz.

  • Für dieses Tutorial benötigen Sie die folgenden Parameter:

    Parameter Zu verwendender Wert Beispiel Speicherort dieses Werts
    CLIENT_ID Anwendungs-ID (Client) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Sie verwenden diese App- oder Client-ID, wenn Sie die Anwendung bei der Microsoft Identity Platform registrieren. Weitere Informationen finden Sie unter Registrieren einer Anwendung.
    CLIENT_SECRET Geheime Clientschlüssel _fl****************** Geheime Clientschlüssel werden manchmal auch als Anwendungskennwörter bezeichnet und entsprechen einem Zeichenfolgenwert, den Ihre App anstelle eines Zertifikats für die Identifizierung verwenden kann. Informationen hierzu finden Sie unter Geheimen Clientschlüssel hinzufügen.
    TENANT_ID Verzeichnis-ID (Mandant) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx Bewegen Sie die Maus auf den Namen Ihres Kontos, um die Verzeichnis- bzw. Mandanten-ID anzuzeigen. Alternativ können Sie im Azure-Portal zu Microsoft Entra ID>Eigenschaften>Mandanten-ID navigieren und die Option auswählen.
    SCOPE Anwendungs-ID (Client) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Dieser Wert entspricht der zuvor erwähnten App- bzw. Client-ID.
    refresh_token Aktualisierungstokenwert 0.ATcA01-XWHdJ0ES-qDevC6r........... Befolgen Sie die Anweisungen unter Generieren eines Authentifizierungstokens, um ein Aktualisierungstoken zu erstellen und zu speichern. Sie benötigen dieses Aktualisierungstoken später, um ein Benutzertoken zu generieren.
    DNS URI <instance>.energy.Azure.com Dieser Wert ist auf der Übersichtsseite der Instanz von Azure Data Manager for Energy verfügbar.
    data-partition-id Datenpartitionen <instance>-<data-partition-name> Dieser Wert ist auf der Übersichtsseite der Instanz von Azure Data Manager for Energy verfügbar.

Befolgen Sie den Leitfaden zum Verwalten von Benutzer*innen, um geeignete Berechtigungen für die Benutzer*innen hinzuzufügen, die dieses Tutorial ausführen.

Einrichten von Postman- und Ausführungsanforderungen

  1. Laden Sie die Postman-Desktop-App herunter, und installieren Sie sie.

  2. Importieren Sie die folgenden Dateien in Postman:

    Befolgen Sie zum Importieren der Postman-Sammlung und der Umgebungsvariablen die unter Importieren von Daten in Postman beschriebenen Schritte.

  3. Aktualisieren Sie AKTUELLER WERT für die Postman-Umgebung mit den Informationen, die Sie in den Details für die Instanz von Azure Data Manager for Energy erhalten haben.

  4. Die Postman-Sammlung für die Manifesterfassung enthält mehrere Anforderungen, die nacheinander ausgeführt werden müssen.

    Stellen Sie sicher, dass Sie die Umgebung für den Erfassungsworkflow auswählen, bevor Sie die Postman-Sammlung auslösen.

    Screenshot of the Postman environment.

  5. Lösen Sie die einzelnen Anforderungen aus, indem Sie auf die Schaltfläche Senden klicken.

    Bei jeder Anforderung vergleicht Postman den tatsächlichen API-Antwortcode mit dem erwarteten Antwortcode. Bei einer Nichtübereinstimmung werden im Testabschnitt Fehler angezeigt.

Hier finden Sie ein Beispiel für eine erfolgreiche Postman-Anforderung:

Screenshot of a successful Postman call.

Dies ist ein Beispiel für eine nicht erfolgreiche Postman-Anforderung:

Screenshot of a failed Postman call.

Erfassen von Beispielmanifesten mithilfe von Postman

Führen Sie die folgenden Schritte aus, um mithilfe der Postman-Sammlung Beispielmanifeste in der Instanz von Azure Data Manager for Energy zu erfassen:

  1. Abrufen eines Benutzerzugriffstokens: Generieren Sie das Benutzertoken. Dieses wird zum Authentifizieren weiterer API-Aufrufe verwendet.

  2. Erstellen eines rechtlichen Tags: Erstellen Sie ein rechtliches Tag, das den Manifestdaten zum Zweck der Datenkonformität hinzugefügt wird.

  3. Abrufen einer signierten URL für das Hochladen einer Datei: Rufen Sie den Pfad der signierten URL ab, auf die die Manifestdatei hochgeladen wird.

  4. Hochladen einer Datei: Laden Sie das Beispiel Wellbore.csv auf Ihren lokalen Computer herunter. Hierbei kann es sich um einen beliebigen Dateityp handelt (beispielsweise um eine CSV-, LAS- oder JSON-Datei). Wählen Sie diese Datei in Postman aus, indem Sie auf die Schaltfläche Datei auswählen klicken.

    Screenshot of uploading a manifest file.

  5. Hochladen von Dateimetadaten: Laden Sie die Dateimetadateninformationen (z. B. Dateispeicherort und andere relevante Felder) hoch.

  6. Abrufen der Dateimetadaten: Überprüfen Sie mithilfe eines Aufrufs, ob die Metadaten erfolgreich erstellt wurden.

  7. Erfassen von Master-, Referenz- und Arbeitsproduktkomponentendaten (Work Product Component, WPC): Erfassen Sie die Master-, Referenz- und WPC-Manifestmetadaten.

  8. Abrufen des Workflowstatus für die Manifesterfassung: Der Workflow wird gestartet und befindet sich im Zustand running. Setzen Sie die Abfrage fort, bis der Zustand finished lautet (normalerweise nach 20–30 Sekunden).

Suchen nach erfassten Daten mithilfe von Postman

Führen Sie die folgenden Schritte aus, um nach Speichermetadatensätzen zu suchen, die während der Manifesterfassung unter Verwendung der Postman-Sammlung erstellt wurden:

  1. Suchen nach Arbeitsprodukten: Rufen Sie den Suchdienst auf, um die Datensätze mit Metadaten zu Arbeitsprodukten abzurufen.
  2. Suchen nach Arbeitsproduktkomponenten: Rufen Sie den Suchdienst auf, um die WPC-Metadatensätze abzurufen.
  3. Suchen nach Datasets: Rufen Sie den Suchdienst auf, um die Datensätze mit Metadaten zu Datasets abzurufen.
  4. Suchen nach Masterdaten: Rufen Sie den Suchdienst auf, um die Datensätze mit Mastermetadaten abzurufen.
  5. Suchen nach Referenzdaten: Rufen Sie den Suchdienst auf, um die Datensätze mit Referenzmetadaten abzurufen.

Nächster Schritt

Fahren Sie mit dem nächsten Tutorial fort:

Tutorial: Verwenden von „sdutil“ zum Hochladen von Daten in Seismic Store

Weitere Informationen zur Manifesterfassung finden Sie in der Schnellstartanleitung zum Laden von OSDU-Operatordaten.