search

arkivverket / noark5-standard

Noark 5 versjon 5.0 – innspill før versjonering til Noark 5 versjon 5.1
Other
3 stars 5 forks source link

Legg til M413 eksternReferanse (AM.REF) til journalpost i 120-vedlegg_2_metadatakatalog_objektsortert.rst #132

Open hanber opened 3 years ago

petterreinholdtsen commented 1 year ago

Jeg tror dette er en god ide som bringer Noark 5 og tjenestegrensesnittet nærmere hverandre. Se https://github.com/arkivverket/noark5-tjenestegrensesnitt-standard/issues/184 for tilsvarende henvendelse om tjenestegrensesnittet, der endringen er tatt inn. Se også https://github.com/arkivverket/noark5-standard/pull/124 .

petterreinholdtsen commented 2 weeks ago

Jeg tenker ta endringen inn i master i slutten av måneden hvis ingen protesterer.

sturtzel commented 2 weeks ago

Hvis knyttet til korrespondansepart slik det var i Noark 4 så er det helt OK. Dette er et felt som fortsatt brukes aktivt. Feltet heter deresReferanse i Fiks Arkiv, men definert uten referanse til metadatakatalogen: https://github.com/ks-no/fiks-arkiv-specification/blob/main/Schema/V1/no.ks.fiks.arkiv.v1.arkivering.arkivmelding.opprett.xsd

petterreinholdtsen commented 2 weeks ago

[Ragnar Sturtzel]

Hvis knyttet til korrespondansepart slik det var i Noark 4 så er det helt OK.

I dette forslaget så verdien den knyttet til journalpost som en ekstra attributt, ikke korrespondansepart. Se forøvrig metadata/M413.yaml som ble lagt inn uten at den ble tatt i bruk. Denne endringen er dermed å fullføre endringene i e14b6a05039cb287f715bd4d6b50bbe1316125fd og e3f0b35697a481d9ccf32a2a006bf006e156cf28.

-- Vennlig hlisen Petter Reinholdtsen

sturtzel commented 2 weeks ago

[Ragnar Sturtzel] Hvis knyttet til korrespondansepart slik det var i Noark 4 så er det helt OK. I dette forslaget så verdien den knyttet til journalpost som en ekstra attributt, ikke korrespondansepart. Se forøvrig metadata/M413.yaml som ble lagt inn uten at den ble tatt i bruk. Denne endringen er dermed å fullføre endringene i e14b6a0 og e3f0b35. … -- Vennlig hlisen Petter Reinholdtsen

413 er også journalpost. Referansen ligger antagelig på korrespondansepart i alle systemer som er i bruk i dag da dette er referansen denne korrespondanseparten har gitt. I en forsendelse kan det være angitt mottagers så vel som avsenders referanse. Det er ikke mulig med forslaget slik det foresligger. Det betyr også at Noark får noe som ikke matcher bruk/behov.

petterreinholdtsen commented 2 weeks ago

[Ragnar Sturtzel]

413 er også journalpost.

Det stemmer, det er som nevnt forløperen til dette endringsforslaget.

Referansen ligger antagelig på korrespondansepart i alle systemer som er i bruk i dag da dette er referansen denne korrespondanseparten har gitt. I en forsendelse kan det være angitt mottagers så vel som avsenders referanse. Det er ikke mulig med forslaget slik det foresligger. Det betyr også at Noark får noe som ikke matcher bruk/behov.

Noen som vet hvordan XML-en så ut i Noark 4 for dette?

Den aktuelle referansen er slik jeg forstår dette, 'vår referanse' i avsenders skriv, og slik ikke knyttet til avsender men selve innsendt skriv. Et innkommende skriv vil aldri ha flere avsendere, slik at for slik bruk vil det gi mening å koble referansen til journalpost, ikke avsender.

For utgående skriv, der en gjerne ønsker å føre opp innkommende 'vår referanse' i feltet for 'deres referanse', så kan en jo ha flere mottakere, og hver av disse kan ha ulike 'vår referanse' på tidligere innkommende skriv, slik at det for utgående skriv kan gi mening å oppgi flere 'deres referanse', en for hver mottaker. Det er dog uklart for meg hva slags bruksområde registrering av ekstern referanse for hver utgående korrespondent skal brukes til.

