Interfaçage OpenFlyers et Charterware: Difference between revisions

From Documentation de la solution web de gestion OpenFlyers
Jump to navigation Jump to search
imported>Claratte
imported>Claratte
Line 34: Line 34:
*Si l'identifiant d'un aéronef Charterware ne peut être retrouvé dans OpenFlyers alors le robot n'enregistrera pas le vol.
*Si l'identifiant d'un aéronef Charterware 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 correspondant au vol communiqué par charterware. Pour ce faire Openflyers cherche s'il existe une réservation avec la même ressource et dont les horaires comprennent l'heure médiane du vol charterware. Si aucun vol n'a pu être trouvé alors OpenFlyers, cherche si une réservation avec la même ressource a ses horaires comprise entre le début et la fin du vol remonté par Charterware. Si plusieurs réservations sont trouvé aucune n'est associées. Si un vol a pu être trouvé et que Charterware a transmis les pilotes alors OpenFlyers vérifie si ceux-ci correspondent à ceux de la réservation. Si c'est le cas OpenFlyers, considère que le vol correspond à la réservation. Si un vol a pu être trouvé, mais que Charterware n'a pas transmis de pilote le vol est directement associé.
Afin de retrouver un maximum d'informations le robot tente de retrouver une réservation correspondant au vol communiqué par charterware. Pour ce faire Openflyers cherche s'il existe une réservation avec la même ressource et dont les horaires comprennent l'heure médiane du vol charterware. Si aucun vol n'a pu être trouvé, alors OpenFlyers cherche si une réservation avec la même ressource a ses horaires comprise entre le début et la fin du vol remonté par Charterware. Si plusieurs réservations sont trouvé aucune n'est associées. Si un vol a pu être trouvé et que Charterware a transmis les pilotes alors OpenFlyers vérifie si ceux-ci correspondent à ceux de la réservation. Si c'est le cas OpenFlyers, considère que le vol correspond à la réservation. Si un vol a pu être trouvé, mais que Charterware n'a pas transmis de pilote le vol est directement associé.


Une fois une réservation définie comme associées OpenFlyers utilise ses informations.
Une fois une réservation définie comme associées OpenFlyers utilise ses informations.

Revision as of 06:19, 6 June 2019

Présentation

L'objet de cette page est de présenter la configuration de l'interfaçage d'OpenFlyers avec Charterware et l'utilisation associée.

La mise en place de Charterware nécessite d’acheter le boîtier et de souscrire à l’abonnement de transmission des données. La tarification est disponible ici : https://www.charterware.de/price.html. Côté OpenFlyers, l’interfaçage ne génère aucun coût supplémentaire.

Activation de l'interfaçage

Afin de permettre à OpenFlyers de s'interfacer avec Charterware, il faut :

Données récupérés via Charterware

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

  • Aéronef utilisé (donnée planecode)
  • Horodatage du début du vol (donnée offblock)
  • Durée du vol (par calcul de la différence entre les données offblock et onblock)
  • Temps en l'air (par calcul de la différence entre les données landing et takeoff)
  • Personnes à bord (données pilot1 et pilot2)
  • Lieu de départ (donnée flightfrom)
  • Lieu d'arrivé (donnée flightto)
  • Nombre d’atterrissage (donnée nooflandings)

Récupération des vols Charterware

Chaque minute le robot OpenFlyers interroge le serveur Charterware pour savoir si de nouveaux vols ont été enregistrés par Charterware. Si c'est le cas, alors il sont sauvegarder dans OpenFlyers et supprimer des vols en attente de récupération côté Charterware.

Charterware 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 utilisateur Charterware ne peut être retrouvé dans OpenFlyers alors le robot se comporte comme si les pilotes n'avaient pas été transmis par Charterware.
  • Si l'identifiant d'un aéronef Charterware 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 correspondant au vol communiqué par charterware. Pour ce faire Openflyers cherche s'il existe une réservation avec la même ressource et dont les horaires comprennent l'heure médiane du vol charterware. Si aucun vol n'a pu être trouvé, alors OpenFlyers cherche si une réservation avec la même ressource a ses horaires comprise entre le début et la fin du vol remonté par Charterware. Si plusieurs réservations sont trouvé aucune n'est associées. Si un vol a pu être trouvé et que Charterware a transmis les pilotes alors OpenFlyers vérifie si ceux-ci correspondent à ceux de la réservation. Si c'est le cas OpenFlyers, considère que le vol correspond à la réservation. Si un vol a pu être trouvé, mais que Charterware n'a pas transmis de pilote le vol est directement associé.

Une fois une réservation définie comme associées OpenFlyers utilise ses informations.

Les données suivantes sont alors récupérées :

Statut des pilotes

Pour chaque pilote :

  • Si un vol récupéré dans Charterware 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é :
    • Si 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 Charterware 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é :
    • Si il y a un seul pilote => Sa place est celle par défaut (0, Gauche).
    • Si 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 Charterware 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é :
    • Si 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.
    • Si il y a un pilote et que le type d'activité par défaut pour un pilote est défini => Le type d'activité est celle définie par défaut.
    • Si il y a aucun pilote ou que les types d'activité par défaut ne sont pas définies => Le type d'activité est le premier type d'activité trouvé.

Récupération des traces de vols

Pour chaque vol détecté par Charterware une trace de vol est envoyé en pièce jointe d'un mail par Charterware (fichier au format kml). Un robot mis en place par OpenFlyers va chercher chaque minute si de nouveaux mails ont été transmis par OpenFlyers. La connexion à la messagerie se fait via les paramètres vus précédemment. Le robot fonctionne ainsi :

  • Recherche d'emails dans la boîte de réception.
  • Recherche de l'objet de l'email.
  • Recherche de la pièce jointe de l'email.
  • Recherche du vol associé à l'email (par date et par aéronef)
  • Ajout de la trace de vol dans OpenFlyers
  • Déplacement de l'email dans le répertoire parsed_flight_track de la messagerie.

Pour rechercher le vol, le robot se base sur l'objet des e-mails. Les e-mails envoyés par Charterware ayant des objets composés ainsi "Nom de l'aéronef" "Date offblock" Il est alors possible de retrouver le vol associé en utilisant ces deux données. Une fois l'e-mail traité, il est déplacé dans le répertoire parsed_flight_track. Si ce répertoire n'existe pas, il est alors créé.

Les traces de vols sont téléchargeables depuis les interfaces Activités > Carnet de route et Activités > Carnet de vol.