Shortcut: Help:QS

Help:QuickStatements/nl

From Wikidata
Jump to navigation Jump to search

Pictogram dat op Commons wordt gebruikt door sjablonen die naar Wikidata uploaden met behulp van QuickStatements
QuickStatements
2019 Coolest Tool Award Winner
in the category
Editor

QuickStatements (QS) is een hulpmiddel, geschreven door Magnus Manske, dat Wikidata-items kan bewerken, op basis van een eenvoudige set tekstcommando's. Het kan verklaringen, labels, beschrijvingen en aliassen toevoegen en verwijderen; en verklaringen met optionele kwalificaties en bronnen toevoegen. De opdrachtsequentie kan worden getypt in het invoervenster of gecreëerd in een spreadsheet of teksteditor en geplakt. Het kan ook worden gemaakt door externe code zoals Lua, die wordt geroepen vanuit een sjabloon en wordt doorgestuurd als een URL. Gegevens die zijn geedit in OpenRefine kunnen ook worden geëxporteerd in het QuickStatements-formaat.

De hulpmiddelen[edit]

Het hulpmiddel QuickStatements heeft meerdere iteraties en herschrijvingen ondergaan. Gebruik altijd de huidige versie wanneer het mogelijk is. Er zijn verschillende QuickStatements versies beschikbaar:

De syntaxis tussen versies kan enigszins verschillen. De rest van het document beschrijft de syntaxis van de huidige versie, maar markeert delen die niet in de eerdere versies werden ondersteund.

Commando-sequentie syntaxis[edit]

Dit gedeelte beschrijft de syntaxis die sinds versie V1 wordt gebruikt, soms aangeduid als V1-commando's[1].

Een eenvoudige verklaring toevoegen[edit]

U kunt de instructies opgeven die u wilt toevoegen door te typen/plakken in het tekstgebied van het hulpmiddel. Verschillende delen van de instructies worden gescheiden door een TAB of "|"[2] tekens. Elke instructie staat op een nieuwe regel of wordt gescheiden door "||"[2] tekens. Tip: U kunt ook een spreadsheetsoftware gebruiken, zoals Microsoft Excel of LibreOffice Calc; als u de cellen kopieert/plakt, wordt automatisch TAB ingevoegd. Ook teksteditors zoals Notepad++ staat toe dat elk symbool wordt vervangen door het TAB teken (\t).

Elke verklaring moet bestaan uit een entiteit, een eigenschap en een waarde. Een entiteit kan een item, een eigenschap, een lexeem[2], een vorm[2] of een betekenis zijn[2]. Een waarde kan een andere entiteit, een tekst, een tijd, een lokatie of een kwantiteit zijn, afhankelijk van het eigenschapstype, of een van de speciale waarden somevalue of novalue (zie Unknown /no values).

