Mengintegrasikan ke dalam aplikasi web ASP.NET Core memungkinkan penyuntingan dokumen yang mulus langsung di portal web Anda. GroupDocs.Editor Cloud SDK for .NET menyediakan API yang kuat yang memungkinkan Anda memuat, menyunting, dan menyimpan file DOCX di server. Panduan ini memandu Anda melalui pengaturan yang diperlukan, menampilkan kode langkah‑demi‑langkah, dan menyediakan contoh lengkap yang dapat Anda jalankan dalam hitungan menit. Pada akhir panduan, Anda akan dapat menambahkan penyuntingan dokumen ke aplikasi ASP.NET Core dengan percaya diri.

Prasyarat dan Penyiapan

Sebelum Anda memulai, pastikan Anda memiliki hal berikut:

  • .NET 6.0 SDK atau yang lebih baru terpasang
  • Sebuah IDE seperti Visual Studio 2022 atau VS Code
  • Akun GroupDocs Cloud untuk memperoleh Client Id dan Client Secret
  • Akses ke mesin pengembangan Windows, Linux, atau macOS

Mengintegrasikan ke dalam aplikasi web ASP.NET Core juga memerlukan koneksi jaringan yang handal ke endpoint GroupDocs Cloud, karena semua pemrosesan dokumen terjadi secara remote. Rencanakan lingkungan penyebaran Anda dengan tepat.

Instal SDK melalui NuGet:

dotnet add package GroupDocs.editor-Cloud

Unduh paket terbaru dari halaman rilis resmi: GroupDocs.Editor Cloud SDK for .NET Unduh.

Buat objek konfigurasi dengan kredensial Anda (kutipan dari contoh lengkap):

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

Dengan paket terinstal dan kredensial siap, Anda dapat melanjutkan ke implementasi. Bagian‑bagian berikut menjelaskan setiap potongan kode secara detail, sehingga Anda memahami bagaimana perpustakaan tersebut cocok dengan arsitektur keseluruhan aplikasi web ASP.NET Core.

Panduan Langkah demi Langkah untuk Mengintegrasikan ke dalam Aplikasi Web ASP.NET Core

Bagian ini memecah proses integrasi ke dalam aplikasi web ASP.NET Core menjadi langkah‑langkah terpisah yang dapat dikelola. Setiap langkah menyertakan potongan kode singkat yang diambil langsung dari implementasi referensi.

Langkah 1: Konfigurasikan Kredensial API

Pertama, buat objek Configuration dengan detail klien Anda dan buat klien EditorApi.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

The EditorApi class is documented in the referensi API. Menginisialisasi klien sekali per permintaan sudah cukup untuk kebanyakan skenario; Anda juga dapat mendaftarkannya sebagai singleton di kontainer injeksi ketergantungan ASP.NET Core untuk kinerja yang lebih baik.

Langkah 2: Tentukan Opsi Muat

Tentukan file sumber dan lokasi output yang diinginkan menggunakan LoadOptions. Objek ini memberi tahu layanan dokumen mana yang akan dibuka dan di mana menyimpan HTML yang dirender.

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

LoadOptions, FileInfo, dan RenderOptions memungkinkan Anda mengontrol bagaimana dokumen dirender untuk penyuntingan. Misalnya, Anda dapat mengatur RenderOptions untuk menyertakan gambar, mempertahankan gaya asli, atau membatasi jumlah halaman yang dirender.

Langkah 3: Panggil LoadDocument

Panggil API untuk memuat dan mengonversi dokumen. Panggilan ini bersifat sinkron dalam contoh ini, tetapi Anda juga dapat menggunakan versi asinkron jika aksi pengontrol Anda bersifat async.

var loadResult = editorApi.LoadDocument(loadOptions);

Metode LoadDocument mengembalikan objek hasil yang berisi URL ke HTML yang dirender dan metadata lainnya. Anda dapat menyimpan loadResult untuk diambil nanti atau mengirim HTML langsung ke front‑end.

Langkah 4: Proses Hasil Muat

Setelah memuat, Anda dapat menyajikan HTML ke front‑end atau menyimpannya untuk penggunaan nanti. Langkah ini menyelesaikan alur kerja mengintegrasikan editor dokumen ke dalam aplikasi web ASP.NET Core dan menyiapkan dokumen untuk interaksi pengguna.

Dalam skenario dunia nyata, Anda biasanya akan mengembalikan konten HTML dari aksi controller:

return Content(loadResult.HtmlContent, "text/html");

Anda juga mungkin ingin menerapkan caching untuk menghindari pemuatan‑ulang dokumen yang sama secara berulang, yang dapat meningkatkan waktu respons ketika mengintegrasikan ke dalam aplikasi web ASP.NET Core pada skala besar.

Mengintegrasikan Document Editor ke dalam Aplikasi Web ASP.NET Core - Contoh Kode Lengkap

Kode berikut menunjukkan seluruh proses mulai dari konfigurasi hingga memuat file DOCX.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

var loadResult = editorApi.LoadDocument(loadOptions);

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 uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Menggunakan cURL untuk Integrasi Pengeditan Dokumen ASP.NET Core

Jika Anda lebih suka pendekatan REST langsung, operasi yang sama dapat dilakukan dengan perintah cURL. Metode ini berguna untuk prototipe cepat atau ketika Anda perlu mengintegrasikan editor ke dalam layanan yang tidak ditulis dalam .NET.

1. Autentikasi dan Dapatkan Token Akses

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Respons berisi access_token yang digunakan dalam panggilan berikutnya.

2. Unggah File Sumber

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/storage/upload?path=/input.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.docx"

3. Muat Dokumen untuk Penyuntingan

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.docx" },
           "renderOptions": { "outputPath": "output.html" }
         }'

4. Unduh HTML yang Dirender

curl -X GET "https://api.groupdocs.cloud/v2.0/editor/storage/download?path=/output.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.html

Perintah-perintah ini menggambarkan cara menambahkan penyuntingan dokumen ke aplikasi ASP.NET Core tanpa menulis kode C#, berguna untuk pengujian cepat atau integrasi dengan layanan lain. Untuk detail lebih lanjut, lihat dokumentasi API resmi.

Dengan menguasai baik perpustakaan .NET maupun REST API mentah, Anda memperoleh fleksibilitas saat mengintegrasikan ke dalam aplikasi web ASP.NET Core, memungkinkan Anda memilih pendekatan yang paling sesuai dengan arsitektur Anda.

FAQ

Bacaan Lebih Lanjut