I det siste har jeg forsøkt få Nikita til et nivå der jeg kan bruke den som privatarkiv selv, og i den forbindelse satte jeg sludderboten min i gang med å lage en terminalklient jeg kunne bruke til å utforske strukturen og opprette arkivstruktur som trengs for å starte opplasting av dokumenter inn i arkivet.
I dag var den kommet så langt at jeg sjekket jeg endringen inn i git-depotet for noark5-tester, der den nå kan testes mot forhånetligvis enhver Noark 5 Tjenestegrensesnittimplementasjon. Jeg har kun Nikita tilgjengelig selv, og ingen ide om hvor godt den fungerer mot andre implementasjoner. Her er et eksempel på hvordan terminalgrensesnittet ser ut:
┌──────────────────────────────────────┐┌─────────────────────────────────────┐ │ Archive Tree ││ Mappe Details │ │+ 2026-08-16 Move Test Mappe Under ││ │ │Klasse ││systemID: │ │+ 2026-08-16 Child Mappe For ││6a54e9ea-442f-4023-8674-daafae0b81b3 │ │Overmappe Test ││tittel: │ │+ 2026-08-16 Child Mappe For ││IMAP-test-mappe │ │Overmappe Test 2 ││dokumentmedium: [Elektronisk│ │+ 2026-08-16 Mottaksmappe ││arkiv (E)] │ │> +2026-08-18 IMAP-test-mappe ││endretAv: admin │ │ ││endretDato: │ │ ││2026-08-18T12:05:54.365953Z │ │ ││opprettetAv: admin │ │ ││opprettetDato: │ │ ││2026-08-18T12:05:54.365953Z │ │ ││ │ │ ││ Children (5): │ │ ││ 2026-08-18 Mappe hallo verden │ │ ││ 2026-08-18 Mappe Welcome to │ │ ││nikita-noark5-core │ │ ││ 2026-08-18 Mappe Development │ │ ││language - why Java? │ │ ││ 2026-08-18 Mappe Re: Development│ │ ││language - why Java? │ │ ││ 2026-08-18 Mappe NOARK5-kjerne │ │ ││som fri programvare får epostliste │ │ ││hos NUUG │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ │ ││ │ └──────────────────────────────────────┘└─────────────────────────────────────┘
(Ikke helt trygg på at tegnsettet gjør fremvisningen riktig i eposten, håper det gir litt mening).
TUI-klienten støtter oppretting, endring, sletting, utviding, flytting og søk. En kan finne instrukser om bruk ved å trykke 'h' når den er statet. Merk at den krever --baseurl med mindre din API-tjener kjører på lokal maskin og er kun testet med HTTP Basic Auth, men bør også fungere med OAuth2-innlogging. Den er tett knyttet opp mot strukturen i Noark, og ikke beregnet på hverken saksbehandling eller arkivering, kun utforsking og oppretting av struktur. Jeg får se om den overleverer praktisk bruk, når jeg kommer så langt.
I tillegg til terminal-brukergrensesnittet så er det også et kommandolinjegrensesnitt for enkle operasjoner. Jeg har ikke testet dette spesielt mye, men kan bekrefte at list-arkiv, list-children og get-entity fungerer.
Her er bruksinstruksene som kommer med (--help):
usage: tui-api-client [-h] [--baseurl BASEURL] [--username USERNAME] [--password PASSWORD] [--cli] [-v] [--validate-tui] {list-arkiv,list-children,get-entity,create-mappe,create-saksmappe,create-registrering,create-journalpost,create-dok-beskrivelse,create-dok-objekt,upload-file,move-mappe,update-entity,close-mappe,delete-entity} ...
Noark 5 v5 REST API client with TUI and CLI modes
positional arguments: {list-arkiv,list-children,get-entity,create-mappe,create-saksmappe,create-registrering,create-journalpost,create-dok-beskrivelse,create-dok-objekt,upload-file,move-mappe,update-entity,close-mappe,delete-entity} CLI command list-arkiv List top-level archives list-children List children of an entity path get-entity Get entity JSON create-mappe Create a mappe create-saksmappe Create a saksmappe (case) create-registrering Create a registrering create-journalpost Create a journalpost create-dok-beskrivelse Create a dokumentbeskrivelse create-dok-objekt Create a dokumentobjekt upload-file Upload file to a dokumentobjekt move-mappe Move a mappe to new parent update-entity Update entity fields close-mappe Close a mappe delete-entity Delete an entity
options: -h, --help show this help message and exit --baseurl BASEURL API base URL (default: http://localhost:8092/noark5v5/) --username USERNAME Username (default: admin@example.com) --password PASSWORD Password (default: password) --cli Run in non-interactive CLI mode (requires subcommand) -v, --verbose Verbose output --validate-tui Run automated TUI validation tests (requires pexpect)
Kanskje noen flere finner den nyttig?
Jeg har allerede takket være den funnet flere feil i API-tolkingen i Nikita, som har blitt utbedret gjennom sommeren. Antar jeg finner flere etter hvert som jeg tar Nikita mer i bruk som privatarkiv. :)