Interfaçage OpenFlyers et ClickAndTakeoff

From Documentation de la solution web de gestion OpenFlyers
Revision as of 13:44, 22 July 2024 by imported>Ozerhouni (→‎Données récupérées via ClickAndTakeoff)
Jump to navigation Jump to search

Présentation

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

  • Le produit ClickAndTakeoff
  • La configuration de l'interfaçage OpenFlyers avec ClickAndTakeoff
  • Son utilisation dans OpenFlyers

Click & Take-off propose une plateforme d’alerte, de géolocalisation et d’analyse du pilotage pour l’aviation légère.

La plateforme Click & Take-off permet de :

  • Consulter l’historique des vols qui contient les informations suivantes :
    • les heures blocs/ horamétres de mouvement:Début du roulage, Décollage, Atterrissage, Fin du roulage.
    • La liste des aérodromes de toucher.

OpenFlyers récupère ces données (voir le chapitre ci-dessous données récupérées via ClickAndTakeoff) et affecte l'adresse email des pilotes/instructeurs dans ClickAndTakeOff d'après le planning de réservations. Un vol modifié manuellement à posteriori de sa remontée automatique dans OpenFlyers et mis à jour dans ClickAndTakeoff.

NB: Il y a une tâche cron pour synchroniser automatiquement les données des vols avec ClickAndTakeoff. Le code de cette tâche s'applique uniquement aux serveurs de production et ignore les serveurs de test.

Procédure

Interfacer OpenFlyers avec Charterware

  • Aller dans Admin > Structure > Paramétrage > Activités
    • Activer l'interrupteur Charterware situé dans la 4ème colonne
    • Renseigner les champs suivants :
      • Nom de la plateforme dans Charterware: Saisir le nom de votre plateforme Charterware.
      • Formule date de début du vol Charterware: Entrer la formule pour calculer la date de début du vol.
      • Formule durée du vol Charterware: Entrer la formule pour calculer la durée du vol.
      • Formule temps en l'air Charterware: Entrer la formule pour calculer le temps en l'air.
      • Règle d'arrondi horaire Charterware: Sélectionner la règle d'arrondi horaire (par exemple, Arrondi au plus proche).
      • Type d'activité par défaut avec zéro ou un pilote dans Charterware: Choisir le type d'activité par défaut pour un pilote unique ou aucun pilote.
      • Type d'activité par défaut avec deux pilotes dans Charterware: Choisir le type d'activité par défaut pour deux pilotes.
      • E-mail: Entrer l'adresse e-mail associée à votre compte Charterware.
      • Mot de passe: Entrer le mot de passe associé à votre compte Charterware.
    • Cliquer sur le bouton Enregistrer
  • Aller dans Gestion > Ressources > Actives et pour chaque ressource pour laquelle les vols seront enregistrés par Charterware :
    • Cliquer sur le bouton symbolisant un crayon
    • Renseigner le champ Numéro de ressource API géolocalisation avec l'IMEI de la boîte Teltonika utilisée avec cette ressource.
    • Cliquer sur le bouton Enregistrer

Données récupérées via ClickAndTakeoff

En récupérant les vols via ClickAndTakeoff les informations suivantes sont récupérées ou calculées.

  • Aéronef utilisé (donnée deviceName)
  • Horodatage du début du vol (donnée startTime)
  • Durée du vol (par calcul de la différence entre les données startTime et endTime)
  • Temps en l'air (par calcul de la différence entre les données horametreDebutVol et horametreFinVol)
  • Personnes à bord (données pilote et instructeur)
  • Lieu de départ (donnée oaciAeroStart)
  • Lieu d'arrivé (donnée oaciAeroEnd)
  • Nombre d’atterrissage (donnée oaci)

Variables pour les formules de calcul

