Brukstilfelle Klassifikasjon

UTKAST: Bruk av klassifikasjon ved arkivering

Under arbeid

Som klientsystem ønsker jeg ikke å måtte ha forskjellige konfigurasjoner for klassifikasjon og klassifikasjonssystemer for hvert arkivsystem og kundeinstallasjon. Jeg ønsker at alle arkivleverandører og deres kunder kan motta klassifikasjon slik de er definert for klientsystem og mappe det til riktig klassifikasjonssystem hos kunden. Mapping må avtales og testes mellom klientsystem og arkivleverandør/kunde i sammenheng med å definere regel for de forskjellige brukstilfellene. Arkivsystem kan vite hvilke mappinger (regler) som er aktuelle basert på klientsystemet identifiseres via system og regel atributtet i arkivmelding sammen med klassifikasjonssystemID. Les mer om regel her.

Register for klientsystemenes definisjoner

Vi oppretter et "register" hvor klientsystemene kan dokumentere hvordan de definerer sine klassifikasjoner og regler man ønsker dette knyttet til. Registeret er et github repository hvor man kan gjøre endringer via pull-requests. KS vil da merge inn ved forespørsel. Registeret ligger i repositoriet fiks-plan-specification-docs som man finner her.

Eksempel

Eksempel for arkivering av saksmappe med 4 stk klassifikasjon knyttet til system "Klientsystem X" og regel med id "regel1":

<system>Klientsystem X</system>
<regel>regel1</regel>
<antallFiler>0</antallFiler>
<mappe xsi:type="saksmappe">
    <tittel>En saksmappe</tittel>
    <klassifikasjon>
       <klassifikasjonssystemID>X1</klassifikasjonssystemID> <!-- En kort id --> 
       <klasseID>4.16</klasseID> <!-- Klientsystemleverandørens applikasjon -->
       <tittel>Systemnavn</tittel>
    </klassifikasjon>
    <klassifikasjon>
       <klassifikasjonssystemID>X2</klassifikasjonssystemID> <!-- En kort id -->
       <klasseID>4</klasseID> <!-- En type -->
       <tittel>Kartlegginger</tittel> 
    </klassifikasjon>
    <klassifikasjon>
       <klassifikasjonssystemID>X3</klassifikasjonssystemID> <!-- En kort id -->
       <klasseID>**Et orgnr**</klasseID> <!-- En skole identifisert med organisasjonsnummer -->
       <tittel>En test skole</tittel>
    </klassifikasjon>
    <klassifikasjon>
       <klassifikasjonssystemID>X4</klassifikasjonssystemID> <!-- En kort id -->
       <klasseID>**Et fødselsnummer**</klasseID> <!-- En person identifisert med fødselsnummer -->
       <tittel>John Testelev Doe</tittel>
    </klassifikasjon>
    ...

</mappe>

Forklaring til eksempel - system, regel og klassifikasjonssystemID

System er en entydig definisjon av en klient på tvers av alle mulige klienter som benytter Fiks Arkiv. System vil normalt være det samme som produktnavnet til klienten.

Regel er identifikator for hvilken regel man ønsker at skal benyttes hos arkivsystem. Regel vil fylle ut felter som klientsystemet ikke trenger å fylle ut selv og som alltid skal være likt. Regel vil også da kunne se hvordan mapping skal gjøres mot klassifikasjonssystem hos kunden, basert på klassifikasjonssystemID.

KlassifikasjonssystemID er en forkortet identifikator fra klientsystem som arkivsystem mapper til korrekt klassifikasjonssystem hos kunen.

Klientsystem kan da ha forskjellige mappinger som skal gjøres med forskjellige klassifikasjonssystem hos kunden. Mapping gjøres ved å se på system + regel + klassifikasjonssystemID.

Mapping fra eksempel

System = "Klientsystem X"

Regel = "regel1"

klassifikasjonssystemID = X1, X2, X3 og X4

Arkivsystem vet da basert på system og regel hva de 4 forskjellige klassifikasjonssystemID-ene skal mappes til hos kunden samt hva som evt er primær- og sekundær klassifikasjoner.

Klassifikasjon

Rekkefølgen til klassifikasjon elementene er likegyldige og viser ikke til f.eks. primær og sekundær klassifikasjoner. Primær og sekunderklassifikasjoner er bestemt i avtalen mellom klientsystem og arkiv for gitt regel, og mappes riktig av arkivsystem.

KlassifikasjonssystemID

Kan være et kort navn. Trenger ikke være full beskrivelse av hva de er.

KlasseID

Identifiserer f.eks. organsiasjonen (K3, skolen i dette eksempelet), eller personen (K4, eleven i eksempelet).

Tittel

Første gang man sender inne en klassifikasjon med en klasseID som ikke eksisterer fra før, så kan arkivet opprette den med den tittel som kom med. For eksempel personnavn. Hvis man sender en påfølgende melding senere, hvor det følger med en navnendring for personen via tittel, vil ikke arkivet garantere at dette blir endret i arkivet for den klasseID det gjelder.

Svakheter med denne løsningen

Slik det er definert nå så kan det være et problem hvis klientsystemet har definert et kortnavn for klassifikasjonssystemID (X1 fra eksempelet), som man ønsker skal mappes om til korrekt klassifikasjonssystemID men som også faktisk eksisterer i arkivsystemet. Da kan arkivsystemet få et problem med å vite om det skal mappes om eller det er slik at klientsystemet ønsket å vise til det faktiske klassifikasjonssystemet som eksisterer hos arkivsystemet.

Regel er definert slik at når man bruker regel for at arkivsystem skal sette standardverdier så skal klientsystem fremdeles kunne sette verdiene selv, og dermed overstyre det regel skulle sette som standardverdi.

Se issue og kommentarer her: https://github.com/ks-no/fiks-arkiv-specification/issues/205