Presentasjonsmøte Grouse

[Aamot Software]

  _  __ ____  ____  ____        _____ ____  ____  _     ____  _____
/ |/ //  _ \/  __\/ ___\      /  __//  __\/  _ \/ \ /\/ ___\/  __/
|   / | | \||  \/||    \_____ | |  _|  \/|| / \|| | |||    \|  \
|   \ | |_/||    /\___ |\____\| |_//|    /| \_/|| \_/|\___ ||  /_
\_|\_\\____/\_/\_\\____/      \____\\_/\_\\____/\____/\____/\____\

Innlegg basert på https://www.folloarkivet.no/presentasjonsmote-grouse/

13. juni 2018 inviterte Folloarkivet kommunene til en presentasjon av 
Grouse. Det er en løsning som skal lette arbeidet med å produsere en 
NOARK 5 kravspesifikasjon.

Anskaffelse av nytt sak/arkiv-system og utarbeidelse av 
kravspesifikasjon til denne er en stor oppgave som må på plass ved 
etableringen av en ny kommune. Systemet skal både være et verktøy for 
saksbehandling og ha arkivfunksjonalitet på plass. Mens NOARK 4 var en 
kravspesifikasjon er NOARK 5 en standard som stiller store krav til 
kommunen som bestiller.  NOARK 5 gjør det mulig å skape effektiv 
arbeidsflyt på tvers, men det krever mye fra bestillerrollen.

KAI-miljøet har sammen med KDRS og Thomas Sødring utviklet en løsning 
som skal gjøre det enklere å utvikle en kravspesifikasjon for Noark 5. 
Løsningen ble ferdigstilt sommeren 2018 og Folloarkivet fikk Thomas 
Sødring som er førsteamanuensis i arkivviteskap ved OsloMet til å gi en 
demostrasjon. Løsningen baserer seg på kravspec'en som ble utviklet for 
Nye Sandefjord kommune.

Grouse ligger på KDRS SA sine sider og på GitHub.

https://github.com/KDRS-SA/grouse

