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ä.
Tietueen lähettäminen lomakkeella
Finnassa on versiosta 2.47.0 lähtien 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.
MARC-tietueet kannattaa lähettää MARCXML-muodossa vaihtomuodon sijaan, jotta formaatin erikoismerkit eivät aiheuta ongelmia.
- 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ä.
- Kun tietue on leikepöydällä, liitetään se Finnan lomakkeen Metadata-kenttään.
- Finna yrittää päätellä oikean formaatin, mutta sen voi myös valita valintalistasta.
- Lopuksi valitaan tietolähde.
- 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ä.
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):
Parametri | Kuvaus | Esimerkki |
---|---|---|
data | Yksittäinen XML-tietue | <lidoWrap>...</lidoWrap> |
format | Tietueen formaatti. Ks. vaihtoehdot yllämainitulta lomakkeelta. | lido |
source | Tietolähde, jonka tietoja käytetään tietueen muunnoksessa. Myös tämän vaihtoehdot löytyvät yllämainitulta lomakkeelta. | lusto |
Rajapinta tukee myös Voyagerin Send Record to -toimintoa.