Community på Sveriges dataportal

Hej!

Jag är stolt över att kunna meddela att LFV och vårt systemutvecklingsteam nu har släppt vårt andra egna open source-projekt reqstool.

Reqstool är ett verktyg (Python) för att hantera krav och tester av dessa i källkod. Utvecklare annoterar källkod var krav implementeras (@Requirements) respektive testas (@SVC, software verification case). Tillsammmans med test resultat (typiskt unit-tester) så kan verktyget generera status, asciidoc-rapport etc.

Reqstool består av en klient och antal andra repositories för stöd i Java och Python (hantera annoteringar samt byggverktyg såsom Maven, Poetry och Hatch). Allt är publicerat på Maven Central samt pypi.

Ni finner klienten (reqstool-client) och ett demo-projekt (reqstool-demo) på vår github: https://github.com/Luftfartsverket

För dokumentation av reqstool: https://luftfartsverket.github.io/reqstool-client/

Mvh Jimisola

@Maria_Dalhage

Har haft diskussioner om detta med LFV:s koncern juridik som vill att vi ska Copyright i varenda fil.
Vi utvecklare är inte helt överens för det skapar en extraarbete som inte behövs av just den orsaken som du tar du upp.

@Maria_Dalhage

Sorry för sent svar. Tack för inputen!

Hej,

Vem ansvarar för https://offentligkod.se/ aka https://gitlab.com/open-data-knowledge-sharing/katalogen?

Där är 3 Merge requests och 7 Issues som daterar 5 månader tillbaka. Repository har inte blivit uppdaterat på 10 månader.

Mvh Jimisola

Hej,

Vi är lite nyfikna hur andra myndigheter har gjort när de publicerar öppen källkod (på t ex GitHub).
Förutom att välja en licens så finns det ju även möjlighet att ha med en Copyright notice i källkodsfilerna.

Jag är ingen juridisk-expert så därför undrar jag hur ni andra har gjort och vilket resonemang ni hade.

