문제 해결 가이드

일반적인 문제

이 섹션에서는 Python에서 Aspose.Cells FOSS를 사용할 때, Cell, AutoFilter, CSVHandler 및 CFBReader와 같은 API 표면 클래스와 관련된 자주 발생하는 문제들을 다룹니다.

CSV 가져오기 인코딩 오류로 실패

증상으로는 CSV 파일을 로드할 때 깨진 텍스트 또는 UnicodeDecodeError가 나타납니다. 이는 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는 AgileEncryptionParameters을 통해 Agile 암호화(ECMA-376 Part 2, Section 4)만 지원합니다. 레거시 XOR 또는 표준 ECMA-376 암호화로 암호화된 파일은 지원되지 않습니다. 파일이 Agile 암호화를 사용하는 경우에만 CFBReader.read_encryption_info()을 사용하십시오; 그렇지 않으면 로드하기 전에 외부에서 복호화하십시오.

`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는 파일 I/O, 암호화 및 구문 분석 작업 중에 특정 오류를 발생시킵니다. 이 섹션에서는 CFBReader, CFBWriter 및 AutoFilterXMLLoader와 같은 클래스에서 발생하는 일반적인 오류 메시지와 그 원인 및 해결 방법을 문서화합니다.

Error	Cause	Fix
`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이 아닌 암호화 매개변수와 함께 사용함.	`write()` 또는 `read_encrypted_package()`을 호출하기 전에 `AgileEncryptionParameters`을 통해 암호화를 구성하십시오.
`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에 저장함.	`xml_chart_saver`를 통해 차트를 저장할 때 지원되는 `ChartType` 값만 사용하십시오.
`ValueError: Invalid CSV content`	`CSVHandler.load_csv_from_string()` 또는 `load_csv()`에 전달된 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와 같은 클래스에 대한 문서를 검토하십시오. Python 워크플로에서 라이브러리를 사용하는 일반적인 질문은 GitHub Discussions에서 커뮤니티와 소통하십시오.

GitHub 이슈: 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와 같은 핵심 클래스에 대한 문서를 검토하십시오.