Aide:QuickStatements

Icône utilisée sur Commons par les modèles qui alimentent Wikidata en utilisant QuickStatements

QuickStatements

2019 Coolest Tool Award Winner

in the category
Editor

QuickStatements est un outil, écrit par Magnus Manske, qui permet de modifier les éléments Wikidata, à partir d'un ensemble de commandes texte. L'outil peut ajouter et supprimer des déclarations, des libellés, des descriptions et des alias ; ainsi que d'ajouter des déclarations avec des qualificatifs et des sources optionnels. La séquence de commandes peut être saisie dans la fenêtre d'importation ou créée dans une feuille de calcul ou d'un éditeur de texte, puis collée. Elle peut également être créée par un code externe comme Lua appelé à partir d'un modèle et passé en URL. Les données éditées dans OpenRefine peuvent également être exportées au format QuickStatements.

Les outils

Quickstatement a été modifié et réécrit plusieurs fois. Il est recommandé d’utiliser la version actuelle à chaque fois que possible. Voici les versions actuellement disponibles :

• QuickStatements Version 2 (V2) réécrite (ou nouvelle interface) ← version actuelle
• Versions antérieures
  • QuickStatements Version 2 (V2) original (ou ancienne interface)
  • QuickStatements Version 1 (V1) (ne fonctionne plus)

La syntaxe peut varier légèrement entre les versions. Le reste de ce document décrit la syntaxe de la version actuelle, tout en indiquant les parties qui n’étaient pas supportées par les versions antérieures.

Syntaxe de la séquence de commandes

Cette section décrit la syntaxe utilisée depuis la version V1 de l'outil, référencée comme commandes V1.

Ajouter une déclaration simple

Vous pouvez spécifier les déclarations à ajouter en tapant/collant une ligne par instruction dans la zone d'entée de texte de l'outil. Les différentes parties de la déclaration sont séparées par un caractère TAB, ou des caractères "|". Chaque commande est sur une nouvelle ligne, ou séparée par les caractères "||". Conseil: Vous pouvez aussi utiliser une feuille de calcul Microsoft Excel ou LibreOffice Calc ; copier/coller les cellules insère automatiquement les TABs. Des éditeurs comme Notepad++ permettent le remplacement de n'importe quel caractère par un caractère TAB (\t).

Chaque déclaration doit doit consister en un élément, une propriété, et une valeur.

Une entité peut être un élément, une propriété, ou, uniquement dans QuickStatements version 2, un lexème, une forme ou un sens. Une valeur peut être une autre entité, une chaîne de caractères, un temps, les coordonnées d'un lieu ou une quantité, selon le type de la propriété, ou une des valeurs spéciales somevalue ou novalue (voir Special:MyLanguage/Help:Statements#Aucune valeur ou valeur inconnue).

Format de chaque partie :

• Les Éléments sont toujours de la forme Qxx sur Wikidata. Sur Commons, ils sont toujours de la forme Mxx. Dans QuickStatements version 1, on pouvait utiliser un nom d'article au lieu du q-code, si l'on remplissait une valeur xxwiki dans la zone de saisie au-dessus de la zone de texte ; le bon numéro d'article (si disponible) a été récupéré automatiquement.

  Exemple : Q4115189 TAB P31 TAB Q1

  Signifiant : ajouter à Wikidata Sandbox (Q4115189)instance of (P31)Universe (Q1)

