Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

Tällä sivulla kuvataan melko teknisellä tasolla se, miten Finnassa näytettävä tietueiden sisältö valitaan. Allaolevan esimerkin avulla toiminta toivon mukaan hahmottuu helpommin, mutta kokonaisuuden hahmottaminen on haastavaa. VuFind VuFindin wikissä on kehittäjille suunnattua yleistä tietoa siitä, miten tietueita käsitellään VuFindissa, johon Finnakin pohjautuu. Lisäksi siellä on lista yleisistä record drivereissa käytetyistä metodeista ja niiden palauttamasta sisällöstä.

...


Finnassa tavoitteena on loppukäyttäjän kannalta mahdollisimman suuri yhtenäisyys, eli käyttäjälle pyritään tarjoamaan tietueista mahdollisimman yhtenäinen samantyyppinen näyttö riippumatta tietosisällöstä. Tietueen muodosta (MARC, LIDO, EAD jne.) riippuen näytetään kuitenkin vähän erilaisia tietoja, ja myös tietuesivun ulkoasu vaihtelee jonkin verran. Kattavaa taulukkoa siitä, mitä tietueista näytetään käyttäjälle, esim. MARC-kentät, joita näytetään, on vaikea koota taulukkoon, koska formaatteja . Formaatteja on useita, järjestelmää kehitetään jatkuvasti, ja usein säännöt sille, mitä näytetään, näytettävälle sisällölle ovat monimutkaisia. Tälle sivulle on koottu yleistä tietoa, jonka perusteella voi tarvittaessa selvittää tarkemmin, mitä metadatasta tulee Finnan listoihin tai tietuenäyttöön.

...

Jokaisella formaatilla voi olla omat versiot yllämainituista tiedostoista, mutta ne voivat käyttää myös oletuspohjia ("Default"). Sivupohjien sisältöä voi tutkia osoitteessa https://github.com/NatLibFi/NDL-VuFind2/tree/master/themes/finna/templates/RecordDriver. Esimerkiksi MARC-tietueiden koko tietue -näyttöä ohjaa https://github.com/NatLibFi/NDL-VuFind2/blob/master/themes/finnafinna2/templates/RecordDriver/SolrDefaultDefaultRecord/core.phtml. Monimutkaisuutta tähän lisää se, että nämä pääsivupohjat käyttävät sisällön luomiseen vielä apupohjia ja ns. helpereitä, joten yksittäisen sivun muodostuminen on monipolvinen prosessi. Taulukkomuotoinen sisältö muodostetaan RecordDataFormatterin sääntöjen perusteella.

Sivupohjat käyttävät vielä erillistä formaattikohtaista ajuria ("Record Driver"), joka vastaa jotka vastaavat halutun tiedon hakemisesta kunkin formaatin sisältämästä metadatasta. Nämä ajurit on tehty PHP-kielellä, ja niitä voi tarkastella osoitteessa https://github.com/NatLibFi/NDL-VuFind2/tree/master/module/Finna/src/Finna/RecordDriver. Useimmat ajurit polveutuvat VuFindin alkuperäisistä ajureista, joista suuri osa toiminnallisuudesta löytyy. Niitä toi tutkailla osoitteessa https://github.com/NatLibFi/NDL-VuFind2/tree/master/module/VuFind/src/VuFind/RecordDriver.

...

Jos esim. selvitetään, mitä MARC-kenttiä käytetään Aiheet-kentän näyttämiseen, lähdetään tarkastelemaan tiedostosta https://github.com/NatLibFi/NDL-VuFind2/blob/master/themes/finna/templates/RecordDriver/SolrDefault/core.phtml RecordDataFormatterin sääntöjä. Sieltä voidaan selvittää, että aiheiden näyttämiseen käytetään record driverin toimintoa getAllSubjectHeadings. Sellainen löytyy record driverista https://github.com/NatLibFi/NDL-VuFind2/blob/master/module/Finna/src/Finna/RecordDriver/SolrMarc.php. Sieltä nähdään, että aiheet tulevat kentistä '600', '610', '611', '630', '648', '650', '651', '653' ja '656', ja näytettäväksi hyväksytään kaikki osakentät numeerisia lukuunottamatta.