Opmaak van elk deel:

  • Items op Wikidata staan altijd in de vorm Qxx. Op Commons staan ze altijd in de vorm Mxx. In QuickStatements versie 1 kon men een artikelnaam gebruiken in plaats van de q-code, als men een xxwiki-waarde invulde in het invoervak boven het tekstgebied; het juiste artikelnummer (indien beschikbaar) werd automatisch opgehaald.
    Voorbeeld: Q4115189 TAB P31 TABQ1
    Betekenis: aan Wikidata Sandbox (Q4115189)instance of (P31)Universe (Q1) toevoegen
  • Eigenschappen in de vorm Pxx.
  • Lexemen in de vorm Lxxx.
  • Forms in de vorm Lxxx-Fyy.
  • Betekenissen in de vorm Lxxx-Syy.
  • Teksten/Strings (inclusief URL's en numerieke waarden van tekstvelden, bijvoorbeeld externe-ID waarden) moeten tussen "dubbele quotes" staan. Veel verklaringen nemen waarden in string formaat, inclusief externe-id's (als VIAF ID (P214)), bestandsnamen (als image (P18)) of andere paginanamen (als Commons category (P373)).
    Voorbeeld: Q41576278 TAB P373 TAB """Antoni Ignacy Mietelski"""
    Betekenis: toevoegen aan Antoni Ignacy Mietelski (Q41576278)Commons category (P373)Antoni Ignacy Mietelski
    LET OP: Sommige tekens in de strings lijken het hulpmiddel te verwarren. Dit zijn onder meer: "_" (liggend streepje), " (dubbele quote), " " (spatie), "=". Het toevoegen van URL's met die tekens, zoals deze of deze kan falen. Strings en URL's met die tekens werken mogelijk wanneer niet via de interface met het hulpmiddel interactie heeft maar falen wanneer niet via URL interactie heeft.
  • Eentalige tekst het voorvoegsel tekst in "dubbele quotes" met de taal en een dubbele punt, bijvoorbeeld en:"Some text"
    Voorbeeld: Q1214098 TAB P1476 TAB pl:"Krzyżacy"
    Betekenis toevoegen aan The Knights of the Cross (Q1214098)title (P1476)"Krzyżacy" (Pools)
  • Tijd De waarde "moet" in het formaat bijvoorbeeld +1967-01-17T00:00:00Z/11, waar /11 de nauwkeurigheid aangeeft. De nauwkeurigheid is: 0 - miljard jaar, 1 - honderd miljoen jaar, ..., 6 - millennium, 7e eeuw, 8 - decennium, 9 - jaar (standaard), 10 - maand, 11 - dag, 12 - uur, 13 - minuut, 14 - seconde.
    Voorbeeld: Q41576483 TAB P569 TAB +1839-00-00T00:00:00Z/9
    Betekenis: toevoegen aan Bronisław Podbielski (Q41576483)date of birth (P569)+1839
    Gebruik "-" voor datum BC en gebruik ten minste 4 cijfers.
    Stel een extra "/J" in als u de datum in de Juliaanse kalender wilt instellen (zie deze lijst om te begrijpen waar dit moet worden gedaan).
    Als u de API gebruikt, gebruik dan "%09" in plaats van het TAB-symbool, "%2B" in plaats van het "+"-symbool, "%3A" in plaats van het ":"-symbool en "%2F" in plaats van het "/"-symbool.
  • Locatie coördinaten in de vorm van @LAT/LON, met LAT en LON als decimale nummers.
    Voorbeeld: Q3669835 TAB P625 TAB @43.26193/10.92708
    Betekenis: locatie toevoegen aan San Dalmazio (Q3669835)
  • Hoeveelheid in de vorm van amount~toleranceUxx[2], met amount en tolerance als rationele nummers en Uxx als het itemnummer van een eenheid (Qxx). Unit en tolerance waarden zijn optioneel. Zet geen spaties in de hoeveelheidsdefinitie.
    QuickStatements versie 1 gebruikte een andere syntaxis voor Hoeveelheid(Quantity): amount[lower,upper]Uxx, met aantal, lager en boven als rationele getallen.
    lower, upper zijn optioneel en moeten beide aanwezig of beide afwezig zijn. Indien aanwezig dan binnen vierkante haken en gescheiden door een ,
    amount, lower and upper moeten . als decimaal scheidingsteken gebruiken, moet geen scheidingsteken voor duizendtallen gebruiken en mag worden voorafgegaan door "+" of "-".
    10, 10U11573, -10[-12.5,-7.5], 0[-5,5]U11573 zijn alle geldige hoeveelheden (waar U11573 metre (Q11573) aangeeft)
    Hoeveelheden met tolerantie mogen worden ingevoerd als 1.2~0.3 in QuickStatements versie 2, wat hetzelfde is als 1.2[0.9,1.5] in QuickStatements versie 1 en betekent 1.2±0.3.[3]
  • somevalue voor unknown value Help
  • novalue voor no value Help. Zowel novalue als somevalue moeten zonder dubbele quotes worden gebruikt. Beide verklaringen werken wel als onderdeel van de itemcreatieverklaringen met behulp van de sleutelwoorden CREATE en LAST.


Verklaring met kwalificaties toevoegen[edit]

Elke "triplet" verklaring kan worden gevolgd door een onbeperkt aantal "kwalificatie-paren" van eigenschap TAB waarde.

Voorbeeld: Q41577083 TAB P570 TAB +1600-00-00T00:00:00Z/7 TAB P1319 TAB +1586-00-00T00:00:00Z/9
Betekenis: toevoegen aan Gian Federigo Bonzagna (Q41577083)date of death (P570)16. eeuwearliest date (P1319)+1586

Verklaring met bronnen toevoegen[edit]

Elke verklaring kan worden gevolgd door een onbeperkt aantal "bronparen" om referenties toe te voegen van bron eigenschappen TAB waarde. De eigenschap bron is identiek aan de eigenschap "normaal", behalve dat deze de vorm Sxx gebruikt in plaats van Pxx.

Voorbeeld: Q22124656 TAB P21 TAB Q6581097 TAB S143 TAB Q24731821 TAB S813 TAB +2017-10-04T00:00:00Z/11
Betekenis: toevoegen aan Gotō Ichijō (Q22124656)sex or gender (P21)male (Q6581097) met referentie imported from Wikimedia project (P143)Commons Creator page (Q24731821)retrieved (P813)

Standaard gaan alle bronnen naar dezelfde "referentiegroep" (een blok eigenschap/waardeparen). Als u meer dan één referentiegroep in één opdrachtrij wilt maken, hoeft u alleen maar de eerste broneigenschap van de nieuwe groep een prefix te geven met een uitroepteken: "! Sxx" in plaats van "Sxx". (In de eerste referentiegroep is de "!" optioneel en heeft deze geen invloed op de uitkomst.)

Opmerkingen:

  • Bestaande verklaringen met een exacte overeenkomst (eigenschap en waarde) worden niet opnieuw toegevoegd; er kunnen echter aanvullende verwijzingen aan de verklaring worden toegevoegd.
  • U kunt kwalificaties en referenties in dezelfde verklaring mengen. Gebruik Sxx in plaats van Pxx bij het gebruik van bronnen.
  • In QuickStatements versie 1 vertegenwoordigde elke claim van een bron een individuele referentie, d.w.z. zij werden niet in één referentie gegroepeerd; het werkt nu goed in QuickStatements versie 2.


Labels, aliassen, beschrijvingen en sitelinks toevoegen[edit]

Net als bij het toevoegen van eenvoudige tekstinstructies, moet elke opdracht bestaan uit een item, een commando en een string in dubbele quotes.

  • Als u een label in een specifieke taal aan een item wilt toevoegen, gebruikt u 'Lxx' in plaats van een eigenschap, met 'xx' als taalcode.
    Voorbeeld: Q340122 TAB Lpl TAB "Cyprian Kamil Norwid"
    Betekenis: voeg het Poolse etiket "Cyprian Kamil Norwid" toe aan Cyprian Norwid (Q340122)
  • Als u een alias in een specifieke taal aan een item wilt toevoegen, gebruikt u 'Axx' in plaats van een eigenschap, met 'xx' als taalcode.
    Voorbeeld: Q340122 TAB Aen TAB "Cyprjan Kamil Norwid"
    Betekenis: voeg de Engelse alias "Cyprjan Kamil Norwid" toe aan Cyprian Norwid (Q340122)
    Tip: Meerdere aliassen kunnen tegelijkertijd worden toegevoegd door ze te scheiden met een verticale streep ("|").
    Voorbeeld: Q340122 TAB Aen TAB "Cyprian Kamil Norwid|Cypryan Kamil Norvid"
  • Om een beschrijving in een specifieke taal aan een item toe te voegen, gebruik "Dxx" in plaats van een eigenschap, met "xx" als taalcode.
    Voorbeeld: Q340122 TAB Dde TAB "polnischer Dichter"
    Betekenis: voeg de Duitse beschrijving "polnischer Dichter" toe aan Cyprian Norwid (Q340122)
  • Als u een sitelink wilt toevoegen aan een specifieke pagina op een site aan een item, gebruikt u 'Sxxx' in plaats van een eigenschap, met 'xxx' als site (bijv. enwiki, commonswiki).
    Voorbeeld: Q340122 TAB Szhwiki TAB "塞浦路斯·諾爾維特"
    Betekenis: toevoegen van een sitelink naar Chinese Wikipedia (塞浦路斯·諾爾維特) naar Cyprian Norwid (Q340122)

Als u een label/beschrijving/sitelink wilt verwijderen, moet de waarde een lege string zijn en de rest van het commando hetzelfde zijn.

Item aanmaken[edit]

U kunt nieuwe items maken door een regel in te voegen die alleen bestaat uit het woord "CREATE". Om een verklaring toe te voegen aan het nieuw gecreëerde item, gebruik het woord "LAST" in plaats van het Q-nummer, en de verklaring wordt toegevoegd aan het laatste gecreëerd item.

Een voorbeeld voor het maken van een nieuw item, het toevoegen van een sitelink en het instellen van een label:

CREATE
LAST TAB Sfrwiki TAB "Le croissant magnifique!"
LAST TAB Lfr TAB "Le croissant magnifique!"
Betekenis: een nieuw item maken met een link naar de Franse Wikipedia w:fr:Le croissant magnifique! met het Franse label "Le croissant magnifique!"

Eigenschappen kunnen op dezelfde manier worden gecreëerd met "CREATE_PROPERTY" gevolgd door een TAB of | en het entiteitstype, bijvoorbeeld een van: 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. Dit wordt voornamelijk gebruikt op third-party Wikibase-instanties, omdat eigenschap aanmaak beperkt is tot Wikidata.

Item samenvoegen[edit]

U kunt twee items samenvoegen. Het eerste item wordt samengevoegd en (indien succesvol) omgeleid naar het tweede item.

MERGE TAB Qbron TAB Qbestemming

Verklaring verwijderen[edit]

U kunt specifieke instructies verwijderen door een regel met het voorvoegsel"-"[2].

Voorbeeld: -Q4115189 TAB P31 TAB Q1
Betekenis: verwijderen uit Wikidata Sandbox (Q4115189)instance of (P31)Universe (Q1)

Een datum met een nauwkeurigheid van boven de 9 kan worden verwijderd via de specifieke datum:

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

Bij een datum met een nauwkeurigheid tot 9 kan zowel 00-00 als 01-01 als de maanddatumwaarde worden gebruikt, dus kan het nodig zijn om beide proberen te verwijderen:

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

Daarnaast kunt u verklaring met een specifieke ID verwijderen met behulp van de volgende syntaxis:

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

Het ID van de verklaring kan worden opgehaald met:

  • De broncode van een entiteitspagina, waar de ID kan worden gevonden in de <div> elementen met "wikibase-statementview" class
  • API
  • naam van de verklaring node in RDF die opgevraagd kan worden met de query service (vervang hierbij de '-' na het ID van de entiteit door een '$')

Commentaar[edit]

Elk commando kan aan het einde een commentaar hebben, dat wordt in de samenvatting van het bewerkingscommando ingevoegd.[2]Gebruik de /* ... */ syntaxis. Voordat dit wordt gedaan, "kan" een TAB worden ingevoegd. De plaatsen rond de opmerking worden verwijderd voordat ze worden verwerkt. Het hulpmiddel verdeelt de toevoeging van een claim en de verwijzing ervan in twee wijzigingen. Bij het gebruik van de "versie 1-formaat" invoer lijkt het niet mogelijk om een commentaar toe te voegen voor de bewerking die de verwijzing toevoegt. De opmerking wordt toegevoegd aan de bewerking die de vordering toevoegt (als de claim nog niet bestaat en helemaal wordt toegevoegd).

Voorbeeld: Q4115189 TAB P31 TAB Q1 /* Dit is een commentaar. */
Betekenis: voeg aan Wikidata Sandbox (Q4115189)instance of (P31)Universe (Q1) toe "Dit is een commentaar." in de bewerkingssamenvatting.


CSV bestand syntaxis[edit]

Commando's[edit]

In QuickStatements versie 2 kan men ook een goed gestructureerd CSV-bestand knippen en plakken als alternatief voor de syntaxis die in QuickStatements versie 1 is geïntroduceerd. Het CSV-bestand bevat dan opdrachten op die moeten worden uitgevoerd. De eerste regel is een kopregel met de veldnamen van de kolommen.

qid
Altijd de eerste kolom: het item of de entiteit die moet worden bewerkt. Als het leeg blijft, wordt er een nieuw item gemaakt. Zie onderstaand voorbeeld.

De andere kolommen kunnen de volgende opdrachten bevatten:

P1234
Een eigenschap-ID (hoofdletter) begint met een nieuwe verklaring. De kolomwaarde geeft de belangrijkste waarde van de statement in QuickStatements versie 1 syntaxis aan.
qal1234
Een "qal" (kleine letters) gevolgd door een eigenschapsnummer (zonder "P") voegt een kwalificatie toe aan de huidige verklaring. De kolomwaarde geeft de waarde van de kwalificatie in QuickStatements versie 1 syntaxis aan. Er moet een "P" kolom voor een "qal" kolom zijn om te specificeren aan welke verklaring de kwalificatie wordt toegevoegd.
S1234
Een hoofdletter S gevolgd door een eigenschapsnummer (zonder "P") begint met een nieuwe bron voor de huidige verklaring. De kolomwaarde geeft de waarde van de bron in de QuickStatements versie 1-syntaxis aan. Er moet een "P" kolom voor een "S" kolom zijn om te specificeren aan welke verklaring de bron wordt toegevoegd.
s1234
Een "s" (kleine letter) gevolgd door een eigenschapsnummer (zonder "P") voegt een ander eigenschapswaardepaar toe aan de huidige bron. De kolomwaarde geeft de waarde van de bron in de QuickStatements versie 1-syntaxis aan. Er moet een "S" kolom voor een "s" kolom zijn om te specificeren aan welke bron het eigenschapswaardepaar wordt toegevoegd.
Len
Een hoofdletter "L" gevolgd door een taalcode geeft het label in die taal aan.
Dfr
Een hoofdletter "D" gevolgd door een taalcode stelt de beschrijving in die taal in.
Ade
Een hoofdletter "A" gevolgd door een taalcode voegt een alias in die taal toe.
Senwiki
Een hoofdletter 'S' gevolgd door een site-id voegt een sitelink toe aan die site.
#
Met een cijferteken stelt u de bewerkingssamenvatting (opmerking) van de vorige opdracht in. Het hulpmiddel splitst het toevoegen van een claim en de verwijzing ervan in twee bewerkingen. Een opmerking kan worden toegevoegd aan de bewerkingssamenvatting van elk van hen. Dat kan bij de claim door een kolom "#" te plaatsen tussen de kolommen voor de claim en de verwijzing ervan, en voor de verwijzing door een kolom "#" achter de kolommen te plaatsen. Bijvoorbeeld:
qid,P21,#,S143,s813,#
Q22124656,Q6581097,comment to claim adding edit,Q24731821,+2017-10-04T00:00:00Z/11,Opmerking bij verwijzing toevoegen bewerken

Item aanmaken[edit]

Om een nieuw item te maken, moet het eerste element van de rij leeg zijn, dus de rij begint met een ,.

Bijvoorbeeld:

Qid, Len, Den, P31
,Regina Phalange,fictional character,Q95074


Voorbeeld
Hiermee maakt u een nieuw item.

Geschikt voor LibreOffice (plakken in cel A1)

filenamelabeldescriptionqid,P31,Len,Den,P18
Mona Lisa - the Louvre.jpgMona Lisaoil painting by Leonardo da Vinci=",Q3305213,"""&B2&""","""&C2&""","""""""&A2&""""""""
Mona Lisa - the Louvre.jpgMona Lisaoil painting by Leonardo da Vinci,Q3305213,"Mona Lisa","oil painting by Leonardo da Vinci","""Mona Lisa - the Louvre.jpg"""

Commando's voor het verwijderen van instructies[edit]

Kolomkoppen van verklaringen kunnen ook beginnen met "-" om de instructie te verwijderen. (Houd er rekening mee dat dit alleen geldig is in de koptekst voor de hele kolom, niet in afzonderlijke waarden.) Het verwijderen van andere kolomtypen wordt nog niet ondersteund en zal resulteren in een fout wanneer de opdracht wordt uitgevoerd; Sitelinks en labels kunnen echter worden verwijderd door ze in te stellen op de lege tekenreeks (zonder "-" in de kolomkop).

qid,P31,-P31
Q4115189,Q5,Q5

Voeg aan het zandbak item een P31 waarde van human (Q5) toe, en verwijder vervolgens dezelfde verklaring weer.

Komma's en dubbele quotes[edit]

Labels, beschrijvngen, aliassen en sitelinks hoeven niet tussen dubbele quotes te staan tenzij ze komma's (,) of dubbele quotes (") bevatten.

In dit geval, vervang alle dubbele quotes door twee dubbele quotes (bijv. Toys "R" UsToys ""R"" Us) en wikkel de string vervolgens in een paar dubbele quotes (bijv. "Toys ""R"" Us").

Voorbeelden: Toys "R" Us en Patronen, Voorspellingen en Uitkomsten

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

Om een string-waarde toe te voegen die dubbele citaten bevat ("), vervang alle dubbele quotes door twee dubbele quotes ("").

Als elke stringwaarde, wikkel het dan in drie dubbele quotes ("""), bijvoorbeeld """Toys ""R"" Us""".

