arkivverket / arkade5

Arkade 5 - testverktøy for arkivuttrekk
http://arkade.arkivverket.no
GNU Affero General Public License v3.0
12 stars 17 forks source link

Arkade 5 v2.10.0 mangler i dokumentasjon #167

Open solfeggietto opened 1 year ago

solfeggietto commented 1 year ago

DIAS sine OAIS SIP og AIP lagrer metadata i METS elementer utenfor arkivpakkene (info.xml) og inne i arkivpakkene (dias-mets.xml). Dette er "pakkseddelen" til de bevarte pakker og det er derfor essensielt at de nevnte metadata da er av høy kvalitet og både korrekt tastet inn og bevart i pakkene.

Derfor er det på sin plass å påpeke at den nødvendige dokumentasjon på denne sammenhengen ikke er godt nok dokumentert i Arkade 5 dokumentasjonen fra Arkivverket

  1. Alle metadata som kan tastes inn i Arkade 5 GUI (eller importeres inn dit) eller settes opp som parametere i Arkde 5 CLI må dokumenteres en for en og knyttes opp til endelig plassering i METS-filene info.xml og dias-mets.xml
  2. Alle betingelser for når et element kommer med eller ikke blir med må entydig også dokumenteres
  3. F. eks. at TypeVersjon av System og Uttrekkssystem kun kommer med hvis Type er Noark5
  4. Og det ser ut som om det nye metadata Arkivsystemtype kun blir med hvis det nye metadata Overføringstype ikke er NULL (ikke valgt noe verdi for i Arkade 5 GUI)
  5. Der er også tvetydighet ved Overføringstype NULL, der info.xml ikke da har elementet, mens dias-metx.xml har elementet med tom streng verdi
  6. Må også nevne at DIAS spesifikasjonen er mangelfull i sluttrapporten med at nevnte info.xml og dias-metx.xml ikke er dokumentert, men bare finnes i upubliserte/uformelle Word-dokument beskrivelser.
  7. Og at dias-mets.xsd ikke er utfyllende mht. metadata-elementene som finnes i Arkade 5 SIP og AIP pakkegenerering
  8. IT-arkivar fagmiljøer finner fortløpende ut av sammenhenger her ved en prøve og feile metodikk, der man ved nye release versjoner av Arkade 5 da tester gjennom metadata på nytt og hvor de spores opp i DIAS pakkestrukturene
  9. REDIGERT/LAGT TIL: Nytt i Arkade v2.10.0 er at AIP pakke \description_metadata\ no har eac-cpf.xml og ead.xml med (med henholdsvis recordId og recordid som eneste elementer - ser uferdig ut i impelmentasjon?)
  10. REDIGERT/LAGT TIL: Det må også dokumenteres entydig fullt ut nøyaktig hvilke DIAS IP-elementer som produseres av henholdsvis pakketype SIP og AIP fra Arkade 5 pakking metadata!

REDIGERT/LAGT TIL:

Bakgrunn

Arkade 5 brukes som et pakkeverktøy for DIAS (norsk Digital Arkivpakkestruktur) der OAIS danner premissene for:

Informasjon og dokumentasjon forøvrig på innholdet i Arkade 5 er fint tilgjengelig vie Arkivverkets nettsider, dog uten den nødvendige presisjon på elementene som er tatt opp øverst er:

Videre er mye tatt opp via GitHub Issues, både i Open og Closed seksjoner

Swoy commented 1 year ago

Kort kommentar til punktet om NULL på Overføringstype. I METS er overføringstype Optional, men det betyr ikke at vi ikke kan gjøre den Required i våre systemer. Disse forskjellige valgene er for vår del viktig for å kunne gruppere flere SIP på riktig måte. Jeg er klar over at det i KDRS ikke er vanlig å akseptere flere SIP per system, men det vil være veldig lurt å adoptere denne måten å håndtere pakkene på. Blant annet for å kunne ha en dynamisk AIP man jobber med i OAIS eller annen implementasjon.

En DIP er ikke nødvendigvis en pakke, men kan like gjerne være en implementasjon man har ingestert en del av eller en hel AIP. Ta for eksempel for Asta7, vi vil opprette en SIP med innhold som gir instruksjoner til hvordan Asta skal migrere inn innholdet, dette er et SUPPLEMENT til NEW, og vil derfor kunne inkluderes i en AIP som senere kan brukes ved innlasting. Slike pakker kan eksistere for flere systemer, det er også enklere å håndtere flere SIP for et system, enn hva det er å håndtere en stor pakke.

erikaaberg commented 1 year ago

Her har vi litt å ta tak i. Alle punkter vil bli vurdert - og vi kommer tilbake med svar - og implementasjon i den grad det er påkrevet.