Open main menu

Help:QuickStatements

This page is a translated version of the page Help:QuickStatements and the translation is 46% complete.

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎dansk • ‎español • ‎français • ‎italiano • ‎magyar • ‎polski • ‎svenska • ‎русский • ‎українська • ‎հայերեն • ‎العربية • ‎മലയാളം • ‎中文 • ‎日本語

Symbol zum Hochladen von Commons-Vorlagen zu Wikidata unter der Nutzung von QuickStatements.

QuickStatements ist ein von Magnus Manske erstelltes Werkzeug zur Änderung von Wikidata-Einträgen mithilfe einfacher Befehle. Es kann Aussagen, Bezeichnungen, Beschriftungen und Alternativbezeichnungen hinzufügen und entfernen. Die Befehlssequenz kann im Eingabefenster eingegeben werden oder in einer Tabellenkalkulation, Textbearbeitung erstellt und eingefügt werden. Sie kann auch von externen Programmen oder Code erzeugt werden wie zum Beispiel Lua, das von einer Vorlage aufgerufen wird, und dann als URL weitergereicht werden. In OpenRefine.org bearbeitete Daten können auch in QuickStatements-Format exportiert werden.

Contents

Die Werkzeuge

Es stehen einige QuickStatements-Versionen zur Verfügung:

Befehlschreibweise

Einfache Aussagen hinzufügen

Du willst eine Aussage in Wikidata hinzufügen/importieren. Dazu fügst Du pro Aussage eine Zeile in das Eingabefeld des Tools hinzu.

  • Für Version 1: Die verschiedenen Teile der Aussage trennst Du mit einem TAB
  • Für Version 2: Die verschiedenen Teile der Aussage trennst Du mit einer „Pipe".

Tipp: Wenn Du eine Tabellenkalkulation wie Excel oder LibreOffice Calc verwendest und daraus per Kopieren/Einfügen die Daten übernimmst, werden die TABs automatisch eingefügt. Auch mit Texteditoren wie Notepad++ kannst Du zur Not jedes Trennzeichen durch einen TAB ersetzen.

Jede Aussage muss aus einem Datensatz, einer Eigenschaft und einem Wert bestehen. Ein Datensatz kann ein Objekt, eine Eigenschaft, ein Lexeme, eine Form oder ein Sense sein. Ein Wert kann, abhängig von der Eigenschaft, ein anderer Datensatz, ein Text, eine Zeit, ein Ort oder eine Menge oder aber einer der Spezialwerte somevalue oder novalue (siehe Help:Statements) sein.

