N5TG flytting, tre tilnærminger

[Petter Reinholdtsen]

Det ser ut til å være tre tilnærminger så langt til flytting av
instanser for Noark 5 Tjenestegrensesnitt.  To av dem er beskrevet i
kapittel 6, den siste ser ut til å være implementert i Nikita.
Kapittel 6 er tilgjengelig via
<URL: https://github.com/arkivverket/noark5-tjenestegrensesnitt-standard/blob/master/kapitler/06-konsepter_og_prinsipper.rst >,
søk etter 'flytt'.

Den første i kapittel 6 er for å flytte en dokumentbeskrivelse fra en
registrering til en annen:

  PATCH https://n5.example.com/api/arkivstruktur/Dokumentbeskrivelse/1fa94a89-3550-470b-a220-92dd4d709044

  Innholdet skal ha følgende form:
  
    {
      "_links": {
        "https://rel.arkivverket.no/noark5/v5/api/arkivstruktur/registrering/": {
          "href": "https://n5.example.com/api/arkivstruktur/registrering/cf8e1d0d-e94d-4d07-b5ed-46ba2df0465e/dokumentbeskrivelse/"
        }
      }
    }

Denne ser ut til å være inspiert av IETF RFC 7396, der en oppgir
kun JSON-feltet som skal erstattes.

Den andre i kapittel 6, litt lenger ned i teksten, beskriver flytting av
mappe fra en arkivdel til en annen:

  PUT https://n5.example.com/api/arkivstruktur/mappe/cf8e1d0d-e94d-4d07-b5ed-46ba2df0465e/arkivdel/$ref

  Innholdet skal ha følgende form:

    https://n5.example.com/api/arkivstruktur/arkivdel/092e497a-a528-4121-8f22-fbc78fa6c930

Den siste er beskrevet i en test i Nikita for å flytte en mappe fra en
arkivdel til en annen,
<URL: https://gitlab.com/OsloMet-ABI/nikita-noark5-core/-/blob/master/src/test/java/app/webapp/general/GeneralTest.java?ref_type=heads#L595 >:

  PATCH https://n5.example.com/api/arkivstruktur/mappe/cf8e1d0d-e94d-4d07-b5ed-46ba2df0465e": "move",
  "from": "0a3348d9-a950-45e7-8835-302fda9925af",
  "path": "092e497a-a528-4121-8f22-fbc78fa6c930"
  }

Denne siste tilnærmingen ser ut til å være inspiert av IETF RFC 6902,
JavaScript Object Notation (JSON) Patch.

Det er kanskje på tide å gjøre spesifikasjonen mer konsistent med seg
selv, og i samme slengen kan vi jo vurdere om det er lurt å basere seg
på en av RFC-standardene for endring av JSON-objekter.

Hva tenker dere andre om mekanisme for flytting av instanser i arkivet?

-- 
Vennlig hilsen
Petter Reinholdtsen