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
m (Text replacement - "Fichier:" to "File:")
 
(90 intermediate revisions by 5 users not shown)
Line 1: Line 1:
=Présentation=
=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.
[[File:Boitier charterware.png]]


=Activation de l'interfaçage=
L'objet de cette page est de présenter :
Afin de permettre à OpenFlyers de s'interfacer avec Charterware, il faut :
*Le produit Charterware
*Créer différents [[Champs-métiers|champs métier]] :
*La configuration de l'interfaçage OpenFlyers avec Charterware
**[[Champs-métiers#charterwareUserId|Numéro d'utilisateur Charterware]]
*Son utilisation dans OpenFlyers
**[[Champs-métiers#charterwareResourceId|Numéro de ressource Charterware]]
 
**[[Champs-métiers#offBlockDate|Date off block]]
[https://www.charterware.de/index-en.html Charterware] est une société allemande qui commercialise un boitier qui s'installe dans un aéronef en le posant sur le tableau de bord et en le reliant par un câble à l'alimentation électrique de l'avion. Ce boitier enregistre les heures blocs :
**[[Champs-métiers#onBlockDate|Date on block]]
*Début du roulage
*Modifier les utilisateurs et les ressources afin de leur rajouter leurs numéros correspondants
*Décollage
*Activer le paramètre '''Gestion de Charterware''' dans le formulaire '''Structure->Paramétrage'''
*Atterrissage
*Cliquer sur le bouton enregistrer
*Fin du roulage
*Suite à cela, de [[Configuration#Gestion-de-Charterware|nouveaux paramétrages]] vont apparaître il faudra alors les configurer.
Ainsi que les facteurs de charges excessifs lors de l'atterrissage.
 
Le boitier transmet ces informations au serveur Charterware après le bloc arrivé et après que les pilotes aient badgé avec leur carte prévue à cet effet après avoir coupé le contact de l'aéronef. Ensuite, OpenFlyers récupère ces données (voir le chapitre ci-dessous [[#Données-récupérés-via-Charterware|données récupérées via Charterware]]).
 
Il est également possible de récupérer les traces de vols.
 
Pour la certification, voir le chapitre [[Technologies-de-géolocalisation-aéronautique#CS-STAN|CS-STAN]]. De plus Charterware dispose également d'un Minor Change Approval pour certains types d'aéronefs.
 
La tarification Charterware est disponible ici : https://www.charterware.de/price.html .
 
En 2019, les tarifs donnés par Charterware sont :
*Boitier + kit d'installation : 900 + 90 = 990 € HT soit 1178,10 € TTC avec 19% de TVA allemande
*Tag pour permettre à un 1 pilote de badger : 4,90 € HT soit 5,83 € TTC avec 19% de TVA allemande
*Abonnement pour une structure associative sans les traces de vol : 19 € HT/mois soit 22,80 € TTC/mois avec 20% de TVA française
*Abonnement pour une structure associative avec les traces de vol : 28 € HT/mois soit 33,60 € TTC/mois avec 20% de TVA française
*Abonnement pour une structure professionnelle : 49 € HT/mois
C'est la TVA française qui s'applique sur la location car le service est rendu en France.
 
Pour l'installation, il faut prévoir environ 300 € HT par aéronef selon l'atelier de maintenance. Le prix sera surement plus cher pour un seul appareil et moins cher pour une flotte importante car l'atelier devra passer du temps à lire le guide d'installation une fois et ensuite il pourra amortir ce temps sur les autres appareils.
 
Côté OpenFlyers, l’interconnexion avec Charterware est facturé 120 € HT/ressource/an pour les abonnements First-Price et Business. L'interconnexion est incluse dans les abonnements Business+ et Première.
 
OpenFlyers a sélectionné cette solution car elle est fiable et pérenne dans le temps. Nos concurrents nous ont suivi ;-)
 
==Chronologie de la mise en place==
La mise en place de Charterware et la synchronisation avec OpenFlyers suit la chronologie suivante :
*Achat des boitiers et souscription à l’abonnement de transmission des données chez Charterware.
*Installation des boitiers par l'atelier de maintenance ou l'atelier radio de la structure
*Interfaçage par OpenFlyers de la liaison entre la plateforme OpenFlyers et Charterware. Cela nécessite pour OpenFlyers de disposer des informations de connexion et les numéros d'aéronefs communiqués par Charterware.
Une fois que la configuration est faite par OpenFlyers, il reste à la structure à saisir les numéros de badges des utilisateurs : [[Gestion-des-utilisateurs#Saisir-le-numéro-d'utilisateur-Charterware|Saisir le numéro d'utilisateur Charterware]]
 
'''Points d'attention''' :
*L'interfaçage n'est pas mis en place sur les dépôts de test OpenFlyers.
*Si les aéronefs disposaient de la saisie des compteurs dans OpenFlyers, ces champs deviennent obsolètes et doivent être désactivés.
 
=Données récupérées 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)
*Rapport d'atterrissage dur
 
=Paramétrage des arrondis=
Charterware transmet à OpenFlyers des dates à la seconde. OpenFlyers fonctionne avec des dates à la minute. Il est donc nécessaire de définir des formules d'arrondis dans le [[Configuration#Gestion-de-Charterware|paramétrage de Charterware]] de la plateforme.
 
Les variables suivantes sont utilisables dans les formules :
*CHARTERWARE_ONBLOCK_DATE : Datetime de départ bloc
*CHARTERWARE_TAKEOFF_DATE : Datetime de décollage
*CHARTERWARE_LANDING_DATE : Datetime d’atterrissage
*CHARTERWARE_OFFBLOCK_DATE : Datetime de bloc arrivée
Ces variables sont directement transmises par Charterware.
 
Les fonctions suivantes peuvent être utilisées dans les formules :
*[[Formules-de-calcul#formatDate('patron',-'date')|formatDate]] : Permet de formater une date
*[[Formules-de-calcul#roundCeil(X,Y)|roundCeil]] : Arrondi à la minute supérieure la date transmise en paramètre
*[[Formules-de-calcul#roundFloor(X,Y)|roundFloor]] : Arrondi à la minute inférieure la date transmise en paramètre
*[[Formules-de-calcul#strtotime(string)|strtotime]] : Transforme une date en timestamp
=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'''
*[[Gestion-des-ressources#Saisir-le-numéro-de-ressource-pour-l'API-de-geolocalisation|Configurer le numéro de l'API de géolocalisation pour les ressources]].


=Récupération des vols Charterware=
=Récupération des vols Charterware=
Chaque minute un robot va chercher si de nouveaux vols ont été enregistré par Charterware. Si de nouveaux vols sont présents alors il va les sauvegarder dans OpenFlyers.
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 sauvegardés dans OpenFlyers et supprimés 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.


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é.
*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.


Une fois une réservation définie comme associées OpenFlyers utilise ses informations.
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 charterware :
*Il cherche s'il existe une réservation dont les horaires comprennent l'heure médiane du vol charterware. 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 Charterware.
**S'il y a plusieurs réservations, alors il n'en prend aucune.
**S'il y a une seule réservation :
***Si Charterware a transmis les identifiants pilotes alors le robot vérifie si ceux-ci correspondent à ceux de la réservation. Si c'est le cas il prend en compte les informations de la réservation.
***Si Charterware n'a pas transmis les identifiants pilotes, les informations de la réservation sont prises en compte.
 
Une fois qu'une réservation est identifiée comme correspondre au vol remonté par Charterware, les informations de la réservation sont prises en compte par le robot.
 
;Exemple :
Pour un vol exemple qui commence à 16h05 et se termine à 17h00, l'heure médiane serait 16h32 et 30 secondes. La réservation correspondante pour ce vol serait celle qui inclut cette heure médiane.


Les données suivantes sont alors récupérées :
Les données suivantes sont alors récupérées :
Line 26: Line 118:
*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 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 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.
**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 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.
**Si le pilote est sur la seconde place => Le statut du pilote est le statut "Instructeur" si il n'existe pas le second statut.


==La place des pilotes==
==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 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 le vol ne peut être associé :  
**Si il y a un seul pilote => Sa place est celle par défaut (0, Gauche).
**S'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.
**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.
**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.


==Le type d'activité==
==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 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 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.
**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.
**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.
**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 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é.
**Si 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=
=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 [[Interfaçage-OpenFlyers-et-Charterware#Activation-de-l'interfaçage|paramètres]] vus précédemment.
Charterware propose en option à son abonnement d'enregistrer les traces de vols. Cf. la [[#Présentation|présentation]].
Le robot fonctionne ainsi :
 
*Recherche d'emails dans la boîte de réception.
Les traces de vols sont constituées de points enregistrés à une fréquence variable qui dépend de la trajectoire ou de la vitesse de l'aéronef :
*Recherche de l'objet de l'email.
*1 point tous les 3 secondes pour le roulage
*Recherche de la pièce jointe de l'email.
*1 point toutes les 25 secondes en vol en ligne droite
*Recherche du vol associé à l'email (par date et par aéronef)
*1 point toutes les secondes en montée et en descente
*Ajout de la trace de vol dans OpenFlyers
*1 point tous les 10 degrés d'angle en virage
*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 [[Carnet-de-route#Traces-de-vols|Activités > Carnet de route]] et '''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 [[Gestion-des-profils#Visualiser-les-traces-de-vol|Visualiser les traces de vol]].


Les traces de vols sont téléchargeables depuis les interfaces '''Activités > Carnet de route''' et '''Activités > Carnet de vol'''.
=Troubleshooting=
==Activité vol non créée automatiquement dans OpenFlyers==
Procédure à suivre dans le cas où un vol a été effectué sur un appareil équipé d'un boitier Charterware et que l'activité vol correspondante n'apparait pas dans OpenFlyers.
*Allumer le boitier Charterware de l'aéronef concerné pour lancer une nouvelle tentative de transmission des données. Contrôler l'affichage du boitier pour voir s'il s'éteint de lui-même au bout de 2 minutes. Ce n'est que lorsqu'il s'éteint avec aucun texte d'affiché que la transmission s'est effectuée. Dans le cas contraire, cela veut dire qu'il y a un problème de transmission entre le boitier et le serveur Charterware. Il est probable que ce problème de transmission soit un problème de réseau. Dans ce cas là, il faut retenter le processus lorsque la transmission réseau est meilleure.
Une fois que le boitier s'est éteint de lui-même, dans les 10 minutes qui suivent, la synchronisation entre le serveur Charterware et celui d'OpenFlyers se fait.
*Vérifier à nouveau si le vol apparait dans OpenFlyers
**Si le vol est présent, la procédure est terminée
**Si le vol est toujours manquant effectuer les actions suivantes
*Se connecter à l'interface Charterware et voir si le vol apparait
**Si le vol apparait, faire une copie d'écran de l'interface et la transmettre à OpenFlyers pour qu'il puisse investiguer sur la non création automatique de l'activité vol dans la plateforme OpenFlyers
**Si le vol n'apparait pas, contacter Charterware pour investigation

Latest revision as of 17:27, 2 October 2024

Présentation

Boitier charterware.png

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

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

Charterware est une société allemande qui commercialise un boitier qui s'installe dans un aéronef en le posant sur le tableau de bord et en le reliant par un câble à l'alimentation électrique de l'avion. Ce boitier enregistre les heures blocs :

  • Début du roulage
  • Décollage
  • Atterrissage
  • Fin du roulage

Ainsi que les facteurs de charges excessifs lors de l'atterrissage.

Le boitier transmet ces informations au serveur Charterware après le bloc arrivé et après que les pilotes aient badgé avec leur carte prévue à cet effet après avoir coupé le contact de l'aéronef. Ensuite, OpenFlyers récupère ces données (voir le chapitre ci-dessous données récupérées via Charterware).

Il est également possible de récupérer les traces de vols.

Pour la certification, voir le chapitre CS-STAN. De plus Charterware dispose également d'un Minor Change Approval pour certains types d'aéronefs.

La tarification Charterware est disponible ici : https://www.charterware.de/price.html .

En 2019, les tarifs donnés par Charterware sont :

  • Boitier + kit d'installation : 900 + 90 = 990 € HT soit 1178,10 € TTC avec 19% de TVA allemande
  • Tag pour permettre à un 1 pilote de badger : 4,90 € HT soit 5,83 € TTC avec 19% de TVA allemande
  • Abonnement pour une structure associative sans les traces de vol : 19 € HT/mois soit 22,80 € TTC/mois avec 20% de TVA française
  • Abonnement pour une structure associative avec les traces de vol : 28 € HT/mois soit 33,60 € TTC/mois avec 20% de TVA française
  • Abonnement pour une structure professionnelle : 49 € HT/mois

C'est la TVA française qui s'applique sur la location car le service est rendu en France.

Pour l'installation, il faut prévoir environ 300 € HT par aéronef selon l'atelier de maintenance. Le prix sera surement plus cher pour un seul appareil et moins cher pour une flotte importante car l'atelier devra passer du temps à lire le guide d'installation une fois et ensuite il pourra amortir ce temps sur les autres appareils.

Côté OpenFlyers, l’interconnexion avec Charterware est facturé 120 € HT/ressource/an pour les abonnements First-Price et Business. L'interconnexion est incluse dans les abonnements Business+ et Première.

OpenFlyers a sélectionné cette solution car elle est fiable et pérenne dans le temps. Nos concurrents nous ont suivi ;-)

Chronologie de la mise en place

La mise en place de Charterware et la synchronisation avec OpenFlyers suit la chronologie suivante :

  • Achat des boitiers et souscription à l’abonnement de transmission des données chez Charterware.
  • Installation des boitiers par l'atelier de maintenance ou l'atelier radio de la structure
  • Interfaçage par OpenFlyers de la liaison entre la plateforme OpenFlyers et Charterware. Cela nécessite pour OpenFlyers de disposer des informations de connexion et les numéros d'aéronefs communiqués par Charterware.

Une fois que la configuration est faite par OpenFlyers, il reste à la structure à saisir les numéros de badges des utilisateurs : Saisir le numéro d'utilisateur Charterware

Points d'attention :

  • L'interfaçage n'est pas mis en place sur les dépôts de test OpenFlyers.
  • Si les aéronefs disposaient de la saisie des compteurs dans OpenFlyers, ces champs deviennent obsolètes et doivent être désactivés.

Données récupérées 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)
  • Rapport d'atterrissage dur

Paramétrage des arrondis

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

Les variables suivantes sont utilisables dans les formules :

  • CHARTERWARE_ONBLOCK_DATE : Datetime de départ bloc
  • CHARTERWARE_TAKEOFF_DATE : Datetime de décollage
  • CHARTERWARE_LANDING_DATE : Datetime d’atterrissage
  • CHARTERWARE_OFFBLOCK_DATE : Datetime de bloc arrivée

Ces variables sont directement transmises par Charterware.

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 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
  • Configurer le numéro de l'API de géolocalisation pour les ressources.

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 sauvegardés dans OpenFlyers et supprimés 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 avec la même ressource correspondant au vol communiqué par charterware :

  • Il cherche s'il existe une réservation dont les horaires comprennent l'heure médiane du vol charterware. 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 Charterware.
    • S'il y a plusieurs réservations, alors il n'en prend aucune.
    • S'il y a une seule réservation :
      • Si Charterware a transmis les identifiants pilotes alors le robot vérifie si ceux-ci correspondent à ceux de la réservation. Si c'est le cas il prend en compte les informations de la réservation.
      • Si Charterware n'a pas transmis les identifiants pilotes, les informations de la réservation sont prises en compte.

Une fois qu'une réservation est identifiée comme correspondre au vol remonté par Charterware, les informations de la réservation sont prises en compte par le robot.

Exemple

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

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é :
    • 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 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é :
    • 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 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é :
    • 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é.

Récupération des traces de vols

Charterware propose en option à son abonnement d'enregistrer les traces de vols. Cf. la présentation.

Les traces de vols sont constituées de points enregistrés à une fréquence variable qui dépend de la trajectoire ou de la vitesse de l'aéronef :

  • 1 point tous les 3 secondes pour le roulage
  • 1 point toutes les 25 secondes en vol en ligne droite
  • 1 point toutes les secondes en montée et en descente
  • 1 point tous les 10 degrés d'angle en virage

Les traces de vols sont téléchargeables depuis les interfaces Activités > Carnet de route et 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.

Troubleshooting

Activité vol non créée automatiquement dans OpenFlyers

Procédure à suivre dans le cas où un vol a été effectué sur un appareil équipé d'un boitier Charterware et que l'activité vol correspondante n'apparait pas dans OpenFlyers.

  • Allumer le boitier Charterware de l'aéronef concerné pour lancer une nouvelle tentative de transmission des données. Contrôler l'affichage du boitier pour voir s'il s'éteint de lui-même au bout de 2 minutes. Ce n'est que lorsqu'il s'éteint avec aucun texte d'affiché que la transmission s'est effectuée. Dans le cas contraire, cela veut dire qu'il y a un problème de transmission entre le boitier et le serveur Charterware. Il est probable que ce problème de transmission soit un problème de réseau. Dans ce cas là, il faut retenter le processus lorsque la transmission réseau est meilleure.

Une fois que le boitier s'est éteint de lui-même, dans les 10 minutes qui suivent, la synchronisation entre le serveur Charterware et celui d'OpenFlyers se fait.

  • Vérifier à nouveau si le vol apparait dans OpenFlyers
    • Si le vol est présent, la procédure est terminée
    • Si le vol est toujours manquant effectuer les actions suivantes
  • Se connecter à l'interface Charterware et voir si le vol apparait
    • Si le vol apparait, faire une copie d'écran de l'interface et la transmettre à OpenFlyers pour qu'il puisse investiguer sur la non création automatique de l'activité vol dans la plateforme OpenFlyers
    • Si le vol n'apparait pas, contacter Charterware pour investigation