Insamlingsverktyg - teknisk beskrivning av metadataformuläret

Transkript

1 Digitala leveranser Insamlingsverktyg - teknisk beskrivning av metadataformuläret Innehåll: Allmänt Layout och uppbyggnad Hur man använder programmet Starta Fylla i metadata Skapa metadatafiler och leverera paket Spara uppgifter som default Redigera en sparad metadatafil Konfigurationsfiler Metadataformuläret - allmänt Detta är ett fristående program skrivet i Java. Eftersom det är skrivet i Java så är det fullt möjligt att köra på alla moderna operativsystem (t ex Windows, Linux och Mac OS X), förutsatt att Java Runtime Enviroment (JRE) finns installerat i minst version Om detta krav inte skulle uppfyllas från början så finns JRE att ladda ner eller uppgradera gratis från Det huvudsakliga syftet med programmet är att man på ett enkelt sätt skall kunna ange bibliografisk metadata för ett visst objekt utifrån ett färdigt leveranspaket kan skapas som innehåller: 1. Själva objektet (för tillfället stödjer programmet bara objekt som består av en enda fil). 2. Bibliografisk metadata i form av en xml-fil. 3. Teknisk metadata i ytterligare en annan xml-fil. Läs mer om leveranspaketets uppbyggnad i Teknisk beskrivning av insamlingsverktyg (pdf). När ett leveranspaket har skapats så kan man med hjälp av programmet överföra detta paket till KB via FTP, förutsatt att man har ett konto hos KB och erhållit användarnamn och lösenord. Programmets layout är till stora delar konfigurerbar för att möta olika leverantörers olika behov Digitala leveranser - Metadataformuläret 1 av 6

2 Layout och uppbyggnad Själva formulärdelen av programmet är uppbyggt av ett flertal olika komponenter. Varje komponent är en liten tabell med information att fylla i och som sedan mappas direkt till ett specifikt metadataelement i MODS och enligt KB:s Specifikation för metadata vid digitala leveranser... (pdf). Informationen fylls antingen in i ett textfält, eller så väljer man ett värde från en rullgardinsmeny. Viss metadata är repeterbar och i de fallen kan man genom en enkel knapptryckning (på +-tecken) få tillgång till fler komponenter av samma slag att fylla i. Ett typiskt exempel är när två eller fler författare för ett och samma objekt ska redovisas. Vilka komponenter som skall gå att fylla i, och vilka som skall vara repeterbara, går enkelt att styra via konfigurationsfiler. En enklare lösning, ett grafiskt gränssnitt till programmet, är under arbete. En tabell över vilka komponenter som finns tillgängliga visas nedan. De existerande komponenterna motsvarar som tidigare nämnts de metadataelement som specificerats för MODS enlig KB. Om det i framtiden skulle uppstå behov av ytterligare bibliografisk metadata så är denna komponentmodell väl förbered för tillägget av nya komponenter Digitala leveranser - Metadataformuläret 2 av 6

