Open main menu

Допомога:QuickStatements

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

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎dansk • ‎español • ‎français • ‎italiano • ‎magyar • ‎polski • ‎svenska • ‎беларуская (тарашкевіца)‎ • ‎русский • ‎українська • ‎հայերեն • ‎العربية • ‎മലയാളം • ‎中文 • ‎日本語

Іконка, яка використовується у Вікісховищщі шаблонами, які експортують доні у Вікідані за допомогою QuickStatements
Eggbeater stencil narrow.svg
QuickStatements
2019 Coolest Tool Award Winner
in the category
Editor

QuickStatements — це інструмент, написаний користувачем Magnus Manske, який може редагувати елементи Вікіданих на основі простого набору текстових команд. Інструмент може додавати та видаляти твердження, назви, описи та псевдоніми; а також додавати твердження з додатковими кваліфікаторами та джерелами. Послідовність команд можна ввести у вікні імпорту або створити в електронній таблиці, текстовому редакторі та вставити. Вона також може бути створена за допомогою зовнішнього коду, такого як Lua, викликана з шаблону і передана як URL.

Інструменти

Є кілька доступних версій QuickStatements:

QuickStatements Версія 2 (початкова)

Синтаксис послідовності команд

Додавання єдиного твердження

Додайте до тестового вікна сформовані твердження, кожні в окремому рядку. Різні частини твердження розділяються символом TAB, або у версії QuickStatements version 2 також працює "|". Кожна команда з нового рядка, або у QuickStatements version 2 також працює "||"-сепаратор. Порада: Ви також можете використовувати програмне забезпечення для електронних таблиць, наприклад Excel або LibreOffice Calc; копіювання/вставляння комірок повинно автоматично вставляти символи TAB. Текстові редактори, такі як Notepad++, також дозволяють замінити будь-який символ символом TAB.

Кожне твердження повинно складатися з сутності, властивості і значення. Сутність може бути елементом, властивістю, лексемою, формою або сенсом.

