Modulo:Wikidata/man: differenze tra le versioni

Aggiungi collegamenti
Da Wikiquote, aforismi e citazioni in libertà.
Naviga nella cronologia in modo interattivo
← Differenza precedenteDifferenza successiva →
Contenuto cancellato Contenuto aggiunto
VisualeWikitesto
m descrizione e precisazione
fix vari
Riga 1: Riga 1:
Il [[Aiuto:Moduli|modulo]] [[Aiuto:Lua|Lua]] '''Wikidata''' serve per leggere il valore delle proprietà di [[Aiuto:Wikidata|Wikidata]] relative alla pagina corrente, cioè la pagina in cui è utilizzato il modulo. Sarà in futuro possibile leggere le proprietà anche di pagine diverse da quella corrente. Il modulo fornisce un utilizzo più avanzato, a volte senza alternativa, rispetto a quello che si può ottenere con la ''magic word'': <code><nowiki>{{#property:NumProprietà}}</nowiki></code>.
Il [[Aiuto:Moduli|modulo]] [[Aiuto:Lua|Lua]] '''Wikidata''' serve per leggere il valore delle proprietà di [[Aiuto:Wikidata|Wikidata]] relative alla pagina corrente, cioè la pagina in cui è utilizzato il modulo. Sarà in futuro possibile leggere le proprietà anche di pagine diverse da quella corrente. Il modulo fornisce un utilizzo più avanzato, a volte senza alternativa, rispetto a quello che si può ottenere con la ''magic word'': <code><nowiki>{{#property:proprietà}}</nowiki></code>.


== Utilizzo ==
== Utilizzo ==
Il modulo ha quattro funzioni:
Il modulo ha quattro funzioni:
* '''formatStatements''': restituisce il valore di una proprietà di Wikidata. Nel caso una proprietà ha più di un valore (''statement'') li può restituire tutti, separandoli con una virgola e inserendo la congiunzione "e" prima dell'ultimo valore, oppure filtrarli se si specifica un rank, un qualifier o un indice. Permette di formattare l'output attraverso delle opzioni (da qui il nome formatStatements). Se la pagina non ha un elemento su Wikidata, oppure non ha la proprietà specificata, oppure il valore della proprietà è a sua volta un elemento che non ha un'etichetta in italiano, non restituisce nulla. Se possibile ([[#nolink|e se non diversamente specificato]]), i valori delle proprietà sono restituiti con wikilink, compresa eventuale disambiguazione nascosta con la barra verticale (es. <code><nowiki>[[Savoia (dipartimento)|Savoia]]</nowiki></code>). Il nome italiano della voce viene ricavato dall'interlink del rispettivo elemento su Wikidata; se il soggetto non è presente su Wikidata, il valore viene restituito senza wikilink.
* '''formatStatements''': restituisce il valore di una proprietà di Wikidata. Nel caso una proprietà abbia più di una dichiarazione (''statement'') può restituire tutti i valori, separandoli con una virgola e inserendo la congiunzione "e" prima dell'ultimo valore, oppure filtrarli se si specifica un ''rank'' (valutazione), un ''qualifier'' (qualificatore) o un indice. Permette di formattare il risultato attraverso delle opzioni (da qui il nome formatStatements). Se la pagina non ha un elemento su Wikidata, oppure non ha la proprietà specificata, oppure il valore della proprietà è a sua volta un elemento che non ha un'etichetta in italiano, non restituisce nulla. Se possibile ([[#nolink|e se non diversamente specificato]]), i valori delle proprietà sono restituiti con wikilink, compresa eventuale disambiguazione nascosta con la barra verticale (es. <code><nowiki>[[Savoia (dipartimento)|Savoia]]</nowiki></code>). Il collegamento viene ricavato dall'interlink in italiano del rispettivo elemento su Wikidata; se il soggetto non è presente su Wikidata, oppure non possiede un interlink in italiano, il valore viene restituito senza wikilink.
* '''getQualifier''': restituisce il valore di un qualifier di una proprietà di Wikidata. Se la proprietà ha più statement e il qualifier è presente in più statement, oppure se il qualifier ha più valori, li può restituire tutti, oppure si possono filtrare in base a rank e indice (dello statement) come per la formatStatements.
* '''getQualifier''': restituisce il valore di un ''qualifier'' (qualificatore) di una proprietà di Wikidata. Se la proprietà ha più ''statement'' (dichiarazioni) e il ''qualifier'' è presente in più ''statement'', oppure se il ''qualifier'' ha più valori, li può restituire tutti, oppure si possono filtrare in base a ''rank'' (valutazione) e indice (dello ''statement'') come per la funzione ''formatStatements''.
* '''N''': ritorna il numero di statement della proprietà richiesta.
* '''N''': ritorna il numero di ''statement'' (dichiarazioni) della proprietà richiesta.
* '''<span style="color:blue;">checkStatements</span>'''<ref name="newpedia">:Funzionalità nuova e aggiuntiva rispetto al corrispondente modulo su Wikipedia.</ref> verifica se una proprietà di Wikidata ha un determinato valore. Nel caso una proprietà ha più di un valore (''statement'') li verifica tutti. Se la pagina non ha un elemento su Wikidata, oppure non ha la proprietà specificata, oppure il valore della proprietà non corrisponde a quello da verificare, non restituisce nulla; altrimenti restituisce un numero corrispondente allo statement verificato.
* '''<span style="color:teal;">checkStatements</span>'''<ref name="newpedia">:Funzionalità nuova e aggiuntiva rispetto al corrispondente modulo su Wikipedia.</ref> verifica se una proprietà di Wikidata ha un determinato valore. Nel caso una proprietà abbia più di una dichiarazione (''statement'') ne verifica tutti i valori. Se la pagina non ha un elemento su Wikidata, oppure non ha la proprietà specificata, oppure il valore della proprietà non corrisponde a quello da verificare, non restituisce nulla; altrimenti restituisce un numero corrispondente all'indice dello ''statement'' verificato.


=== Parametri di formatStatements ===
=== Parametri di formatStatements ===
La funzione formatStatements ha i seguenti parametri, l'unico obbligatorio è ''property''. Gli esempi utilizzati fanno riferimento alla voce [[Dante Alighieri]] (il cui elemento su Wikidata è questo: [[d:Q1067]]).
La funzione ''formatStatements'' ha i seguenti parametri, l'unico '''obbligatorio''' è ''property''. Gli esempi utilizzati fanno riferimento alla voce [[Dante Alighieri]] (il cui elemento su Wikidata è: [[d:Q1067|Q1067]]).


Parametri di selezione:
;Parametri di selezione
* ''property'': l'identificatore della proprietà;
* ''property'': l'identificatore della proprietà;
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p19}}</nowiki></code> ritornerà: [[Firenze]] ([[d:P19]] è il luogo di nascita).
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p19}}</nowiki></code> ritornerà: [[Firenze]] ([[d:Property:P19|P19]] è il luogo di nascita).
* ''rank'': se valorizzato, il modulo ritorna solo gli statement che hanno un certo rank. I rank disponibili sono i tre definiti da Wikidata: ''deprecated'', ''normal'' e ''preferred'', più il tipo ''best''. Con quest'ultimo vengono ritornati gli statement a partire dal rank più alto: i ''preferred'' se presenti altrimenti i ''normal''.
* ''rank'': se valorizzato, il modulo ritorna solo gli ''statement'' che hanno un certo ''rank'' (valutazione). I ''rank'' disponibili sono i tre definiti da Wikidata: ''deprecated'' (sconsigliato), ''normal'' (normale) e ''preferred'' (consigliato), più il tipo ''best'' (migliore). Con quest'ultimo vengono ritornati gli ''statement'' a partire dal ''rank'' più alto: i ''preferred'' se presenti altrimenti i ''normal''.
* ''qualifier'': l'identificatore di un qualifier di una proprietà. Verranno ritornati solo gli statement che posseggono quel qualifier.
* ''qualifier'': l'identificatore di un ''qualifier'' (qualificatore) di una proprietà. Verranno ritornati solo gli ''statement'' che posseggono quel ''qualifier''.
* ''qualifiervalue'': l'identificatore del valore del qualifier specificato con il parametro qualifier. Verranno ritornati solo gli statement che posseggono quel qualifier e con il valore specificato con qualifiervalue.
* ''qualifiervalue'': l'identificatore del valore del ''qualifier'' (qualificatore) specificato con il parametro ''qualifier''. Verranno ritornati solo gli ''statement'' che posseggono quel ''qualifier'' e con il valore specificato con ''qualifiervalue''.
* ''qualifiertype'': ulteriore filtro sul qualifier specificato. Ha attualmente un unico valore accettato, <code>qualifiertype=latest</code>: se il qualifier contiene un valore di tipo "time", verrà ritornato solo lo statement che possiede quel qualifier e con il valore più recente.
* ''qualifiertype'': ulteriore filtro sul ''qualifier'' (qualificatore) specificato. Ha attualmente un unico valore accettato, <code>qualifiertype=latest</code>: se il ''qualifier'' contiene un valore di tipo "time", verrà ritornato solo lo ''statement'' che possiede quel ''qualifier'' e con il valore più recente.
* ''n'': se la proprietà ha più statement ritorna l'n-esimo;
* ''n'': se la proprietà ha più ''statement'' (dichiarazioni) ritorna solo il valore dell'n-esimo;
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p101|n=1}}</nowiki></code> ritornerà: [[poeta]] ([[d:P101]] è la professione, mentre con n=2 avrebbe ritornato [[scrittore]], con n=3 [[politico]]).
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p106|n=1}}</nowiki></code> ritornerà: [[poeta]] ([[d:Property:P106|P106]] è la professione, mentre con n=2 avrebbe ritornato [[scrittore]], con n=3 [[politico]], ecc.).
* ''value'': se valorizzato, il modulo ritorna il valore di questo parametro invece di quello su Wikidata, formattandolo eventualmente secondo il pattern se specificato. Serve quando si usa il modulo da un template, per dare la precedenza al valore passato al template rispetto a quello su Wikidata;
* ''value'': se valorizzato, il modulo ritorna il valore di questo parametro invece di quello su Wikidata, formattandolo eventualmente secondo il pattern se specificato. Serve quando si usa il modulo all'interno di un template, per dare la precedenza al valore passato al template rispetto a quello su Wikidata;
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p19|value={{{LuogoNascita|}}}}}</nowiki></code> ritornerà: il valore di LuogoNascita se valorizzato, altrimenti quello della proprietà p19 su Wikidata.
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p19|value={{{LuogoNascita|}}}}}</nowiki></code> ritornerà: il valore di LuogoNascita se valorizzato nel template, altrimenti quello della proprietà [[d:Property:P19|P19]] su Wikidata.
* ''entityId'': per ora '''<span style="color:red;">NON FUNZIONANTE</span>''', quando sarà attivato permetterà di specificare un'entity di Wikidata relativa a una pagina diversa da quella in cui ci si trova.
* ''entityId'': l'identificatore dell'entità – per ora '''<span style="color:red;">NON FUNZIONANTE</span>''' – quando sarà attivato permetterà di specificare un'entità (''entity'') di Wikidata relativa a una pagina diversa da quella in cui ci si trova.


Parametri per la formattazione del risultato:
;Parametri per la formattazione del risultato
* ''separator'': separatore tra valori multipli, se diverso da virgola_spazio;
* ''separator'': separatore tra valori multipli, se diverso da virgola_spazio;
* ''conjunction'': separatore tra gli ultimi due valori, se diverso da spazio_e_spazio;
* ''conjunction'': separatore tra gli ultimi due valori, se diverso da spazio_e_spazio;
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p101|separator=/|conjunction=/}}</nowiki></code> ritornerà: [[poeta]]/[[scrittore]]/[[politico]].
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p106|separator=/|conjunction=/}}</nowiki></code> ritornerà: [[poeta]]/[[scrittore]]/[[politico]].
* ''pattern'': pattern utilizzato per ogni statement, sia per le proprietà che per il parametro "value" quando presente. La stringa "$1" verrà rimpiazzata dal valore ritornato per ogni sua occorrenza
* ''pattern'': pattern utilizzato per ogni ''statement'', sia per le proprietà che per il parametro "value" quando presente. La stringa "$1" verrà rimpiazzata dal valore ritornato per ogni sua occorrenza;
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p18|pattern=[[File:$1|thumb|Il nome del file è $1]]}}</nowiki></code> ritornerà: <code><nowiki>[[File:Portrait de Dante.jpg|thumb|Il nome del file è Portrait de Dante.jpg]]</nowiki></code> ([[d:P18]] è l'immagine).
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p18|pattern=[[File:$1|thumb|Il nome del file è $1]]}}</nowiki></code> ritornerà: <code><nowiki>[[File:Portrait de Dante.jpg|thumb|Il nome del file è Portrait de Dante.jpg]]</nowiki></code> ([[d:Property:P18|P18]] è l'immagine).
** esempio con value: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p18|value={{{Immagine|}}}|pattern=[[File:$1|thumb|Il nome del file è $1]]}}</nowiki></code> In un template, se il parametro Immagine fosse valorizzato a "Test.png" allora ritornerebbe <code><nowiki>[[File:Test.png|thumb|Il nome del file è Test.png]]</nowiki></code>, altrimenti se Immagine non fosse valorizzato, lo stesso risultato dell'esempio precedente.
** esempio con "value": <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p18|value={{{Immagine|}}}|pattern=[[File:$1|thumb|Il nome del file è $1]]}}</nowiki></code> In un template, se il parametro Immagine fosse valorizzato a "Test.png" allora ritornerebbe <code><nowiki>[[File:Test.png|thumb|Il nome del file è Test.png]]</nowiki></code>, altrimenti se Immagine non fosse valorizzato, ritornerebbe lo stesso risultato dell'esempio precedente.
* ''<span style="color:blue;">novaluepattern</span>'':<ref name="newpedia" /> applica il pattern precedentemente definito solo agli statement di Wikidata e non al parametro "value"; si deve assegnargli un valore qualunque, es: "novaluepattern=no".
* ''<span style="color:teal;">novaluepattern</span>'':<ref name="newpedia" /> se valorizzato, applica il pattern precedentemente definito solo agli ''statement'' di Wikidata e non al parametro "value"; es: "novaluepattern=no".
* ''list'': formatta il risultato ritornato come lista non ordinata; si deve assegnargli un valore qualunque, es: "list=sì". Eventuali parametri ''separator'' e ''conjunction'' vengono ignorati;
* ''list'': formatta il risultato ritornato come lista non ordinata; si deve assegnargli un valore qualunque, es: "list=sì". Eventuali parametri ''separator'' e ''conjunction'' vengono ignorati;
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p101|list=1}}</nowiki></code>.
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p106|list=sì}}</nowiki></code>.
* ''orderedlist'': formatta il risultato ritornato come lista ordinata; si deve assegnargli un valore qualunque, es: "orderedlist=sì". Eventuali parametri ''separator'' e ''conjunction'' vengono ignorati. Se sono presenti entrambi i parametri ''list'' e ''orderedlist'' viene creata una lista non ordinata;
* ''orderedlist'': formatta il risultato ritornato come lista ordinata; si deve assegnargli un valore qualunque, es: "orderedlist=sì". Eventuali parametri ''separator'' e ''conjunction'' vengono ignorati. Se sono presenti entrambi i parametri ''list'' e ''orderedlist'' viene creata una lista non ordinata;
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p101|orderedlist=1}}</nowiki></code>.
** esempio: <code><nowiki>{{#invoke:Wikidata|formatStatements|property=p106|orderedlist=sì}}</nowiki></code>.
<span id="nolink" />
<span id="nolink" />
* ''formatting'': esegue formattazioni speciali, attulmente i valori consentiti sono: <code><span style="color:blue;">formatting=nolink</span></code><ref name="newpedia" /> per ritornare il risultato senza wikilink (anche se disponibile); <code>formatting=latitude</code> e <code>formatting=longitude</code> per ritornare solo latitudine o longitudine in caso di proprietà di tipo coordinata.
* ''formatting'': esegue formattazioni speciali, attulmente i valori consentiti sono:
** <code><span style="color:teal;">formatting=nolink</span></code><ref name="newpedia" /> per ritornare il risultato senza wikilink (anche se disponibile);
** <code>formatting=latitude</code> e <code>formatting=longitude</code> per ritornare solo latitudine o longitudine in caso di proprietà di tipo coordinata.
* ''value-module'': nome di un modulo che effettua una formattazione speciale.
* ''value-module'': nome di un modulo che effettua una formattazione speciale.
* ''value-function'': funzione nel modulo ''value-module''.
* ''value-function'': funzione nel modulo ''value-module''.
Riga 43: Riga 45:
=== Parametri di getQualifier ===
=== Parametri di getQualifier ===
Parametri di selezione:
Parametri di selezione:
* gli stessi di formatStatements, con in più la differenza che i parametri obbligatori sono, oltre "property", anche "qualifier".
* gli stessi di ''formatStatements'', con in più la differenza che i parametri obbligatori sono, oltre "property", anche "qualifier".


Parametri per la formattazione del risultato:
Parametri per la formattazione del risultato:
* gli stessi di formatStatements, ad eccezione di list e orderedlist.
* gli stessi di ''formatStatements'', ad eccezione di ''list'' e ''orderedlist'' (non disponibili).


=== Parametri di N ===
=== Parametri di N ===
La funzione N ha un unico parametro (ordinale) '''obbligatorio''' per specificare la proprietà.
La funzione ''N'' ha un unico parametro (ordinale) '''obbligatorio''' per specificare la proprietà.
* esempio: <code><nowiki>{{#invoke:Wikidata|N|p40}}</nowiki></code> ritornerà: 2 ([[d:P40]] è "figlio").
* esempio: <code><nowiki>{{#invoke:Wikidata|N|p40}}</nowiki></code> ritornerà: 2 ([[d:Property:P40|P40]] è "figlio").


=== Parametri di checkStatements ===
=== Parametri di checkStatements ===
La funzione checkStatements ha due parametri, di cui ''property'' è '''obbligatorio'''.
La funzione ''checkStatements'' ha due parametri, di cui ''property'' è '''obbligatorio'''.
* ''property'': l'identificatore della proprietà.
* ''property'': l'identificatore della proprietà.
* ''value'': il valore da verificare; ''value'' può espresso sia come stringa di testo sia come identificatore dell'elemento corrispondente su Wikidata;
* ''value'': il valore da verificare; ''value'' può essere espresso sia come stringa di testo sia come identificatore dell'elemento corrispondente su Wikidata;
** esempio: <code><nowiki>{{#invoke:Wikidata|checkStatements|property=p101|value=poeta}}</nowiki></code> ritornerà: 1 ([[d:P101]] è la professione, e "poeta" è la prima professione),
** esempio: <code><nowiki>{{#invoke:Wikidata|checkStatements|property=p106|value=poeta}}</nowiki></code> ritornerà: 1 ([[d:Property:P106|P106]] è la professione, e "poeta" è la prima professione),
** esempio: <code><nowiki>{{#invoke:Wikidata|checkStatements|property=p101|value=q49757}}</nowiki></code> ritornerà: 1 ([[d:P101]] è la professione e [[d:Q49757]] è "poeta").
** esempio: <code><nowiki>{{#invoke:Wikidata|checkStatements|property=p106|value=q49757}}</nowiki></code> ritornerà: 1 ([[d:Property:P106|P106]] è la professione e [[d:Q49757|Q49757]] è l'identificatore dell'elemento "poeta").


==Note==
==Note==
Riga 63: Riga 65:


== Pagine correlate ==
== Pagine correlate ==
* [[Template:Wikidata]]
* [[Template:Wikidata]], richiama in modo semplificato la funzione ''formatStatements''
* [[Template:Wikidata Check]]
* [[Template:Wikidata Check]], richiama in modo semplificato la funzione ''checkStatements''
* [[Wikiquote:Pagina delle prove di Wikidata]]


<includeonly>{{interprogetto|nolink}}
<includeonly>{{interprogetto|nolink}}

Versione delle 11:51, 18 apr 2015

Il modulo Lua Wikidata serve per leggere il valore delle proprietà di Wikidata relative alla pagina corrente, cioè la pagina in cui è utilizzato il modulo. Sarà in futuro possibile leggere le proprietà anche di pagine diverse da quella corrente. Il modulo fornisce un utilizzo più avanzato, a volte senza alternativa, rispetto a quello che si può ottenere con la magic word: {{#property:proprietà}}.

Utilizzo

Il modulo ha quattro funzioni:

  • formatStatements: restituisce il valore di una proprietà di Wikidata. Nel caso una proprietà abbia più di una dichiarazione (statement) può restituire tutti i valori, separandoli con una virgola e inserendo la congiunzione "e" prima dell'ultimo valore, oppure filtrarli se si specifica un rank (valutazione), un qualifier (qualificatore) o un indice. Permette di formattare il risultato attraverso delle opzioni (da qui il nome formatStatements). Se la pagina non ha un elemento su Wikidata, oppure non ha la proprietà specificata, oppure il valore della proprietà è a sua volta un elemento che non ha un'etichetta in italiano, non restituisce nulla. Se possibile (e se non diversamente specificato), i valori delle proprietà sono restituiti con wikilink, compresa eventuale disambiguazione nascosta con la barra verticale (es. [[Savoia (dipartimento)|Savoia]]). Il collegamento viene ricavato dall'interlink in italiano del rispettivo elemento su Wikidata; se il soggetto non è presente su Wikidata, oppure non possiede un interlink in italiano, il valore viene restituito senza wikilink.
  • getQualifier: restituisce il valore di un qualifier (qualificatore) di una proprietà di Wikidata. Se la proprietà ha più statement (dichiarazioni) e il qualifier è presente in più statement, oppure se il qualifier ha più valori, li può restituire tutti, oppure si possono filtrare in base a rank (valutazione) e indice (dello statement) come per la funzione formatStatements.
  • N: ritorna il numero di statement (dichiarazioni) della proprietà richiesta.
  • checkStatements[1] verifica se una proprietà di Wikidata ha un determinato valore. Nel caso una proprietà abbia più di una dichiarazione (statement) ne verifica tutti i valori. Se la pagina non ha un elemento su Wikidata, oppure non ha la proprietà specificata, oppure il valore della proprietà non corrisponde a quello da verificare, non restituisce nulla; altrimenti restituisce un numero corrispondente all'indice dello statement verificato.

Parametri di formatStatements

La funzione formatStatements ha i seguenti parametri, l'unico obbligatorio è property. Gli esempi utilizzati fanno riferimento alla voce Dante Alighieri (il cui elemento su Wikidata è: Q1067).

Parametri di selezione
  • property: l'identificatore della proprietà;
    • esempio: {{#invoke:Wikidata|formatStatements|property=p19}} ritornerà: Firenze (P19 è il luogo di nascita).
  • rank: se valorizzato, il modulo ritorna solo gli statement che hanno un certo rank (valutazione). I rank disponibili sono i tre definiti da Wikidata: deprecated (sconsigliato), normal (normale) e preferred (consigliato), più il tipo best (migliore). Con quest'ultimo vengono ritornati gli statement a partire dal rank più alto: i preferred se presenti altrimenti i normal.
  • qualifier: l'identificatore di un qualifier (qualificatore) di una proprietà. Verranno ritornati solo gli statement che posseggono quel qualifier.
  • qualifiervalue: l'identificatore del valore del qualifier (qualificatore) specificato con il parametro qualifier. Verranno ritornati solo gli statement che posseggono quel qualifier e con il valore specificato con qualifiervalue.
  • qualifiertype: ulteriore filtro sul qualifier (qualificatore) specificato. Ha attualmente un unico valore accettato, qualifiertype=latest: se il qualifier contiene un valore di tipo "time", verrà ritornato solo lo statement che possiede quel qualifier e con il valore più recente.
  • n: se la proprietà ha più statement (dichiarazioni) ritorna solo il valore dell'n-esimo;
    • esempio: {{#invoke:Wikidata|formatStatements|property=p106|n=1}} ritornerà: poeta (P106 è la professione, mentre con n=2 avrebbe ritornato scrittore, con n=3 politico, ecc.).
  • value: se valorizzato, il modulo ritorna il valore di questo parametro invece di quello su Wikidata, formattandolo eventualmente secondo il pattern se specificato. Serve quando si usa il modulo all'interno di un template, per dare la precedenza al valore passato al template rispetto a quello su Wikidata;
    • esempio: {{#invoke:Wikidata|formatStatements|property=p19|value={{{LuogoNascita|}}}}} ritornerà: il valore di LuogoNascita se valorizzato nel template, altrimenti quello della proprietà P19 su Wikidata.
  • entityId: l'identificatore dell'entità – per ora NON FUNZIONANTE – quando sarà attivato permetterà di specificare un'entità (entity) di Wikidata relativa a una pagina diversa da quella in cui ci si trova.
Parametri per la formattazione del risultato
  • separator: separatore tra valori multipli, se diverso da virgola_spazio;
  • conjunction: separatore tra gli ultimi due valori, se diverso da spazio_e_spazio;
    • esempio: {{#invoke:Wikidata|formatStatements|property=p106|separator=/|conjunction=/}} ritornerà: poeta/scrittore/politico.
  • pattern: pattern utilizzato per ogni statement, sia per le proprietà che per il parametro "value" quando presente. La stringa "$1" verrà rimpiazzata dal valore ritornato per ogni sua occorrenza;
    • esempio: {{#invoke:Wikidata|formatStatements|property=p18|pattern=[[File:$1|thumb|Il nome del file è $1]]}} ritornerà: [[File:Portrait de Dante.jpg|thumb|Il nome del file è Portrait de Dante.jpg]] (P18 è l'immagine).
    • esempio con "value": {{#invoke:Wikidata|formatStatements|property=p18|value={{{Immagine|}}}|pattern=[[File:$1|thumb|Il nome del file è $1]]}} In un template, se il parametro Immagine fosse valorizzato a "Test.png" allora ritornerebbe [[File:Test.png|thumb|Il nome del file è Test.png]], altrimenti se Immagine non fosse valorizzato, ritornerebbe lo stesso risultato dell'esempio precedente.
  • novaluepattern:[1] se valorizzato, applica il pattern precedentemente definito solo agli statement di Wikidata e non al parametro "value"; es: "novaluepattern=no".
  • list: formatta il risultato ritornato come lista non ordinata; si deve assegnargli un valore qualunque, es: "list=sì". Eventuali parametri separator e conjunction vengono ignorati;
    • esempio: {{#invoke:Wikidata|formatStatements|property=p106|list=sì}}.
  • orderedlist: formatta il risultato ritornato come lista ordinata; si deve assegnargli un valore qualunque, es: "orderedlist=sì". Eventuali parametri separator e conjunction vengono ignorati. Se sono presenti entrambi i parametri list e orderedlist viene creata una lista non ordinata;
    • esempio: {{#invoke:Wikidata|formatStatements|property=p106|orderedlist=sì}}.

  • formatting: esegue formattazioni speciali, attulmente i valori consentiti sono:
    • formatting=nolink[1] per ritornare il risultato senza wikilink (anche se disponibile);
    • formatting=latitude e formatting=longitude per ritornare solo latitudine o longitudine in caso di proprietà di tipo coordinata.
  • value-module: nome di un modulo che effettua una formattazione speciale.
  • value-function: funzione nel modulo value-module.

Parametri di getQualifier

Parametri di selezione:

  • gli stessi di formatStatements, con in più la differenza che i parametri obbligatori sono, oltre "property", anche "qualifier".

Parametri per la formattazione del risultato:

  • gli stessi di formatStatements, ad eccezione di list e orderedlist (non disponibili).

Parametri di N

La funzione N ha un unico parametro (ordinale) obbligatorio per specificare la proprietà.

  • esempio: {{#invoke:Wikidata|N|p40}} ritornerà: 2 (P40 è "figlio").

Parametri di checkStatements

La funzione checkStatements ha due parametri, di cui property è obbligatorio.

  • property: l'identificatore della proprietà.
  • value: il valore da verificare; value può essere espresso sia come stringa di testo sia come identificatore dell'elemento corrispondente su Wikidata;
    • esempio: {{#invoke:Wikidata|checkStatements|property=p106|value=poeta}} ritornerà: 1 (P106 è la professione, e "poeta" è la prima professione),
    • esempio: {{#invoke:Wikidata|checkStatements|property=p106|value=q49757}} ritornerà: 1 (P106 è la professione e Q49757 è l'identificatore dell'elemento "poeta").

Note

  1. ↑ a b c :Funzionalità nuova e aggiuntiva rispetto al corrispondente modulo su Wikipedia.

Pagine correlate

Estratto da "https://it.wikiquote.org/w/index.php?title=Modulo:Wikidata/man&oldid=708246"