3 Komponentens namn se.kb.diglev.form.mods.titleinfo se.kb.diglev.form.mods.identifier se.kb.diglev.form.mods.typeofresource se.kb.diglev.form.mods.name se.kb.diglev.form.mods.language se.kb.diglev.form.mods.physicaldescription se.kb.diglev.form.mods.origininfo se.kb.diglev.form.mods.accesscondition se.kb.diglev.form.mods.genre se.kb.diglev.form.mods.subject se.kb.diglev.form.mods.abstract se.kb.diglev.form.mods.relateditem se.kb.diglev.form.mods.hostrelateditem se.kb.diglev.form.mods.seriesrelateditem Metadataelement Titel Identifikator Typ av resurs Upphovsman, Medarbetare Språk Antal sidor Förlag, ort och år Rättigheter Publikationstyp Ämne Beskrivning Annan version Värdpublikation Serie Hur man använder programmet Starta programmet För att starta programmet så gör man något av följande: 1. Generiskt På alla plattformar som har en fungerande version av JRE så kan man starta programmet genom att, i en kommandoprompt, gå till katalogen DiglevTool och skriva "java -jar DiglevTool.jar". 2. Windows Dubbelklicka på den exekverbara filen DiglevTool.jar som finns i mappen DiglevTool. 3. Mac OS X Här kan man också öppna programmet genom att dubbelklicka på DiglevTool.jar. * OBS: Programmet kommer ej att kunna köras på äldre versioner av Mac OS, då Apple ej har uppdaterat sin JRE till dessa på flertalet år. 4. Linux Kör filen med namnet DiglevTool.sh. Detta kan göras antingen via kommandoprompten (./ DigelvTool.sh) eller via dubbelklickning i fönstersystemet. Programmet kan länkas till andra platser, dock bör inte själva filen DigelevTool.sh flyttas från sin mapp. Fylla i metadata När man väl har startat programmet så möts man endast av en stor tom yta. För att gå vidare så skall man nu välja den fil man vill ange bibliografisk metadata för (och Digitala leveranser - Metadataformuläret 3 av 6

4 eventuellt paketera och sända till KB). Detta görs antingen via knappen "Välj fil" eller via menyn "Arkiv->Välj fil". Observera att man ännu så länge bara kan välja objekt som är enstaka filer, till exempel ett pdf-dokument eller ett Word-dokument. När så ett objekt har valts så kommer själva metadataformuläret att bli synligt. Det är nu bara att fylla i sin bibliografiska metadata. Vissa värden som är repeterbara går att välja antalet inmatningskomponenter på med hjälp av "plus" och "minus"-knapparna som tillhör dessa. Man kan dock inte ta bort alla exemplar av en komponent, utan minst en komponent blir alltid kvar. Skapa metadatafiler och leverera paket Slutligen när allt som skall är ifyllt så har man nu två olika alternativ: 1. Skapa metadata i en xml-fil. Detta görs via menyalternativet "Arkiv->Spara XML" eller snabbknappen i verktygsraden. Detta kommer att skapa en fil med samma namn som objektet men med filändelsen ". xml". Filen kommer att ligga i samma mapp som objektet. 2. Skapa ett helt färdigt paket. Detta görs via menyalternativet "Arkiv->Skapa paket" eller via snabbknappen (med ett paket på) i verktygsraden. Resultatet av detta blir att en xml-fil skapas och paketeras ihop med en kopia av objektet samt ytterligare en xml-fil innehållande teknisk metadata. Alla dessa kommer att zippas ihop och resultera i en fil med ett kryptiskt namn som slutar med ".md5.zip". " 977f9503e863bdbdf70e8e0d30144dee.md5.zip". Den långa strängen med siffror och bokstäver i namnet är MD5-checksumman för det färdiga paketet och är till för att senare verifiera att paketet förts över korrekt. I och med detta så dyker även paketet upp i den lista med namnet "Färdiga paket" som finns under fliken "Pakethantering". På detta sätt kan man nu fortsätta tills man skapat metadata för alla de objekt man vill. Om man då enligt ovan har skapat ett antal paket så kan man nu gå in under fliken "Pakethantering" och markera de paket man har för avsikt att leverera till KB. Via menyalternativet "Arkiv->Skicka mha FTP" eller snabbknappen i verktygsraden kan man sedan skicka dessa till KB:s FTP-server. Själva överföringen kan, beroende på antalet objekt och deras storlek, ta ganska lång tid och statusen på överföringen kommer då att visas under tiden. Spara uppgifter som defaults Uppgifter som brukar finnas med i alla xml-poster (t.ex. utgivarens namn), kan sparas och behöver inte fyllas i varje gång. Man fyller i de delar av formuläret som upprepas, t ex förlagsinformation, och i menyn väljer "Arkiv->Spara som defults". Varje gång man hädanefter väljer ett nytt objekt så kommer de värden man angav tidigare att vara förifyllda. Om man senare vill återgå till att ha ett blankt formulär så rensar man bara alla fält och väljer "Spara som defaults" igen. Redigera en befintlig metadatafil Om man vill redigera i en MODS-fil så kan detta enkelt ske genom att man på nytt väljer objektet i fråga. Om programmet då hittar en fil med ändelsen ".xml" och samma namn som objektet i rätt katalog så kommer filens metadata att läsas in och visas i formuläret. Sedan är det bara att ändra eller lägga till och spara igen. Observera att detta inte kommer att slå igenom på xml-filer som redan har paketerats ihop med objektet. I dessa fall måste man skapa ett nytt paket och helst rensa bort det gamla Digitala leveranser - Metadataformuläret 4 av 6

5 Konfigurationsfiler För att styra vissa beteenden hos programmet, så att det bättre skall passa den enskilda användarens behov, finns det ett antal konfigurationsfiler att ändra på. Dessa finns alla i katalogen "conf" och är som följer: diglevtool.props Detta är huvudkonfigurationen för programmet. Här anges vilken fil som innehåller layouten, vilken fil som defaultvärdena skall sparas i samt namnen på eventuella flikar i formuläret. Dessutom så anger man här de nödvändiga inställningarna för ftpöverföringen. I original så ser denna fil ut som följer: Obligatoriska inställningar: layout.file=conf/layout.props defaults.file=conf/defaults.xml tabs.name=info,mer info Ftp-inställningar: ftp.host=ftp.host.se ftp.username=user ftp.password=passwd layout.props Här anger man vilka av komponenterna som skall vara synliga. Man anger även i vilken flik (ett nummer) dessa skall visas, samt om komponenten är repeterbar. Det är denna fil som "layout.file" under obligatoriska inställningar ovan skall peka på. se.kb.diglev.form.mods.titleinfo:repeatable,1 languages.props I denna fil anges vilka språk som skall gå att välja mellan, samt även en mappning till den tresiffriga språkkoden (enligt iso639-2b) som kommer att skrivas i xml-posten. Svenska:swe Engelska:eng Arabiska:arb marcrelators.props Här anger man vilka olika roller som en upphovsman kan ha samt vilken tresiffrig kod detta har i MARC-formatet. Författare:aut Fotograf:pht Kompositör:cmp resourcetypes.props Här konfiguerar man vilka olika typer en viss resurs kan tänkas vara. Man anger först namnet som det skall dyka upp i rullgardinsmenyn och sedan vad den skall mappas till i Digitala leveranser - Metadataformuläret 5 av 6

6 xml-posten. Text:text Karta:cartographic Musiknoter:notated music Ljudinspelning:sound recording Stillbild:still image Film:moving image mediatypes.props Här anger man vilka mediatyper som ett relaterat objekt kan ha. text/html application/pdf application/ms-word text/xml Av alla filerna ovan så är det bara diglevtool.props och layout.props som måste finnas, övriga har defaultvärden angivna och går att klara sig utan. Oskar Grenholm Senast uppdaterad: Kungl. biblioteket / IDA - Avdelning för insamling och dokumentation Digitala leveranser - Metadataformuläret 6 av 6