addFlight

Fügt einen Flug zur Datenbank hinzu.

Syntax

integer addFlight (integer $hub_id, bool $is_arrival, string $dst_code, string $flight_number, integer $aircraft_id, string $aircraft_code, integer $weekdays, integer $time)

Parameter

  • $hub_id - Interne ID des Hubs, dem der Flug zugeordnet werden soll.
  • $is_arrival - Legt fest, ob der Flug vom Hub abgeht (true) oder ankommt (false).
  • $dst_code - IATA-Code des Herkunft- bzw. Zielflughafens des Fluges.
  • $flight_number - Alphanumerische Flugnummer des Fluges.
  • $aircraft_id - AS-definierte ID1) des Flugzeugtyps.
  • $aircraft_code 3-Letter-Code des Flugzeugtyps.
  • $weekdays - Wochentage, an denen der Flug durchgeführt wird, als Bitmuster2).
  • $time - Uhrzeit, zu der der Flug am Hub ankommt bzw. abfliegt, in Minuten nach Mitternacht3).

Rückgabewerte

Wurde der Flug erfolgreich der Datenbank hinzugefügt wird 0 zurückgegeben. Konnte der Flug aufgrund fehlerhafter Daten nicht hinzugefügt werden, wird ein negativer Wert zurückgegeben. Wird ein Flug aufgrund bestimmter Kriterien verworfen, wird ein positiver Wert zurückgegeben.

  • -255 - Datenbankfehler.
  • -7 - Die Uhrzeit ist ungültig.
  • -6 - Die Wochentage sind ungültig.
  • -5 - Die Flugzeugtyp-ID ist unbekannt oder ungültig.
  • -4 - Die Flugnummer ist ungültig.
  • -3 - Der angegebene Flughafen-Code ist unbekannt oder ungültig.
  • -2 - Die angegebene Hub-ID existiert nicht.
  • -1 - Bei der Verarbeitung ist ein unbekannter Fehler aufgetreten.
  • 0 - Der Flug wurde der Datenbank hinzugefügt.
  • 1 - Der Flug wurde aus unbekanntem Grund nicht der Datenbank hinzugefügt.
  • 2 - Fluggesellschaft ist kein Mitglied von nice.SKIES. Flug wurde nicht der Datenbank hinzugefügt, sondern verworfen.

Abhängigkeiten

1)
Die ID kann aus der Link-Adresse extrahiert werden.
2)
Das Bitmuster kann über die Funktion convertWeekdaysPlain erzeugt werden. Achtung: Bei ankommenden Flügen muss unbedingt ermittelt werden, ob der Flug am nachfolgenden Tag am Hub ankommt. In diesem Falle müssen die Wochentage mittels der Funktion shiftWeekdays um eine Position weitergerückt werden.
3)
Die Uhrzeit kann mittels der Funktion convertTimePlain konvertiert werden.