Modul:Wikidata/doc

Aceasta este pagina de documentație pentru Modul:Wikidata. Pagina descrie modul de folosire al formatului și conține categoriile de care acesta aparține, precum și orice altceva ce nu face parte din formatul propriu-zis. Ea poate fi editată modificând pagina Modul:Wikidata/doc

Acest modul folosește pentru accesarea datelor din structurile de la Wikidata. Desigur, există {{#property:}} cu care se poate accesa o proprietate a itemului curent, dar de cele mai multe ori este nevoie de acțiuni mai complexe.

Convenții

Funcțiile al căror nume începe cu get sunt dedicate formatelor și paginilor, și primesc ca argument un frame (care se transmite automat la apelul din pagini sau formate). Cele al căror nume începe cu find sunt dedicate celorlalte module, și primesc ca argumente direct valorile necesare. De regulă, cele din urmă doar extrag argumentele, apoi le apelează pe cele dintâi cu argumentele extrase.

Funcții exportate

Funcție	Argumente	Comportament
descriptionIn	frame cuprinzând ca argumente: codul limbii id-ul itemului de Wikidata	Extrage descrierea unui item într-o limbă. Limba este specificată de primul argument și poate lipsi, caz în care se folosește limba wikiului; id-ul itemului poate lipsi, caz în care se folosește itemul asociat paginii curente.
labelIn	frame cuprinzând ca argumente: codul limbii id-ul itemului de Wikidata	Extrage eticheta unui item într-o limbă. Limba este specificată de primul argument și poate lipsi, caz în care se folosește limba wikiului; id-ul itemului poate lipsi, caz în care se folosește itemul asociat paginii curente.
getEntityId		Extrage id-ul entității curente.
findLinkToItem	entityId - id-ul entității capitalize - flag care cere scrierea cu inițială majusculă feminine - flag care cere căutarea formei feminine shortestAlias - flag care cere căutarea unei abrevieri	Creează un link către articolul despre o altă entitate decât cea în pagina în care ne aflăm. Se poate cere scrierea etichetei linkului cu inițială majusculă (dacă regulile gramaticale o impun — cazul în care linkul se pune la începutul unui titlu sau al unei fraze); în forma de feminin (de exemplu, pentru meserii, dacă ele sunt referite ca practicate de o femeie); sau cu cea mai scurtă variantă posibilă (dacă se dorește o abreviere). Oricare din ultimele trei flaguri poate lipsi, caz în care ele sunt considerate a avea valoarea false.
findLinkToItemWithLabelFromClaim	* entityId - id-ul entității capitalize - flag care cere scrierea cu inițială majusculă propertyId - identifică proprietatea folosită pentru extragerea etichetei linkului	Ca și findLinkToItem, doar că generalizează modul de obținere a etichetei: se poate preciza o proprietate a entității de la care se va obține eticheta
printSnak	snak - elementul din structura Wikidata	Afișează un „snak” (element polimorf din structura de date de la Wikidata). Este utilă atunci când într-un modul se procesează date preluate în mod direct din structurile de date de la Wikidata. Acest snak poate fi o dată calendaristică, id-ul unui alt item Wikidata, un șir de caractere etc. Funcția ia decizia a ce afișează în funcție de tipul snakului.
outputReferences	claim - Structura de date de la Wikidata care modelează o afirmație	Creează note de subsol conținând referințele bibliografice asociate unei afirmații. Notele de subsol sunt evitate dacă referința este către un alt proiect Wikipedia. Numele refului se calculează automat pentru a putea fi reutilizat de la o instanță la alta.
getValue	Un frame, având ca prim parametru id-ul proprietății	Afișează datele asociate proprietății specificate ca prim argument în cadrul frame-ului, separate prin virgulă și cu referințele date ca note de subsol.
getValueList	entityId - id-ul entității; dacă este nil, e vorba de entitatea curentă propertyId - id-ul proprietății	Întoarce un table format din toate valorile cu rang de la normal în sus pentru proprietatea și entitatea specificată.
printTimestampForClaim	claim - Structura de date de la Wikidata care modelează o afirmație	Întoarce, între paranteze, datele temporale asociate afirmației: simpla specificare a datei dacă e dată prin proprietatea P585 (point in time) „din” urmat de specificarea datei dacă este definită doar proprietatea P580 (start time) „până la” urmat de specificarea datei dacă este definită doar proprietatea P582 (end time) specificarea datelor date de proprietățile P580 și P582 separate de en-dash (–) dacă sunt definite ambele
getTimestampedValueList	entityId - id-ul entității; dacă este nil, e vorba de entitatea curentă propertyId - id-ul proprietății	Întoarce un table format din valorile pe care le-ar returna funcția getValueList, fiecare urmată de valoarea pe care ar returna-o, pentru fiecare, funcția printTimestampForClaim apelată cu claimul asociat fiecăreia.
getValueListWithSeparator	Un frame, având pe prima poziție separatorul, pe a doua id-ul de proprietate și pe a treia id-ul de entitate	Returnează o listă ale cărei elemente sunt separate prin separatorul specificat, elementele fiind valorile pe care le-ar returna funcția getValueList apelată cu id-urile de proprietate și entitate specificate.
_getValueListWithSeparator	Ca și getValueListWithSeparator, doar că primește direct table-ul de argumente, nu frame-ul	Ca și getValueListWithSeparator.
getTimestampedValueListWithSeparator	Un frame, având pe prima poziție separatorul, pe a doua id-ul de proprietate și pe a treia id-ul de entitate	Returnează o listă ale cărei elemente sunt separate prin separatorul specificat, elementele fiind valorile pe care le-ar returna funcția getTimestampedValueList apelată cu id-urile de proprietate și entitate specificate.
_getTimestampedValueListWithSeparator	Ca și getTimestampedValueListWithSeparator, doar că primește direct table-ul de argumente, nu frame-ul	Ca și getTimestampedValueListWithSeparator.
getEntityIdsList	entityId - id-ul entității; dacă este nil, e vorba de entitatea curentă propertyId - id-ul proprietății	Întoarce un table conținând id-urile de entitate, cu rank cel puțin normal, către care trimite proprietatea specificată a entității specificate.
getBestEntityIdsList	entityId - id-ul entității; dacă este nil, e vorba de entitatea curentă propertyId - id-ul proprietății	Întoarce un table conținând id-urile de entitate, cu rank cel mai mare, către care trimite proprietatea specificată a entității specificate.
findClaimsForProperty	entityId - id-ul entității; dacă este nil, e vorba de entitatea curentă propertyId - id-ul proprietății	Întoarce un table conținând claimurile pure ce reprezintă afirmațiile asociate proprietății specificate a entității specificate.
findBestClaimsForProperty	entityId - id-ul entității; dacă este nil, e vorba de entitatea curentă propertyId - id-ul proprietății	Întoarce un table conținând claimurile pure ce reprezintă afirmațiile cu cel mai bun rang, asociate proprietății specificate a entității specificate.
findSortedClaimsForProperty entityId - id-ul entității; dacă este nil, e vorba de entitatea curentă propertyId - id-ul proprietății	Întoarce un table conținând claimurile pure ce reprezintă afirmațiile asociate proprietății specificate a entității specificate, sortate în funcție de calificatorul end time (P580) asociat lor.
findQualifierValueListForClaim	claim - Structura de date de la Wikidata care modelează o afirmație qualifierId - id-ul calificatorului	Întoarce un table conținând reprezentarea valorilor asociate calificatorului specificat pentru claimul specificat.
getQualifierValue	Un frame conținând în tabelul args, în ordine, id-ul proprietății și id-ul calificatorului	Întoarce reprezentarea tuturor calificatorilor cu id-ul specificat pentru proprietatea cu id-ul specificat a entității curente. Calificatoarele sunt separate prin virgulă și spațiu.
getRawValue	Un frame având pe prima poziție a tabelului args valoare id-ului proprietății.	Întoarce reprezentarea dată de funcția formatPropertyValues a entitătii curente, apelată cu id-ul de proprietate specificat.
getRawQualifierValue	Un frame având pe prima poziție a tabelului args valoare id-ului proprietății și pe a doua id-ul unui calificator.	Întoarce reprezentarea simplă a valorii (dacă valoarea este id-ul unui alt element, aceasta este labelul acelui element) tuturor calificatoarelor cu id-ul specificat ale id-ului proprietății cu id-ul specificat a entității curente. Reprezentările sunt separate prin virgulă.
findDateValues	propertyId - id-ul proprietății entityId - id-ul entității; dacă este nil, e vorba de entitatea curentă	Întoarce un table ale cărui elemente sunt la rândul lor table-uri reprezentând datele cu rangul cel mai bun asociate proprietății cu id-ul specificat al entității cu id-ul specificat. Proprietățile fiecărui element din table-ul ce reprezintă data sunt: day - ziua din lună month - luna din an, întreg între 1 și 12 year - anul, poate fi valoare negativă pentru datele dinaintea erei noastre claim - claimul brut asociat datei, pentru eventuale procesări ulterioare precision - precizia, în codificarea Wikidata calendarmodel - modelul calendarului, ca URL de entitate
getDateValue	Un frame conținând în tabelul args pe prima poziție id-ul de proprietate, pe a doua id-ul de entitate (nil înseamnă entitatea curentă), pe a treia un format de dată (implicit dmy) și pe a patra un sufix pentru datele dinaintea erei noastre	Întoarce o listă a datelor cu rang cel puțin normal asociate id-ului de proprietate și id-ului de entitate specificate, formatate după cum specifică formatul de dată și sufixul, separate prin virgulă și spațiu.