Création et modification de modèles de métadonnées

Modifié

Vous devez être administrateur pour configurer les modèles de métadonnées.

Huwise fournit un ensemble de métadonnées basiques, telles que le titre, la description, les thèmes, les mots-clés, la langue, la licence, etc. D’autres modèles prédéfinis facultatifs sont également disponibles, par exemple pour des objectifs d’interopérabilité (DCAT, INSPIRE, etc.).

Il est toutefois possible de remplir des métadonnées supplémentaires personnalisées à utiliser dans vos jeux de données.

Créer un nouveau modèle personnalisé

Vous pouvez créer un nouveau modèle dans l’onglet Basique ou dans l’onglet Admin, en cliquant sur + Créer un modèle. Choisissez l’onglet selon qui doit voir les métadonnées :

  • Basique : les métadonnées sont affichées dans votre portail, sur la page de l’actif. Voir Métadonnées basiques.

  • Admin : les métadonnées sont réservées à un usage interne. Elles s’affichent dans le back office et dans les outils de gestion de catalogue, mais pas dans votre portail. Voir Métadonnées d’administration.

Notez que vous ne pouvez pas créer de modèle dans l’onglet Interopérabilité. Ses modèles sont des modèles système : voir « Modifier le niveau d’exigence dans un modèle système » ci-dessous.

Nommer le modèle

La première étape consiste à remplir le champ "Nom du modèle".

Cela remplira automatiquement l'"identifiant du modèle", bien que vous puissiez modifier manuellement l’identifiant.

L’identifiant du modèle est l’identifiant unique du modèle et, par exemple, ce que vous utilisez dans l’API pour faire référence au modèle. Notez qu’une fois le modèle créé, son identifiant ne peut plus être modifié.

Activation et désactivation des modèles

Pour activer ou désactiver des modèles, vous pouvez le faire dans la section "Activation" lors de l'édition d'un modèle, ou bien à partir de la liste des modèles en cliquant sur l'icône Activer ou Désactiver sur la ligne du modèle. Pour activer ou désactiver plusieurs modèles à la fois, sélectionnez-les dans la liste, puis cliquez sur Activer ou Désactiver.

Lorsqu’un modèle est activé, il est disponible pour être rempli dans l’onglet Métadonnées de vos jeux de données. Voir ci-dessous pour plus de détails sur la désactivation des modèles.

Création de champs de métadonnées dans votre nouveau modèle

Pour créer de nouveaux champs de métadonnées dans votre modèle personnalisé, cliquez sur + Ajouter un champ sous « Champs de métadonnées ». Cela ouvre une interface pour vous guider dans le processus, où vous remplirez les informations, le type et les valeurs, et les règles du champ.

1. Informations

Commencez par renseigner le « Nom » du champ, puis cliquez sur Suivant.

Comme pour le modèle lui-même, l’identifiant est créé automatiquement, mais peut être modifié. Comme l’identifiant du modèle, une fois la création du champ achevée, l’identifiant du champ ne peut plus être modifié.

2. Type et valeurs

Dans le menu déroulant, précisez le type de champ que vous souhaitez créer.

Notez qu’une fois le type défini, il ne peut plus être modifié.

Le tableau ci-dessous décrit les 11 types de champ disponibles :

Type

Description

Texte

Il s’agit d’un texte à entrée unique destiné à des entrées courtes. Si vous pensez avoir besoin de plus d’espace, utilisez le type de champ "Texte long".

Vous pouvez définir un nombre quelconque de valeurs uniques à proposer. Alternativement, l’auto-complétion proposera des valeurs basées sur celles saisies précédemment pour ce champ par d’autres utilisateurs. (Les deux options ne sont pas disponibles ensemble.)

Sélection Unique

Une valeur peut être choisie parmi une liste fournie.

Sélection Multiple

Plusieurs valeurs peuvent être choisies dans une liste fournie.

Liste Ouverte

Autorise les utilisateurs à entrer n’importe quelle valeur.

Vous pouvez définir un nombre quelconque de valeurs uniques à proposer. Alternativement, l’auto-complétion proposera des valeurs basées sur celles saisies précédemment pour ce champ par d’autres utilisateurs. (Les deux options ne sont pas disponibles ensemble.)

Date

Le contributeur sera invité à fournir une date.

Le format de date affiché dans votre espace de travail est MM/JJ/AAAA, mais il est disponible dans l’API au format AAAA-MM-JJ. Les dates sont limitées de 0 à 9999.

Les contributeurs disposent d’un bouton Aujourd’hui qu’ils peuvent utiliser pour fournir automatiquement la date actuelle.

Date & Heure

Le contributeur sera invité à fournir une date et une heure.

