Wiki source code of set_driver_license_check_data.php
Last modified by YellowFox_RD on 2025/07/25 11:01
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | (% class="box" %) |
| |
3.1 | 2 | ((( |
| |
12.7 | 3 | Table of Contents |
| |
3.1 | 4 | ))) |
| 5 | |||
| |
1.1 | 6 | {{toc/}} |
| 7 | |||
| |
12.7 | 8 | Allows you to activate and deactivate driver's license control for a person |
| |
3.1 | 9 | |
| |
12.7 | 10 | {{warning}} |
| 11 | To use this function, the “Paid RTI Functions” authorization must be activated in the YellowFox portal. | ||
| |
9.1 | 12 | |
| |
12.7 | 13 | You can enable this permission in the YellowFox portal in the RTI settings. |
| 14 | {{/warning}} | ||
| |
9.1 | 15 | |
| |
12.7 | 16 | = Description = |
| |
3.1 | 17 | |
| |
12.7 | 18 | (% class="blue mark" %)//**POST**//(%%)//**set_driver_license_check_data.php?company**=RTI_COMPANYKEY**&import**=RTI_VEHICLEKEY**&id**=1234//**&nfc_tag**=123456789A12**&check_interval**=month**&last_check_date**=20250625000000 |
| |
3.1 | 19 | |
| |
12.7 | 20 | = Parameters = |
| |
1.1 | 21 | |
| 22 | |=Parameter|=Bezeichnung Personalverwaltung|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
| |
12.7 | 23 | |company| |RTI company key|string| |yes |
| 24 | |import| |RTI import key|string| |yes | ||
| 25 | |id|employee number|start date of beeing an employee at this company |string|the employee number must be unique and is used for further access to personnel data|yes | ||
| 26 | |nfc_tag|NFC Tag ID| | |If not set or empty, then the driver's license check will be deactivated for this person|no (1) | ||
| 27 | |check_interval|driver license check interval| | |((( | ||
| 28 | possible values | ||
| |
3.1 | 29 | |
| |
12.7 | 30 | * 2d = every two days |
| 31 | * week = weekly | ||
| 32 | * 2 weeks = every two weeks | ||
| 33 | * month = monthly | ||
| 34 | * 2 months = every two months | ||
| 35 | * quarter = quarterly | ||
| 36 | * half = half-yearly | ||
| 37 | * year = annually | ||
| 38 | )))|yes/no (2) | ||
| 39 | |last_check_date|last driver license check date | | |format: YYYYMMDDHHMMSS | ||
| 40 | The date must be after the last driver license check date|no (3) | ||
| |
3.1 | 41 | |
| |
12.7 | 42 | notes: |
| 43 | (1) If no NFC tag is transmitted or if it is empty, the driver's license check is deactivated. | ||
| 44 | (2) If an NFC tag is submitted, specifying a control interval is mandatory. If driver's license check is deactivated (nfc_tag is empty or not transmitted), specifying the control interval is obsolete. | ||
| 45 | (3) If no date of the last check is set when activating the driver's license check, any existing last check date remains unchanged. | ||
| |
1.1 | 46 | |
| |
3.1 | 47 | |
| |
12.7 | 48 | = Return = |
| |
3.1 | 49 | |
| |
12.7 | 50 | If successful, "**DRIVER_LICENSE_CHECK_DATA_SAVED**" is returned. |
| |
3.1 | 51 | |
| |
12.7 | 52 | In case of an error, return the string "(% class="error" %)**ERROR:Description**(%%)". |
| |
1.1 | 53 | |
| |
12.7 | 54 | = Example calls = |
| |
1.1 | 55 | |
| |
12.7 | 56 | **Activation of the driver's license check with specification of a last check date and a check interval "monthly** |
| |
1.1 | 57 | |
| |
5.1 | 58 | {{code language="java"}} |
| |
6.1 | 59 | https://map.yellowfox.de/rti/set_driver_license_check_data.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&id=1234&nfc_tag=123456789A123&check_interval=month&last_check_date=20250625000000 |
| |
5.1 | 60 | {{/code}} |
| |
3.1 | 61 | |
| |
12.7 | 62 | **Deactivating driver's license checks** |
| |
3.1 | 63 | |
| 64 | {{code language="java"}} | ||
| |
6.1 | 65 | https://map.yellowfox.de/rti/set_driver_license_check_data.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&id=1234&nfc_tag= |
| |
3.1 | 66 | {{/code}} |
| 67 | |||
| 68 | |||
| |
1.1 | 69 |