Formatierung der einzelnen Teile:

  • Objekte haben immer die Form Qxx. In QuickStatements Version 1 kann auch ein voller Seitenname statt des Q-Codes verwendet werden, wenn ein Wert xxwiki in das Eingabefeld über dem Textfeld angegeben wird; der richtige Q-Code (wenn vorhanden) wird automatisch abgerufen.
    Beispiel: Q4115189 TAB P31 TAB Q1
    heißt übersetzt: Wikidata Sandbox (Q4115189) instance of (P31) Universe (Q1) wird als Aussage hinzugefügt.
  • eine Eigenschaft (Property) in Form von Pxx.
  • ein Lexeme in Form von Lxxx.
  • eine Form in Form von Lxxx-Fyy.
  • einen Sense in Form von Lxxx-Syy.
  • Zeichenketten (Text) (Strings, einschließlich URLs, numerische Werte in Textfeldern, zum Beispiel IDs von externen Institutionen) müssen in "Zollzeichen" eingegeben werden. Viele Aussagen benötigen das Zeichenketten-Format, einschließlich Identifikatoren (wie VIAF ID (P214)), Dateinamen (z. B. image (P18)) oder Seitennamen (z. B. Commons category (P373)).
    Beispiel: Q41576278 TAB P373 TAB "Antoni Ignacy Mietelski"
    heißt: Antoni Ignacy Mietelski (Q41576278) Commons category (P373) Antoni Ignacy Mietelski wird als Aussage hinzugefügt
    Achtung: Ein paar Zeichen in der Zeichenkette scheinen das Werkzeug zu verwirren. Darunter "_" (Unterstrich), " (Zollzeichen), " " (Leerzeichen), "=", und vielleicht noch andere. Wenn Du URLs mit diesen Zeichen eingibst, z. B. diese oder diese kann der Import schiefgehen. Zeichenketten und URLs mit diesen Zeichen funktionieren eventuell mit QuickStatements Version 2, aber schlagen mit [[#Running QuickStatements through URL|]] fehl.
  • Einsprachiger Text Text in "Zollzeichen" nach einem Präfix aus dem Sprachkürzel gefolgt von einem Doppelpunkt (:), z. B: de:"deutschsprachiger Textschnipsel"
    Beispiel: Q1214098 TAB P1476 TAB pl:"Krzyżacy"
    heißt: The Knights of the Cross (Q1214098) title (P1476) "Krzyżacy" (polnisch)
  • Zeitangaben müssen z. B. im Format +1967-01-17T00:00:00Z/11 eingegeben werden, wobei /11 die Genauigkeit anzeigt. Genauigkeitswerte sind: 0 - Milliarden Jahre, 1 - Hundert Millionen Jahre, ..., 6 - Jahrtausend, 7 - Jahrhundert, 8 - Jahrzehnt, 9 - Jahr (Standard), 10 - Monat, 11 - Tag, 12 - Stunde, 13 - Minute, 14 - Sekunde.
    Beispiel: Q41576483 TAB P569 TAB +1839-00-00T00:00:00Z/9
    heißt: Bronisław Podbielski (Q41576483) date of birth (P569) +1839
    Benutze "-" für Daten vor unserer Zeitrechnung; und benutze in jedem Fall vier Stellen.
  • Koordinaten im Format @LAT/LON, wobei LAT und LON als Dezimalzahlen (mit Punkt als Dezimaltrennzeichen) zu schreiben sind.
    Beispiel: Q3669835 TAB P625 TAB @043.26193/010.92708
    heißt: zu San Dalmazio (Q3669835) werden Koordinaten hinzugefügt.
  • Zahlen/Mengen/Maße im Format Zahlenwert~AbweichungUxx (in Version 1: Zahlenwert[Minimalwert,Maximalwert]Uxx), wobei Zahl, Abweichung, Minimal- und Maximalwert je eine rationale Zahl sein muss, und Uxx die Objektnummer einer Maßeinheit (Qxx).
    Kurzfassung für Anfänger: Du kannst einfach eine einfache Zahl als Wert setzen. Benutze keine Tausenderzeichen und statt Komma einen Punkt als Dezimalzeichen.
    Wenn Du eine Maßeinheit dazusetzen willst, suche in Wikidata das Objekt für die Maßeinheit (z. B. metre (Q11573), centimetre (Q174728)) raus und schreibe statt Q einfach U. Also für Meter U11573 und für Zentimeter U174728
    Maßeinheit ist optional.
    Abweichung ist optional.
    Minimalwert, Maximalwert sind optional. Minimalwert und Maximalwert dürfen nur zusammen oder gar nicht verwendet werden. Wenn sie da sind, müssen sie in eckige Klammern gesetzt und mit , getrennt werden.
    Zahlenwerte, Minimalwert und Maximalwert müssen den . als Dezimaltrenner verwenden, dürfen keine Tausendertrennzeichen verwenden und dürfen mit + oder - als Präfix verwendet werden.
    Benutze keinen Leerzeichen in den Angaben! 10, 10U11573, -10[-12.5,-7.5], 0[-5,5]U11573 sind alles gültige Zahlenangaben (wobei U11573 für metre (Q11573) steht).
    Zahlenwerte mit Toleranzen dürfen als 1.2~0.3 angegeben werden (in QuickStatements Version 2), was identisch mit 1.2[0.9,1.5] (in QuickStatements Version 1) ist und 1.2±0.3 bedeutet. Beachte, dass dadurch, wie Computer mit Gleitkommazahlen arbeiten, das Eingabeformat von Version 2 bei Dezimalzahlen zu unerwünschten Ergebnissen führen kann.
  • somevalue für unknown value Help
  • novalue für no value Help

Aussage mit Qualifikatoren hinzufügen

Hinter jedem Aussagen-„Tripel“ kann eine beliebige Nummer an „Qualifikator-Paaren“ aus Eigenschaft TAB Wert stehen.

Beispiel: Q41577083 TAB P570 TAB +1586-00-00T00:00:00Z/7 TAB P1319 TAB +1586-00-00T00:00:00Z/9
Bedeutung: füge zu Gian Federigo Bonzagna (Q41577083) date of death (P570) 16. Jahrhundert / earliest date (P1319) +1586 hinzu

Aussage mit Quellen hinzufügen

