xlsx

XLSX création, édition et analyse

openpyxl, pandas et markitdown sont préinstallés — n'exécutez pas pip install au préalable ; écrivez le script et importez directement. Uniquement si une importation échoue (ou si la commande markitdown est manquante) : installez le paquet manquant à l'aide de pip install.

Les chemins d'accès aux scripts ci-dessous sont relatifs au répertoire de cette compétence.

Exigences pour chaque résultat

• Police professionnelle (Arial, Times New Roman) partout, sauf indication contraire de l’utilisateur.
• Aucune erreur de formule. Ne livrez jamais le script tant que recal.py signale des erreurs (errors_found). Si vous pensez qu’une erreur est antérieure à votre intervention, prouvez-le : chargez le fichier d’origine avec data_only=True et examinez cette cellule. Une erreur que vous avez introduite ressemble exactement à celle dont vous avez hérité.
• Utilisez des formules, jamais de résultats codés en dur. Écrivez sheet['B10'] = '=SUM(B2:B9)', et non le total calculé par Python. La feuille doit se recalculer lorsque ses données d’entrée changent.
• Respectez à la lettre les spécifications de l’utilisateur. Les noms exacts des onglets, les en-têtes exacts des colonnes et la formule telle qu’il l’a formulée. Une refonte qui calcule autre chose est un échec, aussi élégante soit-elle.
• Documentez chaque hypothèse et chaque chiffre codé en dur à un endroit où le lecteur pourra le voir — dans un commentaire de cellule ou dans une cellule adjacente à la fin d’un tableau. Citez une source réelle lorsqu’elle existe (Source : Rapport 10-K de l’entreprise, exercice 2024, page 45, note sur le chiffre d’affaires, [URL SEC EDGAR]) ; lorsque le chiffre provient de l’utilisateur, indiquez-le clairement.
• Un classeur que vous créez pour que quelqu’un le remplisse doit comporter une brève légende indiquant les cellules à modifier, ainsi qu’une ligne d’exemple contenant des valeurs réalistes illustrant le format attendu. N’ajoutez jamais une telle ligne à un fichier que l’on vous a demandé de modifier.
• Modification d’un fichier existant : respectez scrupuleusement ses conventions. Celles-ci prévalent sur toutes les consignes énoncées ici. Identifiez d’abord les cellules de saisie désignées — elles sont signalées par une couleur de police, un remplissage ou un ombrage distincts —, écrivez uniquement à ces emplacements et ne modifiez aucune formule existante.

Recalculer (obligatoire dès lors que le fichier contient des formules)

openpyxl écrit les formules sous forme de chaînes de caractères sans valeurs mises en cache. Tant que vous n’avez pas relancé le calcul, chaque cellule de formule est interprétée comme « None » par tout programme lisant les valeurs mises en cache — pandas, load_workbook(data_only=True) et la plupart des outils de prévisualisation.

Sortie du script Python `recalc.py`. `xlsx [timeout_seconds]`   # valeur par défaut : 30

LibreOffice calcule chaque formule, le fichier est réécrit sur place et vous obtenez un fichier JSON : status (success | errors_found), total_formulas, total_errors, et un error_summary répertoriant jusqu’à 100 cellules par type d’erreur (locations_truncated indique combien ont été omises — fiez-vous à total_errors, pas à la longueur de la liste). Corrigez ce qui est répertorié et relancez le programme. Un JSON comportant une clé « error » au lieu d’un statut signifie qu’aucun recalcul n’a eu lieu, et seul ce cas renvoie une valeur non nulle — « errors_found » renvoie 0 ; ne considérez donc jamais une sortie sans erreur comme un classeur sans erreur.

Un recalcul « vert » prouve que vos formules s’évaluent, pas qu’elles sont correctes. Une plage décalée d’une case ou une référence à la mauvaise ligne donne un fichier « propre », sans erreur, mais contenant des chiffres erronés. Écrivez d’abord 2 ou 3 formules et vérifiezqu’ elles renvoient les valeurs attendues, avant de construire une grille.

