Eksplisitt deklarasjon av mapper

[joergen-vs]

Med mediekonverterte arkiver kom det et behov for å kunne angi hvilken mappe inneholdt dokumentene. Og med skjema for arkivbeskrivelse har det nesten alltid kommet inn en egen mappe for systemdokumentasjon.

I den forbindelse ble det lagt til ny bruk av addml [sommeren 2021] for å si hvilken mappe inneholdt hva. Nå identifiserer man mappe og antall filer i den, med følgende;

<dataObject name="dokumenter">
  <properties>
    <property name="folder">
      <properties>
        <property name="name">
          <value>Filer</value><!-- navn på dokument-mappe -->
        </property>
      </properties>
    </property>
    <property name="info">
      <properties>
        <property name="numberOfOccurrences">
          <value>dokumenter</value>
          <properties>
            <property name="filePath">
              <value>*.*</value>
            </property>
            <property dataType="integer"
              name="value">
              <value>2630</value><!-- antall filer i dokument-mappe -->
            </property>
          </properties>
        </property>
      </properties>
    </property>
  </properties>
</dataObject>
<dataObject name="dokumentasjon">
  <properties>
    <property name="folder">
      <properties>
        <property name="name">
          <value>SYSDOK</value><!-- navn på mappe med systemdokumentasjon -->
        </property>
      </properties>
    </property>
    <property name="info">
      <properties>
        <property name="numberOfOccurrences">
          <value>dokumenter</value>
          <properties>
            <property name="filePath">
              <value>*.*</value>
            </property>
            <property dataType="integer"
              name="value">
              <value>2</value>
            </property>
          </properties>
        </property>
      </properties>
    </property>
  </properties>
</dataObject>

Det samme gjelder for andre fagsystem / register-data med dokumenter.

Slik som f.eks. arkivstruktur er deklarert med et navn på overordnet dataObject, er disse objektene deklarert med henholdsvis "dokumenter" og "dokumentasjon" for å navngi inneholdet.

Spørsmål: Ville dette være aktuelt å ta inn i et vedlikehold av standarden?

[petterreinholdtsen]

[Jørgen]

Med mediekonverterte arkiver kom det et behov for å kunne angi hvilken mappe inneholdt dokumentene. Og med skjema for arkivbeskrivelse har det nesten alltid kommet inn en egen mappe for systemdokumentasjon.

Snakker du her om mapper på disken, eller Noark 5-mapper? Hvis jeg forstår spørsmålet riktig, så er ønsket å markere i XML-fil i uttrekket hvilke filer som hører til arkivmapper, og hvilke som hører til dokumentasjon om arkivsystemet, når begge er del av et arkivuttrekk. Stemmer dette?

I den forbindelse ble det lagt til ny bruk av addml [sommeren 2021] for å si hvilken mappe inneholdt hva. Nå identifiserer man mappe og antall filer i den, med følgende;

Har du URL til hvor det ble lagt til, og detaljer om hva som ble endret?

Spørsmål: **Ville dette være aktuelt å ta inn i et vedlikehold av standarden?**

Hvis det trengs for å bringe Noark 5 på linje med relaterte beskrivelser, så tenker jeg at det bør gjøres. Hva konkret tenker du bør endres i Noark 5-spesifikasjonsteksten? Det er litt uklart fra forslaget ditt.

…

-- Vennlig hilsen Petter Reinholdtsen

[joergen-vs]

Snakker du her om mapper på disken, eller Noark 5-mapper?

Mapper på disk. Så om den heter DOKUMENT, dokumenter eller Filer, vil arkivuttrekk.xml peke på den. Så i dag har vi

• dokumenter
• sysdok [forekommer oftere]
• addml.xsd
• arkivstruktur.xml
• arkivstruktur.xsd
• arkivuttrekk.xml
• endringslogg.xml
• endringslogg.xsd
• loependeJournal.xml
• loependeJournal.xsd
• metadatakatalog.xsd
• offentligJournal.xml
• offentligJournal.xsd

I arkivuttrekk.xml er de/noen deklarert

• Noark 5-arkivuttrekk
  • arkivstruktur
    • arkivstruktur.xml
    • arkivstruktur.xsd
    • metadatakatalog.xsd
  • endringslogg
    • endringslogg.xml
    • endringslogg.xsd
    • metadatakatalog.xsd
  • loependeJournal
    • loependeJournal.xml
    • loependeJournal.xsd
    • metadatakatalog.xsd
  • offentligJournal
    • offentligJournal.xml
    • offentligJournal.xsd
    • metadatakatalog.xsd

Forslaget blir da å legge til [tar med arkiv-nivå i arkivuttrekk.xml]:

• Noark 5-arkivuttrekk
  • dokumenter
  • dokumentasjon

Har du URL til hvor det ble lagt til, og detaljer om hva som ble endret?

Nei, dette skjedde i epost-tråder og uthjemling av praksis. Fungerer nå uavhengig av skanner-aktør.

Hvis det trengs for å bringe Noark 5 på linje med relaterte
beskrivelser, så tenker jeg at det bør gjøres. Hva konkret tenker du
bør endres i Noark 5-spesifikasjonsteksten? Det er litt uklart fra
forslaget ditt.