Le format de date affiché dans votre espace de travail est MM/JJ/AAAA HH:MM:SS, mais il est disponible dans l’API au format AAAA-MM-JJTHH:MM:SS+00:00, ou année-mois-jour-THour:Minute:Second+Fuseau horaire. Les dates sont limitées de 0 à 9999.

Voir cette page Wikipedia pour comprendre la notation temporelle.

Notez que les contributeurs disposent d’un bouton Maintenant qu’ils peuvent utiliser pour fournir automatiquement la date et l’heure actuelles.

Booléen

Cette option crée un interrupteur vrai/faux. S’il est utilisé dans vos filtres, il apparaîtra sous le nom que vous lui donnez, sélectionnable pour tous les jeux de données pour lesquels il est vrai.

Nombre Entier

Accepte des valeurs numériques. Elles peuvent être positives ou négatives, mais doivent être des nombres entiers.

Nombre Décimal

Comme le type « Nombre Entier », mais n’accepte que des valeurs décimales.

Texte long avec HTML

Ce type de champ est destiné à des entrées plus longues où vous souhaitez que les utilisateurs aient accès au HTML.

Texte long

Destiné à des entrées de texte plus longues.

Activer la traduction

Sous « Traduire les valeurs », vous pouvez activer l’option Activer les traductions. Cela vous permet de traduire le contenu d’un champ de métadonnées. La traduction n’est pas activée par défaut et doit être activée au cas par cas pour chaque champ.

Notez qu’une fois qu’un modèle est créé ou enregistré, les traductions ne peuvent plus être activées ou désactivées pour les champs existants du modèle.

Notez aussi l’exception que certains champs du modèle Actif sont toujours traduisibles.

Remplissage des traductions

Pour remplir les traductions, allez dans l’onglet Métadonnées et cliquez sur le bouton Gérer les langues en haut à droite. Cela ouvre une interface où vous pouvez remplir les traductions pour chaque champ concerné.

Chaque modèle comportant des valeurs traduisibles apparaît comme son propre onglet. Sélectionnez la langue appropriée parmi celles activées sur votre portail via le menu déroulant en haut sous « Langues de traduction ».

Les champs « Titre », « Description » et « Mots-clés » sont traduits à partir du modèle Actif.

Pour traduire les « Thèmes » et les « Catégories », dans le back office allez dans Catalogue > Catégories et thèmes d'actifs de données.

Les traductions des licences sont gérées dans le back office dans Portail > Mentions légales. Là, allez dans la section « Licence » en bas de la page.

Si vous devez traduire des champs de métadonnées existants qui n’ont pas les traductions activées, vous devez créer de nouveaux champs de métadonnées. Si possible, vous pouvez utiliser l’API pour récupérer les valeurs de métadonnées puis mettre à jour les champs correspondants sur les nouveaux champs de métadonnées. Voir la documentation de l’API Automation pour plus d’informations.

Autocomplétion, valeurs suggérées

Lors de la création d’un nouveau champ, vous pouvez activer l’autocomplétion. Lorsque les utilisateurs commencent à taper une valeur dans le champ, ils verront des suggestions basées sur les valeurs que d’autres utilisateurs ont saisies pour ce champ dans votre espace de travail.

Vous pouvez aussi fournir manuellement des valeurs suggérées.

3. Règles

Sous « Texte d’aide » se trouve la description ou l’information pour aider les utilisateurs à comprendre le champ.

Sous « Niveau d’exigence », une fois que vous avez défini le type et la valeur du champ, vous avez la possibilité de marquer le champ comme facultatif, recommandé ou obligatoire.

Vous avez la possibilité d'inclure n'importe quel champ dans un filtre de votre catalogue et dans l'API Explore. Lorsque vous êtes en train de modifier un champ de métadonnées, rendez-vous dans l'onglet Règles et activez le bouton sous "Filtre du catalogue". Une fois cette option activée, rendez-vous dans Catalogue > Paramètres et modifiez la "Page Catalogue". Là, sous "Filtres", lors de l'ajout d'un nouveau filtre, vous pouvez désormais sélectionner le champ que vous avez activé.

N’oubliez pas de sauvegarder

N’oubliez pas de cliquer sur Sauvegarder en haut à droite une fois que vous avez fini de créer ou de modifier votre modèle.

Modification d’un modèle ou champ existant

Nous vous recommandons de lire cette section en entier avant d’essayer de modifier un modèle ou un champ existant. L’impact du changement que vous souhaitez effectuer peut ne pas être évident immédiatement.

Évidemment, si vous devez modifier un modèle (ou un champ ou valeur individuel) qui n’a pas encore été utilisé, il n’y a pas de problème : supprimez le modèle (ou champ ou valeur fautifs) et créez son remplacement.

Par contre, lorsque un champ ou une valeur a déjà commencé à être utilisé, des conséquences inattendues peuvent survenir lors de leur modification.

Que se passe-t-il si je rends un champ obligatoire ?

