ae- Fonctionnement de l’export des données visualisées vers un tableur xls

library(propre.eptb)
indicateurs_eptb <- lire_eptb_exemple()

L’export xls est personnalisé

Les données visualisées dans les tableaux, les graphiques et les cartes sont rassemblées au fil de la compilation du book et exportées dans un fichier xls au niveau du dossier _book.

Les données exportées tiennent ainsi compte des personnalisations apportées par l’auteur de la publication au fil des chapitres, comme par exemple la modification d’un titre d’une illustration.

Attention, si une illustration doit être enlevée d’une publication, il faut veiller à supprimer tout le chunk dédié à cette illustration pour ajuster l’export.

L’objectif est que le tableur soit le plus conforme possible aux illustrations préparées par l’auteur d’une publication régionale et d’éviter à ce dernier de saisir plusieurs fois les arguments de paramétrage d’une visualisation.

Comment ça marche ?

Les fonctions de création d’illustration renvoient toutes une liste nommée de 3 objets :

  • le visuel au format html (objet “viz”),
  • la table des données visualisées (objet “tab_xls”),
  • et des métadonnées qui viennent amender la table des matières (objet “meta”)

Les fonctions afficher_visuel() et incrementer_export_xls() accèdent à ces différents objets.

Si on prend l’exemple du premier graphe du chapitre 1, que l’on stocke dans un objet nommé graphe_1_1 :

graphe_1_1 <- creer_graphe_1_1(data = indicateurs_eptb, annee = 2023, note_de_lecture = "")

l’instruction :

afficher_visuel(graphe_1_1)

est équivalente à :

graphe_1_1[["viz"]]

Comment l’export se paramètre-t-il ?

Le nom du fichier xls exporté est défini à la fin du fichier index.Rmd, au niveau du chunk ‘init exports xls’.

# definition du nom du fichiers xls 
nom_fich_xls <- paste0(
  "EPTB_", annee, "_", str_standardize(params$nom_region), 
  "_export_donnees_illustrations_v", Sys.Date(), ".xlsx"
  )

Il est stocké dans un objet nommé nom_fich_xls.

Cet objet est utilisé pour nommer le fichier xls exporté au niveau du chapitre Méthodologique (au début du fichier 10-methodo.Rmd) mais aussi pour définir les liens pré-insérés dans le book, au niveau des chapitres d’introduction (fin du fichier index.Rmd) et méthodologique (paragraphe “Accès aux données” du fichier 05-methodo.Rmd).

Lorsque le nom est changé par l’utilisateur dans l’objet nom_fich_xls, les liens pré-insérés sont automatiquement mis à jour.

Le fichier xls est créé sur votre poste lors de la compilation HTML du book à la racine du répertoire “_book”. Il faut l’y laisser pour le charger sur le serveur webstatic en vue de la mise en ligne avec le reste de la publication, pour que les liens pré-insérés soient opérants.