SAD: Utökning av HR-data till SDA

Status: Approved

Datum: 2026-01-23

Författare: Alex Exempel

Granskare: Arkitekturgruppen, Arkitekturrådet

Version (valfri): 1.0

---

Sammanfattning [Obligatorisk]

Lösningen utökar HR-data från SuccessFactors till SDA för att möjliggöra bättre rapportering och datadrivna beslut. Utökningen bygger vidare på befintlig integrationsmodell och lägger till nya HR-objekt via SHCMS och Logic Apps. Målet är att minska manuell handpåläggning, förbättra datakvalitet och skapa bättre underlag för verksamhetsnära uppföljning.

Bakgrund [Obligatorisk]

Affärsbehov

Samhall behöver målgruppsanpassade rapportpaket och bättre beslutsunderlag kopplat till medarbetares utveckling, förmåga och övergångar.

Nuläge

HR-data finns utspridd i flera system, vilket gör rapportering tidskrävande och svår att kvalitetssäkra. Befintliga endpoints för HR-data i SHCMS täcker endast delar av behovet.

Målbild

Relevant HR-data finns tillgänglig i SDA på ett enhetligt sätt, med tydligt ägarskap och spårbar informationshantering. Rapporter kan produceras snabbare och över tid kombineras med fler datadomäner.

Koppling till befintliga CAD-dokument [Obligatorisk vid behov]

Finns koppling till CAD?

• [x] Ja
• [ ] Nej

Om ja, dokumentera:

CAD-dokument	Typ av koppling	Påverkan på denna SAD
Tidigare CAD/SAD för HR-data till SDA	Bygger vidare på	Utökade objekt, nya endpoints och förtydligad informationsmodell

Omfattning [Obligatorisk]

Ingår

• Utökning av HR-dataobjekt från SuccessFactors till SDA
• Nya eller justerade endpoints i SHCMS för objektgruppering
• Integration via Logic Apps till SDA Data Lake Storage
• Rapportering i Power BI baserat på utökad datamängd

Ingår ej

• Omskrivning av historisk HR-data i källsystem
• Ny integrationsplattform utanför etablerad målarkitektur
• Omfattande förändring av källsystemets datamodell

Viktiga avgränsningar

• Eventdriven hämtning används där möjligt, annars schemalagd körning
• Informationsklassning är intern och hanteras enligt gällande policy

Arkitekturdiscipliner [Obligatorisk]

Enterprisearkitektur

Bidrag i denna lösning:

Lösningen stärker Samhalls mål om datadriven styrning genom att göra HR-information tillgänglig i central analysplattform. Den ligger i linje med befintlig målarkitektur för dataförsörjning till SDA.

Viktiga beslut/avvägningar:

• Bygga vidare på etablerat integrationsmönster istället för ny plattform

Verksamhetsarkitektur

Bidrag i denna lösning:

Rapportering för HR och verksamhetsledning blir mer tillgänglig och mindre beroende av manuell sammanställning. Förvaltning och beställning av nya rapportbehov kan hanteras mer strukturerat.

Viktiga beslut/avvägningar:

• Prioritera rapportbehov med högst verksamhetsnytta i första leverans

Verksamhetsprocess (BPMN-liknande i Mermaid)

flowchart LR
  subgraph L1["HR och verksamhet"]
    H1["Identifiera rapportbehov"]
    H2["Formulera databehov och syfte"]
    H3{"Godkänd prioritering?"}
  end

  subgraph L2["Arkitektur och utveckling"]
    A1["Bedöma påverkan på arkitektur"]
    A2["Implementera endpoint- och integrationsförändringar"]
    A3["Publicera data i SDA"]
  end

  subgraph L3["Analys och förvaltning"]
    F1["Bygga/uppdatera Power BI-rapporter"]
    F2["Följa upp nytta och datakvalitet"]
    F3{"Nytt behov uppstår?"}
  end

  H1 --> H2 --> H3
  H3 -- Ja --> A1 --> A2 --> A3 --> F1 --> F2 --> F3
  H3 -- Nej --> F2
  F3 -- Ja --> H1
  F3 -- Nej --> F2

Informationsarkitektur

Bidrag i denna lösning:

Nya informationsobjekt som Course, Abilities, Education, Certificate, ProfessionalCompetence, WorkExperience, Language och TransitionCycle görs tillgängliga i SDA. Informationsägarskap och klassning är tydliggjord för att stödja säker användning.

