Créer des instances de métadonnées

Ce guide explique comment créer des instances de métadonnées cloud dans des buckets de métadonnées. Manufacturing Data Engine (MDE) propose deux méthodes pour créer des instances de métadonnées :

1. Via l'API Metadata ou l'interface Web (tous les buckets).
2. De manière dynamique à partir d'analyseurs (buckets d'enregistrements et de tags uniquement).

Avant de commencer

Pour suivre ce guide, vous devez avoir déjà créé un bucket de métadonnées.

Créer des instances de métadonnées via l'API Metadata ou la console

Vous pouvez créer des instances de métadonnées via l'API Metadata ou l'interface utilisateur MDE. Vous pouvez utiliser l'API pour charger des instances de métadonnées dans MDE à partir de sources externes et pour remplir des buckets de recherche avec des données de référence.

Créez une instance de métadonnées cloud en suivant les instructions ci-dessous pour les appels d'API REST ou la console :

REST

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

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

Remplacez les éléments suivants :

• BUCKET_NAME par le nom du bucket dans lequel créer une instance de métadonnées.
• BUCKET_VERSION par la version du bucket de métadonnées dans lequel créer une instance de métadonnées.
• NATURAL_KEY par la clé naturelle de l'instance de métadonnées. Elle doit être tagName si BUCKET_NAME correspond à un bucket de tags. Si BUCKET_NAME correspond à un bucket d'enregistrements et que la clé naturelle est omise, elle est automatiquement définie sur le hachage de la valeur.
• METADATA_INSTANCE_OBJECT par l'objet d'instance de métadonnées. L'objet d'instance de métadonnées doit être conforme au schéma défini pour BUCKET_NAME et BUCKET_VERSION.

Console

Ouvrez la section 'CLOUD TAGS' du menu supérieur de l' interface utilisateur pour créer une Metadata Instance (Instance de métadonnées). La vue par défaut fournit une liste des Tags (Tags) disponibles dans l'instance MDE :

L'interface utilisateur n'accepte que la modification des buckets de métadonnées de tags. Les instances d'autres types de buckets ne peuvent être créées qu'à l'aide de l'API. Pour créer une Tag Metadata Instance (Instance de métadonnées de tag) :

1. Cliquez sur l'icône 'ACTIONS' (ACTIONS) dans le Tag (Tag) sélectionné de la liste.

2. Sélectionnez 'View / Edit' (Afficher/Modifier).

   

3. Dans le menu latéral 'Edit Tag' (Modifier le tag), recherchez la section 'Tag Metadata' (Métadonnées de tag) pour modifier ou ajouter une Metadata Instance (Instance de métadonnées).

4. Cliquez sur le Badge du bucket que vous souhaitez implémenter. Les attributs du bucket s'affichent en dessous.

   

5. Modifiez les attributs existants ou ajoutez-en de nouveaux si nécessaire. Ces attributs sont modifiables.

6. Ajoutez les valeurs sélectionnées dans chaque case du formulaire.

7. Une fois l'instance terminée, cliquez sur 'SAVE' (ENREGISTRER).

8. L'instance est ensuite validée par rapport au(x) schéma(s) du bucket. Si la validation réussit, l'instance est stockée et un message de réussite s'affiche. Cette instance devient l'instance valide actuelle qui qualifie les nouveaux Records (Enregistrements) reçus pour ce tag.

Créer des instances de métadonnées de manière dynamique à partir d'analyseurs

Les instances de métadonnées peuvent être créées de manière dynamique à partir d'analyseurs lorsque vous utilisez la méthode lookup by value pour résoudre les références d'instances de métadonnées. Lorsque vous utilisez la méthode lookup by value et que la dernière valeur d'instance de métadonnées pour la clé naturelle fournie n'existe pas, MDE crée automatiquement une instance de métadonnées pour la clé naturelle à partir de l'objet d'instance défini dans l'enregistrement proto. Pour en savoir plus, consultez la documentation sur la résolution de l'instance_id de métadonnées par valeur d'instance.