Versions Compared

Old Version 4

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version Current

changes.mady.by.user YellowFox R&D

Saved on

Key

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

vehicle_groups/manage_assignments.php [Original Seitentitel]

Verwaltung der Fahrzeuggruppen-Zuweisungen.

Hier können einzelne Fahrzeuge einer Gruppe hinzugefügt oder von einer Gruppe entfernt werden.

Beschreibung

Status
colourGreen
titleGET
vehicle_groups/manage_assignments.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&group=GROUP_RTIKEY&task=assign

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring

ja

vehicleRTI Fahrzeugschlüsselstringvehicle wird erwartet
ja
groupRTI Gruppenschlüsselstringgroup wird erwartet
ja
taskAufgabestring

Kann folgende Werte annehmen:

  • assign (hinzufügen)
oder
  • remove (entfernen)
wird erwartet
ja

Rückgabe

Es wird ein string zurückgegeben. welcher zu jedem Fahrzeug bei Erfolg OK enthält. Bei einem Fehler   Bei Erfolg wird als Antwort "OK" zurückgegeben. Ansonsten wird ein "ERROR:Beschreibung" zurückgegeben

Beispielaufrufe

.


Mögliche Fehlerwerte

FehlerBeschreibung
MISSING_COMPANY Firmenschlüssel fehlt
INVALID_COMPANYFirma nicht gefunden. Dies kann an einem fehlerhaften Firmen- oder Import-Schlüssel liegen.
ERROR_MAINTENANCEIhre Firma wird gerade gewartet, währenddessen sind keine RTI Abfragen möglich.
MISSING_GROUPGruppenschlüssel fehlt
INVALID_GROUP_KEYGruppenschlüssel passt zu keiner Gruppe
MISSING_TASKEs wurde kein Task angebeben.
MISSING_VEHICLEFahrzeugschlüssel fehlt
INVALID_KEY(VEHICLE|GROUP|IMPORT)Fahrzeugschlüssel entspricht nicht dem Format eines RTI Schlüssels
INVALID_VEHICLE_KEYFahrzeugschlüssel passt zu keinem Fahrzeug
CAR_ALREADY_IN_GROUPFahrzeug ist bereits in der angegebenen Gruppe
CAR_IS_NOT_IN_GROUPFahrzeug ist derzeit nicht in der angegebenen Gruppe
UNKNOWN_TASK([TASK])Task hat einen unzulässigen Wert
ERROR_WHILE_[TASK]Fehler beim Speichern der neuen Zuweisung


Beispielaufruf

Code Block
titleHinzufügen eines Fahrzeugs zu einer Gruppe
https://map.yellowfox.de/rti/vehicle_groups/manage_assignments.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&group=GROUP_RTIKEY&task=assign

https://map.yellowfox.de/rti/vehicle_groups/manage_assignments.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&group=GROUP_RTIKEY&task=assign




vehicle_groups/manage_assignments.php [Original Seitentitel]
Sv translation
languageen

Management of vehicle group assignments.

Separate vehicles can be added to or removed from a group hereAssign a single vehicle to a vehicle group or remove it from there.

Description

Status
colourGreen
titleGET
vehicle_groups/manage_assignments.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&group=GROUP_RTIKEY&task=assign

Parameter

ParameterDescriptionTypeNoteMandatory
companyRTI company keystring

yes

vehicleRTI vehicle keystring
vehicle needed

yes
groupRTI group keystring
group needed

yes
taskorder to assign or removestring

Possible values:

  • assign
or
  • remove
needed
yes

Return

A string string will be returned. If the request was successful "OK". If the request failed "ERROR:Description".


Possible error values

errordescription
MISSING_COMPANY company key is missing
INVALID_COMPANYCompany not found. Company key or import key might be faulty.
ERROR_MAINTENANCEYour company is under maintenance, no RTI request are possible at the moment.
MISSING_GROUPgroup key is missing
INVALID_GROUP_KEYgroup key does not match any group
MISSING_TASKno task given
MISSING_VEHICLEvehicle key is missing
INVALID_KEY(VEHICLE|GROUP|IMPORT)vehicle key does not match structure of a rti key
INVALID_VEHICLE_KEYvehicle key does not match any vehicle
CAR_ALREADY_IN_GROUPvehicle is already in given group
CAR_IS_NOT_IN_GROUPvehicle is not in given group
UNKNOWN_TASK([TASK])task has an invalid value
ERROR_WHILE_[TASK]error while saving assignment


Example calls

Code Block
titleAssign a vehicle to a group
https://map.yellowfox.de/rti/vehicle_groups/manage_assignments.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&group=GROUP_RTIKEY&task=assign

https://map.yellowfox.de/rti/vehicle_groups/manage_assignments.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&group=GROUP_RTIKEY&task=assign