การสกัดข้อความดิบจากเวิร์กบุ๊ก Excel เป็นความต้องการที่พบบ่อยเมื่อสร้างสายงานข้อมูลหรือสร้างรายงานอย่างง่าย หากคุณต้องการทราบ วิธีแปลง Excel Workbook เป็นข้อความใน Python SDK GroupDocs.Conversion Cloud SDK for Python ทำให้เรื่องนี้ง่ายขึ้น คู่มือนี้จะพาคุณผ่านขั้นตอนการติดตั้ง SDK, การอัปโหลดเวิร์กบุ๊ก, การกำหนดค่าตัวเลือกการแปลง, และการดึงผลลัพธ์เป็นไฟล์ TXT ธรรมดา เมื่อเสร็จสิ้นคุณจะมีสคริปต์ที่ใช้ซ้ำได้และชุดคำสั่ง cURL สำหรับการทำงานอัตโนมัติโดยใช้ REST.

ก่อนที่คุณจะเริ่ม: ข้อกำหนดเบื้องต้นและการติดตั้ง

ก่อนที่คุณจะเริ่มต้น โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้:

  • Python 3.7 หรือใหม่กว่า ติดตั้งบนเครื่องของคุณ
  • มีบัญชี GroupDocs Cloud ที่ใช้งานอยู่ (client ID และ client secret)
  • การเข้าถึงเครือข่ายไปยัง endpoint ของ GroupDocs Cloud

ติดตั้ง SDK ผ่าน pip:

pip install groupdocs-conversion-cloud

คุณยังสามารถดาวน์โหลดแพ็กเกจล่าสุดจาก หน้าเผยแพร่อย่างเป็นทางการ ได้ หลังการติดตั้ง ให้ตั้งค่าข้อมูลประจำตัวของคุณเป็นตัวแปรสภาพแวดล้อมหรือแทนที่ตัวแปรตำแหน่งในโค้ดในภายหลัง เมื่อ SDK พร้อมแล้ว คุณก็พร้อมที่จะเริ่มกระบวนการแปลง.

สร้างอย่างเป็นขั้นตอน: วิธีแปลง Excel Workbook เป็นข้อความใน Python

ขั้นตอนที่ 1: ตั้งค่าข้อมูลประจำตัว

ก่อนแรก ให้สร้างอ็อบเจ็กต์ Configuration และระบุ client ID และ secret ของคุณ อ็อบเจ็กต์นี้จะถูกใช้ในทุกการเรียก API ถัดไป

import os
from groupdocs_conversion_cloud import Configuration

client_id = os.getenv("GROUPDOCS_CLIENT_ID", "YOUR_CLIENT_ID")
client_secret = os.getenv("GROUPDOCS_CLIENT_SECRET", "YOUR_CLIENT_SECRET")

config = Configuration()
config.client_id = client_id
config.client_secret = client_secret

คลาส Configuration ถูกบันทึกไว้ใน API reference.

ขั้นตอนที่ 2: อัปโหลด Excel Workbook

อัปโหลดไฟล์ Excel ในเครื่องไปยัง GroupDocs Cloud storage. ขั้นตอนนี้เป็นทางเลือกหากไฟล์ของคุณอยู่ในคลาวด์แล้ว.

from groupdocs_conversion_cloud import ApiClient, UploadFileApi, UploadFileRequest

api_client = ApiClient(config)
upload_api = UploadFileApi(api_client)

local_excel_path = "sample.xlsx"
remote_excel_path = "sample.xlsx"

with open(local_excel_path, "rb") as f:
    upload_request = UploadFileRequest(
        path=remote_excel_path,
        file=f.read()
    )
    upload_api.upload_file(upload_request)

ฟังก์ชัน UploadFileApi จัดการการถ่ายโอนไฟล์; ดูเอกสารของมันสำหรับรายละเอียดเพิ่มเติม.

ขั้นตอนที่ 3: กำหนดตัวเลือกการแปลง

สร้างอ็อบเจ็กต์ TxtConvertOptions เพื่อระบุพารามิเตอร์ทางเลือก เช่น ช่วงหน้า จากนั้นสร้างอ็อบเจ็กต์ ConvertSettings ที่เชื่อมทุกอย่างเข้าด้วยกัน.

from groupdocs_conversion_cloud import (
    FileInfo,
    TxtConvertOptions,
    ConvertSettings,
)

file_info = FileInfo()
file_info.file_path = remote_excel_path

txt_options = TxtConvertOptions()
# txt_options.page_number = 1   # Uncomment to start from a specific page
# txt_options.page_count = 1    # Uncomment to limit the number of pages

convert_settings = ConvertSettings()
convert_settings.file_info = file_info
convert_settings.format = "txt"
convert_settings.output_path = "sample.txt"
convert_settings.options = txt_options

คลาส TxtConvertOptions ให้คุณปรับแต่งการแปลงอย่างละเอียด; โปรดดูที่ เอกสารอย่างเป็นทางการ สำหรับฟิลด์ที่มีทั้งหมด.

