xlsx

Création, édition et analyse de fichiers XLSX

Tâche	Approche
Créer ou éditer avec formules/mise en forme	openpyxl — voir les pièges ci-dessous
Données volumineuses en entrée ou en sortie	pandas (read_excel, to_excel)
Aperçu rapide d'une feuille	markitdown file.xlsx — ## NomFeuille par feuille ; lit aussi les .xlsm. Aucune coordonnée de cellule, donc ne planifiez pas d'éditions à partir de celui-ci
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 uv pip install d'abord ; écrivez le script et importez directement. Uniquement si une importation échoue (ou si la commande markitdown est absente) : uv 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 quand recalc.py signale errors_found. Si vous pensez qu'une erreur vous a précédé, prouvez-le : chargez l'original avec data_only=True et examinez cette cellule. Une erreur que vous avez introduite ressemble exactement à une 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 pouvoir 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, FY2024, 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 nécessite une brève légende indiquant les cellules à modifier, et 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é de modifier.
• Modifier un fichier existant : respectez exactement ses conventions. Elles priment sur toutes les directives ici. Trouvez d'abord ses cellules d'entrée désignées — une couleur de police, un remplissage ou un ombrage distinctif les marque — écrivez uniquement là, et laissez chaque formule existante intacte.

Recalcul (obligatoire dès que 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 est lue comme None par tout ce qui lit les valeurs mises en cache — pandas, load_workbook(data_only=True), et la plupart des visionneuses.

python scripts/recalc.py output.xlsx [timeout_seconds]   # 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 ont été retenues — faites confiance à total_errors, pas à la longueur de la liste). Corrigez ce qu'il nomme et exécutez-le à nouveau. Un 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 correctes. 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 d'abord 2 à 3 formules et vérifiez qu'elles récupèrent les valeurs attendues, avant de construire une grille.

Un classeur qui référence un autre fichier perd ces liens si vous le réenregistrez avec openpyxl puis le recalculez. Une telle formule lit ='[1]Analyse des Retours'!$B$2 — le [1] est un index dans la liste de 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 contient 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 s'exécuter dans cet état — copiez les valeurs de ces cellules à partir de l'original avant d'enregistrer par-dessus (--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é au fichier que vous livrez.

• Privilégiez les fonctions de l'ère Excel-2007 — SUMIFS, INDEX, MATCH, IFERROR, SUMPRODUCT — qui ne nécessitent aucun préfixe.
• Six fonctions post-2007 fonctionnent, mais seulement avec un préfixe _xlfn., car openpyxl écrit votre formule textuellement dans le XML et Excel stocke les noms post-2007 préfixés (son interface utilisateur cache ce 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 moteur d'exécution LibreOffice ne peut pas les évaluer sous aucun préfixe. Les versions plus récentes les évaluent, mais ce sont des fonctions matricielles débordantes et un fichier écrit par openpyxl n'a pas de métadonnées de débordement, donc seule la cellule en haut à gauche de la plage reçoit 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édupliquez en Python avant d'écrire les cellules.
• Une formule que LibreOffice n'a pas pu analyser est réécrite en minuscules — un indice 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 sans les formules ; 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 chaque formule par une valeur littérale — définitivement.
• data_only=True sur un fichier qu'openpyxl vient d'écrire renvoie None partout — exécutez d'abord recalc.py. (Une formule dont le résultat est "" est également lue comme 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 : ='Hypothèses Entrées'!$B$5. Sans guillemets, cela 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énarios · 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 (Revenus ($mm)) · les zéros sont rendus comme -, y compris dans les pourcentages ($#,##0;($#,##0);-) · les négatifs entre parenthèses · pourcentages 0.0%, stockés sous forme de fractions (0.15 rendu 15.0% ; stocker 15 rendu 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 unique modifié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 uniquement si une importation échoue ou si la commande est absente) · LibreOffice (soffice, auto-configuré pour les environnements sandboxés via scripts/office/soffice.py)

---

Cette compétence est créée et maintenue par Anthropic. Distribué ici sans modification hormis les métadonnées de préambule ; voir LICENSE.txt pour les conditions.