GroupDocs.Conversion for Python 26.9 – ไฮไลท์การปล่อยกันยายน 2026

เรามีความยินดีที่จะประกาศการเปิดตัว GroupDocs.Conversion for Python v26.9 ซึ่งพร้อมให้ใช้งานตั้งแต่ กันยายน 2026 รุ่นนี้อัปเกรดเอนจิน GroupDocs.Conversion พื้นฐานจากเวอร์ชัน 26.3 ไปเป็น 26.8, แนะนำ API ConversionEvents สำหรับการตรวจสอบการแปลงแบบเรียลไทม์, เพิ่มการสนับสนุนไฟล์อาร์ไคฟ์ XAR, แผนภาพ draw.io และ Mermaid, พร้อมด้วยตัวเลือกการโหลดและแปลงใหม่หลายรายการ นอกจากนี้ยังแก้ไขปัญหาความเข้ากันได้สำคัญบน Python 3.5–3.10 และแก้ไขข้อบกพร่องที่ค้างคามานานเกี่ยวกับคุณสมบัติแบบ delegate‑typed และอาร์กิวเมนต์ enum

สิ่งใหม่ในรุ่นนี้

• [Feature] เพิ่มการสนับสนุน ConversionEvents เพื่อสังเกตการเริ่มต้น, ความคืบหน้า, การแปลงเสร็จสิ้นต่อหน้าและต่อเอกสาร, ความล้มเหลวและการแทนที่ฟอนต์ (CONVERSIONPYTHON-93)
• [Feature] เพิ่มการสนับสนุนรูปแบบใหม่ — ไฟล์อาร์ไคฟ์ XAR, แผนภาพ draw.io และ Mermaid (.mmd) (CONVERSIONPYTHON-94)
• [Feature] เพิ่ม CadLoadOptions.layout_scope เพื่อจำกัดการแปลง CAD ให้เป็น model space, paper‑space layouts หรือทั้งสองอย่าง (CONVERSIONPYTHON-95)
• [Feature] เพิ่ม MarkdownOptions.image_saving_callback เพื่อควบคุมตำแหน่งที่บันทึกภาพที่สกัดออกมาจาก Markdown (CONVERSIONPYTHON-96)
• [Feature] เพิ่ม EmailLoadOptions.page_layout_options และ WebLoadOptions.margin_settings / orientation_settings / size_settings (CONVERSIONPYTHON-97)
• [Feature] เพิ่ม ImageConvertOptions.min_resolution และ cap_resolution_to_page_content (CONVERSIONPYTHON-98)
• [Feature] เพิ่ม WordProcessingLoadOptions.auto_detect_rtl_direction (CONVERSIONPYTHON-99)
• [Feature] เพิ่ม MissingDependencyException เพื่อให้ข้อผิดพลาดที่ชัดเจนเมื่อไม่มี dependency ของเอนจินที่เป็นตัวเลือก (CONVERSIONPYTHON-100)
• [Enhancement] อัปเดตเอนจิน GroupDocs.Conversion จาก 26.3 ไปเป็น 26.8 (CONVERSIONPYTHON-101)
• [Enhancement] ลบโมดูล groupdocs.conversion.file_types ที่ซ้ำซ้อน — ใช้ groupdocs.conversion.filetypes แทน (CONVERSIONPYTHON-102)
• [Enhancement] เปลี่ยนชื่อ PdfOptions.remove_pdf_acompliance เป็น remove_pdf_a_compliance (CONVERSIONPYTHON-103)
• [Enhancement] เพิ่มส่วน “Developer Guide” และหน้า groupdocs.conversion.integration.* ใน API reference (CONVERSIONPYTHON-104)
• [Fix] ไม่สามารถนำเข้าโมดูลได้เมื่อใช้ Python 3.5 – 3.7 (CONVERSIONPYTHON-91)
• [Fix] เกิด Runtime error เมื่อส่งอาร์กิวเมนต์ Enum ใน Python 3.8 – 3.10 (CONVERSIONPYTHON-92)
• [Fix] Indexer item บน *DocumentInfo และ PossibleConversions เป็น property จึงไม่สามารถเรียกได้ (CONVERSIONPYTHON-105)
• [Fix] คุณสมบัติแบบ delegate‑typed ไม่สามารถกำหนดค่าได้จาก Python (Object must implement IConvertible) (CONVERSIONPYTHON-106)
• [Fix] คุณสมบัติแบบ delegate‑typed ถูกระบุประเภทผิดใน stub และ docstring (CONVERSIONPYTHON-107)

การเปลี่ยนแปลง Public API

คลาสใหม่

สมาชิกใหม่บนคลาสที่มีอยู่