Forslaget baserer seg på eksisterende informasjon:

Dokumentene skal ligge i en underkatalog kalt DOKUMENT. Denne
katalogen kan struktureres i nye underkataloger etter fritt
valg.

Så forslaget er å deklarere DOKUMENT på samme måte som arkivstruktur m.fl. Eneste mulige sted som blir påvirket er 6.4.22. Den inneholder i dag punktliste over informasjon som skal med i arkivuttrekk.xml, e mulig endring er et tilleggspunkt om "Antall dokumentasjons-filer i uttrekket".
Utover det blir eneste endringen en ny mal for arkivuttrekk.xml.

En oppklaring: i 6.4.15 heter mappen DOKUMENT. dataobjektet i arkivuttrekk.xml som angir dokumentmappen kan angis til DOKUMENT i stedet for dokumenter, som foreslått over. Så blir den mer i tråd med standarden.

<dataObject name="DOKUMENT">
  <properties>
    <property name="folder">
      <properties>
        <property name="name">
          <value>Filer</value><!-- navn på dokument-mappe -->
        </property>
      </properties>
    </property>
    <property name="info">
      <properties>
        <property name="numberOfOccurrences">
          <value>dokumenter</value>
          <properties>
            <property name="filePath">
              <value>*.*</value>
            </property>
            <property dataType="integer"
              name="value">
              <value>2630</value><!-- antall filer i dokument-mappe -->
            </property>
          </properties>
        </property>
      </properties>
    </property>
  </properties>
</dataObject>

[sturtzel]

Jeg forutsetter at de foreslåtte endringene ikke gjør at dagens løsninger for avlevering etter Noark 5.5 vil feile (at dette blir en bakoverkompatibel utvidelse).

Alt som er referert fra arkivstrukturen kan ligge i dagens katalog.

Jeg synes ikke det kommer klart frem hva som skal ligge i katalogen dokumentasjon. Beskrivelse av prosessen med produksjon? Beskrivelse av systemet som har produsert uttrekket?

[joergen-vs]

Jeg forutsetter at de foreslåtte endringene ikke gjør at dagens løsninger for avlevering etter Noark 5.5 vil feile (at dette blir en bakoverkompatibel utvidelse).

I dag er det underforstått hvor en finner dokumentene, og det må det også tillate å være, om man går for en bakoverkompatibel versjon. Vil tro at f.eks. Arkade må operere med "hvis ikke deklarert, fall tilbake på ".

Jeg synes ikke det kommer klart frem hva som skal ligge i katalogen dokumentasjon.

Arkivforskriften § 5-32 B, med videre lenking. I disse dager gjelder det først og fremst skjema for arkivbeskrivelse.

Edit: Og om du bruker egne verktøy som tar i bruk andre filer / logger / rapporter, står man fritt til å legge til de. På samme måte som dagens arkivuttrekk.xml er en mal, kan det legges til ytterligere xml-filer.

En beskrivelse av Noark i addml belager seg på et krav til visse xml-er og andre valgfrie (etter hva systemet leverer). Men beskrivelsen skal gjelde hele datasettet, som gjelder resten av innholdet, hva angår dokumentasjon / SYSDOK-mapper, rapporter fra eksport m.fl.

Og Arkade skal kunne kjøre Noark-tester på Noark-innholdet, men også ta høyde for annet innhold, som å kontrollere materiale som ikke er beskrevet [i addml-en].

Eksempel på "mer":

• content
  • Noark-uttrekk (xml-er, xsd-er og dokument-mappe)
  • "export"-mappe med logger
  • avviksmeldinger.txt

[petterreinholdtsen]

[Jørgen]

I dag er det underforstått hvor en finner dokumentene, og det må det også tillate å være, om man går for en bakoverkompatibel versjon. Vil tro at f.eks. Arkade må operere med "hvis ikke deklarert, fall tilbake på <dagens praksis>".

Hvis jeg forstår deg riktig, så er ditt forslag å forlate kravet i Arkivforskriften § 5-31, "For arkivdokumenter skal det opprettes en katalog med navnet DOKUMENT på første nivå under rotkatalogen på vedkommende lagringsenhet. Dokumentfilene skal samles på andre nivå under rotkatalogen og eventuelt struktureres i underkataloger. Dersom et enkelt arkivdokument består av flere filer, skal disse samles i én katalog med et entydig navn. Filformat for arkivdokumenter angis ved filendelse, f.eks. XML, PDF eller TIF." Intet ville glede meg mer, da kravet om en katalog bestående av kun store bokstaver, og en filstruktur der formatinformasjonen i arkivstruktur.xml dupliseres med dårligere oppløsning og formålsløs navnebegresning (jeg vil heller lagre filene med navn avledet fra innholdets sjekksum, for automatisk deduplisering) er for meg helt meningsløst. Uansett tenker jeg det bør eksplisitt nevnes at alle nye katalognavn for arkivdokumenter vil være i strid med Arkivforskriften, og neppe kan godkjennes helt uten å oppdatere forskriften i samme slengen.

…

-- Vennlig hilsen Petter Reinholdtsen