Shortcut: Help:QS

Help:QuickStatements

From Wikidata
Jump to navigation Jump to search
This page is a translated version of the page Help:QuickStatements and the translation is 89% complete.

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎dansk • ‎español • ‎français • ‎italiano • ‎magyar • ‎polski • ‎svenska • ‎русский • ‎українська • ‎العربية • ‎മലയാളം • ‎日本語

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

QuickStatements est un outil, écrit par Magnus Manske, qui peut éditer les éléments Wikidata, à partir d'un ensemble de commandes texte. L'outil peut ajouter ou enlever des déclarations, des libellés, des descriptions et des alias ; et aussi bien, ajouter des déclarations avec des qualificatifs et des sources. La suite des commmandes peut être tapée dans la fenêtre d'entrée ou créée dans une feuille de calcul, un éditeur de texte et collée dedans. Elle peut aussi être créée par un programme externe, comme Lua appelé par un modèle et passée dans l'URL.

Les outils

Syntaxe des commandes

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 dans QuickStatements version 2 par "|". Chaque commande est sur une nouvelle ligne ou dans QuickStatements version 2 séparée par "||". Conseil: Vous pouvez aussi utiliser une feuille de calcul Excel ou 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.

Chaque déclaration doit consister en un élément, une propriété, et une valeur. Une valeur peut être un autre élément, une chaîne de caractères, un temps, les coordonnées d'un lieu, ou une quantité, selon le type de la propriété.

Format de chaque partie:

  • Les éléments sont toujours de la forme Qxx. Dans la Version 1 de l'outil on pouvait utiliser un nom d'article au lieu d'un QID, if one filled in a xxwiki value in the input box above the text area; the correct item number (if available) was retrieved automatically.
    Exemple: Q4115189 TAB P31 TAB Q1
    Signifiant: ajouter Wikidata Sandbox (Q4115189)instance of (P31)  Universe (Q1)
  • Les propriétés de la forme Pxx.
  • Les chaînes (incluant les URLs et les valeurs numériques des champs texte, par exemple dans les valeurs des propriétés d'identifiant externes) doivent être "en double quotes". 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)). Pour une chaîne monolingue, la préfixer du code langue et de deux points, e.g. fr:"texte"
    Exemple: Q41576278 TAB P373 TAB "Antoni Ignacy Mietelski"
    Signifiant: ajouter à Antoni Ignacy Mietelski (Q41576278)Commons category (P373)  Antoni Ignacy Mietelski
    Exemple: Q1214098 TAB P1476 TAB pl:"Krzyżacy"
    Signifiant: ajouter à The Knights of the Cross (Q1214098)title (P1476)  "Krzyżacy" (Polish)
  • Les valeurs de temps doivent être au format +1967-01-17T00:00:00Z/11, où le /11 désigne la précision. La précision est : 0 - un milliard d'années, 1 - cent millions d'années, ..., 6 - millénaire, 7 - siècle, 8 - décade, 9 - année (défaut), 10 - mois, 11 - jour, 12 - heure 13 - minute, 14 - seconde. 11 pour le jour, 10 pour le mois, 9 pour l'année; le défaut est 9.
    Exemple: Q41576483 TAB P569 TAB +1839-00-00T00:00:00Z/9
    Signifiant: ajouter à Bronisław Podbielski (Q41576483)date of birth (P569)  +1839
    Utilisez "-" pour les dates BC; et précisez au moins 4 chiffres.
  • Les coordonnées d'un lieu sont de la forme @LAT/LON, avec LAT et LON en nombres décimaux.
    Example: Q3669835 TAB P625 @043.26193/010.92708
    Signifiant: ajouter des coordonnées à San Dalmazio (Q3669835)
  • Quantités sont de la forme montant[minimum,maximum]Uxx, avec montant, minimum et maximum exprimés en nombres rationnels, Uxx étant l'identifiant d'une unité (Qxx) préfixé par "U" au lieu de "Q".
    unité est optionnel. En juillet 2017 il semblait y avoir quelques problèmes avec les unités, voir ici.
    minimum, maximum sont optionnels. minimum et maximum doivent être présents ou absents ensembles. Quand ils sont présents, ils sont entourés de crochets et séparés par une ,.
    montant, minimum et maximum doivent utiliser le . comme séparateur décimal, ne doivent pas utiliser de séparateur de milliers et peuvent être préfixés par + or -.
    Ne laissez aucun espace dans les quantités.
    10, 10U11573, -10[-12.5,-7.5], 0[-5,5]U11573 sont des quantités valides (U11573 étant le metre (Q11573)).
    Les quantités avec un facteur d'erreur peuvent être spécifiées comme 1.2~0.3 (pour 1.2±0.3) (dans la Version 2 de l'outil).

