APOS2 DWH Services
Forord Dette dokument er en del af APOS version 2 manualerne. APOS version 2 (APOS2 herefter) er et organisation, klassifikation og personale system baseret på Sag & Dokument standarderne. Dokument oversigt: APOS2 Bulk data import / export APOS2 Security APOS2 Installation, Operation and Monitoring APOS2 Service Catalogue APOS2 Data Models APOS2 Administration Guide Alle dokumenterne kan findes på: http://axapoint.com/ Dette dokument beskriver DWH Services tilgængelige i APOS2. Versioner Version Date Description 1.0.0 09/05/2012 Initial version 2
Indhold 1 Generelt om DWH services 4 1.0.1 Komponent opdelingen........................ 4 1.1 Kald af service metoder og respons...................... 4 1.1.1 URL opbygning............................. 4 2 Relationer og Egenskaber 6 2.1 OrganisationEnhed............................... 6 2.2 OrganisationFunktion............................. 6 3 Appendiks 8 3.1 Oversigt over Organisation.......................... 8 3.1.1 Organisation.............................. 8 3.1.2 OrganisationEnhed........................... 8 3.1.3 OrganisationFunktion......................... 8 3.1.4 Lokation................................. 9 3.1.5 Bruger.................................. 9 3.1.6 ItSystem................................ 9 3.1.7 Interessefaellesskab........................... 9 3.2 Oversigt over Klassifikation.......................... 10 3.2.1 Klassifikation.............................. 10 3.2.2 Facet.................................. 10 3.2.3 Klasse.................................. 10 3.3 Oversigt over Part............................... 10 3.3.1 Person.................................. 10 3.3.2 GeografiskAdresse........................... 10 3.3.3 KlassifikationKontaktkanal...................... 11 3
1 Generelt om DWH services 1.0.1 Komponent opdelingen Services er opdelt i komponenterne Organisation, Part og Klassifikation. Services på entiteter er således opdelt i den respektive komponenter de tilhører. Eks. OrganisationEnhedServiceDwhOIO er tilgængelig i Organisation komponenten, mens PersonServiceDwhOIO er tilgængelig i Part komponenten. 1.1 Kald af service metoder og respons Alle metoder kaldes med GET. Response er OIO XML og dermed valdieret med de offentlige XSD er. Der er én parameter på alle services, der hedder filter, som angiver hvilken relation eller egenskaber der returneres for alle entiteter som servicen returnerer. Alle muligheder er udpenslet i afsnittet Relationer og Egenskaber. Data der returneres er kun på den valide tidakse. Registreringstid antages til at være nu. 1.1.1 URL opbygning Service komponenterne er opdelt i 3, vist herunder, se tabel 1, for en forklaring af tokens i URL. Organisation komponent http://<server>[:<port>]/apos2-app-organisation[-<miljø>]/<entitet>servicedwhoio Part komponent http://<server>[:<port>]/apos2-app-part[-<miljø>]/<entitet>servicedwhoio Klassifiaktion komponent http://<server>[:<port>]/apos2-app-klassifikation[-<miljø>]/<entitet>servicedwhoio token <server> :<port> -<miljø> beskrivelse DNS navnet på serveren angives hvis den ikke kører på port 80, typisk vil den være på port 8080, som er standard for Tomcat angives hvis det ikke er produktions serveren, alternativt -test el. -trial Tabel 1: URL tokens Eksempel på URL til servicen OrganisationEnhedServiceDwhOIO på en test server 4
http://s00270t:8080/apos2-app-organisation-test/organisationenhedservicedwhoio 5
2 Relationer og Egenskaber 2.1 OrganisationEnhed For denne entitet returneres selve enhedens data og relationer. OrganisationEnhed Egenskaber navn, brugervendtnoegle OrganisationEnhed Tilhoerer enhedens organisation tilhør OrganisationEnhed Overordnet uuid på overordnet enhed, dvs. enhedens placering OrganisationEnhed Gyldighed AKTIV / INAKTIV med periode angivelse OrganisationEnhed Enhedstype uuid på klasse til angivelse af enhedstype OrganisationEnhed Lokationer uuid er på tilknyttede lokationer Tabel 2: OrganisationEnhed filter muligheder 2.2 OrganisationFunktion Lederfunktioner, engagementer og arbejdsopgave funktioner er indeholdt i denne entitet. OrganisationFunktion Egenskaber navn, brugervendtnoegle OrganisationFunktion Gyldighed AKTIV / INAKTIV perioder OrganisationFunktion TilknyttedeEnheder angiver hvilke enheder en funktion er tilknyttet OrganisationFunktion TilknyttedePersoner angiver hvilke personer en funktion er tilknyttet. For et engagement vil der f.eks. kun være tilknyttet én person OrganisationFunktion Organisatoriskfunktionstype klasse uuid på funktionen type, kan f.eks. anvendes til at opdele i lederfunktion eller engagement OrganisationFunktion Opgaver klasse uuidér på opgaver. For et engagement vil stillingsbetegnelsen være indeholdt her. OrganisationFunktion Adresser reference til funktionens adresser, det kan f.eks være KontaktKanaler. Tabel 3: OrganisationFunktion filter muligheder 6
Lokation Egenskaber indholder bl.a. lokationsnavn Lokation Gyldighed AKTIV / INAKTIV perioder Lokation ArbejderHer angiver personer der er placeret på lokationen Lokation Adresser indeholder referencer til både GeografiskAdresse og KlassifikationKontaktKanaler Tabel 4: Lokation filter muligheder Person Egenskaber navn Tabel 5: Person filter muligheder Klasse Egenskaber titel Klasse Facet angiver hvilken facette klassen tilhører Klasse Publiceret angiver om klssen må anvendes Tabel 6: Klasse filter muligheder Facet Egenskaber brugervendtnoegle Facet FacetTilhoer angiver hvilken klassifikation facetten tilhører Tabel 7: Facet filter muligheder KlassifikationKontaktkanal Egenskaber navn, brugervendtnoegle Tabel 8: KlassifikationKontaktkanal filter muligheder Klassifikation Egenskaber navn, brugervendtnoegle Tabel 9: Klassifikation filter muligheder 7
3 Appendiks Her følger en komplet oversigt over de data warehouse services og hvilke filterværdier de reagere på. Filterværdierne kan kombineres vha. komma. 3.1 Oversigt over Organisation 3.1.1 Organisation http://host/apos2-app-organisation/organisationservicedwhoio?filter=egenskaber http://host/apos2-app-organisation/organisationservicedwhoio?filter=gyldighed http://host/apos2-app-organisation/organisationservicedwhoio?filter=tilhoerer http://host/apos2-app-organisation/organisationservicedwhoio?filter=tilknyttedeorganisationer http://host/apos2-app-organisation/organisationservicedwhoio?filter=overordnet http://host/apos2-app-organisation/organisationservicedwhoio?filter=tilknyttedeenheder http://host/apos2-app-organisation/organisationservicedwhoio?filter=tilknyttedefunktioner http://host/apos2-app-organisation/organisationservicedwhoio?filter=tilknyttedeitsystemer http://host/apos2-app-organisation/organisationservicedwhoio?filter=tilknyttedebrugere http://host/apos2-app-organisation/organisationservicedwhoio?filter=tilknyttedeinteressefaellesskaber http://host/apos2-app-organisation/organisationservicedwhoio?filter=skatteenhed http://host/apos2-app-organisation/organisationservicedwhoio?filter=virksomhed http://host/apos2-app-organisation/organisationservicedwhoio?filter=produktionsenhed http://host/apos2-app-organisation/organisationservicedwhoio?filter=myndighed http://host/apos2-app-organisation/organisationservicedwhoio?filter=ansatte http://host/apos2-app-organisation/organisationservicedwhoio?filter=tilknyttedepersoner http://host/apos2-app-organisation/organisationservicedwhoio?filter=branche http://host/apos2-app-organisation/organisationservicedwhoio?filter=opgaver http://host/apos2-app-organisation/organisationservicedwhoio?filter=adresser http://host/apos2-app-organisation/organisationservicedwhoio?filter=myndighedstype http://host/apos2-app-organisation/organisationservicedwhoio?filter=virksomhedstype 3.1.2 OrganisationEnhed http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=egenskaber http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=gyldighed http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=adresser http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=ansatte http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=branche http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=enhedstype http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=opgaver http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=overordnet http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=produktionsenhed http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=skatteenhed http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=tilhoerer http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=lokationer http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=tilknyttedebrugere http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=tilknyttedeenheder http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=tilknyttedefunktioner http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=tilknyttedeinteressefaellesskaber http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=tilknyttede http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=tilknyttedepersoner http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=tilknyttedeitsystemer http://host/apos2-app-organisation/organisationenhedservicedwhoio?filter=integration 3.1.3 OrganisationFunktion http://host/apos2-app-organisation/organisationfunktionservicedwhoio?filter=egenskaber http://host/apos2-app-organisation/organisationfunktionservicedwhoio?filter=gyldighed http://host/apos2-app-organisation/organisationfunktionservicedwhoio?filter=adresser http://host/apos2-app-organisation/organisationfunktionservicedwhoio?filter=organisatoriskfunktionstype http://host/apos2-app-organisation/organisationfunktionservicedwhoio?filter=opgaver http://host/apos2-app-organisation/organisationfunktionservicedwhoio?filter=tilknyttedebrugere http://host/apos2-app-organisation/organisationfunktionservicedwhoio?filter=tilknyttedeenheder http://host/apos2-app-organisation/organisationfunktionservicedwhoio?filter=tilknyttedeinteressefaellesskaber http://host/apos2-app-organisation/organisationfunktionservicedwhoio?filter=tilknyttedeorganisationer http://host/apos2-app-organisation/organisationfunktionservicedwhoio?filter=tilknyttedepersoner 8
http://host/apos2-app-organisation/organisationfunktionservicedwhoio?filter=tilknyttedeitsystemer http://host/apos2-app-organisation/organisationfunktionservicedwhoio?filter=integration 3.1.4 Lokation http://host/apos2-app-organisation/lokationservicedwhoio?filter=egenskaber http://host/apos2-app-organisation/lokationservicedwhoio?filter=gyldighed http://host/apos2-app-organisation/lokationservicedwhoio?filter=geografiskadresse http://host/apos2-app-organisation/lokationservicedwhoio?filter=adresser http://host/apos2-app-organisation/lokationservicedwhoio?filter=lokationstype http://host/apos2-app-organisation/lokationservicedwhoio?filter=opgaver http://host/apos2-app-organisation/lokationservicedwhoio?filter=arbejderher 3.1.5 Bruger http://host/apos2-app-organisation/brugerservicedwhoio?filter=egenskaber http://host/apos2-app-organisation/brugerservicedwhoio?filter=gyldighed http://host/apos2-app-organisation/brugerservicedwhoio?filter=tilhoerer http://host/apos2-app-organisation/brugerservicedwhoio?filter=tilknyttedeorganisationer http://host/apos2-app-organisation/brugerservicedwhoio?filter=tilknyttedeenheder http://host/apos2-app-organisation/brugerservicedwhoio?filter=tilknyttedefunktioner http://host/apos2-app-organisation/brugerservicedwhoio?filter=tilknyttedeinteressefaellesskaber http://host/apos2-app-organisation/brugerservicedwhoio?filter=tilknyttedeitsystemer http://host/apos2-app-organisation/brugerservicedwhoio?filter=tilknyttedepersoner http://host/apos2-app-organisation/brugerservicedwhoio?filter=opgaver http://host/apos2-app-organisation/brugerservicedwhoio?filter=brugertyper http://host/apos2-app-organisation/brugerservicedwhoio?filter=adresser http://host/apos2-app-organisation/brugerservicedwhoio?filter=integration 3.1.6 ItSystem http://host/apos2-app-organisation/itsystemservicedwhoio?filter=egenskaber http://host/apos2-app-organisation/itsystemservicedwhoio?filter=gyldighed http://host/apos2-app-organisation/itsystemservicedwhoio?filter=adresser http://host/apos2-app-organisation/itsystemservicedwhoio?filter=opgaver http://host/apos2-app-organisation/itsystemservicedwhoio?filter=systemtyper http://host/apos2-app-organisation/itsystemservicedwhoio?filter=tilhoerer http://host/apos2-app-organisation/itsystemservicedwhoio?filter=tilknyttedebrugere http://host/apos2-app-organisation/itsystemservicedwhoio?filter=tilknyttedeenheder http://host/apos2-app-organisation/itsystemservicedwhoio?filter=tilknyttedefunktioner http://host/apos2-app-organisation/itsystemservicedwhoio?filter=tilknyttedeinteressefaellesskaber http://host/apos2-app-organisation/itsystemservicedwhoio?filter=tilknyttedeorganisationer http://host/apos2-app-organisation/itsystemservicedwhoio?filter=tilknyttedepersoner http://host/apos2-app-organisation/itsystemservicedwhoio?filter=tilknyttedeitsystemer http://host/apos2-app-organisation/itsystemservicedwhoio?filter=integration 3.1.7 Interessefaellesskab http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=egenskaber http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=gyldighed http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=tilhoerer http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=tilknyttedeorganisationer http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=overordnet http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=tilknyttedeenheder http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=tilknyttedefunktioner http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=tilknyttedeitsystemer http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=tilknyttedeinteressefaellesskaber http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=tilknyttedebrugere http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=tilknyttedepersoner http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=branche http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=opgaver http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=interessefaellesskabstype http://host/apos2-app-organisation/interessefaellesskabservicedwhoio?filter=adresser 9
3.2 Oversigt over Klassifikation 3.2.1 Klassifikation http://host/apos2-app-klassifikation/klassifikationservicedwhoio?filter=egenskaber http://host/apos2-app-klassifikation/klassifikationservicedwhoio?filter=publiceret http://host/apos2-app-klassifikation/klassifikationservicedwhoio?filter=ansvarlig http://host/apos2-app-klassifikation/klassifikationservicedwhoio?filter=ejer 3.2.2 Facet http://host/apos2-app-klassifikation/facetservicedwhoio?filter=egenskaber http://host/apos2-app-klassifikation/facetservicedwhoio?filter=publiceret http://host/apos2-app-klassifikation/facetservicedwhoio?filter=ansvarlig http://host/apos2-app-klassifikation/facetservicedwhoio?filter=ejer http://host/apos2-app-klassifikation/facetservicedwhoio?filter=redaktorer http://host/apos2-app-klassifikation/facetservicedwhoio?filter=facettilhoer 3.2.3 Klasse http://host/apos2-app-klassifikation/klasseservicedwhoio?filter=egenskaber http://host/apos2-app-klassifikation/klasseservicedwhoio?filter=publiceret http://host/apos2-app-klassifikation/klasseservicedwhoio?filter=ansvarlig http://host/apos2-app-klassifikation/klasseservicedwhoio?filter=ejer http://host/apos2-app-klassifikation/klasseservicedwhoio?filter=erstatter http://host/apos2-app-klassifikation/klasseservicedwhoio?filter=facet http://host/apos2-app-klassifikation/klasseservicedwhoio?filter=lovligekombinationer http://host/apos2-app-klassifikation/klasseservicedwhoio?filter=mapninger http://host/apos2-app-klassifikation/klasseservicedwhoio?filter=redaktoerer http://host/apos2-app-klassifikation/klasseservicedwhoio?filter=overordnet http://host/apos2-app-klassifikation/klasseservicedwhoio?filter=sideordnede http://host/apos2-app-klassifikation/klasseservicedwhoio?filter=tilfoejelser 3.3 Oversigt over Part 3.3.1 Person http://host/apos2-app-part/personservicedwhoio?filter=egenskaber http://host/apos2-app-part/personservicedwhoio?filter=sundhedoplysninger http://host/apos2-app-part/personservicedwhoio?filter=registeroplysninger http://host/apos2-app-part/personservicedwhoio?filter=livstatus http://host/apos2-app-part/personservicedwhoio?filter=civilstatus http://host/apos2-app-part/personservicedwhoio?filter=moder http://host/apos2-app-part/personservicedwhoio?filter=fader http://host/apos2-app-part/personservicedwhoio?filter=aegtefaelle http://host/apos2-app-part/personservicedwhoio?filter=registreretpartner http://host/apos2-app-part/personservicedwhoio?filter=foraeldremyndighedsindehaver http://host/apos2-app-part/personservicedwhoio?filter=retlighandleevnevaergeforpersonen http://host/apos2-app-part/personservicedwhoio?filter=erstattesaf http://host/apos2-app-part/personservicedwhoio?filter=boern http://host/apos2-app-part/personservicedwhoio?filter=bopaelssamling http://host/apos2-app-part/personservicedwhoio?filter=foraeldremyndighedsboern http://host/apos2-app-part/personservicedwhoio?filter=retlighandleevnevaergemaalsindehaver http://host/apos2-app-part/personservicedwhoio?filter=erstatningfor 3.3.2 GeografiskAdresse http://host/apos2-app-part/geografiskadresseservicedwhoio?filter=egenskaber http://host/apos2-app-part/geografiskadresseservicedwhoio?filter=gyldighed 10
3.3.3 KlassifikationKontaktkanal http://host/apos2-app-part/klassifikationkontaktkanalservicedwhoio?filter=egenskaber http://host/apos2-app-part/klassifikationkontaktkanalservicedwhoio?filter=gyldighed http://host/apos2-app-part/klassifikationkontaktkanalservicedwhoio?filter=kanaltype http://host/apos2-app-part/klassifikationkontaktkanalservicedwhoio?filter=brugsegenskaber 11