トラブルシューティングガイド
一般的な問題
このセクションでは、Aspose.Cells FOSS を Python で使用する際に頻繁に遭遇する問題を取り上げます。特に、API の表層にあるクラスとして Cell, AutoFilter, CSVHandler,、および CFBReader.
CSV インポートがエンコーディングエラーで失敗する
症状としては、文字化けや UnicodeDecodeError CSV ファイルを読み込む際に発生します。これは、CSV ファイルが非 UTF-8 エンコーディング（例: cp1252 や Shift-JIS）を使用している場合に起こります。対策としては、読み込む前にファイルを UTF-8 に変換するか、あるいは CSVLoadOptions インスタンスを CSVHandler.load_csv():
from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions
opts = CSVLoadOptions()
wb = Workbook()
CSVHandler.load_csv(wb, "data.csv", opts)AutoFilter XLSX 読み込み後に適用されない
症状としては、フィルタコントロールが欠如している、または読み込み後にデータがフィルタリングされていないことが挙げられます .xlsx ファイルです。この現象は、 AutoFilterXMLLoader.load_auto_filter() ソースファイルの XML が不正なため、黙って失敗します。XLSX の xl/autofilters/autofilter*.xml が正しく形成されているか確認してください。ファイルが外部で作成された場合は、ECMA-376 に準拠していることを確認してください。使用 AutoFilter.range, filter_columns,、そして sort_state ロード後にロードされた状態を検査するために。.
暗号化された XLSX ファイルが読み取れない
症状には NotImplementedError: Standard encryption is not yet supported 暗号化されたファイルを開こうとしたとき .xlsx ファイル。Aspose.Cells FOSS は Agile 暗号化（ECMA-376 Part 2, Section 4）を介してのみサポートします AgileEncryptionParameters.。レガシー XOR または標準 ECMA-376 暗号化で暗号化されたファイルはサポートされていません。使用してください CFBReader.read_encryption_info() ファイルが Agile 暗号化を使用している場合にのみ使用してください。そうでない場合は、ロード前に外部で復号してください。.
Cell XML から正しく解析できない値
症状には、日付の値が正しくない、数値文字列が数値として誤解される、またはエラー値（例：., #N/A）が認識されません。この現象は、…のときに発生します CellValueHandler.parse_value_from_xml() は不正確に使用されています cell_type または欠落しています shared_strings コンテキストです。確実に cell_type が ECMA-376 と一致します t 属性（例、., 's' 共有文字列用、, 'n' 数値用）、そして、入力済みの shared_strings 文字列タイプのリストです。使用してください CellValueHandler.get_cell_type() 推測された型を解析前に検証するために.
エラーメッセージ
Aspose.Cells FOSS raises specific errors during file I/O, encryption, and parsing operations. This section documents common error messages from classes like CFBReader, CFBWriter,、そして AutoFilterXMLLoader, それらの原因と対処法。.
| エラー | 原因 | 修正 |
|---|---|---|
NotImplementedError: Standard encryption is not yet supported | Agile 以外の暗号化（例: XOR、RC4）を使用して暗号化された XLSX の読み取りまたは書き込みを試みる。. | 使用 AgileEncryptionParameters そして、ファイルが Agile 暗号化（ECMA-376 Part 2、Section 4）を使用していることを確認してください。. |
NotImplementedError: Only Agile encryption is currently supported | 使用 CFBWriter または CFBReader Agile 以外の暗号化パラメータを使用している場合。. | 暗号化を構成するには AgileEncryptionParameters 呼び出す前に write() または read_encrypted_package(). |
NotImplementedError: Unsupported chart type for creation | 次のいずれにも含まれないタイプのチャートを作成しています ChartType.LINE,、BAR、PIE、AREA、または STOCK。. | サポートされているタイプに限定してチャートを作成してください: LINE、BAR、PIE、AREA、STOCK。. |
NotImplementedError: Only line, bar, pie, area and stock charts are currently supported | サポートされていないチャートタイプ（例: WATERFALL、BOX_WHISKER）を XML に保存しています。. | サポートされているもののみ使用 ChartType チャートを保存する際に使用する値 xml_chart_saver. |
ValueError: Invalid CSV content | 不正な CSV データが渡された CSVHandler.load_csv_from_string() または load_csv(). | ロードする前に CSV 構文を検証してください。. |
ValueError: Cell value type mismatch | 互換性のない型を渡すと CellValueHandler.format_value_for_xml() または parse_value_from_xml(). | 使用してください CellValueHandler.get_cell_type() 書式設定または解析の前に正しいセルタイプを決定するために. |
ヘルプを得るには
Aspose.Cells の FOSS では、GitHub Issues を通じて問題を報告したり機能をリクエストしたりしてください。次のようなクラスのドキュメントをご確認ください AutoFilter, Cell, CSVHandler,、および AgileEncryptionParameters.。GitHub Discussions でコミュニティと交流し、Python ワークフローでライブラリを使用する一般的な質問について相談してください。.
- GitHub Issues: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
- GitHub ディスカッション: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/discussions
- API リファレンス: https://reference.aspose.org/cells/python/
関連項目
Aspose.Cells の FOSS における一般的な問題の取り扱いに関する関連ガイダンスについては、次のようなコアクラスのドキュメントをご確認ください Cell, AutoFilter, CSVHandler,、と AgileEncryptionParameters.