Hinter jeder Aussage kann eine beliebige Anzahl an „Quellen-Paaren“ aus Quellen-Eigenschaft TAB Wert stehen. Die Quellen-Eigenschaft funktioniert wie eine „normale“ Eigenschaft, nur mit dem Format Sxx statt Pxx.

Beispiel: Q22124656 TAB P21 TAB Q6581097 TAB S143 TAB Q24731821 TAB S813 TAB +2017-10-04T00:00:00Z/11
Meaning: füge zu Gotô Ichijô (Q22124656) sex or gender (P21) male (Q6581097) mit Quelle imported from Wikimedia project (P143) Commons Creator page (Q24731821) / retrieved (P813) hinzu

Hinweise:

  • Bestehende Aussagen mit exakt gleicher Eigenschaft und Wert werden nicht erneut hinzugefügt; allerdings können zusätzliche Quellen zur Aussage hinzugefügt werden.
  • Früher entsprach jedes „Quellen-Paar“ einer eigenen Referenz, d. h. sie wurden nicht zu einer Referenz gruppiert; das funktioniert jetzt korrekt in QuickStatements Version 2.

Labels, Aliasse, Beschreibungen und Sitelinks ergänzen

Wie beim Hinzufügen einfacher Aussagen muss jeder Befehl aus einem Objekt, einem Befehl und einem Text in Zollzeichen bestehen.

  • Um eine Bezeichnung in einer bestimmten Sprache zu einem Objekt hinzuzufügen, verwende "Lxx" statt einer Eigenschaft, wobei "xx" das Sprachkürzel ist.
    Beispiel: Q340122 TAB Lpl TAB "Cyprian Kamil Norwid"
    Bedeutung: füge die polnische Bezeichnung "Cyprian Kamil Norwid" zu Cyprian Norwid (Q340122) hinzu
  • Um einen Alternativnamen in einer bestimmten Sprache zu einem Objekt hinzuzufügen, verwende "Axx" statt einer Eigenschaft, wobei "xx" das Sprachkürzel ist.
    Beispiel: Q340122 TAB Aen TAB "Cyprjan Kamil Norwid"
    Bedeutung: füge den englischen Alternativnamen "Cyprjan Kamil Norwid" zu Cyprian Norwid (Q340122) hinzu
  • Um eine Beschreibung in einer bestimmten Sprache zu einem Objekt hinzuzufügen, verwende "Dxx" statt einer Eigenschaft, wobei "xx" das Sprachkürzel ist.
    Beispiel: Q340122 TAB Dde TAB "polnischer Dichter"
    Bedeutung: füge die deutsche Beschreibung "polnischer Dichter" zu Cyprian Norwid (Q340122) hinzu
  • Um einen Seitenlink zu einer bestimmten Seite auf einem Wiki zu einem Objekt hinzuzufügen, verwende "Sxxx" statt einer Eigenschaft, wobei "xxx" das Wiki ist (z. B. enwiki, commonswiki).
    Beispiel: Q340122 TAB Szhwiki TAB "塞浦路斯·諾爾維特"
    Bedeutung: füge den Seitenlink zur chinesischen Wikipedia (塞浦路斯·諾爾維特) zu Cyprian Norwid (Q340122) hinzu

Objekterstellung

Du kannst neue Objekte erstellen durch das Einfügen einer Zeile, die ausschließlich aus dem Wort "CREATE" besteht. Um Aussagen zu dem neu erstellten Objekt hinzuzufügen, verwende das Wort "LAST" anstelle des Q-Codes und die Aussage wird zu dem zuletzt erstellten Objekt hinzugefügt.

Ein Beispiel für das Erstellen eines neuen Objektes sowie das Hinzufügen eines Seitenlinks und einer Bezeichnung:

CREATE
LAST TAB Sfrwiki TAB "Le croissant magnifique!"
LAST TAB Lfr TAB "Le croissant magnifique!"
Bedeutung: erstelle ein neues Objekt mit einem Link zur französischen Wikipedia w:fr:Le croissant magnifique! und mit der französischen Bezeichnung "Le croissant magnifique!"

Objekte zusammenlegen

Du kannst zwei Objekte zusammenlegen. Das erste Objekt wird zum zweiten Objekt zusammengeführt und (falls erfolgreich) zu einer Weiterleitung zum zweiten Objekt.

MERGE TAB Qquelle TAB Qziel

Entferne Aussagen

You can remove specific statements by prefixing a line with "-". (To remove labels or descriptions, set them to the empty string.)