I MIT License t ex så anger man en Copyright (se t ex "Copyright (c) 2022 Havs- och vattenmyndigheten: "https://github.com/diggsweden/jitsi-outlook?tab=MIT-1-ov-file#readme)

Skapar det problem som "vi bortsett från" när man tar emot Pull Requests (bidrag) eftersom personen(erna) som bidrar äger rätten till sin källkod per default. Vi kan med andra ord inte ta in den och bara ersätta med Copyright <någon myndighet> - inte utan medgivande genom t ex Contributor License Agreement (CLA). Ett CLA skapar ju en tröskel för att få in bidrag.

För övrigt så har GitHub har: https://github.com/cla-assistant/cla-assistant

Det är inte jättevanligt bland open source-projekt att där finns ett CLA men en del har sådana, t ex:

• Microsoft: https://opensource.microsoft.com/cla/

Jag vill minnas att jag även råkat ut för att min kommentar på en issue inte har synts förrän jag har accepterat motsvarande CLA.

Hur som helst, hur har andra myndigheter resonerat?

@DIGG_admin

Det är väldigt olyckligt att en plugin som DIGG tagit fram och annonserat här sedan inte har någon som svarar på frågor.

Jag har full förståelse för att det är open source och utan några som helst garantier men jag tycker det är oerhört viktigt att DIGG visar vägen för open source inom myndighets-Sverige.

Med anledning av denna plugin så har jag involverad en rad personer på LFV samt hos vår leverantör och det är tyvärr inte en bra upplevelse för dessa och jag är orolig att det påverkar hur LFV kommer se på open source framöver.

Jag har skapat en ticket på github med frågorna från vår leverantör.

https://github.com/diggsweden/jitsi-outlook/issues/43

Vår leverantör, CGI, får inte rätt på pluginen och de verkar inte riktigt anamma idén med att fråga på GitHub. Finns det någon på DIGG som de kan kontakta direkt? Annars lär det nog inte blir någon plugin för LFV vilket vore jäkligt synd.

@Maria_Dalhage Vet du?

@Josef_Andersson Hej, jag får be vår SA alternativt CGI. Skriva då. Tack.

@Josef_Andersson Ett par frågor:

1. Det ser ut att gjorts en del ändringar i pluginen men ingen ny release har skett. När räknar ni med att göra en ny release.

2. Den aktuella releasen ser endast ut att vara en tag. Vår leverantör har fått till uppgift att lägga in pluginen för vår organisation. Vilka filer är det som ska med? Måste något byggas? Det vore bra med lite mer guidning kring vad som krävs för att kunna följa Microsofts-guide som ni länkar till. Med det sagt, så är jag inte någon Windows-nisse men det verkar ändå inte vara tydligt.

Ni kanske behöver köra en pipeline som bygger ett färdigt paket när ni gör en release?

@Josef_Andersson Vad kul. Ser framemot återkoppling.

Jag är stolt över att kunna meddela att LFV och vårt systemutvecklingsteam har släppt vårt första egna open source-projekt (vi har ett till som vi hoppas kunna släppa snart).

Det är ett verktyg (Python) för att generera AsciiDoc från en OpenAPI Specification-fil.

För er som inte är bekanta med AsciiDoc så är det människo-läsbart text-format för dokumentation (påminner om MarkDown men är mer strukturerat och hanterar tekniska texter bättre). Vårt utvecklingsteam använder det till ALLT. AsciiDoc används av Eurocontrol, Red Hat, Spring Foundation m fl.

Länkar till openapi-to-asciidoc:

• PyPi
• GitHub

@Josef_Andersson Fixat. https://github.com/diggsweden/jitsi-outlook/issues/21

@Josef_Andersson Tack för återkopplingen och informationen.

Jag/vi saknar information om vilka versioner av Outlook som pluginen fungerar med. Fungerar den t ex Office 2016?

Mvh Jimisola

Härligt med ett öppen källkodsprojekt där myndigheterna samarbetar.

Jag måste dock fråga hur denna relaterar till en redan existerande plugin: https://github.com/timetheoretical/jitsi-meet-outlook

Uppfattar det som att DIGG:S plugin är ny. Det hade kanske varit att föredra att bidra till en redan existerande om det finns tillräckligt många likheter?

Mvh Jimisola

@Björn-Hagström sa i Samarbete kring Roda (e-arkiv):

@lfvjimisola Hallå där, ni måste så klart arkivera i arkivbeständiga format men jag undrar om ni också kommer spara i originalformatet? Man dödar mycket användning om man byter till pdf till exempel.

Vet ej. Det är inte mitt ansvarsområde utan arkiverings.

@Linus sa i Samarbete kring Roda (e-arkiv):

@lfvjimisola Den här tråden på stackoverflow kanske är till hjälp: https://stackoverflow.com/questions/1659147/how-to-use-ghostscript-to-convert-pdf-to-pdf-a-or-pdf-x

Tack men jag har koll på den tråden men den har några år på nacken och fanns det något som garanterat fungerar och går igenom validering så hade det besparat mig lite tid.

Nu har vi tagit fram en Docker image med konvertingsverktyg för

• Office-format till PDF: unoserver (LibreOffice)
• PDF till PDF/A: Ghostscript
• bilder: ImageMagick
• video: FFmpeg

samt valideringsverktyget veraPDF (båda implementationerna dvs Greenfield och PDFBox).

Härnäst är tanken att implementera en Java-backend som mikrotjänst som styrs av användaren genom en webbaserad frontend.

För att spara tid och undvika att återuppfinna hjulet så undrar jag om någon har kommandorad(er) samt eventuellt tillhörande definitionsfil för Ghostscript för konvertingar av PDF till PDF/A-1A samt PDF/A-1B? I så fall mottages den tacksamt.

Mvh Jimisola

@svenTV sa i Samarbete kring Roda (e-arkiv):

@lfvjimisola Nej, RODA kommer inte med något färdigt konverteringsgränssnitt.
Jag är inte tekniker, så jag borde kanske hålla mun. Men de alternativ du skissar på pekar i mina ögon mot någon form av arkiveringsbehov där olika roller (handläggare mm) manuellt ska välja ut filer för konvertering och arkivering.
Tänker du att det är ett försteg för att skapa filer/kataloger som man sedan kan köra RODA-In mot? Så kan det vara.
Men det förutsätter nog i de flesta fall att man tar omhand/skapar någon form av metadata redan i försteget som gör att man ser vad en fil har för sammanhang (t ex ett ärende eller en filkatalog strukturerad utifrån t ex tidsomfång). Gränssnittet skulle behöva ett tvingande metadataformulär (e-arkivets metadatamodell) som styr lagringsstrukturen, tillsammans med kunniga användare, så att det inte bara blir en hög blandade filer.
Vilken informationsstruktur ska filerna in i?

• En SIP per tidsomfång med alla filer i tidsomfånget?
• En fil per SIP?
• Ärende-SIP med vissa tillhörande filer per SIP?
• Annat?
• Olika beroende på? Hur?

Den snåriga delen är hur man skapar "rätt" datastruktur och sökbarhet (metadata). Där behöver både den informationsskapande verksamheten och arkivet säga hur det ska vara. En generell informationsmodell bör ligga till grund för det, som alla leveranser kan mappas mot.

Konverteringsbehoven och målen är ju väldigt olika, även om det övergripande målet är detsamma...

Ja, vi tänker oss ett konverteringsverktyg av diverse format (initialt Office och PDF till PDF/A).
Har kommit en bit på vägen nu och skriver om det i nästa post.

@davidlars sa i Intresse för ett DevOps-seminarium:

@lfvjimisola Jag är övertygad om att vi har en stor potentiell målgrupp som söker efter DevOps 101. Grunderna utan djupdykningar i tekniken och avancerad utvecklingsmetodik.

En till viktig fråga som jag själv behöver hjälp med är hur man bygger upp en förvaltningsorganisation för DevOps-orienterat utvecklingsarbete. Gärna kopplat till en typisk PM3-organisation.

Jag är iofs övertygad om att vi också har en stor grupp som suktar efter djupdykningar och mer nischade diskussioner. Båda behövs. Men personligen så ligger fokuset mer på 101-nivån, det är där vi är i min egen org.

Ok. Då har vi helt klart olika behov. Vårt team efterfrågar utbyte med organisationer i det offentliga som har erfarenhet av och använder DevOps. Vi har kommit rätt långt får jag nog säga men det icke desto mindre är utbyte av erfarenhet oerhört intressant.

Mvh Jimisola

Vem tänker ni ska vara mottagare (audience)?

• Adminstrativ personal, IT-avdelning och utvecklare och/eller?
• Riktar sig träffen till dom utan någon som helst erfarenhet av DevOps eller till oss som är en bit på vägen?
• Metodik och/eller teknik?
• osv