Anda akan memiliki penampil dokumen self‑hosted, super cepat yang berjalan di dalam aplikasi .NET Anda
Pada akhir panduan ini Anda dapat membuka PDF, file Office, gambar CAD dan puluhan format lainnya langsung di browser, dengan waktu muat sub‑detik, tanpa panggilan SaaS eksternal, dan kontrol penuh atas keamanan.
Prasyarat
| Apa yang Anda butuhkan | Mengapa penting |
|---|---|
| .NET 6 atau lebih baru (SDK menargetkan .NET 6+) | Menjamin kompatibilitas dengan SDK Online Document Viewer |
| Server Windows atau Linux tempat Anda dapat menjalankan aplikasi (on‑premise atau cloud pribadi) | Self‑hosting memerlukan penampil berada di dalam infrastruktur Anda sendiri |
| Akses ke feed NuGet Online Document Viewer (https://doconut.com) | SDK didistribusikan sebagai paket NuGet |
| Pengetahuan dasar tentang ASP.NET Core dan JavaScript front‑end | Anda akan mengekspos endpoint yang mengembalikan URL bertanda tangan dan kemudian meluncurkan penampil dari browser |
| Lokasi penyimpanan untuk file sumber (sistem file, blob storage, dll.) | Penampil merender file dari jalur lokal atau jaringan; sumber harus dapat dijangkau oleh proses server |
Kehilangan salah satu item ini akan menyebabkan proses build terhenti sebelum baris kode pertama dijalankan.
Instal SDK Online Document Viewer
Buka solusi Anda di Visual Studio atau IDE pilihan Anda dan tambahkan SDK resmi melalui manajer NuGet:
dotnet add package Doconut.NET8
Paket ini berisi mesin rendering, konverter format, dan lapisan HTTP tipis yang menyajikan halaman yang dihasilkan. Karena SDK dikompilasi ke dalam aplikasi Anda, tidak ada layanan eksternal yang dihubungi saat runtime.
Setelah paket dipulihkan, daftarkan layanan SDK di Program.cs (atau Startup.cs untuk template lama). Pendaftaran ini menyuntikkan pipeline rendering ke dalam kontainer DI ASP.NET Core, membuatnya tersedia untuk controller Anda.
Konfigurasikan pipeline rendering untuk format yang diperlukan
Penampil mendukung lebih dari 50 format secara default, termasuk:
- PDF, DOC, DOCX, ODT, RTF
- XLS, XLSX, CSV, ODS
- PPT, PPTX, ODP
- DWG, DXF, DGN (CAD)
- PSD, SVG, TIFF, WEBP, ICO
- EML, MSG, EPUB, MOBI, MPP, VSD
Saat permintaan tiba, SDK menentukan jenis file dan memilih konverter yang sesuai. Untuk kinerja terbaik, aktifkan lapisan caching bawaan yang menyimpan halaman yang dirender di memori selama permintaan; inilah yang memberikan pengalaman “Super Cepat – Rendering dokumen instan dengan kinerja optimal dan pemuatan sub‑detik”.
Di controller Anda, panggil metode rendering SDK (misalnya RenderAsync) dan berikan jalur absolut file sumber. Metode ini mengembalikan fragmen HTML yang berisi penampil berbasis kanvas. Karena rendering terjadi di server, klien hanya menerima markup siap‑tampil, yang menghilangkan pemrosesan berat di sisi klien.
Amankan penampil dengan URL berbasis token dan pembatasan opsional
Kedaulatan data dan kepatuhan GDPR adalah kekhawatiran umum untuk penyebaran on‑premise. SDK terintegrasi dengan sistem otentikasi ASP.NET Core, memungkinkan Anda menghasilkan token bertanda tangan yang memberikan akses satu kali ke dokumen tertentu.
Alur tipikal:
- Front‑end meminta token pratinjau dari API Anda, dengan memberikan pengidentifikasi dokumen.
- API Anda memvalidasi izin pengguna, membuat token bergaya JWT yang mengkodekan jalur file dan stempel waktu kedaluwarsa, lalu mengembalikan token tersebut.
- Front‑end menambahkan token ke URL penampil (misalnya,
/viewer?token=…). SDK memvalidasi token pada setiap permintaan dan menolak token yang diubah atau kedaluwarsa.
Jika Anda perlu mencegah pengguna mengunduh atau mencetak dokumen, konfigurasikan opsi rendering yang disediakan SDK untuk menonaktifkan tindakan tersebut. Lapisan JavaScript penampil kemudian akan menyembunyikan tombol unduh, menonaktifkan pintasan cetak, dan memblokir menu konteks klik kanan.
Verifikasi bahwa semuanya berfungsi
- Buka halaman yang menampung penampil.
- Dokumen harus muncul dalam satu detik, dengan scrollbar, kontrol zoom, dan kotak pencarian.
- Jika Anda mengonfigurasi penampil untuk menonaktifkan unduhan, tombol “Download” harus disembunyikan.
- Klik kanan pada dokumen tidak boleh membuka menu konteks browser ketika pembatasan tersebut diaktifkan.
- Setelah token kedaluwarsa (default 5 menit), menyegarkan halaman harus mengembalikan error “401 Unauthorized”, mengonfirmasi bahwa validasi token aktif.
Jika salah satu pemeriksaan ini gagal, tinjau kembali langkah yang bersangkutan: pendaftaran SDK yang hilang, pembuatan token yang salah, atau flag keamanan yang terlewat.