Interfaçage-OpenFlyers-et-Foxtrot-Aviation

Présentation

L'objet de cette page est de présenter :

• Le service Foxtrot Aviation
• La configuration de l'interfaçage OpenFlyers avec Foxtrot Aviation
• Son utilisation dans OpenFlyers

L'interfaçage Foxtrot Aviation permet à OpenFlyers d'importer et de synchroniser des données de vol via l'API Foxtrot Aviation.

Données récupérées via Foxtrot Aviation

En récupérant les vols via Foxtrot Aviation, les informations suivantes sont récupérées ou calculées.

Données issues de l'API

• Aéronef utilisé (immatriculation)
• Horodatages bloc (données onblock/offblock)
• Horodatages "moteur / principal" (onengine/offengine/onmain/offmain)
• Décollage / atterrissage (données takeoff/landing des legs)
• Lieu de départ / arrivée (codes ICAO depuis les legs : from/to)
• Nombre d'atterrissages (somme de nooflandings de chaque leg)
• Trajectoire (KMZ) via l'endpoint trace, quand disponible

Données calculées par OpenFlyers via formule

• Date de début du vol
• Durée du vol
• Temps en l'air

Pilotes / statut / place / type d'activité

Foxtrot Aviation ne fournissant pas les pilotes dans le payload, OpenFlyers procède comme suit :

• Si une réservation unique correspondant au vol est trouvée :
  • Les pilotes, statuts et places sont récupérés depuis la réservation.
  • Les types d'activité sont récupérés depuis la réservation.
• Si aucune réservation ne peut être associée (ou s'il existe plusieurs réservations qui se chevauchent) :
  • Les pilotes restent vides.
  • Le type d'activité est déterminé par les paramètres "type d'activité par défaut" (2 pilotes vs 0-1 pilote). Si non renseignés, OpenFlyers utilise le premier type d'activité disponible.

Paramétrage des formules

Foxtrot Aviation transmet des horodatages à la seconde. OpenFlyers fonctionne avec des dates à la minute. Il est donc nécessaire de définir des formules dans le paramétrage Foxtrot Aviation de la plateforme.

Variables utilisables

Les variables suivantes sont utilisables dans les formules :

• %FOXTROT_AVIATION_ONBLOCK_DATE : Datetime de départ bloc
• %FOXTROT_AVIATION_OFFBLOCK_DATE : Datetime de bloc arrivée
• %FOXTROT_AVIATION_TAKEOFF_DATE : Datetime de décollage (premier leg)
• %FOXTROT_AVIATION_LANDING_DATE : Datetime d'atterrissage (dernier leg)
• %FOXTROT_AVIATION_ONMAIN_DATE : Datetime "on main"
• %FOXTROT_AVIATION_OFFMAIN_DATE : Datetime "off main"
• %FOXTROT_AVIATION_ONENGINE_DATE : Datetime "on engine"
• %FOXTROT_AVIATION_OFFENGINE_DATE : Datetime "off engine"

Fonctions utilisables

Les fonctions suivantes peuvent être utilisées dans les formules :

• formatDate : Permet de formater une date
• roundCeil : Arrondi à la minute supérieure la date transmise en paramètre
• roundFloor : Arrondi à la minute inférieure la date transmise en paramètre
• strtotime : Transforme une date en timestamp

Procédure

Interfacer OpenFlyers avec Foxtrot Aviation

• Aller dans Admin > Structure > Paramétrage > Activités
  • Activer l'interrupteur Foxtrot Aviation
  • Renseigner les champs suivants :
    • Formule date de début du vol Foxtrot Aviation
    • Formule durée du vol Foxtrot Aviation
    • Formule temps en l'air Foxtrot Aviation
    • Type d'activité par défaut avec zéro ou un pilote
    • Type d'activité par défaut avec deux pilotes
  • Cliquer sur le bouton Enregistrer

• Configurer les champs métiers des ressources :
  • Aller sur la fiche ressource (aéronef)
  • Renseigner :
    • Numéro de ressource API géolocalisation : identifiant ressource utilisé par Foxtrot (doit correspondre à planecode coté Foxtrot Aviation)
    • Username Foxtrot : identifiant de connexion Foxtrot Aviation
    • Mot de passe Foxtrot : mot de passe de connexion Foxtrot Aviation

Récupération des vols Foxtrot Aviation

L'interfaçage Foxtrot Aviation fonctionne en mode "push" : Foxtrot Aviation envoie une notification à OpenFlyers lorsqu'un ou plusieurs vols sont disponibles pour un aéronef.

OpenFlyers reçoit la demande (avec le code de l'aéronef / planeCode) puis lance l'import des vols.

La synchronisation peut aussi être lancée manuellement dans Gestion > Activités > Activités > Liste.

Association aux réservations

OpenFlyers tente d'associer un vol importé à une réservation correspondant à la ressource et aux horaires du vol.

• Si plusieurs réservations se chevauchent sur la période, aucune n'est prise en compte.
• Si une réservation unique correspond :
  • Les pilotes/statuts/places et types d'activité sont repris depuis la réservation.

Récupération des traces de vols

Foxtrot Aviation fournit une trajectoire par vol (KMZ).

Les traces de vols sont téléchargeables depuis les interfaces Planning > Activités > Carnet de route et Planning > Activités > Carnet de vol. Pour visualiser les traces de vol il faut soit être sur le vol en tant que pilote ou instructeur ou bien avoir le droit Visualiser les traces de vol.