Module:Wikidata/Documentation

Ceci est la page de documentation de Module:Wikidata [modifier] [purger].

Cette sous-page contient les instructions et les catégories de son module d'origine et elle n'est pas destinée à être visualisée directement.

Module permettant d'utiliser de récupérer et de mettre en forme des données issues de Wikidata.

Dans la mesure du possible, ce module devrait être neutre sur le plan linguistique. Pour les textes spécifiquement français, voir Module:Wikidata/I18n.

Fonctions exportables

Fonctions opérant au niveau d'un snak

Nom	Arguments	Description
formatSnak	`snak, params`	Récupère la valeur d'un snak et la met en forme
getDataValue	`snak, params`	Récupère la valeur d'un snak avec une valeur de type "value" et la met en forme
isSpecial	`snak`	retourne `true` si un snak est une valeur spéciale (novalue ou somevalue)
getId	`snak`	retourne l'identifiant Qdd de l'élément utilisé comme valeur d'un snak

Fonctions opérant au niveau d'une affirmation

Nom	Arguments	Description
formatStatement	`params`	Transforme une déclaration individuelle en chaîne wikitexte, selon les mêmes paramètres que stringTable
getDate	`statement, qualifs`	récupère les informations de date stockées dans une déclaration Wikidata (qualificatifs ou valeur principale) et les stocke sous forme de table
getFormattedDate	`statement, params`	récupère la date associée à un déclaration Wikidata comme getDate, mais la retourne sous forme d'une chaîne formattée selon les paramètres `params`
hasQualifier	`claim, acceptedqualifs, acceptedvals, excludequalifiervalues`	retourne `true` si l'affirmation comporte des qualificatifs utilisant les propriétés acceptedqualifs avec les valeurs acceptedvals, et sans les valeurs excludequalifiervalues. Si acceptedqualifs n'est pas renseignée, toutes les propriétés sont acceptées. Si acceptedvals n'est pas renseigné, toutes les valeurs sont acceptées.
getMainId	`claim`	retourne l'identifiant Qdd de l'élément utilisé comme valeur du "mainsnak" d'une déclaration
getFormattedQualifiers	`statement, qualifs, params`	à partir d'une affirmation, retourne une chaîne contenant les qualificatifs demandés. La table params permet de personnaliser l'affichage, voir #Paramètres.
getReferences	`statement`	récupère et affiche la partie références d'une déclaration Wikidata.
addTrackingCat	`property, cat`	catégorise une propriété (ex : `"P18"`) ou une table de propriétés (ex : `{"P18","P2716"}`) dans [[Catégorie:Page utilisant $property]] (par défaut) ou dans la catégorie cat en argument.

Fonctions opérant au niveau d'une entité