Voorbeelden Q4115189#P370, opmerkelijk Toys "R" Us

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

Gecombineerd voorbeeld[edit]

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"

Voorbeeld per waardetype[edit]

Voor de test kan de zandbak (Q4115189) gebruikt worden en rechtstreeks in QuickStatements worden geplakt. Dat zou zonder risico's moeten zijn.

Label
qid,Len
Q4115189,Sandbox
Q4115189,"Patterns, Predictors, and Outcome"
Q4115189,"Toys ""R"" Us"
Beschrijving
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"
Item
qid,P369
Q4115189,Q5
Q4115189,somevalue
Q4115189,novalue
L123,Q5
L123-S1,Q5
L123-F1,Q5

somevalue is voor unknown value Help, novalue voor no value Help. F1 en S1 op Lexeme:L123 moeten bestaan om het te laten werken.

String of externe identifier (externe-id)
qid,P370
Q4115189,"""Sandbox"""
Q4115189,"""Patterns, Predictors, and Outcome"""
Q4115189,"""Toys ""R"" Us"""

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

en is voor Engels

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

Precisie s zijn 9=jaar, 10=maand, 11=dag, dus de datums zijn 1856, januari 1856 en 1 januari 1856.

Afbeelding/Commons mediabestand
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"""

Afbeeldingen zijn:

URL
qid,P856
Q4115189,"""https://example.com/"""
Q4115189,"""https://example.com/equalsign=test"""
Q4115189,"""https://example.com/underscore_test"""
Hoeveelheid
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 is voor metre (Q11573), U11574 voor second (Q11574). Let op het vreemde resultaat van 1.2~0.3.

