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) doit 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 les ; contrôles actifs de contraintes et Special:ConstraintReport utilise PCRE depuis août 2021 (à la place de java.util.regex auparavent); 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 de 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 doit ê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 ou le modèle. 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. Notez que, au moins pour WikibaseQualityConstraints, le modèle ne doit pas être échappé (par exemple,
/
ne doit pas être échappé en tant que\/
). - 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.