Quelltext der Seite ÖsterreichWiki:Lua/Modul/Wikidata/de

{{LuaModuleDoc|de}}
<onlyinclude>'''<code>Wikidata</code>''' – Modul zum Abfragen von Informationen aus [[Wikidata]] basierend auf der [[mw:Extension:Wikibase Client/Lua|Wikibase Client Lua-API]].

Dieses Modul ist in vielen Projekten vorhanden, jedoch mit vielen unterschiedlichen Funktionen und Funktionsnamen. Sie sind untereinander nicht kompatibel.

'''Hinweis:''' Um die Datenextraktion mit diesem Modul zu testen, kann [[Wikipedia:Wikidata/Wikidata-Spielwiese]] und das zugeordnete Datenobjekt [[d:Q4115189|Q4115189]] verwendet werden, welches auch eine freie Bearbeitung von dessen Eigenschaften zulässt.

== {{Anker|Vorlage}} Funktionen für Vorlagen ==
Die im folgenden angegeben Beispiele beziehen sich darauf, dass das Modul '''im Artikel [[Berlin]] verwendet wird''', und gibt somit die Werte auf Basis des verknüpften Wikidata-Objekts [[d:Q64|Q64]] zurück. Die hier aufgeführten Beispielergebnisse sind u.U. nicht aktuell.

