Guías de solución de problemas

Problemas comunes

Esta sección cubre los problemas frecuentes que se encuentran al usar Aspose.Cells FOSS en Python, específicamente con clases de la superficie de la API como Cell, AutoFilter, CSVHandler, y CFBReader.

La importación de CSV falla con errores de codificación

Los síntomas incluyen texto distorsionado o UnicodeDecodeError al cargar archivos CSV. Esto ocurre cuando el archivo CSV usa una codificación que no es UTF-8 (p. ej., cp1252 o Shift-JIS). Para solucionarlo, convierta el archivo a UTF-8 antes de cargarlo, o pase un CSVLoadOptions instancia a CSVHandler.load_csv():

from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions

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

`AutoFilter` No se aplica después de cargar XLSX

Los síntomas incluyen controles de filtro ausentes o datos sin filtrar después de cargar un .xlsx archivo. Esto ocurre cuando AutoFilterXMLLoader.load_auto_filter() falla silenciosamente debido a XML malformado en el archivo fuente. Verifique que el XLSX xl/autofilters/autofilter*.xml esté bien formado. Si el archivo fue creado externamente, asegúrese de que cumpla con ECMA-376. Use AutoFilter.range, filter_columns, y sort_state para inspeccionar el estado cargado después de la carga.

Los archivos XLSX cifrados no pueden leerse

Los síntomas incluyen NotImplementedError: Standard encryption is not yet supported al intentar abrir un archivo cifrado .xlsx archivo. Aspose.Cells FOSS solo admite el cifrado Agile (ECMA-376 Parte 2, Sección 4) a través de AgileEncryptionParameters. Los archivos cifrados con XOR heredado o con el cifrado estándar ECMA-376 no son compatibles. Use CFBReader.read_encryption_info() solo si el archivo usa cifrado Agile; de lo contrario, descífralo externamente antes de cargarlo.

`Cell` Valores que no se analizan correctamente desde XML

Los síntomas incluyen valores de fecha incorrectos, cadenas numéricas interpretadas erróneamente como números, o valores de error (p. ej., #N/A) no se reconocen. Esto ocurre cuando CellValueHandler.parse_value_from_xml() se usa con incorrecto cell_type o falta shared_strings contexto. Asegúrese cell_type coincide con el ECMA-376 t atributo (p. ej., 's' para cadena compartida, 'n' para número), y proporcione una poblada shared_strings lista para tipos de cadena. Use CellValueHandler.get_cell_type() para validar los tipos inferidos antes del análisis.

Mensajes de error

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, y AutoFilterXMLLoader, junto con sus causas y correcciones.

Error	Causa	Corregir
`NotImplementedError: Standard encryption is not yet supported`	Intentando leer o escribir XLSX cifrado usando cifrado no Agile (p. ej., XOR, RC4).	Usar `AgileEncryptionParameters` y asegúrese de que el archivo use cifrado Agile (ECMA-376 Parte 2, Sección 4).
`NotImplementedError: Only Agile encryption is currently supported`	Usando `CFBWriter` o `CFBReader` con parámetros de cifrado diferentes a Agile.	Configure el cifrado a través de `AgileEncryptionParameters` antes de llamar a `write()` o `read_encrypted_package()`.
`NotImplementedError: Unsupported chart type for creation`	Creando un gráfico de tipo no incluido en `ChartType.LINE`, BAR, PIE, AREA, o STOCK.	Limite la creación de gráficos a los tipos compatibles: LINE, BAR, PIE, AREA, STOCK.
`NotImplementedError: Only line, bar, pie, area and stock charts are currently supported`	Guardando tipos de gráficos no compatibles (p. ej., WATERFALL, BOX_WHISKER) en XML.	Utilice solo los compatibles `ChartType` valores al guardar gráficos mediante `xml_chart_saver`.
`ValueError: Invalid CSV content`	Datos CSV malformados pasados a `CSVHandler.load_csv_from_string()` o `load_csv()`.	Valide la sintaxis CSV antes de cargar.
`ValueError: Cell value type mismatch`	Pasando un tipo incompatible a `CellValueHandler.format_value_for_xml()` o `parse_value_from_xml()`.	Utilice `CellValueHandler.get_cell_type()` para determinar el tipo de celda correcto antes de formatear o analizar.

Obtener ayuda

Para Aspose.Cells FOSS, informe problemas o solicite funciones a través de GitHub Issues. Revise la documentación de clases como AutoFilter, Cell, CSVHandler, y AgileEncryptionParameters. Involucre a la comunidad en GitHub Discussions para preguntas generales sobre el uso de la biblioteca en flujos de trabajo de Python.

GitHub Issues: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
GitHub Discussions: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/discussions
Referencia de API: https://reference.aspose.org/cells/python/

Ver también

Para obtener orientación relacionada sobre cómo manejar problemas comunes en Aspose.Cells FOSS, revise la documentación de clases centrales como Cell, AutoFilter, CSVHandler, y AgileEncryptionParameters.