Sv translation | ||
---|---|---|
| ||
Abfrage der aktuell angelegten Personen der der Personalverwaltung Beschreibung |
...
|
...
IMPORTKEY&format=csv Parameter
|
...
|
...
|
...
RückgabeEs wird eine Zeichenkette zurück gegebenBei einem Fehler wird der "403 - Verboten: Zugriff verweigert." HTTP-Header gesendet. |
CSV Format
Bei einer korrekten Anfrage werden die Personaldaten im CSV (Comma Separated Value) Format ausgeliefert wobei die erste
Anwortzeile immer die Kopfzeile ist, die die Feld-/Spalten Namen festlegt. Dannach folgen dann die Daten
Metainformationen
Trennzeichen | Semikolon ( ; ) |
---|---|
Textbegrenzer | Doppeltes Hochkomma ( " ) |
Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
Header | Zeile 1 |
Header
Header Informationen
"ID" ; "NAME" ; "KEY" ; "VALID_FROM" , "VALID_TO" , "GROUPS" ; "CARD_NR";"DRV_LICENCE_NR";"DRV_LICENCE_VALID_TO";"IDENTITY_CARD_NR";"IDENTITY_CARD_VALID_TO";"PASSPORT_NR";"PASSPORT_VALID_TO";"ADR_CERTIFICATE_NR";"ADR_CERTIFICATE_VALID_TO";"BKRFQG_VALID_TO";"BIRTHDATE";"JOB_START_DATE" |
Beispiel
Code Block |
---|
"ID";"NAME";"KEY";"VALID_FROM","VALID_TO","GROUPS";"CARD_NR"
"0012";"Max Mustermann";"DF1234567890";"2018-01-01 06:43:00";"";"Fahrer,Dresden";"" |
JSON Format
Liefert eine JSON formatierte Liste mit allen verfügbaren Daten zurück. Die Daten selbst werden alle in einer Key - Value - Beziehung zurückgegeben. Einzelne Werte wie die Daten zum Personalschlüssel oder die einzelnen Personalgruppen sind zur besseren Zuordnung jeweils in einem Unterobjekt zusammengefasst.
Beispiel
Code Block | ||
---|---|---|
| ||
[
{
"id":"0013",
"name":"Marion Musterfrau",
"key":{
"id":"DF9876543210",
"valid_from":"2016-01-01 00:00:00",
"valid_to":null
},
"card_nr":null,
"groups":[
"Fahrer",
"Berlin"
],
"deleted":null,
"drv_licence":{
"id":"asd09472845",
"valid_to":"2017-02-24 23:59:59"
},
"identity_card":{
"id":"hal2001",
"valid_to":"2017-01-11 23:59:59"
},
"passport":{
"id":null,
"valid_to":null
},
"adr_certificate":{
"id":null,
"valid_to":"2019-05-23 23:59:59"
},
"bkfqg":{
"valid_to":null
},
"birthdate":"1998-05-13 00:00:00",
"job_start_date":"2016-09-01 00:00:00"
},
{
"id":"0014",
"name":"Patrick Berger",
"key":{
"id":"00047392",
"valid_from":"2017-07-05 13:20:00",
"valid_to":null
},
"card_nr":"7937102",
"groups":[
"B\u00fcro",
"Berlin"
],
"deleted":null,
"drv_licence":{
"id":jvg7820185",
"valid_to":"2014-07-18 23:59:59"
},
"identity_card":{
"id":"ppa4711",
"valid_to":"2014-07-19 23:59:59"
},
"passport":{
"id":null,
"valid_to":null
},
"adr_certificate":{
"id":null,
"valid_to":null
},
"bkfqg":{
"valid_to":"2019-07-18 25:59:59"
},
"birthdate":"1996-07-17 00:00:00",
"job_start_date":"2014-07-17 00:00:00"
}
] |
XML Format
Liefert einen XML formatierten String zurück. Unter dem Hauptschlüssel "<persons>" ist jede einzelne Person als "<person>" Objekt erfasst. Einzelne Werte wie die Daten zum Personalschlüssel oder die einzelnen Personalgruppen sind zur besseren Zuordnung jeweils in einem Unterobjekt zusammengefasst.
Beispiel
Code Block | ||
---|---|---|
| ||
<?xml version="1.0"?>
<persons>
<person>
<id>0012</id>
<name>Max Mustermann</name>
<key>
<id>DF1234567890</id>
<valid_from>2018-01-01 06:43:00</valid_from>
<valid_to/>
</key>
<card_nr/>
<groups>
<group>Fahrer</group>
<group>Dresden</group>
</groups>
</person>
<person>
<id>0013</id>
<name>Marion Musterfrau</name>
<key>
<id>DF9876543210</id>
<valid_from>2016-01-01 00:00:00</valid_from>
<valid_to>2019-01-01 00:00:00</valid_to>
</key>
<card_nr/>
<groups>
<group>Fahrer</group>
<group>Berlin</group>
</groups>
</person>
</persons> |
Spalten
Spalte CSV | Spalte JSON/XML | Bezeichnung Personalverwaltung | Beschreibung | Hinweis | |
---|---|---|---|---|---|
ID | id | MA-Nummer | selbstdefinierte eindeutige Mitarbeiternummer | ||
NAME | name | Name | vollständiger Name der Person | ||
KEY | key[id] | Personalschlüssel | Personalschlüssel (für Buchungen über YellowFox) | ||
VALID_FROM | key[valid_from] | Personalschlüssel gültig ab | Gültigkeitsbeginn des Personalschlüssels | Format: YYYY-MM-DD HH:MM:SS | |
VALID_TO | key[valid_to] | Personalschlüssel gültig bis | Gültigkeitsende des Personalschlüssels | Format: YYYY-MM-DD HH:MM:SS | |
GROUPS | groups[group] | Personalgruppen | Komma getrennte Liste mit den Bezeichnungen der zugewiesenen Personalgruppen | ||
CARD_NR | card_nr | Ausweisnummer | Entspricht der optioPASSnale zuweisbaren Ausweisnummer, welche zur Erfassung von Buchungen mittels ReinerSCT genutzt wird | ||
DRV_LICENCE_NR | drv_licence[id] | Führerschein | Führerscheinnummer der Person | Daten nur bei gebuchtem Tacho Archiv | |
DRV_LICENCE_VALID_TO | drv_licence[valid_to] | Führerschein gültig bis | Ablaufdatum des Führerscheins | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
IDENTITY_CARD_NR | identity_card[id] | Personalausweis | Personalausweisnummer | Daten nur bei gebuchtem Tacho Archiv | |
IDENTITY_CARD_VALID_TO | identity_card[valid_to] | Personalausweis gültig bis | Ablaufdatum des Personalausweises | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
PASSPORT_NR | passport[id] | Reisepass | Reisepass Nummer | Daten nur bei gebuchtem Tacho Archiv | |
PASSPORT_VALID_TO | passport[valid_to] | Reisepass gültig bis | Ablaufdatum des Reisepasses | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
ADR_CERTIFICATE_NR | adr_certificate[id] | ADR Bescheinigung | Nummer der ADR Bescheinigung | Daten nur bei gebuchtem Tacho Archiv | |
ADR_CERTICATE_VALID_TO | adr_certificate[valid_to] | ADR Bescheinigung gültig bis | Ablaufdatum der ADR Bescheinigung | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
BKRFQG_VALID_TO | bkrfqg[valid_to] | Qualifikation laut Schlüsselzahl 95 gültig bis | Gültigkeit der Schulung zum Berufskraftfahrerqualifikationsgesetz | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
BIRTHDATE | birthdate | Geburtsdatum | Geburtsdatum der Person | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
JOB_START_DATE | job_start_date | Einstellungsdatum | Einstellungsdatum der Person | Daten nur bei gebuchtem Tacho Archiv | Format: YYYY-MM-DD HH:MM:SS |
Beispiele
Spalten
CSV FormatBei einer korrekten Anfrage werden die Personaldaten im CSV (Comma Separated Value) Format ausgeliefert wobei die erste Metainformationen
Header
JSON FormatLiefert eine JSON formatierte Liste mit allen verfügbaren Daten zurück. Die Daten selbst werden alle in einer Key - Value - Beziehung zurückgegeben. Einzelne Werte wie die Daten zum Personalschlüssel oder die einzelnen Personalgruppen sind zur besseren Zuordnung jeweils in einem Unterobjekt zusammengefasst.
XML FormatLiefert einen XML formatierten String zurück. Unter dem Hauptschlüssel "<persons>" ist jede einzelne Person als "<person>" Objekt erfasst. Einzelne Werte wie die Daten zum Personalschlüssel oder die einzelnen Personalgruppen sind zur besseren Zuordnung jeweils in einem Unterobjekt zusammengefasst.
Beispiele
|
Sv translation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Getting data for personnel set in personnel administration Description
Parameters
ReturnReturning a string in selected format. On error returning "403 - Verboten: Zugriff verweigert." as HTTP-Header. Column
CSV FormatSending a correct request will return a csv formatted file with a headline as first line containing column names. The data itself will be returned in following rows. Meta informations
Header
Beispiel
JSON FormatRetrun a json formatted string with all the available data matching the request parameters. The entries will be returned as key - value relation. Some data such as personnel key or personnel groups are grouped in a sub object. Beispiel
XML FormatReturn an xml formatted string with main key "<persons>" and data for each single person then grouped in a "<person>" object. Some data such as personnel key or personnel groups are grouped in a sub object. Beispiel
Examples
|