Création et modification de modèles de métadonnées
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é
Accédez au back office, sous Catalogue > Modèles de métadonnées. Dans les onglets Basique et Admin, vous pouvez créer un nouveau modèle en cliquant sur + Créer un modèle.
Nommer le modèle
La première étape consiste à remplir le champ « Nom du modèle ».
Cela remplira automatiquement le « 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 à trois points du modèle et en sélectionnant l’option appropriée.
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 « Long texte ».
|
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.
|
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.
|
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.
|
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 ensembles 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. |
Long texte avec HTML | Ce type de champ est destiné à des entrées plus longues où vous souhaitez que les utilisateurs aient accès au HTML. |
Long texte | 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 Standard 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 d’actif.
Pour traduire les « Thèmes » et les « Catégories », dans le back office allez dans Catalogue > Catégories d’actifs et thèmes.
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.
L’option « Filtre du catalogue » vous permet d’ajouter le champ dans les filtres de votre catalogue et dans l’Explore API. Après avoir activé cette option pour un champ donné, pour l’appliquer vous devez ensuite accéder à Configuration > Pages catalogue et jeux de données > Page catalogue — filtres, où ce champ sera désormais une option, et le sélectionner.
N’oubliez pas de sauvegarder
N’oubliez pas de cliquer sur Enregistrer 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 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.
Que se passe-t-il si je modifie 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
| Une fois le modèle enregistré : Type de champ Valeurs |
Règles | Texte d'aide Niveau d’exigence Paramètre de filtre du catalogue |
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ées.
