Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 23 Next »

Bemærk siden er under opdatering i forbindelse med STAR moderniseringsprojekt er igangsat

Det følgende beskrives den struktur som alle webservices der udstilles af DFDG opdelt efter i forhold STAR igangværende modernisering. Strukturen baserer sig på den logiske serviceopdeling i forretningsdomæner og er inspireret af microservice. Selve udruldningen sker i helt projektforløbet for moderniseringsprojektet se DFDG moderniserings og forretnings roadmap for serviceaftagere for eksterne og DFDG moderniseringsroadmap Version 0.6 - KUN INTERN for interne. 

Selve opdelingen følger nedenstående figur og for nærmere beskrivelse se Gennemgang af forretningsdomæner - STARs økosystem (Rebecca og Knud modellen)

Imens moderniseringen forgår vil de eksisterende DFDG service (også kaldet DFDG classic) løbende blive udfaset til fordel for de nye REST service. Parallelt med denne modernisering vil STAR forsætte den løbende forretningsudvikling i samspil med moderniseringen. For nærmere beskrivelse af dette se Transitionsprincipper for DFDG service.

Baggrunden for denne domæneopdeling er at opnå for en bedre understøttelse af forretningen, en mere enkelt og mere vedligeholdelsesbar systemportefølje, hvor ny/ændre forretning kan etableres hurtigt, effektivt og med minimal ricisi. En systemportefølje der er mere robust i drift og samtidig skalerbar i forhold til aftageres kaldemønstre. At STAR systemporteføljen lever op til anderkendte arkitekturstandarder og principper for offentelige it-løsning. For flere detaljer se Principper og baggrund for DFDF forretningsdomaæner og Forslag til DFDG principper.

Selvom STAR deler DFDG i en række interne forretningsdomæner, kan DFDG fra serviceaftager stadige betraktes som DFDG i samlet forretning.

Generelle regler for webservices i forretningsdomæner   

Følgende er overordnede regler for oprettelse af webservices:

  1. En webservice hører til et forretningsdomæne
    1. Kun undtagelsesvis kan der oprettes webservices der går på tværs af forretningsdomæner, disse skal oprettes som composite services i forretningsdomænet Komposit.
  2. En webservice vil typisk arbejde på en enkel entitet eller en lille gruppe at tæt knyttede entiteter. Navnet på webservicen skal beskrive hvilken hovedentitet der arbejdes med.
  3. En webservice skal understøtte de operationer eller actions der er behov for for at tilgå og behandle data, det kan være Create, Read, Update og Delete operationer eller forretningsoperationer der foretager en handling eller registrerer en hændelse (typisk actions).
    1. På den måde er de enkelte services komplette og selvstændigt afgrænsede.
  4. For hvert forretningsdomæne kan der efter behov oprettes status-webservices, der returnerer aktuel status for udvalgte forretningsområder under forretningsdomænet. 
  5. For hvert forretningsdomæne er der udstilling af kodelister anvendt i forbindelse med de forretningsdata der er ejet af domænet, disse kodelister er de primære kodelister der skal anvendes af serviceaftagerer
    1. Anvender forretningsdomæne kodelister til data de ikke ejer vil disse være sekundærer kodelister og vil følge indholdet af den primære kodeliste, serviceaftagerer behøver ikke at aftage disse kodelister.
  6. For hvert forretningsdomæne kan der efter behov oprettes regelservice, der returnerer et aktuel status forretningsregelsæt anvendt i forretningsdomænet. Serviceaftager kan anvende dette regelsæt i egen kode eller som reference ramme.
  7. Et forretningsdomæne kan udløse en puchbesked på ændringer fortaget via webservice eller anden  i de forretningsdata domænet ejer   

Status-services inden for et forretningsdomæne

For hvert forretningsdomæne (de områder illustreret i ovenstående figur) oprettes efter behov services indeholdende f.eks. status- eller metadata opslag. Status-service som returnerer nøgledata om personen eller virksomheden for hele forretningsdomænet samlet. Målet med disse domæne specifikke status-services er at give serviceaftager et hurtigt overblik over de registrerede data, så serviceaftager slipper for at hente data fra mange forskellige services for f.eks. at kunne tilpasse en brugergrænseflade til den aktuelle status.

En sådan domæne Status-services kan f.eks. indeholde data som aktuel ledighed, kontaktgruppe, startdato for ledighed, personkategori osv. Det kan også være statusflag eller nøgledata. Ønskes et fuldt datasæt skal disse data skal hentes fra de enkelte services getmetoder eller hvis historik også ønskes fra gethistorikmetoder.

Følgende er principper for status-webservices for borger eller virksomhed:

  1. Kan returnere nøgledata om en entitet, som id, subtype, revisionsdato
  2. Kan indeholde statusflag, der fortæller om borgers/virksomheds status/tilstand, eller et flag der indikerer om der kan hentes flere relevante data andet steds.
  3. Kan i begrænset omfang indeholde lister af aktuelle data, som f.eks. om borger har et aktuelt fravær
    1. Generelt bør sådanne ligge servicen der understøtter adgang til entiteten, f.eks. i fraværs servicen

Disse principper kan dog fraviges såfremt der som helhed giver en bedre understøttelse af borgeren og/eller sagsbehandlerens arbejdsgang og serviceaftager aftaler dette med STAR. 

De tværgående webservices er som følger:

Tværgående status-services

Tværgående status services

Regelservice

For hvert forretningsdomæne (de områder illustreret i ovenstående figur) oprettes efter behov services indeholdende regelmetadata. Regelmetadata-service returnerer forretningsregler som strukturerer data for givet delområde af forretningen f.eks. hvilke fravære der er lovlige for givne kontaktgruppe og personkategorier.

Eksempler på regelmetadata er:

  • Business rules
  • Data quality rules
  • Valid values for reference data (code lists,..)
  • Wikis
  • Collaboration software

Business rules:

Kodelister

For hvert forretningsdomæne (de områder illustreret i ovenstående figur) oprettes efter behov services indeholdende f.eks. status- eller metadata opslag. Status-service som returnerer nøgledata om personen eller virksomheden for hele forretningsdomænet samlet. Målet med disse domæne specifikke status-services er at give serviceaftager et hurtigt overblik over de registrerede data, så serviceaftager slipper for at hente data fra mange forskellige services for f.eks. at kunne tilpasse en brugergrænseflade til den aktuelle status.

Codelist:


Webservicebeskeder





  • No labels

Tilgængelighed: https://starwiki.atlassian.net/was