# Andmete import ja eksport

&appname; suudab importida ja eksportida väga mitmesuguseid andmefaile, samuti otsida teavet paljudelt internetisaitidelt.

## Import internetist

&appname; võib otsida mitmesugustelt internetisaitidelt teavet internetiotsingu dialoogi vahendusel. Kirjeid võib otse importida ja lisada oma aktiivsesse kogusse. Eri teabepakkujaid saab seadistada andmeallikate valikutega.

Otsingutes saab kasutada eri kriteeriume: Pealkiri, Isik, ISBN, UPC/EAN, LCCN või Võtmesõna. Kõigi andmeallikate puhul ei saa kõiki kriteeriume kasutada. ISBN ja LCCN väärtused on mõeldud ainult raamatutele, UPC või EAN väärtused aga suvalistele esemetele.

Otsingu käivitamisel asendub nupp Otsi nupuga Peata, millele vajutamisel otsing lõpetatakse. Tulemuste leidmisel lisatakse need nimekirja otse otsingukasti all, kus kirje valimisel näeb tulemust, ilma et seda veel lisataks kogusse. Klõps nupule Lisa kirje lisab kõik valitud elemendid kogusse. Kui andmeallikal on rohkem tulemusi, kui esialgu sooviti, muutub aktiivseks nupp Rohkem tulemusi. Nupuga Puhasta saab eemaldada kõik aktiivsed tulemused ja otsingu lähtestada.

&appname; internetiotsingu dialoog
&appname; internetiotsingu dialoog

Ositakse ainult kirjeid, mis sobivad aktiivse kogu tüübiga. Veerg Kirjeldus annab kirje kohta lisateavet, et teha vahet näiteks eri formaadis videodel või eri köites raamatutel. Kui kirje on edukalt kogusse lisatud, lisatakse nimekirja esimesse veergu linnuke.

Korraga saab lisada ka mitu kirjet, kasutades &kde; tavapärast viisi mitme elemendi valimiseks, milleks tavaliselt on kirjetele klõpsamise ajal klahvi &Shift; või &Ctrl; allhoidmine.

Ribakoodilugejate kasutamise lihtsustamiseks võib otsing hõlmata mitut ISBN/UPC väärtust. Ruudukese Mitme ISBN/UPC otsing märkimisel muutub otsisõnakast mitteaktiivseks ning aktiivseks muutub nupp Muuda ISBN/UPC väärtusi, millega saab avada mitmerealist sisestust võimaldava tekstikasti. IGA ISBN peab olema eraldi real. Kasti sulgemise järel kontrollitakse iga ISBN-i vorminduse korrektsust. ISBN-i kontrollimisel saab nii 13-arvulised EAN väärtused kui ka täielikud UPC koodid teisendada vajalikku vormingusse. ISBN-ide nimekirja võib sisse lugeda ka tekstifailist.

## Andmete import

&appname; pakub andmete importimisel kolme toimimisviisi. Aktiivse kogu asendamine sulgeb aktiivse kogu ja loob uue imporditud failist pärit andmetega. Aktiivsele kogule lisamine sunnib &appname; lisama imporditava kogu kõik kirjed aktiivsesse kogusse ning lisama ka kõik väljad, mida seni ei eksisteerinud. Aktiivse koguga liitmine on sarnane lisamisele, ainult et kõiki imporditavaid kirjeid võrreldakse senistega ning kõik identsed kirjed jäetakse vahele. Edaspidi on kavas parandada samaste kirjete tuvastamist, aga praegu peavad need olema identsed kõigi väljade poolest, välja arvatud muusikakogude puhul, mille korral võrreldakse ainult esitajat ja albumit ning kattuvate kirjete puhul palad liidetakse. Helifailide importija suudab kirjeid liites luua korrektsed palade nimekirjad.

### &appname; andmete import

Importida saab ka teisi &appname; andmefaile. Aktiivse kogu asendamine &appname; faili importides on samaväärne faili avamisega. &appname; andmete importimine on eelkõige mõttekas andmete lisamiseks või kahe kogu ühendamiseks.

### CSV-andmete import

Komadega eraldatud väärtuste (CSV) kasutamine on levinud viis tabelisse korraldatud andmete importimiseks ja eksportimiseks. Iga välja väärtus on eraldatud komaga, üks kirje rea kohta. Väljade nimed võivad olla esimesel real. CSV importija ei ole aga piiratud komaga: eraldajaks võib kasutada mis tahes tähte või stringi.

