Vianmääritysoppaat

Yleisiä ongelmia

Tämä osio käsittelee yleisiä ongelmia, joita esiintyy käytettäessä Aspose.Cells FOSS:ia Python:ssa, erityisesti API-rajapinnan luokkien kanssa, kuten Cell, AutoFilter, CSVHandler, ja CFBReader.

CSV‑tuonti epäonnistuu merkistökoodausvirheiden takia

Oireita ovat vääristynyt teksti tai UnicodeDecodeError kun ladataan CSV-tiedostoja. Tämä tapahtuu, kun CSV-tiedosto käyttää ei-UTF-8-merkistöä (esim. cp1252 tai Shift-JIS). Korjataksesi, muunna tiedosto UTF-8-muotoon ennen lataamista tai anna CSVLoadOptions instance to CSVHandler.load_csv():

from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions

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

`AutoFilter` Ei sovellettu XLSX:n lataamisen jälkeen

Oireita ovat puuttuvat suodatusohjaimet tai suodattamaton data lataamisen jälkeen .xlsx tiedosto. Tämä tapahtuu, kun AutoFilterXMLLoader.load_auto_filter() epäonnistuu hiljaisesti, koska lähdetiedoston XML on virheellinen. Vahvista, että XLSX:n xl/autofilters/autofilter*.xml on hyvin muodostettu. Jos tiedosto on luotu ulkoisesti, varmista, että se noudattaa ECMA-376:ta. Käytä AutoFilter.range, filter_columns, ja sort_state tarkastellaksesi ladattua tilaa latauksen jälkeen.

Salatut XLSX‑tiedostot eivät ole luettavissa

Oireita ovat NotImplementedError: Standard encryption is not yet supported kun yritetään avata salattu .xlsx tiedosto. Aspose.Cells FOSS tukee vain Agile-salausta (ECMA-376 Osa 2, Luku 4) kautta AgileEncryptionParameters. Tiedostot, jotka on salattu vanhalla XOR- tai standardi ECMA-376-salauksella, eivät ole tuettuja. Käytä CFBReader.read_encryption_info() vain jos tiedosto käyttää Agile-salausta; muuten pura salaus ulkoisesti ennen lataamista.

`Cell` Arvot eivät jäsenny oikein XML:stä

Oireita ovat virheelliset päivämääräarvot, numeeriset merkkijonot tulkittuna luvuiksi tai virhearvot (esim., #N/A) ei tunnisteta. Tämä tapahtuu, kun CellValueHandler.parse_value_from_xml() käytetään virheellisesti cell_type tai puuttuu shared_strings kontekstissa. Varmista cell_type vastaa ECMA-376 -standardia t attribuutti (esim., 's' jaetulle merkkijonolle, 'n' numerolle), ja tarjoa täytetty shared_strings luettelo merkkijonotyypeille. Käytä CellValueHandler.get_cell_type() vahvista pääteltyjen tyyppien ennen jäsentämistä.

Virheilmoitukset

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, ja AutoFilterXMLLoader, niiden syiden ja korjausten kanssa.

Virhe	Syy	Korjaus
`NotImplementedError: Standard encryption is not yet supported`	Yritetään lukea tai kirjoittaa salattua XLSX-tiedostoa käyttäen ei-Agile-salausta (esim. XOR, RC4).	Käytä `AgileEncryptionParameters` ja varmista, että tiedosto käyttää Agile-salausta (ECMA-376 Part 2, Section 4).
`NotImplementedError: Only Agile encryption is currently supported`	Käyttäen `CFBWriter` tai `CFBReader` muilla kuin Agile-salausparametreilla.	Määritä salaus käyttäen `AgileEncryptionParameters` ennen kutsua `write()` tai `read_encrypted_package()`.
`NotImplementedError: Unsupported chart type for creation`	Luodaan kaavio, jonka tyyppi ei ole `ChartType.LINE`, BAR, PIE, AREA tai STOCK.	Rajoita kaavion luominen tuettuihin tyyppeihin: LINE, BAR, PIE, AREA, STOCK.
`NotImplementedError: Only line, bar, pie, area and stock charts are currently supported`	Tallennetaan tukemattomia kaaviotyyppejä (esim. WATERFALL, BOX_WHISKER) XML-muotoon.	Käytä vain tuettuja `ChartType` arvoja tallentaessasi kaavioita via `xml_chart_saver`.
`ValueError: Invalid CSV content`	Virheellisesti muotoiltu CSV-data annettu `CSVHandler.load_csv_from_string()` tai `load_csv()`.	Vahvista CSV-syntaksi ennen lataamista.
`ValueError: Cell value type mismatch`	Epäyhteensopivan tyypin antaminen `CellValueHandler.format_value_for_xml()` tai `parse_value_from_xml()`.	Käytä `CellValueHandler.get_cell_type()` tunnistaaksesi oikean solutyypin ennen muotoilua tai jäsentämistä.

Apua saaminen

Kun kyseessä on Aspose.Cells FOSS, raportoi ongelmista tai pyydä ominaisuuksia GitHub Issues -kanavan kautta. Tarkastele dokumentaatiota luokille, kuten AutoFilter, Cell, CSVHandler, ja AgileEncryptionParameters. Osallistu yhteisöön GitHub Discussions -alustalla yleisissä kysymyksissä kirjaston käytöstä Python-työnkuluissa.

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
API-viite: https://reference.aspose.org/cells/python/

Katso myös

Saadaksesi lisäohjeita yleisten ongelmien käsittelemiseen Aspose.Cells FOSS -ympäristössä, tarkastele ydinklassien dokumentaatiota, kuten Cell, AutoFilter, CSVHandler, ja AgileEncryptionParameters.