xlsx

XLSX Erstellung, Bearbeitung und Analyse

openpyxl, pandas und markitdown sind bereits vorinstalliert – führen Sie nicht zuerst „pip install“ aus; schreiben Sie das Skript und importieren Sie die Module direkt. Nur wenn ein Import fehlschlägt (oder der Befehl „markitdown“ fehlt): Installieren Sie das fehlende Paket mit „pip install “.

Die unten angegebenen Skriptpfade beziehen sich relativ auf das Verzeichnis dieses Skills.

Anforderungen für jede Ausgabe

• Durchgehendprofessionelle Schriftart (Arial, Times New Roman), sofern der Nutzer nichts anderes angibt.
• Keine Formelfehler. Niemals veröffentlichen, solange „recalc.py“ „errors_found“ meldet. Wenn du glaubst, dass ein Fehler bereits vor deiner Arbeit vorhanden war, beweise es: Lade das Original mit „data_only=True“ und schau dir diese Zelle an. Ein von dir eingeführter Fehler sieht genauso aus wie ein geerbter.
• Verwende Formeln, niemals fest codierte Ergebnisse. Schreibe sheet['B10'] = '=SUM(B2:B9)', nicht die von Python berechnete Summe. Das Arbeitsblatt muss neu berechnet werden, wenn sich seine Eingaben ändern.
• Halten Sie sich buchstäblich an die Vorgaben des Nutzers. Genaue Tabellennamen, genaue Spaltenüberschriften und die von ihm vorgegebene Formel. Eine Neugestaltung, die etwas anderes berechnet, ist ein Fehlschlag, egal wie elegant sie auch sein mag.
• Dokumentieren Sie jede Annahme und jede fest codierte Zahl dort, wo der Leser sie sehen kann – in einem Zellkommentar oder in einer benachbarten Zelle am Ende einer Tabelle. Geben Sie eine echte Quelle an, sofern eine vorhanden ist (Quelle: Unternehmensbericht 10-K, Geschäftsjahr 2024, Seite 45, Anmerkung zum Umsatz, [SEC-EDGAR-URL]); wenn die Zahl vom Nutzer stammt, geben Sie dies klar an.
• Eine Arbeitsmappe, die Sie erstellen, damit jemand sie ausfüllen kann, benötigt eine kurze Legende, in der angegeben wird, welche Zellen zu bearbeiten sind, sowie eine Beispielzeile mit realistischen Werten, die das erwartete Format veranschaulicht. Fügen Sie eine solche Zeile niemals zu einer Datei hinzu, die Sie bearbeiten sollen.
• Bearbeitung einer bestehenden Datei: Halten Sie sich genau an deren Konventionen. Diese haben Vorrang vor allen hier genannten Richtlinien. Suchen Sie zunächst die dafür vorgesehenen Eingabezellen – diese sind durch eine abweichende Schriftfarbe, Füllfarbe oder Schattierung gekennzeichnet –, schreiben Sie nur dort und lassen Sie alle bestehenden Formeln unverändert.

Neu berechnen (zwingend erforderlich, wenn die Datei Formeln enthält)

openpyxl schreibt Formeln als Zeichenketten ohne zwischengespeicherte Werte. Solange du nicht neu berechnest, wird jede Formelzelle von Programmen, die zwischengespeicherte Werte auslesen – wie pandas, load_workbook(data_only=True) und die meisten Vorschau-Programme – als „None“ zurückgegeben.

Ausgabe von python-Skripten/recalc.py. `xlsx [timeout_seconds]`   # Standardwert 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 auflistet (locations_truncated gibt an, wie viele zurückgehalten wurden – vertrauen Sie auf total_errors, nicht auf die Länge der Liste). Korrigieren Sie die genannten Fehler und führen Sie das Programm erneut aus. JSON mit einem „error“-Schlüssel anstelle eines „status“-Schlüssels bedeutet, dass nichts neu berechnet wurde, und nur dieser Fall endet mit einem Wert ungleich Null – „errors_found“ endet mit 0; betrachten Sie daher einen fehlerfreien Abschluss niemals als fehlerfreie 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 führt zu einer fehlerfreien Datei mit falschen Zahlen. Schreiben Sie zunächst 2–3 Formeln und überprüfen Sie, ob sie die erwarteten Werte liefern, bevor Sie eine Tabelle erstellen.

Eine Arbeitsmappe, die mit einer anderen Datei verknüpft ist, verliert diese Verknüpfungen, wenn du sie mit openpyxl erneut speicherst und anschließend neu berechnest. Eine solche Formel lautet ='[1]Returns Analysis'!$B$2 – die [1] ist ein Index in der Liste der externen Verweise der Arbeitsmappe, der eine separate Datei auf der Festplatte benennt, nicht ein Arbeitsblatt. Da diese Datei hier selten vorhanden ist, ist der zwischengespeicherte Wert der Zelle das Einzige, was ihre Daten enthält. openpyxl entfernt diesen Wert beim Speichern; LibreOffice muss dann die Referenz tatsächlich auflösen, scheitert dabei, schreibt #NAME? und löscht alle Verknüpfungen. recalc.py weigert sich, in diesem Zustand zu laufen – kopieren Sie die Werte dieser Zellen aus dem Original, bevor Sie sie überschreiben (die Option --force setzt dies außer Kraft und akzeptiert den Verlust).