CSV importimise dialoog
CSV importimise dialoog

Kõigepealt vali imporditava kogu tüüp. Kui tegemist on aktiivsele kogule lisamise või sellega liitmisega, siis on tüübiks juba ette valitud aktiivse kogu tüüp. Kui CSV-faili esimene rida sisaldab väljade pealkirju, märgista vastav ruuduke ning importija võrdleb automaatselt pealkirju aktiivse kogu väljadega. Kui välja pealkiri kattub, muutub selle veeru päis näitamaks, et veerg on omistatud sellele väljale. Kui fail kasutab mõnda muud eraldajat kui koma, märgi kindlasti ka vastav valik.

Et &appname; saaks faili korrektselt importida, peab ta teadma, milline väli vastab millisele veerule. Kui veeru päises on ainult number, selle veeru andmeid ei impordita. Sa peaksid omistama väljad igale veerule, valides veeru kas sellele klõpsates või muutes veeru numbrit ennast ning siis valides omistatava välja rippmenüüst ja klõpsates nupule Omista väli. Kui on vaja lisada kogusse uus väli, avab rippmenüü viimane käsk kogu väljade dialoogi.

Dialoogis näidatakse ainult imporditava CSV-faili esimest viit rida.

### Heli-&CD; andmete import

&appname; võib kasutada freedb.org-i teenust teabe hankimiseks &CD; kohta, kaasa arvatud selle radade nimekiri. Sõltuvalt distributsioonist võib olla vajalik määrata teenuse kasutamise seadistusi &kde; Süsteemi seadistustes. Lisatakse nii &CD; esitaja, pealkiri, žanr, aasta kui ka radade nimekiri.

Kui plaat peaks sisaldama &CD;-teksti, loetakse sisse ka see teave ning lisatakse imporditavale kirjele.

### Helifaili metaandmete import

&appname; võib läbi uurida kataloogi ning lugeda sealt välja levinumate helifailivormingute, näiteks `mp3`- ja `ogg`-failide sildid. Laulud sisestatakse muusikalogusse, kus iga kirje on album. Kui laulufailid sisaldavad raja numbrit, lisatakse laulu nimi radade nimekirjas õigesse kohta. Kirjele lisatakse ka teave esitaja ja žanri kohta. Kui laulu sildid sisaldavad kommentaare, lisatakse need kirje kommentaariväljale, mille ees seisab failinimi.

Kui kataloog peaks sisaldama faili `.directory` ja kataloogi nimi kattub albumi pealkirjaga, kasutatakse desktop-faili kirjet `Icon` albumi kaanepildina.

Helifaili metaandmete importija võib rekursiivselt läbi uurida kataloogi, et leida kõik helifailid kõigis alamkataloogides, ehkki nimeviitasid sel puhul ei järgita. &appname; kasutab helifaili metaandmete lugemiseks TagLibi teeki, mistõttu ta võib importida kõigi failitüüpide andmeid, mida TagLib vähegi tunnustab.

### Alexandria raamatukogude import

Alexandria on alternatiivne raamatute kogude haldur GNOME töökeskkonnale. Importija pakub võimalust importida kõik raamatukogud, mis leiduvad kataloogis `$`HOME`/.alexandria/`.

### Anti filmikataloogi andmete import

Anti filmikataloog on alternatiivne filmikogude haldur.

### Bibtexi andmete import

Bibtex on bibliograafiavorming, mida kasutab LaTeXi dokumentide ettevalmistamise süsteem. Failis võivad sisalduda eri tüüpi bibliograafilised viited. &appname; impordib bibtex-failid bibliograafiakoguna.

Kui bibtexi importija kohtab failis välju, mida ei leidu vaikimisi bibliograafiakogus, lisatakse need väljatüübina Tavaline tekst, välja arvatud kaks erandit. Kui välja väärtus sisaldab üle 100 märgi, lisatakse see väljatüübina Lõik. Kui välja väärtus paistab sisaldavat &URL;-i või failiviidet, lisatakse see väljatüübina &URL;. &appname; kasutab bibtex-failide parsimiseks sisemist btparse teegi koopiat.

### Bibtexml-andmete import

Bibtexml on bibtex-andmed &XML;-i kujul ning bibtexml-failist imporditavaid andmeid koheldakse samamoodi nagu bibtex-andmeid.

### Deliciouse raamatukogu andmete import

