Mengekstrak teks mentah dari workbook Excel adalah kebutuhan yang sering muncul saat membangun pipeline data atau menghasilkan laporan sederhana. Jika Anda ingin mengetahui cara mengonversi Excel Workbook ke teks dalam Python, GroupDocs.Conversion Cloud SDK for Python mempermudah proses tersebut. Panduan ini akan memandu Anda melalui pemasangan SDK, mengunggah workbook, mengonfigurasi opsi konversi, dan mengambil hasil TXT dalam format teks biasa. Pada akhir panduan, Anda akan memiliki skrip yang dapat digunakan kembali serta serangkaian perintah cURL untuk otomatisasi berbasis REST.
Sebelum Anda Memulai: Prasyarat dan Instalasi
Sebelum Anda memulai, pastikan Anda memiliki hal berikut:
- Python 3.7 atau yang lebih baru terpasang di mesin Anda.
- Akun GroupDocs Cloud yang aktif (client ID dan client secret).
- Akses jaringan ke endpoint GroupDocs Cloud.
Instal SDK melalui pip:
pip install groupdocs-conversion-cloud
Anda juga dapat mengunduh paket terbaru dari halaman rilis resmi. Setelah instalasi, atur kredensial Anda sebagai variabel lingkungan atau ganti placeholder dalam kode nanti. Dengan SDK siap, Anda siap memulai proses konversi.
Membangun Langkah demi Langkah: Cara Mengonversi Workbook Excel ke Teks di Python
Langkah 1: Konfigurasikan Kredensial
Pertama, buat objek Configuration dan berikan client ID serta secret Anda. Objek ini digunakan oleh semua panggilan API berikutnya.
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
Kelas Configuration didokumentasikan di referensi API.
Langkah 2: Unggah Buku Kerja Excel
Unggah file Excel lokal ke penyimpanan GroupDocs Cloud. Langkah ini opsional jika file Anda sudah berada di cloud.
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 menangani transfer file; lihat dokumentasinya untuk detail lebih lanjut.
Langkah 3: Tentukan Opsi Konversi
Buat objek TxtConvertOptions untuk menentukan parameter opsional apa pun seperti rentang halaman. Kemudian buat objek ConvertSettings yang menggabungkan semuanya.
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
Kelas TxtConvertOptions memungkinkan Anda menyesuaikan konversi secara detail; lihat dokumentasi resmi untuk semua bidang yang tersedia.
Langkah 4: Jalankan Konversi
Panggil metode convert dari ConvertApi dengan pengaturan yang telah disiapkan. Respons berisi URL untuk mengunduh file yang telah dikonversi.
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}")
Jika panggilan berhasil, Anda akan menerima tautan unduhan langsung untuk file TXT.
Langkah 5: Ambil Hasil
Gunakan URL dari langkah sebelumnya untuk mengunduh file teks biasa ke lingkungan lokal Anda, atau memprosesnya lebih lanjut dalam aplikasi Anda.
Tip: Anda dapat mengotomatiskan pengunduhan dengan panggilan sederhana
requests.get(), menangani otentikasi melalui token akses yang sama yang digunakan untuk permintaan konversi.
Dengan langkah‑langkah ini, Anda sekarang memiliki alur kerja lengkap untuk cara mengonversi Excel Workbook ke teks dalam Python menggunakan pustaka GroupDocs.
Konversi Teks Workbook Excel - Contoh Kode Lengkap
Contoh berikut menunjukkan implementasi lengkap dari awal hingga akhir.
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()
Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan lakukan pengujian secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.
Konversi Excel ke Teks Menggunakan cURL dan REST API
Jika Anda lebih memilih pendekatan REST murni, konversi yang sama dapat dilakukan dengan perintah cURL.
- Dapatkan token akses
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"
- Unggah file Excel sumber
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
- Mulai konversi ke 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": {}
}'
- Unduh file TXT yang telah dikonversi
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.txt" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o sample.txt
Perintah‑perintah ini menggambarkan siklus hidup lengkap mulai dari otentikasi hingga pengunduhan. Untuk parameter tambahan dan penanganan kesalahan, lihat referensi API.
Mengonfigurasi Pengaturan Konversi untuk Excel
SDK menawarkan beberapa opsi untuk menyesuaikan output. Di bawah ini adalah pengaturan paling berguna untuk konversi Excel‑ke‑TXT:
- Page Number - Mulai konversi dari lembar atau halaman tertentu.
txt_options.page_number = 1
- Page Count - Batasi jumlah lembar/halaman yang akan dikonversi.
txt_options.page_count = 2
- Output Path - Tentukan nama dan lokasi file TXT hasil di penyimpanan cloud.
convert_settings.output_path = "output/sample.txt"
Opsi lanjutan lainnya seperti encoding atau preserveFormatting tersedia dalam referensi API; jelajahi mereka untuk menyesuaikan dengan kebutuhan spesifik Anda.
Pemikiran Akhir
Mengonversi workbook Excel ke teks biasa di Python kini menjadi proses yang sederhana dan dapat diulang berkat GroupDocs.Conversion Cloud SDK for Python. SDK menangani otentikasi, penyimpanan file, dan konversi di belakang layar, memungkinkan Anda fokus pada logika bisnis. Ingatlah untuk meninjau opsi lisensi pada halaman harga dan dapatkan lisensi sementara untuk evaluasi sebelum beralih ke produksi. Dengan contoh kode dan cURL yang disediakan, Anda dapat mengintegrasikan konversi Excel‑to‑TXT ke dalam alur kerja atau mikroservis berbasis Python mana pun.
Pertanyaan Umum
Apa cara termudah untuk mengonversi buku kerja Excel ke teks di Python?
Gunakan GroupDocs.Conversion Cloud SDK for Python. SDK ini mengabstraksi panggilan REST dan menyediakan API Pythonic yang bersih untuk mengunggah, mengonversi, dan mengunduh file.Apakah saya dapat mengonversi hanya lembar atau halaman tertentu dari sebuah workbook Excel?
Ya. Aturpage_numberdanpage_countpada objekTxtConvertOptionsuntuk menargetkan lembar tertentu. Lihat referensi API untuk detail lengkap.Apakah saya memerlukan akun GroupDocs untuk menggunakan SDK?
Akun GroupDocs Cloud yang valid dengan client ID dan secret diperlukan. Anda dapat membuat akun di portal GroupDocs dan mendapatkan kredensial dari dasbor.Apakah ada batas ukuran file untuk konversi Excel ke TXT?
Layanan cloud mendukung file hingga 200 MB untuk konversi. File yang lebih besar harus dibagi atau diproses dalam potongan sebelum diunggah.
