Wiki-Quellcode von set_personnel.php
Zuletzt geändert von YellowFox_RD am 2025/01/20 15:37
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | (% class="box" %) | ||
| 2 | (((Inhaltsverzeichnis))) | ||
| 3 | {{toc/}} | ||
| 4 | |||
| 5 | Erlaubt das anlegen, bearbeiten und löschen von Personaldaten | ||
| 6 | = Beschreibung = | ||
| 7 | //**(% class="blue mark" %)POST(%%) set_personnel.php?company**=RTI_COMPANYKEY**&import**=RTI_VEHICLEKEY&**mode=**new**&id**=01234**&key_from**=YYYYMMDDHHMMSS**&pkey**=DF123456789012**&name**=Max%20Mustermann**&groups**=Fahrer,Dresden// | ||
| 8 | = Parameter = | ||
| 9 | // | ||
| 10 | // | ||
| 11 | |||
| 12 | |=Parameter|=Bezeichnung Personalverwaltung|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
| 13 | |company||RTI Firmenschlüssel|string||ja | ||
| 14 | |import||RTI Importschlüssel|string||ja | ||
| 15 | |mode||Unterscheidung der verschiedenen Aktionen|string|zulässige Modi sind: | ||
| 16 | ((( | ||
| 17 | * new: eine neue Person anlegen | ||
| 18 | * update: Daten einer angelegten Person ändern | ||
| 19 | * delete: eine angelegte Person löschen | ||
| 20 | * append_key: einer Person einen neuen Folgeschlüssel zuweisen | ||
| 21 | )))|ja | ||
| 22 | |id|MA-Nummer|selbstdefinierbare Mitarbeiternummer|string|die Mitarbeiternummer muss eindeutig sein und dient dem weiteren Zugriff auf die Personaldaten|ja | ||
| 23 | |name|Name|vollständiger Name der Person|string||ja^^(1)^^ | ||
| 24 | |pkey|Personalschlüssel|Buchungsschlüssel der Person|string|dies kann der Transponder oder auch die Fahrerkarte sein, je nachdem welche Option zur Authentifizierung des Personals gewählt ist|ja^^(1,2)^^ | ||
| 25 | |key_from|Personalschlüssel gültig ab||string|Format: YYYYMMDDHHMMSS | ||
| 26 | wird kein Wert gesetzt, wird die aktuelle Zeit genommen|nein | ||
| 27 | |key_to|Personalschlüssel gültig bis||string|Format: YYYYMMDDHHMMSS|nein | ||
| 28 | |groups|Personalgruppen|Namen der zugewiesenen Personalgruppen|string|Bezeichnung der zugeordneten Personalgruppe | ||
| 29 | ((( | ||
| 30 | * Mehrere Gruppen lassen sich mittels Komma getrennter Liste hinzufügen | ||
| 31 | * Beim bearbeiten werden eventuell vorher vorhandene Gruppenzuordnungen gelöscht | ||
| 32 | )))|nein | ||
| 33 | |card_nr|Ausweisnummer|selbstdefinierte Ausweisnummer der externen Software|string|Dies entspricht der optionale zuweisbaren Ausweisnummer, welche zur Erfassung von Buchungen mittels ReinerSCT genutzt wird|nein | ||
| 34 | |drv_licence_nr|Führerschein|Führerscheinnummer der Person|string||nein^^(3)^^ | ||
| 35 | |drv_licence_valid_to|Führerschein gültig bis|Ablaufdatum des Führerscheins|string|Format: YYYYMMDDHHMMSS|nein^^(3)^^ | ||
| 36 | |identity_card_nr|Personalausweis|Personalausweisnummer|string||nein^^(3)^^ | ||
| 37 | |identity_card_valid_to|Personalausweis gültig bis|Ablaufdatum des Personalausweises|string|Format: YYYYMMDDHHMMSS|nein^^(3)^^ | ||
| 38 | |passport_nr|Reisepass|Reisepass Nummer|string||nein^^(3)^^ | ||
| 39 | |passport_valid_to|Reisepass gültig bis|Ablaufdatum des Reisepasses|string|Format: YYYYMMDDHHMMSS|nein^^(3)^^ | ||
| 40 | |adr_cert_nr|ADR Bescheinigung|Nummer der ADR Bescheinigung|string||nein^^(3)^^ | ||
| 41 | |adr_cert_valid_to|ADR Bescheinigung gültig bis|Ablaufdatum der ADR Bescheinigung|string|Format: YYYYMMDDHHMMSS|nein^^(3)^^ | ||
| 42 | |bkrfqg_valid_to|Qualifikation laut Schlüsselzahl 95 gültig bis|Gültigkeit der Schulung zum Berufskraftfahrerqualifikationsgesetz|string|Die Gültigkeit ist für Berufskraftfahrer auf dem Führerschein unter der Schlüsselzahl 95 erfasst|nein^^(3)^^ | ||
| 43 | |birth|Geburtsdatum|Geburtsdatum der Person|string|Format: YYYYMMDDHHMMSS^^(4)^^|nein^^(3)^^ | ||
| 44 | |job_from|Einstellungsdatum|Einstellungsdatum der Person|string|Format: YYYYMMDDHHMMSS|nein^^(3)^^ | ||
| 45 | |||
| 46 | Hinweise: | ||
| 47 | (1) Pflichtfeld beim Anlegen einer Person | ||
| 48 | (2) Pflichtfeld beim Zuweisen eines Folgeschlüssels | ||
| 49 | (3) nur verfügbar, wenn das Digitacho Archiv gebucht wurde | ||
| 50 | (4) Wenn Tag und/oder Monat unbekannt ist, wird der Geburtstag mit "XX" für die unbekannten Werte aufgefüllt entsprechend deutschem Ausweisgesetz (Bsp: 198006XX oder 1980XXXX) | ||
| 51 | |||
| 52 | = Rückgabe = | ||
| 53 | Beim anlegen, bearbeiten und hinzufügen eines Folgeschlüssels wird im Erfolgsfall "**PERSON_DATA_SAVED**" zurückgegeben. | ||
| 54 | Beim löschen einer Person wird im Erfolgsfall "**PERSON_DELETED**" zurückgegeben. | ||
| 55 | Bei fehlenden oder fehlerhaften Eingaben wird ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben. | ||
| 56 | = Beispiele = | ||
| 57 | **Anlegen einer Person** | ||
| 58 | {{code language="java"}}https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=new&id=1234&name=Maria%20Musterfrau&pkey=98765&group=Aussendienst{{/code}} | ||
| 59 | |||
| 60 | **Bearbeiten einer Person** | ||
| 61 | {{code language="java"}}https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=update&id=1234&name=Maria%20Musterfrau&pkey=98765&group=Aussendienst{{/code}} | ||
| 62 | |||
| 63 | **Zuweisen eines Folgeschlüssels** | ||
| 64 | {{code language="java"}}https://map.yellowfox.de/rti/set_person.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=append_key&id=1234&pkey=98766&key_from=20180101000000{{/code}} | ||
| 65 | |||
| 66 | **Löschen einer Person** | ||
| 67 | {{code language="java"}}https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=delete&id=1234{{/code}} | ||
| 68 |