Example: -Q4115189 TAB P31 TAB Q1
Meaning: remove from Wikidata Sandbox (Q4115189) instance of (P31) Universe (Q1)

Kommentare

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.

CSV file syntax

  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.

In QuickStatements version 2, one can also cut and paste a properly structured CSV file as an alternative to the syntax introduced in QuickStatements version 1. The CSV file will specify commands to execute. The first row is a header describing how the columns are interpreted.

The other columns may specify the following commands:

P1234
A property ID (uppercase) begins a new statement. The column value specifies the main value of the statement, in QuickStatements version 1 syntax.
qal1234
A lowercase "qal" followed by a property number (without "P") adds a qualifier to the current statement. The column value specifies the value of the qualifier, in QuickStatements version 1 syntax. There must be some "P" column before a "qal" column to specify which statement the qualifier is added to.
S1234
An uppercase "S" followed by a property number (without "P") begins a new source for the current statement. The column value specifies the value of the source, in QuickStatements version 1 syntax. There must be some "P" column before an "S" column to specify which statement the source is added to.
s1234
A lowercase "s" followed by a property number (without "P") adds another property-value pair to the current source. The column value specifies the value of the source, in QuickStatements version 1 syntax. There must be some "S" column before an "s" column to specify which source the property-value pair is added to.
Len
An uppercase "L" followed by a language code sets the label in that language.
Dfr
An uppercase "D" followed by a language code sets the description in that language.
Ade
An uppercase "A" followed by a language code adds an alias in that language.
Senwiki
An uppercase "S" followed by a site ID adds a sitelink to that site.
#
A number sign character sets the edit summary (comment) of the preceding command. The tool splits adding of a claim and its reference in two edits. A comment can be added to the edit summary of each of them. For the claim by putting a "#" column between the columns for the claim and its reference, for the reference by putting a "#" column behind its columns. For example:
qid,P21,#,S143,s813,#
Q22124656,Q6581097,comment to claim adding edit,Q24731821,+2017-10-04T00:00:00Z/11,comment to reference adding edit

Statement column headers may also begin with - to remove the statement. (Note that this is only valid in the header for the whole column, not in individual values.) Removing other column types is not yet supported and will result in an error when the command is run; however, sitelinks and labels can be removed by setting them to the empty string (without - in the column header).

For example
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"

Running QuickStatements

Using QuickStatements version 2

Here is how to use QuickStatements (version 2) in basic mode:

  1. Go to https://tools.wmflabs.org/quickstatements/
  2. Make sure you are logged in OAuth and your name is visible in the upper right corner. If not then log in.
  3. Click "New batch".
  4. Cut and paste your commands. See the syntax in the section above.
  5. When you are done, click "Import V1 commands" or "Import CSV commands".
  6. The tool will convert your commands into human-readable form. Inspect them and click "Run" to execute.
  7. As your statements are being processed, double-check the results, and press "Stop" if you detect a problem.
  8. The user interface will tell you when all statements have been processed.

Nutzung von QuickStatements Version 1

 
Screenshot of using QuickStatements version 1

QuickStatements version 1 is still available, but no longer maintained. It stopped working for some users, while still working fine for others. NIOSH's fork of the tool is also available.

  1. Go to https://tools.wmflabs.org/wikidata-todo/quick_statements.php
  2. Cut and paste your commands into the window
  3. Click "Do it!"
  4. The user interface will tell you when all statements have been processed.

Using QuickStatements version 2 in batch mode

When to use batch mode?

 
QuickStatements version 2 has "Run in the background" button

Note: QuickStatements V2 has a new interface, for the new interface parts of the following doesn't apply any more!

Batch mode (also known as running in the background) means your statements are executed from a Wikimedia server, rather than from your Web browser. This has several advantages:

  • Even if you close your browser or if your computer crashes, the statements will be executed until the last one.
  • You can launch several batches in parallel, without slowing down your computer.
  • You get a unique URL for your batch, to which you can refer later. This page shows some statistics about your run.
  • Anyone can stop your batch by going to this URL. For instance, if someone realizes that your batch is erroneous and you are sleeping, they can stop it immediately (by going to the individual batch page), rather than having to block you.

But there are also drawbacks:

  • You can only see the total number of errors, not the statements that produced an error. Actually, you can not see any statement.
  • It takes a few more clicks, so as a rule of thumb if you only have 10 or fewer statements, then better run them in normal mode.
  • Checking the edits while waiting is not easy, as you don't get a list of the items that have been processed so far.
  • Depending on how busy the server is it might take a time for your batch to start so that checking the results might not be possible immediately.