Volledig voorbeeld[edit]

Volledige voorbeelden zijn te vinden op Help:QuickStatements/examples.

QuickStatements uitvoeren[edit]

QuickStatements versie 2 gebruiken[edit]

QuickStatements V2 introductie

Hier is hoe QuickStatements (versie 2) in de basismodus wordt gebruikt:

  1. Ga naar https://quickstatements.toolforge.org
  2. Zorg ervoor dat u bent aangemeld bij OAuth en dat uw naam zichtbaar is in de rechterbovenhoek. Zo niet, log dan in.
  3. Klik op "Nieuwe batch".
  4. Voor het werken met Wikimedia Commons Gestructureerde gegevens:
    1. Zoek naar het vervolgkeuzemenu Maak een nieuwe opdrachtbatch voor... en verander het project van Wikidata naar Commons [Alleen batchmodus!]
    2. U heeft "M" -id's nodig om aan te werken in plaats van "Q" -nummers. Zoek de media-id's voor Commons-bestanden op met het hulpmiddel Minefield
    3. Gebruik instructies in de vorm van "MXXXX|PXX|QXXX" of gebruik de CSV-indelingsoptie
    4. Start de query met de knop "Uitvoeren" of "Uitvoeren op de achtergrond" om deze in de batchmodus uit te voeren
  5. Knip en plak uw commando's. Zie de syntaxis in het bovenstaande gedeelte.
  6. Als u klaar bent, klikt u op "V1-opdrachten importeren" of "CSV-opdrachten importeren".
  7. Het hulpmiddel zet uw opdrachten om in een voor mensen leesbare vorm. Inspecteer ze en klik op "Uitvoeren" of "Op de achtergrond uitvoeren" om uit te voeren
  8. Terwijl uw opdrachten worden verwerkt, controleert u de resultaten en drukt u op "STOP" als u een probleem detecteert.
  9. De gebruikersinterface vertelt u wanneer alle opdrachten zijn verwerkt.

