Interfaçage OpenFlyers et Carnet.aero and FAQ export: Difference between pages

From Documentation de la solution web de gestion OpenFlyers
(Difference between pages)
Jump to navigation Jump to search
 
 
Line 1: Line 1:
__TOC__
__TOC__
=Présentation=
L'objet de cette page est de présenter la FAQ des fonctions d'exports d'[[Accueil|OpenFlyers]] notamment pour importer dans d'autres logiciels.
=Encodage des caractères=
OF utilise par défaut le jeu de caractère [[Wikipedia-fr:UTF-8|UTF-8]] qui est le format de [[Wikipedia-fr:Codage_de_caractères|codage des caractères]] recommandé pour les échanges de données.
Cependant, lors de l'exportation de données il faut que l'encodage utilisé pour le fichier généré par OpenFlyers soit accepté par le logiciel utilisé pour lire le fichier. Selon le système d'exploitation et selon les versions, les formats reconnus varient. Voici quelques exemples d'encodage de caractères courants pour la France
* MS-DOS : CP850 (Europe occidentale DOS International)
* Windows : CP1252 (Europe occidentale Windows Latin1)
* Linux : ISO-8859-1 (Europe occidentale ou latin-1), ISO-8859-15/Euro (Europe occidentale ou latin-9), UTF-8 (unicode), etc. Sur Linux l'encodage dépend de la distribution et de la configuration. Faire ''locale charmap'' pour connaitre l'encodage utilisé.
* Apple : macRoman, UTF-8 (unicode)