Auswahl von Formeln, die die Überprüfung überstehen

LibreOffice implementiert weniger Funktionen als Excel, und eine Funktion, die es nicht auswerten kann, wird zu einem literalen #NAME?, das in die von Ihnen gelieferte Datei eingebettet ist.

• Bevorzugen Sie Funktionen aus der Excel-2007-Ära – SUMIFS, INDEX, MATCH, IFERROR, SUMPRODUCT –, die kein Präfix benötigen.
• Sechs Funktionen aus der Zeit nach 2007 funktionieren, jedoch nur mit dem Präfix _xlfn., da openpyxl Ihre Formel wortwörtlich in das XML schreibt und Excel Namen aus der Zeit nach 2007 mit Präfix speichert (die Benutzeroberfläche von Excel verbirgt das Präfix): _xlfn.TEXTJOIN, _xlfn.CONCAT, _xlfn.IFS, _xlfn.SWITCH, _xlfn.MAXIFS, _xlfn.MINIFS. Ohne Präfix führen sie jeweils zu #NAME?.
• Verwenden Sie niemals XLOOKUP, XMATCH, SORT, FILTER, UNIQUE oder SEQUENCE. Das LibreOffice der Laufzeitumgebung kann diese Funktionen unter keinem Präfix auswerten. Neuere Builds werten sie zwar aus, aber es handelt sich um Array-Funktionen mit Überlauf, und eine mit openpyxl geschriebene Datei enthält keine Überlauf-Metadaten, sodass nur die Zelle oben links im Bereich einen Wert erhält – und „recalc.py“ meldet „total_errors: 0“ für das abgeschnittene Ergebnis. Verwenden SieINDEX/MATCH für Suchvorgänge und sortieren, filtern und entfernen Sie Duplikate in Python, bevor Sie die Zellen beschreiben.
• Eine Formel, die LibreOffice nicht analysieren konnte, wird in Kleinbuchstaben zurückgeschrieben – ein schnelles Erkennungsmerkmal neben einem #NAME?.

openpyxl-Fallstricke

• Das Einlesen eines Modells erfordert zwei Ladevorgänge. data_only=True liefert zwischengespeicherte Werte ohne Formeln; die Standardeinstellung liefert Formelstrings ohne Werte. In einem Durchgang lassen sich nicht beide Ergebnisse erzielen.
• „data_only=True“ wirkt sich beim Speichern destruktiv aus. Da die Arbeitsmappe dann keine Formeln mehr enthält, ersetzt das Speichern jede einzelne dauerhaft durch einen Literalwert.
• „data_only=True“ bei einer Datei, die openpyxl gerade geschrieben hat, liefert überall „None“ – führen Sie zuerst „recalc.py“ aus. (Eine Formel, deren Ergebnis „“ ist, wird ebenfalls als „None“ zurückgegeben.)
• Zusammengeführte Zellen: Es wird nur die Ankerzelle oben links geschrieben. Jede andere Zelle im Bereich ist eine „MergedCell“, deren `.value` schreibgeschützt ist.
• .xlsm verliert seine Makros, es sei denn, Sie übergeben keep_vba=True an load_workbook.
• Ein Blattname, der ein Leerzeichen enthält, muss in einer blattübergreifenden Referenzin Anführungszeichen gesetzt werden: ='Assumptions Inputs'!$B$5. Ohne Anführungszeichen wird er zu #VALUE! ausgewertet.

Finanzmodelle

Sofern der Benutzer nichts anderes angibt oder die vorhandene Datei bereits anders vorgeht.

Farbe: blauer Text (0,0,255) für fest codierte Eingaben und Szenario-Hebel · 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üllfarbe (255,255,0) für wichtige Annahmen und Zellen, die der Benutzer ausfüllen sollte.

Zahlen: Währung $#,##0, wobei die Einheit in der Kopfzeile angegeben ist (Umsatz ($mm)) · Nullen werden als „-“ dargestellt, auch in Prozentangaben ($#,##0;($#,##0);-) · negative Werte in Klammern · Prozentangaben 0,0 %, gespeichert als Brüche (0,15 wird als 15,0 % dargestellt; die Speicherung 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 Formeln verweisen, die sie verwenden (=B5*(1+$B$6), niemals =B5*1,05) · Formeln, die über jeden Prognosezeitraum hinweg konsistent sind, da eine einzige bearbeitete Zelle mitten in einer Zeile der häufigste versteckte Fehler ist · Schutznenner, die Null sein können.

Abhängigkeiten

openpyxl, pandas, markitdown (pip, vorinstalliert – nur installieren, wenn ein Import fehlschlägt oder der Befehl fehlt) · LibreOffice (soffice, automatisch konfiguriert für Sandbox-Umgebungen über scripts/office/soffice.py)