Sebagai pengembang Python, Anda mungkin perlu mengedit dokumen Word atau Excel secara terprogram. Anda dapat memperbarui dokumen tersebut tanpa menginstal aplikasi eksternal apa pun. Artikel ini akan berfokus pada cara mengedit dokumen Word atau Excel menggunakan REST API.

Topik-topik berikut akan dibahas dalam artikel ini:

Editor Dokumen REST API dan Python SDK

Keluarga Produk Cloud GroupDocs.Editor

Untuk mengedit dokumen Word atau lembar Excel, saya akan menggunakan API Python SDK of GroupDocs.Editor Cloud. Ini memungkinkan Anda untuk secara terprogram mengedit dokumen pengolah kata, lembar Excel, atau dokumen dari format lain yang didukung. Ini juga menyediakan .NET, Java, PHP, Ruby, Android, dan Node.js SDK sebagai anggota keluarga editor dokumen untuk Cloud API.

Anda dapat menginstal GroupDocs.Editor-Cloud ke proyek Python Anda menggunakan perintah berikut di konsol:

pip install groupdocs_editor_cloud

Dapatkan ID Klien dan Rahasia Klien Anda dari dashboard sebelum Anda mulai mengikuti langkah-langkah dan contoh kode yang tersedia. Tambahkan ID dan rahasia Anda dalam kode seperti yang ditunjukkan di bawah ini:

client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"

configuration = groupdocs_editor_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"

Edit Dokumen Word menggunakan REST API

Anda dapat mengedit dokumen Word dengan mengikuti langkah-langkah sederhana yang disebutkan di bawah ini:

Unggah Dokumen

Pertama-tama, unggah dokumen Word ke Cloud menggunakan contoh kode di bawah ini:

storage_api = groupdocs_editor_cloud.StorageApi.from_config(config_info)
file_api = groupdocs_editor_cloud.FileApi.from_config(config_info)

# mengunggah file sampel
files = glob.glob("C:\\Files\\sample_word_document.docx", recursive=False)
destination_file = files[0].replace("C:\\Files\\", "", 1)
file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(destination_file, files[0]))

Hasilnya, file Word akan diunggah ke Cloud Storage dan akan tersedia di bagian file dasbor Anda.

Edit Dokumen Word dengan Python

Silakan ikuti langkah-langkah yang disebutkan di bawah ini untuk mengedit dokumen Word secara terprogram.

  • Buat File API dan Edit API instance
  • Berikan Opsi Beban Pemrosesan Kata
  • Muat file dengan metode Load dari Edit API
  • Unduh dokumen HTML menggunakan metode Download File dari File API
  • Mengedit Dokumen HTML
  • Unggah kembali HTML menggunakan metode Unggah File API File
  • Sediakan WordProcessingSaveOptions untuk Menyimpan di DOCX
  • Simpan kembali HTML ke DOCX menggunakan metode Save dari Edit API

Cuplikan kode berikut menunjukkan cara memperbarui dokumen Word menggunakan REST API.

# Buat instance API yang diperlukan
edit_api = groupdocs_editor_cloud.EditApi.from_config(configurations)
file_api = groupdocs_editor_cloud.FileApi.from_config(configuration)

# Dokumen sudah diunggah ke penyimpanan.
# Muat ke status yang dapat diedit
file_info = groupdocs_editor_cloud.FileInfo("sample_word_document.docx", None, None, None)
load_options = groupdocs_editor_cloud.WordProcessingLoadOptions()
load_options.file_info = file_info
load_options.output_path = "output"
load_result = edit_api.load(groupdocs_editor_cloud.LoadRequest(load_options))

# Unduh dokumen html
html_file = file_api.download_file(groupdocs_editor_cloud.DownloadFileRequest(load_result.html_path))
html = ""
with open(html_file, 'r') as file:
    html = file.read()

# Mengedit sesuatu...
html = html.replace("Sample test text", "Hello world")

# Unggah html kembali ke penyimpanan
with open(html_file, 'w') as file:
    file.write(html)