Prior to 18 Oktober 2018, batch edits would also be made as User:QuickStatementsBot instead of as the user submitting the batch.

Before running a batch, it can be a good idea to run a few statements directly in non-batch mode to get a good view of what is being done.

Verwendung des Stapel-Modus

  1. Prepare your statement normally as described in Using QuickStatements version 2 section above
  2. Instead of pressing "Run", press "Run in background" button.
  3. "Your last batches" will show a list of the most recent batches run by you, with statistics.

The following statistics values are available:

  • DONE: The number of statements that were successful run
  • ERROR: The number of statements that failed
  • INIT: The number of statements left to run
  • RUN: The number of statements being run right now

Running QuickStatements through URL

An alternative way of communicating with QuickStatements is to use URL instead of cutting and pasting commands into import window. That approach worked for QuickStatements V1 and original V2, but no longer works in V2 rewrite. For example in original original V2, if we import Q37887397 TAB P214 TAB "96480189" TAB S143 TAB Q565 statement using cut-and-past method (image #1 below), it will show the parsed statement and in URL field QS will show https: //tools.wmflabs.org/quickstatements/index_old.html/#v1=Q37887397%09P214%09"96480189"%09S143%09Q565 or https://tools.wmflabs.org/quickstatements/index_old.html/#v1=Q37887397%09P214%09%2296480189%22%09S143%09Q565 (image #2 below)(Statement is to add to Emile Justin Merlot (Q37887397) VIAF ID (P214) "96480189" with source imported from Wikimedia project (P143) Wikimedia Commons (Q565)). Creating the URL through some other means can skip the initial step. Many templates on Commons, like c:Template:Creator or c:Template:Authority control use that technique to package information that can be imported to Wikidata into a clickable URL.

Hints:

  • URL cannot have any spaces. Replace TAB with "%09", double quote with "%22", space with "%20", and end-of-line with "%0A" and slash "/" with "%2F".
  • Statements with URL inputs that have "_" or " " can be added through regular interface but not through URL. For example this URL was produced by the tool and it works; however if you click or cut-and-paste it you will end up on a page with slightly different URL, which does not work.
  • [[File:Commons to Wikidata QuickStatements.svg|20px|link=https://tools.wmflabs.org/quickstatements/index_old.html/#v1=Q37887397%09P214%09%2296480189%22%09S143%09Q565]] will encode the URL within a handy clickable icon:   (click it but do not click "run"; pressing it will not work since that item already has that property).
  • Pages with QuickStatements URLs may be located through Special:LinkSearch (see here) or through a database query calling externallinks table (see for example here).

Beschränkungen

QuickStatements version 2 currently cannot:

  • set ranks for statements
  • set comments when removing statements
  • specify calendar for a date statement
  • specify precision or globe for a location statement
  • add URLs with some characters like "_" or "="
  • add statements to redirected items
  • add second statement with the same property and value but with different qualifiers, since additional qualifiers will be added to the first statement
  • remove qualifier only (without removing statement itself)

Note that for using QuickStatements an account needs to be autoconfirmed.

Häufig gestellte Fragen

Can QuickStatements add reference statements with more than one claim?
Yes, current QuickStatements can add references that have for example both imported from Wikimedia project (P143) and retrieved (P813) (see here) or both stated in (P248) and page(s) (P304).
How do I experiment with QuickStatements?
Use Wikidata Sandbox (Q4115189).
How do I report issues with the tool.
Check with other users at the talk page or at Wikidata:Project chat. Confirmed bugs should be reported at tool's Bitbucket page.
Where do I suggest new features?
You can ask at tool's Bitbucket page or at User:Magnus Manske/quick statements2, but be aware that we keep Magnus busy!
What is the maximum number of commands I can enter at once?
Not documented. It was already tested with over 11,000 commands. But note that such large batch runs will take several hours to complete.

Beste Praktiken

  • QuickStatements allows edits ranging from single statement to multi-thousand-item batch runs. Very large runs or potentially-controversial runs should go through approval process described in Wikidata:Bots.
  • Users should avoid creating duplicate items.
  • All statements should have references as per Help:Sources. That might be less important for identifiers, like VIAF ID (P214) or RKDartists ID (P650), etc.
  • Users doing the edits are responsible for fixing or undoing their changes if issues are found. See about statement removal.

Siehe auch