Interfaçage OpenFlyers et Carnet.aero: Difference between revisions

From Documentation de la solution web de gestion OpenFlyers
Jump to navigation Jump to search
 
(21 intermediate revisions by 2 users not shown)
Line 2: Line 2:


=Présentation=
=Présentation=
L'objet de cette page est de présenter :
L'objet de cette page est de présenter la synchronisation de https://www.carnet.aero/ avec OpenFlyers. Cette application permet à chaque pilote de disposer de son carnet de vol numérique. Lorsqu'il est synchronisé avec OpenFlyers, la saisie d'un vol dans OpenFlyers remonte automatiquement vers Carnet.aero.
*Le service [https://www.carnet.aero/ Carnet.aero]
*La configuration de l'interfaçage OpenFlyers avec [https://www.carnet.aero/ Carnet.aero]
*Son utilisation dans OpenFlyers


[https://carnet.aero Carnet.aero] est une plateforme de carnet de vol numérique. L'interfaçage permet la synchronisation automatique des vols saisis dans OpenFlyers vers le carnet de vol personnel des pilotes sur [https://www.carnet.aero/ Carnet.aero].


L'API permet une intégration transparente : chaque création, modification ou suppression de vol dans OpenFlyers est répercutée quasi-instantanément sur le compte [https://www.carnet.aero/ Carnet.aero] des pilotes concernés.
Sur la plupart des plateformes OpenFlyers, l'administrateur de la plateforme n'a pas d'action à effectuer : l'association des statuts pilote - au sens OpenFlyers - avec les fonctions - au sens Carnet.aero - est automatique.


;La synchronisation automatique s'effectue dans les conditions suivantes
Néanmoins, il est possible de vérifier/mettre à jour cette association en suivant la procédure [[#Configurer-les-fonctions-Carnet.aero|Configurer les fonctions Carnet.aero]].


*Elle se produit après chaque insertion, modification ou suppression d'un vol dans OpenFlyers.
 
Par contre, chaque pilote souhaitant interfacer son compte OpenFlyers avec son compte Carnet.aero doit suivre la procédure [[#Configurer-les-identifiants-utilisateur-Carnet.aero|Configurer les identifiants utilisateur Carnet.aero]].
 
Une fois l'interfaçage du compte OpenFlyers effectué avec le compte Carnet.aero, le pilote peut [[Interfaçage OpenFlyers et Carnet.aero#Synchroniser manuellement|synchroniser manuellement]] pour envoyer tous les vols éligibles et non encore synchronisés.
 
 
;Synchronisation automatique entre OpenFlyers et Carnet.aero
*Le pilote doit avoir renseigné [[Fiche personnelle#Synchronisation des activités|les identifiants Carnet.aero]].
*Le pilote doit avoir renseigné [[Fiche personnelle#Synchronisation des activités|les identifiants Carnet.aero]].
*La date du vol doit être postérieure ou égale à la "Date de début de synchronisation" définie par le pilote.
*La date du vol doit être postérieure ou égale à la "Date de début de synchronisation" définie par le pilote.
*Le statut du pilote sur le vol (ex: Commandant de bord, Élève) doit être associée à une fonction [https://www.carnet.aero/ Carnet.aero] correspondante dans le paramétrage d'OpenFlyers.
*Elle se produit après chaque insertion, modification ou suppression d'un vol dans OpenFlyers.
 
*Le statut du pilote sur le vol (ex: Commandant de bord, Élève) doit être associé à une fonction [https://www.carnet.aero/ Carnet.aero] correspondante dans le paramétrage d'OpenFlyers.
; La synchronisation peut également être [[Interfaçage OpenFlyers et Carnet.aero#Synchroniser manuellement|lancée manuellement]] depuis la fiche personnelle du pilote, pour envoyer tous les vols éligibles et non encore synchronisés.


=Les données envoyées à Carnet.aero=
=Données envoyées à Carnet.aero=
Lors de la synchronisation, les informations suivantes sont transmises à [https://www.carnet.aero/ Carnet.aero] :
Lors de la synchronisation, les informations suivantes sont transmises à [https://www.carnet.aero/ Carnet.aero] :


Line 40: Line 41:
=Procédures=
=Procédures=


==[[Gestion-des-statuts#Fonction_Carnet.aero|Configurer les fonctions Carnet.aero]]==
==Configurer les fonctions Carnet.aero==
Pour que la synchronisation fonctionne, un administrateur doit configurer le mapping des statuts.
Pour que la synchronisation fonctionne, il faut définir une fonction Carnet.aero pour chaque statut pilote défini dans OpenFlyers.
 
;Procédure
*Aller sur la page '''Admin > Utilisateurs > Statuts'''
*[[Gestion des statuts#Modifier un statut|Sélectionner]] la fonction appropriée dans la liste déroulante dans la colonne '''Fonction Carnet.aero'''
 
==Configurer les identifiants utilisateur Carnet.aero==
Pour qu'un pilote puisse synchroniser ses vols dans Carnet.aero, il doit préalablement renseigner son couple identifiant/clé secrète [https://www.carnet.aero/ Carnet.aero] dans sa fiche personnelle en suivant la procédure : [[Fiche-personnelle#Synchroniser-les-activités-avec-Carnet.aero|Synchroniser les activités avec Carnet.aero]].


==[[Fiche-personnelle#Synchronisation-des-activités|Configurer les identifiants utilisateur Carnet.aero]]==
==Forcer la synchronisation avec Carnet.aero==
Chaque pilote doit renseigner ses identifiants [https://www.carnet.aero/ Carnet.aero] dans sa fiche personnelle pour activer la synchronisation.
[[File:2025-12-04-11-48-51-Affichage-et-fiche-personnelle---Brave.png|alt=Synchroniser]]
 
Une fois que le couple identifiant/clé secrète est renseigné, il est possible de forcer la synchronisation dans Carnet.aero des vols existants dans OpenFlyers.


==Synchroniser manuellement==
;Prérequis
;Prérequis
*Il faut avoir mis en place la [[Fiche-personnelle#Synchronisation-des-activités|synchronisation des activités]] pour Carnet.aero
*Il faut avoir mis en place la [[Fiche-personnelle#Synchroniser-les-activités-avec-Carnet.aero|synchronisation des activités avec Carnet.aero]].


;Procédure
;Procédure
Il est possible de forcer la synchronisation des vols existants (par exemple après avoir configuré les identifiants pour la première fois).
*Aller dans '''[[Fiche-personnelle#Synchroniser-les-activités-avec-Carnet.aero|Planning > Données > Personnelles > Affichage et fiche personnelle]]'''
[[File:2025-12-04-11-48-51-Affichage-et-fiche-personnelle---Brave.png|alt=Synchroniser|thumb]]
*Cliquer sur le bouton '''Forcer la Synchronisation avec Carnet.aero'''
*Aller dans '''[[Fiche personnelle#Synchronisation-des-activités|Planning > Données > Personnelles > Affichage et fiche personnelle]]'''
*Cliquer sur le bouton '''Forcer la Synchronisationavec Carnet.aero'''
Le système va alors tenter de synchroniser tous les vols éligibles (postérieurs à la date de début de synchronisation) qui n'ont pas encore été synchronisés.
Le système va alors tenter de synchroniser tous les vols éligibles (postérieurs à la date de début de synchronisation) qui n'ont pas encore été synchronisés.
==Récupérer les identifiants API sur Carnet.aero==
* Se connecter sur le site [https://www.carnet.aero/Connexion.aspx carnet.aero].
* Cliquer en haut à droite sur le bouton '''Paramètres'''.
[[File:Carnet.aero parameter.png|250px]]
* Dans le menu des paramètres, sélectionner l'onglet '''API'''.
* Copier les identifiants API suivants :
** '''UserId''' : à utiliser dans ''Identifiant Utilisateur Carnet.aero''.
** '''UserSecretKey''' : à utiliser dans ''Clé secrète utilisateur Carnet.aero''.
[[File:2025-12-04-14-28-09-Paramètres---Carnet.aero---Brave.png|alt=Identifiants Carnet.aero|900px]]

Latest revision as of 14:22, 5 December 2025

Présentation

L'objet de cette page est de présenter la synchronisation de https://www.carnet.aero/ avec OpenFlyers. Cette application permet à chaque pilote de disposer de son carnet de vol numérique. Lorsqu'il est synchronisé avec OpenFlyers, la saisie d'un vol dans OpenFlyers remonte automatiquement vers Carnet.aero.


Sur la plupart des plateformes OpenFlyers, l'administrateur de la plateforme n'a pas d'action à effectuer : l'association des statuts pilote - au sens OpenFlyers - avec les fonctions - au sens Carnet.aero - est automatique.

Néanmoins, il est possible de vérifier/mettre à jour cette association en suivant la procédure Configurer les fonctions Carnet.aero.


Par contre, chaque pilote souhaitant interfacer son compte OpenFlyers avec son compte Carnet.aero doit suivre la procédure Configurer les identifiants utilisateur Carnet.aero.

Une fois l'interfaçage du compte OpenFlyers effectué avec le compte Carnet.aero, le pilote peut synchroniser manuellement pour envoyer tous les vols éligibles et non encore synchronisés.


Synchronisation automatique entre OpenFlyers et Carnet.aero
  • Le pilote doit avoir renseigné les identifiants Carnet.aero.
  • La date du vol doit être postérieure ou égale à la "Date de début de synchronisation" définie par le pilote.
  • Elle se produit après chaque insertion, modification ou suppression d'un vol dans OpenFlyers.
  • Le statut du pilote sur le vol (ex: Commandant de bord, Élève) doit être associé à une fonction Carnet.aero correspondante dans le paramétrage d'OpenFlyers.

Données envoyées à Carnet.aero

Lors de la synchronisation, les informations suivantes sont transmises à Carnet.aero :

Données systématiquement transmises :

  • Date du vol
  • Fonction à bord : Déterminée par le statut configué dans Fonctions Carnet.aero.
  • Temps total : Durée du vol en minutes.
  • Aéronef : Immatriculation et modèle de l'aéronef.

Données transmises si disponibles :

  • Heures bloc : Heure de départ et d'arrivée en TU.
  • Décollage/atterrissage : Codes OACI des aérodromes de départ et d'arrivée.
  • Nombre d'atterrissages
  • Nature du vol : Les types d'activités OpenFlyers sont envoyés comme "Tags". Le tag "Instruction" est ajouté automatiquement pour les vols avec deux pilotes dont l'un a le statut "Instructeur" au sens OpenFlyers/Carnet.aero.
  • Remarques : Les commentaires saisis sur le vol.
  • Temps spécifiques : Durée de l'activité.
  • Équipage : Les noms des autres membres d'équipage (Instructeur, Élève, Copilote, Examinateur) sont transmis selon le statut de chaque personne sur le vol.

Procédures

Configurer les fonctions Carnet.aero

Pour que la synchronisation fonctionne, il faut définir une fonction Carnet.aero pour chaque statut pilote défini dans OpenFlyers.

Procédure
  • Aller sur la page Admin > Utilisateurs > Statuts
  • Sélectionner la fonction appropriée dans la liste déroulante dans la colonne Fonction Carnet.aero

Configurer les identifiants utilisateur Carnet.aero

Pour qu'un pilote puisse synchroniser ses vols dans Carnet.aero, il doit préalablement renseigner son couple identifiant/clé secrète Carnet.aero dans sa fiche personnelle en suivant la procédure : Synchroniser les activités avec Carnet.aero.

Forcer la synchronisation avec Carnet.aero

Synchroniser

Une fois que le couple identifiant/clé secrète est renseigné, il est possible de forcer la synchronisation dans Carnet.aero des vols existants dans OpenFlyers.

Prérequis
Procédure

Le système va alors tenter de synchroniser tous les vols éligibles (postérieurs à la date de début de synchronisation) qui n'ont pas encore été synchronisés.

Récupérer les identifiants API sur Carnet.aero

  • Se connecter sur le site carnet.aero.
  • Cliquer en haut à droite sur le bouton Paramètres.

Carnet.aero parameter.png

  • Dans le menu des paramètres, sélectionner l'onglet API.
  • Copier les identifiants API suivants :
    • UserId : à utiliser dans Identifiant Utilisateur Carnet.aero.
    • UserSecretKey : à utiliser dans Clé secrète utilisateur Carnet.aero.

Identifiants Carnet.aero