Addtionally, you can use "somevalue" and "novalue" (without quotes) for concept of unknown value in Wikibase (Q19798648) and concept of no-value in Wikibase (Q19798647), respectively. (See Help:Statements#Unknown or no values.)

Ajouter une déclaration avec qualificatifs

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

Exemple: Q41577083 TAB P570 +1586-00-00T00:00:00Z/11 TAB P1319 TAB +1586-00-00T00:00:00Z/9
qui signifie: ajouter à Gian Federigo Bonzagna (Q41577083)date of death (P570)  16. siècle / earliest 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 à no label (Q41577600)sex or gender (P21)  male (Q6581097) la référence imported from Wikimedia project (P143)  Commons Creator page (Q24731821) / retrieved (P813)

Notes:

  • Les déclarations existantes avec propriétés et valeurs identiques ne seront pas rajoutées une nouvelle fois ; cependant des références supplémentaires peuvent être ajoutées à une déclaration.
  • Par le passé, chaque déclaration représentait une référence individuelle, c.a.d. qu'elles n'étaient pas groupées en une seule référence ; ceci fonctionne maintenant correctement dans la version 2 de QS.

Ajouter des libellés, des alias, des description 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"
    Signifiant: ajouter le libellé polonais "Cyprian Kamil Norwid" à Cyprian Norwid (Q340122)
  • Pour ajouter un alias dans un langage spécifique à un élément, utilisez "Axx" au lieu d'une propriété, avec "xx" comme code langue.
    Exemple: Q340122 TAB Aen TAB "Cyprjan Kamil Norwid"
    Signifiant: ajouter l'alias anglais "Cyprjan Kamil Norwid" à Cyprian Norwid (Q340122)
  • Pour ajouter une description dans un langage spécifique à un élément, utilisez "Dxx" au lieu d'une propriété, avec "xx" comme code langue.
    Exemple: Q340122 TAB Dde TAB "polnischer Dichter"
    Signifiant: ajouter la description en allemand "polnischer Dichter" à Cyprian Norwid (Q340122)
  • Pour ajouter un lien inter-sites vers une page spécifique d'un site à un élément, utilisez "Sxxx" au lieu d'une propriété, avec "xxx" comme site (e.g. enwiki, commonswiki).
    Exemple: Q340122 TAB Szhwiki TAB "塞浦路斯·諾爾維特"
    Signifiant: ajouter le lien inter-sites vers Wikipedia en chinois (塞浦路斯·諾爾維特) à Cyprian Norwid (Q340122)

Création d'élément

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 Wikipedia en français w:fr:Le croissant magnifique! et un libellé français "Le croissant magnifique!"

Fusion d'élément

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)

Commentaires

Every command can have a comment at its end, which will be inserted into the edit summary for the command. Use the /* ... */ syntax. Before this a TAB may be inserted. Spaces around the comment will be removed from the command before processing. The tool splits adding of a claim and its reference in two edits. When using the "version 1 format" import it seems not to be possible to add a comment for the edit adding the reference. The comment is added to the edit adding the claim (if the claim does not exist yet and is added at all).

Example: Q4115189 TAB P31 TAB Q1 /* This is a comment. There are many others like it, but this one is mine. */
Meaning: add to Wikidata Sandbox (Q4115189)instance of (P31)  Universe (Q1), with "This is a comment. There are many others like it, but this one is mine." in the edit summary.

Syntaxe de fichier CSV

Singapore Information-signs Warning-signs-02.jpg This page or section is in the process of an expansion or major restructuring. You are welcome to assist in its construction by editing it as well.

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.

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