=Présentation=
Dans OpenFlyers, vous pouvez définir l'encodage par défaut dans '''Admin > Structure > Paramétrage''' dans le formulaire '''Reporting/Export''' en bas de la page. Sur certaines pages, vous pouvez également changer occasionnellement l'encodage au moment de l'export.
L'objet de cette page est de présenter :
 
*Le service [https://www.carnet.aero/ Carnet.aero]
=Mémorisation du choix d'encodage lors des exports CSV=
*La configuration de l'interfaçage OpenFlyers avec [https://www.carnet.aero/ Carnet.aero]
Par défaut, OpenFlyers utilise le jeu de caractères défini dans :
*Son utilisation dans OpenFlyers
 
'''Admin > Structure > Paramétrage > Export'''
 
Ce paramètre constitue la valeur par défaut pour l'ensemble des exports CSV.


[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].
certaines pages d'export permettent désormais de :
* choisir un jeu de caractères spécifique au moment de l'export,
* mémoriser ce choix pour les prochaines utilisations de la même page,
* sans modifier le paramétrage global défini par l'administrateur.
Lorsque aucun jeu de caractères spécifique n'est mémorisé pour une page donnée, OpenFlyers utilise automatiquement l'encodage par défaut configuré dans '''Admin > Structure > Paramétrage > Export''' .


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.
=Import de fichiers CSV=
==Import de fichiers CSV dans OpenOffice/LibreOffice==
Lors de l'ouverture du fichier OpenOffice ou LibreOffice ouvre une fenêtre d'import de texte qui vous permet de sélectionner le jeu de caractère. Il suffit de choisir le même jeu de caractère que celui utilisé dans l'export côté OpenFlyers.


;La synchronisation automatique s'effectue dans les conditions suivantes
===Les nombres sont remplacés par des dates dans OpenOffice/LibreOffice===
Le format Standard d'Open Office ou de Libre Office interprète les cellules comme du texte ou comme une date si les chiffres sont compatibles.


*Elle se produit après chaque insertion, modification ou suppression d'un vol dans OpenFlyers.
Pour que ne pas avoir cette conversion automatique (désagréable) il faut, dans OpenOffice ou LibreOffice, modifier le format de la colonne en Texte dans la fenêtre de préparation de l'import de texte.  
*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.
*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 non encore synchronisés.
Voici la procédure :
=Les données envoyées à Carnet.aero=
*Changer l'encodage par UTF-8 si vous ne l'avez pas paramétré dans votre config OF,
Lors de la synchronisation, les informations suivantes sont transmises à [https://www.carnet.aero/ Carnet.aero] :
*Décocher le séparateur virgule (Colon) mis par défaut,
*Cliquer sur le séparateur point virgule (SemiColon),
*Cliquer sur l'entête du tableau de prévisualisation pour sélectionner la colonne dont vous souhaitez modifier le format (colonne comportant des montants tel que Solde, Débit ou Crédit)
*Dans la comboBox Type de colonne (column type) cliquer sur Texte
*Répéter l'opération pour les colonnes que vous souhaitez modifier le format


;Données obligatoires
Il sera nécessaire de remplacer le "Point" par une virgule dans les colonnes numériques:
*'''Date du vol'''
*Sélectionner les colonnes à modifier
*'''Fonction à bord''' : Déterminée par le statut configué dans [[Gestion-des-statuts#Fonction_Carnet.aero|Fonctions Carnet.aero]].
*Sélectionner la fenêtre Edit > Cherche & Remplace et remplir les champs avec Recherche = . et Remplace = ,
*'''Temps total''' : Durée du vol en minutes.
*Dans Plus d'options sélectionner "Sélection courante seulement"
*'''Aéronef''' : Immatriculation et modèle de l'aéronef.
*Cliquer sur Remplacer tous
Le format sera alors correctement interprété par votre tableur et vous pourrez l'enregistrer sous le format ods


;Données optionnelles (si disponibles)
=== Alignement des en-têtes ===
*'''Heures de bloc''' : Heure de départ et d'arrivée (converties en minutes depuis minuit).
Si les en-têtes ou données des dernières colonnes sont manquants ou décalés :
*'''Décollage/atterrissage''' : Codes OACI des aérodromes de départ et d'arrivée.
* '''Cause''' : LibreOffice utilise un séparateur incorrect (virgule au lieu de point-virgule).
*'''Nombre d'atterrissages'''
* '''Solution''' :
*'''Natures de vol''' : Les types d'activités OpenFlyers sont envoyés comme "Tags". Le tag "'''Instruction'''" est ajouté automatiquement pour les vols en double commande avec un fonction "Instructeur".
# Relancer l’import du CSV.
*'''Remarques''' : Les commentaires saisis sur le vol.
# Décocher le séparateur "Virgule" (par défaut).
*'''Temps spécifiques''' : Temps de vol.
# Cocher "Point-virgule" (ou le séparateur utilisé dans le fichier CSV).
*'''Équipage''' : Les noms des autres membres d'équipage (Instructeur, Élève, Copilote, Examinateur) sont transmis selon la fonction du person dans le vol.


[[File:LibreOfficeImportCSV.png|400px]]


=Procédures=
===Séparateur décimal lors de copier/coller vers OpenOffice ou LibreOffice===
Le séparateur décimal dans les pages XHTML fourni par OF dans votre navigateur est le point.
Lors d'un copier/Coller Open Office ou Libre Office interprète les cellules au format standard par défaut et interprète alors les cellules comme du texte.
OpenOffice ou Libre office peut etre configuré pour une interprétation automatique du point comme séparateur décimal
*Allez dans l'onglet Outils > Options > Chargement&Enregistrement > Compatibilité HTML (Tools > Options > Load&Save > HTML Compatibility)
*Cocher "Utiliser l'environnement linguistique Anglais (USA) pour les nombres", ("Use English (USA) locale numbers")


==[[Gestion-des-statuts#Fonction_Carnet.aero|Configurer les fonctions Carnet.aero]]==
Le programme interprète alors le point comme le séparateur décimal et le format de la cellule sera alors numérique
Pour que la synchronisation fonctionne, un administrateur doit configurer le mapping des statuts.


==[[Fiche-personnelle#Synchronisation-des-activités|Configurer les identifiants utilisateur Carnet.aero]]==
==Import de fichiers CSV dans Excel==
Chaque pilote doit renseigner ses identifiants [https://www.carnet.aero/ Carnet.aero] dans sa fiche personnelle pour activer la synchronisation.
Les anciennes versions d'Excel ne gèrent pas le choix ou la reconnaisse automatique de l'encodage des caractères. Si vous êtes dans cette situation vous pouvez soit vous tourner vers le logiciel libre [http://fr.openoffice.org/ OpenOffice] ou modifier le format d'encodage côté OpenFlyers en spécifiant [[#Encodage_des_caractères|un format d'encodage qui correspond à votre système d'exploitation]].


==Synchroniser manuellement==
===Somme de nombres décimaux d'un export CSV===
Il est possible de forcer la synchronisation des vols existants (par exemple après avoir configuré les identifiants pour la première fois).
Si la somme de nombre décimaux retourne 0 :
[[File:2025-12-04-11-48-51-Affichage-et-fiche-personnelle---Brave.png|alt=Synchroniser|thumb]]
#Vérifier la nature du séparateur de décimales
* Aller dans '''[[Fiche personnelle#Synchronisation des activités|Planning > Données > Personnelles > Affichage et fiche personnelle]]'''
#*une virgule en français (ex: 0,1)
* Assurer que les identifiants Carnet.aero sont bien renseignés.
#*un point en anglais (ex: 0.1)
*Cliquer sur le bouton '''Forcer la Synchronisationavec Carnet.aero'''
#Dans '''Excel 2007''' : Cliquer sur le "Bouton Office" (bouton rond avec le logo Microsoft Office en haut à gauche)
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.
#Cliquer sur le bouton "Options Excel" en bas de la liste. Cette action ouvre une fenêtre
#Aller dans '''Options avancées > Options d'édition'''
#Décocher "Utiliser les séparateurs système" et remplacer le séparateur de décimales par celui utilisé dans le fichier
#Sauvegarder, quitter puis ouvrir le fichier
#Utiliser la fonction "somme"

Latest revision as of 11:31, 9 December 2025

Présentation

L'objet de cette page est de présenter la FAQ des fonctions d'exports d'OpenFlyers notamment pour importer dans d'autres logiciels.

Encodage des caractères

OF utilise par défaut le jeu de caractère UTF-8 qui est le format de codage des caractères recommandé pour les échanges de données.

Cependant, lors de l'exportation de données il faut que l'encodage utilisé pour le fichier généré par OpenFlyers soit accepté par le logiciel utilisé pour lire le fichier. Selon le système d'exploitation et selon les versions, les formats reconnus varient. Voici quelques exemples d'encodage de caractères courants pour la France

  • MS-DOS : CP850 (Europe occidentale DOS International)
  • Windows : CP1252 (Europe occidentale Windows Latin1)
  • Linux : ISO-8859-1 (Europe occidentale ou latin-1), ISO-8859-15/Euro (Europe occidentale ou latin-9), UTF-8 (unicode), etc. Sur Linux l'encodage dépend de la distribution et de la configuration. Faire locale charmap pour connaitre l'encodage utilisé.
  • Apple : macRoman, UTF-8 (unicode)

Dans OpenFlyers, vous pouvez définir l'encodage par défaut dans Admin > Structure > Paramétrage dans le formulaire Reporting/Export en bas de la page. Sur certaines pages, vous pouvez également changer occasionnellement l'encodage au moment de l'export.

Mémorisation du choix d'encodage lors des exports CSV

Par défaut, OpenFlyers utilise le jeu de caractères défini dans :

Admin > Structure > Paramétrage > Export

Ce paramètre constitue la valeur par défaut pour l'ensemble des exports CSV.

certaines pages d'export permettent désormais de :

  • choisir un jeu de caractères spécifique au moment de l'export,
  • mémoriser ce choix pour les prochaines utilisations de la même page,
  • sans modifier le paramétrage global défini par l'administrateur.

Lorsque aucun jeu de caractères spécifique n'est mémorisé pour une page donnée, OpenFlyers utilise automatiquement l'encodage par défaut configuré dans Admin > Structure > Paramétrage > Export .

Import de fichiers CSV

Import de fichiers CSV dans OpenOffice/LibreOffice

Lors de l'ouverture du fichier OpenOffice ou LibreOffice ouvre une fenêtre d'import de texte qui vous permet de sélectionner le jeu de caractère. Il suffit de choisir le même jeu de caractère que celui utilisé dans l'export côté OpenFlyers.

Les nombres sont remplacés par des dates dans OpenOffice/LibreOffice

Le format Standard d'Open Office ou de Libre Office interprète les cellules comme du texte ou comme une date si les chiffres sont compatibles.

Pour que ne pas avoir cette conversion automatique (désagréable) il faut, dans OpenOffice ou LibreOffice, modifier le format de la colonne en Texte dans la fenêtre de préparation de l'import de texte.

Voici la procédure :

  • Changer l'encodage par UTF-8 si vous ne l'avez pas paramétré dans votre config OF,
  • Décocher le séparateur virgule (Colon) mis par défaut,
  • Cliquer sur le séparateur point virgule (SemiColon),
  • Cliquer sur l'entête du tableau de prévisualisation pour sélectionner la colonne dont vous souhaitez modifier le format (colonne comportant des montants tel que Solde, Débit ou Crédit)
  • Dans la comboBox Type de colonne (column type) cliquer sur Texte
  • Répéter l'opération pour les colonnes que vous souhaitez modifier le format

Il sera nécessaire de remplacer le "Point" par une virgule dans les colonnes numériques:

  • Sélectionner les colonnes à modifier
  • Sélectionner la fenêtre Edit > Cherche & Remplace et remplir les champs avec Recherche = . et Remplace = ,
  • Dans Plus d'options sélectionner "Sélection courante seulement"
  • Cliquer sur Remplacer tous

Le format sera alors correctement interprété par votre tableur et vous pourrez l'enregistrer sous le format ods

Alignement des en-têtes

Si les en-têtes ou données des dernières colonnes sont manquants ou décalés :

  • Cause : LibreOffice utilise un séparateur incorrect (virgule au lieu de point-virgule).
  • Solution :
  1. Relancer l’import du CSV.
  2. Décocher le séparateur "Virgule" (par défaut).
  3. Cocher "Point-virgule" (ou le séparateur utilisé dans le fichier CSV).

LibreOfficeImportCSV.png

Séparateur décimal lors de copier/coller vers OpenOffice ou LibreOffice

Le séparateur décimal dans les pages XHTML fourni par OF dans votre navigateur est le point. Lors d'un copier/Coller Open Office ou Libre Office interprète les cellules au format standard par défaut et interprète alors les cellules comme du texte. OpenOffice ou Libre office peut etre configuré pour une interprétation automatique du point comme séparateur décimal

  • Allez dans l'onglet Outils > Options > Chargement&Enregistrement > Compatibilité HTML (Tools > Options > Load&Save > HTML Compatibility)
  • Cocher "Utiliser l'environnement linguistique Anglais (USA) pour les nombres", ("Use English (USA) locale numbers")

Le programme interprète alors le point comme le séparateur décimal et le format de la cellule sera alors numérique

Import de fichiers CSV dans Excel

Les anciennes versions d'Excel ne gèrent pas le choix ou la reconnaisse automatique de l'encodage des caractères. Si vous êtes dans cette situation vous pouvez soit vous tourner vers le logiciel libre OpenOffice ou modifier le format d'encodage côté OpenFlyers en spécifiant un format d'encodage qui correspond à votre système d'exploitation.

Somme de nombres décimaux d'un export CSV

Si la somme de nombre décimaux retourne 0 :

  1. Vérifier la nature du séparateur de décimales
    • une virgule en français (ex: 0,1)
    • un point en anglais (ex: 0.1)
  2. Dans Excel 2007 : Cliquer sur le "Bouton Office" (bouton rond avec le logo Microsoft Office en haut à gauche)
  3. Cliquer sur le bouton "Options Excel" en bas de la liste. Cette action ouvre une fenêtre
  4. Aller dans Options avancées > Options d'édition
  5. Décocher "Utiliser les séparateurs système" et remplacer le séparateur de décimales par celui utilisé dans le fichier
  6. Sauvegarder, quitter puis ouvrir le fichier
  7. Utiliser la fonction "somme"