API:fiera kravkatalog för upphandling. Erfarenheter?

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?

Maria Söderlind

@davidlars jag är ju inte informationsägaren så jag är inte helt säker. Tror excel, men rekommenderar att du skickar frågan till den kontakt som anges i datamängden IFkrav@umea.se

tove

@Maria-Söderlind sa i API:fiera kravkatalog för upphandling. Erfarenheter?:

datamängd med upphandlingskrav?

@davidlars det var EXAKT denna kravlista jag satt och tittade på när vi diskuterade idag (men hade inte sett denna tråd). Men med tillägget hur man kan göra en sådan kravlista open source och community baserad. Där man beaktar icke-funktionella krav som kanske har annan review-gång än funktionella krav. Icke-funktionella krav från såväl lag som standarder och möjligt att filtrera utifrån bransch och målgrupp på systemet. Och där man kan koppla olika standarder till samma krav ex om ISO och NIST och eller GDPR i slutändan innebär samma krav.

De som är icke-kod kunniga ska kunna lägga till/föreslå ändringar i content & kommentera i ett web-interface, men som har versionshantering genom git (finns kommenteringssystem som hanterar kommentarer på det sättet).

Vi kan gå igenom det initiala diagrammet och flödena jag skissat på vid tillfälle.

tove

@davidlars sa i API:fiera kravkatalog för upphandling. Erfarenheter?:

@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?

Uppdaterar du oss om du får något svar om inmatning? Och hemvist för metadatan?

davidlars

@tove

"det var EXAKT denna kravlista jag satt och tittade på när vi diskuterade idag (men hade inte sett denna tråd)."

Jag misstänkte det Inget svar ännu ang hemvist för metadata och hur Umeå matar in detta. Men blir inte förvånad om det är Excel och att man extraherar datan i säg nattliga jobb inför publicering via API, CSV och JSON.

Jag gillar ju mitt YAML-exempel här i tråden men jag är inte de flesta.

Björn Hagström

@davidlars Hallå, kan du maila mig på bjorn@hagstrom.nu? Skulle vilja ta en lunch:)