Nom	Arguments	Description
sortClaims	`claims, sorttype`	Met en ordre une série de valeurs pour ordre chronologique ou de quantité, voir l'argument "sorttype" pour plus de détail.
filterClaims	`claims, params`	Prend une table d'affirmations, et exclut celles qui ne correspondent pas aux critères donnés dans la table `params`. Pour la liste de ces arguments, voir l'aide ci dessous
getClaims	`params`	Retourne une table d'affirmations (ou nil) en fonction des instructions données dans la table `params`, qui dont contenir une clé `\|entity =` et `\|property =` , et peut contenir de nombreux autres paramètres optionnels, voir #Paramètres.
getIds	`params`	Sélectionne des affirmations de la même manière que `getClaims` met au lieu de retourner les affirmations complètes, elle ne retourne que l'identifiant de son mainsnak (ne fonctionne que pour les données de type élément).
stringTable		Retourne les mêmes affirmations que getClaims, sauf éventuellement celles supprimées par le paramètre removedupes. Chacune est rendue sous forme d'une chaîne en Wikitexte directement utilisable. Les paramètres de mise en forme sont également contenus dans la table params.
formatStatements	`params`	Retourne les mêmes valeurs que stringTable, mais concaténées sous forme de chaîne unique. La méthode de concaténation est définie par le paramètre `conjtype` qui utilise Module:Linguistique. Si les paramètres `linkback` et `addcat` sont activés, un rétrolien et une catégorie de maintenance peuvent également être ajoutés.
formatAndCat	`params`	Même fonction que `formatStatements`, mais ajoute un rétrolien vers Wikidata et une catégorie de maintenance
getTheDate	`params`	affiche une date qui se trouve soit en valeur principale soit en qualificatif de la propriété prop de l'élément item
mainDate	`entity`	Récupère et met en forme la "date principale" que l'on peut associer à l'élément, en fonction de ses propriétés P580 (« date de début »), P582 (« date de fin ») et P585 (« date »)
keyDate	`event, item, params`	Récupère et format une date provenant de l'élément `item`. `event` doit être soit un identifiant de propriété, dans ce cas là, la fonction récupérera les valeurs dans cette propriété, soit un identifiant d'élément. Dans ce cas là, elle cherchera cet élément dans les valeurs de P793 (« événement clé ») et retournera la date indiquée en qualificatif.`event` peut également être une liste d'identifiants sous forme de table, dans ce cas là, la valeur retournée sera celle du premier identifiant pour lequel quelque chose est trouvé. Par exemple `wd.keyDate('Q1417098', 'P1690'}` cherchera la valeur dans P793 (« événement clé ») Q1417098 (« inauguration ») et si elle ne trouve rien, elle cherchera dans P1690 (« ICD-10-PCS »).
getLabel	`entity, lang1, lang2`	Retourne le libellé Wikidata de l'entité en langue donnée par le code lang1 (français par défaut) ; si il est absent, le libellé en langue donnée par le code lang2 (par défaut, l'anglais ou la première langue de Module:Wikidata/Hiérarchie des langues ayant un libellé) et une catégorie de maintenance indiquant la langue utilisée.
siteLink	`entity, project, lang`	retourne un lien vers la page projet demandé ('wikipedia', 'wikivoyage', 'commons') etc. lié à l'entité Wikidata indiquée, dans la langue demandée. Par défaut, la langue est le français et le projet Wikpédia.
formatEntity	`entity, params`	Prend l'identifiant (ou la table de données) donnée en paramètre entité et la transforme, et la retourne sur la forme d'un texte contenant un libellé et éventuellement un lien interne.
getDescription	`entity, lang`	affiche la description Wikidata pour une entité donnée, dans un langue donnée (français par défaut)
getNumericId	`snak`	retourne l'identifiant numérique de l'élément utilisé comme valeur d'un snak
getEntity	`str`	retourne la table de données correpondant à un identifiant (inverse de getEntityId)
getEntityId	`str`	retourne l'identifiant d'une entité Wikidata passée sous la forme d'une table de données (inverse de getEntity)

Fonctions récupérant des données dans plusieurs entités

Nom	Arguments	Description
isSubclass	`class, item, maxdepth`
isinstance	`class, item, maxdepth`
inTransitiveVals	`searchedval, sourceval, query, maxdepth, maxnodes`

Module:Wikidata/Chemin : Implémentation analogue aux PropertyPaths de SPARQL en Lua, plus de détails et exemples dans la page du module.

Nom	Arguments	Description
iterate	`entité, chemin` : iterateur	retourne un itérateur sur toutes les valeurs possibles d’un chemin qui part de l’entité spécifiée. Exemple d’utilisation.
matches	`entité, chemin, valeur` :	retourne une valeur booléenne pour savoir si le chemin spécifié permet d’aller de l’entité « entité » à l’entité « valeur ». « isInstance » au-dessus est équilavente à `path.matches(item, "P31/P279*", class)` par exemple. Maxdepth pour l’instant pas implémenté, mais sans doute possible, il y a déjà une limite en dur dans les chemins).

Divers