ขั้นตอนที่ 4: ดำเนินการแปลง

เรียกเมธอด convert ของ ConvertApi พร้อมกับการตั้งค่าที่เตรียมไว้ การตอบสนองจะมี URL สำหรับดาวน์โหลดไฟล์ที่แปลงแล้ว.

from groupdocs_conversion_cloud import ConvertApi, ApiException

convert_api = ConvertApi(api_client)

try:
    conversion_result = convert_api.convert(convert_settings)
    print(f"Conversion succeeded. Download URL: {conversion_result.url}")
except ApiException as e:
    print(f"Conversion failed: {e}")

หากการเรียกสำเร็จ คุณจะได้รับลิงก์ดาวน์โหลดโดยตรงสำหรับไฟล์ TXT.

ขั้นตอนที่ 5: ดึงผลลัพธ์

ใช้ URL จากขั้นตอนก่อนหน้าเพื่อดาวน์โหลดไฟล์ข้อความธรรมดาไปยังสภาพแวดล้อมในเครื่องของคุณ หรือดำเนินการต่อในแอปพลิเคชันของคุณ

เคล็ดลับ: คุณสามารถทำการดาวน์โหลดโดยอัตโนมัติด้วยการเรียก requests.get() อย่างง่าย โดยจัดการการตรวจสอบสิทธิ์ผ่านโทเค็นการเข้าถึงเดียวกันที่ใช้สำหรับคำขอแปลงรูปแบบ

ด้วยขั้นตอนเหล่านี้ คุณจะมีเวิร์กโฟลว์ที่สมบูรณ์สำหรับ วิธีแปลง Excel Workbook เป็นข้อความใน Python โดยใช้ไลบรารี GroupDocs.

การแปลงข้อความใน Excel Workbook - ตัวอย่างโค้ดเต็ม

ตัวอย่างต่อไปนี้แสดงการดำเนินการเต็มรูปแบบตั้งแต่เริ่มต้นจนจบ.

import os
from groupdocs_conversion_cloud import (
    Configuration,
    ApiClient,
    UploadFileApi,
    UploadFileRequest,
    ConvertApi,
    ConvertSettings,
    FileInfo,
    TxtConvertOptions,
    ApiException,
)

def main():
    # ----------------------------------------------------------------------
    # 1. Configure credentials (replace placeholders or set env variables)
    # ----------------------------------------------------------------------
    client_id = os.getenv("GROUPDOCS_CLIENT_ID", "YOUR_CLIENT_ID")
    client_secret = os.getenv("GROUPDOCS_CLIENT_SECRET", "YOUR_CLIENT_SECRET")

config = Configuration()
    config.client_id = client_id
    config.client_secret = client_secret

api_client = ApiClient(config)

# ----------------------------------------------------------------------
    # 2. Upload local Excel workbook to GroupDocs Cloud storage (optional)
    # ----------------------------------------------------------------------
    local_excel_path = "sample.xlsx"          # path to the Excel file on your machine
    remote_excel_path = "sample.xlsx"         # path where the file will be stored in the cloud

upload_api = UploadFileApi(api_client)
    try:
        with open(local_excel_path, "rb") as f:
            upload_request = UploadFileRequest(
                path=remote_excel_path,
                file=f.read()
            )
            upload_api.upload_file(upload_request)
        print(f"Uploaded '{local_excel_path}' to cloud storage as '{remote_excel_path}'.")
    except (ApiException, IOError) as e:
        print(f"Failed to upload file: {e}")
        return

# ----------------------------------------------------------------------
    # 3. Prepare conversion settings to transform Excel → plain text
    # ----------------------------------------------------------------------
    convert_api = ConvertApi(api_client)

file_info = FileInfo()
    file_info.file_path = remote_excel_path          # source file in cloud storage

txt_options = TxtConvertOptions()
    # (optional) you can limit conversion to specific pages:
    # txt_options.page_number = 1
    # txt_options.page_count = 1

convert_settings = ConvertSettings()
    convert_settings.file_info = file_info
    convert_settings.format = "txt"                  # target format
    convert_settings.output_path = "sample.txt"      # result file name in cloud storage
    convert_settings.options = txt_options

# ----------------------------------------------------------------------
    # 4. Execute conversion
    # ----------------------------------------------------------------------
    try:
        conversion_result = convert_api.convert(convert_settings)
        # The result contains a URL to download the converted file
        print(f"Conversion succeeded. Download URL: {conversion_result.url}")
    except ApiException as e:
        print(f"Conversion failed: {e}")

if __name__ == "__main__":
    main()

หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลัก ก่อนนำไปใช้ในโครงการของคุณ โปรดตรวจสอบให้แน่ใจว่าได้อัปเดตเส้นทางไฟล์และค่าการกำหนดค่าต่าง ๆ ให้ตรงกับสภาพแวดล้อมจริงของคุณ ตรวจสอบว่าขึ้นตอนที่จำเป็นทั้งหมดได้ถูกติดตั้งอย่างถูกต้อง และทำการทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากคุณพบปัญหาใด ๆ โปรดอ้างอิงที่ เอกสารอย่างเป็นทางการ หรือ ติดต่อ ทีมสนับสนุน เพื่อขอความช่วยเหลือ.