Значення може бути іншою сутністю, рядком, часом, місцем або кількістю, залежно від типу властивості, або одним із спеціальних значень невідоме значення або значення не задано (див. Допомога:Твердження#Невідомі чи відсутні значення).

Formatting of each part:

  • Items are always in the form Qxx. In QuickStatements version 1 one could use an article name instead of the q-code, if one filled in a xxwiki value in the input box above the text area; the correct item number (if available) was retrieved automatically.
    Example: Q4115189 TAB P31 TAB Q1
    Meaning: add to Wikidata Sandbox (Q4115189) instance of (P31) Universe (Q1)
  • Properties in the form Pxx.
  • Lexemes in the form Lxxx.
  • Forms in the form Lxxx-Fyy.
  • Senses in the form Lxxx-Syy.
  • Strings (including URLs, and numerical values of text fields, for example external-ID property values) must be in "double quotes". Many statements take values in string format, including external identifiers (like VIAF ID (P214)), filenames (like image (P18)) or other page names (like Commons category (P373)).
    Example: Q41576278 TAB P373 TAB "Antoni Ignacy Mietelski"
    Meaning: add to Antoni Ignacy Mietelski (Q41576278) Commons category (P373) Antoni Ignacy Mietelski
    Caution: Some characters in the string seem to confuse the tool. Those include: "_" (underscore), " (double quote), " " (spaces), "=", and possibly more. Adding URLs with those characters, like this one or this might fail. String and URLs with those characters might work when interacting with the tool through the interface but fail when interacting through URL.
  • Monolingual text prefix text in "double quotes" with the language and a colon, e.g. en:"Some text"
    Example: Q1214098 TAB P1476 TAB pl:"Krzyżacy"
    Meaning: add to The Knights of the Cross (Q1214098) title (P1476) "Krzyżacy" (Polish)
  • Time values must be in format eg +1967-01-17T00:00:00Z/11, where /11 designates the precision. The precision is: 0 - billion years, 1 - hundred million years, ..., 6 - millennium, 7 - century, 8 - decade, 9 - year (default), 10 - month, 11 - day, 12 - hour, 13 - minute, 14 - second.
    Example: Q41576483 TAB P569 TAB +1839-00-00T00:00:00Z/9
    Meaning: add to Bronisław Podbielski (Q41576483) date of birth (P569) +1839
    Use "-" for dates BC; and use at least 4 digits.
  • Location coordinates in the form of @LAT/LON, with LAT and LON as decimal numbers.
    Example: Q3669835 TAB P625 TAB @043.26193/010.92708
    Meaning: add location to San Dalmazio (Q3669835)
  • Quantity in the form of amount~toleranceUxx (amount[lower,upper]Uxx in QuickStatements version 1), with amount, tolerance, lower and upper being a rational number and Uxx being the item number of a unit (Qxx).
    unit is optional.
    tolerance is optional.
    lower, upper are optional. lower and upper must be either both present or not present at all. When present, they should be enclosed in square brackets and separated by ,
    amount, lower and upper must use . as decimal separator, must not use any thousands separator and may be prefixed by + or -.
    Don't leave any space in the quantity.
    10, 10U11573, -10[-12.5,-7.5], 0[-5,5]U11573 are all valid quantities (where U11573 indicates metre (Q11573))
    Quantities with tolerance may be entered as 1.2~0.3 (in QuickStatements version 2), which is the same as 1.2[0.9,1.5] (in QuickStatements version 1) and means 1.2±0.3. Note that due to the way computers operate with floating-point numbers the input format of version 2 may produce undesired results when working with decimal numbers.
  • somevalue for unknown value Help
  • novalue for no value Help

Додавання твердження з кваліфікаторами

За кожним "триплетом" твердження може бути необмежена кількість "пар кваліфікаторів" властивість TAB значення.

Приклад: Q41577083 TAB P570 +1586-00-00T00:00:00Z/11 TAB P1319 TAB +1586-00-00T00:00:00Z/9
Означає: додати до Gian Federigo Bonzagna (Q41577083) date of death (P570) 16. century / earliest date (P1319) +1586

Додавання твердження з джерелами

Кожне твердження може супроводжуватися необмеженою кількістю "пар джерел" властивість джерела TAB значення. Властивість джерела позначається аналогічно до "нормальної" властивості, але використовується форма Sxx замість Pxx.

Приклад: Q22124656 TAB P21 TAB Q6581097 TAB S143 TAB Q24731821 TAB S813 TAB +2017-10-04T00:00:00Z/11
Означає: додати до Gotô Ichijô (Q22124656) sex or gender (P21) male (Q6581097) посилання imported from Wikimedia project (P143) Commons Creator page (Q24731821) / retrieved (P813)

Примітки:

  • Існуючі твердження з точною відповідністю (властивість і значення) не будуть додані ще раз; однак додаткові посилання можуть бути додані до твердження.
  • У QuickStatements версії 1 кожна заява щодо джерела (source claim) представляла окреме посилання, тобто вони не були згруповані в межах одного посилання; тепер це працює належним чином у QuickStatements версії 2.

Додавання назв, синонімів, описів і посилань на сайти

As with adding simple text statements, each command must consist of an item, a command, and a string in double quotes.

  • To add a label in a specific language to an item, use "Lxx" instead of a property, with "xx" as the language code.
    Example: Q340122 TAB Lpl TAB "Cyprian Kamil Norwid"
    Meaning: add Polish label "Cyprian Kamil Norwid" to Cyprian Norwid (Q340122)
  • To add an alias in a specific language to an item, use "Axx" instead of a property, with "xx" as the language code.
    Example: Q340122 TAB Aen TAB "Cyprjan Kamil Norwid"
    Meaning: add English alias "Cyprjan Kamil Norwid" to Cyprian Norwid (Q340122)
  • Щоб додати опис певною мовою для елемента, використовуйте "Dxx" замість властивості, з кодом мови "xx".
    Приклад: Q340122 TAB Dde TAB "polnischer Dichter"
    Означає: додати опис німецькою "polnischer Dichter" до Cyprian Norwid (Q340122)
  • Щоб додати посилання на сайт (sitelink) на вказану сторінку на сайті до елемента, використовуйте "Sxxx" замість властивості, з "xxx" як сайтом (наприклад, enwiki, commonswiki).
    Приклад: Q340122 TAB Szhwiki TAB "塞浦路斯·諾爾維特"
    Означає: додати посилання на сайт (sitelink) на китайську Вікіпедію (塞浦路斯·諾爾維特) до Cyprian Norwid (Q340122)

If you want to remove a label/description/sitelink, the value has to be an empty string and the rest of the command will be the same.

Створення Елемента

Нові Елементи можна створювати за допомогою рядка із єдиної команди "CREATE". Для додавання тверджень до щойно створеного Елемента використовуйте команду "LAST" замість Q-номера. Твердження будуть додані до останнього створеного Елемента.

An example for creating a new item, adding a sitelink, and setting a label:

CREATE
LAST TAB Sfrwiki TAB "Le croissant magnifique!"
LAST TAB Lfr TAB "Le croissant magnifique!"
Meaning: create a new item with a link to French Wikipedia w:fr:Le croissant magnifique! and with French label "Le croissant magnifique!"

Злиття Елементів

You can merge two items. The first item will be merged and (if successful) redirected into the second item.

MERGE TAB Qsource TAB Qdestination

Видалення тверджень

Видалення тверджень можливе вказанням "-" на початку рядка

Приклад: -Q4115189 TAB P31 TAB Q1
Означає: видалити із Wikidata Sandbox (Q4115189) instance of (P31) Universe (Q1)

Коментарі

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-файлів

  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.

У версії 2 можна також вирізати та вставити правильно структурований файл CSV як альтернативу синтаксису, введеному у версії QuickStatements 1. Файл CSV задає команди для виконання. Перший рядок - це заголовок, що описує як інтерпретуються стовпці.

Інші стовпці можуть вказувати такі команди:

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. Sometimes three double quotes before and three double quotes after work instead.

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

Запуск QuickStatements

Використання QuickStatements версії 2

Використання QuickStatements (версія 2) у базовому режимі:

  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.

Використання QuickStatements версії 1

 
Скріншот використання QuickStatements версії 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.

Використання QuickStatements версії 2 у пакетному режимі

Коли використовувати пакетний режим?

 
QuickStatements версії 2 має кнопку "Run in the background" ("Запустити у фоновому режимі")

Примітка: QuickStatements V2 має новий інтерфейс, для нових частин інтерфейсу нижче не застосовується більше!

Пакетний режим (також відомий як запуск у фоновому режимі) означає, що ваші оператори виконуються з сервера Wikimedia, а не з вашого веб-браузера. Це має ряд переваг:

  • Навіть якщо ви закриєте браузер або якщо ваш комп'ютер дасть збій, оператори будуть виконуватися до останнього.
  • Ви можете запускати кілька пакетів паралельно, без уповільнення роботи комп'ютера.
  • Ви отримуєте унікальну URL-адресу для свого пакета, до якого ви можете звернутися пізніше. Ця сторінка показує певну статистику щодо вашого запуску.
  • Ви або адміністратор може зупинити ваш пакет, перейшовши на цю URL-адресу. Наприклад, якщо хтось зрозуміє, що ваш пакет помилковий, а ви спите, адміністратор може негайно зупинити його (перейшовши на сторінку окремого пакета), а не заблокувати вас.

But there are also drawbacks:

  • 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.
  • 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 жовтень 2018, batch edits would also be made as User:QuickStatementsBot instead of as the user submitting the batch.

Перед запуском пакета може бути корисним запустити декілька команд безпосередньо в ручному режимі, щоб отримати повне уявлення про те, що робиться.

Використання пакетного режиму

  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

Запуск QuickStatements через 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", 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).

Обмеження

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 or reference only (without removing statement itself) and aliases
  • update badges
  • create lexemes

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

ЧаПи

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.

Найкращий досвід

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

Див. також