Erstellung, Bearbeitung und Analyse von XLSX-Dateien
| Aufgabe | Ansatz |
|---|---|
| Erstellen oder Bearbeiten mit Formeln/Formatierung | openpyxl – siehe Hinweise unten |
| Massenweise Daten importieren/exportieren | pandas (read_excel, to_excel) |
| Schneller Überblick über ein Blatt | markitdown datei.xlsx – ## Blattname pro Blatt; liest auch .xlsm. Keine Zellkoordinaten, daher keine Bearbeitungen auf dieser Basis planen |
| Ein Modell lesen (Formeln und Werte) | zwei load_workbook-Durchläufe – siehe Hinweise |
openpyxl,pandasundmarkitdownsind vorinstalliert – führen Sie zuerst keinpip installaus; schreiben Sie das Skript und importieren Sie direkt. Nur wenn ein Import fehlschlägt (oder der Befehlmarkitdownfehlt):pip installdes fehlenden Pakets.
Die Skriptpfade unten sind relativ zum Verzeichnis dieses Skills.
Anforderungen für jede Ausgabe
- Professionelle Schriftart (Arial, Times New Roman) durchgängig, sofern der Benutzer nichts anderes angibt.
- Keine Formelfehler. Liefern Sie niemals aus, während
recalc.pyerrors_foundmeldet. Wenn Sie glauben, dass ein Fehler bereits vor Ihnen vorhanden war, beweisen Sie es: Laden Sie das Original mitdata_only=Trueund sehen Sie sich diese Zelle an. Ein von Ihnen eingeführter Fehler sieht genauso aus wie einer, den Sie übernommen haben. - Formeln verwenden, niemals hartcodierte Ergebnisse. Schreiben Sie
sheet['B10'] = '=SUM(B2:B9)', nicht die in Python berechnete Summe. Das Blatt muss neu berechnen, wenn sich seine Eingaben ändern. - Die Vorgabe des Benutzers wörtlich befolgen. Exakte Registerkartennamen, exakte Spaltenüberschriften und die von ihm buchstabierte Formel. Ein Redesign, das etwas anderes berechnet, ist fehlgeschlagen, so elegant es auch sein mag.
- Jede Annahme und jede hartcodierte Zahl dokumentieren, dort, wo der Leser sie sieht – ein Zellkommentar oder eine benachbarte Zelle am Ende einer Tabelle. Zitieren Sie eine reale Quelle, wenn eine existiert (
Quelle: Unternehmens-10-K, Geschäftsjahr 2024, Seite 45, Umsatzvermerk, [SEC-EDGAR-URL]); wenn die Zahl vom Benutzer stammt, sagen Sie dies unmissverständlich. - Eine Arbeitsmappe, die Sie zum Ausfüllen erstellen, benötigt eine kurze Legende, die benennt, welche Zellen zu bearbeiten sind, und eine Beispielzeile mit realistischen Werten, die das erwartete Format zeigt. Fügen Sie eine solche Zeile niemals zu einer Datei hinzu, die Sie bearbeiten sollen.
- Bearbeiten einer vorhandenen Datei: Ihre Konventionen genau übernehmen. Sie überschreiben jede Richtlinie hier. Finden Sie zuerst die dafür vorgesehenen Eingabezellen – eine bestimmte Schriftfarbe, Füllung oder Schattierung kennzeichnet sie – schreiben Sie nur dort und lassen Sie jede vorhandene Formel unberührt.
Neuberechnung (zwingend erforderlich, wenn die Datei Formeln enthält)
openpyxl schreibt Formeln als Zeichenfolgen ohne zwischengespeicherte Werte. Bis Sie neu berechnen, liest sich jede
Formelzelle als None für alles, was zwischengespeicherte Werte liest – pandas,
load_workbook(data_only=True) und die meisten Vorschauprogramme.
python scripts/recalc.py ausgabe.xlsx [timeout_sekunden] # Standard 30
LibreOffice berechnet jede Formel, die Datei wird an Ort und Stelle neu geschrieben, und Sie erhalten JSON:
status (success | errors_found), total_formulas, total_errors und eine
error_summary, die bis zu 100 Zellen pro Fehlertyp benennt (locations_truncated sagt, wie viele es
zurückgehalten hat – vertrauen Sie total_errors, nicht der Länge der Liste). Beheben Sie, was es benennt, und führen Sie es
erneut aus. JSON mit einem error-Schlüssel anstelle eines status bedeutet, dass nichts neu berechnet wurde, und
nur in diesem Fall endet der Exit-Code ungleich Null – errors_found endet mit Exit-Code 0, also behandeln Sie einen sauberen Exit niemals als saubere
Arbeitsmappe.
Eine grüne Neuberechnung beweist, dass Ihre Formeln ausgewertet werden, nicht dass sie richtig sind. Ein um eins verschobener Bereich oder ein Verweis auf die falsche Zeile ergibt eine saubere, fehlerfreie Datei mit falschen Zahlen. Schreiben Sie zuerst 2–3 Formeln und prüfen Sie, ob sie die erwarteten Werte abrufen, bevor Sie ein ganzes Raster aufbauen.
Eine Arbeitsmappe, die mit einer anderen Datei verknüpft ist, verliert diese Verknüpfungen, wenn Sie sie mit openpyxl
neu speichern und dann neu berechnen. Eine solche Formel liest sich als ='[1]Returns Analysis'!$B$2 – die [1] ist ein Index
in die Liste der externen Verweise der Arbeitsmappe und benennt eine separate Datei auf der Festplatte, kein Blatt.
Diese Datei ist hier selten vorhanden, daher ist der zwischengespeicherte Wert der Zelle das Einzige, was ihre
Daten hält. openpyxl entfernt diesen Wert beim Speichern; LibreOffice muss dann den Verweis tatsächlich
auflösen, scheitert, schreibt #NAME?, und löscht jede Verknüpfung. recalc.py weigert sich, in diesem Zustand
ausgeführt zu werden – kopieren Sie die Werte dieser Zellen aus dem Original, bevor Sie darüber speichern (--force überschreibt
und akzeptiert den Verlust).
Auswahl von Formeln, die die Überprüfung überstehen
LibreOffice implementiert weniger Funktionen als Excel, und eine, die es nicht auswerten kann, wird zu einem literal
#NAME?, das in die von Ihnen gelieferte Datei eingebacken ist.
- Bevorzugen Sie Funktionen aus der Excel-2007-Ära –
SUMIFS,INDEX,MATCH,IFERROR,SUMPRODUCT– die kein Präfix benötigen. - Sechs Funktionen nach 2007 funktionieren, aber nur mit einem
_xlfn.-Präfix, weil openpyxl Ihre Formel wörtlich in das XML schreibt und Excel Namen nach 2007 mit einem Präfix speichert (seine UI versteckt das Präfix):_xlfn.TEXTJOIN,_xlfn.CONCAT,_xlfn.IFS,_xlfn.SWITCH,_xlfn.MAXIFS,_xlfn.MINIFS. Ohne Präfix ergeben sie alle#NAME?. - Verwenden Sie niemals
XLOOKUP,XMATCH,SORT,FILTER,UNIQUEoderSEQUENCE. Die Laufzeit von LibreOffice kann sie unter keinem Präfix auswerten. Neuere Builds werten sie zwar aus, aber sie sind Spread-Array-Funktionen und eine mit openpyxl geschriebene Datei hat keine Spread-Metadaten, sodass nur die oberste linke Zelle des Bereichs einen Wert erhält – undrecalc.pymeldettotal_errors: 0auf das abgeschnittene Ergebnis. Verwenden SieINDEX/MATCHfür Suchvorgänge und sortieren, filtern und deduplizieren Sie in Python, bevor Sie die Zellen schreiben. - Eine Formel, die LibreOffice nicht parsen konnte, wird kleingeschrieben zurückgeschrieben – ein schneller Hinweis neben
#NAME?.
openpyxl-Hinweise
- Ein Modell zu lesen erfordert zwei Ladevorgänge.
data_only=Trueliefert zwischengespeicherte Werte, wobei die Formeln weg sind; die Voreinstellung liefert Formelzeichenfolgen ohne Werte. Ein einziger Durchlauf kann nicht beides liefern. data_only=Trueist zerstörerisch, wenn Sie speichern. Diese Arbeitsmappe hat keine Formeln mehr, daher ersetzt das Speichern jede durch einen literal – dauerhaft.data_only=Trueauf einer Datei, die openpyxl gerade geschrieben hat, gibt überallNonezurück – führen Sie zuerstrecalc.pyaus. (Eine Formel, deren Ergebnis""ist, wird ebenfalls alsNonezurückgelesen.)- Verbundene Zellen: nur den oberen linken Anker schreiben. Jede andere Zelle im Bereich ist eine
MergedCell, deren.valueschreibgeschützt ist. .xlsmverliert seine Makros, es sei denn, Sie übergebenkeep_vba=Trueanload_workbook.- Ein Blattname, der ein Leerzeichen enthält, muss zitiert werden in einem blattübergreifenden Verweis:
='Assumptions Inputs'!$B$5. Unzitiert wertet er zu#WERT!aus.
Finanzmodelle
Sofern der Benutzer nichts anderes angibt oder die vorhandene Datei bereits etwas anderes tut.
Farbe: blauer Text (0,0,255) für hartcodierte Eingaben und Szenariohebel · schwarz für Formeln ·
grün (0,128,0) für Verknüpfungen zu einem anderen Blatt · rot (255,0,0) für Verknüpfungen zu einer anderen Datei ·
gelbe Füllung (255,255,0) für Schlüsselannahmen und Zellen, die der Benutzer ausfüllen soll.
Zahlen: Währung $#,##0, mit der Einheit in der Überschrift (Umsatz ($mm)) · Nullen werden als - dargestellt, auch in Prozenten ($#,##0;($#,##0);-) · negative Zahlen in Klammern ·
Prozentsätze 0.0%, als Bruch gespeichert (0,15 ergibt 15,0%; das Speichern von 15 ergibt 1500,0%) · Bewertungsmultiplikatoren 0,0x · Jahre als Text ("2024", niemals 2.024).
Struktur: jede Annahme in einer eigenen beschrifteten Zelle, auf die die sie verwendenden Formeln verweisen
(=B5*(1+$B$6), niemals =B5*1,05) · Formeln konsistent über jeden Prognosezeitraum, da eine
einzelne bearbeitete Zelle in der Mitte einer Zeile der häufigste stille Fehler ist · Nenner, die null sein können, absichern.
Abhängigkeiten
openpyxl, pandas, markitdown (pip, vorinstalliert – nur installieren, wenn ein Import fehlschlägt oder der Befehl fehlt) · LibreOffice (soffice, automatisch für Sandbox-Umgebungen konfiguriert über scripts/office/soffice.py)