Nom	Arguments	Descriptions
Dump	`entity`	affiche le contenu d'une entité Wikidata
sourceStr
frameFun	(frame)	appelle une des fonctions précédentes depuis le frame. Le nom de la fonction est donné en argument 1
addRefAnchor
addLinkback		ajoute un rétrolien (généralement utilisé par `formatStatements{linkback = true}`, mais peut être utile comme fonction indépendante lorsque les données font l'objet de nombreuses manipulations avant leur rendu final
isHere	`searchset, val`	retourne `true` si la chaîne `val` se trouve dans la table `searchset`
addNewValues	`old, new`	ajoute les nouvelles valeurs à une table, seulement si elles ne s'y trouvent pas déjà

Paramètres

Liste des clés pouvant être utilisées dans la table "params" mentionnée ci-dessous.

Choix des déclarations

Paramètres utilisés par la fonction filterclaims et donc indirectement par les fonctions y faisant appel, tels que getClaims et formatStatements.

Nom	Mode d'utilisation	Description
claims	Lua	Liste de déclarations à utiliser. Lorsque ce paramètre est activé, les paramètres `property` et `entity` ne sont pas utilisés pour la récupération des données.
entity	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	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	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	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	Lua et wikicode	Exclut les déclarations dont la valeur du snak principal correspond à la (ou une des) valeurs indiquées
targetclass	Lua et wikicode	Ne retient que la ou les déclarations dont la valeur du snak principal est une instance de la (ou d'une des) classes indiquées, éventuellement via des sous-classes
excludeclasses	Lua et wikicode	Exclut les déclarations dont la valeur du snak principal est une instance de la (ou d'une des) classes indiquées, éventuellement via des sous-classes
targetsuperclass	Lua et wikicode	Ne retient que la ou les déclarations dont la valeur du snak principal est une sous-classe (éventuellement indirecte) de la (ou d'une des) classes indiquées
excludesuperclasses	Lua et wikicode	Exclut les déclarations dont la valeur du snak principal est une sous-classe (éventuellement indirecte) de la (ou d'une des) classes indiquées
maxdepth	Lua et wikicode	Profondeur maximale dans la recherche de sous-classes imbriquées en cas d'utilisation de `targetclass`, `excludeclasses`, `targetsuperclass`, `excludesuperclasses`.
qualifier	Lua et wikicode	Seules les déclarations contenant ce qualificatif sont retournées. Pour activer l'affichage du qualificatif, voir `showqualifiers`
qualifiervalue	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	Lua et wikicode	Les déclarations contenant ce qualificatif sont exclues
excludequalifiervalue	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	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`. Pour accepter n'importe quelle source du moment qu'elle utilise la propriété demandée, mettre la valeur `any`. Pour désactiver ce paramètre, mettre la valeur `-`.
sourceproperty	Lua et wikicode	Propriété à utiliser pour le paramètre `withsource`
isinlang	Lua et Wikicode	Indiquer un code de langue (ou, en Lua, une liste de codes de langues) pour inclure seulement : si les valeurs sont des textes, les textes dans la langue demandée ; sinon, les valeurs ayant la langue demandée comme qualificateur P401 (« »), ou pas de qualificateur P401.
rank	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	Lua et wikicode	Nombre maximal de valeurs à retourner (les n premières valeurs de la liste établie par les autres paramètres)
withlink	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.
atdate	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. Pour demander la valeur à la date d'aujourd'hui utiliser : `\|atdate = today`.
minprecision	Lua et Wikicode	Degré de précision minimum accepté pour les données de type date. Doit être une valeur numérique correspondant au modèle de Wikidata (par exemple année = 9)
condition	Lua	Pour définir une fonction libre. Si la fonction retourne `true`, la déclaration sera gardée
sorttype	Lua et wikicode	Manière de classer les déclarations. Valeurs possibles : `chronological` `inverted` (chronologique inversé) `ascending` par ordre croissant (données de type quantité) `descending` par ordre décroissant (données de type quantité) `alphabetical` par ordre alphabétique (données de type texte ou élément, s'applique alors au libellé) `age` par ordre chronologique des dates de naissances (données de type élément possédant des dates de naissance) `ageinverted` par ordre chronologique inversé des dates de naissances (données de type élément possédant des dates de naissance) `language` priorise certaines langues en les mettant en tête. Permet aussi de trier les qualificatifs, si utilisé en conjugaison avec `showonlyqualifiers`. Pour l'instant l'ordre est arbitraire, français, anglais en premier, des langues latines ensuite^[1] l'identifiant d'une propriété numérique utilisée dans les qualificatifs (par exemple `P1545`) une fonction Lua (pour les appels depuis un module). Voir mw:extension:Scribunto/Lua reference manual#table.sort

Activation / désactivation de Wikidata

Nom	Mode d'utilisation	Description
value	Lua et wikicode	Lorsque le paramètre value est non vide, le module ne cherche pas les données de Wikidata, mais utilise celles fournies localement par ce paramètre. Les fonction formatAndCat en revanche lui applique `linkback` et `addcat`)
expl	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).

Mise en forme des données

Nom	Niveau d'application	Mode d'utilisation	Description
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)
qualifconjtype	snak	Lua et wikicode	Manière de coordonner les qualificatifs. Même fonctionnement que `conjtype`.
default	liste des déclarations	Lua et wikicode	Résultat par défaut à afficher si l'import depuis Wikidata donne un résultat vide.
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	mise en forme des données	Lua et Wikicode	Langue dans lequel le texte doit être retourné.
lang	snak (entité)	Lua et wikicode	Code Wikimédia de la langue utilisée pour afficher les libellés (par défaut : français)
wikidatalang	snak (entité)	Lua et Wikicode	Code Wikimédia de la langue utilisée pour afficher les libellés en l'absence du français (ou de lang) et de l'anglais. Par défaut, la première langue dont il existe un libellé dans la liste Module:Wikidata/Hiérarchie des langues.
ucfirst	liste des déclarations	Lua et Wikicode	Par défaut, la fonction formatStatements ajoute une majuscule en début de texte. `\|ucfirst=-` permet de désactiver cela.
ucfirst_entity	entité	Lua (et Wikicode?)	Parfois le libellé d'une entité qu'on veut formater est en minuscule, cette option permet de forcer la mise en majuscule du libellé quand nécessaire. Mettre `\|ucfirst_wikicode=true (ou toute autre valeur non vide ou ''false'')`.
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 qualificatifs de date : P585 (« date »), P580 (« date de début »), P582 (« date de fin »). 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` et `longitude` pour Module:Coordinates En Lua, `displayformat` peut également être une fonction applicable au snak, ou une table dont les clés sont des types de donnée (`"wikibase-item"`, `"quantity"` etc.) pour que le faire varier en fonction du type de donnée.
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 »). `only` n'affichera que les sources.
linktopic	snak (temporel)	Lua et wikicode	Type de lien à ajouter aux dates (voir Module:Date). Pour ne mettre aucun lien : `linktopic = -`
qualiflinktopic	snak (entité)	Lua et wikicode	Même fonctionnement que le paramètre `linktopic`, applicable aux qualificatifs. Lorsque ce paramètre est laissé vide, les qualificatifs utilisent le paramètre `linktopic` comme la valeur principale.
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`
qualifprecision	snak	Lua et wikicode	Précision avec laquelle les qualificatifs temporels doivent être affichées. Même fonctionnement que `precision`.
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 et wikicode	(En Lua) fonction de mise en forme des libellés prenant comme argument un qid ; (en Lua ou en wikicode) l'une des chaînes de caractères suivantes : `male` ou `female` pour utiliser la P2521 (« forme féminine du libellé ») ou la P3321 (« forme masculine du libellé ») à la place du libellé `gendered` pour utiliser l'une des deux en fonction du P21 (« sexe ou genre ») de l'élément. En Lua, la valeur du paramètre peut aussi être une fonction applicable à un snak.
labelformat2	snak (entité)	Lua et wikicode	(En Lua) fonction de mise en forme des libellés prenant comme argument un libellé ; (en Lua ou en wikicode) l'une des chaînes de caractères `bold` ou `italic` pour mettre le libellé en gras ou en italique.
qualiflabelformat	snak (entité)	Lua et wikicode	Mise en forme des libellés des qualificatifs. Même fonctionnement que le paramètre `labelformat`. Lorsque ce paramètre est laissé vide, les qualificatifs utilisent le paramètre `labelformat` comme la valeur principale.
qualiflabelformat2	snak (entité)	Lua et wikicode	Même fonctionnement que le paramètre `qualiflabelformat` appliqué à `labelformat2`. Ce dédoublement est provisoire (26/09/22)
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éé.
qualiflink	snak (entité)	Lua et wikicode	Site vers lequel doivent lier des qualificatifs. Même fonctionnement que le paramètre `link`. Lorsque ce paramètre est laissé vide, les qualificatifs utilisent le paramètre `link` comme la valeur principale.
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.
qualifdefaultlink	snak	Lua et wikicode	Même fonctionnement que `defaultlink`, applicable aux qualificatifs. Lorsque ce paramètre est laissé vide, les qualificatifs utilisent le paramètre `defaultlink` comme la valeur principale.
defaultlinkquery	snak (entité)	Lua	Lorsque le site demandé par le paramètre link ne retourne pas de lien, ce paramètre définit une requête que `recup.getClaims` utilise pour créer un lien. Par exemple, avec `\|defaultlinkquery = {property = 'P279'}` le lien créé correspondra à celui fourni par l'élément utilisé dans la propriété P279 (« sous-classe de »).
qualifdefaultlinkquery	snak	Lua et wikicode	Même fonctionnement que `defaultlinkquery`, applicable aux qualificatifs. Lorsque ce paramètre est laissé vide, les qualificatifs utilisent le paramètre `defaultlinkquery` comme la valeur principale.
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.
qualiftargetunit	snak	Lua et Wikicode	Unité dans laquelle doivent être converties les qualificatifs de type quantité.
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" (aucune valeur). Par défaut : "-". En Lua, la valeur peut-être une fonction.
unknownlabel	snak (somevalue)	Lua et wikicode	Libellé à retourner lorsque la valeur est de type "somevalue" (valeur inconnue). Par défaut : "inconnu". En Lua, la valeur peut-être une fonction.
returnnumberofvalues	liste des déclarations	Lua	retourne en deuxième valeur le nombre de valeurs récupérées par getClaims (si la fonction est appelée depuis du Wikicode, le nombre sera concaténé au reste de la chaîne retournée

Exemples

Définition des liens

Code	Rendu	Remarques
{{#invoke:Wikidata\|frameFun\|formatStatements\|entity = Q79 \| property = P36}}	Le Caire	Capitale de l'Égypte, format standard
{{#invoke:Wikidata\|frameFun\|formatStatements\|entity = Q79 \| property = P36\|link=-}}	Le Caire	Capitale de l'Égypte, sans lien
{{#invoke:Wikidata\|frameFun\|formatStatements\|entity = Q79 \| property = P36\|link=wikidata}}	Le Caire	Capitale de l'Égypte, avec lien vers Wikidata
{{#invoke:Wikidata\|frameFun\|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:Wikidata\|frameFun\|formatStatements\|entity = Q937 \| property = P569\|linktopic = football }}	14 mars 1879	Date de naissance d'Einstein, avec liens spécialisés dans le football
{{#invoke:Wikidata\|frameFun\|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:Wikidata\|frameFun\|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:Wikidata\|frameFun\|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:Wikidata\|frameFun\|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:Wikidata\|frameFun\|formatStatements\|entity =Q12418 \| property = P186\|showqualifiers = P518}}	Panneau de peuplier (d)	ne retient que les valeurs ayant un qualificatif P518 (« s'applique à »)
{{#invoke:Wikidata\|frameFun\|formatStatements\|entity =Q12418 \| property = P186\|qualifier = 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:Wikidata\|frameFun\|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:Wikidata\|frameFun\|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:Wikidata\|frameFun\|formatStatements\|entity =Q12418 \| property = P276\|sourceproperty = P854}}	Salle 711 (d)
{{#invoke:Wikidata\|frameFun\|formatStatements\|entity =Q11879536 \| property = P460\|withsource=Q1645493}}	Lisa Gherardini
{{#invoke:Wikidata\|frameFun\|formatStatements\|entity =Q11879536 \| property = P460\|withsource=Q1645493\|showsource=true}}	Lisa Gherardini^[2]^,^[3]	Montre seulement les valeurs données par la source
{{#invoke:Wikidata\|frameFun\|formatStatements\|entity =Q153 \| property = P231\|showsource=true}}	64-17-5^[4]^,^[5]^,^[6]
{{#invoke:Wikidata\|frameFun\|formatStatements\|entity =Q153 \| property = P231\|showsource=only}}	^[4]^,^[5]^,^[6]

↑ Introduit pour trier les Modèle:P' dans des {{Infobox Patrimoine mondial}} par exemple, cf. cette discussion.
↑ Giorgio Vasari, Le vite de piu eccellenti architetti, pittori, et scultori italiani, da Cimabue insino a' tempi nostri (œuvre littéraire), 1550 et 1568.
↑ « https://web.archive.org/web/20110508121954/http://www.ub.uni-heidelberg.de/Englisch/news/monalisa.html » (consulté le 19 juin 2020)
1 2 ChEBI (ontologie), EMBL-EBI, consulté le 19 octobre 2016.
1 2 Global Substance Registration System (base de données en ligne), consulté le 14 février 2018.
1 2 CAS Common Chemistry (base de données en ligne), consulté le 9 avril 2021.

Autres options

Code	Rendu	Remarques
{{#invoke:Wikidata\|frameFun\|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:Wikidata\|frameFun\|formatStatements\|entity =Q205309 \| property = P793\|showdate=true\|sorttype=chronological\|conjtype =new line}}	Construction (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:Wikidata\|frameFun\|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 (1903)	sorttype = inverted pour inverser l'ordre chronologique
{{#invoke:Wikidata\|frameFun\|formatStatements\|entity =Q4470 \| property = P50\|showdate=true\|sorttype=P1545\|conjtype = new line}}	Robert Jordan Brandon Sanderson	sorttype = P1545 pour trier dans l'ordre de la série
{{#invoke:Wikidata\|frameFun\|formatStatements\|entity = Q230 \| property = P1448 \| sorttype = language}}	Géorgie (la), Georgia, Gruzie, Georgien, საქართველო, Грузия, Sakartvelas et Gruzija	sorttype = language pour prioriser certaines langues dans les noms officiels
{{#invoke:Wikidata\|frameFun\|formatStatements\|entity = Q2015257 \| property = P1435\|targetvalue = Q9259 \|showonlyqualifier = P1448\| sorttype = language}}	Sanctuaire de l'oryx arabe, Arabian Oryx Sanctuary et Santuario del Oryx árabe	sorttype = language pour prioriser certaines langues dans les noms officiels, cette fois en utilisant "showonlyqualifier" parce que les noms sont stockés en qualificatif de déclarations
{{#invoke:Wikidata\|frameFun\|formatStatements\|entity =Q12418 \| property = P186\|displayformat=raw}}	Q296955 et Q106857865	affiche les identifiants des valeurs (essentiellement utile pour la programmation)
{{#invoke:Wikidata\|frameFun\|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:Wikidata\|frameFun\|formatStatements\|entity=Q535922 \| property=P172 \|expl= \|value={{WD}} }}		avec expl=, pour que la valeur soir retournée il faut value={{WD}}

Projet Scribunto

[1] Introduit pour trier les Modèle:P' dans des {{Infobox Patrimoine mondial}} par exemple, cf. cette discussion.

[wikidata-f27a5aa572e1852bf947d6146dac75b1a60786b6Q1645493-2] Giorgio Vasari, Le vite de piu eccellenti architetti, pittori, et scultori italiani, da Cimabue insino a' tempi nostri (œuvre littéraire), 1550 et 1568.

[wikidata-b119eb22ba0a2c8c99f98f10ea44d39d99285f57-3] « https://web.archive.org/web/20110508121954/http://www.ub.uni-heidelberg.de/Englisch/news/monalisa.html » (consulté le 19 juin 2020)

[wikidata-3b6c0fee962a03a6d955b15e485823194a092c2bQ902623-4] 1 2 ChEBI (ontologie), EMBL-EBI, consulté le 19 octobre 2016.

[wikidata-4840c0bf768d8e02e91866cc4e0e9467d7ef058bQ116031405-5] 1 2 Global Substance Registration System (base de données en ligne), consulté le 14 février 2018.

[wikidata-6d75a2c495a5388b332fdb9ffa6bfad19fba9612Q18907859-6] 1 2 CAS Common Chemistry (base de données en ligne), consulté le 9 avril 2021.

[1]

[2]

[3]

[4]

[5]

[6]