QuickStatements versie 1 gebruiken[edit]

Schermafbeelding van het gebruik van QuickStatements versie 1

QuickStatements versie 1 is nog steeds beschikbaar, maar wordt niet langer onderhouden. Het heeft werken voor sommige gebruikers gestopt, maar nog steeds prima voor anderen.

  1. Ga naar https://wikidata-todo.toolforge.org/quick_statements.php
  2. Kopieer en plak uw commando's in het venster
  3. Klik op "Uitvoeren"
  4. De gebruikersinterface geeft aan wanneer alle commando's zijn verwerkt.

QuickStatements versie 2 in batch gebruiken[edit]

Wanneer de batch mode gebruiken?[edit]

QuickStatements versie 2 heeft de knop "Run in background"

Batch-modus (ook bekend als achtergrond- of asynchrone batch-modum) betekent dat uw instructies worden uitgevoerd vanaf een Wikimedia-server, in plaats van vanuit uw webbrowser. Dit heeft verschillende voordelen:

  • Zelfs als u uw browser sluit of als uw computer crasht, worden de commando's uitgevoerd tot de laatste.
  • U kunt verschillende batches tegelijkertijd starten, zonder uw computer trager wordt. (De batches lijken opeenvolgend te worden uitgevoerd)
  • U krijgt een unieke URL voor uw batch, waar u later naar kunt verwijzen. Op deze pagina vindt u enkele statistieken over uw sessie.
  • Om al uw recente batches te zien, klikt u op "Uw laatste batch". Om de recente batches van iedereen te zien klikt u op "Laatste batches"
  • U of een projectadministrator kunt uw batch stoppen door naar de URL te gaan. Als het bijvoorbeeld wordt vastgesteld dat de batch fout is en u offline bent, kan een beheerder deze onmiddellijk stoppen (door naar de individuele pagina te gaan), in plaats van u te moeten blokkeren.
  • Als u ontdekt dat er iets mis is gegaan, kunt u de hele batch later terugdraaien.

