Wiki-Quellcode von set_personnel.php
Version 3.1 von YellowFox_RD am 2025/07/10 11:31
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | (% class="box" %) | ||
| 2 | ((( | ||
| 3 | Inhaltsverzeichnis | ||
| 4 | ))) | ||
| 5 | |||
| 6 | {{toc/}} | ||
| 7 | |||
| 8 | Erlaubt das anlegen, bearbeiten und löschen von Personaldaten | ||
| 9 | |||
| 10 | = Beschreibung = | ||
| 11 | |||
| 12 | (% 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// | ||
| 13 | |||
| 14 | = Parameter = | ||
| 15 | |||
| 16 | |||
| 17 | |=Parameter|=Bezeichnung Personalverwaltung|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
| 18 | |company| |RTI Firmenschlüssel|string| |ja | ||
| 19 | |import| |RTI Importschlüssel|string| |ja | ||
| 20 | |mode| |Unterscheidung der verschiedenen Aktionen|string|zulässige Modi sind:((( | ||
| 21 | * new: eine neue Person anlegen | ||
| 22 | * update: Daten einer angelegten Person ändern | ||
| 23 | * delete: eine angelegte Person löschen | ||
| 24 | * append_key: einer Person einen neuen Folgeschlüssel zuweisen | ||
| 25 | )))|ja | ||
| 26 | |id|MA-Nummer|selbstdefinierbare Mitarbeiternummer|string|die Mitarbeiternummer muss eindeutig sein und dient dem weiteren Zugriff auf die Personaldaten|ja | ||
| 27 | |name|Name|vollständiger Name der Person|string| |ja^^(1)^^ | ||
| 28 | |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)^^ | ||
| 29 | |key_from|Personalschlüssel gültig ab| |string|((( | ||
| 30 | wird nur bei folgenden Modi verwendet: | ||
| 31 | |||
| 32 | * new | ||
| 33 | * append_key | ||
| 34 | * update_key | ||
| 35 | * deactivate_key | ||
| 36 | |||
| 37 | Format: YYYYMMDDHHMMSS | ||
| 38 | wird kein Wert gesetzt, wird die aktuelle Zeit genommen | ||
| 39 | )))|nein | ||
| 40 | |key_to|Personalschlüssel gültig bis| |string|((( | ||
| 41 | wird nur bei folgenden Modi verwendet: | ||
| 42 | |||
| 43 | * new | ||
| 44 | * append_key | ||
| 45 | * update_key | ||
| 46 | * deactivate_key | ||
| 47 | |||
| 48 | Format: YYYYMMDDHHMMSS | ||
| 49 | )))|nein | ||
| 50 | |key_deactivation_date|Personalschlüssel Deaktivierungs-Datum| | |((( | ||
| 51 | wird nur bei folgenden Modi verwendet: | ||
| 52 | |||
| 53 | * new | ||
| 54 | * append_key | ||
| 55 | * update_key | ||
| 56 | * deactivate_key | ||
| 57 | |||
| 58 | Format: YYYYMMDDHHMMSS | ||
| 59 | |||
| 60 | * wird kein Wert gesetzt, wird die aktuelle Zeit genommen | ||
| 61 | * Der Wert darf nicht in der Zukunft liegen | ||
| 62 | )))|nein | ||
| 63 | |groups|Personalgruppen|Namen der zugewiesenen Personalgruppen|string|Bezeichnung der zugeordneten Personalgruppe((( | ||
| 64 | * Mehrere Gruppen lassen sich mittels Komma getrennter Liste hinzufügen | ||
| 65 | * Beim bearbeiten werden eventuell vorher vorhandene Gruppenzuordnungen gelöscht | ||
| 66 | )))|nein | ||
| 67 | |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 | ||
| 68 | |drv_licence_nr|Führerschein|Führerscheinnummer der Person|string| |nein^^(3)^^ | ||
| 69 | |drv_licence_valid_to|Führerschein gültig bis|Ablaufdatum des Führerscheins|string|Format: YYYYMMDDHHMMSS|nein^^(3)^^ | ||
| 70 | |identity_card_nr|Personalausweis|Personalausweisnummer|string| |nein^^(3)^^ | ||
| 71 | |identity_card_valid_to|Personalausweis gültig bis|Ablaufdatum des Personalausweises|string|Format: YYYYMMDDHHMMSS|nein^^(3)^^ | ||
| 72 | |passport_nr|Reisepass|Reisepass Nummer|string| |nein^^(3)^^ | ||
| 73 | |passport_valid_to|Reisepass gültig bis|Ablaufdatum des Reisepasses|string|Format: YYYYMMDDHHMMSS|nein^^(3)^^ | ||
| 74 | |adr_cert_nr|ADR Bescheinigung|Nummer der ADR Bescheinigung|string| |nein^^(3)^^ | ||
| 75 | |adr_cert_valid_to|ADR Bescheinigung gültig bis|Ablaufdatum der ADR Bescheinigung|string|Format: YYYYMMDDHHMMSS|nein^^(3)^^ | ||
| 76 | |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)^^ | ||
| 77 | |birth|Geburtsdatum|Geburtsdatum der Person|string|Format: YYYYMMDDHHMMSS^^(4)^^|nein^^(3)^^ | ||
| 78 | |job_from|Einstellungsdatum|Einstellungsdatum der Person|string|Format: YYYYMMDDHHMMSS|nein^^(3)^^ | ||
| 79 | |||
| 80 | Hinweise: | ||
| 81 | (1) Pflichtfeld beim Anlegen einer Person | ||
| 82 | (2) Pflichtfeld beim Zuweisen, Bearbeiten oder Deaktivieren eines Personalschlüssels | ||
| 83 | (3) nur verfügbar, wenn das Digitacho Archiv gebucht wurde | ||
| 84 | (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) | ||
| 85 | |||
| 86 | = Rückgabe = | ||
| 87 | |||
| 88 | Beim anlegen, bearbeiten und hinzufügen eines Folgeschlüssels wird im Erfolgsfall "**PERSON_DATA_SAVED**" zurückgegeben. | ||
| 89 | Beim löschen einer Person wird im Erfolgsfall "**PERSON_DELETED**" zurückgegeben. | ||
| 90 | Bei fehlenden oder fehlerhaften Eingaben wird ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben. | ||
| 91 | |||
| 92 | = Beispiele = | ||
| 93 | |||
| 94 | **Anlegen einer Person** | ||
| 95 | {{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}} | ||
| 96 | |||
| 97 | **Bearbeiten einer Person** | ||
| 98 | {{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}} | ||
| 99 | |||
| 100 | **Zuweisen eines Folgeschlüssels** | ||
| 101 | {{code language="java"}}https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=append_key&id=1234&pkey=98766&key_from=20180101000000{{/code}} | ||
| 102 | |||
| 103 | **Aktualisieren eines Personalschlüssels** | ||
| 104 | |||
| 105 | {{code language="java"}}https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=update_key&id=1234&pkey=98766&key_from=20180101000000&key_to=20190101000000{{/code}} | ||
| 106 | **Deaktivieren eines Personalschlüssel** | ||
| 107 | |||
| 108 | {{code language="java"}} | ||
| 109 | https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=deactivate_key&id=1234&pkey=98766&key_deactivation_date=20180101000000 | ||
| 110 | {{/code}} | ||
| 111 | |||
| 112 | |||
| 113 | |||
| 114 | **Löschen einer Person** | ||
| 115 | {{code language="java"}}https://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=delete&id=1234{{/code}} | ||
| 116 |