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.

Modificatori de formatare

Anumite funcții apelate din formate permit următorii parametri ce modifică formatarea rezultatelor:

• ill: înlocuiește formatarea legăturilor către Wikidata folosită în infocasete cu folosirea formatului {{ill-wd}}.
• si: convertește „snak”-urile de tip cantitate la o unitate a Sistemului Internațional echivalentă.

Toți acești parametri pot avea orice valoare.

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
findLinkToItemWithLabelFromAnyClaim	entityId - id-ul entității capitalize - flag care cere scrierea cu inițială majusculă propertyIdsTable - listă de proprietăți folosite pentru extragerea etichetei linkului	Ca și findLinkToItemWithLabelFromClaim, doar că generalizează și mai mult modul de obținere a etichetei: se poate preciza o listă de proprietăți ale entității care sunt verificate pe rând până se găsește una care are o valoare
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.
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ă.
getValueListLimited	entityId - id-ul entității; dacă este nil, e vorba de entitatea curentă propertyId - id-ul proprietății limitVal - numărul de itemi de obținut; dacă este negativ sau nil, este considerat nelimitat	Întoarce un table cu cel mult limitVal elemente format din valori cu rang de la normal în sus pentru proprietatea și entitatea specificată și un int ce reprezintă numărul total de valori ce ar fi fost întoarse dacă nu exista limitVal
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.
findValueListWithQualifiersInBrackets	entityId - id-ul entității; dacă este nil, e vorba de entitatea curentă propertyId - id-ul proprietății best - true/false dacă se dorește sau nu limitarea doar la cele mai bune valori (ignoră valorile cu rang normal dacă există valori cu rang preferat) bracketTemplate - un format pentru datele din paranteză, unde codul fiecărei proprietăți este prefixat de semnul $. De exemplu, formatul $P580-$P582 înseamnă dată de început-dată de sfârșit	Întoarce un table format din valorile pe care le-ar returna funcția getValueList, fiecare urmată de o paranteză conținând calificativele sale de la Wikidata formatate după template-ul specificat ca al patrulea parametru.
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 (opțional) modificatori de formatare	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 start 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.
pageId		Întoarce id-ul din Wikidata al elementului asociat paginii curente
getPreferredValue	Un frame conținând în tabelul args pe prima poziție id-ul de proprietate și pe a doua id-ul de entitate (nil înseamnă entitatea curentă)	Întoarce, separate prin virgulă, valorile cu rang preferred pentru entitatea și proprietatea specificate.
ViewSomething	Un frame conținând în tabelul args o serie de elemente care împreună constituie o cale de urmat prin modelul de date de la Wikidata	Întoarce data existentă pe calea specificată.
Dump	Un frame conținând în tabelul args o serie de elemente care împreună constituie o cale de urmat prin modelul de date de la Wikidata	Întoarce datele existente pe calea specificată; dacă datele sunt un tabel, el se expandează și se afișează toate datele din el. Funcția este de folosit pentru debug și pentru analiză
findOneValue	propertyId - id-ul proprietății entityId - id-ul entității sau însăși entitatea; dacă este nil, e vorba de entitatea curentă	Returnează o singură valoare din cele cu rangul cel mai înalt cu referințele corespunzătoare pentru o proprietate specificată, împreună cu note de subsol care reprezintă referințele bibliografice. Se apelează din alte module.
findOneValueNoRef	propertyId - id-ul proprietății entityId - id-ul entității sau însăși entitatea; dacă este nil, e vorba de entitatea curentă	Același lucru ca findOneValue, dar fără referințe bibliografice.
getOneValue	Un frame conținând în tabelul args pe prima poziție id-ul de proprietate și pe a doua id-ul de entitate (nil înseamnă entitatea curentă) (opțional) modificatori de formatare	Returnează o singură valoare din cele cu rangul cel mai înalt cu referințele corespunzătoare pentru o proprietate specificată, împreună cu note de subsol care reprezintă referințele bibliografice.
getOneValueNoRef	Un frame conținând în tabelul args pe prima poziție id-ul de proprietate și pe a doua id-ul de entitate (nil înseamnă entitatea curentă)	Același lucru ca getOneValue, dar fără referințe bibliografice.
getLatestQualifierDateValueForOneProperty	Un frame conținând în tabelul args pe prima poziție id-ul de proprietate și pe a doua id-ul qualifierului	Returnează valoarea cea mai recentă a qualifierului specificat pentru proprietea specificată a entității curente
findLatestQualifierDateValueForOneProperty	propertyId - id-ul proprietății qualifierId - id-ul qualifierului	Același lucru ca și getLatestQualifierDateValueForOneProperty, doar că de apelat din alte module
getReferenceForOneProperty	Un frame conținând în tabelul args pe prima poziție id-ul proprietății	Returnează un text ce conține referința pentru o proprietate a entității curente; de apelat din formate
findLabel	entityId - id-ul entității lang - codul limbii	Returnează labelul unei entități în limba specificată; dacă nu se găsește, atunci se încearcă în limba wikiului și apoi în limba engleză
getLabel	Un frame conținând în tabelul args pe prima poziție id-ul de entitate (nil înseamnă entitatea curentă) și pe a doua codul limbii	Ca și findLabel, dar apelabil din formate sau pagini
findBestValues	propertyId - id-ul proprietății entity - id-ul entității sau însăși entitatea; dacă este nil, e vorba de entitatea curentă	Returnează o listă a valorilor cu rangul cel mai înalt cu referințele corespunzătoare pentru o proprietate specificată. Apelabil din module.
getBestValuesWithSeparator	Un frame conținând în tabelul args pe prima poziție un separator, pe a doua id-ul proprietății și pe a treia id-ul de entitate (nil înseamnă entitatea curentă).	Returnează valorile cu rangul cel mai înalt și cu referințele corespunzătoare pentru o proprietate specificată, despărțite prin separatorul specificat
findLanguageText	propertyId - id-ul de proprietate langcode - codul limbii entityId - id-ul de entitate	Întoarce labelul unei entități asociate proprietății specificate a entității specificate, în limba specificată; dacă nu se specifică entityId, se folosește entitatea curentă; dacă nu se specifică langcode, se caută întâi în limba wikiului și apoi în limba engleză
getLanguageText	Un frame conținând în tabelul args pe prima poziție id-ul de proprietate, pe a doua codul limbii și pe a treia id-ul de entitate	Același lucru ca și findLanguageText, doar că apelabilă din formate și pagini
findClaimForTimestamp	entityId - id-ul entității; dacă este nil, e vorba de entitatea curentă propertyId - id-ul proprietății timestamp - un obiect de tip dată (cu valori numerice corespunzătoare în câmpurile day, month, year, precision) lang - opțional: dacă tipul de date căutat este multi-language, atunci se caută această limbă; dacă lipsește, se caută româna	Claimul din entitatea specificată, corespunzător proprietății specificate, cu valori ale calificatorilor pentru proprietățile start time și end time care cuprind între ele data specificată de timestamp. Dacă timestamp lipsește, se returnează primul claim întâlnit cu rangul cel mai mare.
findOnlineLinks	onlinelinksprops - un table ce conține id-uri de proprietăți care să fie explorate în vederea extragerii de legături externe entityId - id-ul entității	Un table ce conține legăturile web formatate cu tot cu titlu, pentru entitatea specificată
getOnlineLinks	Un frame ce conține pe pozițiile numerice valorile proprietăților de căutat, iar pe poziția qid ID-ul entității asociate; dacă nu este precizat, se consideră entitatea asociată paginii curente	Ca și findOnlineLinks, doar că lista este concatenată cu fiecare link pe câte o linie.
findTitleOfWork	entityId - id-ul entității	Titlul unei opere așa cum ar trebui afișat aici. Se caută, în ordine: eticheta în română, titlul în română, titlul în limba originară, eticheta în limba originară, eticheta în engleză
findTitlesOfWorksFromProperty	propertyId - id-ul proprietății entityId - id-ul entității	Caută cu ajutorul funcției findTitleOfWork de mai sus titlurile unor opere listate în proprietatea specificată a entității specificate și le returnează ca intrări într-un table; titlurile sunt linkuri trimit spre articolul sau itemul wikidata corespunzător operei;
findBestValuesForLocalLanguage	propertyId - id-ul proprietății entityId - id-ul entității	Returnează o listă a valorilor de cel mai mare rang asociate limbii române prin intermediul unui calificator cu proprietatea limba operei sau a denumirii (P407).
getBestValuesForLocalLanguageWithSeparator	sep - un separator propertyId - id-ul proprietății entityId - id-ul entității	ca mai sus, doar că apelabilă din format; primește mai întâi un separator și apoi id-urile
getTitleOfWorkFromPropertyWithSeparator	Un frame ce conține următoarele argumente: sep - un separator propertyId - id-ul proprietății entityId - id-ul entității	Ca și findTitlesOfWorksFromProperty, dar primește frame, returnează lista serializată cu separatori și cu titlurile italicizate
loadOneValueInChain	Un număr teoretic nelimitat de argumente înlănțuite care descriu o cale prin structurile Wikidata. Implicit, punctul de început este elementul Wikidata asociat paginii curente. Dacă un argument este un ID de element Wikidata, atunci acela este stabilit ca punct de început. Dacă este un ID de proprietate, atunci se trece la valoarea proprietății respective pentru elementul curent. Dacă este un ID de proprietate precedat de _ atunci se trece la calificatorul asociat proprietății respective asociate snakului curent. În cele două cazuri din urmă se folosește la fiecare pas doar un singur snak, de rangul cel mai mare. Vezi și {{Date înlănțuite de la Wikidata}}.	Forma textuală a snakului final de pe lanț; nil dacă nu există date sau lanțul nu poate fi parcurs până la destinație
getOneValueInChain	Ca și mai sus, doar că apelabil cu un frame	Ca și mai sus
isA	entityId - ID-ul unei entități typeIds - un table care conține o listă de ID-uri de entități	true dacă entitatea cu id-ul entityId are unul din tipurile cu ID-ul din colecția typeIds sau unul din subtipurile directe sau indirecte ale acestuia; false altfel
formatExternalLink	Formatează o proprietate a cărei valoare este un link extern	pId - ID-ul de proprietate qId - ID-ul de entitate text - textul care să apară pe link în locul valorii proprietății
getFormattedExternalLink	Ca și mai sus, apelabilă cu un frame	Ca și mai sus, apelabilă cu un frame; pId poate fi dat ca primul parametru fără nume; qId poate fi dat ca al doilea parametru fără nume
findAnniversary	propertyId - id-ul proprietății entityId - id-ul entității step - un număr întreg reprezentând numărul de ani la care se consideră o aniversare	Întoarce numărul de ani trecuți de la evenimentul descris în proprietate dacă acesta este multiplu de step, 0 altfel
getAnniversary	Ca și mai sus, doar că apelabil cu un frame	Ca și mai sus
getLocationChain	(opțional) modificatori de formatare	Întoarce o listă de locații în care se află entitatea curentă