Uansett, I sum tenker jeg at dette taler for at det gir mest mening å ha 'eksterReferanse' knyttet til korrespondanseparter i stedet for journalposter.

I Noark 5 tjenestegrensesnittet (N5TG) ble det på forespørsel fra kommunal aktør lagt inn støtte for ekstra felt i mappe, registrering og dokumentbeskrivelse, basert på hva som kunne trengs for innkommende skriv. Forslaget til endring i Noark 5 basert på spesifikasjonen i tjenestegrensesnittet ligger som alternativt forslag <URL: https://github.com/arkivverket/noark5-standard/pull/124 > med annen tilnærming for å løse samme utfordring. I N5TG tror jeg ikke det ble vurdert behovet rundt utgående skriv og verdien av å ha flere eksterne referanser på samme utgående brev, ut fra ideen om at et skriv har en mottaker og flere kopimottakere, og at det kun er hovedmottakers eksterne referanse som registreres i arkivet.

Ragnar, kan du navngi systemer du kjenner til som har slik referanse koblet til korrespondansepart? Jeg er ikke overbevist om at det er alle, men det kan kanskje noen med tilgang til ulike systemer gi innspill på?

-- Vennlig hilsen Petter Reinholdtsen

sturtzel commented 2 weeks ago

Noark 4: image

Jeg vet ikke hvordan det er i alle systemer, men Elements har det i hvert fall på korrespondansepart. ESA hadde det også der.

petterreinholdtsen commented 2 weeks ago

Hvis jeg leser Documasters API-dokumenasjonen, så er tilsvarende verdi der ExternalID (EksternId), og den er koblet til Mappe, Registrering og Dokumentbeskrivelse, se <URL: https://documaster.github.io/api-docs/model/secondary-entities/common-entities/#external-id >, med andre ord identisk med det som er definert i Noark 5 Tjenestegrensesnitt og foreslått i https://github.com/arkivverket/noark5-standard/pull/124 .

-- Vennlig hilsen Petter Reinholdtsen

sturtzel commented 2 weeks ago

Hvis jeg leser Documasters API-dokumenasjonen, så er tilsvarende verdi der ExternalID (EksternId), og den er koblet til Mappe, Registrering og Dokumentbeskrivelse, se <URL: https://documaster.github.io/api-docs/model/secondary-entities/common-entities/#external-id >, med andre ord identisk med det som er definert i Noark 5 Tjenestegrensesnitt og foreslått i #124 . … -- Vennlig hilsen Petter Reinholdtsen

Documaster er et rent arkiv. Brevene med referansene produseres av saksbehandlingssystemer.

petterreinholdtsen commented 2 weeks ago

[Ragnar Sturtzel]

Documaster er et rent arkiv. Brevene med referansene produseres av saksbehandlingssystemer.

Jeg antar du mener Noark 5-kjerne når du skriver 'rent arkiv'. Kan du forklare litt nærmere hvordan det er relevant for plassering av ekstern referanseinformasjon på mappe/registrering/dokumentobjekt versus korrespondansepart i arkiv og uttrekk?

-- Vennlig hilsen Petter Reinholdtsen

sturtzel commented 2 weeks ago

F.o.m. Noark 4 Web Services har det vært to muligheter for standard integrasjoner (Noark 5 tjenestesnitt ble aldri det):

Deres referanse knyttet til en korrespondansepart (den referansen denne korrespondanseparten har). Deres referanse vises i brukergrensesnittene.

Ekstern referanse som nøkkel for mappe (sak) og registrering (journalpost) som eget objekt med to felt, et felt som angir fagsystemet og et felt som angir nøkkelen fagsystemet benytter. Denne nøkkelen er gjerne en UUID og er derfor ikke egnet for noe brukergrensesnitt. Den kan også være et løpenummer eller et fødselsnummer. Den benyttes gjerne av fagsystemet for referanser ved oppslag, oppdateringer og avskrivning. Ingen av disse integrasjonsstandardene har en eksternreferanse på dokumentbeskrivelse eller dokumentobjekt. Feltene er ikke med i noe uttrekk, men det gjelder mye annen informasjon også som f.eks. matrikkelnummer, planident og geografisk plassering.

Spørsmålet er om vi snakker om to forskjellige behov og at referansen til Noark 4 er feil.