API:fiera kravkatalog för upphandling. Erfarenheter?

davidlars

Vi sitter idag med ett växande Excel-dokument för de krav som används vid upphandling. Vi har under en tid pratat om att API:fiera den. Jag handledde även ett projekt med en LIA-student för att bygga en prototyp med C#/dotnet core API. Vår kära student gjorde ett fantastiskt jobb men vi var inte riktigt framme i våra egna tankar i tid till LIA-perioden.

Nu är det hög tid att inspireras av er som gjort en liknande resa. Jag har ju svårt att tro att vi har jättemånga krav i vår egen lista som är helt unika för oss. Kanske någon enstaka punkt.

Jag har sett Umeås öppna dataportal. Och har sett någon diskussion om wikidata här på forumet men hade lite svårt att relatera det till vårt behov.

Var börjar vi? Utveckla ett eget REST API, nyttja något populärt ändamålsenligt projekt, nyttja en färdig produkt (SaaS, egen drift)?

jonass

@davidlars Mycket bra idé. Kanske går att börja enkelt. Exempelvis https://nosad.se/tips autogenereras från https://gitlab.com/open-data-knowledge-sharing/wiki/-/wikis/Lista-med-delat-material.

Maria_Dalhage

@davidlars superbra idé!

Jag tror på att samla in exempelkrav. Det kan vara organisationer som delar hela, eller endast meningar av kravunderlag. Ett sätt att göra detta på är ju att använda forumet, denna tråd för att fylla på med exempelkrav. Ett annat sätt för mer anonymitet (om det behövs) är det som @jonass skriver; att skapa en sida på NOSAD som heter Exempelkrav.

davidlars

@jonass Hmm, nosad.se/tips parsar markdown från en wikisida på Gitlab? Ursäkta om jag är helt ute och cyklar...

davidlars

Gillar förresten hur
https://government.github.com/community/
genereras från xml i detta repo:
https://github.com/github/government.github.com/blob/gh-pages/_data/governments.yml

Men ok versionshanterad källdata på Gitlab/GitHub och någon client side JS app för att passa och presentera?

Och så smackar man på något JS-bibliotek för sök och filtrering?
Det låter ju lättförvaltat och med hyfsat human UX. Med reservation för att jag kan ha missförstått helt och hållet..

davidlars

@Maria_Dalhage

skapa en sida på NOSAD som heter Exempelkrav.

Nu hänger jag inte med, har sett att man kan begära behörighet att editera vissa sidor där men skapa egna sidor, hur och var? Har du något exempel?

Maria_Dalhage

@davidlars processen är halvmanuell fortfarande. Men NOSAD har en wiki2html funktion. ”skapa en wikisida och få den uppvisad som HTML.” NSÖD har gjort en sådan sida och även DIGG (jag). Vi kallar det för communiydriven publicering. https://nosad.se/Projekt

Björn Hagström

@davidlars Hur ser du att ett API skulle hjälpa kravställare och upphandlare att ställa bättre/rätt krav? Jag har svårt att göra det.

Jag ska hålla ett seminarie om öppen inköpskedja imorgon genom Nosad/Goto10 så om jag missat något här vore det bra att få koll på:)

PS Vilken organisation kommer du ifrån?

Nina_Berlin

@davidlars @Maria_Dalhage Jättebra om du gör en sådan här sida, @davidlars! Det är precis åt det här hållet vi är på väg nu när dataportalen växlar upp till att bli digitala arenan. Jag hoppas vi kan börja visa sådant här innehåll där också, även om vi kommer ha en väg att gå för att reda ut frågorna kring juridik och tillgänglighet, t ex.

Maria_Dalhage

@davidlars @Björn-Hagström, @Nina_Berlin Ska försöka uttrycka mig tydligare. Ser att vi alla lätt pratar förbi varandra. Att ta fram ett API med sammanställda, kurerade krav är en bra idé, frågan är hur detta enklast görs.