• FluentConverter.with_events(...) และเช่นเดียวกันบน IConversionFrom และ IConversionSettings
• Converter(...) — มี overload ของคอนสตรัคเตอร์ใหม่ 4 ตัวที่รับ ConversionEvents
• CadLoadOptions.layout_scope
• EmailLoadOptions.page_layout_options
• WebLoadOptions.margin_settings, .orientation_settings, .size_settings
• MarkdownOptions.image_saving_callback
• ImageConvertOptions.min_resolution, .cap_resolution_to_page_content
• WordProcessingLoadOptions.auto_detect_rtl_direction
• CompressionFileType.XAR, DiagramFileType.DRAWIO, DiagramFileType.MMD

ลบ — groupdocs.conversion.file_types

โมดูล groupdocs.conversion.file_types และคลาส 23 ตัวที่อยู่ในนั้นถูกลบออก แต่คลาสเองยังคงอยู่ — ทุกคลาสยังคงมีอยู่โดยไม่มีการเปลี่ยนแปลงใน groupdocs.conversion.filetypes

หากคุณเคย import จากโมดูลนี้ ให้เปลี่ยนการ import — ไม่มีการเปลี่ยนแปลงอื่นใด:

# before
from groupdocs.conversion.file_types import WordProcessingFileType
# after
from groupdocs.conversion.filetypes import WordProcessingFileType

เปลี่ยนชื่อ — PdfOptions.remove_pdf_acompliance

# before
options.remove_pdf_acompliance = True
# after
options.remove_pdf_a_compliance = True

คุณสมบัติใหม่

เหตุการณ์การแปลง (Conversion events)

ConversionEvents ให้คุณสังเกตการแปลงขณะทำงาน — ความคืบหน้า, การแปลงเสร็จสิ้นต่อหน้าและต่อเอกสาร, ความล้มเหลว, และการแทนที่ฟอนต์ แนบฟังก์ชัน Python ธรรมดาได้:

from groupdocs.conversion import ConversionEvents, Converter, ConverterSettings
from groupdocs.conversion.options.convert import PdfConvertOptions

events = ConversionEvents()
events.on_conversion_started = lambda: print("started")
events.on_conversion_progress = lambda percent: print(f"{percent}%")
events.on_document_converted = lambda ctx: print("document done")
events.on_font_substituted = lambda ctx: print(
    f"{ctx.original_font_name} -> {ctx.substitute_font_name} ({ctx.reason})")
events.on_conversion_completed = lambda: print("completed")

with Converter("business-plan.docx", ConverterSettings(), events) as converter:
    converter.convert("business-plan.pdf", PdfConvertOptions())

โปรดสังเกตว่าคอนสตรัคเตอร์รับพารามิเตอร์ (path, settings, events) — ไม่มี overload ที่รับ (path, events) ดังนั้นต้องส่ง ConverterSettings() แม้คุณจะไม่ต้องการกำหนดค่าใด ๆ

ฮุคที่พร้อมใช้งานได้แก่ on_conversion_started, on_conversion_progress, on_conversion_completed, on_document_converted, on_document_failed, on_page_converted, on_page_failed, on_compression_completed และ on_font_substituted.

รูปแบบใหม่

ขอบเขตการแปลง CAD (CAD layout scope)

from groupdocs.conversion.options.load import CadLayoutScope, CadLoadOptions

load_options = CadLoadOptions()
load_options.layout_scope = CadLayoutScope.MODEL     # MODEL | LAYOUTS | BOTH

BOTH เป็นค่าเริ่มต้นและจะไม่จำกัดการแปลง

ตัวอย่างโค้ด

from groupdocs.conversion import ConversionEvents, Converter, ConverterSettings
from groupdocs.conversion.options.convert import PdfConvertOptions

events = ConversionEvents()
events.on_conversion_started = lambda: print("started")
events.on_conversion_progress = lambda percent: print(f"{percent}%")
events.on_document_converted = lambda ctx: print("document done")
events.on_font_substituted = lambda ctx: print(
    f"{ctx.original_font_name} -> {ctx.substitute_font_name} ({ctx.reason})")
events.on_conversion_completed = lambda: print("completed")

with Converter("business-plan.docx", ConverterSettings(), events) as converter:
    converter.convert("business-plan.pdf", PdfConvertOptions())

วิธีรับอัปเดต

PyPI

pip install groupdocs-conversion-net==26.9.0

ดาวน์โหลดโดยตรง

ดาวน์โหลดจากหน้า GroupDocs.Conversion for Python via .NET 26.9

แหล่งข้อมูล

• Full Release Notes
• Product Page
• Documentation
• API Reference
• Code Examples
• Free Support Forum