Un classeur lié à un autre fichier perd ces liens si vous le réenregistrez avec openpyxl puis effectuez un recalcul. Une telle formule se présente ainsi : ='[1]Returns Analysis'!$B$2 — le [1] est un index dans la liste des références externes du classeur, désignant un fichier distinct sur le disque, et non une feuille. Ce fichier est rarement présent ici, donc la valeur mise en cache de la cellule est la seule à contenir ses données. openpyxl supprime cette valeur lors de l'enregistrement ; LibreOffice doit alors résoudre la référence pour de vrai, échoue, affiche #NAME? et supprime tous les liens. recalc.py refuse de s'exécuter dans cet état — copiez les valeurs de ces cellules depuis le fichier d’origine avant de les écraser (l’option--force passe outre et accepte la perte).

Choisir des formules qui résistent à la vérification

LibreOffice implémente moins de fonctions qu’Excel, et toute 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’époque d’Excel 2007 — SUMIFS, INDEX, MATCH, IFERROR, SUMPRODUCT — qui ne nécessitent aucun préfixe.
• Six fonctions postérieures à 2007 fonctionnent, mais uniquement avec le préfixe _xlfn., car openpyxl écrit votre formule tel quel dans le XML et Excel stocke les noms postérieurs à 2007 avec ce préfixe (son interface utilisateur masque le préfixe) : _xlfn.TEXTJOIN, _xlfn.CONCAT, _xlfn.IFS, _xlfn.SWITCH, _xlfn.MAXIFS, _xlfn.MINIFS. Écrites sans préfixe, chacune renvoie #NAME?.
• N’utilisez jamais XLOOKUP, XMATCH, SORT, FILTER, UNIQUE ou SEQUENCE. Le moteur d’exécution LibreOffice ne peut pas les évaluer, quel que soit le préfixe utilisé. Les versions plus récentes les évaluent, mais il s'agit de fonctions de tableau à débordement et un fichier écrit avec openpyxl ne contient pas de métadonnées de débordement ; par conséquent, 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é. UtilisezINDEX/MATCH pour les recherches, et effectuez le tri, le filtrage et la déduplication en Python avant de remplir 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

• La lecture d’un modèle nécessite deux chargements. data_only=True renvoie les valeurs mises en cache sans les formules ; la valeur par défaut renvoie les chaînes de formules sans les valeurs. Un seul passage ne permet pas d’obtenir les deux.
• data_only=True est destructif si vous enregistrez. Ce classeur ne contient plus aucune formule ; l’enregistrement remplace donc chacune d’entre elles par une valeur littérale — de manière définitive.
• data_only=True sur un fichier que 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 : n'écrivez que l'ancrage en haut à gauche. Toutes les autres cellules de la plage sont des MergedCell dont la propriété .value est en lecture seule.
• Le format.xlsm perd ses macros à moins que vous ne passiez keep_vba=True à la fonction load_workbook.
• Un nom de feuille contenant un espace doit être placé entre guillemets dans une référence inter-feuilles : ='Assumptions Inputs'!$B$5. Sans guillemets, cela renvoie #VALUE!.

Modèles financiers

Sauf indication contraire de l’utilisateur, ou si le fichier existant fonctionne déjà différemment.

Couleur : texte bleu (0,0,255) pour les données saisies 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.

Chiffres : format monétaire $#,##0, avec l’unité indiquée dans l’en-tête (Chiffre d’affaires ($mm)) · les zéros s’affichent sous la forme -, y compris dans les pourcentages ($#,##0;($#,##0);-) · les valeurs négatives entre parenthèses · les pourcentages 0,0 %, stockés sous forme de fractions (0,15 s'affiche en 15,0 %; le stockage de 15 donne 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 toutes les périodes de projection, car une seule cellule modifiée au milieu d’une ligne constitue l’erreur silencieuse la plus courante · dénominateurs de sécurité pouvant être nuls.

Dépendances

openpyxl, pandas, markitdown (pip, préinstallé — à installer uniquement si une importation échoue ou si la commande est manquante) · LibreOffice (soffice, configuré automatiquement pour les environnements en sandbox via scripts/office/soffice.py)