เรามีความยินดีที่จะแจ้งการปล่อย GroupDocs.Redaction for Python v26.11 ซึ่งพร้อมให้ใช้งานตั้งแต่ พฤศจิกายน 2026 รุ่นนี้อัปเกรดเอนจิน GroupDocs.Redaction จากเวอร์ชัน 26.5 เป็น 26.10 และฝัง .NET runtime 10.0.15 แทนที่ System.Drawing ด้วย Aspose.Drawing และ SkiaSharp เพื่อการเรสเตอร์ไลซ์ข้ามแพลตฟอร์มและการลบข้อมูลในพื้นที่ภาพ—รวมถึง Linux และ macOS คุณลักษณะใหม่รวมถึงการแสดงตัวอย่างหน้า, การสนับสนุน Python logger, การรวม Python OCR connector, การควบคุมการปฏิบัติตาม OOXML สำหรับเอกสาร Word, การโหลดไฟล์ตามประเภทอย่างชัดเจน, และการตรวจสอบสถานะใบอนุญาต
สิ่งใหม่ในรุ่นนี้
- [Feature] เพิ่มการสนับสนุนการแสดงตัวอย่างหน้าให้กับไฟล์และ
io.BytesIO(PreviewOptions,generate_preview()) (REDACTIONPYTHONNET-23) - [Feature] เพิ่มการสนับสนุน Python logger (
ILogger) (REDACTIONPYTHONNET-24) - [Feature] เพิ่มการสนับสนุน Python OCR connector (
IOcrConnector) เพื่อทำการลบข้อความในภาพ (REDACTIONPYTHONNET-25) - [Feature] เพิ่มการสนับสนุนการตั้งค่าระดับการปฏิบัติตาม OOXML ของเอกสาร Word ที่บันทึก (
ooxml_compliance) (REDACTIONPYTHONNET-26) - [Feature] เพิ่มการสนับสนุนการเปิดเอกสารเป็นประเภทไฟล์ที่กำหนด (
LoadOptions.file_type) (REDACTIONPYTHONNET-27) - [Feature] เพิ่มการสนับสนุนการตรวจสอบว่ามีการใช้ใบอนุญาตหรือไม่ (
License.is_licensed) (REDACTIONPYTHONNET-28) - [Enhancement] อัปเดต GroupDocs.Redaction เป็น 26.10 และ runtime ที่ฝังไว้เป็น .NET 10.0.15 (REDACTIONPYTHONNET-29)
- [Enhancement] แทนที่ประเภท
groupdocs.pydrawingด้วยgroupdocs.redaction.options.drawing(Color,Point,Size,Rectangle,Font,FontStyle) (REDACTIONPYTHONNET-30) - [Enhancement] คืนค่า enum
RedactionTypeและRedactionActionTypeจากคำอธิบายของ redaction callback (REDACTIONPYTHONNET-31) - [Enhancement] โยน
AttributeErrorเมื่อมีการกำหนดแอตทริบิวต์ที่ไม่รู้จักให้กับวัตถุ API (REDACTIONPYTHONNET-32) - [Enhancement] โยน
LicenseErrorสำหรับใบอนุญาตที่ไม่สามารถนำไปใช้ได้ และส่งออกLicenseErrorและGroupDocsRedactionExceptionจากgroupdocs.redaction(REDACTIONPYTHONNET-33) - [Enhancement] ติดตั้ง
groupdocs.pydrawingและgroupdocs.pycoreจากแพคเกจแชร์groupdocs-shared-net(REDACTIONPYTHONNET-34) - [Fix] แก้ไขปัญหา CVE ในเวอร์ชัน 26.6.0: .NET runtime 10.0.0 → 10.0.15 (+2 รายการเพิ่มเติม) (REDACTIONPYTHONNET-12)
- [Fix] การแสดงผล PDF ที่เรสเตอร์ไลซ์และการลบข้อมูลในพื้นที่ภาพทำให้เกิด
PlatformNotSupportedExceptionบน Linux และ macOS (REDACTIONPYTHONNET-35) - [Fix] redaction callback ล้มเหลวด้วย
JSONDecodeErrorเมื่อข้อความมีแท็บ (REDACTIONPYTHONNET-36) - [Fix]
RedactorSettingsโยนTypeErrorสำหรับ redaction callback ที่ส่งเป็นอาร์กิวเมนต์เดียว (REDACTIONPYTHONNET-37) - [Fix] Wheels ติดตั้งบน Linux และ macOS เวอร์ชันที่ .NET runtime ที่ฝังไว้ไม่สามารถทำงานได้ (REDACTIONPYTHONNET-38)
การเปลี่ยนแปลง Public API
ผู้อัปเกรดต้องนำเข้าสีและเรขาคณิตจาก groupdocs.redaction.options.drawing และเปรียบเทียบ redaction_type และ action_type ของ redaction callback กับสมาชิกของ enum ส่วนอื่น ๆ จะเป็นการเพิ่มเท่านั้น
คลาสและสมาชิกใหม่
groupdocs.redaction:CancellationToken,CancellationTokenSource,OperationCanceledError,LicenseError,LicenseWarning,GroupDocsRedactionException.groupdocs.redaction.options:WordProcessingComplianceLevel,WordprocessingSaveOptions.groupdocs.redaction.options.drawing:Color,Font,FontStyle,Point,Rectangle,Size.FileType:DJVU,LOG,OTP,POTM,POTX,PPS,PPSM,PPSX,PPTM,TAB,WEBP,XLT,XLTM,XLTX.License:is_licensed.LoadOptions:file_type.SaveOptions:wordprocessing_save_options.
groupdocs.redaction.options.drawing เป็นโมดูลใหม่ GroupDocsRedactionException ยังถูกส่งออกโดย groupdocs.redaction.exceptions ด้วย
ถูกลบ
สี groupdocs.pydrawing ที่เวอร์ชัน 26.6 ส่งออกใหม่; ให้นำเข้า Color จาก groupdocs.redaction.options.drawing แทน:
groupdocs.redaction.Colorgroupdocs.redaction.redactions.Color
มีการเปลี่ยนแปลง
- ทุกสมาชิกที่รับหรือคืนค่าสี, จุด, ขนาด หรือสี่เหลี่ยม จะใช้ประเภทจาก
groupdocs.redaction.options.drawingค่าgroupdocs.pydrawingจะทำให้เกิดTypeError(ไม่มี overload ที่ตรงกัน) RedactionDescription.redaction_typeและaction_typeที่ redaction callback อ่าน จะเป็นสมาชิกของRedactionTypeและRedactionActionType- นามแฝงที่ล้าสมัยของเอนจินยังคงอยู่เช่น:
ReplacementOptions.box_fill_color,RegionReplacementOptions.area_fill_colorและarea_size,ImageAreaRedaction.top_left_position,PageAreaFilter.area_rectangleและTextFragment.bounding_rectangle. ใช้box_color,fill_color,size,top_leftและrectangle.
คุณลักษณะใหม่
การแสดงตัวอย่างหน้า
Redactor.generate_preview() แสดงหน้าของเอกสารเป็นภาพ PreviewOptions รับฟังก์ชันที่คืนค่า stream สำหรับแต่ละหน้า, ไฟล์ไบนารีที่เปิดอยู่ หรือ io.BytesIO และอาจมีฟังก์ชันที่สองที่ปล่อย stream ของแต่ละหน้า ตั้งค่า width, height และ page_numbers. เวอร์ชัน 26.6.0 ปฏิเสธฟังก์ชัน Python ด้วย TypeError.
Python logger
RedactorSettings(logger=...) รับอ็อบเจ็กต์ที่มีเมธอด error(message), warning(message) และ trace(message), และเอนจินจะรายงานผ่านมัน เวอร์ชัน 26.6.0 ปฏิเสธ Python logger ด้วย TypeError.
Python OCR connector
GroupDocs.Redaction ไม่ได้มาพร้อมกับ OCR engine. RedactorSettings(ocr_connector=...) รับอ็อบเจ็กต์ที่มีเมธอด recognize(image_stream) ซึ่งคืนค่าที่ OCR engine ของคุณพบ: RecognizedImage ของ TextLine ที่ประกอบด้วย TextFragment แต่ละอันที่มีข้อความและสี่เหลี่ยม. เอนจินจะค้นหาวลีในภาพและทับสีลงไป รายงานแต่ละบรรทัดของข้อความเป็น TextFragment หนึ่งรายการ เวอร์ชัน 26.6.0 ปฏิเสธ Python connector ด้วย TypeError.
ระดับการปฏิบัติตาม OOXML ของเอกสาร Word ที่บันทึก
SaveOptions.wordprocessing_save_options.ooxml_compliance ตั้งค่าระดับการปฏิบัติตาม OOXML ของเอกสาร Word ที่บันทึก: WordProcessingComplianceLevel.ECMA, TRANSITIONAL หรือ STRICT. หากไม่ได้ตั้งค่า เอกสารจะคงระดับเดิมที่มีอยู่ เวอร์ชัน 26.6.0 ไม่มีคุณลักษณะนี้
เปิดเอกสารเป็นประเภทไฟล์ที่กำหนด
LoadOptions(file_type) เปิด stream หรือไฟล์ที่ชื่อไม่บ่งบอกรูปแบบเป็น FileType ที่กำหนด เวอร์ชัน 26.6.0 ไม่มีคุณลักษณะนี้
ตรวจสอบว่ามีการใช้ใบอนุญาตหรือไม่
License().is_licensed จะเป็น True เมื่อใบอนุญาตถูกนำไปใช้แล้ว โดยใช้ License().set_license() หรือจากตัวแปรสภาพแวดล้อม GROUPDOCS_LIC_PATH
ตัวอย่างโค้ด
import io
from groupdocs.redaction import Redactor
from groupdocs.redaction.options import PreviewOptions, PreviewFormats
pages = {}
def create_page_stream(page_number):
pages[page_number] = io.BytesIO()
return pages[page_number]
with Redactor("document.pdf") as redactor:
options = PreviewOptions(create_page_stream)
options.width, options.height = 300, 400
options.page_numbers = [1]
options.preview_format = PreviewFormats.PNG
redactor.generate_preview(options)
print(len(pages[1].getvalue()), "bytes of PNG")
วิธีรับอัปเดต
PyPI
อัปเกรดผ่าน PyPI:
ติดตั้งด้วย:
pip install groupdocs-redaction-net==26.11.0
ดาวน์โหลดโดยตรง
ดาวน์โหลด wheel สำหรับแพลตฟอร์มของคุณจาก:
- GroupDocs.Redaction for Python via .NET 26.11 – Windows
- GroupDocs.Redaction for Python via .NET 26.11 – Linux
- GroupDocs.Redaction for Python via .NET 26.11 – macOS Intel
- GroupDocs.Redaction for Python via .NET 26.11 – macOS Apple Silicon