Nytt: kravspec-1.0-SNAPSHOT.jar-fil 
(http://as.engineering:80/kravspec-1.0-SNAPSHOT.jar) hos Aamot 
Engineering.

Grouse kan kjøres på følgende vis med MacPorts, MariaDB, wget, java og 
curl mot
Word-malfilen "kravspec.docx" lokalt på et case-sensitivt operativsystem 
som Linux.

$ sudo port install mariadb-server
$ sudo -u _mysql /opt/local/lib/mariadb/bin/mysql_install_db
$ sudo /usr/lib/mariadb/bin/mysqld_safe --datadir='/usr/var/db/mariadb
$ '/usr/lib/mariadb/bin/mysqladmin' -u root password 'new-password'
$ '/usr/lib/mariadb/bin/mysqladmin' -u root -h localhost password 
'new-password'
$ echo '
-- Remove database if it exists
DROP DATABASE `grouse`;
-- Dumping database structure for concretepage
CREATE DATABASE IF NOT EXISTS `grouse`;
USE `grouse`;
-- Dumping structure for table grouse.kravspecs
CREATE TABLE IF NOT EXISTS `kravspec` (
   `kravspec_id` int(5) NOT NULL AUTO_INCREMENT,
   `title` varchar(200) NOT NULL,
   `category` varchar(100) NOT NULL,
   PRIMARY KEY (`kravspec_id`)
) ENGINE=InnoDB AUTO_INCREMENT=10 DEFAULT CHARSET=latin1;
-- Dumping data for table concretepage.kravspecss: ~3 rows 
(approximately)
INSERT INTO `kravspec` (`kravspec_id`, `title`, `category`) VALUES
   (1, 'Java Concurrency', 'Java'),
   (2, 'Hibernate HQL ', 'Hibernate'),
   (3, 'Spring MVC with Hibernate', 'Spring');' >kravspec-1.0.sql
$ '/usr/lib/mariadb/bin/mysqladmin' -u root -p <kravspec-1.0.sql
$ wget https://as.engineering/kravspec-1.0-SNAPSHOT.jar
$ java -jar kravspec-1.0-SNAPSHOT.jar &
$ curl -i -H "Content-Type: application/json"
--data '{"organisationName" : "Ski kommune", "projectName" : "Nytt Noark
5 system"}' -X POST 
http://localhost:9294/grouse/bruker/admin@kdrs.no/prosjekt

$ curl -i -H "Content-Type: application/json"
--data '{"organisationName" : "Ski kommune", "projectName" : "Nytt Noark
5 system"}' -X POST 
http://localhost:9294/grouse/bruker/admin@kdrs.no/prosjekt
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Sun, 03 Sep 2023 02:15:13 GMT

{"projectId":1,"projectName":"Nytt Noark 5
system","organisationName":"Ski
kommune","fileName":"kravspec.docx","fileNameInternal":null,"documentCreated":false,"projectComplete":null,"createdDate":"2023-09-03T02:15:13.705+0000","changedDate":"2023-09-03T02:15:13.705+0000","links":[{"rel":"self","href":"http://localhost:9294/grouse/prosjekt/1","hreflang":null,"media":null,"title":null,"type":null,"deprecation":null},{"rel":"funksjon","href":"http://localhost:9294/grouse/prosjekt/1/funksjon","hreflang":null,"media":null,"title":null,"type":null,"deprecation":null},{"rel":"dokument","href":"http://localhost:9294/grouse/dokument/1","hreflang":null,"media":null,"title":null,"type":null,"deprecation":null}]}

Så den fungerer.

> curl -i -H "Content-Type: application/json" --data
> '{"rel":"dokument","href":"http://localhost:9294/grouse/dokument/1
> <http://localhost:9294/grouse/dokument/1>","filename" :
> "/tmp/kravspec.docx"}' -X POST http://localhost:9294/grouse/dokument/1

Denne gir:

curl -i -H "Content-Type: application/json" --data
'{"rel":"dokument","href":"http://localhost:9294/grouse/dokument/1","filename"
: "/tmp/kravspec.docx"}' -X POST http://localhost:9294/grouse/dokument/1
HTTP/1.1 201
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Sun, 03 Sep 2023 02:15:13 GMT

{"projectId":1,"projectName":"Nytt Noark 5 
system","organisationName":"Ski 
kommune","fileName":"kravspec.docx","fileNameInternal":"/tmp/grouse-1.docx","documentCreated":true,"projectComplete":true,"createdDate":"2018-04-16T13:25:50.705+0000","changedDate":"2018-04-16T13:26:41.642+0000","links":[{"rel":"self","href":"http://localhost:9294/grouse/prosjekt/1","hreflang":null,"media":null,"title":null,"type":null,"deprecation":null},{"rel":"funksjon","href":"http://localhost:9294/grouse/prosjekt/1/funksjon","hreflang":null,"media":null,"title":null,"type":null,"deprecation":null},{"rel":"dokument","href":"http://localhost:9294/grouse/dokument/1","hreflang":null,"media":null,"title":null,"type":null,"deprecation":null}]}

Så det fungerer også.

Hvis du oppgir banen til input- og output-filene i JSON-request'en med 
"fileName":"kravspec.docx" og "fileNameInternal":"/tmp/grouse-1.docx", 
så vil du se en opprettet Word-fil (DOCX):

$ ls -l /tmp/*.docx
-rw-r--r--@ 1 oka  wheel  93276 Sep  3 02:23 /tmp/grouse-1.docx

Thomas, finnes det et webbasert HTML/CSS/jQuery-grensesnitt for å laste 
opp/ned kravspec-filene?

Du kan abonnere på KDRS SA sin RSS-strøm på https://www.kdrs.no/rss.xml

Mvh,
Ole Aamot
Aamot Engineering
as.engineering:80
GSM: 004741732002