STS ORGANISATION 26. februar 2019
Indhold Baggrund og ophæng til rammearkitekturen Hvordan fungerer Organisation? Anvisninger til anvendelse af Organisation Guide til udlæsning af Organisation Dokumentation og vejledninger
BAGGRUND
Baggrund Støttesystemet Organisation er en implementering af OIO-standarden for Organisation v 1.1, som er en del af Sag og dokument standarderne. Standarden specificerer et interface til registrering og udveksling af organisations- og personaledata. Fra standarden v 1.1: Der findes typisk flere organisationssystemer i en organisation. Det betyder, at oplysninger om organisations- og personaledata skal vedligeholdes i en lang række systemer, det være sig lønsystemer, økonomisystemer, fagsystemer og ESDH-systemer. I praksis giver det anledning til stort vedligeholdelsesarbejde, usikkerhed omkring hvilke oplysninger der er de rigtige samt x antal ikke-standardiserede integrationer. Det er baggrunden for ønsket om en fælles standard for udveksling af informationer om organisations- og personaledata.
Karakteristika Fleksibel/kompleks informationsmodel Generelle egenskaber : Dobbelthistorik/Bitemporalitet på alle forretningsobjekternes relationer, tilstand og attributliste Fleksibelt/komplekst aktør-begreb Organistion, OrgEnhed, IT-system, Bruger, Interessefællesskab Datanært serviceinterface
HVORDAN FUNGERER INTEGRATIONEN?
Integration 1 Specialservice og 10 services med 8 operationer SF1500-OrganisationSystem SF1500-Organisation SF1500-OrganisationEnhed SF1500-OrganisationFunktion SF1500-Bruger SF1500-ItSystem SF1500-InteresseFaellesskab SF1500-Adresse SF1500-Person SF1500-Virksomhed SF1500-Myndighed
Hent data om et enkelt forretningsobjekt Operationen søg Søgning efter objekter der matcher specifikke søgekriterier. Der kan søges på kombinationer af attributter i informationsmodellen, dato-intervaller og med wildcards i tekstfelter. Søgeresultatet er en liste af referencer til objekter, dvs. UUID er på objekter der matcher søgekriterierne
Hent data om et enkelt forretningsobjekt Operationen Læs: Udlæsning af et enkelt objekt. Input er et enkelt UUID. Output er default et øjebliksbillede af forretningsobjektet pr dags dato Operationen List: Udlæsning mange objekter samtidig. Input er en liste af UUID er. Output er default et øjebliksbillede af forretningsobjekterne pr dags dato. I Læs og List kan der også returneres historik og registreringslog. Læs mere om historik og registreringslog i D.10.01 Fællesdokument for snitfladerne i Støttesystemerne
Hent data om kommunens organisatoriske hierarki Operationen Fremsøg Objekthierarki: Returnerer alle de OrgEnheder der indgår i et organisationshierarki. Input UUID eller navn på Organisation. Snitfladen returnerer både data fra Organisation og OrganisationEnhed forretningsobjekterne Resultatet pagineres med max 500 objekter ad gangen Korsbæk Kommune Korsbæk Kommune Ydelsescenteret Borgerservice Kontaktcenteret Kontanthjæl ps-teamet
Vedligehold et enkelt forretningsobjekt Opret: Opretter et nyt forretningsobjekt. Returnerer UUID for det oprettede objekt Ret: Opdaterer et forretningsobjekt Passiver: Ændrer et forretningsobjekts livscyklus til Passiveret Slet: Ændrer et forretningsobjekts livscyklus til Slettet Importer: Opdaterer et passiveret forretningsobjekt eller opretter et nyt forretningsobjekt.
Livscyklus for et Forretningsobjekt Læs mere i Generelle serviceegenskaber (juni 2011)
Importer organisatorisk hierarki Operationen Import Organisationssystem: Opdaterer passiverede OrgEnheder eller opretter Organisation og tilknyttede OrgEnheder. Output er UUID og ObjektType på alle oprettede eller opdaterede forretningsobjekter Der kan maksimalt importeres X objekter ad gangen Korsbæk Kommune Korsbæk Kommune Ydelsescenteret Borgerservice Kontaktcenteret Kontanthjæl ps-teamet
Bemærk Genindlæsning af forretningsobjekt 1) Passiver forretningsobjektet 2) Importer forretningsobjektet Bemærk at slettede forretningsobjekter ikke kan genindlæses eller rettes Fysisk sletning af f.eks. Personhenførbare data om en medarbejder Der er pt. ikke en webservice til fysisk sletning af data Bestil teknisk support fra KMD til sletning via KOMBITs ydelseskatalog
Historik og registreringslog Ud fra disse registreringer kan LÆS, LIST og FREMSØG operationerne returnere tre forskellige former for output: Snapshot = Øjebliksbillede viser, hvad der gælder om et objekt på et bestemt tidspunkt. Historik viser et objekts historik som det er kendt på et bestemt registreringstidspunkt. Registreringslog viser, hvad der er registreret på et objekt indenfor et registreringsinterval og virkningsinterval.
ANVISNINGER TIL STS ORGANISATION
LIDT BAGGRUND
Hvorfor har vi anvisninger? KORSBÆKS ORG DATA I STS ORGANISATION FAGSYSTEMERS FORRETNINGSBEHOV Læs Læs Læs SAPA KY KY Læs Kommunens løsninger
Hvorfor har vi anvisninger? KORSBÆKS ORG DATA I STS ORGANISATION FAGSYSTEMERS FORRETNINGSBEHOV Læs Læs Læs SAPA KY KY Læs Kommunens løsninger
Hvorfor har vi anvisninger? KORSBÆK ORG. KILDEDATA KORSBÆKS ORGANISATIONSLØSNING KORSBÆKS ORG DATA I STS ORGANISATION FAGSYSTEMERS FORRETNINGSBEHOV BRUGERE Læs SAPA AFDELINGER MEDARBEJDE RE ORGANISATIONS LØSNING Skriv Læs Læs KY KY ADRESSER Læs Kommunens løsninger
Hvorfor har vi anvisninger? KORSBÆK ORG. KILDEDATA KORSBÆKS ORGANISATIONSLØSNING KORSBÆKS ORG DATA I STS ORGANISATION FAGSYSTEMERS FORRETNINGSBEHOV COMPLIANCETEST BRUGERE Læs SAPA AFDELINGER MEDARBEJD ERE ORGANISATIONS LØSNING Skriv Læs Læs KY KY ADRESSER Læs Kommunens løsninger
Formål og målgruppe Formål Hjælpe kommuner og leverandører med at forstå hvordan kommunens data struktureres og udstilles i Organisation Målgruppe Leverandører af organisationsløsninger der skal skrive til Organisation Leverandører af fagsystemer der skal læse kommunens organisationsdata Kommunale it-arkitekter og it-teknikere der skal sikre af kommunens organistionsdata opfylder de krav KOMBIT stiller
HVAD INDEHOLDER ANVISNINGERNE?
FORRETNINGSOBJEKTER
Indeholder Beskrivelse af forretningsobjektet formål og anvendelse af objektet Forretningsobjektets attributter Forretningsobjektets relationer
Organisationsenhed - beskrivelse KOMBITs fortolkning af standarden for det enkelte forretningsobjekt KOMBITs anvendelse af forretningsobjektet
Organisationsenhed - attributter Navn Definition Regler for udfyldelse Datatype Eksempel BrugervendtNøgle Brugervendt identifikation af objektet. Attributten er obligatorisk i nuværende version og skal udfyldes med samme værdi som EnhedNavn. Attributten gøres optionel i næste version, da den fremadrettet ikke skal benyttes. Tekst(50) Borgerservice. EnhedNavn... Officielt navn på OrganisationEnhed... Attributten er obligatorisk Tekst(200) Borgerservice.........
Organisationsenheder - relationer Navn Definition Regler for udfyldelse Objekttype Registrerings mønster Adresser En OrganisationEnhed har relation til et antal adresser: Email, Telefon, EAN, Lokation, Kontaktadresse, URL, Postadresse, LOS Adresse, TelefonÅbningstid, KontaktAdresseÅbningstid, EmailÅbningstid, PostadresseReturpost jf. klassifikationen af adressetyper se afsnit 5.1.2.2. 0..n - 0..n Opgaver OrganisationEnhed har relation til et antal opgaver. De opgaver enheden skal udføre beskrives med relationen til en eller flere Klasser, der beskriver KLEopgaver. Angiver relation til de opgaver OrgEnheden er ansvarlig for. Der kan henvises til en gruppe, hvis OrgEnheden er ansvarlige for alle underliggende KLEområder. Klasse (KLE)
REGISTRERINGSMØNSTRE
Hvad er det? Logiske relationer mellem forretningsobjekter, der er relevante for fagsystemer der skal læse og anvende data i STS Organisation
To slags mønstre Obligatoriske mønstre Er mønstre der er nødvendige for at understøtte KOMBITs fagsystemer Kommunerne skal strukturere deres data efter de obligatoriske mønstre Anbefalede mønstre Er mønstre der understøtter lokale forretningsbehov i kommunernes egne fagløsninger Er anbefalede mønstre, men ikke et krav
DEN ADMINISTRATIVE ORGANISATION
Det forretningsmæssige behov - eksempler Fremsøge organisationshierarkiet i kommunens administrative organisation Opmærke sager og dokumenter med ansvarlig organisationsenhed i S&D Indekserne Organisationsenhed som dataafgrænsning i Adgangsstyring for brugere Kontaktoplysninger til breve
Eksempel - Korsbæk Kommune Korsbæk Kommune Tilhører Overordnet Korsbæk Kommune Ydelsescenteret Borgerservice Kontaktcenteret Kontanthjæl ps-teamet
Administrativ organisation med relation til Adresse-objektet Eksempel - Korsbæk Kommune Adresser Korsbæk Kommune Tilhører Overordnet Adresse <type> Skyttemarksvej 17 Korsbæk Kommune bs@korsbaek.dk 55771842 Ydelsescenteret Borgerservice Kontaktcenteret Kontanthjælpsteamet
Typeangivelse af organisationsenheder
OPGAVEFORDELING
Det forretningsmæssige behov - eksempler Fordeling af sager til ansvarlig Organisations-enhed Fordeling og post (scannet og e-mail) til ansvarlig Organisations-enhed
Korsbæk Kommune - opgavefordeling Korsbæk Kommune Korsbæk Kommune Tilhører Overordnet Opgaveansvarlig Ydelsescenteret Borgerservice 32.00.00 32.03 Kontaktcenteret Kontanthjælpsteamet KLE 32.06 KLE
ORGANISATORISK TILKNYTNING
Forretningsbehovet - eksempler Gør det mulig at fremsøge/udpege medarbejdere og ledere i organisationen Opmærke sager og dokumenter med ansvarlig sagsbehandler i Indekserne Berige oplysninger om en bruger ved log-in til fagsystem med Token
Tilknytning af medarbejdere og ledere Funktionstype: Enhedsrolle Enhedsrolle Medarbejdere (Løst koblet model) hj@kk.dk Hanne Jensen Kontanthjælpsteamet Ydelses medarbejdere ka@kk.dk Kjeld Andersen Org.enhed Org.Funk pn@kk.dk Peter Nielsen Bruger Person Leder Funktionstype: Lederrolle
UDLÆSNING AF DATA
Hvordan udlæses data om en medarbejder? Når medarbejderen logger på fagløsningen, ønsker vi at hente medarbejderens navn, BrugerId, Kontaktoplysninger og Organisatorisk placering Med de datanære webservices kræver det 5 kald til STS-Organisaton
Hent data om medarbejder 1. Bruger.Læs (UUID fra brugerens SAML-token) Medarbejderens bruger-id A. Reference til et Person objekt B. Referencer til Adresse objekter 2. Person.Læs (A) Medarbejderens navn Medarbejderens CPR nummer 3. Adresse.List(B) Den faktisk adresse-værdi (fx telefonnummeret, emailadressen, osv) 4. OrgFunktion.Søg(Bruger.UUID, Enhedsrolle) D. En liste af referencer til OrganisationFunktion objekter 5. OrgFunktion.List(D) E. Referencer til de OrgEnheder som medarbejderen er tilknyttet 6. OrgEnhed.List(E) Enhedens navn 6) 4, 5) 1) 2) 3) Enhedsrolle hj@kk.dk Hanne Jensen Kontanthjælpsteamet Ydelses medarbejdere ka@kk.dk Kjeld Andersen pn@kk.dk Peter Nielsen
Læs mere Vi udbygger løbende søgevejledninger, og lægger dem snarest ud i KOMBITs dokumentbibliotek. Der er også gode eksempler i D.10.01 Fællesdokument for snitfladerne i Støttesystemerne
GOVERNANCE
Governance processen FORRETNINGSBEHOV BEHANDLING REVIEW I FØLGEGRUPPE PUBLICERING
DOKUMENTATION OG VEJLEDNINGER
Dokumentation og vejledninger Dokument/produkter Indhold Link Produktblad for STS Organisation Giver en hurtig introduktion til STS Organisation med fokus på kommunens forretningsmæssige fordele ved at anvende STS Organisation Servicebeskrivelsen Her finder man end-points til hver af de services Organisation udstiller på Serviceplatformen Integrationsbeskrivelse Overordnet beskrivelse af Organisation Formål og forretnings-flow Snitfladebeskrivelse Beskrivelse af hver af de services Organisation udstiller Beskrivelse af de operationer der kan udføres på services Finder man her Finder man her Finder man her Vælg SF 1500 Finder man her Vælg SF 1500 Ligger i mappen bilag Teknisk beskrivelse Teknisk dokumentation Finder man her Vælg SF 1500 Anvisninger til anvendelse af STS Organisation Testdatasæt til Organisation Korsbæk Kommune Beskrivelse af hvordan STS Organisation skal anvendes for kommuner og leverandører Krav til registrering af data i Organisation Registreringsmønstre til understøttelse af forretningsmæssige behov hos fagsystemer Et testdatasæt modelleret efter Anvisninger til STS Organisation Kan anvendes til gennemførelse af Compliancetest Ligger i mappen Tekniske specs Finder man her Finder man her
Dokumentation og vejledninger Dokument/produkter Indhold Link Vejledning til ibrugtagning af STS Organisation servicesnitflade for leverandører der skal læse kommunens organisationsdata Vejledning til ibrugtagning af STS Organisation servicesnitflade for leverandører der skal skrive til Organisation Målgruppen er leverandører, der skal integrere til STS Organisation og som har behov for at udlæse de data kommunerne har registreret i STS Organisation. Vejledningen beskriver de opgaver, leverandøren skal løse for at få adgang til, og anvende, STS Organisation servicesnitflader. Målgruppen er leverandører, der skal integrere til STS Organisation og som har behov for at skrive til STS Organisation Vejledningen beskriver de opgaver, leverandøren skal løse for at få adgang til, og anvende, STS Organisation servicesnitflader. Finder man her Finder man her Testeksempler på kald til STS Organisation Indeholder xml eksempler på request og response til udvalgte services Finder man her Klassifikationer til STS Organisation Anvendte klassifikationer, herunder oversigt over UUID på Organisationsobjektet for hver kommune, funktionstyper, masterobjekttyper, relationsroller og relationsobjekttyper. Vi anbefaler at man først orienterer sig i Vejledning til anvendelse af interimsklassifikationer. Vejledningen giver et overblik over hvilke klassifikationer der findes og hvor de findes. Vejledning og oversigt over de enkelte klassifikationer findes Compliancetest Er kun relevant for leverandører af organisations-løsninger der skal synkronisere data til STS Organisation Beskriver det testforløb en leverandør skal igennem for at leverandørens løsning lever op til de krav KOMBIT stiller Finder man her Finder man her
Dokumentation og vejledninger Dokument/produkter Indhold Link Vejledning til Administrationsmodulet Beskriver hvordan du som leverandører registrerer dit it-system og hvordan du anmoder om en serviceaftale for at kunne anvende STS Organisation Link til Administrationsmodulet i ekstern test Giver dig adgang til at registrere dit it-system og anmode om serviceaftale for kunne anvende STS Organisation i KOMBITs testmiljø Link til STS Organisations brugergrænseflade i ekstern test Link til STS Organisations brugergrænseflade i produktionsmiljøet Giver adgang til at kunne se en kommunens organisationsdata i det eksterne testmiljø Kræver at kommunen har oprettet og tildelt en jobfunktionsrolle til leverandøren i kommunens IdP Giver adgang til at kunne se en kommunens organisationsdata i produktionsmiljøet Kræver at kommunen har oprettet og tildelt en jobfunktionsrolle til leverandøren i kommunens IdP Finder man her Finder med her Finder man her Finder man her Vejledning til token sikkerhed Beskriver hvilke opgaver leverandøren skal løse for at kalde STS Organisation med et token Finder man her
TUSIND TAK FOR I DAG!