Open main menu

Help:QuickStatements/it

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

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

Icona usata su Commons dai template che caricano i dati su Wikidata usando QuickStatements

QuickStatements è uno strumento scritto da Magnus Manske, che può modificare elementi di Wikidata, basato su un semplice insieme di comandi comandi testuali. Lo strumento può aggiungere o rimuovere dichiarazioni, etichette, descrizioni, alias; può anche aggiungere dichiarazioni con qualificatori e fonti. La sequenza dei comandi può essere digitata nella finestra di import, o creati in un foglio elettronico o in un editor di testo e poi incollato. Può anche essere creato da codice esterno, come del codice Lua richiamato da un template e passato come URL.

Contents

Gli strumenti

Sintassi dei comandi

Aggiungere una semplice dichiarazione

Puoi indicare la dichiarazione aggiungendo per copia/digitazione una riga per dichiarazione nell'area per il testo dello strumento. Le differenti parti della dichiarazione vanno separate da un carattere TAB, in QuickStatements versione 2 puoi usare anche il carattere "|". Ogni comando va messo in una nuova linea, in QuickStatements versione 2 puoi usare anche i caratteri "||". Suggerimento: Puoi anche usare un foglio elettronico come Excel o LibreOffice Calc; copiare e incollare le celle dovrebbe inserire automaticamente i TAB. Anche editor come Notepad++ consentono la sostituzione di qualsiasi simbolo con un TAB.

Ogni dichiarazione consiste di un elemento, una proprietà, e un valore. Un valore può essere un altro elemento, una stringa, una data/orario, un luogo, o una quantità, dipende dal tipo di proprietà.

Formattazione di ogni parte:

  • Elementi sono sempre nella forma Qxx. Nella versione 1 dello strumento si poteva usare il nome della voce al posto del q-code, se si compilava con un valore xxwiki la casella sopra l'area di testo; il numero di elemento corretto (se disponibile) veniva recuperato automaticamente.
    Esempio: Q4115189 TAB P31 TAB Q1
    Significato: aggiungi a Wikidata Sandbocs (Q4115189) instance of (P31) Universe (Q1)
    Come surrogato per <valore sconosciuto> si può usare l'item placeholder for <somevalue> (Q53569537) perché sarà successivamente sostituito da un bot.
  • Proprietà nella forma Pxx.
  • Stringhe (compreso URL, e valori numerici di campi testuali, per esempio valori per proprieta ID-esterni) deve essere compreso in "virgolette doppie". Molte dichiarazioni sono scritte in formato stringa, compreso identificatori esterni (come VIAF ID (P214)), nomi dei file (come image (P18)) o altri nomi di pagina (come Commons category (P373)).
    Esempio: Q41576278 TAB P373 TAB "Antoni Ignacy Mietelski"
    Significato: aggiungi a Antoni Ignacy Mietelski (Q41576278) Commons category (P373) Antoni Ignacy Mietelski
    Attenzione: Alcuni caratteri nella stringa possono confondere lo strumento. Fra questi: "_" (sottlineato), " (virgolette doppie), " " (spazi), "=", e forse più. Aggiungere URL con questi caratteri, come questo o questo potrebbe fallire. Stringhe e URL con questi caratteri potrebbero lavorare quando interagisci con lo strumento utilizzano l'interfaccia ma potrebbe fallire quando interagisci mediante URL.
  • Testo monolingua prefissa il testo nelle "virgolette doppie" con la lingua e una virgola, es. it:"del testo"
    Esempio: Q1214098 TAB P1476 TAB pl:"Krzyżacy"
    Significato: aggiungi a The Knights of the Cross (Q1214098) title (P1476) "Krzyżacy" (Polacco)
  • Data e ora i valori devono essere nel formato +1967-01-17T00:00:00Z/11, dove /11 indica la precisione. La precisione è: 0 - miliardi di anni, 1 - cento milioni di anni, ..., 6 - millennio, 7 - secolo, 8 - decennio, 9 - anno (default), 10 - mese, 11 - giorno, 12 - ora, 13 - minuto, 14 - secondo.
    Esempio: Q41576483 TAB P569 TAB +1839-00-00T00:00:00Z/9.
    Significato: aggiungi a Bronisław Podbielski (Q41576483) date of birth (P569) +1839
    Usa "-" per date a.C.; e usa almeno 4 cifre.
  • Coordinate geografiche nella forma @LAT/LON, con LAT e LON come numeri decimali.
    Esempio: Q3669835 TAB P625 TAB @043.26193/010.92708
    Significato: aggiungi le coordinate a San Dalmazio (Q3669835)
  • Quantità nella forma di quantità[inferiore,superiore]Uxx, con quantità, inferiore e superiore che devono essere numeri razionali e Uxx deve essere il numero dell'elemento dell'unità (Qxx).
    L'unità è opzionale. A luglio 2017 sembra che ci siano dei problemi con le unità di misura, vedi qui.
    inferiore, superiore sono opzionali. inferiore e superiore devono essere presenti contemporaneamente o non vanno aggiunte. Quando presenti, dovrebbero essere racchiuse tra parentesi quadre e separate da ,
    quantità, inferiore e superiore devono usare . come separatore decimale, non devono usare nessun separatore per le migliaia e possono essere prefissati da + o -.
    Non lasciare spazi nelle quantità.
    10, 10U11573, -10[-12.5,-7.5], 0[-5,5]U11573 sono tutte quantità valide (dove U11573 indica metre (Q11573))
    Quantità con tolleranza possono essere inserite come 1.2~0.3 (nella versione 2 dello strumento), che è lo stesso di 1.2[0.9,1.5] e significa 1.2±0.3.