Delicious Library on alternatiivne kogude haldur &Mac; OS X töökeskkonnas. &appname; impordib osa Delicious Library kasutatavaid andmeid.

### GCstari andmete import

GCstar on alternatiivne kogude haldur. Praegu on toetatud raamatute, filmi-, muusika-, mündi-, mängude, lauamängude ja veinikogude importimine.

&appname; võib importida ka GCfilmsi andmefaile. GCfilms on GCstari eelkäija ja kujutas endast alternatiivset filmikogude haldurit. Tavaliselt leiab GCfilmsi andmefailid kataloogist `$`HOME`/.local/share/gcfilms/`.

### Griffithi andmete import

Griffith on alternatiivne videokogude haldur. &appname; suudab importida enamiku Griffithi andmebaasi andmeid.

### MODS-i andmete import

MODS on mitut tüüpi meediakogusid esindav vorming. Praegu impordib &appname; ainult raamatuid bibliograafiakogu kujul.

### PDF-i andmete import

Kui &appname; on kompileeritud exempi või poppleri toetusega, saab importida metaandmeid PDF-failidest. Metaandmed võivad sisaldada pealkirja, autorit ja kuupäeva, samuti bibliograafiaidentifikaatoreid, mida seejärel kasutatakse muu teabe uuendamiseks.

### Referenceri andmete import

Referencer on GNOME töökeskkonna dokumentide korraldaja ja bibliograafiahaldur. &appname; suudab importida enamiku Referenceri andmebaasi andmetest.

### RIS-i andmete import

RIS-i vorming bibliograafiafaili vorming, mida kasutavad Reference Manager ja veel mitmed rakendused. &appname; impordib RIS-failid bibliograafiakoguna.

### Goodreadsi kogu import

Goodreads on lugejate sotsiaalvõrgustik raamatute kogude jälgimiseks. &appname; suudab importida kasutaja kogu raamatute nimekirja kas kasutaja nime või ID järgi, kui kogu on avalikult kättesaadav.

### Failinimekirjade import

Parim viis failikataloogi loomiseks on kataloogi sisu importimine. Kataloogi võib rekursiivselt läbi uurida, et lisatakse kõik selles leitavad failid. See importija on eelkõige kasulik tagavarakoopiate ning andmekandjate, näiteks &CD;-de või DVD-de sisu kataloogimiseks. Lisaks võib genereerida failisisu eelvaatlused, kuigi suurema hulga failide korral võtab nende lugemine omajagu aega. Failide eelvaatlused on samasugused nagu &kde; failihalduris.

### &XML;-andmete import XSLT vahendusel

Mis tahes &XML;-faili saab importida &appname;sse, kui &XSL;-laaditabel on vähegi suuteline teisendama faili &appname; vormingusse. &appname; laadib laaditabeli automaatselt ning sooritab faili laadimiseks vajaliku &xslt; töötluse.

## Lohistamine

Andmefailide lohistamisega &appname; peaaknasse saab neid samamoodi importida nagu menüü importimiskäskudega. Lohistamine toimib järgmiste failivormingute puhul: Tellico, Bibtex, RIS ja PDF. Toetatud on ka mitme faili importimine korraga.

Kui näiteks soovid kataloogida mitu PDF-faili, vali need failihalduris ja lohista &appname; aknasse. &appname; impordib failidest nii palju metaandmeid kui võimalik ning hangib seejärel lisateavet erinevatest seadistatud internetiallikatest.

## Andmete eksport

Kogu andmete eksportimisel võidakse kirjete väärtused eksportida sellisena, nagu need on sisestatud, või kasutades &appname; pakutavat automaatset vormindamist. Lisaks võib eksporti piirata ka kogus parajasti valitud kirjetega, mille puhul valitud kirjete arvu võib näha olekuribal.

Tekstifailide, näiteks Bibtex- või CSV-failide eksportimisel võib kasutada nii Unicode'i (UTF-8) kodeeringut kui ka operatsioonisüsteemi aktiivset lokaati.

Üldised eksportimisvalikud
Üldised eksportimisvalikud

### Eksport &XML;-ina

&appname; andmete failivorming on zip-pakendusega on &XML;-fail. Eksport &XML;-ina tähendab lihtsalt &XML;-faili loomist ilma seda zip-pakendamata. Pildid saab &XML;-faili kaasata base64 kodeeringus andmetena elemendis image, kuid sel moel tekivad väga suured tekstifailid.

### Eksport Zipina