P1234
Un code 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 minuscule suivi d'un numéro de propriété (sans le "P") ajoute un qualificatif à l'instruction en cours. Une valeur dans cette colonne sera la valeur du qualificatif, dans la même syntaxe que QuickStatements version 1. Il doit y avoir une colonne "P" avant une colonne "qal" pour indiquer à quelle déclaration est ajouté le qualificatif.
S1234
Un "S" majuscule suivi d'un numéro de propriété (sans le "P") commence une nouvelle source pour l'instruction en cours. Une valeur dans cette colonne sera la valeur de la source, dans la même syntaxe que QuickStatements version 1. Il doit y avoir une colonne "P" avant une colonne "S" pour indiquer à quelle déclaration est ajouté la source.
s1234
Un "s" minuscule suivi d'un numéro de propriété (sans le "P") ajoute une nouvelle paire propriété-valeur à la source courante. Une valeur dans cette colonne sera la valeur de la source, dans la même syntaxe que QuickStatements version 1. Il doit y avoir une colonne "S" avant une colonne "s" pour indiquer à quelle source est ajouté la paire propriété-valeur.
Len
Un "L" majuscule suivi d'un code langue renseigne le libellé dans cette langue.
Dfr
Un "D" majuscule suivi d'un code langue renseigne la description dans cette langue.
Ade
Un "A" majuscule suivi d'un code langue ajoute un alias dans cette langue.
Senwiki
Un "S" majuscule suivi d'un code site ajoute un lien inter-site vers ce site.

Une en-tête de colonne peut aussi commencer par "-" pour enlever 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.)

Par exemple

qid,Len,Den,Aen,P31,-P31,P21,P735,qal1545,S248,s214,S143,Senwiki
Q42,Douglas Adams,author,Douglas Noël Adams,Q5,Q36180,Q6581097,Q463035,1,Q54919,113230702,Q328,Douglas Adams

To create a new item, the first element of the row needs to be empty, so the line starts with a ,.

For example
qid,Len,Den,P31
,Regina Phalange,fictional character,Q5

The double quotes for string values seem to interfere with CSV syntax. Empirically four double quotes before and one after the string have been found to work.

For example
qid,P473
Q304652,""""62"
Q582223,""""34"

Exécuter QuickStatements

Utiliser QuickStatements version 2

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

  1. Allez à https://tools.wmflabs.org/quickstatements/
  2. Assurez-vous d'être loggé à OAuth et que votre nom soit affiché dans le coin en haut à droite. Sinon, loggez-vous.
  3. Cliquez sur "Import commands" and choisissez "Version 1 format" parce que c'est la seule option disponible actuellement.
  4. Copiez/collez vos commandes. Leur syntaxe est décrite dans la section ci-dessus.
  5. Quand c'est fait, cliquez sur "Import".
  6. L'outil va convertir vos commandes en forme lisible. Vérifiez-les puis cliquez "Run" pour les executer.
  7. Au fur et à mesure du traitement de vos déclarations, vérifiez une nouvelle fois les résultats et cliquez sur "Stop" si vous vous apercevez d'un problème.
  8. L'interface utilisateur vous informe de la fin du traitement de vos déclarations.

Utiliser QuickStatements version 1

Copie d'écran de l'utilisation de QuickStatements version 1

QuickStatements version 1 est toujours disponible, mais plus maintenu. Il s'est arrêté de fonctionner pour quelques utilisateurs, tout en fonctionnant correctement pour les autres. Le fork NIOSH's de l'outil est aussi disponible.

  1. Allez à https://tools.wmflabs.org/wikidata-todo/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 batch

Quand utiliser le mode batch ?

QuickStatements version 2 a un bouton "Run in the background"

