• Hem
  • Kategorier
  • Senaste
  • Taggar
  • Populära
  • Användare
  • Grupper
Collapse
Dataportal logo

Community på Sveriges dataportal

Uppdaterad dokumentation (20221221) - version 3

Scheduled Fäst Låst Flyttad Mina ärenden
5 Inlägg 3 Posters 343 Visningar
    • Äldst till nyaste
    • Nyaste till äldst
    • Flest röster
Svara
  • Svara som ämne
Logga in för att posta
Det här ämnet har raderats. Endast användare med ämneshanterings-privilegier kan se det.
  • J Offline
    J Offline
    johantjader
    wrote on Senaste redigerad av johantjader
    #1

    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.

    Stefan WallinS Ett svar Senaste svaret
    2
  • Stefan WallinS Offline
    Stefan WallinS Offline
    Stefan Wallin
    replied to johantjader on Senaste redigerad av
    #2

    @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å.

    Senior systemutvecklare i privata sektorn (f.n. Iteam)

    J Ett svar Senaste svaret
    2
  • J Offline
    J Offline
    johantjader
    replied to Stefan Wallin on Senaste redigerad av
    #3

    @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! 🎄 🎆

    Stefan WallinS Ett svar Senaste svaret
    1
  • Stefan WallinS Offline
    Stefan WallinS Offline
    Stefan Wallin
    replied to johantjader on Senaste redigerad av
    #4

    @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

    Senior systemutvecklare i privata sektorn (f.n. Iteam)

    Nina_BerlinN Ett svar Senaste svaret
    1
  • Nina_BerlinN Offline
    Nina_BerlinN Offline
    Nina_Berlin
    replied to Stefan Wallin on Senaste redigerad av
    #5

    @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! 🌟

    CSN

    Ett svar Senaste svaret
    0

Finansieras av Europeiska unionen logo
  • Logga in

  • Har du inget konto? Registrera

  • Login or register to search.
  • Första inlägget
    Sista inlägget
0
  • Hem
  • Kategorier
  • Senaste
  • Taggar
  • Populära
  • Användare
  • Grupper
  • Logga in

  • Har du inget konto? Registrera

  • Login or register to search.