• Les Propriétés de la forme Pxx.
• Lexèmes sous la forme Lxxx.
• Formes sous la forme Lxxx-Fyy.
• Sens sous la forme Lxxx-Syy.
• Les chaînes de caractères (incluant les URLs et les valeurs numériques des champs texte, par exemple dans les valeurs des propriétés d'identifiants externes) doivent être entre "guillemets". Beaucoup de déclarations ont des valeurs en format chaîne, y compris les identifiants externes (comme VIAF ID (P214)), les noms de fichiers (comme image (P18)) ou autre noms de pages (comme Commons category (P373)).

  Exemple : Q41576278 TAB P373 TAB """Antoni Ignacy Mietelski"""

  Signifiant : ajoute Antoni Ignacy Mietelski (Q41576278)Commons category (P373)Antoni Ignacy Mietelski

  Attention : Certains caractères de la chaîne semblent embrouiller l'outil, notamment : « _ » (soulignement), « " » (chevrons), «   » (espace), « = », et peut-être plus. L'ajout d'URL avec ces caractères, comme celui-ci ou cela pourrait échouer. Les chaînes et les URL contenant ces caractères peuvent fonctionner lors de l'interaction avec l'outil via l'interface, mais échouer lors de l'interaction via l'URL.

• Le texte monolingue doit accompagner le préfixe, deux points et le texte entre guillemets, par exemple fr:"Quelque texte"

  Exemple : Q1214098 TAB P1476 TAB pl:"Krzyżacy"

  Signifiant : ajoute The Knights of the Cross (Q1214098)title (P1476)"Krzyżacy" (polonais)

• Les valeurs de temps doivent suivre le même format que +1967-01-17T00:00:00Z/11, où /11 désigne la précision. La précision peut prendre une de ces valeurs : 0 - milles milliards d'années, 1 - cents de millions d'années, ..., 6 - millénaire, 7 - siècle, 8 - décennie, 9 - an (valeur par défaut), 10 - mois, 11 - jour, 12 - heure, 13 - minute, et 14 - seconde.

  Exemple : Q41576483 TAB P569 TAB +1839-00-00T00:00:00Z/9

  Signifiant : ajoute Bronisław Podbielski (Q41576483)date of birth (P569)+1839

  Utilisez « - » pour les dates avant J.-C., et utilisez au moins 4 chiffres.

  Ajoutez un "/J" supplémentaire si vous voulez utiliser la date du calendrier Julien (voir cette liste pour comprendre à quel endroit cela doit être fait).

  Si vous envoyez votre travail à l’API, utilisez "%09" à la place du symbole TAB, "%2B" à la place du symbole "+", "%3A" à la place du symbole ":", et "%2F" à la place du symbole "/".

• Cooordonées du lieu au format @LAT/LON, avec LAT et LON sous-forme de nombre décimaux.

  Exemple : Q3669835 TAB P625 TAB @43.26193/10.92708

  Signifiant : ajoute une localisation à San Dalmazio (Q3669835)

• Quantité au format quantité~précisionUxx, quantité et précision étant des nombres rationnels et Uxx le numéro d’identifiant d’une unité (Qxx). Les valeurs Unit et tolerance sont optionnelles. Ne laissez aucune espace dans la définition.

  La version 1 de QuickStatements utilisait une syntaxe différente pour les quantités : amount[lower,upper]Uxx, où amount, lower et upper étaient des nombres rationnels (respectivement quantité, limite inférieure et limite supérieure).

  lower, upper sont optionnels et doivent être présents ensemble, ou bien manquer tous les deux. S'ils sont présents, ils doivent être encapsulés entre crochets et séparés par des ,.

  amount, lower and upper doivent utiliser le . comme séparateur décimal, ne doivent pas utiliser de séparateur de milliers et peuvent être préfixés par + ou -.

  10, 10U11573, -10[-12.5,-7.5], 0[-5,5]U11573 sont des quantités valides (où U11573 est le metre (Q11573)).

  Les quantités avec tolérance peuvent être saisies comme 1.2~0.3 (dans QuickStatements version 2), ce qui est le même que 1.2[0.9,1.5] (dans QuickStatements version 1) et signifie 1.2±0.3. Notez qu'en raison de la façon dont les ordinateurs fonctionnent avec les nombres à virgule flottante, le format d'entrée de la version 2 peut produire des résultats indésirables lorsque vous travaillez avec des nombres décimaux.

• somevalue pour unknown value Help
• novalue pour no value Help. A la fois novalue et somevalue doivent être utilisés sans guillemets autour. Ces deux déclarations fonctionnent réellement en tant que déclarations de création d'éléments en utilisant les mots-clé CREATE et LAST.

Ajouter une déclaration avec des qualificatifs

Chaque "triplet" de déclaration peut être suivi par un nombre illimité de "paires de qualificatifs" propriété TAB valeur.

Exemple: Q41577083 TAB P570 TAB +1600-00-00T00:00:00Z/7 TAB P1319 TAB +1586-00-00T00:00:00Z/9

Signifiant : ajouter Gian Federigo Bonzagna (Q41577083)date of death (P570)16e siècleearliest date (P1319)+1586

Ajouter une déclaration avec des sources

Chaque déclaration peut être suivie par un nombre illimité de sources sous la forme de « paires » propriété source TAB valeur. La propriété source est identique à une propriété « normale », sauf qu'on la spécifie sous la forme Sxx au lieu de Pxx.

Exemple: Q22124656 TAB P21 TAB Q6581097 TAB S143 TAB Q24731821 TAB S813 TAB +2017-10-04T00:00:00Z/11

Signifiant: ajouter à Gotō Ichijō (Q41577600)sex or gender (P21)male (Q6581097) la référence imported from Wikimedia project (P143)Commons Creator page (Q24731821)retrieved (P813)4 October 2017

Signification: Ajoute à Gotō Ichijō (Q22124656)sex or gender (P21)male (Q6581097) la référence imported from Wikimedia project (P143)Commons Creator page (Q24731821)retrieved (P813)4 October 2017

Par défaut, toutes les sources iront dans le même « groupe de références » (un bloc de paires propriété/valeur). Si vous voulez créer plus d’un groupe de référence dans une seule ligne de commande, préfixez simplement la première propriété de source du nouveau groupe avec un point d’exclamation: "!Sxx" à la place de "Sxx". (dans le premier groupe de référence, le "!" est optionnel et n’influencera pas le résultat.)

Notes :

• Les déclarations existantes avec une correspondance exacte (propriétés et valeurs) ne seront pas ajoutées une nouvelle fois ; cependant des références supplémentaires peuvent être ajoutées à une déclaration.
• Vous pouvez combiner qualificatifss et références dans la même commande. Il suffit d'utiliser Sxx au lieu de Pxx pour les sources.
• Dans la version 1 de QuickStatements, chaque source représentait une référence unique, c'est-à-dire qu'elles n'étaient pas regroupées en une seule référence ; c'est corrigé dans la version 2.

Ajouter des libellés, des alias, des descriptions et des liens inter-sites (sitelinks)

Comme pour ajouter des déclarations en texte simple, chaque instruction consiste en un élément, une commande, et une chaîne entre double quotes.

• Pour ajouter un libellé dans un langage spécifique à un élément, utilisez "Lxx" au lieu d'une propriété, avec "xx" comme code langue.

  Exemple : Q340122 TAB Lpl TAB "Cyprian Kamil Norwid"

  Signification : ajouter le libellé en polonais « Cyprian Kamil Norwid » à Cyprian Norwid (Q340122).

• Pour ajouter un alias dans une langue spécifique à un élément, utilisez "Lxx" au lieu d'une propriété, avec "xx" comme code langue, exemple Lfr.

  Exemple : Q340122 TAB Aen TAB "Cyprjan Kamil Norwid"

  Signification: ajouter l'alias en anglais "$allias" à Cyprian Norwid (Q340122)

  Conseil: plusieurs alias peuvent être renseignés en étant séparés par le caractère «|».

  Exemple : Q340122 TAB Aen TAB "Cyprian Kamil Norwid|Cypryan Kamil Norvid"

• Pour ajouter une description dans un langage spécifique à un élément, utilisez "Dxx" au lieu d'une propriété, avec "xx" comme code de langue.

  Exemple : Q340122 TAB Dde TAB "polnischer Dichter"

  Signification : ajouter la description en allemand « polnischer Dichter » à Cyprian Norwid (Q340122).

• Pour ajouter à un élément un lien de site vers une page spécifique, utilisez « Sxxx » au lieu d'une propriété, avec « xxx » comme identifiant de site (par exemple enwiki, commonswiki).

  Exemple : Q340122 TAB Szhwiki TAB "塞浦路斯·諾爾維特"

  Signifiant : ajoute un sitelink sur le Wikipédia chinois (塞浦路斯·諾爾維特) à Cyprian Norwid (Q340122)

Si vous souhaitez effacer un libellé, une description ou un lien de site, la valeur doit être une chaîne vide. Le reste de la commande fonctionne de la même façon.

Création d'éléments

Vous pouvez aussi créer de nouveaux éléments en insérant une ligne contenant seulement l'instruction "CREATE". Pour ajouter des des déclarations à l'élément nouvellement créé, utilisez le mot "LAST" au lieu de l'identifiant d'élément Q number; la déclaration sera ajoutée au dernier élément créé.

Un exemple de création d'un nouvel élément, en lui ajoutant un lien inter-sites et un libellé:

CREATE

LAST TAB Sfrwiki TAB "Le croissant magnifique!"

LAST TAB Lfr TAB "Le croissant magnifique!"

Signifiant: créer un nouvel élément avec un lien vers la Wikipedia en français w:fr:Le croissant magnifique! avec un libellé en français "Le croissant magnifique!"

Les propriétés peuvent être créées de la même manière avec CREATE_PROPERTY suivi d'une tabulation ou d'un pipe | et du type d'entité, c'est à dire une valeur parmi : commonsMedia, globe-coordinate, wikibase-item, wikibase-property, string, monolingualtext, external-id, quantity, time, url, math, geo-shape, musical-notation, tabular-data, wikibase-lexeme, wikibase-form, wikibase-sense. Ceci est principalement utilisé sur les instances Wikibase tierces, parce que la création de propriétés est restreinte sur Wikidata.

Fusion d'éléments

Vous pouvez fusionner deux éléments. Le premier élément (source) sera fusionné avec le deuxième et (si la fusion s'est bien passée) redirigé vers le deuxième élément (cible).

MERGE TAB Qsource TAB Qcible

Suppression de déclarations

Vous pouvez supprimer une déclaration en préfixant la ligne avec "-".

Exemple : -Q4115189 TAB P31 TAB Q1

Signifiant: supprimer de Wikidata Sandbox (Q4115189)instance of (P31)Universe (Q1)

Les dates avec une précision supérieure à 9 peuvent être supprimées en spécifiant leur valeur exacte :

-Q98426308	P585	+1988-05-11T00:00:00Z/11

Les dates avec une précision inférieure ou égale à 9 peuvent être enregistrées avec 00-00 ou 01-01 comme valeur mois-jour, il peut donc être nécessaire d'essayer les deux pour les effacer :

-Q98426308	P585	+1988-01-01T00:00:00Z/9
-Q98426308	P585	+1988-00-00T00:00:00Z/9

Additionnellement vous pouvez supprimer des déclarations données grâce à leur identifiant de déclaration en utilisant la syntaxe suivante :

-STATEMENT TAB Q1$00000000-0000-0000-0000-000000000000

L’identifiant de déclaration peut être récupéré par :

• Visionnage du code HTML des pages des entités, dans lequel l’identifiant peut-être lu sur les balises <div> de classe "wikibase-statementview"
• API
• le nom d’un nœud RDF pour une déclaration qui peut être récupéré par exemple avec le service de requête (en remplaçant le «-» qui suit l’identifiant de l’entité par un «$»)

Commentaires

Chaque commande peut se terminer par un commentaire qui sera inséré au résumé d'édition. Utiliser la syntaxe /* ... */. Une TAB peut être insérée avant. Les espaces autour du commentaire seront retirées lors de l'exécution de la commande. L'outil ajoute la déclaration et sa référence en deux éditions distinctes. En important les commandes dans le « format version 1 », il n'apparait pas possible d'ajouter un commentaire à l'édition ajoutant la référence. Le commentaire est ajouté à l'édition ajoutant la déclaration.

Exemple : Q4115189 TAB P31 TAB Q1 /* Ceci est un commentaire */

Signification : ajouter à Wikidata Sandbox (Q4115189)instance of (P31)Universe (Q1), avec « Ceci est un commentaire. » dans le résumé de modification.

Syntaxe du fichier CSV

Commandes

En version 2, on peut aussi copier/coller un fichier CSV bien structuré comme alternative à la syntaxe de QuickStatements version 1. Le fichier CSV va fournir les commandes à exécuter. La première ligne est une en-tête décrivant comment interpréter les colonnes.

qid

Toujours la première colonne : l'élément ou l'entité à modifier. S'il est laissé vide, un nouvel élément sera créé. Voir l'exemple de création d'élément ci-dessous.

On peut spécifier les commandes suivantes dans les autre colonnes :

P1234

Un code de propriété (en majuscule) commence une nouvelle instruction. Une valeur dans cette colonne sera la valeur principale de l'instruction, dans la même syntaxe que QuickStatements version 1.

qal1234

Un « qal » en minuscules, suivi d'un numéro de propriété (sans « P ») ajoute un qualificatif à la déclaration actuelle. La valeur de la colonne spécifie la valeur du qualificatif, en syntaxe QuickStatements version 1. Il doit y avoir une colonne « P » avant d'une colonne « qal » pour spécifier à quelle déclaration s'ajoute le qualificatif.

S1234

Un « S » majuscule suivi d'un numéro de propriété (sans « P ») commence une nouvelle source pour la déclaration actuelle. La valeur de la colonne spécifie la valeur de la source, en syntaxe QuickStatements version 1. Il doit y avoir une colonne « P » avant une colonne « S » pour préciser à quelle déclaration s'ajoutera la source.

s1234

Un « s » en minuscule suivi d'un numéro de propriété (sans « P ») ajoute une autre paire propriété-valeur à la source actuelle. La valeur de la colonne spécifie la valeur de la source, en syntaxe QuickStatements version 1. Il doit y avoir une colonne « S » avant une colonne « s » pour spécifier à quelle source s'ajoutera la paire propriété-valeur.

Len

Un « L » majuscule suivi d'un code de langue définit le libellé dans cette langue.

Dfr

Un « D » majuscule suivi d'un code de langue définit la description dans cette langue.

Ade

Un « A » majuscule suivi d'un code de langue ajoute un alias dans cette langue.

Senwiki

Un « S » majuscule suivi d'un identifiant de site ajoute un lien vers ce site.

#

Un caractère d'identifiant numérique définit le résumé des modifications (comment) de la commande précédente. L'outil sépare l'addition d'une déclaration et sa référence en deux modifications. Un commentaire peut être ajouté dans le résumé de chacune des modifications. Pour la déclaration, en mettant une colonne # entre les colonnes de la céclaration et sa référence, et pour la référence en mettant une colonne # derrière ses colonnes. Exemple :

qid,P21,#,S143,s813,#
Q22124656,Q6581097,commentaire de la modification pour l'ajout d'une déclaration,Q24731821,+2017-10-04T00:00:00Z/11,commentaire pour référencer la modification ajoutée

Création d'éléments

Pour créer un nouvel élément, le premier élément de la ligne doit être vide, donc la ligne débute par un ,.

Par exemple

qid,Lfr,Dfr,P31
,Regina Phalange,personnage de fiction,Q95074

Par exemple

créez un nouvel élément. Compatible avec LibreOffice (coller en cellule A1)

filename	label	description	qid,P31,Len,Den,P18
Mona Lisa - the Louvre.jpg	Mona Lisa	oil painting by Leonardo da Vinci	=",Q3305213,"""&B2&""","""&C2&""","""""""&A2&""""""""
Mona Lisa - the Louvre.jpg	Mona Lisa	oil painting by Leonardo da Vinci	,Q3305213,"Mona Lisa","oil painting by Leonardo da Vinci","""Mona Lisa - the Louvre.jpg"""

Commandes pour retirer une déclaration

L'en-tête d'une colonne de déclaration peut aussi commencer par "-" pour effacer la déclaration, le libellé, etc. au lieu de l'ajouter (Notez que c'est seulement valable dans l'en-tête de toute la colonne et non pour des valeurs individuelles.). Effacer d'autres types de colonnes n'est pas encore possible et causera une erreur quand la commande est lancée ; cependant les liens de sites et les libellés peuvent être retirés en les définissants en comme une chaîne vide (sans "-" dans l'en-tête de la colonne).

qid,P31,-P31
Q4115189,Q5,Q5

Ajoute à l'élément Bac à sable une valeur P31 de human (Q5), puis supprime cette même déclaration.

Virgules et guillemets

Les libellés, descriptions, alias et liens de site n'ont pas besoin d'être entre doubles quotes à moins de contenir une virgule (,) ou des doubles quotes (").

Dans ce cas, remplacez tous les guillemets par deux guillemets doubles (par exemple, Toys "R" Us → Toys ""R"" Us) et entourez la chaîne avec une paire de guillemets doubles (par exemple "Toys ""R"" Us").

Exemples : Toys "R" Us et Patterns, Predictors, and Outcome

qid,Len
Q4115189,"Toys ""R"" Us"
Q4115189,"Patterns, Predictors, and Outcome"

Pour ajouter une valeur de type chaîne contenant des guillemets ("), remplacez ces derniers par deux guillemets doubles ("").

Comme n'importe quelle chaîne, entourez-les ensuite de trois guillemets doubles ("""), par exemple """Toys ""R"" Us""".

Exemples pour Q4115189#P370, en particulier Toys "R" Us.

qid,P370
Q4115189,"""Toys ""R"" Us"""
Q4115189,"""Patterns, Predictors, and Outcome"""
Q4115189,"""Wikidata sandbox item 1"""

Exemple combiné

qid,Len,Den,Aen,P31,-P31,P21,P735,qal1545,S248,s214,S143,Senwiki
Q4115189,Douglas Adams,author,Douglas Noël Adams,Q5,Q36180,Q6581097,Q463035,"""1""",Q54919,"""113230702""",Q328,Douglas Adams
Q4115189,"Toys ""R"" Us",testin sample,Toys R Us,Q5,Q36180,Q6581097,Q463035,"""1""",Q54919,"""113230702""",Q328,"Toys ""R"" Us"

Exemples par type de valeur

Les exemples utilisent un élément bac à sable (Q4115189) et peuvent être collés dans Quickstatements pour tester. Cela devrait normalement être sans risque.

Libellé

qid,Len
Q4115189,Sandbox
Q4115189,"Patterns, Predictors, and Outcome"
Q4115189,"Toys ""R"" Us"

Description

qid,Den
Q4115189,Wikidata item for tests
Q4115189,"sample for Patterns, Predictors, and Outcome"
Q4115189,"description sample for Toys ""R"" Us"

Alias

qid,Aen
Q4115189,Wikidata sandbox
Q4115189,"Predictors, Patterns, and Outcome"
Q4115189,"Toys ""4"" You"

Élément

qid,P369
Q4115189,Q5
Q4115189,somevalue
Q4115189,novalue
L123,Q5
L123-S1,Q5
L123-F1,Q5

somevalue est pour unknown value Help, novalue pour no value Help. F1 et S1 doivent exister dans Lexeme:L123 pour que cela fonctionne.

Chaîne de caractères ou identifiant externe (external-id)

qid,P370
Q4115189,"""Sandbox"""
Q4115189,"""Patterns, Predictors, and Outcome"""
Q4115189,"""Toys ""R"" Us"""

Texte monolingue

qid,P1450
Q4115189,en:"Sandbox"
Q4115189,en:"Toys "R" Us"
Q4115189,"en:""Toys ""R"" Us"""
Q4115189,"en:""Patterns, Predictors, and Outcome"""

fr est pour le français

Date/temps

qid,P577
Q4115189,+1856-01-01T00:00:00Z/9
Q4115189,+1856-01-01T00:00:00Z/10
Q4115189,+1856-01-01T00:00:00Z/11

Les précisions sont 9 pour l'année, 10 pour le mois et 11 pour le jour, donc les dates sont respectivement 1856, janvier 1856 et le 1er janvier 1856.

Image/fichier multimédia Commons

qid,P18
Q4115189,"""Frans Breydel - A merry company.jpg"""
Q4115189,"""'Girl Reading' by Mary Colman Wheeler, El Paso Museum of Art.JPG"""
Q4115189,"""Kaubalaeva ""E. Russ"" vrakk.jpg"""
Q4115189,"""''L'empereur Napoleon III'' de Franz-Xaver Winterhalter.jpg"""

Les images sont :

• File:Frans Breydel - A merry company.jpg
• File:'Girl Reading' by Mary Colman Wheeler, El Paso Museum of Art.JPG (comprend une apostrophe simple et une virgule)
• File:Kaubalaeva "E. Russ" vrakk.jpg (comprend des guillemets)
• File:''L'empereur Napoleon III'' de Franz-Xaver Winterhalter.jpg

URL

qid,P856
Q4115189,"""https://example.com/"""
Q4115189,"""https://example.com/equalsign=test"""
Q4115189,"""https://example.com/underscore_test"""

Quantité

qid,P1114
Q4115189,10
Q4115189,+20
Q4115189,+3.1415926
Q4115189,-40
Q4115189,5.5U11574
Q4115189,+60U11573
Q4115189,+7.5U11574
Q4115189,-80~1.5
Q4115189,2.2~0.3
Q4115189,+1.2~0.3

U11573 est pour metre (Q11573), U11574 pour second (Q11574). Notez le résultat impair de 1.2~0.3.

Exemple complet

Des exemples complets peuvent être trouvés à Help:QuickStatements/examples.

Exécuter QuickStatements

Utiliser QuickStatements version 2

Écran d'accueil de QuickStatements V2.

Voici comment utiliser QuickStatements (version 2) en mode basique :

1. Allez à https://quickstatements.toolforge.org
2. Assurez-vous d'être connecté avec OAuth et que votre nom soit affiché dans le coin en haut à droite. Sinon, connectez-vous.
3. Cliquez sur "Nouveau lot".
4. Pour travailler avec les données structurées de Wikimedia Commons :
   1. Dans le menu "Créer une nouvelle commande de lot pour" et changer le projet de Wikdata en Commons [Batch mode only!]
   2. Vous avez besoin d'ientifiant "M" au lieu des ientifiants "Q" pour travailler. Chercher les identifiants media pour les fichiers Commons avec l'outil Minefield
   3. Utiliser des déclarations de la forme "MXXXX|PXX|QXXX" our utiliser l'option format CSV
   4. Commencer la requête avec le bouton "Lancer" ou "Lancer en arrière-plan" pour démarrer en mode batch
5. Copiez/collez vos commandes. Voir la syntaxe dans la section ci-dessus.
6. Quand c'est fait, cliquez sur "Importer des commandes dans le format V1" ou "Importer les commandes CSV".
7. L'outil va convertir vos commandes dans une forme lisible. Vérifiez-les puis cliquez "Lancer" ou "Lancer en arrière-plan" pour les executer.
8. Au fur et à mesure du traitement de vos déclarations, vérifiez encore les résultats et cliquez sur "Stop" si vous repérez un problème.
9. L'interface utilisateur vous informe une fois toutes vos déclarations traitées.

• 
  Préparation des commandes dans une feuille de calcul
• 
  Copiez/collez les cellules directement dans la fenêtre d'importation QS
• 
  QS converti vos commandes en langage clair et attend votre accord
• 
  QS exécute les commandes. Le bouton "Stop" vous permet d'interrompre le traitement.
• 
  QS a complété la tâche.

Utiliser QuickStatements version 1

Ecran de l'utilisation de QuickStatements version 1

La version 1 de QuickStatements est toujours disponible, mais plus maintenue. Elle s'est arrêtée de fonctionner pour certains utilisateurs, mais fonctionne encore correctement pour d'autres.

1. Allez à https://wikidata-todo.toolforge.org/quick_statements.php
2. Copiez/collez vos commandes dans la fenêtre
3. Cliquez sur "Do it!"
4. L'interface utilisateur vous avertit quand le traitement de toutes les commandes est terminé.

Utiliser QuickStatements version 2 en mode traitement par lot

Quand utiliser le mode de traitement par lot ?

La version 2 de QuickStatements a un bouton "Lancer en arrière-plan"

Le mode batch (connu aussi comme tâche de fond ou mode batch asynchrone) signifie que vos instructions sont exécutées par un serveur Wikimédia, plutôt qu'à partir de votre navigateur web, ceci présente plusieurs avantages.

• Même si vous fermez votre navigateur ou si votre ordinateur plante, les commandes seront exécutées jusqu'à la dernière.
• Vous pouvez lancer plusieurs traitements par lots en parallèle, sans ralentir votre ordinateur. (Les traitements semblent s'exécuter séquentiellement.)
• Vous obtenez une URL unique pour votre traitement, que vous pouvez réutiliser plus tard. Cette page affiche des statistiques au sujet de votre traitement.
• Pour voir tous vos traitements récents, cliquez sur « Vos derniers lots ». Pour voir les traitements récents des autres utilisateurs, cliquez sur « Derniers lots ».
• Vous ou un administrateur du projet peut arrêter votre traitement en se rendant sur cette URL. Par exemple, si on se rend compte que le traitement est erroné et que vous n'est pas en ligne, un administrateur peut l'arrêter immédiatement (en allant sur la page propre au traitement), plutôt que d'avoir à vous bloquer.
• Si vous découvrez que quelque chose ne s'est pas bien passé, vous pouvez annuler le lot entier après son exécution.

Mais il y a aussi des inconvénients :

• Ceci prend quelques clics de plus, aussi, si vous avez 10 instructions ou moins, il vaut mieux utiliser le mode normal.
• Selon la charge du serveur, le démarrage de votre lot peut prendre un certain temps, de sorte que la vérification des résultats peut ne pas être possible immédiatement.
• Il y a une limite sur le nombre d'instructions dans un lot, et les lots avec plus d'instructions ne se chargent pas correctement (montrant une page vierge et un cercle tournant). Pour les instructions les plus simples, le maximum semble être d'environ 25 000 instructions par lot, mais il est beaucoup plus bas pour les instructions plus complexes.
• Le mode batch semble bien fonctionner pour les instructions simples sans qualificatifs ni références, mais les instructions plus complexes où, par exemple, l'ajout réussi d'un qualificatif dépend de la présence de l'instruction de base, semblent avoir un taux d'erreur beaucoup plus élevé.

Avant de lancer un batch, c'est une bonne idée d'exécuter quelques commandes directement pour voir ce qui sera fait.

Utiliser le mode traitement par lot

1. Préparez vos instructions normalement comme indiqué dans la section Utiliser QuickStatements version 2 ci-dessus.
2. Au lieu d'appuyer sur "Run", appuyez sur "Run in the background".
3. Le menu "Show"/"Your last batches" vous montrera la liste de vos batchs les plus récents, avec des statistiques.

Les statistiques suivantes sont disponibles :

• DONE : nombre d'instructions exécutées sans erreur.
• ERROR : nombre d'instructions ayant échoué.
• INIT : nombre d'instructions restant à exécuter
• RUN : nombre d'instructions actuellement en cours de traitement

Exécuter QuickStatements par URL

Ce que vous devriez voir si vous cliquez sur le lien de l'exemple dans cette section.

Un autre moyen d'exécuter QuickStatements est d'utiliser une URL au lieu de copier/coller les commandes dans la fenêtre "Import". Par exemple, une commande pour ajouter à Emile Justin Merlot (Q37887397)VIAF ID (P214)"96480189" avec la source imported from Wikimedia project (P143)Wikimedia Commons (Q565) serait : Q37887397 TAB P214 TAB "96480189" TAB S143 TAB Q565 Vous pouvez également générer une fenêtre QuickStatements préinitialisée avec https://quickstatements.toolforge.org/#/v1= Q37887397%7CP214 %7C%2296480189%22%7C S143%7CQ565 ou https://quickstatements.toolforge.org/#/v1=Q37887397%7CP214%7C%2296480189%22%7CS143%7CQ565. Les étapes pour convertir la syntaxe V1 en URL sont les suivantes :

1. remplacer TAB par | et le passage à la ligne par ||
2. appliquer à la chaîne de caractères l'encodage de l'URL, qui va remplacer | par %7C, les guillemets par %22, les espaces par %20, la barre oblique / par %2F, etc.
3. ajouter https://quickstatements.toolforge.org/#/v1= en tête de cela

Plusieurs modèles de Commons, comme c:Template:Creator ou c:Template:Artwork utilisent cette technique pour empaqueter les informations à importer dans Wikidata dans une URL cliquable.

Conseils :

• [[File:Commons to Wikidata QuickStatements.svg|20px|link=https://quickstatements.toolforge.org/#/v1=Q37887397%7CP214%7C%2296480189%22%7CS143%7CQ565]] encodera l'URL dans une icône pratique et cliquable : (cliquez dessus mais ne l'exécutez pas (run); si vous le faites, cela ne fonctionnera pas car cet élément possède déjà la propriété).
• Les pages contenant les URLs QuickStatements peuvent être toruvées via Special:LinkSearch (voir ici) ou via une requête de base de données en appelant la table des liens externes (voir par exemple ici).

Clients

- Python

Limitations

La version 2 de QuickStatements ne peut pas actuellement :

• créer plusieurs éléments liés les uns aux autres
• modifier les rangs des déclarations
• ajouter des commentaires lors de l'effacement de déclarations
• spécifier le calendrier pour une déclaration de date
• spécifier la précision ou le globe pour une déclaration de localisation
• ajouter des déclarations à des redirections
• ajouter une deuxième déclaration avec la même propriété et valeur mais avec différentes qualificateurs, car ces qualificateurs s'ajouteront à la première déclaration
• effacer un qualificateurs (sans effacer la déclaration entière)
• effacer seulement la référence (sans effacer la déclaration entière)
• effacer un alias
• actualiser les badges
• créer des lexèmes

Notez que pour utiliser QuickStatements, un compte doit être autoconfirmé. Il n’y a aucun moyen pour un utilisateur se servant d'un compte de robot de marquer ses modifications comme modification de robot (mais un ticket est ouvert à ce sujet ici).

FAQ

QuickStatements peut-il ajouter des déclarations de références avec plus d'une affirmation ?

Oui, QuickStatements actuel peut ajouter des références ayant par exemple à la fois imported from Wikimedia project (P143) et retrieved (P813) (voir ici) ou à la fois stated in (P248) et page(s) (P304).

Comment puis-je m'exercer à utiliser QuickStatements ?

Utilisez le Wikidata Sandbox (Q4115189).

Comment signaler les problèmes avec l'outil ?

Vérifiez avec d'autre utilisateurs sur la page de discussion ou sur Wikidata:Project chat. Les erreurs confirmées devront être signalées sur [https://phabricator.wikimedia.org/maniphest/task/edit/form/1/?projects=tools&subscribers=Magnus sur Phabricator après lecture de mw:How to report a bug.

Où puis-je suggérer de nouvelles fonctionnalités ?

Vous pouvez les demander sur la page Git des outils ou sur User:Magnus Manske/quick statements2, mais soyez conscient que Magnus est très occupé !

Quel est le nombre maximum de commandes que je puisse traiter en une fois ?

Non documenté. Il a déjà été testé avec plus de 11 000 commandes. Mais prenez note que des traitements aussi importants vont prendre plusieurs heures avant de se terminer.

Pratiques recommandées

• QuickStatements permet de traiter d'une seule déclaration à plusieurs milliers par batch. Les très gros batchs ou ceux qui peuvent prêter à controverses doivent être soumis à la procédure d'approbation décrite dans Wikidata:Bots.
• Les utilisateurs doivent éviter de créer des éléments en double.
• Toutes les déclarations doivent avoir une référence (source) comme indiqué dans Help:Sources. Cela peut être moins important pour les identifiants, comme VIAF ID (P214) ou RKDartists ID (P650), etc.
• Les utilisateurs faisant des modifications sont responsables de la correction ou de l'annulation de leurs changements si des problèmes apparaissent. Voir à ce sujet Suppression de déclarations.
• Cet outil ne respecte pas le maxlag. Ce n'est généralement pas un problème car les actions de l'outil sont limitées par les limites de modifications soumises à l'utilisateur. Cela peut cependant poser des problèmes si l'utilisateur n'est pas soumis aux limites de modifications (par exemple les administrateurs).

Utiliser l'API pour démarrer un traitement par lots

Si vous êtes connecté à QuickStatements, vous pouvez obtenir un token sur votre page d'utilisateur. Cette page contient aussi des informations sur comment utiliser le token pour soumettre des traitements par lots avec un programme. Pour que cela fonctionne, il faut avoir déjà lancé au moins un traitement côté serveur manuellement !

Groupes de modifications

QuickStatements V2 crée des groupes de modifications pour tous les traitements individuels. Vous pouvez discuter d'un groupe de modifications en particulier, ou annuler le groupe de modifications en entier.

EditGroups est un autre outil externe, qui ne fait pas partie de QuickStatements. Il fonctionne actuellement sur Wikidata, et il existe aussi une instance pour Commons. Sur les autres instances de Wikibase, il peut ne pas être disponible.

Voir aussi

• instructions sur YouTube
• CSV to quick_statements Outil pour convertir un fichier CSV bien formé en une série de commandes QuickStatements.
• [$tool2 topictagger]
• Zotero export translator to QuickStatements format in zotkat: permet de collecter des références dans Zotero et de les exporter vers QuickStatements pour intégration dans Wikidata.
• Instructions sur l’installation de QuickStatements dans une suite Wikibase

Outils qui exportent vers QuickStatements

• Le traducteur d'exportation Zotero au format QuickStatements dans zotkat permet la collecte de références dans Zotero, qui peuvent ensuite être exportées vers QuickStatements pour être téléchargées sur Wikidata.
• topictagger] : trouve potentiellement manquant main subject (P921)