Aide:Contraintes de propriété/Format
Cette documentation concerne un type particulier de contrainte. Voir le Portail pour un aperçu général des contraintes sur les propriétés. |
La format constraint (Q21502404) indique que les valeurs d'une propriété doivent être conformes à un certain modèle.
Par exemple, la valeur de GNIS Feature ID (P590) devrait toujours être un nombre comportant jusqu'à huit chiffres, sans commencer par un ou plusieurs zéros : [1-9][0-9]{0,7}
.
Le modèle est une expression régulière, mais il peut varier : KrBot, qui crée les rapports de la base de données utilise les expressions régulières compatibles Perl (PCRE) ; l'extension WikibaseQualityConstraints, qui fait fonctionner Special:ConstraintReport et le gadget utilisait historiquement java.util.regex mais depuis août 2021 elle utilise PCRE; OpenRefine utilise java.util.regex; d'autres implémentations peuvent utiliser autre chose pour vérifier les expressions régulières. Les versions sont le plus souvent compatibles, mais pas entièrement ; pour un maximum de compatibilité avec les différents moteurs de contraintes, il est recommandé de s'en tenir au sous-ensemble commun des versions.
Si aucun constraint scope (P4680) n'est spécifié, la contrainte est vérifiée partout.
Actions possibles
Il y a plusieurs façons de corriger une violation pour cette contrainte :
- Le cas le plus probable est que la valeur est malformée d'une certaine manière. Souvent le correctif est simple : ajouter un préfixe manquant ou en supprimer un qui devrait être implicite, ajouter la ponctuation (par ex. ajouter des traits d'union à un ISBN), corriger la capitalisation, etc.
- Il est possible que la valeur soit correcte, mais qu'elle n'appartienne pas à cette propriété, et qu'elle doive être déplacée dans une déclaration pour une propriété différente (par exemple de ISBN-13 (P212) à ISBN-10 (P957)).
- Il est possible que l'identifiant ait étendu sa portée et que l'expression régulière doive être adaptée (par exemple, un identifiant utilise maintenant jusqu' à 15 chiffres et non plus 10 comme lors de sa définition initiale).
- Il est enfin possible que l'élément soit une exception rare mais justifiée à la contrainte, et rien ne doit alors être changé.
Paramètres
Cette contrainte a un paramètre obligatoire et un autre optionnel :
- format as a regular expression (P1793)
- Contient le format. Doit contenir exactement une valeur (no value Help ou unknown value Help ne sont pas autorisés), qui doit être une expression régulière valide.
- syntax clarification (P2916)
- Contient une description du format compréhensible par un humain. Peut-être spécifié plusieurs fois pour différentes langues.
Avertissement : format as a regular expression (P1793) est également souvent utilisé comme une déclaration de niveau supérieur d'une propriété, mais cet usage ne constitue pas une contrainte : pour spécifier un format contrainte, une déclaration property constraint (P2302)format constraint (Q21502404) avec le qualificatif format as a regular expression (P1793) doit être utilisée. |
Exemples
Exemple 1
Les valeurs de image (P18) doivent se terminer avec certaines extensions, comme .jpg
ou .png
.
property constraint |
| ||||||||||||
add value |
Exemple 2
Utilisation du paramètre syntax clarification (P2916) pour expliquer l'expression régulière avec un texte lisible par un humain. Par exemple, la valeur de IPA transcription (P898) ne contient pas le caractère : (deux points) ni le caractère ' (apostrophe). Le caractère correct est ː (longueur) ou ˈ (stress). Cette expression régulière est difficile à comprendre sans explication.
property constraint |
| |||||||||||||||||||||||||||
add value |
Modèle
Quand la contrainte figure sur la propriété, le modèle suivant est automatiquement affiché sur la page de discussion de la propriété. Le modèle est créé par Module:Constraints en utilisant Template:Constraint, appelé à partir de Template:Property documentation. Les traductions sont définies sur Module:i18n/constraints.
(?i).+\.(jpg|jpeg|jpe|png|svg|tif|tiff|gif|xcf|pdf|djvu|webp)|
”: value must be formatted using this pattern (PCRE syntax). (Help)List of violations of this constraint: Database reports/Constraint violations/P18#Format, SPARQL
Listes
Listes des propriétés définies avec des contraintes sur le format.
- Category:Properties with format constraints
- SPARQL query - click the execute button at the linked page to see the query result.