Les variables suivantes sont utilisables dans les formules :

  • CLICKANDTAKEOFF_ENGINE_START : Datetime de démarrage moteur
  • CLICKANDTAKEOFF_OFFBLOCK_DATE : Datetime de départ bloc
  • CLICKANDTAKEOFF_ONBLOCK_DATE : Datetime de bloc arrivée
  • CLICKANDTAKEOFF_ENGINE_STOP : Datetime d'arrêt moteur

Ces variables sont directement transmises par ClickAndTakeOff.

Les fonctions suivantes peuvent être utilisées dans les formules pour le paramétrage de ClickAndTakeoff :

  • 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

Récupération des vols ClickAndTakeoff

Chaque minute le robot OpenFlyers interroge le serveur ClickAndTakeoff pour savoir si de nouveaux vols ont été enregistrés par ClickAndTakeoff. Si c'est le cas, alors il sont sauvegardés dans OpenFlyers et modifiés les vols récupérés côté Charterware après l'affectation du pilote et de l'instructeur.

ClickAndTakeoff utilise un système d'identifiant pour retrouver les pilotes et les aéronefs il est donc nécessaire de créer les champs métiers nécessaires et de les renseigner dans l'interface d'OpenFlyers.

  • Si l'identifiant d'un aéronef ClickAndTakeoff ne peut être retrouvé dans OpenFlyers alors le robot n'enregistrera pas le vol.

Afin de retrouver un maximum d'informations le robot tente de retrouver une réservation avec la même ressource correspondant au vol communiqué par ClickAndTakeoff:

  • Il cherche s'il existe une réservation dont les horaires comprennent l'heure médiane du vol ClickAndTakeoff. Si c'est le cas, il se base sur les informations de cette réservation.
  • S'il n'y a aucune réservation, il cherche une réservation avec la même ressource dont les horaires sont compris entre le début et la fin du vol remonté par ClickAndTakeoff.
    • S'il y a plusieurs réservations, alors il n'en prend aucune.
    • Une fois qu'une réservation est identifiée comme correspondre au vol remonté par ClickAndTakeoff, les informations de la réservation sont prises en compte par le robot.
Exemple

Pour un vol qui commence à 16h05 et se termine à 17h00, l'heure médiane est 16h32. La réservation correspondante pour ce vol sera celle qui inclut cette heure médiane.

Statut des pilotes

Pour chaque pilote :

  • Si un vol récupéré dans ClickAndTakeoff peut être associé à une réservation => Les statuts des pilotes sont celles définies dans la réservation.
  • Si le vol ne peut être associé :
    • S'il n'y a qu'un statut autorisé pour la place du pilote et pour l'avion => Le statut du pilote est ce statut.
    • Si le pilote est sur la première place => Le statut du pilote est le statut "pilote" si il n'existe pas le premier statut.
    • Si le pilote est sur la seconde place => Le statut du pilote est le statut "Instructeur" si il n'existe pas le second statut.

Place des pilotes

  • Si un vol récupéré dans ClickAndTakeoff peut être associé à une réservation => Les places des pilotes sont celles définies dans la réservation.
  • Si le vol ne peut être associé :
    • S'il y a un seul pilote => Sa place est celle par défaut (0, Gauche).
    • S'il y a deux pilotes et que un seul à l'autorisation pour être sur la place de droite => Le pilote ayant l'autorisation est à la place de droite et l'autre à la place de gauche.
    • Si les deux pilotes ont les autorisations pour être sur la place de droite => Le pilote 1 est sur la place de gauche le pilote 2 est sur la place de droite.

Type d'activité

  • Si un vol récupéré dans ClickAndTakeoff peut être associé à une réservation => Les types d'activités sont celles définies dans la réservation.
  • Si le vol ne peut être associé :
    • S'il y a deux pilotes et que le type d'activité par défaut pour deux pilotes est défini => Le type d'activité est celle définie par défaut.
    • S'il y a zero ou un pilote et que le type d'activité par défaut pour zero ou un pilote est défini => Le type d'activité est celle définie par défaut.
    • Si les types d'activité par défaut ne sont pas définies => Le type d'activité est le premier type d'activité trouvé.