xlsx

Création, édition et analyse XLSX

Tâche	Approche
Créer ou éditer avec formules/formatage	openpyxl — voir les pièges ci-dessous
Données volumineuses en entrée ou sortie	pandas (read_excel, to_excel)
Aperçu rapide d'une feuille	markitdown fichier.xlsx — ## NomFeuille par feuille ; lit aussi .xlsm. Pas de coordonnées de cellules, donc ne planifiez pas d'éditions à partir de cela
Lire un modèle (formules et valeurs)	deux passes load_workbook — voir les pièges

openpyxl, pandas et markitdown sont préinstallés — n'exécutez pas pip install d'abord ; écrivez le script et importez directement. Uniquement si une importation échoue (ou si la commande markitdown est manquante) : pip install du paquet manquant.

Les chemins de scripts ci-dessous sont relatifs au répertoire de cette compétence.

Exigences pour chaque sortie

• Police professionnelle (Arial, Times New Roman) partout, sauf indication contraire de l'utilisateur.
• Zéro erreur de formule. Ne livrez jamais tant que recalc.py signale errors_found. Si vous pensez qu'une erreur existait avant vous, prouvez-le : chargez l'original avec data_only=True et examinez cette cellule. Une erreur que vous avez introduite ressemble exactement à une erreur que vous avez héritée.
• Utilisez des formules, jamais de résultats codés en dur. Écrivez sheet['B10'] = '=SUM(B2:B9)', pas le total calculé en Python. La feuille doit se recalculer lorsque ses entrées changent.
• Suivez les spécifications de l'utilisateur à la lettre. Noms d'onglets exacts, en-têtes de colonnes exacts et la formule qu'il a énoncée. Une refonte qui calcule autre chose échoue, aussi élégante soit-elle.
• Documentez chaque hypothèse et nombre codé en dur là où le lecteur le verra — un commentaire de cellule, ou une cellule adjacente à la fin d'un tableau. Citez une source réelle lorsqu'elle existe (Source : 10-K de l'entreprise, exercice 2024, page 45, note sur les revenus, [URL SEC EDGAR]) ; lorsque le nombre provient de l'utilisateur, dites-le clairement.
• Un classeur que vous créez pour que quelqu'un le remplisse a besoin d'une courte légende nommant les cellules à éditer, et d'une ligne d'exemple avec des valeurs réalistes montrant le format attendu. N'ajoutez jamais une telle ligne à un fichier que l'on vous a demandé d'éditer.
• Édition d'un fichier existant : respectez ses conventions exactement. Elles remplacent toutes les directives ici. Trouvez d'abord ses cellules d'entrée désignées — une couleur de police, un remplissage ou une trame distincts les marquent — écrivez uniquement là, et ne touchez à aucune formule existante.

Recalcul (obligatoire lorsque le fichier contient des formules)

openpyxl écrit les formules sous forme de chaînes sans valeurs mises en cache. Jusqu'à ce que vous recalculiez, chaque cellule de formule renvoie None à tout ce qui lit les valeurs mises en cache — pandas, load_workbook(data_only=True) et la plupart des visionneuses.

python scripts/recalc.py sortie.xlsx [délai_en_secondes]   # par défaut 30

LibreOffice calcule chaque formule, le fichier est réécrit sur place, et vous obtenez du JSON : status (success | errors_found), total_formulas, total_errors, et un error_summary nommant jusqu'à 100 cellules par type d'erreur (locations_truncated indique combien il a retenues — faites confiance à total_errors, pas à la longueur de la liste). Corrigez ce qu'il nomme et relancez-le. Le JSON avec une clé error au lieu de status signifie que rien n'a été recalculé, et seul ce cas se termine avec un code non nul — errors_found se termine avec 0, donc ne traitez jamais une sortie propre comme un classeur propre.

Un recalcul vert prouve que vos formules s'évaluent, pas qu'elles sont justes. Une plage décalée d'une ligne ou une référence à la mauvaise ligne produit un fichier propre et sans erreur avec des nombres erronés. Écrivez 2 à 3 formules d'abord et vérifiez qu'elles rapportent les valeurs attendues, avant de construire une grille.

Un classeur qui fait référence à un autre fichier perd ces références si vous le réenregistrez avec openpyxl puis recalculez. Une telle formule lit ='[1]AnalyseRetours'!$B$2 — le [1] est un index dans la liste des références externes du classeur, nommant un fichier séparé sur le disque, pas une feuille. Ce fichier est rarement présent ici, donc la valeur mise en cache de la cellule est la seule chose qui conserve ses données. openpyxl supprime cette valeur lors de l'enregistrement ; LibreOffice doit alors résoudre la référence pour de vrai, échoue, écrit #NAME? et supprime tous les liens. recalc.py refuse de fonctionner dans cet état — copiez les valeurs de ces cellules à partir de l'original avant de les enregistrer (--force passe outre et accepte la perte).

Choisir des formules qui survivent à la vérification

LibreOffice implémente moins de fonctions qu'Excel, et une fonction qu'il ne peut pas évaluer devient un #NAME? littéral intégré dans le fichier que vous livrez.

• Privilégiez les fonctions de l'ère Excel 2007 — SUMIFS, INDEX, MATCH, IFERROR, SUMPRODUCT — qui n'ont besoin d'aucun préfixe.
• Six fonctions post-2007 fonctionnent, mais seulement avec un préfixe _xlfn., car openpyxl écrit votre formule dans le XML textuellement et Excel stocke les noms post-2007 préfixés (son interface masque le préfixe) : _xlfn.TEXTJOIN, _xlfn.CONCAT, _xlfn.IFS, _xlfn.SWITCH, _xlfn.MAXIFS, _xlfn.MINIFS. Écrites nues, chacune produit #NAME?.
• N'utilisez jamais XLOOKUP, XMATCH, SORT, FILTER, UNIQUE ou SEQUENCE. Le runtime de LibreOffice ne peut pas les évaluer avec aucun préfixe. Les versions plus récentes les évaluent, mais ce sont des fonctions de tableau déversées et un fichier écrit par openpyxl n'a pas de métadonnées de déversement, donc seule la cellule en haut à gauche de la plage obtient une valeur — et recalc.py signale total_errors: 0 sur le résultat tronqué. Utilisez INDEX/MATCH pour les recherches, et triez, filtrez et dédoublonnez en Python avant d'écrire les cellules.
• Une formule que LibreOffice n'a pas pu analyser est réécrite en minuscules — un indicateur rapide à côté d'un #NAME?.

Pièges d'openpyxl

• Lire un modèle nécessite deux chargements. data_only=True donne les valeurs mises en cache avec les formules disparues ; la valeur par défaut donne les chaînes de formules sans valeurs. Un seul passage ne peut pas vous donner les deux.
• data_only=True est destructeur si vous enregistrez. Ce classeur n'a plus de formules, donc l'enregistrement remplace chacune par une valeur littérale — définitivement.
• data_only=True sur un fichier qu'openpyxl vient d'écrire renvoie None partout — exécutez recalc.py d'abord. (Une formule dont le résultat est "" renvoie aussi None.)
• Cellules fusionnées : écrivez uniquement l'ancre en haut à gauche. Chaque autre cellule de la plage est une MergedCell dont .value est en lecture seule.
• .xlsm perd ses macros sauf si vous passez keep_vba=True à load_workbook.
• Un nom de feuille contenant un espace doit être entre guillemets dans une référence inter-feuilles : ='Saisies hypothèses'!$B$5. Sans guillemets, il s'évalue en #VALUE!.

Modèles financiers

Sauf indication contraire de l'utilisateur, ou si le fichier existant fait déjà autrement.

Couleur : texte bleu (0,0,255) pour les entrées codées en dur et les leviers de scénario · noir pour les formules · vert (0,128,0) pour les liens vers une autre feuille · rouge (255,0,0) pour les liens vers un autre fichier · remplissage jaune (255,255,0) pour les hypothèses clés et les cellules que l'utilisateur doit remplir.

Nombres : devise $#,##0, avec l'unité nommée dans l'en-tête (Revenu ($mm)) · les zéros s'affichent comme -, y compris dans les pourcentages ($#,##0;($#,##0);-) · négatifs entre parenthèses · pourcentages 0.0%, stockés sous forme de fractions (0.15 affiche 15.0% ; stocker 15 affiche 1500.0%) · multiples de valorisation 0.0x · années sous forme de texte ("2024", jamais 2 024).

Structure : chaque hypothèse dans sa propre cellule étiquetée, référencée par les formules qui l'utilisent (=B5*(1+$B$6), jamais =B5*1.05) · formules cohérentes sur chaque période de projection, car une cellule isolée éditée au milieu d'une ligne est l'erreur silencieuse la plus courante · protégez les dénominateurs qui peuvent être nuls.

Dépendances

openpyxl, pandas, markitdown (pip, préinstallés — installez seulement si une importation échoue ou si la commande est manquante) · LibreOffice (soffice, auto-configuré pour les environnements sandbox via scripts/office/soffice.py)