Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede

Erlaubt das anlegen, bearbeiten und löschen von Personaldaten

Beschreibung

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

Parameter


 

ParameterBezeichnung PersonalverwaltungBeschreibungTypHinweisPflicht
company RTI Firmenschlüsselstring ja
import RTI Importschlüsselstring 

ja

mode Unterscheidung der verschiedenen Aktionenstring

zulässige Modi sind:

  • new: eine neue Person anlegen
  • update: Daten einer angelegten Person ändern
  • delete: eine angelegte Person löschen
  • append_key: einer Person einen neuen Folgeschlüssel zuweisen

 

ja

idMA-Nummerselbstdefinierbare Mitarbeiternummerstringdie Mitarbeiternummer muss eindeutig sein und dient dem weiteren Zugriff auf die Personaldatenja
nameNamevollständiger Name der Personstring ja(1)
pkeyPersonalschlüsselBuchungsschlüssel der Personstringdies kann der Transponder oder auch die Fahrerkarte sein, je nachdem welche Option zur Authentifizierung des Personals gewählt ist

ja(1,2)

key_fromPersonalschlüssel gültig ab string

Format: YYYYMMDDHHMMSS

wird kein Wert gesetzt, wird die aktuelle Zeit genommen

nein
key_toPersonalschlüssel gültig bis string

Format: YYYYMMDDHHMMSS

nein
groupsPersonalgruppenNamen der zugewiesenen Personalgruppenstring

Bezeichnung der zugeordneten Personalgruppe

  • Mehrere Gruppen lassen sich mittels Komma getrennter Liste hinzufügen
  • Beim bearbeiten werden eventuell vorher vorhandene Gruppenzuordnungen gelöscht
nein
card_nrAusweisnummerselbstdefinierte Ausweisnummer der externen SoftwarestringDies entspricht der optionale zuweisbaren Ausweisnummer, welche zur Erfassung von Buchungen mittels ReinerSCT genutzt wirdnein
drv_licence_nrFührerscheinFührerscheinnummer der Personstring nein(3)
drv_licence_valid_toFührerschein gültig bisAblaufdatum des FührerscheinsstringFormat: YYYYMMDDHHMMSSnein(3)
identity_card_nrPersonalausweisPersonalausweisnummerstring nein(3)
identity_card_valid_toPersonalausweis gültig bisAblaufdatum des PersonalausweisesstringFormat: YYYYMMDDHHMMSSnein(3)
passport_nrReisepassReisepass Nummerstring nein(3)
passport_valid_toReisepass gültig bisAblaufdatum des ReisepassesstringFormat: YYYYMMDDHHMMSSnein(3)
adr_cer_nrADR BescheinigungNummer der ADR Bescheinigungstring nein(3)
adr_cert_valid_toADR Bescheinigung gültig bisAblaufdatum der ADR BescheinigungstringFormat: YYYYMMDDHHMMSSnein(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

Code Block
titleAnlegen 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
Code Block
titleBearbeiten 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
Code Block
titleZuweisen 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
Code Block
titleLöschen einer Person
http://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=delete&id=1234
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 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

Code Block
titleAnlegen 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
Code Block
titleBearbeiten 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
Code Block
titleZuweisen 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
Code Block
titleLöschen einer Person
http://map.yellowfox.de/rti/set_personnel.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&mode=delete&id=1234