Cách Chuyển Đổi Sổ Làm Việc Excel Sang Văn Bản trong Python

Việc trích xuất văn bản thô từ các sổ làm việc Excel là một nhu cầu thường gặp khi xây dựng các pipeline dữ liệu hoặc tạo các báo cáo đơn giản. Nếu bạn muốn biết cách chuyển đổi Excel Workbook sang văn bản trong Python, GroupDocs.Conversion Cloud SDK for Python giúp thực hiện một cách dễ dàng. Hướng dẫn này sẽ đưa bạn qua các bước cài đặt SDK, tải lên một sổ làm việc, cấu hình các tùy chọn chuyển đổi và lấy kết quả TXT thuần. Khi kết thúc, bạn sẽ có một script có thể tái sử dụng và một tập hợp các lệnh cURL cho tự động hoá dựa trên REST.

Trước khi bắt đầu: Các yêu cầu và cài đặt

Trước khi bắt đầu, hãy đảm bảo rằng bạn có những thứ sau:

Python 3.7 hoặc mới hơn được cài đặt trên máy của bạn.
Một tài khoản GroupDocs Cloud đang hoạt động (client ID và client secret).
Truy cập mạng tới các endpoint của GroupDocs Cloud.

Cài đặt SDK bằng pip:

pip install groupdocs-conversion-cloud

Bạn cũng có thể tải xuống gói mới nhất từ trang phát hành chính thức. Sau khi cài đặt, hãy đặt thông tin xác thực của bạn dưới dạng biến môi trường hoặc thay thế các placeholder trong mã sau này. Khi SDK đã sẵn sàng, bạn đã chuẩn bị để bắt đầu quá trình chuyển đổi.

Xây dựng từng bước: Cách chuyển đổi sổ làm việc Excel sang văn bản trong Python

Bước 1: Cấu hình Thông tin xác thực

Đầu tiên, tạo một đối tượng Configuration và cung cấp ID khách hàng và bí mật của bạn. Đối tượng này được sử dụng cho tất cả các cuộc gọi API tiếp theo.

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

Lớp Configuration được tài liệu trong Tham chiếu API.

Bước 2: Tải lên sổ làm việc Excel

Tải lên tệp Excel cục bộ lên bộ nhớ lưu trữ của GroupDocs Cloud. Bước này là tùy chọn nếu tệp của bạn đã có trong đám mây.

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 xử lý việc truyền tệp; xem tài liệu của nó để biết thêm chi tiết.

Bước 3: Xác định tùy chọn chuyển đổi

Tạo một đối tượng TxtConvertOptions để chỉ định bất kỳ tham số tùy chọn nào như phạm vi trang. Sau đó, xây dựng đối tượng ConvertSettings kết nối mọi thứ lại với nhau.

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

Lớp TxtConvertOptions cho phép bạn tinh chỉnh quá trình chuyển đổi; tham khảo tài liệu chính thức để biết tất cả các trường có sẵn.

Bước 4: Thực hiện chuyển đổi

Gọi phương thức convert của ConvertApi với các cài đặt đã chuẩn bị. Phản hồi chứa một URL để tải xuống tệp đã chuyển đổi.

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}")

Nếu cuộc gọi thành công, bạn sẽ nhận được một liên kết tải xuống trực tiếp cho tệp TXT.

Bước 5: Lấy kết quả

Sử dụng URL từ bước trước để tải tệp văn bản thuần về môi trường cục bộ của bạn, hoặc xử lý nó tiếp tục trong ứng dụng của bạn.

Mẹo: Bạn có thể tự động tải xuống bằng một lời gọi requests.get() đơn giản, xử lý xác thực qua cùng một token truy cập được sử dụng cho yêu cầu chuyển đổi.

Với các bước này, bạn đã có một quy trình hoàn chỉnh cách chuyển đổi sổ làm việc Excel sang văn bản trong Python bằng thư viện GroupDocs.

Chuyển Đổi Văn Bản Sổ Làm Việc Excel - Ví Dụ Mã Đầy Đủ

Ví dụ sau đây trình bày việc triển khai đầy đủ từ đầu đến cuối.

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()

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy đảm bảo cập nhật mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Chuyển đổi Excel sang Văn bản bằng cURL và REST API