file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(load_result.html_path, html_file))

# Simpan html kembali ke docx
save_options = groupdocs_editor_cloud.WordProcessingSaveOptions()
save_options.file_info = file_info
save_options.output_path = "output/edited.docx"
save_options.html_path = load_result.html_path
save_options.resources_path = load_result.resources_path
save_result = edit_api.save(groupdocs_editor_cloud.SaveRequest(save_options))

# Selesai
print("Document edited: " + save_result.path)

Unduh File yang Diperbarui

Contoh kode di atas akan menyimpan file Word yang diedit di cloud. Anda dapat mengunduhnya menggunakan contoh kode berikut:

request = groupdocs_editor_cloud.DownloadFileRequest("output\\edited.docx", my_storage)
response = file_api.download_file(request)

# Pindahkan file yang diunduh ke direktori kerja Anda
shutil.move(response, "C:\\Files\\")

Edit Lembar Excel menggunakan REST API

Silakan ikuti langkah-langkah yang disebutkan di bawah ini untuk mengedit lembar Excel secara terprogram.

  • Buat File API dan Edit API instance
  • Sediakan SpreadsheetLoadOptions
  • Muat file dengan metode Load dari Edit API
  • Unduh dokumen HTML menggunakan metode Download File dari File API
  • Mengedit Dokumen HTML
  • Unggah kembali HTML menggunakan metode Unggah File API File
  • Sediakan SpreadsheetSaveOptions untuk Menyimpan di XLSX
  • Simpan kembali HTML ke XLSX menggunakan metode Save Edit API

Contoh kode sederhana yang diberikan di bawah ini menunjukkan cara memperbarui lembar Excel menggunakan REST API. Silakan ikuti langkah-langkah yang disebutkan sebelumnya untuk mengunggah dan mengunduh file.

# Buat instance API yang diperlukan
edit_api = groupdocs_editor_cloud.EditApi.from_config(configurations)
file_api = groupdocs_editor_cloud.FileApi.from_config(configurations)

# Dokumen sudah diunggah ke penyimpanan.
# Muat ke status yang dapat diedit
file_info = groupdocs_editor_cloud.FileInfo("sample_four_sheets.xlsx")
load_options = groupdocs_editor_cloud.SpreadsheetLoadOptions()
load_options.file_info = file_info
load_options.output_path = "output"
load_options.worksheet_index = 0
load_result = edit_api.load(groupdocs_editor_cloud.LoadRequest(load_options))

# Unduh dokumen html
html_file = file_api.download_file(groupdocs_editor_cloud.DownloadFileRequest(load_result.html_path))
html = ""
with open(html_file, 'r') as file:
    html = file.read()

# Mengedit sesuatu...
html = html.replace("This is sample sheet", "This is sample sheep")

# Unggah html kembali ke penyimpanan
with open(html_file, 'w') as file:
    file.write(html)

file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(load_result.html_path, html_file))

# Simpan html kembali ke xlsx
save_options = groupdocs_editor_cloud.SpreadsheetSaveOptions()
save_options.file_info = file_info
save_options.output_path = "output/edited.xlsx"
save_options.html_path = load_result.html_path
save_options.resources_path = load_result.resources_path
save_result = edit_api.save(groupdocs_editor_cloud.SaveRequest(save_options))

# Selesai
print("Excel sheet edited: " + save_result.path)

Kesimpulan

Pada artikel ini, Anda telah mempelajari cara mengedit dokumen Word atau lembar Excel di cloud dengan Document Editor REST API menggunakan Python. Anda juga mempelajari cara mengunggah file di cloud secara terprogram dan kemudian mengunduh file yang diperbarui dari cloud. Anda dapat mempelajari lebih lanjut tentang GroupDocs.Editor Cloud API menggunakan dokumentasi. Kami juga menyediakan bagian Referensi API yang memungkinkan Anda memvisualisasikan dan berinteraksi dengan API kami secara langsung melalui browser. Jika ada ambiguitas, jangan ragu untuk menghubungi kami di forum.

Lihat juga