Crea istanze di metadati

Questa guida descrive come creare istanze di metadati cloud nei bucket di metadati. Manufacturing Data Engine (MDE) offre due modi per creare istanze di metadati:

  1. Tramite l'API Metadata o l'interfaccia web (tutti i bucket).
  2. In modo dinamico dai parser (solo bucket di record e tag).

Prima di iniziare

Per completare questa guida, devi aver già creato un bucket di metadati.

Creazione di istanze di metadati tramite l'API Metadata o la console

Puoi creare istanze di metadati tramite l'API Metadata o l'interfaccia utente MDE. Puoi utilizzare l'API per caricare istanze di metadati in MDE da origini esterne e per compilare i bucket di ricerca con dati di riferimento.

Crea un'istanza di metadati cloud seguendo le istruzioni riportate di seguito per le chiamate API REST o la console:

REST

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

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

Sostituisci quanto segue:

  • BUCKET_NAME con il nome del bucket in cui creare un'istanza di metadati.
  • BUCKET_VERSION con la versione del bucket dei metadati in cui creare un'istanza di metadati.
  • NATURAL_KEY con la chiave naturale dell'istanza dei metadati. Deve essere tagName se BUCKET_NAME corrisponde a un bucket di tag. Se BUCKET_NAME corrisponde a un bucket di record e la chiave naturale viene omessa, la chiave naturale viene impostata automaticamente sull'hash del valore.
  • METADATA_INSTANCE_OBJECT con l'oggetto istanza dei metadati. L'oggetto istanza dei metadati deve essere conforme allo schema definito per BUCKET_NAME e BUCKET_VERSION.

Console

Apri la sezione TAG CLOUD del menu in alto dell'interfaccia utente per creare un'istanza di metadati. La visualizzazione predefinita fornisce un elenco dei tag disponibili nell'istanza MDE:

Sezione Metadati - elenco

L'interfaccia utente supporta solo la modifica dei bucket di metadati dei tag. È possibile creare istanze di altri tipi di bucket solo utilizzando l'API. Per creare un'istanza di metadati tag:

  1. Fai clic sull'icona "AZIONI" nel Tag selezionato dall'elenco.

  2. Seleziona Visualizza / Modifica.

    Sezione Tag - Modifica tag

  3. Nel menu laterale Modifica tag, individua la sezione Metadati tag per modificare o aggiungere una nuova istanza di metadati.

  4. Fai clic sul badge del bucket che vuoi implementare. Gli attributi del bucket vengono visualizzati di seguito.

    Sezione Tag - Modifica i metadati dei tag

  5. Modifica gli attributi esistenti o aggiungine di nuovi in base alle esigenze. Questi attributi sono modificabili.

  6. Aggiungi i valori selezionati in ogni casella del modulo.

  7. Al termine dell'istanza, fai clic su "SALVA".

  8. L'istanza viene quindi convalidata in base agli schemi del bucket. Se la convalida ha esito positivo, l'istanza viene archiviata e viene visualizzato un messaggio di conferma. Questa istanza diventa l'istanza valida corrente che qualifica i nuovi record ricevuti per questo tag.

Creazione dinamica di istanze di metadati dai parser

Le istanze di metadati possono essere create dinamicamente dai parser quando utilizzi il metodo lookup by value per risolvere i riferimenti alle istanze di metadati. Quando utilizzi il metodo lookup by value e il valore dell'ultima istanza dei metadati per la chiave naturale fornita non esiste, MDE crea automaticamente una nuova istanza dei metadati per la chiave naturale dall'oggetto istanza definito nel record proto. Per ulteriori dettagli, consulta la documentazione su come risolvere l'ID istanza dei metadati in base al valore dell'istanza.