การแปลง Excel เป็นข้อความโดยใช้ cURL และ REST API

หากคุณต้องการใช้วิธี REST แบบบริสุทธิ์ การแปลงเดียวกันสามารถทำได้ด้วยคำสั่ง cURL

  1. รับโทเค็นการเข้าถึง
curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. อัปโหลดไฟล์ Excel ต้นฉบับ
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @sample.xlsx
  1. เริ่มการแปลงเป็น TXT
curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "sample.xlsx" },
           "format": "txt",
           "outputPath": "sample.txt",
           "options": {}
         }'
  1. ดาวน์โหลดไฟล์ TXT ที่แปลงแล้ว
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.txt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.txt

คำสั่งเหล่านี้แสดงวงจรชีวิตเต็มรูปแบบตั้งแต่การรับรองความถูกต้องจนถึงการดาวน์โหลด สำหรับพารามิเตอร์เพิ่มเติมและการจัดการข้อผิดพลาด โปรดดูที่ อ้างอิง API.

การกำหนดค่าการแปลงสำหรับ Excel

SDK มีตัวเลือกหลายอย่างเพื่อปรับแต่งผลลัพธ์ ด้านล่างเป็นการตั้งค่าที่มีประโยชน์ที่สุดสำหรับการแปลง Excel‑to‑TXT:

  • หมายเลขหน้า - เริ่มการแปลงจากแผ่นหรือหน้าที่ระบุเฉพาะ.
    txt_options.page_number = 1
    
  • จำนวนหน้า - จำกัดจำนวนแผ่น/หน้าในการแปลง.
    txt_options.page_count = 2
    
  • เส้นทางออก - กำหนดชื่อและตำแหน่งของไฟล์ TXT ที่สร้างในที่เก็บข้อมูลบนคลาวด์.
    convert_settings.output_path = "output/sample.txt"
    

ตัวเลือกขั้นสูงอื่น ๆ เช่น encoding หรือ preserveFormatting มีให้ในเอกสารอ้างอิง API; สำรวจเพื่อให้ตรงกับความต้องการที่แน่นอนของคุณ.

สรุปสุดท้าย

การแปลงไฟล์ Excel workbook เป็นข้อความธรรมดาใน Python ตอนนี้เป็นกระบวนการที่ง่ายและทำซ้ำได้ ขอบคุณ GroupDocs.Conversion Cloud SDK for Python. SDK จัดการการตรวจสอบสิทธิ์ การจัดเก็บไฟล์ และการแปลงเบื้องหลัง ทำให้คุณมุ่งเน้นที่ตรรกะธุรกิจได้ อย่าลืมตรวจสอบตัวเลือกการให้สิทธิ์บน pricing page และรับ temporary license สำหรับการประเมินก่อนย้ายไปสู่การผลิต ด้วยโค้ดและตัวอย่าง cURL ที่ให้มา คุณสามารถรวมการแปลง Excel‑to‑TXT เข้าไปในเวิร์กโฟลว์หรือไมโครเซอร์วิสที่ใช้ Python ใด ๆ ได้

คำถามทั่วไป

  • วิธีที่ง่ายที่สุดในการแปลง Excel workbook เป็นข้อความใน Python คืออะไร?
    ใช้ GroupDocs.Conversion Cloud SDK for Python. มันทำหน้าที่เป็นชั้นนามธรรมของการเรียก REST และให้ API แบบ Pythonic ที่สะอาดสำหรับการอัปโหลด, การแปลงและการดาวน์โหลดไฟล์.

  • ฉันสามารถแปลงเฉพาะแผ่นงานหรือหน้าที่กำหนดของไฟล์ Excel ได้หรือไม่?
    ใช่. ตั้งค่า page_number และ page_count บนวัตถุ TxtConvertOptions เพื่อกำหนดเป้าหมายที่แผ่นงานเฉพาะ. ดู API reference สำหรับรายละเอียดเต็ม.

  • ฉันต้องมีบัญชี GroupDocs เพื่อใช้ SDK หรือไม่?
    จำเป็นต้องมีบัญชี GroupDocs Cloud ที่มี client ID และ secret ที่ถูกต้อง คุณสามารถสร้างบัญชีได้ที่พอร์ทัลของ GroupDocs และรับข้อมูลประจำตัวจากแดชบอร์ด.

  • มีขีดจำกัดขนาดไฟล์สำหรับการแปลง Excel เป็น TXT หรือไม่?
    บริการคลาวด์รองรับไฟล์ขนาดสูงสุด 200 MB สำหรับการแปลง ไฟล์ที่ใหญ่กว่า ควรแบ่งหรือประมวลผลเป็นชิ้นส่วนก่อนอัปโหลด.

การอ่านเพิ่มเติม