Si un champ est marqué obligatoire et reste vide, les contributeurs ne pourront pas publier l'actif de données concerné tant qu'il n'aura pas été renseigné.

Les actifs déjà publiés restent publiés, mais leurs mises à jour automatiques, comme les mises à jour planifiées ou celles provenant d'un formulaire, échoueront tant que les métadonnées manquantes n'auront pas été renseignées.

Si le modèle est actif, une confirmation vous est demandée avant qu'un champ ne soit défini comme obligatoire. Une confirmation vous est également demandée lorsque vous activez un modèle qui contient des métadonnées obligatoires.

Que se passe-t-il si je supprime un modèle ?

Les modèles peuvent être supprimés en cliquant sur l’icône poubelle dans la liste des modèles, ou bien sur le menu à trois points en haut à droite à l’intérieur même du modèle.

Si vous supprimez un modèle ou un champ alors qu’ils ont commencé à être utilisés, vous perdrez définitivement les métadonnées associées.

Nous recommandons de désactiver le modèle, auquel cas ces métadonnées ne seront plus visibles, mais les valeurs ne seront pas perdues.

Est-ce que je peux modifier un champ existant ?

Le tableau ci-dessous résume ce qui peut et ne peut pas être modifié dans un champ. Reportez-vous plus bas pour plus d’informations.

Onglet

Ce que vous pouvez changer

Ce que vous ne pouvez pas changer

Informations

Nom

Identifiant

Type et valeurs

Valeurs

Texte et liste

  • Activation ou désactivation de l’auto-complétion

Une fois le modèle enregistré :

Type de champ

Valeurs

Règles

Texte d'aide

Niveau d’exigence

Paramètre de filtre du catalogue

Modifier le niveau d'exigence dans un modèle système

Certains modèles sont fournis par Huwise et sont appelés modèles système : les modèles Actif et Jeu de données de l'onglet Basique, ainsi que les modèles de l'onglet Interopérabilité, sont des modèles système. Vous ne pouvez pas ajouter, supprimer ou renommer leurs champs. En revanche, vous pouvez décider à quel point vos contributeurs sont tenus de renseigner chaque champ, en modifiant son niveau d'exigence.

Par exemple, le champ "Mots clés" du modèle Actif est facultatif par défaut. Si vous souhaitez que tous les actifs de votre portail aient des mots clés, vous pouvez rendre ce champ obligatoire.

Pour modifier le niveau d'exigence d'un champ :

  1. Ouvrez le modèle, puis cliquez sur le nom du champ ou sur son icône Modifier.

  2. Dans l'onglet Règles, choisissez le niveau d'exigence, puis cliquez sur Appliquer.

  3. Cliquez sur Sauvegarder.

Par ailleurs, certains champs, comme le titre, la catégorie et la langue, sont toujours obligatoires : leur niveau ne peut pas être modifié.

Avant de rendre un champ obligatoire, consultez "Que se passe-t-il si je rends un champ obligatoire ?" ci-dessus.

Que se passe-t-il si je supprime une valeur de métadonnées ?

Si vous supprimez une valeur d’un champ texte ou liste (en gardant à l’esprit que ces valeurs sont facultatives) :

  • Les valeurs de métadonnées elles-mêmes resteront telles quelles dans le portail et au back office. Simplement, cette option ne sera plus proposée pour les sélections futures.

Si vous supprimez une valeur d’un champ à sélection unique (souvenez-vous qu’au moins une valeur est requise lors de la création de ce type de champ) :

  • Dans le back office, l’ancienne valeur de métadonnées ne sera plus visible, mais sera simplement marquée « N/A ».

  • Dans le portail, l’ancienne valeur de métadonnées restera. Si l’utilisateur édite la valeur et republie le jeu de données, la valeur sera mise à jour.

Si vous supprimez une valeur d’un champ à sélection multiple (rappelez-vous qu’au moins une valeur est requise lors de la création de ce champ) :

  • L’ancienne valeur de métadonnées ne sera plus visible dans le back office. Le champ sera comme si aucune sélection n’avait jamais été faite.

  • Dans le portail, l’ancienne valeur de métadonnées restera. Si ou lorsque l’utilisateur édite la valeur et republie le jeu de données, à ce moment-là la valeur serait mise à jour.

Et si je ne fais que désactiver un modèle ?

  • Le modèle reste dans votre liste de modèles, marqué comme inactif.

  • Dans le back office, ce modèle n’est plus proposé dans l’onglet Métadonnées de vos jeux de données.

  • Dans le portail, ainsi que dans l’Automation API et la Search API, ces métadonnées ne seront pas visibles.

Cependant, notez que les métadonnées n’ont pas été supprimées. En supposant qu’aucun autre changement n’intervienne, si vous réactivez le modèle, vous pourrez à nouveau voir ces métadonnée