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. 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
|
CSV Format
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":[{"group":"Fahrer"},{"group":"Berlin"}]},{"id":"0014","name":"Patrick Berger","key":{"id":"00047392","valid_from":"2017-07-05 13:20:00","valid_to":null},"card_nr":"7937102","groups":[{"group":"B\u00fcro"},{"group":"Berlin"}]}] |
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 | |
---|---|---|---|---|
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 | |
(1)DRV_LICENCE_NR | drv_licence[id] | Führerschein | Führerscheinnummer der Person | |
(1)DRV_LICENCE_VALID_TO | drv_licence[valid_to] | Führerschein gültig bis | Ablaufdatum des Führerscheins | Format: YYYY-MM-DD HH:MM:SS |
(1)IDENTITY_CARD_NR | identity_card[id] | Personalausweis | Personalausweisnummer | |
(1)IDENTITY_CARD_VALID_TO | identity_card[valid_to] | Personalausweis gültig bis | Ablaufdatum des Personalausweises | Format: YYYY-MM-DD HH:MM:SS |
(1)PASSPORT_NR | passport[id] | Reisepass | Reisepass Nummer | |
(1)PASSPORT_VALID_TO | passport[valid_to] | Reisepass gültig bis | Ablaufdatum des Reisepasses | Format: YYYY-MM-DD HH:MM:SS |
(1)ADR_CERTIFICATE_NR | adr_certificate[id] | ADR Bescheinigung | Nummer der ADR Bescheinigung | |
(1)ADR_CERTICATE_VALID_TO | adr_certificate[valid_to] | ADR Bescheinigung gültig bis | Ablaufdatum der ADR Bescheinigung | Format: YYYY-MM-DD HH:MM:SS |
(1)BKRFQG_VALID_TO | bkrfqg[valid_to] | Qualifikation laut Schlüsselzahl 95 gültig bis | Gültigkeit der Schulung zum Berufskraftfahrerqualifikationsgesetz | Format: YYYY-MM-DD HH:MM:SS |
(1)BIRTHDATE | birthdate | Geburtsdatum | Geburtsdatum der Person | Format: YYYY-MM-DD HH:MM:SS |
(1)JOB_START_DATE | job_start_date | Einstellungsdatum | Einstellungsdatum der Person | Format: YYYY-MM-DD HH:MM:SS |
Hinweise:
(1) die markierten Spalten werden nur ausgegeben, wenn das Tacho Archiv gebucht wurde.
Beispiele
Code Block | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||
map.yellowfox.de/rti/get_persons_v2
|