Modul:Dallisták szerzővel/doc

A modul célja egytáblás lekérdezések végrehajtása. A tábla adatait egy program gyűjti össze, és (egyelőre) kézzel kerül a Kották metaadatai modulba. A lekérdezések kimenete wikitáblázat fejléc nélkül (így a feliratokat nem kell paraméterben átadni a modulnak). A hívó sablonban a táblázat rendezhetővé tehető. A táblázat lezárása is a hívó sablon dolga, így több modulhívás tehető egy táblázatba.

A modul által végezhető lekérdezések általános alakja SQL-ben:

select oszloplista from Kották_metaadatai where szűrőfeltételek group by oszlop order by oszloplista;

Miután a kimenet-tábla rendezhető, a modul (egyelőre) nem rendez.

Paraméterek

A modulnak egyetlen belépési pontja van: a dallista függvény.

Oszloplista

Oszlopok = oszlop1, oszlop2, … , ahol oszlopn a Dal infobox valamelyik mezője. A szócikk címe mindig belekerül a kimenet első oszlopába. Ha az Oszlopok-ban meg van adva a Szerző, továbbá a Dallam és Szöveg valamelyike, akkor e három mező egymás melletti két oszlopba kerül, közvetlenül a szócikk címe után. A Szerző oszlopa dupla széles. E kivételtől eltekintve az oszlopok a paraméterben megadott sorrendben íródnak ki.

Szűrőfeltételek

oszlop1 = érték1|oszlop2 = érték2| … , ahol oszlopn jelentése azonos az oszloplistabelivel, értékn a mező értéke. Csonkítás, wildchard nem lehetséges. Az összehasonlítás előtt a modul törli a <ref>…</ref> közötti szöveget és az érték linkjét. A szűrőfeltételek ÉS kapcsolatban állnak. OR-t két modulhívással lehet elérni.

NOT a mező eleji felkiáltójellel adható meg. A két felkiáltójel az eredményből kizárja az üres értékeket.

Ha a szűrőfeltételben az oszlop dallam vagy szöveg, és annak értéke üres, a kiértékelésben az érték a szerző oszlop értéke lesz. Más szóval: a dallam mezőben megadott komponistát akkor is megtalálja a program, ha az infoboxban a szerző mezőben adtuk meg. Ez a tulajdonság NOT-tal (felkiáltójellel) kombinálva esetleg nem várt eredményt okozhat.

Group by

Groupby = oszlop. Kétoszlopos táblázatot hoz létre úgy, hogy az azonos értékű oszlopokat egyszer írja ki, a második oszlopba az előfordulási szám kerül. A Groupby szűrőfeltételekkel kombinálható, de oszloplista nem adható meg (pontosabban: figyelmen kívül marad).

Nosum

Group by használatakor nem ír Összesen sort. A paraméternév után ki kell írni az = jelet, értéket nem kell megadni.

Felsorolás

Felsorolás = szint. Táblázat helyett szint szintű wikifelsorolás használata, ha egy oszlopos lenne a táblázat. (Ha a cikkcímeken kívül más is kerül a táblázatba, akkor ez a paraméter figyelmen kívül marad. Ellenkező esetben a Nosum paramétert automatikusan bekapcsolja, így felsorolásos lista végére soha nem kerül összegsor.) Például a Felsorolás=2 két csillaggal kezdett (második szintű) listát generál.

Példák

{| class="wikitable sortable"
|+ Magyar komolyzenei szócikkek
! Szócikk !! Dallam !! Szöveg
{{#invoke:Dallisták szerzővel|dallista|műfaj=magyar komolyzenei dal|Oszlopok=szerző,dallam,szöveg}}
|}

Magyar népdalok stílus szerint

Szócikk	Darab
új	60
régi	100
vegyes	58
nincs megadva	44
Összesen	262

A fenti sablonhívás eredménye a bal oldali táblázatban.

Magyar komolyzenei szócikkek

Szócikk	Dallam	Szöveg
Szózat	Egressy Béni	Vörösmarty Mihály
Jancsi belépője	Kacsóh Pongrác	Heltai Jenő
Furulya nóta	Kacsóh Pongrác	Heltai Jenő
Magyar ünnepi dal	Liszt Ferenc
A francia királylány dala	Kacsóh Pongrác	Heltai Jenő
Székely himnusz	Mihalik Kálmán	Csanády György
Hazám, hazám	Erkel Ferenc	Nádasdy Kálmán
Iluska dala	Kacsóh Pongrác	Heltai Jenő
Egy rózsaszál	Kacsóh Pongrác	Heltai Jenő
Kék tó, tiszta tó	Kacsóh Pongrác	Heltai Jenő
A Reményhez	Kossovits József	Csokonai Vitéz Mihály
Meghalt a cselszövő	Erkel Ferenc	Egressy Béni
Hétfő, kedd	Bárdos Lajos
Summáját írom	Tinódi Lantos Sebestyén
Magyarország himnusza	Erkel Ferenc	Kölcsey Ferenc
Rákóczi-induló	Nikolaus Scholl
Összesen: 16

Példa group by-os lekérdezésre:

{| class="wikitable sortable" align="right"
|+ Magyar népdalok stílus szerint
! Szócikk !! Darab
{{#invoke:Dallisták szerzővel|dallista|műfaj=magyar népdal|Groupby=stílus}}
|}

Az eredmény a jobb oldali táblázatban.

Azok a népdalok, melyeknek üres a kadenciája: …|kadencia=|…. Amelyeknek nem üres: …|kadencia=!|….

A nem négysoros magyar népdalok (beleértve azokat is, ahol a sorok száma nincs megadva: …|dalsor=!4|műfaj=magyar népdal|…

Azok a nem négysoros magyar népdalok, ahol a sorok száma meg van adva: …|dalsor=!!4|műfaj=magyar népdal|…

Teendők

• Groupby-ba link az 1-darabos tételekre