Utmaningen är att få in bidrag och det var detta som jag och @jonass svarade på. För att få in bidrag behöver alla veta var man ska vända sig. Därför började jag med att skriva i detta forum, men det har sina begränsningar när det kommer till att ladda upp filer. @jonass föreslog därför nosad.se som redan används idag för att dela filer. I bägge fallen krävs det att någon senare om behovet föreligger bygger ett API av de bidrag; exempel meningar som tas fram.

Här handlar det om angreppssätt. Jag tror störst nytta kommer av att organisationer på enklaste sätt bara börjar dela sina kravexempel. På nosad.se kan man dela filer som excelark. Får vi in flera kan vi se hur vi kurerar och slår ihop. Jag tror att initialt ligger styrkan i att flera delar. Om det finns dem som endast vill dela enstaka meningar så kan vi kurera även sådant.

Den lösning som jag pekar på blir ju initialt inte ett API, men utmaningen är att få igång ”dela”-rörelsen. Flera spännande frågor dyker upp; hur förvaltas detta på sikt? Men som @Nina_Berlin skriver; det är bl.a. denna typ av frågor som vi gemensamt behöver lösa.

Nina_Berlin

@Maria_Dalhage Håller med jag tänker att det är mycket vunnet om @davidlars börjar sammanställa det innehåll som han vill dela, och delar det med hjälp av NOSAD. Så får vi se vart det tar vägen och var och hur vi bäst jobbar med det. Content is king. @jonass

davidlars

Vilken bra diskussion!
API är ju mer någon slags (del)målbild och som det påpekats sekundärt just nu. Från excel -> strukturerad plain text (enl någon smart XML-struktur) i Gitlab av det som vi är bekväma att dela känns som ett bra första steg härifrån. Jag börjar på den interna Gitlab-instansen och återkommer med delbart material och förmodligen följdfrågor innan dess.

davidlars

@Björn-Hagström
Nja, ett API hjälper inte det syftet direkt. Första steget behöver ju vara att dela datan och ta innehållet vidare gemensamt. Sträva åt någon slags gemensam masterdata kanske. Jag är på Örebro kommun.
Ser fram emot att kika på seminariet vid tillfälle! Hoppas att du är nöjd med hur det blev.

davidlars

@Nina_Berlin
Jag har en del jobb innan det kan bli dags för publicering men jag tänkte ändå flagga för att en trasig länk på

Den här länken:
"I Sverige har vi valt att förregistrera alla offentliga aktörer, man kan enkelt kolla om man är
förregistrerad på registrera"

davidlars

Tänkte se om jag kan få lite handledning i att sätta en RDF-struktur enl DCAT-AP-SE för ett exempelkrav från våran kravkatalog.

Ett exempelkrav, enl <Fält>: <Data>
ID: 012
Kravgrupp: Loggning
Rubrik: Loggning av åtkomst
Kravformulering: Loggning ska ske av åtkomst till lösningen
Prioritet: Ska
Bevis: Genom att svara Ja i anbudssvaret

OBS: detta är ett exempel och är inte det kompletta kravet som vi har formulerat det.

<?xml version="1.0" encoding="UTF-8"?>
<rdf:RDF
	xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
	xmlns:dcterms="http://purl.org/dc/terms/"
	xmlns:vcard="http://www.w3.org/2006/vcard/ns#"
	xmlns:dcat="http://www.w3.org/ns/dcat#"
	xmlns:foaf="http://xmlns.com/foaf/0.1/">
<dcat:Catalog rdf:about="https://example.com/catalog1">
	<dcterms:title xml:lang="sv">Kravkatalog</dcterms:title>
	<dcterms:description xml:lang="sv">Kravkatalog för IT-upphandlingar</dcterms:description>
	<dcterms:publisher rdf:resource="https://example.com/publisher1"/>
	<dcat:dataset rdf:resource="https://example.com/dataset1"/>
	<dcterms:license rdf:resource="http://creativecommons.org/publicdomain/zero/1.0/"/>
</dcat:Catalog>
<foaf:Agent rdf:about="https://example.com/publisher1">
	<foaf:name>Exempelkatalog</foaf:name>