&appname; standardne failivorming on zip-pakendusega fail, mis sisaldab &XML;-kogufaili ja lisavõimalusega kõiki pilte, millele kogus viidatakse. Kui pildid on salvestatud rakenduse kataloogi, luuakse eksportimisel Zipina autonoomne andmefail, mis sisaldab kõiki kogus leiduvaid pilte.

### Eksport &HTML;-ina

Eksportimisel &HTML;-ina kasutatakse laaditabelit `tellico2html.xsl`. Pildid eksporditakse kataloogi sama nimega nagu eksporditav &HTML;-fail, lisades `_files`.

Vaikevorming on sarnane trükkimisväljundile ning võimaldab mitmesuguseid &HTML;-i modifitseerivaid valikuid. Väljade päiseid saab lasta näidata iga veeru kohal, kuid paraku ei võimalda &kde; veel korrata tabeli päiseid igal leheküljel. Kirjeid saab rühmitada samamoodi nagu rühmavaates.

Lisaks võib igale kogu kirjele luua eraldi faili, mille lingid sisalduvad tipptaseme &HTML;-failis. Kirjefailid luuakse piltidega samasse kataloogi. Kirjete &HTML;-failid kasutavad aktiivset laaditabeli malli, nagu seda näeb kirjevaates.

&HTML;-ina eksportimise valikud
&HTML;-ina eksportimise valikud

### Eksport CSV-na

Komadega eraldatud väärtused (CSV) on tavapärane tabelisse korraldatud andmete importimis- ja eksportimisviis. Kõigi väljade väärtused on eraldatud komaga, igal real on üks kirje. Väljade pealkirjad võivad olla esitatud päistena esimesel real. Väljade eraldamiseks võib kasutada ka mis tahes muid märke või stringe peale komade.

CSV-na eksportimise valikud
CSV-na eksportimise valikud

### Eksport Pilot-DB-na

Pilot-DB on &PalmOS; andmebaasivorming. Pilot-DB-faile suudavad lugeda ja kirjutada mitmed töölauarakendused. Eksporditud `.pdb`-faile võib üle kanda pihuarvutisse ja seal vahetult kasutada. Praegu ei ole &appname; veel suuteline Pilot-DB-faile importima.

Pilot-DB-na eksportimise valikud
Pilot-DB-na eksportimise valikud

### Eksport Alexandriana

Alexandria on raamatute kogude haldur GNOME töökeskkonnas. &appname; on suuteline eksportima piiratud hulgal raamatute kogu välju Alexandria vaikimisi andmete asukohta.

### Eksport ONIX-ina

ONIX on &XML;-vorming raamatutööstuse tooteteabe väljendamiseks ja vahetamiseks, mis on peamiselt välja töötatud raamatukaupmeeste huvides. &appname; võib eksportida raamatute kogusid, kasutades vähesel hulgal ONIX-i võimalusi.

### Eksport Bibtexina

Eksportimisel Bibtexina võib väljade väärtusi varjestada sulgude või jutumärkidega. Kui kogus on kasutatud stringimakrosid, võib neid eksportida nii makrodena kui ka laiendatult. &URL;-väljade korral võib &appname; sulustada väljade väärtused sildiga `\url{...}`. Kirjed, millel puudub viitevõti, võib lasta vahele jätta, kuid võib lasta ka &appname;l neile automaatselt võtme genereerida.

Bibtexina eksportimise valikud
Bibtexina eksportimise valikud

### Eksport Bibtexmlina

Bibtexml on vorming bibtex-andmete esitamiseks &XML;-ina.

### GCstari eksport

GCstar on veel üks filmikogude haldur. &appname; suudab eksportida piiratud hulgal videokogu välju GCstari andmefaili.

### Eksport &XML;-ina &xslt; vahendusel

Lõpuks võib &appname; töödelda oma kogu andmete sisemist esitust &XML;ina välise &XSL;-laaditabeli abil, enne kui see eksportida. Seda laadi eksportimine võib olla kasulik tekstiaruannete või muud tüüpi failide genereerimiseks.

## Viidete kasutamine

Bibliograafia puhul võib genereerida parajasti valitud kirjete viited ning neid kasutada mitmes muus rakenduses. Bibtexi vormingus viite võib kopeerida lõikepuhvrisse ja asetada sealt LaTeXi faili. Bibtexi viiteid võib läkitada ka sellistesse välistesse rakendustesse, nagu LyX või Kile, kasutades selleks niinimetatud lyxpipe'i.