Uppdaterad dokumentation 20220914
-
Mina ärenden har uppdaterat delar av lösningsdokumentationen för byggblocket. För att hålla arbetet transperent och göra det enklare att förstå vilka ändringar som gjorts kommer vi att löpande skapa inlägg här på Dataportalens community i samband med att dokumentationen uppdateras/förändras.
Om du som läser detta har några frågor så är du välkommen att skriva de i denna tråd.
Förändringar
2022-09-14
Tjänstebeskrivning
- Indata ska skickas i body till POST-anrop istället för GET. Skälet till ändringen är att möjliggöra kryptering av t.ex. personnummer som anses vara extra skyddsvärda personuppgifter.
- Två nya indataparametrar "kund.identifierare" och "kund.typ" ersätter tidigare "kund". Syftet är att möjliggöra för fler typer av identifierare än personnummer och organisationsnummer
Verksamhetsguide
- Nytt avsnitt i kapitel 1 med rubriken "Kundsituation" har tillkommit som närmare beskriver begreppet och kundsituationsperspektivet.
- Nytt avsnitt i kapitel 2 med rubriken "Mappning från kundärende till producentärenden".
- Ändrad utformning av avsnittet "Kundhändelser och hur du formulerar dem (mikrocopy)" i kapitel 3 i syfte att göra det mer lättläst.
- Nytt innehåll i kapitel 4 med exempel på hur kundhändelser kan användas i gränssnitt i tjänst hos en Konsument.
- Mindre språkliga justeringar
Begreppsmodell
- En begreppsmodell har publicerats i PDF-format. Ambitionen är att göra begreppsmodellen tillgänglig i ett mer lämpligt format framöver.
Enkel Kundhändelsetjänst
- Uppdaterad enligt senaste tjänstebeskrivning (sker inom kort)
-
@johantjader skapa något så saker hänger ihop typ en kategori med ärendenummer eller helpdesk id
En diskussionsgrupp har sina brister....
- gärna ha unika id:n för varje ändring så blir det enklare att referera till dom....
ex.
2022-09-14-1 Indata ska skickas.....
2022-09-14-2 Två nya indataparametrar.....GET vs. POST
Skall Wikidata använda saker som källa funkar inte POST se problem med SCB Regina
-
@johantjader Tack Johan!
Välkommen hit! -
@Magnus-Sälgö Bra synpunkter. Lägger till ID för varje förändring så det går att hänvisa till så får vi utvärdera längs vägen om det här är ett bra sätt eller om det ska justeras mer.
Ang. GET vs POST
Intressant synpunkt. Skulle du kunna utveckla vad du ser för användningsområde mellan Wikidata och kundhändelser (Mina ärenden)? -
--Uppdaterat med ID--
Mina ärenden har uppdaterat lösningsdokumentationen för byggblocket. För att hålla arbetet transperent och göra det enklare att förstå vilka ändringar som görs kommer vi att löpande skapa inlägg här på Dataportalens community i samband med att dokumentationen uppdateras/förändras.
Du hittar Mina ärendens lösningsdokumentation på Sveriges dataportal.
Om du som läser detta har några frågor så är du välkommen att skriva de i denna tråd.
Förändringar
ID Vart Beskrivning 2022-09-14-01 Tjänstebeskrivning Indata ska skickas i body till POST-anrop istället för GET. Skälet till ändringen är att möjliggöra kryptering av t.ex. personnummer som anses vara extra skyddsvärda personuppgifter. 2022-09-14-02 Tjänstebeskrivning Två nya indataparametrar kund.identifierareochkund.typersätter tidigarekund. Syftet är att möjliggöra för fler typer av identifierare än personnummer och organisationsnummer.2022-09-14-03 Verksamhetsguide Nytt avsnitt i kapitel 1 med rubriken "Kundsituation" har tillkommit som närmare beskriver begreppet och kundsituationsperspektivet. 2022-09-14-04 Verksamhetsguide Nytt avsnitt i kapitel 2 med rubriken "Mappning från kundärende till producentärenden". 2022-09-14-05 Verksamhetsguide Ändrad utformning av avsnittet "Kundhändelser och hur du formulerar dem (mikrocopy)" i kapitel 3 i syfte att göra det mer lättläst. 2022-09-14-06 Verksamhetsguide Nytt innehåll i kapitel 4 med exempel på hur kundhändelser kan användas i gränssnitt i tjänst hos en Konsument. 2022-09-14-07 Verksamhetsguide Mindre språkliga justeringar. 2022-09-14-08 Begreppsmodell En begreppsmodell har publicerats i PDF-format. Ambitionen är att göra begreppsmodellen tillgänglig i ett mer lämpligt format framöver. 2022-09-14-09 Enkel kundhändelsetjänst Uppdaterad enligt senaste tjänstebeskrivning (sker inom kort) @johantjader sa i Uppdaterad dokumentation 20220914:
Mina ärenden har uppdaterat delar av lösningsdokumentationen för byggblocket. För att hålla arbetet transperent och göra det enklare att förstå vilka ändringar som gjorts kommer vi att löpande skapa inlägg här på Dataportalens community i samband med att dokumentationen uppdateras/förändras.
Om du som läser detta har några frågor så är du välkommen att skriva de i denna tråd.
Förändringar
2022-09-14
Tjänstebeskrivning
- Indata ska skickas i body till POST-anrop istället för GET. Skälet till ändringen är att möjliggöra kryptering av t.ex. personnummer som anses vara extra skyddsvärda personuppgifter.
- Två nya indataparametrar "kund.identifierare" och "kund.typ" ersätter tidigare "kund". Syftet är att möjliggöra för fler typer av identifierare än personnummer och organisationsnummer
Verksamhetsguide
- Nytt avsnitt i kapitel 1 med rubriken "Kundsituation" har tillkommit som närmare beskriver begreppet och kundsituationsperspektivet.
- Nytt avsnitt i kapitel 2 med rubriken "Mappning från kundärende till producentärenden".
- Ändrad utformning av avsnittet "Kundhändelser och hur du formulerar dem (mikrocopy)" i kapitel 3 i syfte att göra det mer lättläst.
- Nytt innehåll i kapitel 4 med exempel på hur kundhändelser kan användas i gränssnitt i tjänst hos en Konsument.
- Mindre språkliga justeringar
Begreppsmodell
- En begreppsmodell har publicerats i PDF-format. Ambitionen är att göra begreppsmodellen tillgänglig i ett mer lämpligt format framöver.
Enkel Kundhändelsetjänst
- Uppdaterad enligt senaste tjänstebeskrivning (sker inom kort)
-
@johantjader sa i Uppdaterad dokumentation 20220914:
@Magnus-Sälgö Bra synpunkter. Lägger till ID för varje förändring så det går att hänvisa till så får vi utvärdera längs vägen om det här är ett bra sätt eller om det ska justeras mer.
Ang. GET vs POST
Intressant synpunkt. Skulle du kunna utveckla vad du ser för användningsområde mellan Wikidata och kundhändelser (Mina ärenden)?Jag är nog ute och cyklar igen trodde du pratade om det API framework som togs fram av @jonass
Sorry
-
@Magnus-Sälgö Ingen fara. Vi uppskattar all input så delta gärna i fortsatta diskussioner så får vi på sikt förhoppningsvis fram en standard för ärendeåterkoppling från det offentliga som möter upp de behov och förutsättningar som finns därute
-
Forked by
Maria_Dalhage
-
Bra input, här kommer ett tråkigt svar men vi är begränsade kring val av verktyg i dagsläget till de . Självklart ska dock se hur vi kan göra vårt arbete ännu mer transperent och inbjudande till samskapande. Tänker att vi kan lägga upp den road map som vi jobbar efter här på Communtyt så snart den är förankrad med samverkande myndigheter.
Har någon av er haft möjlighet att ta del av den dokumentation vi lagt upp och har ni några spontanta synpunkter på innehållet?
-
@johantjader Jag skulle nog ändå råda er att se över om det verkligen är nödvändigt att använda HTTP POST för läsoperationer. Tänker att HTTPS är grunden för en säker kommunikation och det viktigaste, och sedan går det alltid går att undvika att logga hela förfrågnings-URL. Sen finns det andra småtips som "Referrer hiding" etc. Kan säkert finnas fog för valet. Men att bryta mot grundläggande principer om hur internet är uppbyggt bör noga övervägas, små beslut tenderar till att leda till problem med interoperatbilitet om flera gör olika i dessa frågor.
-
Forked by
DIGG_admin
-
Sen har jag en metapoäng om att namnet "mina ärenden" är något förvirrande. Jag får mer känslan av att byggblocket hanterar "Mina Notifieringar". Kanske inte är önsvärt att ändra det såklart. Men när jag läser dokumentationen så får jag förhoppningen om att nu äntligen kommer ett förslag på det "slutgiltiga" schemat och begreppsmodell för hur en myndighet bör representera informationsmängden ärende.
-
@jonass
Hej Jonas! Schema och begreppsmodell för hundratals autonoma offentliga aktörer på verksamhetsprocessområdet är en rejäl utmaning. Håller helt med om att det skulle ha varit bra om det fanns. Vi har avgränsat oss till ärendeåterkoppling och tror det finns ett stort värde att hämta om offentliga aktörer kan mappa sina processer till standraden och tillgängliggöra sk. kundhändelser, då det ger ökan insyn och kontroll för den det berör. Här ligger fokus initialt och vi tror det kommer vara ett minst sagt omfattande arbete att ensa på ärendeåterkopplingsområdet. Det skulle kunna vara en början på det du efterfrågar, det får tiden utvisa. Håller också med om att namnet Mina ärenden kan vara missvisande, vi tar med oss den. -
@jonass Hej Jonas
Ja du har rätt, detta bryter mot grundläggande REST-principer, vilket i sig är ett problem.
Men att exponera personnummer är också ett problem som till en början kan tyckas vara lite banalt. Men vi vill att standarden för Mina ärenden skall kunna användas i många verksamheter och därför måste vi tänka lie kring de värsta fallen. I vissa fall av offentlig förvaltning bara vetskapen om att någon frågar om en viss person till en viss producent ett säkerhetshål. Till exempel kan man tänka sig att vetskapen om att många frågor ställs till en viss kommun om en person med skyddad identitet säger någonting om var denna person befinner sig. Eller att vetskapen om att frågor ställs om en viss person till en specifik vårdinrättning (cancerbehandling, könsbyte etc) exponerar information om personens medicinska hemligheter.
Så här behöver vi välja mellan två dåliga alternativ. Antingen bryta mot REST-principer och komplicera lösningen eller potentiellt exponera skyddsvärd information. I den sammanvägda bedömningen har vi landat i att skyddet är viktigare än principerna i detta fall och därför har vi ändrat till POST.
-
@Jakob-Fransson Många projekt börjar med för stora omfång och kommer aldrig till det konkreta. Att som ni börjar med att leverera något konkret och avgränsat är ju en viktigt för att det ska bli något vettigt. Så det var inte kritik. Snarare så kanske "mina ärenden" har en solid strategi. Kommer någon myndighet att göra ett formellt åtagande att börja använda det ni kommer fram till? Tänker att någon måste vara först ut.
-
@Fredrik-Ferm Tror många med er resonerar på liknande sätt. Delar er riskbedömning, men jag är inte helt övertygad att åtgärderna behöver vara att lämna GET.
-
@jonass Hej Jonas
Vi tolkade det som inte kritik och vi håller med dig till 100% tror det är en framgångsfaktor att avgränsa sig och våga testa att vara så konkret det går - även om det gör ont eller inte att allt inte riktigt hänger hop.Först ut är Skatteverket som siktar på att ha ett kundhändelse-API i produktion v.44. Vi kommer lägga ut mer information om det inom kort.
Sen håller vi på att starta upp piloter med ett antal olika kommuner på bygglovsområdet. Intressant där är att verksamhetsprocessen "söka bygglov" är i stort likadan i varje enskild kommun vilket skapar en del nya utmaningar som vi vill lära oss mer om.
Därutöver håller några av myndigheterna som har koppling till verksamt.se att jobba med kundhändelser - dels att generera ärendeåterkopplingen och dels att göra informationen tillgänglig på ett standardiserat sätt.
Skjut gärna på med mer inspel och fortsätt följa Mina ärenden, vi är fortfarande i en utvecklande fas där all input är uppskattad
-
@johantjader är det nån kommun från Stockholmsregionen som ska vara med i piloten kring bygglov?
-
@Jonas-Nordqvist
Hej Jonas
Värmdö är med på piloten tillsammans med Boverket och så ser vi också ut att få med en norrlandskommun på den här första kommunpiloten.Men vi söker fler piloter och ser gärna att fler kommuner sätter sig in i de lösningar som vi håller på att ta fram för att se vad som fungerar bra och mindre bra. Har du spontant förslag på någon/några kommuner som skulle kunna vara intresserade eller forum där vi skulle kunna nå ut med att berätta närmare om initiativet Mina ärenden?
-
@johantjader sa i Uppdaterad dokumentation 20220914:
Har du spontant förslag på någon/några kommuner som skulle kunna vara intresserade eller forum där vi skulle kunna nå ut med att berätta närmare om initiativet Mina ärenden?
Ja, det har jag. Kontakta mig på jonas.nordqvist@storsthlm.se
-
@Jonas-Nordqvist Du har mail
-
@Fredrik-Ferm
Jag instämmer i @jonass tankar och det är synd att ett behov av att bryta mot REST finns. Men ser att detta iaf stämmer väl överens med vad som står angivet i den tekniska dokumentationen för Mina Ärenden på skatteverket (https://skatteverket.entryscape.net/store/9/resource/1667) och det är det absolut viktigaste. Att samtliga myndigheters ärenden/händelser och api:er för dessa fungerar likadant
Sen svider det alltid lite i själen när avsteg från väletablerade mönster behöver göras
Ska försöka följa det här forumet, superbra om ni kommer med information kring detta allt eftersom!
Vill någon eller några myndigheter/kommuner ha input tidigt, framför allt om det gäller företag, även på skiss-stadie så är det bara att höra av sig. Oftast mycket lättare att komma med konkret feedback när man har något att "ta" på.
Fredrik Axelsson Forsberg
/VISMA Spcs
