XLSX の作成、編集、分析
| タスク | アプローチ |
|---|---|
| 作成 または 編集(数式/書式付き) | openpyxl — 以下の注意事項を参照 |
| バルクデータ の入出力 | pandas (read_excel, to_excel) |
| シートの クイック確認 | markitdown file.xlsx — ## Sheet名 でシートごとに表示;.xlsm も読み取り可能。セル座標は出力されないため、編集の計画には使用しないこと |
| モデルの読み取り(数式 と 値) | 2回の load_workbook パス — 注意事項を参照 |
openpyxl、pandas、markitdownはプリインストールされています —pip installを実行せず、スクリプトを記述して直接インポートしてください。インポートが失敗した場合(またはmarkitdownコマンドが見つからない場合)のみ、不足しているパッケージをpip installしてください。
以下のスクリプトパスは、このスキルのディレクトリからの相対パスです。
すべての出力に対する要件
- プロフェッショナルなフォント(Arial、Times New Roman)を全体に使用すること。ユーザーが別途指定した場合を除く。
- 数式エラーをゼロにすること。
recalc.pyがerrors_foundを報告している状態でファイルを納品しないでください。エラーがあなたの作業以前から存在していたと思われる場合は、その証拠を示してください:data_only=Trueで 元の ファイルを読み込み、該当セルを確認してください。あなたが導入したエラーは、既存のエラーとまったく同じように見えます。 - 数式を使用し、ベタ書きの結果を使用しないこと。
sheet['B10'] = '=SUM(B2:B9)'と記述し、Pythonで計算した合計値は書き込まないでください。シートは、入力が変更されたときに再計算される必要があります。 - ユーザーの仕様を文字通りに従うこと。 正確なタブ名、正確なカラムヘッダー、ユーザーが指定した数式。別の計算を行うように再設計することは、たとえ洗練されていても失敗です。
- すべての仮定とハードコードされた数値を、読者が確認できる場所にドキュメント化すること。 セルコメント、またはテーブルの末尾の隣接セルに記述します。実在する出典がある場合はそれを引用してください(
Source: Company 10-K, FY2024, Page 45, Revenue Note, [SEC EDGAR URL])。数値がユーザーから提供された場合は、その旨を明示してください。 - ユーザーが記入するためにあなたが 作成した ワークブック には、編集すべきセルを示す簡単な凡例と、期待される形式を示す現実的な値のサンプル行を1行含める必要があります。編集を依頼されたファイルにそのような行を追加しないでください。
- 既存のファイルを編集する場合:そのファイルの規則に厳密に従うこと。 これらは、ここに記載されているすべてのガイドラインに優先します。まず、指定された入力セル(異なるフォントカラー、塗りつぶし、または網掛けでマークされている)を見つけ、そこにのみ書き込み、既存の数式には一切触れないでください。
再計算(ファイルに数式が含まれる場合は必須)
openpyxl は数式を文字列として書き込みますが、キャッシュされた値は保持しません。再計算を行うまでは、すべての数式セルはキャッシュされた値を読み取るもの(pandas、load_workbook(data_only=True)、ほとんどのプレビュアー)に対して None と読み戻されます。
python scripts/recalc.py output.xlsx [timeout_seconds] # デフォルト 30
LibreOffice がすべての数式を計算し、ファイルは その場で上書きされ、JSON が返されます:status (success | errors_found)、total_formulas、total_errors、およびエラータイプごとに最大100セルを指定する error_summary(locations_truncated は抑制された数を示します — total_errors を信頼し、リストの長さではありません)。それが指定するエラーを修正し、再度実行してください。status の代わりに error キーを持つ JSON は、何も再計算されなかったことを意味し、その場合のみ非ゼロで終了します — errors_found は0で終了するため、正常終了をクリーンなワークブックとみなさないでください。
再計算が成功したことは、数式が 評価される ことを証明するだけで、正しい ことを証明するわけではありません。 1つずれた範囲や間違った行への参照は、クリーンでエラーのないファイルを生成しますが、数値は間違っています。グリッド全体を構築する前に、まず2〜3個の数式を書き、それらが期待通りの値を取得することを確認してください。
別のファイルにリンクしているワークブックは、openpyxl で再保存して再計算すると、それらのリンクが失われます。そのような数式は ='[1]Returns Analysis'!$B$2 と読み取られます — [1] はワークブックの外部参照リストへのインデックスであり、シートではなく ディスク上の別ファイル を指定します。そのファイルがここに存在することはほとんどないため、セルのキャッシュされた値だけがデータを保持しています。openpyxl は保存時にその値を削除します。その後、LibreOffice は参照を実際に解決する必要があり、失敗して #NAME? を書き込み、すべてのリンクを削除します。recalc.py はその状態での実行を拒否します — 上書き保存する前に、元のファイルからそれらのセルの値をコピーしてください(--force でオーバーライドし、損失を受け入れます)。
検証に耐える数式の選択
LibreOffice は Excel よりも少ない関数しか実装しておらず、評価できない関数はリテラルの #NAME? となって納品ファイルに書き込まれます。
- Excel 2007 時代の関数を優先 —
SUMIFS、INDEX、MATCH、IFERROR、SUMPRODUCT— これらはプレフィックスを必要としません。 - 6つの2007年以降の関数は、
_xlfn.プレフィックスを付ければ動作します。これは、openpyxl が数式を XML にそのまま書き込み、Excel が2007年以降の名前をプレフィックス付きで保存するためです(UIではプレフィックスは非表示):_xlfn.TEXTJOIN、_xlfn.CONCAT、_xlfn.IFS、_xlfn.SWITCH、_xlfn.MAXIFS、_xlfn.MINIFS。プレフィックスなしで記述すると、それぞれ#NAME?になります。 XLOOKUP、XMATCH、SORT、FILTER、UNIQUE、SEQUENCEは決して使用しないでください。 ランタイムの LibreOffice は、どの プレフィックスでもそれらを評価できません。新しいビルドでは評価できますが、これらはスピル配列関数であり、openpyxl で作成されたファイルにはスピルメタデータがないため、範囲の左上のセルだけに値が格納されます — そしてrecalc.pyは切り詰められた結果に対してtotal_errors: 0を報告します。ルックアップにはINDEX/MATCHを使用し、並べ替え、フィルター、重複除去はセルに書き込む前に Python で行ってください。- LibreOffice が解析できなかった数式は 小文字で書き戻されます — これは
#NAME?の横にある素早い手がかりです。
openpyxl の注意事項
- モデルの読み取りには2回のロードが必要です。
data_only=Trueは数式がなくなったキャッシュ値を返します。デフォルトでは値なしの数式文字列を返します。1回のパスで両方を取得することはできません。 data_only=Trueは保存すると破壊的です。 そのワークブックには数式が残っていないため、保存するとすべての数式がリテラル値に置き換えられます — 永続的に。- openpyxl が書き込んだばかりのファイルに対する
data_only=Trueは、どこでもNoneを返します — 最初にrecalc.pyを実行してください。(結果が""となる数式もNoneとして読み戻されます。) - 結合セル:左上のアンカーのみに書き込んでください。 範囲内の他のすべてのセルは
MergedCellであり、その.valueは読み取り専用です。 .xlsmは、load_workbookにkeep_vba=Trueを渡さない限り、マクロを失います。- スペースを含むシート名は、シート間参照で引用符で囲む必要があります:
='Assumptions Inputs'!$B$5。引用符なしでは#VALUE!と評価されます。
財務モデル
ユーザーが別途指定した場合、または既存のファイルがすでに別のことを行っている場合を除きます。
色: ハードコードされた入力とシナリオレバーには青色テキスト (0,0,255) · 数式には黒色 · 別シートへのリンクには緑色 (0,128,0) · 別ファイルへのリンクには赤色 (255,0,0) · 主要な仮定とユーザーが記入すべきセルには黄色の塗りつぶし (255,255,0)。
数値: 通貨 $#,##0、ヘッダーに単位を記載(Revenue ($mm)) · ゼロは - で表示(パーセンテージも同様、$#,##0;($#,##0);-) · 負数は括弧内 · パーセンテージ 0.0%、分数として保存(0.15 は 15.0% と表示;15 を保存すると 1500.0% と表示) · 評価倍率 0.0x · 年はテキストとして("2024"、決して 2,024 ではない)。
構造: すべての仮定を独自のラベル付きセルに配置し、それを使用する数式から参照する(=B5*(1+$B$6)、決して =B5*1.05 ではない) · すべての予測期間にわたって数式を一貫させる。なぜなら、行途中の孤立した編集セルが最も一般的なサイレントエラーだからです · ゼロになる可能性のある分母をガードする。
依存関係
openpyxl、pandas、markitdown(pip、プリインストール — インポートが失敗した場合、またはコマンドが見つからない場合のみインストール) · LibreOffice(soffice、サンドボックス環境用に scripts/office/soffice.py で自動設定済み)