=== <tt>claim</tt> ===
Gibt eine Aussage des mit der aktuellen Seite verknüpften Wikidata-Objekts zurück. Aussagen sind hierbei Eigenschaften eines Wikidata-Objekts. Diese Funktion bietet eine erweiterte Funktionalität gegenüber dem eingebauten <tt><nowiki>{{#property:}}</nowiki></tt>.

{| {{Bausteindesign5}}
|
'''Parameter:'''
* '''1''' – die Eigenschafts-Id (P…) oder der Eigenschaftsname, dessen Aussage zurückgeliefert werden soll. Aus Performanz- (Geschwindigkeit) und Persistenzgründen (der Name einer Eigenschaft kann sich ändern) sollte die Angabe einer Id bevorzugt werden.
* '''id''' – Id (Q…) des Wikidata-Objektes, auf das zugegriffen werden soll. Wenn nicht angegeben, wird das mit der aktuellen Seite verknüpfte verwendet.
* '''qualifier''' – Aussagen können einen Qualifikator beinhalten, z.B. für welchen {{Wikidata-Property|P585}} eine Aussage gilt oder welche {{Wikidata-Property|P459}} verwendet wurde
* '''parameter''' – Aussagen bestehen aus komplexen Datentypen, von denen üblicherweise nur die wichtigsten Elemente zurückgegeben werden. Mit ''parameter'' kann dieses Verhalten überschrieben werden. Die einzelnen Datentypen und deren möglichen Parameter sind (wenn ''parameter'' nicht angegeben wird, wird das fettgedruckte Element zurückgegeben):
** Koordinaten: <tt>'''latitude, longitude''', altitude, precision, globe</tt> <small>[Wikidata-URI, üblicherweise <nowiki>http://www.wikidata.org/entity/Q2</nowiki> [Erde]]</small>
** Zahlen: <tt>'''amount''', unit, upperBound, lowerBound</tt>
** Datum/Zeit: <tt>time</tt> [ISO 8601], <tt>time:''format''</tt> <small>(angepasste Formatierung gemäß [[Hilfe:Vorlagenprogrammierung#Funktion time]])</small>, <tt>timezone</tt> [Minuten], <tt>before, after, precision</tt> <small>(0 - Mrd. Jahre, 1 - 100 Mio. Jahre, ..., 6 - Jahrtausend, 7 - Jahrhundert, 8 - Jahrzehnt, 9 - Jahr, 10 - Monat, 11 - Tag, 12 - Stunde, 13 - Minute, 14 - Sekunde)</small>, <tt>calendarmodel</tt> <small>[Wikidata-URI, z.B. <nowiki>http://www.wikidata.org/entity/Q1985727</nowiki> für den proleptischen Gregorianischen Kalender oder <nowiki>http://www.wikidata.org/wiki/Q11184</nowiki> für den Julianischen Kalender]</small>
** Wikidata-IDs: <tt>entity-type, numeric-id</tt> (Standardmäßig wird der Titel des mit numeric-id bezeichneten Wikidata-Objekts zurückgegeben), <tt>link</tt> für einen Wikilink
** Text mit Sprachauszeichnung: <tt>language</tt>, <tt>text</tt> (Standardmäßig wird <tt><nowiki><span lang="[language]">[text]</span></nowiki></tt> zurückgegeben)
* '''language''' – sofern eine Eigenschaft mehrere Aussagen mit Sprachauszeichnungen besitzt, wird diejenige Aussage zurückgegeben, die in der Sprache des angegebenen Sprachkürzels vorliegt (z.B. <tt>language=de</tt> für Deutsch oder <tt>language=en</tt> für Englisch)
* '''list''' – wenn eine Eigenschaft mehrere Aussagen besitzt, alle mit dem angegeben Listenseparator ausgeben (<tt>\n</tt> bzw. <tt><nowiki><br</nowiki>&nbsp;<nowiki>/></nowiki></tt> für Zeilensprung verwenden)
* '''includeempty''' – Listenseparator wird auch im Fall von leeren Werten ausgegeben
* '''listMaxItems''' – funktioniert nur mit dem Parameter <code>list</code>. Mit diesem Parameter kann die maximale Zahl an zurückgegebenen Listenelementen festgelegt werden.
* '''references''' – gibt zusätzlich mit Hilfe von <tt><nowiki><ref></nowiki></tt>-Tags formatierten Einzelnachweis als Quellenangabe zurück. Mit <code>references=only</code> wird '''nur''' die Quellenangabe ausgegeben.
* '''sort''' – Sortierung nach Qualifikatoren
* '''sortInItem''' – wenn die Aussagen einer Eigenschaft Wikidata-Items darstellen, wird in diesem Item nach der in <tt>sortInItem</tt> angegebenen Eigenschaft gesucht und der Wert als Sortierschlüssel verwendet. Achtung: rechenintensiv!
* '''inverse'''  – gibt die sortierten Werte in absteigender Folge aus
* '''hasqualifier'''  – nur Aussagen mit Qualifikatoren ausgegeben. Kann mit einer Eigenschafts-Id (P…) auf einen bestimmten Qualifikator beschränkt werden.
* '''hassource'''  – nur Aussagen mit Einzelnachweisen ausgegeben. Kann mit einer Eigenschafts-Id (P…) auf einen bestimmten Einzelnachweis beschränkt werden. !P… ignoriert einen Einzelnachweis.
* '''atdate''' – nur Aussagen ausgegeben, die gemäß den Qualifikatoren {{Wikidata-Property|P580}} und  {{Wikidata-Property|P582}} am gegebenen Datum gültig sind. Bei keiner Datumsangabe wird das heutige Datum verwendet.
* '''showerrors''' – wenn keine Aussage gefunden werden kann, den Grund zurückgeben
<!--* '''default''' – wenn keine Aussage gefunden werden kann, den angegebenen Standardwert zurückgeben (''überschreibt showerrors'').-->
|- 
| style="border-top:solid 3px #E9E9E9" |
'''Beispiele:'''
* <tt><nowiki>{{#invoke:Wikidata|claim|P1082|id=Q64}}</nowiki></tt> → ''3401147'' für die Eigenschaft {{Wikidata-Property|P1082}}. Zahlen werden im Gegensatz zu <tt><nowiki>{{#property:}}</nowiki></tt> ohne Dezimalpunkte zurückgegeben.
* <tt><nowiki>{{#invoke:Wikidata|claim|P1082|id=Q64|qualifier=P585}}</nowiki></tt> → ''31. August 2013'' für den Qualifikator {{Wikidata-Property|P585}} der Eigenschaft {{Wikidata-Property|P1082}}
* <tt><nowiki>{{#invoke:Wikidata|claim|P1082|id=Q64|qualifier=P585|parameter=time}}</nowiki></tt> → ''2013-08-31T00:00:00Z''. Abruf des (normalisierten) Rohdatums.
* <tt><nowiki>{{#invoke:Wikidata|claim|P1082|id=Q64|qualifier=P585|parameter=precision}}</nowiki></tt> → ''11'' (taggenaue Angabe)
* <tt><nowiki>{{#invoke:Wikidata|claim|P1082|id=Q64|qualifier=P585|parameter=time:Y}}</nowiki></tt> → ''2013''. Abruf des formatierten Datums.
* <tt><nowiki>{{#invoke:Wikidata|claim|</nowiki>{{#invoke:Wikidata|labelOf|P1082}}|id=Q64}}</tt> → ''3401147''
* <tt><nowiki>{{#invoke:Wikidata|claim|P6|list=,&amp;#32;}}</nowiki></tt> → ''Klaus Wowereit, Eberhard Diepgen, Walter Momper, Eberhard Diepgen, Richard von Weizsäcker, Hans-Jochen Vogel, Dietrich Stobbe, Klaus Schütz, Heinrich Albertz, Willy Brandt, Franz Amrehn, Otto Suhr, Walther Schreiber, Ernst Reuter'' für die Eigenschaft {{Wikidata-Property|P6}}
* <tt><nowiki>{{#invoke:Wikidata|claim|P6|list=,&amp;#32;|parameter=link}}</nowiki></tt> → ''[[Klaus Wowereit]], [[Eberhard Diepgen]], [[Walter Momper]], [[Eberhard Diepgen]], [[Richard von Weizsäcker]], [[Hans-Jochen Vogel]], [[Dietrich Stobbe]], [[Klaus Schütz]], [[Heinrich Albertz]], [[Willy Brandt]], [[Franz Amrehn]], [[Otto Suhr]], [[Walther Schreiber]], [[Ernst Reuter]]''
* <tt><nowiki>{{#invoke:Wikidata|claim|P6|id=Q64|atdate=2000-01-01}}</nowiki></tt> → Eberhard Diepgen
* <tt><nowiki>{{#invoke:Wikidata|claim|P901|references=ja}}</nowiki></tt> → ''GM16&lt;ref&gt;Datenherkunft: englischsprachige Wikipedia, URL: https://en.wikipedia.org/w/index.php?title=List_of_FIPS_region_codes_(G%E2%80%93I)&oldid=575296220, Originalsprache: Englisch, Titel: List of FIPS region codes (G-I), abgerufen am: 2013-12-30T00:00:00Z&lt;/ref&gt;''
<!--* <tt><nowiki>{{{Bevölkerungszahl|{{#invoke:Wikidata|claim|P1082}}}}}</nowiki>{{0|1=default={{!}}}}</tt> → Vorlagenparameter bevorzugt ausgeben, wenn vorhanden, sonst Wikidata-Eintrag
* <tt><nowiki>{{#invoke:Wikidata|claim|P1082|default={{{Bevölkerungszahl|}}}}}</nowiki></tt> → Wikidata-Eintrag bevorzugt ausgeben, wenn vorhanden, sonst Vorlagenparameter-->
|}

'''Fehlt noch:'''
* Mehrere Aussagen können mit einem Separator getrennt zurückgegeben werden, in vielen Fällen ist jedoch eine besser formatierte Lösung bevorzugt. Daher wird vermutlich eine templatebasierte Rückgabe implementiert werden.

=== <tt>getValue</tt> ===
Kombiniert die Funktionalität von <tt>claim</tt> mit der Funktion <tt>getValue</tt> des englischen [[:en:Module:Wikidata|Module:Wikidata]], d.h. es wird nur Wikidata abgefragt, wenn dies explizit (üblicherweise beim Ausfüllen einer [[Hilfe:Vorlagen|Vorlage]]) angegeben wird. Bei einer Verwendung in Vorlagen überträgt dies damit die Kontrolle ob Wikidata verwendet werden soll auf den Ausfüller einer Vorlage. Dies kann hilfreich dabei sein den [[Wikicode]] von Vorlagen verständlich zu halten.

''Hinweis:'' Das englische Wikidata-Modul geht bei <tt>getValue</tt> stets davon aus, dass die abgefragte Eigenschaft ein Verweis auf einen Wikipedia-Artikel ist und verlinkt diesen. Diese automatische Verlinkung geschieht hier ''nicht'', sondern muss wie im unten angegebenen Beispiel explizit angegeben werden.
{| {{Bausteindesign5}}
|
'''Parameter:'''
* siehe <tt>[[#claim|claim]]</tt>
* '''2''' – Gibt stets diesen angegebenen Wert zurück, außer dieser ist <tt>ABFRAGE_WIKIDATA</tt>, wobei dann die Funktion <tt>claim</tt> aufgerufen wird. (Das englische <tt>FETCH_WIKIDATA</tt> funktioniert ebenso, sollte aber zugunsten der deutschen Version vermieden werden.) Mittels eines vordefinierten <tt>ABFRAGE_WIKIDATA</tt> in der Vorlage kann die Abfrage auch erfolgen, wenn ein Parameter nicht gesetzt wurde.
|- 
| style="border-top:solid 3px #E9E9E9" |
'''Beispiel:'''
Angenommen die Vorlage {{Vorlage|Infobox Staat}} verwendet zur Ausgabe der Eigenschaft Hauptstadt den Vorlagencode <tt><nowiki>{{#invoke:Wikidata|getValue|P36|{{{HAUPTSTADT|}}}|parameter=link}}</nowiki></tt> und im Artikel Deutschland würde diese wie folgt ausgefüllt:
* <tt><nowiki>{{Infobox Staat|…|HAUPTSTADT=[[Berlin]]|…}}</nowiki></tt> → ''[[Berlin]]'', kein Wikidata verwendet
* <tt><nowiki>{{Infobox Staat|…|HAUPTSTADT=ABFRAGE_WIKIDATA|…}}</nowiki></tt> → ''[[Berlin]]'', Wikidata verwendet
* <tt><nowiki>{{Infobox Staat|…|HAUPTSTADT=|…}}</nowiki></tt> → &nbsp; &nbsp; &nbsp;, kein Wikidata verwendet
* <tt><nowiki>{{Infobox Staat|…|…}}</nowiki></tt> → &nbsp; &nbsp; &nbsp;, kein Wikidata verwendet

Wenn ein Wert vordefiniert wurde mittels <tt><nowiki>{{#invoke:Wikidata|getValue|P36|{{{HAUPTSTADT|ABFRAGE_WIKIDATA}}}|parameter=link}}</nowiki></tt>:
* <tt><nowiki>{{Infobox Staat|…|HAUPTSTADT=[[Berlin]]|…}}</nowiki></tt> → ''[[Berlin]]'', kein Wikidata verwendet
* <tt><nowiki>{{Infobox Staat|…|HAUPTSTADT=ABFRAGE_WIKIDATA|…}}</nowiki></tt> → ''[[Berlin]]'', Wikidata verwendet
* <tt><nowiki>{{Infobox Staat|…|HAUPTSTADT=|…}}</nowiki></tt> → &nbsp; &nbsp; &nbsp;, kein Wikidata verwendet
* <tt><nowiki>{{Infobox Staat|…|…}}</nowiki></tt> → ''[[Berlin]]'', Wikidata verwendet (Dies erschwert allerdings die Lesbarkeit des Wikicodes)
|}

=== <tt>descriptionIn</tt> ===
Gibt die Wikidata-Beschreibung des Wikidata-Objekts in der angegebenen Sprache (Wiki-Sprachcode) zurück.

{| {{Bausteindesign5}}
|
'''Parameter:'''
* '''1''' – Wiki-Sprachcode
* '''2''' – Id (Q…) des Wikidata-Objektes auf das zugegriffen werden soll. Wenn nicht angegeben wird das mit der aktuellen Seite verknüpfte verwendet.
|- 
| style="border-top:solid 3px #E9E9E9" |
'''Beispiel:'''
* <tt><nowiki>{{#invoke:Wikidata|descriptionIn|nl}}</nowiki></tt> → ''{{#invoke:Wikidata|descriptionIn|nl|Q64}}''
|}

=== <tt>labelIn</tt> ===
Gibt den Wikidata-Titel des Wikidata-Objekts in der angegebenen Sprache (Wiki-Sprachcode) zurück.

{| {{Bausteindesign5}}
|
'''Parameter:'''
* '''1''' – Wiki-Sprachcode
* '''2''' – Id (Q…) des Wikidata-Objektes auf das zugegriffen werden soll. Wenn nicht angegeben wird das mit der aktuellen Seite verknüpfte verwendet.
|- 
| style="border-top:solid 3px #E9E9E9" |
'''Beispiel:'''
* <tt><nowiki>{{#invoke:Wikidata|labelIn|nl}}</nowiki></tt> → ''Berlijn''
|}

=== <tt>labelOf</tt> ===
Gibt den deutschsprachigen Titel des angegebenen Wikidata-Objekts oder -Eigenschaft zurück.

{| {{Bausteindesign5}}
|
'''Parameter:'''
:* '''1''' – ID des Wikidata-Elements (Q…) oder -Eigenschaft (P…). Wenn nicht angegeben wird das Element der aktuellen Seite verwendet.
|- 
| style="border-top:solid 3px #E9E9E9" |
'''Beispiele:'''
* <tt><nowiki>{{#invoke:Wikidata|labelOf|</nowiki>[[d:Q1589880|Q1589880]]}}</tt> → ''{{#invoke:Wikidata|labelOf|Q1589880}}''
* <tt><nowiki>{{#invoke:Wikidata|labelOf|</nowiki>[[d:Property:P281|P281]]}}</tt> → ''{{#invoke:Wikidata|labelOf|P281}}''
|}

=== <tt>pageId</tt> ===
Gibt die Id eines Wikidata-Objekts zurück, um beispielsweise zu überprüfen, ob die aktuelle Seite mit einem Wikidata-Objekt verbunden ist oder ob das Wikidata-Objekt eine Weiterleitung auf ein anderes Wikidata-Objekt darstellt.

{| {{Bausteindesign5}}
|
'''Parameter:'''
* '''1''' – Id (Q…) des Wikidata-Objektes auf das zugegriffen werden soll. Wenn nicht angegeben wird das mit der aktuellen Seite verknüpfte verwendet.
|- 
| style="border-top:solid 3px #E9E9E9" |
'''Beispiel:'''
* <tt><nowiki>{{#invoke:Wikidata|pageId}}</nowiki></tt> → ''Q64'', wenn auf der Seite Berlin aufgerufen
* <tt><nowiki>{{#invoke:Wikidata|pageId|</nowiki>[[d:Q18511155|Q18511155]]}}</tt> → ''{{#invoke:Wikidata|pageId|Q18511155}}'', da Weiterleitung
|}

=== <tt>sitelinkOf</tt> ===
Gibt den Titel der mit dem Wikidata-Element verbunden Seite in der deutschen Wikipedia zurück.

{| {{Bausteindesign5}}
|
'''Parameter:'''
* '''1''' – Id (Q…) des Wikidata-Objektes auf das zugegriffen werden soll. Wenn nicht angegeben wird das mit der aktuellen Seite verknüpfte verwendet.
|- 
| style="border-top:solid 3px #E9E9E9" |
'''Beispiel:'''
* <tt><nowiki>{{#invoke:Wikidata|sitelinkOf|</nowiki>[[d:Q1589880|Q1589880]]}}</tt> → ''{{#invoke:Wikidata|sitelinkOf|Q1589880}}''
|}

=== <tt>sitelinkCount</tt> ===
Zählt die mit dem Wikidata-Objekt verbundenen Seiten.

{| {{Bausteindesign5}}
|
'''Parameter:'''
* '''1''' – Projekt-Filter. Standardmäßig werden alle Wikiprojekte berücksichtigt, bei <tt>wiki</tt> nur die Wikipedia-Sprachversionen und Commons, <tt>wikibooks</tt>, <tt>wikinews</tt>, <tt>wikiquote</tt>, <tt>wikisource</tt> und <tt>wikivoyage</tt> jeweils nur die Sprachversionen dieser Projekte. Daneben kann auch konkret eine Sprachversion wie <tt>enwiki</tt> angegeben werden, welches entsprechend 0 oder 1 zurückgibt, je nachdem ob es einen Artikel in der Sprachversion gibt.
* '''2''' – Id (Q…) des Wikidata-Objektes auf das zugegriffen werden soll. Wenn nicht angegeben wird das mit der aktuellen Seite verknüpfte verwendet.
|- 
| style="border-top:solid 3px #E9E9E9" |
'''Beispiel:'''
* <tt><nowiki>{{#invoke:Wikidata|sitelinkCount}}</nowiki></tt> → ''{{#invoke:Wikidata|sitelinkCount||Q64}}'', wenn auf der Seite Berlin aufgerufen
* <tt><nowiki>{{#invoke:Wikidata|sitelinkCount|wiki}}</nowiki></tt> → ''{{#invoke:Wikidata|sitelinkCount|wiki|Q64}}'', wenn auf der Seite Berlin aufgerufen
* <tt><nowiki>{{#invoke:Wikidata|sitelinkCount|wikinews}}</nowiki></tt> → ''{{#invoke:Wikidata|sitelinkCount|wikinews|Q64}}'', wenn auf der Seite Berlin aufgerufen
|}

=== <tt>badges</tt> ===
Gibt die Auszeichnungen der mit dem Wikidata-Objekt verbunden Seite im angegebenen Wikimedia-Projekt zurück. Die Auszeichnungen sind üblicherweise {{Wikidata-Property|Q17437798}} oder {{Wikidata-Property|Q17437796}}. Mehrere Auszeichnungen sollten nicht vorkommen, würden aber durch einen Schrägstrich getrennt ausgegeben.

{| {{Bausteindesign5}}
|
'''Parameter:'''
* '''1''' – Id des Wikimedia-Projekts, z.B. <tt>enwiki</tt> für die englische Wikipedia.
* '''2''' – Id (Q…) des Wikidata-Objektes auf das zugegriffen werden soll. Wenn nicht angegeben wird das mit der aktuellen Seite verknüpfte verwendet.
|- 
| style="border-top:solid 3px #E9E9E9" |
'''Beispiel:'''
* <tt><nowiki>{{#invoke:Wikidata|badges|dawiki}}</nowiki></tt> → ''{{#invoke:Wikidata|badges|dawiki|Q64}}'' (lesenswerter Artikel der dänischen Wikipedia), wenn auf der Seite Berlin aufgerufen
|}

== Debug-Funktionen ==
Die folgenden Funktionen können auf Wikipedia-Seiten (insbesondere [[Spezial:Vorlagen expandieren]]) zu Debugging- oder Entwicklungszwecken aufgerufen werden um detailliertere Informationen zu Programmfehlern und Wikidata-Datenstrukturen zu erhalten.

=== <tt>printEntity</tt> ===
Gibt alle mit der aktuellen Seite verbundenen Wikidata-Daten zurück.

{| {{Bausteindesign5}}
|
'''Parameter:'''
* '''1''' – Id (Q…) des Wikidata-Objektes auf das zugegriffen werden soll. Wenn nicht angegeben wird das mit der aktuellen Seite verknüpfte verwendet.
<!--|- 
| style="border-top:solid 3px #E9E9E9" |
'''Beispiel:'''
* <tt><nowiki>{{#invoke:Wikidata|printEntity}}</nowiki></tt> → 
-->
|}

=== <tt>debug</tt> ===
Falls ein Modulaufruf einen Skriptfehler zurückgibt, können hiermit die eigentlichen Fehlerinformationen (Fehlerbeschreibung und evtl. Ort) abgerufen werden.

{| {{Bausteindesign5}}
|
'''Parameter:'''
* '''1''' – Name der Funktion
* weitere Parameter – Parameter dieser Funktion
|- 
| style="border-top:solid 3px #E9E9E9" |
'''Beispiel:'''
* <tt><nowiki>{{#invoke:Wikidata|debug|claim|P1082|qualifier=P585}}</nowiki></tt> anstatt <tt><nowiki>{{#invoke:Wikidata|claim|P1082|qualifier=P585}}</nowiki></tt> um konkrete Fehlerinformationen zu letzterem zu erhalten, wenn dort ein Skriptfehler auftritt.
|}
</onlyinclude>

== Verwendung ==
Allgemeine Bibliothek.

== Siehe auch ==
* {{Vorlage|Graph:Lines}}, grafische Darstellung in Diagrammform von Wikidata-Daten beliebiger Komplexität mittels [[SPARQL]]
* [[Modul:WikidataChart]], grafische Darstellung in Diagrammform von Wikidata-Einträgen von einfachen Abfragen

[[Kategorie:Regiowiki:Lua/Modul/Dokumentation|Wikidata]]
[[Kategorie:Regiowiki:Wikidata]]