Maar er zijn ook nadelen:

  • Het kost een paar meer klikken, dus als vuistregel, als u maar 10 of minder instructies heeft, is het beter om ze in de normale modus uit te voeren.
  • Afhankelijk van hoe druk de server is, kan het enige tijd duren voordat uw batch is gestart, zodat het controleren van de resultaten mogelijk niet onmiddellijk mogelijk is.
  • Er is een limiet op het aantal instructies in een batch en batches met meer instructies worden niet correct geladen (met lege pagina). Voor eenvoudigere verklaringen lijkt het maximum rond de 25 duizend statements per batch te liggen, maar voor complexere is het veel kleiner.
  • Batch-modus lijkt goed te werken voor eenvoudige verklaringen zonder kwalificaties of referenties, maar complexere (waarbij bijvoorbeeld de succesvolle toevoeging van een kwalificatie afhankelijk is van de basisinstructie die al aanwezig is), lijkt er een veel hoger foutenpercentage te zijn.

Voordat u een batch uitvoert, is het een goed idee om een paar commando's direct in de niet-batch-modus uit te voeren om een goed beeld te krijgen van wat er wordt gedaan.

Batch mode gebruiken[edit]

  1. Bereid uw commando's normaal voor zoals beschreven in sectie QuickStatements versie 2 hierboven
  2. In plaats van op "Uitvoeren" te drukken, druk op de knop "Uitvoeren in de achtergrond".
  3. "Uw laatste batches" geeft een lijst met de meest recente batches die u heeft uitgevoerd, met statistieken.

