Uppdaterad dokumentation (20221221) - version 3
-
Mina ärenden har den 21 december 2022 uppdaterat 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
ID Vart Beskrivning 2022-12-21-01 Verksamhetsguide Språkliga justeringar och flyttat runt innehåll. Avsnittet om notifering har flyttats till kap. 5 "Kommunikationstaktik och kanalsamordning" 2022-12-21-02 Verksamhetsguide Uppdaterat språkguide med anledning av ändring av lösning för "referenser och mönster för tvåvägskommunikation" 2022-12-21-03 Tjänstebeskrivning Uppdatering med anledning av nytt angreppssätt för att tillgodose mönster för tvåvägskommunikation. Nytt informationsobjekt "referenser" har lagts till i Tjänstebeskrivning. 2022-12-21-04 Verksamhetsguide Mönster för tvåvägskommunikation beskrivs kap. 2 avsnitt "Mönster för tvåvägskommunikation - referenser" 2022-12-21-05 Tjänstebeskrivning Nytt attribut "version" i "kundhandelsResponse" som informerar vilken version av Mina ärenens standard som producenten implementerat 2022-12-21-06 Enkel kundhändelsetjänst Svaren i enkel kundhändelsetjänst har uppdaterats i enlighet med senaste versionen av Tjänstebeskrivning 2022-12-21-07 Kom igång med Mina ärenden En kom igång-guide som tagits fram utifrån de frågor och diskussioner som väckts i samband med att Värmdö kommun börjat sätta sig in i byggblocket Mina ärenden. Kom igång-guiden avser att ge stöd för hur en producent steg-för-steg kan närma sig området med att lämna ärendeåterkoppling på ett standardiserat sätt 2022-12-21-08 Prototyp Kundhändelsetypskatalog En första enkel prototyp för att bättre kunna kommunicera hur en kundhändelsetypskatalog kan utformas för att få input i den fortsatta utvecklinen. Behandlas i en separat tråd här på communityt. 2022-12-21-09 Versionshantering av Mina ärendens standard och Producenters API:er Dokument som beskriver Mina ärendens versionshantering och hur byggblocket förhåller sig till producenternas versionshantering. Det kan dröja till imorgon innan de nya versionerna och nya resurser "skördats" till dataportalen, vill man se dessa nu så går de hitta på Skatteverkets utvecklarportal.
I och med att vi genomför en förändring av Tjänstebeskrivningen som innebär att ett nytt informationsobjekt "referenser" tillkommer dit bl.a. attributet producentReferens och "konsumentReferens" läggs så blir detta en ny version av standarden för kundhändelser - version 3.
Är man intresserad av att ta del av tidigare versioner finns dessa samlade på dataportal Mina ärenden - Tidigare versioner
På dataportal.se finns senast uppdaterade dokumentation.
Övrig info:
- Skatteverket har tagit fram ett första kundhändelse-API som möjliggör för en användare att via en s.k. konsumenttjänst hämta kundhändelser från Skatteverket. API:et lanserades v.50 och bygger på Mina ärendens första standard (v.1). Läs mer om API:et på Skatteverkets utvecklarportal.
- Digg har publicerat byggblocksbeskrivningar för flera byggblock, inkl. Mina ärenden. De finns att läsa på Diggs webbplats.
Uppdaterade tråden m.a.a. vi lade till nytt dokument "Versionshantering av Mina ärendens standard och Producenters API:er" samt inte beskrivit nytt attribut "version" i Tjänstebeskrivning.
-
@johantjader varför väljer ni att publicera som ni gör och inte i ett diffbart format som exvis github/gitlab/gerrit(🤮)/bitbucket? Tänker att det skulle vara enklare att se de faktiska ändringarna då.
-
@Stefan-Wallin bra och relevant fråga!
När vi fick behov av att publicera och tillgängliggöra dokumentation och specifikationer så undersökte vi vilka möjligheter som stod till buds. På Skatteverket används idag ingen av de lösningar du nämner utan istället är det framförallt Utvecklarportalen som används och som sen skördas till Dataportalen.Vi ville inte skapa konton i eget (privat) namn på t.ex. Github av flera skäl, dels vill vi inte att det ska finnas någon tveksamhet vem som är avsändare (Skatteverket som byggblocksansvarigt), dels kommer det komma fler byggblock i Ena som har ungefär samma behov som BB Mina ärenden där man kommer vilja tillgängliggöra tekniska förmågor, tjänster, standardiserade modeller, ramverk och mönster enkelt, tillgängligt och med en fungerande versionshantering.
Vi tror att det bästa är att vi inom Ena tar ett större grepp kring frågan så att de lösningar som tas fram av vårt och andras byggblock blir enkelt och sammanhängande att både hitta och använda för tänkta användare.
Mot bakgrund av ovanstående valde vi att köra med det som fanns tillhands idag med Utvecklarportalen och medvetna om en del av de brister som ett sådant val medför. Viktigast för oss har varit att tidigt få vår dokumentation publik så det finns möjlighet för andra att ta del och tycka till. Med sagt så kvarstår dock ambitionerna att hitta bättre sätt framöver - helst på ett inom Ena enhetligt sätt
Trevlig fortsättning!
-
@johantjader Vad är ni rädda för? Att skapa en organisation på Github som heter Ena, bjuda in alla i byggblocken och börja publicera kan göras på 5 minuter. Skapa ett Repo för varje byggblock och kör. Blev det inte optimalt, ändra och förbättra, länka vidare från gamla repon, byter ni till gitlab/bitbucket eller vad helst annat, länka vidare i readmen.
Att ta större grepp är en enkel undanflykt för att inget göra istället för att successivt bygga upp processer.
I mina ögon har ni genom detta enda beslut brutit mot 3 av 4 ställningstagande i det agila manifestot.
- Individuals and interactions over processes and tools (ni verkar vara rädda för att privata utvecklare ska synas på github och få ett renommé )
- Working software over comprehensive documentation (Få ut dokumentationen och ändringarna tydligt läsbart)
- Customer collaboration over contract negotiation (Ta emot feedback på ett lämpligt sätt genom ex.vis PR, diskussioner i issues)
- Responding to change over following a plan
-
@Stefan-Wallin Jag skulle säga att @johantjader och hans team har tagit ställning enligt det agila manifestet på ett föredömligt sätt.
Individuals and interactions over processes and tools: När vi inte kan tillhandahålla processer och verktyg för dem, prioriterar de att få ut resultatet till oss med de verktyg och processer som står till buds idag.
Customer collaboration over contract negotiation: Trots att de vet att de kommer få kritik för formatet tycker de ändå att det är så viktigt att ha en dialog om sina resultat så de startar den i alla fall.
Kudos till @johantjader & Co, pionjärer är vad ni är!
Att ni väljer att dela med er sätter fingret på vilka verktyg och processer vi saknar, vilket är första steget på vägen att ta fram dem.
God Jul och Gott Nytt År!