Aggiungere dichiarazioni con qualificatori

Ogni "tripletta" di una dichiarazione può essere seguita da un numero illimitato di "coppie di qualificatori" di proprietà TAB valore.

Esempio: Q41577083 TAB P570 TAB +1586-00-00T00:00:00Z/7 TAB P1319 TAB +1586-00-00T00:00:00Z/9
Significato: aggiungi a Gian Federigo Bonzagna (Q41577083) date of death (P570) 16° secolo / earliest date (P1319) +1586

Aggiungere dichiarazioni con fonti

Ogni dichiarazione può essere seguita da un numero illimitato di "coppie di fonti" di proprietà della fonte TAB valore. La proprietà della fonte è identica alla proprietà "normale", tranne che viene usata nella forma Sxx anziché Pxx.

Esempio: Q22124656 TAB P21 TAB Q6581097 TAB S143 TAB Q24731821 TAB S813 TAB +2017-10-04T00:00:00Z/11
Significato: aggiungi a Gotô Ichijô (Q22124656) sex or gender (P21) male (Q6581097) con riferimento imported from Wikimedia project (P143) Commons Creator page (Q24731821) / retrieved (P813)

Note:

  • Le dichiarazioni esistenti con una coincidenza esatta (proprietà e valore) non saranno aggiunte di nuovo; tuttavia ulteriori riferimenti potrebbero essere aggiunti alla dichiarazione.
  • In passato ogni asserzione di fonte rappresentava un riferimento individuale, non venivano raggruppati all'interno di un riferimento; ora in QS versione 2 lavora correttamente.

Aggiungere etichette, alias, descrizioni e sitelink

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 the 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 the 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)
  • To add a description in a specific language to an item, use "Dxx" instead of the property, with "xx" as the language code.
    Example: Q340122 TAB Dde TAB "polnischer Dichter"
    Meaning: add German description "polnischer Dichter" to Cyprian Norwid (Q340122)
  • To add a sitelink to a specific page on a site to an item, use "Sxxx" instead of the property, with "xxx" as the site (e.g. enwiki, commonswiki).
    Example: Q340122 TAB Szhwiki TAB "塞浦路斯·諾爾維特"
    Meaning: add sitelink to Chinese Wikipedia (塞浦路斯·諾爾維特) to Cyprian Norwid (Q340122)

Creazione di elementi

You can create new items by inserting a line consisting only of the word "CREATE". To add statements to the newly created item, use the word "LAST" instead of the Q number, and the statement will be added to the last created item.

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!"

Item merging

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

MERGE TAB Qsource TAB Qdestination

Removing statements

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 Sandbocs (Q4115189) instance of (P31) Universe (Q1)

Commenti

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 Sandbocs (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

Utilizzo di QuickStatements versione 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.

Utilizzo di QuickStatements versione 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.

Utilizzo di QuickStatements versione 2 in modalità batch

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

Using batch mode

  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

Esecuzione di QuickStatements tramite 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).

Limitations

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.

FAQ

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 Sandbocs (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.

Best practices

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

See also