De volgende statistische waarden zijn beschikbaar:

  • DONE: Het aantal commando's dat met succes is uitgevoerd
  • ERROR: Het aantal commando's dat is mislukt
  • INIT: Het aantal commando's dat nog moet worden uitgevoerd
  • RUN: Het aantal commando's dat op dit moment wordt uitgevoerd

QuickStatements uitvoeren met een URL[edit]

Wat moet u zien als u op de voorbeeld link in deze sectie klikt

Een alternatieve manier om QuickStatements te benaderen is om een URL te gebruiken in plaats van commando's te knippen en te plakken in het importvenster. Een opdracht om toe te voegen aan Emile Justin Merlot (Q37887397)VIAF ID (P214)"96480189" met bron imported from Wikimedia project (P143)Wikimedia Commons (Q565) is bijvoorbeeld Q37887397 TAB P214 TAB "96480189" TAB S143 TAB Q565. U kunt ook een vooraf ingevuld QuickStatements-venster genereren met https://quickstatements.toolforge.org/#/v1= Q37887397%7CP214 %7C%2296480189%22%7C S143%7CQ565 of https://quickstatements.toolforge.org/#/v1=Q37887397%7CP214%7C%2296480189%22%7CS143%7CQ565. De stappen voor het converteren van V1-syntaxis naar URL zijn:

  1. vervang TAB door "|" en newline door "||"
  2. pas URL-codering toe op de tekenreeks, die "|" vervangt door "%7C", dubbele aanhalingsteken door "%22", spatie door "%20", schuine streep "/" door "%2F", enz.[4]
  3. zet https://quickstatements.toolforge.org/#/v1= ervoor

Veel sjablonen op Commons, zoals c:Template:Creator of c:Template:Artwork gebruiken die techniek om informatie die naar Wikidata kan worden geïmporteerd, te verpakken in een klikbare URL.