Viktiga beslut/avvägningar:

• Objekt grupperas i tydligare endpoint-struktur för bättre begriplighet och återanvändning

Informationsobjekt (från SAD-underlag)

Objekt	Exempel på attribut
Person	employmentNumber
Course	id, name, status, type, completed
Education	id, specialization, level, startDate, endDate
Certificate	id, name, fromDate, toDate
Abilities	id, name, validToDate
ProfessionalCompetence	id, role, rating, validToDate
WorkExperience	id, role, mainWorkTask, startDate, endDate
Language	id, name, level
TransitionCycle	id, event, eventReason, transitionStartDate, transitionEndDate

Informationsmodell (Mermaid)

classDiagram
  class Person {
    int employmentNumber
  }
  class Course {
    int id
    string name
    string status
    string type
    date completed
  }
  class Education {
    int id
    string specialization
    string level
    date startDate
    date endDate
  }
  class Certificate {
    string id
    string name
    date fromDate
    date toDate
  }
  class Abilities {
    int id
    string name
    date validToDate
  }
  class ProfessionalCompetence {
    int id
    string role
    string rating
    date validToDate
  }
  class WorkExperience {
    int id
    string role
    string mainWorkTask
    date startDate
    date endDate
  }
  class Language {
    int id
    string name
    string level
  }
  class TransitionCycle {
    int id
    string event
    string eventReason
    date transitionStartDate
    date transitionEndDate
    boolean employeeDialogCompleted
  }

  Person "1" --> "0..*" Course : has
  Person "1" --> "1" Education : has
  Person "1" --> "1..*" Certificate : has
  Person "1" --> "0..*" Abilities : has
  Person "1" --> "0..*" ProfessionalCompetence : has
  Person "1" --> "0..*" WorkExperience : has
  Person "1" --> "1..*" Language : has
  Person "1" --> "0..*" TransitionCycle : has

Lösningsarkitektur

Bidrag i denna lösning:

Tre huvudkomponenter samverkar: SHCMS (API), Logic Apps (integration) och SDA/Power BI (lagring och konsumtion). Lösningen stödjer både eventdrivet och schemalagt flöde beroende på tekniska förutsättningar.

Viktiga beslut/avvägningar:

• Hybridmönster för informationsflöde för att säkra robust leverans även när events saknas

Mjukvaroarkitektur

Bidrag i denna lösning:

API-kontrakt tydliggörs genom ny endpoint-struktur i SHCMS. Lösningen minskar monolitisk utveckling i befintlig person-endpoint och förbättrar underhållbarhet.

Viktiga beslut/avvägningar:

• Dela upp endpoint-ytan i domännära grupper istället för att fortsätta växa en generell endpoint

Infrastrukturarkitektur

Bidrag i denna lösning:

Lösningen nyttjar befintlig molnbaserad plattform för integration, lagring och analys. Driftbarhet och återställningsförmåga bygger på etablerade mönster i SDA-plattformen.

Viktiga beslut/avvägningar:

• Återanvända etablerad infrastruktur för snabbare införande och lägre driftkomplexitet

Avstämning mot 9 arkitekturprinciper [Obligatorisk]

Princip	Status (Ja/Delvis/Nej/N/A)	Kort motivering
1. Digitalisering först	Ja	Manuell rapportsammanställning ersätts av automatiserade flöden
2. Ett datadrivet Samhall	Ja	HR-data görs tillgänglig för analys och uppföljning i SDA
3. Designa utifrån verksamhetsperspektiv	Ja	Lösningen utgår från verksamhetens rapportbehov
4. Informationssäkerhet	Ja	Klassning, dataskydd och spårbar hantering är definierade
5. Informationsdelning	Ja	Data exponeras via API och delas till analysplattformen
6. Gemensam terminologi och definitioner	Delvis	Begrepp är definierade för objekten, fortsatt harmonisering behövs över domäner
7. Återanvänd före köp, köp före bygg	Ja	Befintliga plattformskomponenter återanvänds
8. Viktiga komponenter centraliseras	Ja	SDA och integrationskomponenter används som gemensamma byggblock
9. Drift i molnlösningar	Ja	Lagring och integrationsflöden ligger i Samhalls molnmiljö

Lösningsarkitektur [Obligatorisk]

Översikt

HR-data hämtas från SuccessFactors via SHCMS-endpoints, orkestreras i Logic Apps och levereras till SDA Data Lake för rapportering i Power BI.

