Design av integrationer
Inledning
Alla integrationer vi utvecklar inom Region Halland ska utgå från ett behov. Ett behov kan uppstå till exempel genom:
- Kundbehov
- Strategiska mål
- Regler och lagstiftning
- Förändringar i affärsvillkor eller teknik
Ett behov utmynnar sedan i en idé. För integrationer kommer dessa behov oftast att kanaliseras genom objekten. Om integrationsbehov uppkommer utanför objektens kännedom bör de redan på det här stadiet kanaliseras till objekten så att objekten blir delaktiga.
Designförslag
När ett behov föreligger behöver det konkretiseras. Detta sker för integrationer på två sätt, dels genom att designförslag tas fram, dels genom att relevant information börjar läggas in i Azure Devops.
Designförslaget ska innehålla följande information:
- Vilka applikationer och informationsmängder som är relevanta för integrationen.
- Vilka flöden, och riktningar de har, mellan inblandade applikationer.
- Vilka informationsmängder som är involverade samt vilka flöden dessa är associerade till.
- Hur informationsmängderna är uppbyggda.
- Vem eller vilka är ägare av de informationsmängder som berörs.
- Vilka datamängder kommer att skickas över integrationen.
- Hur säkerställs behörighetskontroll till de informationsmängder som hanteras.
- Vilken frekvens kommer data att skickas med.
- Hur triggas integrationen, tid eller händelse.
- Vilka endpoints, och vilken typ dessa är av, som finns tillgängliga för de involverade applikationerna.
- Vilken säkerhet finns på de endpoints som nyttjas för integrationen.
- Om de finns krav på att specifika meddelandeformat ska användas.
- Vidare behövs allmän information kring integrationen såsom krav på övervakning, 24/7-drift, spårbarhet, med mera framgå i designförslaget.
Nedanstående bild summerar vad som bör ingår i designförslaget.
Parallellt med designförslaget ska lämpliga uppgifter skapas upp i Azure DevOps. För integrationen som helhet ska en Feature skapas. Denna Feature ska ägas av det objekt som sedermera kommer att äga integrationen. För varje krav som sedan finns på integrationen ska en User Story per krav som finns för integrationen skapas. Samtliga User Stories ska vara kopplade till den övergripande Featuren som skapades för integrationen.
När designförslaget börjar bli klart ska det ske en Arkitekturgenomgång. Om designen av integrationen ligger i linje med de principer och riktlinjer som anges i detta dokument behövs ingen genomgång göras med Arkitekturrådet. Om designen av integrationen faller utanför dessa principer och riktlinjer ska en genomgång av integrationen hållas med Arkitekturrådet för att säkerställa att integrationen kan införlivas i Region Hallands digitala ekosystem.
När designen av integrationen är klar, alla uppgifter finns inlagda i Azure DevOps och en eventuell genomgång har hållits med Arkitekturrådet kan designförslaget gå vidare till utvecklingsstadiet. Detta gäller alla typer av integrationer, såväl direktintegrationer såsom integrationer som nyttjar en integrationsplattform.
Senast ändrad: