Innhold
1 Systembilde
SAP Konsumenten lytter etter meldinger om endringer i SAP, og utfører en full provisjonering begrenset til den relaterte entiteten når en melding mottas.
Meldingen bærer informasjon om hva som er endret på en gitt entitet, utfyllende informasjon hentes ut fra SAPs REST-grensesnitt, via API-Gateway.
2 Informasjon som provisjoneres
Følgende informasjon provisjoneres av konsumenten:
2.1 Personinformasjon
- Navn
- Personlig tittel (personalTitle)
- Stillingstittel (jobTitle)
- Adresser
- Kontaktinformasjon (telefon)
- Tilknytninger
- Roller (i form av tilknytninger)
- Reservasjon fra visning i elektronisk katalog
- Eksterne identifikatorer (FNR og ansattnummer)
- Kjønn
- Fødselsdato
2.2 Kart over importerte titteltyper
| Type i SAP | Type i Cerebrum |
|---|---|
| personalTitle | PERSONALTITLE |
| jobTitle | WORKTITLE |
2.3 Kart over importerte adressetyper
| Type i SAP | Type i Cerebrum |
|---|---|
| legalAddress | PRIVPOST |
| workMailingAddress | POST |
| workVisitingAddress | STREET |
2.4 Kart over importert kontaktinformasjon
| Type i SAP | Type i Cerebrum |
|---|---|
| workPhone | PHONE |
| workMobile | MOBILE |
| privateMobile | PRIVATEMOBILE |
| publicMobile | PRIVMOBVISIBLE |
2.5 Kart over ansettelsestype → tilknytning
| Type | Tilknytning |
|---|---|
| academic | ANSATT/vitenskapelig |
| administrative | ANSATT/tekadm |
2.5.1 Kart over rolle → tilknytning
| SAP rolle | Tilknytning |
|---|---|
| GJ-FORSKER | TILKNYTTET/gjesteforsker |
| EF-STIP | TILKNYTTET/ekst_stip |
| INNKJØPER | TILKNYTTET/innkjoper |
| EMERITUS | TILKNYTTET/emeritus |
| STEDOPPLYS | Ikke koblet til tilknytning |
| EKST-PART | TILKNYTTET/ekst_partner |
| GRP-LÆRER | TILKNYTTET/grlaerer |
| EF-FORSKER | TILKNYTTET/ekst_forsker |
| POLS-ANSAT | Ikke koblet til tilknytning |
| EKST-KONS | TILKNYTTET/ekst_partner |
| ASSOSIERT | TILKNYTTET/assosiert_person |
| BILAGSLØNN | TILKNYTTET/bilag |
| PCVAKT | TILKNYTTET/pcvakt |
2.6 Kart over eksterne identifikatorer
| Type i SAP | Type i Cerebrum |
|---|---|
| passportNumber | PASSNR |
| norwegianIdentificationNumber | NO_BIRTHNO |
3 Konfigurering
For at konsumenten skal kunne konsumere meldinger og provisjonere informasjon i Cerebrum på bakgrunn av uttrekk fra SAPs REST-WebService, må følgende konfigureres:
- Tilkoblingsinformasjon til meldingskø
- Tilkoblingsinformasjon til SAPs REST-WebService
Dette gjøres gjennom det sedvanlige konfigurasjonsregime. Se klassene SAPWSConsumerConfig og SAPWSConsumerConfig i konsumenten for pekepinner til konfigurasjonsvariable.
Når det kobles til meldingskøen, bør det kobles til en dedikert kø for hendelser som kommer fra SAP. Køen bør være durable. Køen bør være bundet til exchangen som meldinger fra SAP kommer til, med routing-nøkkel «no.uio.sap.event.person.*».
4 Fremtidige roller og stillinger
Roller og stillinger som har startdato mer enn 3 dager frem i tid blir ikke importert fra SAP til Cerebrum. En rolle sin "effectiveStartDate" er det som regnes som dens startdato. For stillinger er det "originalHireDate" som blir regnet som startdato. Teknisk gjennomføres dette ved at consumer_sap.py setter feltet "nbf" for den innkommende meldingen, og deretter sender denne videre til tiny_scheduler.py.
5 Ofte besøkte stier
- cerebrum/consumers/no/uio/consumer_sap.py