Metadateninstanzen erstellen

In dieser Anleitung wird beschrieben, wie Sie Cloud-Metadateninstanzen in Metadaten-Buckets erstellen. Manufacturing Data Engine (MDE) bietet zwei Möglichkeiten zum Erstellen von Metadateninstanzen:

1. Über die Metadata API oder die Web-UI (alle Buckets).
2. Dynamisch aus Parsern (nur Datensatz- und Tag-Buckets).

Hinweis

Für diese Anleitung müssen Sie bereits ein Metadaten-Bucket erstellt haben.

Metadateninstanzen über die Metadata API oder die Console erstellen

Sie können Metadateninstanzen über die Metadata API oder die MDE-UI erstellen. Mit der API können Sie Metadateninstanzen aus externen Quellen in MDE laden und Lookup-Buckets mit Referenzdaten füllen.

Erstellen Sie eine Cloud-Metadateninstanz mit der folgenden Anleitung für REST API-Aufrufe oder die Console:

REST

POST metadata/v1/buckets/BUCKET_NAME/BUCKET_VERSION/instances

{
    "naturalKey": "NATURAL_KEY",
    "instance": METADATA_INSTANCE_OBJECT
}

Ersetzen Sie Folgendes:

• BUCKET_NAME durch den Namen des Buckets, in dem eine Metadateninstanz erstellt werden soll.
• BUCKET_VERSION durch die Version des Metadaten-Buckets, in dem eine Metadateninstanz erstellt werden soll.
• NATURAL_KEY durch den natürlichen Schlüssel der Metadateninstanz. Wenn BUCKET_NAME einem Tag-Bucket entspricht, muss er tagName sein. Wenn BUCKET_NAME einem Datensatz-Bucket entspricht und der natürliche Schlüssel weggelassen wird, wird er automatisch auf den Hash des Werts festgelegt.
• METADATA_INSTANCE_OBJECT durch das Metadateninstanzobjekt. Das Metadateninstanzobjekt muss dem für BUCKET_NAME und BUCKET_VERSION definierten Schema entsprechen.

Console

Öffnen Sie den Bereich 'CLOUD-TAGS' im oberen Menü der UI, um eine Metadateninstanz zu erstellen. In der Standardansicht wird eine Liste der verfügbaren Tags in der MDE-Instanz angezeigt:

Die UI unterstützt nur die Bearbeitung von Tag-Metadaten-Buckets. Instanzen anderer Bucket-Typen können nur mit der API erstellt werden. So erstellen Sie eine Tag-Metadateninstanz:

1. Klicken Sie in der Liste für das ausgewählte Tag auf das Symbol 'AKTIONEN'.

2. Wählen Sie 'Ansehen / Bearbeiten' aus.

   

3. Suchen Sie im seitlichen Menü 'Tag bearbeiten' den Bereich 'Tag-Metadaten', um eine neue Metadateninstanz zu bearbeiten oder hinzuzufügen.

4. Klicken Sie auf das Badge des Buckets, das Sie implementieren möchten. Die Attribute des Buckets werden darunter angezeigt.

   

5. Ändern Sie die vorhandenen Attribute oder fügen Sie nach Bedarf neue hinzu. Diese Attribute können bearbeitet und geändert werden.

6. Fügen Sie die ausgewählten Werte in jedes Feld des Formulars ein.

7. Klicken Sie nach Abschluss der Instanz auf 'SPEICHERN'.

8. Die Instanz wird dann anhand der Bucket-Schemas validiert. Wenn die Validierung erfolgreich ist, wird die Instanz gespeichert und eine Erfolgsmeldung angezeigt. Diese Instanz wird zur aktuellen gültigen Instanz, die die neuen Datensätze qualifiziert, die für dieses Tag empfangen wurden.

Metadateninstanzen dynamisch aus Parsern erstellen

Metadateninstanzen können dynamisch aus Parsern erstellt werden, wenn Sie die Methode lookup by value zum Auflösen von Metadateninstanzreferenzen verwenden. Wenn Sie die Methode lookup by value verwenden und der letzte Metadateninstanzwert für den angegebenen natürlichen Schlüssel nicht vorhanden ist, erstellt MDE automatisch eine neue Metadateninstanz für den natürlichen Schlüssel aus dem Instanzobjekt, das im Proto-Datensatz definiert ist. Weitere Informationen finden Sie in der Dokumentation zu m Auflösen von metadata_instance_id nach Instanzwert.