Versions Compared

Old Version 5

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 6

changes.mady.by.user YellowFox R&D

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Sv translation
languageen

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 valid 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 erfasstqualification by keynumber 95 valid toexpiration date of german "Berufskraftfahrerqualifikationsgesetz"stringthe expiration date of this qualification is printed at driver licence at key number 95nonein(3)
birthGeburtsdatumdate of birthbirthdate of personGeburtsdatum der PersonstringFormatformat: YYYYMMDDHHMMSSneinno(3)
job_fromEinstellungsdatumemployee sincestart date of beeing an employee at this companyEinstellungsdatum der PersonstringFormatformat: YYYYMMDDHHMMSSneinno(3)

HinweiseRemarks:

(1) Pflichtfeld beim Anlegen einer Personmandatory on add a new person

(2) Pflichtfeld beim Zuweisen eines Folgeschlüsselsmandatory on add a following card

(3) nur verfügbar, wenn das Digitacho Archiv gebucht wurdewill be only stored, if tacho archive extension active

 

Rückgabe

Return

On succesful create, edit or assignment of a following key the return string will be 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 .

On successful delete of a person the return string will be "PERSON_DELETED" zurückgegeben.

Bei fehlenden oder fehlerhaften Eingaben wird ein In case of an error, return the string "ERROR:BeschreibungDescription" zurückgegeben.

Beispiele

Examples

Code Block
titleAnlegen einer PersonCreate new 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
Code Block
titleBearbeiten einer PersonEdit person data
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
Code Block
titleZuweisen eines FolgeschlüsselsAssign a following card
http://map.yellowfox.de/rti/set_person.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=append_key&id=1234&pkey=98766&ekey_from=20180101000000
Code Block
titleLöschen einer PersonDelete a person
http://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=delete&id=1234