|
|
|
Das API zum Datenabgleich ist online in einer interaktiven Form verfügbar (Swagger). Durch Anhängen von `/api` an die Serveradresse erhält man eine komplette Liste der API-Endpunkt sowie der verwendeten Datenstrukturen. |
|
|
\ No newline at end of file |
|
|
|
Das API zum Datenabgleich ist online in einer interaktiven Form verfügbar (Swagger). Durch Anhängen von `/api` an die Serveradresse erhält man eine komplette Liste der API-Endpunkte sowie der verwendeten Datenstrukturen. Folgende weitere Erläuterungen der Datenstrukturen:
|
|
|
|
|
|
|
|
## Lesen der Personeninformationen
|
|
|
|
|
|
|
|
```json
|
|
|
|
{
|
|
|
|
"payrollId": "9648000321",
|
|
|
|
"name": "Lottemann",
|
|
|
|
"firstName": "Jan Jotti Paul",
|
|
|
|
"sex": "m",
|
|
|
|
"titlePrefix": "Dr.",
|
|
|
|
"titleSuffix": null,
|
|
|
|
"position": "Leiter Bildungsstandards",
|
|
|
|
"dateOfBirth": "1998-04-22",
|
|
|
|
"contractStart": "2020-01-15",
|
|
|
|
"contractEnd": "2025-12-31",
|
|
|
|
"addressPrivate": {
|
|
|
|
"addressPlus": "c/o Herbert Lottemann",
|
|
|
|
"street": "Müllerstr.",
|
|
|
|
"number": "1 C",
|
|
|
|
"city": "Erkner",
|
|
|
|
"postalCode": "15537"
|
|
|
|
},
|
|
|
|
"idmId": "lottejan",
|
|
|
|
"addressOffice": {
|
|
|
|
"addressPlus": "Haus 14",
|
|
|
|
"street": "Philippstr.",
|
|
|
|
"number": "13",
|
|
|
|
"city": "Berlin",
|
|
|
|
"postalCode": "10117"
|
|
|
|
},
|
|
|
|
"phone": "2093.46566",
|
|
|
|
"email": "jan.lottemann@iqb.hu-berlin.de"
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
### payrollId: Personalnummer
|
|
|
|
|
|
|
|
Diese besteht i. d. R. aus 10 Ziffern, wobei die ersten stets `96480` lauten. Eine Ausnahme bilden einige wenige Personeneinträge, die bereits vor 2014 dem IQB angehörten und formell weiterhin Mitarbeiter:innen der HU sind. Diese Personen haben eine fünfstellige Personalnummer.
|
|
|
|
|
|
|
|
Die Personalnummer wird von IQB vergeben, gilt aber im HU-IDM als HU-weite Personalnummer und muss damit eindeutig innerhalb der HU sein. Dies wird durch den fünfstelligen Präfix sichergestellt. Mit dem Registrieren der Person mit dieser Personalnummer werden Dienste freigeschaltet, die nur HU-Mitarbeiter:innen zur Verfügung stehen.
|
|
|
|
|
|
|
|
### name, firstName, dateofBirth, sex: Identifikation der Person
|
|
|
|
|
|
|
|
Über diese Informationen wird die Person eindeutig identifiziert. Das Geschlecht wird mit `m`ännlich, `w`eiblich, `d`ivers oder `u`nbekannt angegeben.
|
|
|
|
|
|
|
|
### idmId: Login-Name für HU-Dienste
|
|
|
|
|
|
|
|
Diese ID wird vom HU-IAM bzw. dem Accountmanagement des CMS vergeben und besteht aus 8 Kleinbuchstaben. Das Single Sign On der HU nutzt diese ID zusammen mit dem im Accountmanagement des CMS hinterlegten Kennwort. Auch der Kalenderservice und die E-Mail-Dienste arbeiten damit.
|
|
|
|
|
|
|
|
### contractStart, contractEnd: Beginn und Ende des Arbeitsvertrages
|
|
|
|
|
|
|
|
Datumswerte werden stets als String mit der Kodierung "YYYY-MM-DD" angegeben. Sollte contractEnd `null` sein, handelt es sich um ein unbefristetes Arbeitsverhältnis.
|
|
|
|
|
|
|
|
Beginn und Ende des Arbeitsvertrages sind erforderlich für die Aktivierung der HU-IAM-Dienste. Sollte das aktuelle Datum außerhalb dieses Zeitraumes liegen, sind die Dienste gesperrt.
|
|
|
|
|
|
|
|
### Adresse usw.
|
|
|
|
|
|
|
|
Angaben zum Wohnort und dienstliche Kontaktdaten dienen dazu, ggf. Mitteilungen an die betreffende Person zu schicken. |
|
|
\ No newline at end of file |
