Projet:Wikidata/Atelier/Manuel

Propriétés

Pour retrouver une propriété Wikidata, plusieurs solutions :

1. Consulter les listes indiquées dans Wikidata:Liste des propriétés.
2. Utiliser la page spéciale Liste des propriétés et faire une recherche par « Type de données ».

Options

Liste des paramètres supportés par les fonction formatStatements et formatAndCat de Module:Wikidata. Celles dont le champ d'application inclut "wikicode" peuvent également être utilisées depuis {{Wikidata}}

Sauf indication contraire, les paramètres dont le niveau d'application est "choix des déclarations" sont passés à la fonction p.getClaims et appliqués dans Module:Wikidata/Récup.

Nom	Niveau d'application	Mode d'utilisation	Description
value	au début	Lua et wikicode	Lorsque le paramètre value est non vide, la fonction formatStatements la retourne telle quelle, sans rien faire (la fonction formatAndCat en revanche lui applique linkback et addcat)
expl	au début	Lua et wikicode	Lorsque le paramètre expl est présent, la fonction formatStatements ne fait rien si le paramètre value n'a pas la valeur résultat de {{WD}} (utile pour des données mises à jour mais dont l'utilité dans chaque article est difficile à décider automatiquement).
claims	choix des déclarations	Lua	Liste de déclarations à utiliser, s'impose au fonctionnement normal de Module:Wikidata/Récup.
entity	choix des déclarations	Lua et wikicode	L'identifiant de l'entité Wikidata à utiliser. Par défaut, celle liée à la page. En Lua, on peut passer une entité déjà chargée plutôt que son identifiant.
property	choix des déclarations	Lua et wikicode	Le nom de la propriété à utiliser, sous la forme property = PXX. En Lua, on peut utiliser plusieurs propriétés sous forme de tables
excludespecial	choix des déclarations	Lua et wikicode	Retire les déclarations dont la valeur principale (mainsnak) n'est pas de type "valeur", c'est-à-dire les déclarations "valeur inconnue" ou "aucune valeur". En wikicode : activée par la |excludespecial = true En Lua, activée par un booléen (excludespecial = true)
targetvalue	choix des déclarations	Lua et wikicode	Ne retient que la ou les déclarations dont la valeur du snak principal correspond à la (ou une des) valeurs indiquées
excludevalues	choix des déclarations	Lua et wikicode	Exclut les déclarations dont la valeur du snak principal correspond à la (ou une des) valeurs indiquées
qualifier	choix des déclarations	Lua et wikicode	Seules les déclarations contenant ce qualificatif son retournées. Pour activer l'affichage du qualificatif, voir showqualifiers
qualifiervalue	choix des déclarations	Lua et wikicode	Le qualificatif utilisé par l'argument qualifier doit avoir cette valeur (ou une de ces valeurs, s'il s'agit d'une table ou d'une liste de propriétés séparées par des virgules
excludequalifier	choix des déclarations	Lua et wikicode	Les déclarations contenant ce qualificatif sont exclues
excludequalifiervalue	choix des déclarations	Lua et wikicode	Si ce paramètre est renseigné, excludequalifier n'est activé que lorsque la valeur du qualificatif se trouve dans celles qu'il indique.
withsource	choix des déclarations	Lua et wikicode	Ne retourne que les valeurs contenant une source, utilisant la source indiquée dans la propriété P248 (« affirmé dans »), ou une autre propriété définie par le paramètre sourceproperty
sourceproperty	choix des déclarations	Lua et wikicode	Propriété à utiliser pour le paramètre withsource
rank	choix des déclarations	Lua et wikicocde	Rangs acceptés : preferred normal deprecated valid (= preferred + normal) best (preferred, ou, si aucune ne répond aux autres critères de la requête, normal) Valeur par défaut : best
numval	choix des déclarations	Lua et wikicode	Nombre maximal de valeurs à retourner (les n premières valeurs de la liste établie par les autres paramètres)
withlink	choix des déclarations	Lua et wikicode	Ne retourne que les valeurs contenant un lien vers le site spécifié. Si la valeur du paramètre est simplement true, le site utilisé sera Wikipédia en français.
withdate	choix des déclarations	Lua et wikicode	Ne retourne que les valeurs possédant un qualificatif de date : P585 (« date »), P580 (« date de début »), P582 (« date de fin »)
atdate	choix des déclarations	Lua et wikicode	Exclut les valeurs dont les qualificatifs P580 (« date de début ») ou P582 (« date de fin ») indiquent qu'elle n'était pas valable à la période indiquée. atdate peut-être une date au format wikibase ou au format ISO. Les valeurs sans date ne sont pas exclues (elle peuvent l'être en ayant recours à la fonction withdate)
condition	choix des déclarations	Lua	Pour définir une fonction libre. Si la fonction retourne true, la déclaration sera gardée
sorttype	ordre des déclarations	Lua et wikicode	Manière de classer les déclarations. Valeurs possibles : chronological inverted (chronologique inversé En lua, ce paramètre peut également être une fonction.
conjtype	liste des déclarations	Lua et wikicode	La manière de coordonner les déclarations, en utilisant la fonction conj de Module:Linguistique. Valeurs possibles : and ajoute " et " entre l'avant dernière et la dernière valeur, une virgule entre les autres. or ajout " ou " entre l'avant dernière et la dernière valeur comma des virgules partout new line un retour à la ligne Toute autre valeur donnée au paramètre sera insérée entre chaque valeur (|conjtype = et puis aussi ajoutera "et puis aussi" entre chaque valeurs)
linkback	liste des déclarations	Lua et wikicode	Ajoute un rétrolien vers Wikidata sous forme d'un crayon «  »
addcat	liste des déclarations	Lua et wikicode	Met la page dans une catégorie de suivi (voir Catégorie:Page utilisant des données de Wikidata). Le nom de la catégorie correspond à la valeur du paramètre. Si cette valeur est simplement true, la catégorie est fonction du paramètre property. Attention, ce paramètre peut être source de bugs. Par exemple, si la propriété est utilisée dans une url ou un lien.
removedupes	choix des déclarations (à la fin, dans une fonction différente)	Lua et wikicode	Lorsque, après toutes les mises en forme, deux déclarations sont rendues de la même manière, une seule est conservée.
lang	choix et mise en forme des données	Lua et Wikicode	Langue dans lequel le texte doit être retourné. Lorsqu'une propriété de type "monolingualtext" stockée en qualificatif doit être affichée (par exemple P2096 (« légende de média ») pour les images), seules celles dans la langue concernée seront affichées.
	snak (entité)	Lua et wikicode	Code Wikimédia de la langue utilisée pour afficher les libellés (par défaut : français)
ucfirst	liste des déclarations	Lua et Wikicode	ucfirst=- permet de désactiver cela
statementformat	déclaration	Lua	doit être une fonction fonction(statement) return XX retournant une chaîne. Elle sera appliquée à sur chaque déclaration (permet de simplifier certaines infobox Lua)
showdate	déclaration	Lua et wikicode	Pour afficher la date entre parenthèses en petit pour chaque déclaration en utilisant les mêmes qualificatifs que (withdate). Lorsqu'aucune date n'est trouvée, la valeur est affichée sans aucune date.
displayformat	snak	Lua et wikicode	Pour changer le format par défaut entre chaque valeur. weblink transforme les données de type chaîne en lien web raw retourne un format plus brut parfois utile au codage latitude pour Module:Coordinates longitude pour Module:Coordinates En lua, la valeur du paramètre peut aussi être une fonction.
qualifdisplayformat	snak	Lua et wikicode	Format d'affichage des qualificatifs. Même fonctionnement que le paramètre displayformat. Lorsque ce paramètre est laissé vide, les qualificatifs utilisent le paramètre displayformat comme la valeur principale.
showsource	déclaration	Lua et wikicode	Identifiant d'une source que l'on souhaiterait voir affichée en référence si elle est présente. true affichera toutes les sources utilisant la propriété P248 (« affirmé dans »).
linktopic	snak (temporel)	Lua et wikicode	Type de lien à ajouter aux dates (voir Module:Date). Pour ne mettre aucun lien : linktopic = -
precision	snak (temporel)	Lua et wikicode	Précision avec laquelle les dates doivent être affichées. Valeurs possibles : day month year Valeur par défaut : day
textformat	snak (temporel)	Lua et wikicode	Format d'affichage des intervalles de temps, tels que définis par Module:Date complexe minimum affichera "1995" à la place de "à partir de 1995".
speciallabels	snak (entité)	Lua	Tables de valeurs spéciales à utiliser à la place du libellé Wikidata pour la valeur de certains éléments, par exemple Module:Dictionnaire Wikidata/Métiers.female
labelformat	snak (entité)	Lua	Fonction de mise en forme des libellés
showlang	déclaration	Lua et wikicode	Lorsque la valeur principale est de type "texte monolingue", son code langue est affiché (utilisé par Module:Site officiel)
showqualifiers	déclaration	Lua et wikicode	Qualificatif à retourner entre parenthèses derrière la valeur de la propriété principale demandée. En wikicode sous le format |showqualifiers = P460, en Lua sous le format showqualifiers = "P460" ou showqualifiers = {"P460", "P461"}
showonlyqualifier	déclaration	Lua et wikicode	Qualificatif de même, mais à retourner seul sans la valeur de la propriété principale demandée
link	snak (entité)	Lua et wikicode	Site vers lequel doivent lier les données de type élément. Par défaut : Wikidata en français. Si égal à "-", aucun lien ne sera créé.
defaultlink	snak (entité)	Lua et wikicode	Lorsque le site demandé par le paramètre link ne retourne pas de lien, affiche un lien entre parenthèses vers le site demandé. Par défaut : Wikipédia en anglais ou, si absent, Wikidata. La valeur "-" désactive le paramètre.
defaultlinkquery	snak (entité)	Lua	defaultlinkquery = {property = 'P279'} le lien créé correspondra à celui fourni par l'élément utilisé dans la propriété P279 (« sous-classe de »).
targetunit	snak (quantité)	Lua et Wikicode	Unité dans laquelle doivent être converties les données de type quantité. Les valeurs possibles sont visibles dans Module:Conversion/Données, par exemple km ou km2.
showunit	snak (quantité)	Lua et Wikicode	Manière d'afficher l'unité demandée. Valeurs possibles : 'long' : affiche le nom complet de l'unité (par exemple "12,7 mètres") 'short' affiche l'abréviation conventionnellement utilisée ("12,7 m") '-' : aucune unité affichée défaut : 'short'
rounding	snak (quantité) nombre de chiffres	Lua et Wikicode	Nombre de chiffres significatifs à afficher dans les données de type quantité, après conversion éventuelle (défaut : dépend de la précision indiquée sur Wikidata)
urlpattern	snak (string)	Lua et wikicode	La valeur du paramètre est un chaîne représentant une URL, l'expression "$1" sera remplacée par la valeur Wikidata Avec la propriété P214 (« identifiant VIAF ») et la valeur de paramètre http://viaf.org/viaf/$1, la valeur de l'identifiant VIAF stockée sur Wikidata sera utilisée pour créer un lien externe..
text	snak (string)	Lua et wikicode	Texte à afficher lorsque la valeur crée un lien externe, c'est-à-dire pour les données de type chaîne avec displayformat = "weblink" ou avec le paramètre urlpattern renseigné. Par défaut : la valeur initiale de la déclaration. Utilisé sur Module:Site officiel Module:Bases archi.
novaluelabel	snak (novalue)	Lua et wikicode	Libellé à retourner lorsque la valeur est de type "novalue". Par défaut : "-". En Lua, la valeur peut-être une fonction.

Exemples

Définition des liens

Code	Rendu	Remarques
{{#invoke:Interface Wikidata|formatStatements|entity = Q79 | property = P36}}	Le Caire	Capitale de l'Égypte, format standard
{{#invoke:Interface Wikidata|formatStatements|entity = Q79 | property = P36|link=-}}	Le Caire	Capitale de l'Égypte, sans lien
{{#invoke:Interface Wikidata|formatStatements|entity = Q79 | property = P36|link=wikidata}}	Le Caire	Capitale de l'Égypte, avec lien vers Wikidata
{{#invoke:Interface Wikidata|formatStatements|entity = Q937 | property = P569}}	14 mars 1879	Date de naissance d'Albert Einstein, en utilisant le format standard de Wikipédia en français
{{#invoke:Interface Wikidata|formatStatements|entity = Q937 | property = P569|linktopic = football }}	14 mars 1879	Date de naissance d'Einstein, avec liens spécialisés dans le football
{{#invoke:Interface Wikidata|formatStatements|entity = Q937 | property = P569|linktopic = -}}	14 mars 1879	Date de naissance d'Einstein, sans lien

Rang

Il existe trois types de rang sur Wikidata : "normal", "preferred" et "deprecated". Le rang deprecated est réservé aux données que l'on sait fausse mais que l'on garde pour mémoire, par exemple pour documenter une croyance ancienne qui a été infirmée par des études plus récentes.

Par défaut, seul le rang "preferred" est récupéré, mais le paramètre "rank" permet de changer cela.

Code	Rendu	Remarques
{{#invoke:Interface Wikidata|formatStatements|entity =Q12418 | property = P186}}	Peinture à l'huile (en) et panneau de peuplier (d)	Matériau de la Joconde, affichage par défaut (donc seulement celles avec le rang "preferred" s'il y en a)
{{#invoke:Interface Wikidata|formatStatements|entity =Q12418 | property = P186|rank=valid}}	Peinture à l'huile (en), panneau de peuplier (d) et bois	rank = "valid" accepte les valeur de rang "normal" et "preferred" (par exemple, le matériau d'un chassis qui a été ajouté ultérieurement à la Joconde)
{{#invoke:Interface Wikidata|formatStatements|entity =Q12418 | property = P186|rank=normal}}	Bois	rank = "normal" ne récupère que les données avec un rang "normal", et ignore celles avec un rang "preferred"

Qualificatifs

Les qualificatifs sont des données supplémentaires intégrées à une affirmation Wikidata qu'elle permet de préciser.

Code	Rendu	Remarques
{{#invoke:Interface Wikidata|formatStatements|entity =Q12418 | property = P186|showqualifiers = P518}}	Panneau de peuplier (d)	ne retient que les valeurs ayant un qualificatif P518 (« s'applique à »)
{{#invoke:Interface Wikidata|formatStatements|entity =Q12418 | property = P186|showqualifiers = P518|qualifiervalue=Q1737943}}	Bois	qualifiervalue définit la valeur que possède le qualificatif. Ici, Q1737943 (« châssis ») précise que l'on demande la matériau du chassis. Notez qu'aucune valeur de rang "preferred" n'étant trouvé, un valeur de rang "normal" est retournée.
{{#invoke:Interface Wikidata|formatStatements|entity =Q12418 | property = P186|showqualifiers = P518|rank=valid}}	Peinture à l'huile (en), panneau de peuplier (d) (support de peinture) et bois (châssis)	showqualifiers affiche la valeur des qualificatifs demandé entre parenthèse, après la valeur principale
{{#invoke:Interface Wikidata|formatStatements|entity =Q12418 | property = P186|showdate = true|rank=valid}}	Peinture à l'huile (en), panneau de peuplier (d) et bois (depuis 1951)	si des qualificatifs indiquant la date sont fournis, ils sont affichées

Affichage des sources

{{#invoke:Interface Wikidata|formatStatements|entity =Q12418 | property = P276|sourceproperty = P854}}	Salle 711 (d)
{{#invoke:Interface Wikidata|formatStatements|entity =Q11879536 | property = P460|withsource=Q1645493}}	Lisa Gherardini
{{#invoke:Interface Wikidata|formatStatements|entity =Q11879536 | property = P460|withsource=Q1645493|showsource=true}}	Lisa Gherardini	Montre seulement les valeurs données par la source
{{#invoke:Interface Wikidata|formatStatements|entity =Q153 | property = P231|showsource=true}}	64-17-5

Autres options

Code	Rendu	Remarques
{{#invoke:Interface Wikidata|formatStatements|entity = Q937 | property = P106|conjtype = new line|showdate= true}}	John Lennon (1960-1970) Ringo Starr (16 août 1962 - 1970) Paul McCartney (1960-1970) George Harrison (1960-1970)	conjtype permet de définir le séparateur entre les valeurs (voir Module:Linguistique). Ici "new line" indique qu'il faut revenir à la ligne après chaque valeur.
{{#invoke:Interface Wikidata|formatStatements|entity =Q205309 | property = P793|showdate=true|sorttype=chronological|conjtype =new line}}	Construction (d) (1903) Premier match (d) (6 septembre 1913) Rénovation (1932-1936) Rénovation (1992-1993) Démolition (2006) Fermeture (en) (7 mai 2006)	sorttype = chronological tente de classer les valeurs par ordre chronologique (en se basant sur les qualificatifs). Ici : les événements principaux (d:P:P793) dans l'histoire de l'ancien Stade d'Arsenal.
{{#invoke:Interface Wikidata|formatStatements|entity =Q205309 | property = P793|showdate=true|sorttype=inverted|conjtype = new line}}	Fermeture (en) (7 mai 2006) Démolition (2006) Rénovation (1992-1993) Rénovation (1932-1936) Premier match (d) (6 septembre 1913) Construction (d) (1903)	sorttype = inverted pour inverser l'ordre chronologique
{{#invoke:Interface Wikidata|formatStatements|entity =Q12418 | property = P186|displayformat=raw}}	Q296955 et Q106857865	affiche les identifiants des valeurs (essentiellement utile pour la programmation)
{{#invoke:Interface Wikidata|formatStatements|entity =Q12418 | property = P186|numval=1}}	Peinture à l'huile (en)	retourne les numval première valeurs répondant au reste de la requête (utile notamment pour récupérer une image)
{{#invoke:Interface Wikidata|formatStatements|entity=Q535922 | property=P172 |expl= |value={{WD}} }}		avec expl=, pour que la valeur soir retournée il faut value={{WD}}