Ce document décrit les différentes étapes de vérification de fichier d’input réalisé lors du traitement du fichier Eva-Vélo
Ces vérifications obligatoires testent l’intégrité du fichier xlsx. Si ces tests ne sont pas concluants, le traitement ne pourra pas avoir lieu.
Pour qu’un fichier xlsx puisse être ouvert avec read_evavelo(), il doit comporter au moins les 7 onglets suivants:
L’absence de ces onglets ou un nommage différent entrainera une erreur lors de la lecture avec read_evavelo() ou process_evavelo()
Si l’un de ces onglets est vide (ou ne comporte que les en-têtes), une erreur sera aussi créée au moment de la lecture du fichier (mis à part pour comptages_automatiques où seul un warning non bloquant sera créé).
La function check_evavelo() qui est aussi intégrée à process_evavelo() procède à différentes vérifications de cohérence du fichier Eva-Velo:
Les onglets enquetes_saisies et comptages_manuels doivent être respectivement reportés à l’identique dans les onglets enquetes_post_traitement et comptages_man_post_traitements.
Nous vérifions donc d’abord que c’est bien le cas et qu’aucune information présente dans ces 2 onglets n’est différente dans l’équivalent *_post_traitement
Il est important de noter que dans le cas de comptages_manuels et comptages_man_post_traitements, les lignes du fichier Excel doivent être exactement dans le même ordre pour que la comparaison puisse fonctionner. Ce problème n’est pas présent dans la vérification de enquetes_saisies et enquetes_post_traitement pour lesquels le champ id_quest est utilisé comme clé.
Eva-Scan vérifie ensuite que les variables utilsées dans les différents traitement sont bien disponibles dans le fichier.
Pour l’onglet enquetes_post_traitement, il s’agit des variables:
activite_motivactivitesactivites_aucunecategoriecategorie_corrigecp_resdate_enqdate_enqdist_transp_jourdistance_dom_enq_reelledistance_domicile_enqdistance_heb_enqdistance_heb_enq_reelledmsid_questid_section_destid_section_origineid_site_enqid_site_enqiti_arr_iti_valideiti_arrivee_finaliti_arrivee_itineraireiti_dep_iti_valideiti_depart_initialiti_depart_itineraireiti_experienceiti_km_voyagekm_sortiemode_heb_regroupemode_transp_journb_total_velonb_vaepays_resrevenutaille_totale_groupetour_dep_activitestour_dep_alimtour_dep_autrestour_dep_hebtour_dep_locationtour_dep_souvenirstour_dep_to_jourtype_sortietype_trajetville_hebville_heb_cog_lauville_resville_res_cog_lauPour l’onglet comptages_man_post_traitements, des variables:
categorie_brevecategorie_visuellecategorie_visuelle_cyclistedate_enqid_questid_site_enqvolume_manuelPour l’onglet calendrier_sites, des variables:
date_enqid_site_enqLa variable categorie_visuelle_cycliste de comptages_man_post_traitements et aussi vérifiées et ne doit contenir que les valeurs suivantes: Loisir, Sportif, Utilitaire et Itinérant. (La présence de ces variables au pluriel est aussi tolérée. exemple: Utilitaires)
La variable id_quest est une clé unique qui permet de relier comptages_man_post_traitements et enquetes_post_traitement.
Eva-Scan va d’abord vérifier que dans chacun de ces 2 onglets, la variable id_quest est bien unique et créer une erreur en cas de doublon.
Chaque id_quest présent dans comptages_man_post_traitements doit l’être dans enquetes_post_traitement et inversement. Eva-Scan va donc chercher les id_quest manquants
Dans le cas de questionnaire multiples (identifiés par un id_quest de la forme XXXX-YY), Eva-Scan va vérifier la cohérence entre volume_manuel de comptage et taille_totale_groupe de enquête.
En cas d’incohérence, le traitement est stoppé.
Pour s’assurer qu’aucune enquête n’a été oubliée, Eva-Scan va vérifier l’ensemble de combinaison id_site_enq et date_enq dans les onglets calendrier_sites, comptages_man_post_traitements et enquetes_post_traitement.
L’ensemble des combinaisons doit être présent dans les 3 onglets.