Sisällysluettelo

Johdanto

Finnaan voi lähettää yksittäisiä tietueita esikatseltavaksi ennen niiden haravointia Finnan indeksiin. Toimintoa käyttämällä on siis mahdollista tarkistaa, miltä tietue näyttäisi Finnassa. Esikatselu näyttää vain lähetetyn sisällön, eikä siihen tule esim. kirjastoaineiston saatavuustietoja. Esikatselussa voi käyttää kaikkia Finnassa tuettuja tietuemuotoja. Esikatselulla lähetettyä tietuetta ei tallenneta Finnaan, eikä se siis vaikuta indeksoituihin tietoihin, esim. tietueen aiempaan versioon Finnan indeksissä.

Esikatselua käytettäessä kannattaa huomioida se, että joissain järjestelmissä haravoitaville tietueille voidaan tehdä muutoksia lähtöpäässä ennen kuin ne tulevat Finnaan (esim. Almassa erilaiset rikastukset ym.), ja nämä jäävät esikatselussa tekemättä. Lopputulos ei siis välttämättä ihan vastaa sitä, millaisena tietue lopulta Finnaan päätyy.

Tietueen lähettäminen lomakkeella

Finnassa on lomake, jolla voi lähettää yksittäisen tietueen esikatseltavaksi. Lomake löytyy jokaisesta näkymästä osoitteesta /RecordPreview, eli esim. https://www.finna.fi/RecordPreview.

1. Lähtökohtana on, että tietue saadaan leikepöydälle jossain Finnan tukemassa formaatissa. Järjestelmän ylläpitäjältä voi tarkistaa, miten tämä tapahtuu tai onko ylipäänsä mahdollista ko. järjestelmässä.
2. Kun tietue on leikepöydällä, liitetään se Finnan lomakkeen Metadata-kenttään.
3. Finna yrittää päätellä oikean formaatin, mutta sen voi myös valita valintalistasta.
4. Lopuksi valitaan tietolähde.
5. Lähetä-painikkeella avataan tulos uudelle välilehdelle tai ikkunaan.

Lomake ei sisällä virheentarkistusta, mutta tulossivulla pyritään ilmoittamaan mahdollisuuksien mukaan, mikäli tietuetta ei saatu käsiteltyä.

XML-muotoisen tietueen oikeellisuuden voi tarkistaa esim. w3schools:n XML-validaattorilla.

Lomake tukee myös Alman Record View -näytöltä MARC-välilehdeltä kopioitua sisältöä. Lomakkeen sisällön pitäisi silloin näyttää tällaiselta:

Tietueen lähettäminen ohjelmallisesti

Lomakkeen käyttämää rajapintaa voidaan käyttää myös suoraan taustajärjestelmistä. Tällöin näkymän /Record/0/Preview -osoitteeseen (esim. https://www.finna.fi/Record/0/Preview) lähetetään POST-pyynnöllä seuraavat parametrit (application/x-www-form-urlencoded -muodossa):

Tietueen lähettäminen Alma-järjestelmästä

Tietueen voi lähettää Alman Record View -näytöltä MARC-välilehdeltä tai suoraan MDE:stä käyttämällä tarkoitukseen tehtyä bookmarkletia. Bookmarkletin käyttäminen on helpointi, kun sen lisää selaimen kirjanmerkkipalkkiin. Esimerkkikuva Chromesta, bookmarklet korostettu punaisella kehyksellä:

Esimerkkitietueita

<lidoWrap xmlns="http://www.lido-schema.org">
    <lido>
        <lidoRecID type="ITEM">12345</lidoRecID>
        <descriptiveMetadata xml:lang="fi">
            <objectIdentificationWrap>
                <titleWrap>
                    <titleSet type="nimi">
                        <appellationValue xml:lang="fi">Esimerkkiteos</appellationValue>
                    </titleSet>
                </titleWrap>
            </objectIdentificationWrap>
        </descriptiveMetadata>
    </lido>
</lidoWrap>

<lido:lidoWrap xmlns:lido="http://www.lido-schema.org">
    <lido:lido>
        <lido:lidoRecID lido:type="ITEM">12345</lido:lidoRecID>
        <lido:descriptiveMetadata xml:lang="fi">
            <lido:objectIdentificationWrap>
                <lido:titleWrap>
                    <lido:titleSet lido:type="nimi">
                        <lido:appellationValue xml:lang="fi">Esimerkkiteos</lido:appellationValue>
                    </lido:titleSet>
                </lido:titleWrap>
            </lido:objectIdentificationWrap>
        </lido:descriptiveMetadata>
    </lido:lido>
</lido:lidoWrap>