Tips:

  • [[File:Commons to Wikidata QuickStatements.svg|20px|link=https://quickstatements.toolforge.org/#/v1=Q37887397%7CP214%7C%2296480189%22%7CS143%7CQ565]] codeert de URL in een handig klikbaar pictogram: (klik erop maar klik niet op "uitvoeren"; erop drukken werkt niet omdat dat item die eigenschap al heeft).
  • Pagina's met QuickStatements URL's kunnen worden gevonden via Special:LinkSearch (zie hier) of via een databasequery die de externe links tabel aanroept (zie voorbeeld).

Clients[edit]

- Python

Beperkingen[edit]

QuickStatements versie 2 kan nu niet:

  • meerdere items maken die aan elkaar zijn gekoppeld
  • rangen instellen voor verklaringen
  • opmerkingen toevoegen bij het verwijderen van verklaringen
  • kalender opgeven bij verklaring met een datum
  • precisie of wereldbol specificeren voor een locatieverklaring
  • verklaringen toevoegen bij items met een doorverwijzing
  • een tweede verklaring toevoegen met dezelfde eigenschap en waarde, maar met verschillende kwalificaties, omdat er extra kwalificaties worden toegevoegd aan de eerste instructie
  • een kwalificatie verwijderen zonder de verklaring zelf te verwijderen
  • een verwijzing verwijderen zonder de verklaring zelf te verwijderen
  • een alias verwidjeren
  • badges bijwerken
  • Lexemen maken

Houd er rekening mee dat voor het gebruik van QuickStatements het account autoconfirmed moet zijn. Er is ook geen manier voor gebruikers die botaccounts gebruiken om hun bewerkingen te markeren als bot bewerking (maar er is een open ticket om dat aan te pakken).

Veelgestelde vragen[edit]

Kan QuickStatements referentieverklaringen toevoegen met meer dan één claim?
Ja, huidige QuickStatements kunnen referenties toevoegen die bijvoorbeeld zowel imported from Wikimedia project (P143) als retrieved (P813) hebben (zie hier) of zowel stated in (P248) als page(s) (P304).
Hoe experimenteer ik met QuickStatements?
Gebruik Wikidata Sandbox (Q4115189).
Hoe rapporteer ik problemen met het hulpmiddel?
Neem contact op met andere gebruikers op de overlegpagina of via de deze chat. Bevestigde bugs moeten worden gemeld op Phabricator na het lezen van mw:How to report a bug.
Waar stel ik nieuwe functies voor?
U kunt het vragen op Git pagina of op Wikidata Sandbox (Q4115189)S 2, maar wees u ervan bewust dat we Magnus bezig houden!
Wat is het maximale aantal opdrachten dat ik tegelijk kan invoeren?
Niet gedocumenteerd. Het werd al getest met meer dan 11.000 commando's. Maar houd er rekening mee dat dergelijke grote batchruns enkele uren in beslag nemen.

Beste aanpak[edit]

  • QuickStatements maakt bewerkingen mogelijk, variërend van enkele commando's tot batchruns met meerdere duizenden. Zeer grote runs of potentieel controversiële runs moeten het goedkeuringsproces doorlopen dat wordt beschreven in Wikidata:Bots.
  • Gebruikers moeten voorkomen dat ze dubbele items maken.
  • Alle instructies moeten verwijzingen hebben volgens Help:Sources. Dat is misschien minder belangrijk voor id's, zoals VIAF ID (P214) of RKDartists ID (P650), enzovoort.
  • Gebruikers die de bewerkingen uitvoeren, zijn verantwoordelijk voor het oplossen of ongedaan maken van hun wijzigingen als er problemen worden gevonden. Zie informatie over verklaring verwijderen.
  • Dit hulpmiddel voldoet niet goed aan maxlag. Dit is over het algemeen geen probleem, omdat de acties worden beperkt door de gebruikelijke bewerkingslimieten van de controlerende gebruiker. Dit kan echter problemen veroorzaken als de controlerende gebruiker niet onderworpen is aan bewerkingslimieten (bijvoorbeeld beheerders).

Met de API batches starten[edit]

Als u bent ingelogd op QuickStatements, kunt u een token krijgen op uw gebruikerspagina. Die pagina bevat ook informatie over het gebruik van het token om batches programmatisch in te dienen. U moet minstens één server-side batch handmatig hebben ingediend voordat dit werkt!

Groepen bewerken[edit]

QuickStatements V2 maakt bewerkingsgroepen aan voor alle afzonderlijke batches. U kunt afzonderlijke bewerkingsgroepen bespreken of de hele bewerkingsgroep terugdraaien.

EditGroups is een ander extern hulpprogramma, het maakt geen deel uit van QuickStatements. Momenteel werkt het op Wikidata, en er is ook een instantie voor Commons. Op andere Wikibase-instanties is het mogelijk niet beschikbaar.

Zie ook[edit]

Hulpmiddelen die exporteren naar QuickStatements[edit]

Referenties[edit]

  1. https://wikidata-todo.toolforge.org/quick_statements.php
  2. 2.0 2.1 2.2 2.3 2.4 2.5 2.6 2.7 syntaxis werkt alleen in QuickStatements versie 2
  3. Houd er rekening mee dat vanwege de manier waarop computers werken met drijvende-kommagetallen, de invoerindeling van versie 2 ongewenste resultaten kan opleveren bij het werken met decimale getallen.
  4. https://www.url-encode-decode.com/ is een handige URL-encoder / decoder