Le mode batch (connu aussi comme tâche de fond) signifie que vos instructions sont exécutées sur un serveur Wikimédia, plutôt que sur votre navigateur WEB, ceci présente plusieurs avantages.

  • Même si vous fermez votre navigateur ou si l'ordinateur se plante, les instructions seront exécutées jusqu'à la dernière.
  • Vous pouvez lancer plusieurs batchs en parallèle, sans ralentir votre ordinateur.
  • Vous obtenez un URL unique pour votre batch, auquel vous pourrez vous référer plus tard.
  • N'importe qui peut arrêter votre batch en allant sur cet URL. Par exemple si quelqu'un réalise que votre batch est erroné alors que vous dormez, il pourra l’arrêter immédiatement (en allant sur la page de ce batch), plutôt que d'avoir à vous bloquer.

Mais il y a aussi quelques inconvénients :

  • Vous pouvez seulement voir le nombre total d'erreurs, pas les instructions qui les ont produites. Actuellement, vous ne pouvez voir aucune instruction.
  • Ceci prend quelques clics de plus, aussi, si vous avez 10 instructions ou moins, il vaut mieux utiliser le mode normal.
  • Les modifications sont faites en tant que User:QuickStatementsBot, ce qui signifie que vous ne les retrouverez pas dans vos contributions.
  • Il n'est pas facile de vérifier les mise à jour pendant l'attente, car vous n'avez pas la liste des items qui ont déjà été traités.

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

Utiliser le mode batch

  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 : Le nombre d'instructions exécutées sans erreur.
  • ERROR : Le nombre d'instructions ayant échoué.
  • INIT : Le nombre d'instructions restant à exécuter ?
  • RUN : Le nombre d'instructions en cours de traitement ?

Utiliser QuickStatements par URL

Un autre moyen d'exécuter QuickStatements est d'utiliser l'URL au lieu de copier/coller les commandes dans la fenêtre "Import". Par exemple, si nous importons la commande Q37887397 TAB P214 TAB "96480189" TAB S143 TAB Q565 en utilisant la méthode "copier/coller" (image #1 ci-dessous), il va montrer la commande analysée et dans l'URL on pourra lire https://tools.wmflabs.org/quickstatements/#v1=Q37887397%09P214%09"96480189"%09S143%09Q565 ou https://tools.wmflabs.org/quickstatements/#v1=Q37887397%09P214%09%2296480189%22%09S143%09Q565 (image #2 ci-dessous)(la déclaration ajoute à Emile Justin Merlot (Q37887397)VIAF ID (P214)  "96480189" sourcée par imported from Wikimedia project (P143)  Wikimedia Commons (Q565)). Créer l'URL par d'autres moyens évite l'étape initiale d'analyse. Plusieurs modèles de Commons comme Creator or Authority control utilisent cette technique pour rassembler des informations qui peuvent être importées dans Wikidata par un URL cliquable.

Conseils :

  • Un URL ne peut pas contenir d'espaces. Remplacez TAB par "%09", les double quotes par "%22", les espaces par "%20", et les fins de ligne par "%0A".
  • [[File:Commons to Wikidata QuickStatements.svg|20px|link=https://tools.wmflabs.org/quickstatements/#v1=Q37887397%09P214%09%2296480189%22%09S143%09Q565]] va encoder l'URL dans une icône cliquable: Commons to Wikidata QuickStatements.svg (cliquez-la mais ne cliquez pas sur "run" ; ceci ne fonctionnerait pas parce que cet élément a déjà cette propriété).
  • On peut trouver les pages avec des URLs QuickStatements en utilisant la page spéciale Recherche de liens externes (voir ici) ou par une requête sur la table des liens externes (voir par exemple ici).

Limitations

QuickStatements version 2 ne peut pas actuellement :

  • fusionner des éléments (la version 1 le peut)
  • donner des rangs aux déclarations
  • spécifier le calendrier utilisé pour une déclaration de date (donc grégorien par défaut).
  • spécifier la précision ou le globe pour une localisation

FAQ

QuickStatements peut-il ajouter des références avec plusieurs affirmations ?
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 des 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 tool's Bitbucket page.
Où puis-je suggérer de nouvelles fonctionnalités ?
Vous pouvez demander sur tool's Bitbucket page 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 faire traiter en une fois ?
Non documenté. Il a déjà été testé avec plus de 11 000 commandes. Mais prenez note que d'aussi gros batch vont prendre plusieurs heures avant de se terminer.

Bonnes pratiques

  • 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.

Voir aussi