Nếu bạn muốn sử dụng cách tiếp cận thuần REST, cùng một quá trình chuyển đổi có thể được thực hiện bằng các lệnh cURL.

Nhận token truy cập

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"

Tải lên tệp Excel nguồn

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

Bắt đầu chuyển đổi sang 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": {}
         }'

Tải xuống tệp TXT đã chuyển đổi

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.txt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.txt

Các lệnh này minh họa vòng đời đầy đủ từ xác thực đến tải xuống. Đối với các tham số bổ sung và xử lý lỗi, hãy tham khảo tài liệu API.

Cấu hình cài đặt chuyển đổi cho Excel

SDK cung cấp một số tùy chọn để tùy chỉnh đầu ra. Dưới đây là các cài đặt hữu ích nhất cho việc chuyển đổi Excel‑to‑TXT:

Số trang - Bắt đầu chuyển đổi từ một sheet hoặc trang cụ thể.
```
txt_options.page_number = 1
```
Số lượng trang - Giới hạn số lượng sheet/trang cần chuyển đổi.
```
txt_options.page_count = 2
```
Đường dẫn đầu ra - Xác định tên và vị trí của tệp TXT kết quả trong lưu trữ đám mây.
```
convert_settings.output_path = "output/sample.txt"
```

Các tùy chọn nâng cao khác như encoding hoặc preserveFormatting có sẵn trong tài liệu tham chiếu API; hãy khám phá chúng để đáp ứng đúng yêu cầu của bạn.

Kết luận

Việc chuyển đổi một workbook Excel sang văn bản thuần trong Python hiện đã trở nên đơn giản và có thể lặp lại nhờ vào GroupDocs.Conversion Cloud SDK for Python. SDK xử lý xác thực, lưu trữ tệp và chuyển đổi phía sau, cho phép bạn tập trung vào logic nghiệp vụ. Hãy nhớ xem xét các tùy chọn cấp phép trên trang giá và nhận một giấy phép tạm thời để đánh giá trước khi chuyển sang môi trường sản xuất. Với mã và các ví dụ cURL được cung cấp, bạn có thể tích hợp chuyển đổi Excel‑to‑TXT vào bất kỳ quy trình làm việc hoặc microservice nào dựa trên Python.

Câu hỏi thường gặp

Cách dễ nhất để chuyển đổi một workbook Excel sang văn bản trong Python là gì?
Sử dụng GroupDocs.Conversion Cloud SDK for Python. Nó trừu tượng hóa các cuộc gọi REST và cung cấp một API Pythonic sạch sẽ để tải lên, chuyển đổi và tải xuống các tệp.
Có thể chuyển đổi chỉ các sheet hoặc trang cụ thể của một workbook Excel không?
Có. Đặt page_number và page_count trên đối tượng TxtConvertOptions để nhắm mục tiêu các sheet cụ thể. Xem API reference để biết chi tiết đầy đủ.
Tôi có cần tài khoản GroupDocs để sử dụng SDK không?
Cần một tài khoản GroupDocs Cloud hợp lệ có client ID và secret. Bạn có thể tạo tài khoản trên cổng GroupDocs và lấy thông tin xác thực từ bảng điều khiển.
Có giới hạn kích thước tệp cho việc chuyển đổi Excel sang TXT không?
Dịch vụ đám mây hỗ trợ các tệp lên tới 200 MB cho việc chuyển đổi. Các tệp lớn hơn nên được chia nhỏ hoặc xử lý theo từng phần trước khi tải lên.

Trước khi bắt đầu: Các yêu cầu và cài đặt#

Xây dựng từng bước: Cách chuyển đổi sổ làm việc Excel sang văn bản trong Python#

Bước 1: Cấu hình Thông tin xác thực#

Bước 2: Tải lên sổ làm việc Excel#

Bước 3: Xác định tùy chọn chuyển đổi#

Bước 4: Thực hiện chuyển đổi#

Bước 5: Lấy kết quả#

Chuyển Đổi Văn Bản Sổ Làm Việc Excel - Ví Dụ Mã Đầy Đủ#

Chuyển đổi Excel sang Văn bản bằng cURL và REST API#

Cấu hình cài đặt chuyển đổi cho Excel#

Kết luận#

Câu hỏi thường gặp#

Đọc thêm#