Eventer/bevaringsmetadata

⚠️ Denne siden er under arbeid ⚠️

Eventer i Submission API

I digital bevaring dokumenterer en “event” en handling eller hendelse som har påvirket et digitalt objekt, for eksempel opprettelse, migrering, validering eller overføring. Dette anses som viktig bevaringsmetadata og gir sporbarhet og bevis for hva som er gjort med objektet gjennom hele livssyklusen.

Nasjonalbiblioteket har tatt utgangspunkt i Library of Congress sin liste over EventTypes. Lista har blitt innskrenket, og bruken av de ulike typene er spesifisert til å passe våre behov og bevaringsomgivelser. Andre typer enn det som er spesifisert i lista nedenfor blir ikke godkjent i API.

Avlevering av eventer er ikke et krav, men vi anbefaler at det opprettes hvis man har slik informasjon tilgjengelig. Eventer som legges til i APIet vil bevares i egen event-database. Hvis det er ønskelig å legge til andre typer bevaringsmetadata, er det er også mulig å avlevere bevaringsmetadata i informasjonspakken (SIP). Se mer om det under metadataveiledning og krav til pakkestruktur. Informasjon som går direkte på proveniens kan legges til i krav til metadata.

Eventer kan være knyttet til hele informasjonspakken eller til enkelte filer. Generelt bør eventer knyttes til pakkenivå, Intellektuell entitet (IE), der det er mulig. Dette for å unngå store mengder eventer som i utgangspunktet sier det samme. Det er åpent for å legge eventer på filer der det er behov for å dokumentere hendelser på enkeltfiler. Det viktigste er at man har et bevisst forhold til hva som dokumenteres, hvorfor det dokumenteres, og på hvilket nivå.

Teknisk dokumentasjon for avlevering i API finnes her: Swagger DPS Submission Service API

EventTypes

Capture

Retningslinjer for bruk:

• Brukes når det høstes nettsteder ved hjelp av crawling.

Eksempler:

Compression

Retningslinjer for bruk:

• Eventen bør knyttes til IE når det er mulig. For eksempel dersom filene komprimeres på samme måte.
• Brukes til å dokumentere komprimering og/eller koding som del av lagringsoptimalisering.
• Skal ikke brukes som del av formatmigrering til et komprimert format. Se også eventType “migration”.
• I en PREMIS-kontekst skal informasjon om hvorvidt komprimeringen er tapsfri eller tapsbasert angis i eventDetailInformation eller eventOutcomeInformation.

Eksempler:

Creation

Retningslinjer for bruk:

• Brukes for å dokumentere det digitale objektet i en informasjonspakke.
• Brukes til å dokumentere opprinnelsen til filen eller den Intellektuelle Entiteten (IE), og beskriver metoden og prosessen for å opprette filen/IE. Se også eventType “imaging”.

Eksempler:

Filename change

Retningslinjer for bruk:

• Relevant ved endring av navn på en født digital fil, eller når for eksempel en fil må gis nytt navn for å oppfylle kravene til lagringssystemet.
• Enten fjerning av forbudte tegn eller delvis/hel erstatning av det opprinnelige filnavnet. Dette kan brukes for å dokumentere endringer som fjerning av tegn, eller der et system fjerner filnavnet helt og erstatter det med et systemgenerert navn.

Eksempler:

Fixity check

Retningslinjer for bruk:

• Eventen bør knyttes til IE når det er mulig. Knyttes kun til fil dersom det er behov for å dokumentere avvik.
• Vil mest sannsynlig inneholde resultatene fra eventen «message digest calculation».
• Spesielt viktig når sjekksummer mottas fra eksterne.

Eksempler:

Imaging

Retningslinjer for bruk:

• Brukes for å dokumentere prosessen med å lage en eksakt digital kopi (diskbilde) av et lagringsmedium, inkludert alle filer, metadata, filsystemstruktur og noen ganger også ledig plass og slettede data.
• Der det er relevant, skal denne eventen brukes i stedet for, ikke i tillegg til, «creation»-eventen.

Eksempler:

Message digest calculation

Retningslinjer for bruk:

• Eventen bør knyttes til IE når det er mulig. Knyttes kun til fil dersom det er behov for å dokumentere avvik.
• Eventen «fixity check» kontrollerer Sjekksummen.
• Brukes ved opprettelse av nye sjekksummer. Hvis sjekksummer opprettes lokalt, er det ikke behov for å bruke eventen “fixity check” i tillegg til event “message digest calculation”. Se også EventType “fixity check”.

Eksempler:

Metadata extraction

Retningslinjer for bruk:

• Brukes når metadata hentes ut av en fil og resulterer i en eller flere metadatafiler.
• Filen(e) som utledes må referere til opprinnelsesfila.

Eksempler:

Migration

Retningslinjer for bruk:

• Eventen bør knyttes til IE når det er mulig, for eksempel dersom filene er konvertert på samme måte til samme format.
• Brukes ved endring av filformat, ikke til å dokumentere komprimering som del av lagringsoptimalisering. Se også eventType «compression».
• Migration-events skal alltid resultere i en ny pakke eller fil.
• Filen(e) som migreres må referere til opprinnelsesfila.

Eksempler:

Transfer

Retningslinjer for bruk:

• Brukes ved overføring av objekter inn eller ut av bevaringsområdet eller midlertidige arbeidsområder. Dette inkluderer for eksempel flytting mellom bit-lagre, fra bit-lager til arbeidsområde for bearbeiding, eller fra arbeidsområde til bit-lager.

Eksempler:

Validation

Retningslinjer for bruk:

• Objektet som valideres kan være en fil eller en Intellektuell enhet. Eventen bør knyttes til IE når det er mulig. For eksempel hvis filene er validert på samme måte med samme verktøy, eller strukturen er validert for hele pakken.
• Det kan være hensiktsmessig å lage én event for hele valideringen der man heller beskriver hvilke verktøy som er brukt i de ulike stegene, i stedet for å lage flere eventer for flere valideringer.

Eksempler:

Virus check

Retningslinjer for bruk:

• Eventen bør knyttes til IE når det er mulig. Knyttes kun til fil dersom det er behov for å dokumentere avvik.

Eksempler: