You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Provide functions to create, edit and delete personnel specific data.

Description

set_personnel.php?company=RTI_COMPANYKEY&import=RTI_VEHICLEKEY&mode=new&id=01234&key_from=YYYYMMDDHHMMSS&pkey=DF123456789012&name=Max%20Mustermann&groups=Fahrer,Dresden

Parameters


 

parametername in personnel administrationdesciptiontyperemarkmandatory
company RTI company keystring yes
import RTI import keystring 

yes

mode differentiate between available actionsstring

vlid modes are:

  • new: create a new person
  • update: change data of an already available person
  • delete: remove a person
  • append_key: add a foreign personnel key to a person

 

yes

idemployee numberself defined employee numberstringthe employee number must be a self defined string for further identification of the personyes
nameNamecomplete name of the personstring yes(1)
pkeypersonnel keypersonnel key for bookingsstringthis may be a transponder or driver card to identify the person and assign booked times correctly

yes(1,2)

key_frompersonnel key valid from string

format: YYYYMMDDHHMMSS

if no value set, the current timestamp will be used

no
key_topersonnel key valid to string

format: YYYYMMDDHHMMSS

no
groupspersonnel groupsnames of personnel groups to assignstring

names of assigned personnel groups

  • set multiple groups by submit as comma separated string
  • on edit a person, we set only the selected groups (previous assignments will be removed)
no
card_nremployee licence numberself defined number for assignment to an external timerecording softwarestringrequired especially for correct assignment to ReinerSCT time card softwareno
drv_licence_nrdriver licencenumber of driver licencestring no(3)
drv_licence_valid_todriver licence valid toexpiration date of driver licencestringformat: YYYYMMDDHHMMSSno(3)
identity_card_nridentity cardidentity card numberstring no(3)
identity_card_valid_toidentity card valid toexpiration date of identity cardstringformat: YYYYMMDDHHMMSSno(3)
passport_nrpassportpassport numberstring no(3)
passport_valid_topassport valid toexpiration date of passportstringformat: YYYYMMDDHHMMSSno(3)
adr_cer_nrADR certificatenumber of adr certificatestring no(3)
adr_cert_valid_toADR certificate valid toexpiration date of ADR certificatestringformat: YYYYMMDDHHMMSSno(3)
bkrfqg_valid_toQualifikation laut Schlüsselzahl 95 gültig bisGültigkeit der Schulung zum BerufskraftfahrerqualifikationsgesetzstringDie Gültigkeit ist für Berufskraftfahrer auf dem Führerschein unter der Schlüsselzahl 95 erfasstnein(3)
birthGeburtsdatumGeburtsdatum der PersonstringFormat: YYYYMMDDHHMMSSnein(3)
job_fromEinstellungsdatumEinstellungsdatum der PersonstringFormat: YYYYMMDDHHMMSSnein(3)

Hinweise:

(1) Pflichtfeld beim Anlegen einer Person

(2) Pflichtfeld beim Zuweisen eines Folgeschlüssels

(3) nur verfügbar, wenn das Digitacho Archiv gebucht wurde

 

Rückgabe

Beim anlegen, bearbeiten und hinzufügen eines Folgeschlüssels wird im Erfolgsfall "PERSON_DATA_SAVED" zurückgegeben.

Beim löschen einer Person wird im Erfolgsfall "PERSON_DELETED" zurückgegeben.

Bei fehlenden oder fehlerhaften Eingaben wird ein "ERROR:Beschreibung" zurückgegeben.

Beispiele

Anlegen einer Person
http://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=new&id=1234&name=Maria%20Musterfrau&pkey=98765&group=Aussendienst
Bearbeiten einer Person
http://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=update&id=1234&name=Maria%20Musterfrau&pkey=98765&group=Aussendienst
Zuweisen eines Folgeschlüssels
http://map.yellowfox.de/rti/set_person.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=append_key&id=1234&pkey=98766&ekey_from=20180101000000
Löschen einer Person
http://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=delete&id=1234
  • No labels