</foaf:Agent>
<dcat:Dataset rdf:about="https://example.com/dataset1">
	<dcterms:id xml:lang="sv">0012</dcterms:group>
	<dcterms:group xml:lang="sv">Loggning</dcterms:group>
	<dcterms:title xml:lang="sv">Loggning av åtkomst</dcterms:title>
	<dcterms:description xml:lang="sv">Loggning ska ske av åtkomst till lösningen</dcterms:description>
	<dcterms:priority xml:lang="sv">Ska</dcterms:priority>
	<dcterms:proof xml:lang="sv">Genom att svara Ja i anbudssvaret</dcterms:proof>
	<dcterms:publisher rdf:resource="https://example.com/publisher1"/>
	<dcat:distribution rdf:resource="https://example.com/distribution1"/>
	<dcat:contactPoint rdf:resource="https://example.com/contactpoint1"/>
</dcat:Dataset>
<dcat:Distribution rdf:about="https://example.com/distribution1">
	<dcat:accessURL rdf:resource="http://example.com/api"/>
	<dcat:accessService rdf:resource="https://example.com/dataservice1"/>
</dcat:Distribution>
<vcard:Organization rdf:about="https://example.com/contactpoint1">
	<vcard:fn>Exempelorganisation</vcard:fn>
	<vcard:hasEmail rdf:resource="mailto:oppnadata@example.com"/>
</vcard:Organization>
<dcat:DataService rdf:about="https://example.com/dataservice1">
        <dcterms:title xml:lang="sv">Exempel API</dcterms:title>
        <dcat:endpointURL rdf:resource="http://example.com/api"/>
</dcat:DataService>
</rdf:RDF>

Hur ser det ut för nästa krav? Hur nestar jag in kravlistan?

Jag vet ju hur jag skulle gjort med JSON eller YAML. Kan se hur det kontinuerliga arbetet med katalogen kan hämmas av det "omständiga"/pratiga formatet, även om jag förstår syftet.

davidlars

<kravkatalog.yaml>
...

catalog: "https://example.com/catalog1"
  - title: "kravkatalog"
    description: "Kravkatalog för IT-upphandlingar"
    publisher: "https://example.com/publisher1"
osv...
dataset:
  - id: "0012"
    group: "Loggning"
    title: "Loggning av åtkomst"
    description: "Loggning ska ske av åtkomst till lösningen"
    priority: "Ska"
    osv: ...
  - id: "0013"
    group: "..."
    title: "..."
    description: "..."
    priority: "..."
    osv: ...
  - id: "0014"
    group: "..."
    title: "..."
    description: "..."
    priority: "..."
    osv: ...

davidlars

...Om det inte var tydligt redan så gillar jag att ställa korkade frågor på internet. Nu läste jag vägledningen igen och jag missförstod uppenbarligen första genomläsningen.
Metadata: RDF-format
Data: JSON eller liknande

Korrekt?

Och eftersom att YAML är ett subset av JSON så skulle vi kunna köra något i stil med mitt YAML-exempel.
Hm.. eller JSON-LD, JSON för länkad data.

Maria Söderlind

@davidlars ser att du säger att du sett Umeås dataportal, men har du sett vår datamängd med upphandlingskrav? Tänker att det kanske är den infon du efterfrågar från oss. Här får du i vilket fall länk till där du kan ladda ner dem: [https://opendata.umea.se/explore/dataset/icke-funktionella-exempelkrav0/export/?sort=krav_id](link url)
Och här finns ett API om du föredrar det: [https://opendata.umea.se/explore/dataset/icke-funktionella-exempelkrav0/api/?sort=krav_id](link url)
Diskussionen om Wikidata hade inget att göra med den datamängden så du har helt rätt i att den inte bidrar ngt kring just detta

davidlars

@Maria-Söderlind
Tack, precis vad jag borde ha letat efter men av någon anledning inte letade efter!

davidlars

@Maria-Söderlind
Var bor er masterdata någonstans? Hur ser gränsnittet ut för de som matar in nya krav eller ändrar i kraven? Excel?

Community på Sveriges dataportal

API:fiera kravkatalog för upphandling. Erfarenheter?

Status