Översiktsdiagram (Mermaid)

flowchart LR
  SF["SuccessFactors"] --> SHCMS["SHCMS API"]
  SHCMS --> LA["Logic Apps"]
  LA --> DL["SDA Data Lake"]
  DL --> PBI["Power BI"]

Huvudkomponenter

Komponent	Syfte	Ansvar	Teknologi
SHCMS API	Exponera HR-objekt	Datatillgänglighet och kontrakt	API-plattform
Logic Apps	Hämta och transportera data	Integration och flödesstyrning	Azure Logic Apps
SDA Data Lake + Power BI	Lagra och konsumera data	Analys och rapportering	Data Lake, Power BI

Integrationer

SuccessFactors är primär källa. SHCMS tillgängliggör objekt via endpoints. Logic Apps hämtar data via eventdrivet mönster där möjligt, annars schemalagt.

Data- och informationsflöden

Flödet går från SuccessFactors till SHCMS, vidare till Logic Apps och därefter till SDA Data Lake. Power BI läser kuraterat data för rapporter och analys.

sequenceDiagram
  participant SF as SuccessFactors
  participant SHCMS as SHCMS API
  participant LA as Logic Apps
  participant DL as SDA Data Lake
  participant PBI as Power BI

  SF->>SHCMS: Publicerar/uppdaterar HR-objekt
  LA->>SHCMS: Hämtar objekt (event eller schema)
  SHCMS-->>LA: Returnerar objektsdata
  LA->>DL: Skriver data till lake-lagring
  PBI->>DL: Läser kuraterat data
  DL-->>PBI: Levererar dataset för rapportering

Säkerhetsöversikt

Data hanteras med spårbarhet, tydligt ägarskap och klassning för intern användning. Personkopplade uppgifter begränsas utifrån syfte och åtkomstbehov.

Säkerhet och regelefterlevnad [Obligatorisk]

Säkerhetskrav och kontroller

Område	Krav	Vald kontroll/åtgärd	Ansvar
Åtkomst	Endast behöriga roller får tillgång till data	Rollbaserad åtkomst i integrations- och analyslager	Plattformsteam + dataägare
Dataskydd	Data ska lagras och hanteras enligt policy	Klassning, skydd i lagring och styrd åtkomst	Informationsägare + säkerhetsfunktion
Spårbarhet	Förflyttning och behandling ska kunna följas upp	Loggning i integrationsflöden och plattform	Integrationsteam + drift

Kvarstående säkerhetsrisker

Risk finns att datakvalitet och begreppstolkning varierar mellan källor. Risk hanteras genom uppföljning, datakvalitetskontroller och successiv harmonisering.

Tekniska val [Obligatorisk]

Område	Val	Motivering
Integration	Logic Apps	Etablerat mönster med låg införanderisk
Dataexponering	SHCMS-endpoints	Tydlig ansvarsfördelning och kontrollerade kontrakt
Lagring/analys	SDA Data Lake + Power BI	Central plattform för rapportering och vidare analys

Risker och begränsningar [Obligatorisk]

Risk	Sannolikhet	Påverkan	Mitigering
Ojämn datakvalitet i källdata	Medel	Hög	Datakvalitetsregler och uppföljning med dataägare
Otydlig begreppsanvändning mellan domäner	Medel	Medel	Gemensam terminologi och dokumenterade definitioner
Eventstöd saknas för vissa objekt	Hög	Låg	Schemalagd hämtning som fallback

Alternativa lösningar [Obligatorisk]

Alternativ	Fördelar	Nackdelar	Varför inte valt
Endast eventdrivet	Lägre latency, mer realtid	Stöd saknas för vissa objekt	För hög risk för ofullständigt flöde
Endast schemalagd	Enkel driftmodell	Lägre aktualitet i data	Sämre där event är möjligt och lämpligt
Hybrid (valt)	Robust och flexibel leverans	Något högre komplexitet	Bäst balans mellan kvalitet och genomförbarhet

Relaterade dokument [Obligatorisk]

• Arkitekturprinciper
• SAD-template
• Utredningar
• Standards

Valfria fördjupningar [Valfritt]

Bilagor

• Datamodell och flödesdiagram från beslutsunderlag
• Beslutsprotokoll från arkitekturråd

Versionshistorik

Version	Datum	Förändring	Författare
0.1	2025-10-02	Första utkast	Alex Exempel
1.0	2026-01-23	Första version	Alex Exempel