AERAL and Interfaçage OpenFlyers et Gesasso: Difference between pages

From Documentation de la solution web de gestion OpenFlyers
(Difference between pages)
Jump to navigation Jump to search
imported>Claratte
 
imported>Ozerhouni
 
Line 1: Line 1:
=Présentation=
= Présentation =
Acquisition et Exploitation des Rapports d'activités de l'Aviation Légère : https://www.formulaires.service-public.fr/gf/cerfa_12806.do .
L'objet de cette page est de présenter :
* Le produit Gesasso
* La configuration de l'interfaçage OpenFlyers avec Gesasso
* Son utilisation dans OpenFlyers


=Admin > Structure > Paramétrage > Export Aeral=
[https://www.ffvp.fr/tag/gesasso FFVP-Gesasso] est une plateforme utilisée pour la gestion des activités des clubs au sein de la Fédération Française de Vol à Voile (FFVP). Cette plateforme vise à faciliter la gestion des qualifications, de la formation et des activités de club sous l'égide de la FFVP. Elle est accessible à toutes les parties prenantes, y compris les stagiaires, les pilotes, les instructeurs et les responsables de club, et offre un accès gratuit.
Afin de pouvoir générer les statistiques Aeral, il faut que toutes les questions du formulaire soient complétées. Ce dernier est pré-rempli automatiquement avec les données de la structure grâce à l'utilisation de [[#Prédictions|prédictions]] lors de la première tentative de génération des statistiques Aeral depuis [[#Gestion->-Rapports->-Rapports-spécifiques->-Export-Aeral|Gestion > Rapports > Rapports spécifiques > Export Aeral]].


Il est donc fortement recommandé de générer une première fois les statistiques '''AVANT''' d'éditer le contenu du paramétrage. En effet, une fois que les données de paramétrage des statistiques Aeral sont stockées, la prédiction est désactivée pour ne pas réinitialiser les valeurs enregistrées.
Pour les structures qui souhaitent bénéficier de cette intégration, il faut prendre contact avec la FFVP afin d'obtenir les données d'identification nécessaires pour le code WSSE. Une fois ces informations fournies, l'interface se synchronisera automatiquement en temps réel à chaque création, mise à jour ou suppression de vols dans OpenFlyers avec les enregistrements de Gesasso.


Après une première génération des statistiques, le gestionnaire est invité à vérifier les paramètres pré-remplis du formulaire, à les corriger le cas échéant, et à renseigner manuellement les éléments restants.
L'API permet une intégration transparente, assurant que toutes les données essentielles soient automatiquement mises à jour et partagées entre les deux systèmes, sans nécessiter une intervention technique de la part des utilisateurs.


les données récupérées de ce formulaire affectent directement la manière dont le robot OpenFlyers traite les rapports. Si une données n'est pas présente dans le paramétrage de la structure, le gestionnaire doit sélectionner le choix '''Non applicable'''.
;La synchronisation automatiquement s'effectue dans les conditions suivants :


==Coordonnées==
*Elle se produit après chaque insertion, modification ou suppression d'un vol dans OpenFlyers.
*'''Code_FFA'''
*Seuls les ressources de type "planeur" avec une valeur dans le champ "immatriculation d'aéronef dans Gesasso" seront synchronisées.
*'''Département'''
*Les modifications apportées aux vols dans OpenFlyers déclencheront une synchronisation automatique pour mettre à jour les données du côté Gesasso. Si ce vol n'existe pas du côté Gesasso, il sera créé.
*'''Région aéronautique'''
*'''Délégation régionale'''
*'''Date agrément DGAC'''
*'''Préfecture Agrément DGAC'''
*'''Numéro ATO'''
*'''Date d'obtention de l'ATO'''
*'''Numéro DTO'''
*'''Date d'obtention du DTO'''
*'''APE'''


==Tarifs==
'''NB:''' Pour les paramètres de l'heure de décollage et d'atterrissage, ils sont remplis par la date de début et la date de fin du vol car il n'y a pas d'informations correspondantes sur les horaires de décollage et d'atterrissage du côté d'Openflyers.
Les informations renseignées sont utilisées par le robot OpenFlyers pour générer le tableau [[#Tarifs|Tarifs]] du rapport Aeral.


==Validités correspondant à la cotisation de la structure==
=Procédures=
Les validités cochées dans cette partie sont utilisées par le robot OpenFlyers dans les tableaux [[#Adhérents-par-activité-X|Adhérents par activité X]] du rapport Aeral afin de déterminer les utilisateurs inscrits dans la structure durant l'année considérée.
==Interfacer OpenFlyers avec Gesasso==
;Activer Gesasso
*Aller dans '''Admin > Structure > Paramétrage > Activités'''
*Activer l'interrupteur '''Gesasso''' situé dans la 4ème colonne
*Renseigner les champs '''Code Gesasso FFVP''', '''Nom d'utilisateur''' et '''Mot de passe''' avec les éléments communiqués par la FFVP pour s'interfacer à l'API de Gesasso.
*Cliquer sur le bouton '''Enregistrer'''
;Activer la synchronisation automatique pour une ressource
*Aller dans '''Gestion > Ressources > Actives'''
Pour chaque ressource pour laquelle les vols doivent remonter dans Gesasso :
*Cliquer sur le bouton symbolisant un crayon
*Renseigner le champ '''Immatriculation dans Gesasso''' avec le nom de l'aéronef paramétré dans Gesasso
*Cliquer sur le bouton '''Enregistrer'''
;Activer le champ "Moyen de mise en l'air"
Pour chaque type de ressource où l'information sur le "Moyen de mise en l'air" est nécessaire, appliquer les étapes suivantes :
*Accéder à Admin > Structure > Type de ressource > Actifs
*Cliquer sur le bouton symbolisant un crayon pour le type de ressource concernée
*Activer l'interrupteur "Faire apparaître le champ 'Moyen de mise en l'air'"
*Cliquer sur le bouton '''Enregistrer'''


==Validités désignant les brevetés==
==Réinitialiser le mot de passe de la préprod de Gesasso==
Les validités sélectionnées dans ce champ permettent de définir les validités qui permettent de savoir une personne dispose d'un brevet ou non et donc par différence les personnes qui ne disposent d'aucun brevet sont considérées comme des élèves. Cette catégorisation des personnes est utilisée dans les rapports [[#Adhérents-par-activité-X|Adhérents par activité X]].
*Aller sur http://preprod-licences.ffvp.stadline.com/guard/login
*Cliquer sur '''se connecter via moncompte.ffvp.fr'''
*Cliquer sur '''mot de passe oublié'''
*Saisir le numéro de membre
Un email de réinitialisation du mot de passe de l'espace préprod est envoyé
*Suivre les instructions dans l'email


==Activités pratiquées==
==Se connecter sur la préprod de Gesasso==
Cocher les activités pratiquées par la structure.
;Prérequis
*Disposer d'un couple identifiant/mot de passe pour se connecter à la préprod. Si le mot de passe n'est pas connu, suivre la procédure [[#Réinitialiser-le-mot-de-passe-de-la-préprod-de-Gesasso|Réinitialiser le mot de passe de la préprod de Gesasso]]


Les paramètres de cette partie sont utilisées par le robot OpenFlyers pour générer les tableaux [[#Activité-en-instruction-et-Activité-hors-instruction|Activité en instruction et Activité hors instruction]] ainsi que pour le tableau [[#Instructeurs|Instructeurs]] (pour la partie '''solo supervisé''') du rapport Aeral.
;Procédure
*Aller sur https://preprod.gesasso.ffvp.stadline.com/association/730901/partenaires
*Saisir le numéro de membre et le mot de passe de la préprod


==Correspondance activités / typologie des vols Aeral==
==Tester la synchronisation automatique==
Pour tester la synchronisation automatique des vols d'OpenFlyers vers Gesasso :


==Matériels==
* Accéder à la plateforme de test sur https://openflyers.com/xxxx.test/index.php où xxxx est le nom de la plateforme.
Cocher le matériel dont dispose la structure.
* [[Interfaçage-OpenFlyers-et-Gesasso#Interfacer-OpenFlyers-avec-Gesasso|Effectuer le paramétrage requis]]
 
* Après le paramétrage, la synchronisation automatique peut être exécutée. Pour la tester, créer un vol de démonstration et observer si aucun message d'erreur n'apparaît et si le vol existe du côté de Gesasso et non.
==Terrain==
Renseigner les informations concernant l'aérodrome utilisé.
 
==Bureau==
Définir les personnelles exerçant les fonctions définies.
 
==Personnel==
Renseigner les informatiques statistiques concernant le personnel.
 
==Profil des adhérents non pilotes==
Le profil sélectionné dans cette partie est utilisé par le robot OpenFlyers dans les tableaux [[#Adhérents-par-activité-X|Adhérents par activité X]] du rapport Aeral afin de déterminer les utilisateurs inscrits dans la structure qui rentrent la catégorie '''non pilotes'''.
 
==Profil(s) désignant les instructeurs==
Définir le profil permettant de désigner les utilisateurs instructeurs.
 
Ce profil est utilisé par le robot OpenFlyers pour lister les utilisateurs dans le tableau [[#Instructeurs|Instructeurs]] du rapport Aeral.
 
=Gestion > Rapports > Rapports spécifiques > Export Aeral=
Avant de générer le bilan annuel, il faut s'assurer que toutes les informations sont renseignées, si ce n'est pas le cas alors le gestionnaire est redirigé vers le formulaire précédent.
Après avoir saisi toutes les informations nécessaires pour les statistiques, il faut sélectionner l'année souhaitée et cliquer sur le bouton '''Visualiser'''
 
==Rapports issus de données de formulaire==
:* rapport Aeral ''' TERRAINS'''
:* rapport Aeral '''BUREAU'''
:* rapport Aeral '''PERSONNEL'''
:* rapport Aeral '''MATERIEL'''
 
==Adhérents par activité X==
Ce rapport regroupe 4 tableaux qui correspondent chacun à un type d'activité :
*Avion
*Hélicoptère
*ULM
*Planeur
 
Pour qu'un pratiquant soit pris en compte dans le recensement, il faut :
*Qu'il détienne au moins l'une des validités [[#Validités-correspondant-à-la-cotisation-de-la-structure|Validités correspondant à la cotisation de la structure]] et dont la date d'échéance doit être supérieure ou égale au 31/12 de l'année des statistiques.
*Qu'il dispose d'une date de naissance (cela permet d'exclure les utilisateurs qui ne correspondent pas à des utilisateurs réels en leur mettant une date de naissance vide)
 
Pour chaque type d'activité, le robot OpenFlyers détermine les pratiquants en prenant en compte au moins l'un des éléments suivants :
*La pratique effective durant l'année sur un type d'aéronef correspondant au type d'activité
*La détention par un utilisateur d'une validité le définissant comme pratiquant de l'activité
 
Le robot OpenFlyers prend en compte les utilisateurs désactivés.
 
Une fois calculé le nombre de pratiquants, le robot OpenFlyers détermine le nombre de brevetés parmi ces pratiquants. Est considéré comme breveté un utilisateur qui dispose de l'une des validités sélectionnées dans le paramétrage [[#Validités-désignant-les-brevetés|Validités désignant les brevetés]], peu importe que la validité soit à jour ou non. Cela permet de déterminer, par soustraction, les personnes qui sont élèves. Dis autrement : est élève une personne qui ne possède pas une validité répertoriée comme étant une validité de type "brevet".
 
La figure suivante résume l'approche adoptée pour générer les statistiques liées à ce rapport :
 
[[File:Aeral_statistic_members_by_activity_schema_algorithm.png|800px]]
 
==Instructeurs==
Pour calculer les heures de vol de chaque instructeur on commence tout d'abord par obtenir le total des heures de vol en instruction.
 
Ensuite pour les heures de vol en solo on a adopté deux méthodes :
 
:*la première : dite indirecte consiste à déduire les heures de vol en solo en s'appuyant sur la relation suivante :
''' total des heures en solo supervisé = total des heures de vol - total des heures de vol en instruction. '''
 
:*la deuxième : est adopté si le type d'activité solo supervisé est coché pour l'instructeur, dans ce cas on récupère directement les heures de vol où le type d'activité sélectionné pour le paramètre '''Activité correspondant à Solo supervisé'''.
Dans ce cas là, le total des heures de vol de l'instructeur correspond au total
 
==Activité en instruction et Activité hors instruction==
 
pour ces deux rapport aeral nous utilisons la même stratégie qui est définie ci-dessous, pour différencier entre ces deux types d'activité on se base sur la place du pilote :
 
-En instruction place de pilote = 1.
 
-Hors instruction place de pilote = 0.
La stratégie retenue pour générer ce rapport Aeral a été de commencer par identifier les variables fiables qui sont présentes chez toutes les structures
(navigation, IFR, Nuit),qui sont récupérer soit à partir du [[#Admin > Structure > Paramétrage > Export Aeral| formulaire]], soit grâce à l'utilisation de [[#Types d'activités|prédictions sur les types d'activités]], et à partir desquelles on calcule le nombre d'heures de vol pour les autres types d'activité.
 
[[File:Aeral_activity_types_partition_schema.png|650px]]
 
Les données les plus fiables sont celles qui sont les plus spécifiques, par exemple, pour obtenir la valeur de VFR nuit si ce type d’activité n'est pas présente dans la structure alors on considère que le type d’activité nuit est le plus spécifique et donc il correspond à la donnée la plus fiable pour calculer ce type d’activité.
 
Le calcul des heures de vol pour les différents types d'activité se fait en suivant les étapes suivantes:
:* On commence par l’obtention  des heures de vol total de toutes les activités confondues par une requête sql.
:* Ensuite, les heures de vol de chaque type d'activité sont calculées en fonction des données fournies par le gestionnaire dans le [[#Admin > Structure > Paramétrage > Export Aeral| formulaire]].
 
La figure suivante représente le schéma de l'algorithme utilisé par le robot OpenFlyers pour calculer les heures de vol en fonction des données présente dans la structure :
 
[[File:Aeral_statistic_activity_schema_algorithm.png|650px]]
 
:*'''Exemple''':
on prends l'exemple suivant dans lequel la structure ne possède que les types d'activités suivants: IFR, NUIT et Navigation
 
on commence par l'obtention le '''total des heures de vol''' : 2430
 
ensuite on obtient le total '''IFR''' :  1000
 
puisque le type d'activité VFR nuit n'est pas présent dans la structure:
 
on commence par exécuter deux requête la première sur le type d'activité nuit et l'autre sur les deux types d'activité ifr et nuit on obtient par exemple:
 
'''Nuit''' = 1200
 
'''IFR nuit''' = 400
 
ce que nous aide à calculer la valeur de VFR Nuit(voir la relation dans la figure ci-dessus)
 
'''VFR Nuit''': 1200 - 400 = 800.
 
pour calculer VFR jour navigation:
 
on commence par calculer navigation jour, pour cela on obtient la valeur de navigation = 700 et la valeur de navigation nuit = 300 à partir de la base de données, et donc
'''Navigation jour'''  = 700 - 300 = 400,
 
ensuite de la même manière on obtient IFR Navigation = 330 et IFR navigation nuit = 200, pour calculer '''IFR navigation jour''' = 330 - 200 = 130.
 
et en utilisant la relation défini dans figure ci-dessus, on calcule '''VFR jour navigation''' = 400 - 130 = 270.
 
à la fin on déduit la valeur de VFR jour local en suivant les étapes suivants :
 
*:On calcule tout d'abord les heures de vol de '''VFR jour''' = VFR - VFR nuit = 1430 - 800.
avec '''VFR''' = Total - IFR = 2430 - 1000  = 1430.
 
*:ensuite on déduit la valeur de '''VFR Jour local''' = VFR jour - VFR jour navigation = 630 - 270 = 360
 
==Tarifs==
ce rapport aeral consiste à renseigner les droits d'entrée, cotisation non pilote et cotisation Club pour les deux tranches d'age (Jeunes et Adultes).
 
pour cela, les valeurs du droit d'entrée et de la cotisation non pilote sont directement attribuées pour les deux tranches d'age, en se basant sur les variables renseignées dans la [[#Admin > Structure > Paramétrage > Export Aeral| formulaire]] ou trouvées grâce à l'utilisation de [[#Prédictions|prédictions]].
 
pour Cotisation Club on récupère la valeur ADULTES_Cotisation_Club directement à partir de la variable Cotisation.
 
et on déduit '''Jeunes_Cotisation_Club = ADULTES_Cotisation_Club - remise Cotisation jeunes'''
 
=Prédictions=
Le principe de prédictions consiste à essayer de retrouver les paramètres nécessaires au remplissage du formulaire de statistiques AERAL en recherchant dans la base de données des mots clés spécifiques pour chaque référence.
 
Liste des prédictions utilisées par le robot OpenFlyers.
 
==Tarifs==
===Tarif cotisation===
Le robot OpenFlyers cherche dans la liste des variables '''Admin > Ventes > Variables > Définition''' les occurrences :
#'''cotisation'''
#'''cotisation club'''
#'''cotisation <nom de la structure>'''
 
===Tarif droit d'entrée===
Le robot OpenFlyers cherche dans la liste des variables '''Admin > Ventes > Variables > Définition''' les occurrences :
#'''Droit d'entrée'''
#'''Tarif entrée'''
 
===Tarif instruction===
Le robot OpenFlyers cherche dans la liste des variables '''Admin > Ventes > Variables > Définition''' les occurrences :
#'''Tarif instruction'''
 
===Remise cotisation jeune===
Le robot OpenFlyers cherche dans la liste des variables '''Admin > Ventes > Variables > Définition''' les occurrences :
#'''Remise cotisation jeune'''
 
==Qualifications==
Le robot OpenFlyers cherche dans la liste des variables '''Admin > Ventes > Variables > Définition''' les occurrences :
#'''PPL'''
#'''Brevet de base'''
#'''CPL'''
#'''ATPL'''
#'''Brevet ULM'''
 
==Profils==
===Non Pilotes===
Le robot OpenFlyers cherche dans la liste des profils '''Admin > Utilisateur > Profils''' les occurrences :
#'''Honoraire'''
#'''Non pilote'''
 
===Instructeurs===
Le robot OpenFlyers cherche dans la liste des profils '''Admin > Utilisateur > Profils > Réservations''' les profils qui ont les deux droits suivants:
#'''Planning personnel'''
#'''Planning individuel visible pour les autres'''
 
==Types d'activités==
Le robot OpenFlyers cherche dans la liste des variables '''Admin > Ventes > Variables > Définition''' des occurrences spécifiques pour chaque type d'activité :
 
IFR :
#'''IFR'''
#'''IFR-FR'''
 
Instruction :
#'''Instruction'''
#'''Double commande'''
 
Navigation :
#'''Navigation'''
 
Nuit :
#'''Nuit'''
#'''Vol de nuit'''
 
VFR jour navigation :
#'''VFR jour navigation'''
 
VFR nuit :
#'''VFR nuit'''
 
Solo supervisé :
# '''Solo supervisé'''

Revision as of 13:31, 19 March 2024

Présentation

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

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

FFVP-Gesasso est une plateforme utilisée pour la gestion des activités des clubs au sein de la Fédération Française de Vol à Voile (FFVP). Cette plateforme vise à faciliter la gestion des qualifications, de la formation et des activités de club sous l'égide de la FFVP. Elle est accessible à toutes les parties prenantes, y compris les stagiaires, les pilotes, les instructeurs et les responsables de club, et offre un accès gratuit.

Pour les structures qui souhaitent bénéficier de cette intégration, il faut prendre contact avec la FFVP afin d'obtenir les données d'identification nécessaires pour le code WSSE. Une fois ces informations fournies, l'interface se synchronisera automatiquement en temps réel à chaque création, mise à jour ou suppression de vols dans OpenFlyers avec les enregistrements de Gesasso.

L'API permet une intégration transparente, assurant que toutes les données essentielles soient automatiquement mises à jour et partagées entre les deux systèmes, sans nécessiter une intervention technique de la part des utilisateurs.

La synchronisation automatiquement s'effectue dans les conditions suivants
  • Elle se produit après chaque insertion, modification ou suppression d'un vol dans OpenFlyers.
  • Seuls les ressources de type "planeur" avec une valeur dans le champ "immatriculation d'aéronef dans Gesasso" seront synchronisées.
  • Les modifications apportées aux vols dans OpenFlyers déclencheront une synchronisation automatique pour mettre à jour les données du côté Gesasso. Si ce vol n'existe pas du côté Gesasso, il sera créé.

NB: Pour les paramètres de l'heure de décollage et d'atterrissage, ils sont remplis par la date de début et la date de fin du vol car il n'y a pas d'informations correspondantes sur les horaires de décollage et d'atterrissage du côté d'Openflyers.

Procédures

Interfacer OpenFlyers avec Gesasso

Activer Gesasso
  • Aller dans Admin > Structure > Paramétrage > Activités
  • Activer l'interrupteur Gesasso situé dans la 4ème colonne
  • Renseigner les champs Code Gesasso FFVP, Nom d'utilisateur et Mot de passe avec les éléments communiqués par la FFVP pour s'interfacer à l'API de Gesasso.
  • Cliquer sur le bouton Enregistrer
Activer la synchronisation automatique pour une ressource
  • Aller dans Gestion > Ressources > Actives

Pour chaque ressource pour laquelle les vols doivent remonter dans Gesasso :

  • Cliquer sur le bouton symbolisant un crayon
  • Renseigner le champ Immatriculation dans Gesasso avec le nom de l'aéronef paramétré dans Gesasso
  • Cliquer sur le bouton Enregistrer
Activer le champ "Moyen de mise en l'air"

Pour chaque type de ressource où l'information sur le "Moyen de mise en l'air" est nécessaire, appliquer les étapes suivantes :

  • Accéder à Admin > Structure > Type de ressource > Actifs
  • Cliquer sur le bouton symbolisant un crayon pour le type de ressource concernée
  • Activer l'interrupteur "Faire apparaître le champ 'Moyen de mise en l'air'"
  • Cliquer sur le bouton Enregistrer

Réinitialiser le mot de passe de la préprod de Gesasso

Un email de réinitialisation du mot de passe de l'espace préprod est envoyé

  • Suivre les instructions dans l'email

Se connecter sur la préprod de Gesasso

Prérequis
Procédure

Tester la synchronisation automatique

Pour tester la synchronisation automatique des vols d'OpenFlyers vers Gesasso :

  • Accéder à la plateforme de test sur https://openflyers.com/xxxx.test/index.php où xxxx est le nom de la plateforme.
  • Effectuer le paramétrage requis
  • Après le paramétrage, la synchronisation automatique peut être exécutée. Pour la tester, créer un vol de démonstration et observer si aucun message d'erreur n'apparaît et si le vol existe du côté de Gesasso et non.
Retrieved from "https://doc4-fr.openflyers.com/index.php?title=AERAL&oldid=11983"