Aspose.Cells FOSS
Python
Guides de dépannage

Guides de dépannage

Problèmes courants

Cette section couvre les problèmes fréquents rencontrés lors de l’utilisation de Aspose.Cells FOSS dans Python, en particulier avec les classes de la surface API telles que Cell, AutoFilter, CSVHandler, et CFBReader.

Échec de l’importation CSV en raison d’erreurs d’encodage

Les symptômes incluent du texte brouillé ou UnicodeDecodeError lors du chargement de fichiers CSV. Cela se produit lorsque le fichier CSV utilise un encodage non UTF-8 (par ex., cp1252 ou Shift-JIS). Pour résoudre le problème, convertissez le fichier en UTF-8 avant le chargement, ou passez un CSVLoadOptions instance à CSVHandler.load_csv():

from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions

opts = CSVLoadOptions()
wb = Workbook()
CSVHandler.load_csv(wb, "data.csv", opts)

AutoFilter Non appliqué après le chargement du XLSX

Les symptômes incluent des contrôles de filtre manquants ou des données non filtrées après le chargement d’un .xlsx fichier. Cela se produit lorsque AutoFilterXMLLoader.load_auto_filter() échoue silencieusement en raison d’un XML mal formé dans le fichier source. Vérifiez le XLSX’s xl/autofilters/autofilter*.xml est bien formé. Si le fichier a été créé à l’extérieur, assurez‑vous qu’il est conforme à ECMA-376. Utilisez AutoFilter.range, filter_columns, et sort_state pour inspecter l’état chargé après le chargement.

Impossible de lire les fichiers XLSX chiffrés

Symptômes incluent NotImplementedError: Standard encryption is not yet supported lors de la tentative d’ouvrir un .xlsx fichier. Aspose.Cells FOSS ne prend en charge que le chiffrement Agile (ECMA-376 Part 2, Section 4) via AgileEncryptionParameters. Les fichiers chiffrés avec le XOR hérité ou le chiffrement ECMA-376 standard ne sont pas pris en charge. Utilisez CFBReader.read_encryption_info() uniquement si le fichier utilise le chiffrement Agile ; sinon, déchiffrez-le à l’extérieur avant le chargement.

Cell Valeurs non analysées correctement depuis XML

Les symptômes incluent des valeurs de date incorrectes, des chaînes numériques interprétées à tort comme des nombres, ou des valeurs d’erreur (par ex., #N/A) non reconnues. Cela se produit lorsque CellValueHandler.parse_value_from_xml() est utilisé avec des cell_type ou manquants shared_strings contexte. Assurez‑vous que cell_type correspond à l’attribut ECMA-376 t attribut (par ex., 's' pour la chaîne partagée, 'n' pour le nombre), et fournissez un(e) rempli(e) shared_strings liste pour les types de chaîne. Utilisez CellValueHandler.get_cell_type() pour valider les types inférés avant l’analyse.

Messages d’erreur

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, et AutoFilterXMLLoader, ainsi que leurs causes et correctifs.

ErreurCauseCorrection
NotImplementedError: Standard encryption is not yet supportedTentative de lecture ou d’écriture d’un XLSX chiffré en utilisant un chiffrement non Agile (par ex., XOR, RC4).Utilisez AgileEncryptionParameters et assurez‑vous que le fichier utilise le chiffrement Agile (ECMA-376 Part 2, Section 4).
NotImplementedError: Only Agile encryption is currently supportedUtilisation CFBWriter ou CFBReader avec des paramètres de chiffrement autres que Agile.Configurez le chiffrement via AgileEncryptionParameters avant d’appeler write() ou read_encrypted_package().
NotImplementedError: Unsupported chart type for creationCréation d’un graphique de type non présent dans ChartType.LINE, BAR, PIE, AREA ou STOCK.Limitez la création de graphiques aux types pris en charge : LINE, BAR, PIE, AREA, STOCK.
NotImplementedError: Only line, bar, pie, area and stock charts are currently supportedEnregistrement des types de graphiques non pris en charge (p. ex., WATERFALL, BOX_WHISKER) en XML.Utilisez uniquement les pris en charge ChartType valeurs lors de l’enregistrement des graphiques via xml_chart_saver.
ValueError: Invalid CSV contentDonnées CSV malformées transmises à CSVHandler.load_csv_from_string() ou load_csv().Validez la syntaxe CSV avant le chargement.
ValueError: Cell value type mismatchPassage d’un type incompatible à CellValueHandler.format_value_for_xml() ou parse_value_from_xml().Utilisez CellValueHandler.get_cell_type() pour déterminer le type de cellule correct avant le formatage ou l’analyse.

Obtenir de l’aide

Pour Aspose.Cells FOSS, signalez les problèmes ou demandez des fonctionnalités via GitHub Issues. Consultez la documentation des classes telles que AutoFilter, Cell, CSVHandler, et AgileEncryptionParameters. Impliquez la communauté sur GitHub Discussions pour des questions générales concernant l’utilisation de la bibliothèque dans les flux de travail Python.

Voir aussi

Pour des conseils connexes sur la gestion des problèmes courants dans Aspose.Cells FOSS, consultez la documentation des classes de base telles que Cell, AutoFilter, CSVHandler, et AgileEncryptionParameters.

 Français