Penayangan dokumen tersemat seharusnya terasa seperti bagian dari aplikasi, bukan serah ke ekstensi peramban lama atau program desktop yang diinstal secara lokal. Untuk proyek ASP.NET dan .NET berbasis Windows, Doconut menyediakan SDK penampil dokumen yang dapat merender dokumen bisnis di dalam aplikasi web Anda.

Panduan ini menjelaskan arsitektur pengalaman penayangan tanpa plugin tanpa memperlihatkan kode sumber Doconut yang tidak terdokumentasi.

Dokumen yang melewati layanan rendering .NET ke penampil tersemat tanpa plugin

Apa Arti “Tanpa Plugin”

Penampil tanpa plugin tidak meminta pengguna akhir untuk menginstal teknologi seperti ActiveX, Flash, Silverlight, atau ekstensi peramban khusus sebelum membuka dokumen.

Hal itu mengurangi beberapa sumber gesekan:

Pengguna tidak memerlukan izin instalasi lokal.
Tim TI tidak perlu mendistribusikan dan memperbarui plugin sisi klien.
Aplikasi menjaga alur kerja penayangan tetap berada di dalam antarmukanya.
Ketergantungan plugin lama tidak menjadi syarat untuk membuka file.

Tanpa plugin tidak berarti tanpa ketergantungan. Server tetap memerlukan SDK yang tepat, runtime, font, akses penyimpanan, konfigurasi, dan lisensi. Aplikasi juga tetap bertanggung jawab atas autentikasi, otorisasi, retensi, dan pemantauan.

Mengapa Rendering Dokumen di Sisi Server Membantu

Dokumen bisnis lebih kompleks daripada konten web biasa. File Office, gambar CAD, pesan email, dan gambar beresolusi tinggi masing‑masing memerlukan pemrosesan yang sadar format.

Komponen .NET di sisi server dapat menangani pemrosesan tersebut sementara aplikasi web menyajikan pengalaman penayangan yang dihasilkan. Ini menghindari keharusan bagi setiap pengguna untuk menginstal perangkat lunak authoring asli.

Doconut dirancang untuk peran ini. Informasi produk terkini menggambarkan dukungan untuk tipe dokumen termasuk PDF, dokumen Office, gambar CAD, file email, dan gambar. Pastikan format dan fitur yang tepat yang dibutuhkan aplikasi Anda pada halaman Penampil Doconut.

Rencanakan Alur Kerja Penayangan

Permintaan dokumen yang aman biasanya mengikuti langkah‑langkah berikut:

Pengguna memilih dokumen menggunakan pengidentifikasi aplikasi.
ASP.NET mengautentikasi permintaan.
Server memverifikasi akses ke dokumen spesifik tersebut.
Aplikasi menemukan lokasi penyimpanan yang dilindungi.
Dokumen diteruskan ke lapisan penayangan menggunakan metode integrasi yang didukung.
Aplikasi mencatat hasil dan melepaskan sumber daya sementara.

Klien tidak boleh pernah menerima kredensial penyimpanan, jalur server yang tidak terbatas, atau informasi dokumen lebih dari yang diperlukan sesi yang berwenang.

Gunakan Batas Keamanan Standar ASP.NET

Halaman penayangan harus dilindungi seperti sumber daya sensitif lainnya.

Mekanisme .NET standar dapat mencakup:

Middleware autentikasi
Atribut [Authorize]
Kebijakan dan klaim otorisasi
Otorisasi berbasis sumber daya
Injeksi ketergantungan untuk layanan penyimpanan dan penayangan
Logging terstruktur dengan penyaringan data sensitif

Otorisasi harus dievaluasi di server. Menyembunyikan aksi toolbar atau rute di antarmuka pengguna tidak menghentikan klien yang bertekad untuk memintanya secara langsung.

Simpan Akses SDK di Balik Layanan Aplikasi

Hindari menyebarkan pemanggilan penampil khusus di seluruh kontroler dan halaman. Layanan aplikasi khusus dapat:

Menemukan pengidentifikasi dokumen yang berwenang
Membuka Stream yang terkontrol
Menerapkan konfigurasi untuk versi SDK yang terpasang
Melepaskan sumber daya berkas dan stream
Mengonversi kegagalan teknis menjadi kesalahan aplikasi yang aman
Mencatat waktu dan diagnostik yang disanitasi

Batas ini membuat aplikasi lebih mudah diuji dan mengurangi dampak peningkatan SDK di masa mendatang.

Gunakan sumber unduhan dan dokumentasi resmi Doconut untuk instalasi paket dan panduan API spesifik versi.

Bangun Host Penampil yang Berguna

Kontainer penampil yang dimiliki aplikasi harus menyediakan ruang yang cukup untuk dokumen nyata. Hindari kartu sempit dan lebar desktop tetap.

.viewer-workspace {
  display: grid;
  grid-template-rows: auto minmax(0, 1fr);
  width: 100%;
  min-height: 36rem;
  height: calc(100dvh - 4rem);
}

.viewer-host {
  min-width: 0;
  min-height: 0;
  overflow: hidden;
}

Ini adalah CSS standar untuk halaman sekeliling, bukan konfigurasi Doconut. Jangan menargetkan selector internal yang tidak terdokumentasi atau menciptakan opsi SDK.

Halaman juga harus menyediakan:

Status pemuatan yang jelas
Pesan kesalahan yang aman
Judul dokumen yang terlihat
Cara kembali ke alur kerja induk
Kontrol aplikasi yang dapat diakses
Ruang yang cukup untuk spreadsheet lebar dan gambar detail

Validasi Dokumen Sebelum Rendering

Jika pengguna mengunggah berkas, periksa:

Ukuran berkas
Ekstensi dan tanda tangan berkas
Format yang didukung
Persyaratan kata sandi atau enkripsi
Pembatasan khusus bisnis
Nama penyimpanan yang dihasilkan server

Jangan membangun jalur server langsung dari nama berkas asli. Simpan pengidentifikasi aplikasi yang aman dan temukan melalui layanan sisi server yang berotorisasi.

Siapkan Windows Server

Perilaku rendering dapat bergantung pada lingkungan server. Pastikan:

Versi Windows dan .NET yang didukung
Font yang diperlukan
Lokasi penyimpanan sementara dan izin‑izinya
CPU, memori, dan kapasitas disk yang tersedia
Ukuran dokumen maksimum dan sesi bersamaan
Konfigurasi lisensi
Prosedur pembersihan

Uji dokumen pelanggan representatif pada lingkungan yang mencerminkan produksi.

Daftar Periksa Keamanan dan Privasi

Sebelum rilis:

Autentikasi permintaan penayangan bila diperlukan.
Otorisasi pengguna untuk dokumen spesifik.
Simpan jalur penyimpanan dan kredensial di server.
Batasi izin berkas sementara.
Tentukan retensi untuk asli, data sementara, dan ekspor.
Sanitasi kesalahan yang ditampilkan ke pengguna.
Kecualikan isi dokumen dan rahasia dari log.
Terapkan batas unggahan dan konkurensi.
Jaga SDK serta ketergantungan aplikasi tetap terbarui.

Pernyataan kepatuhan harus mencerminkan sistem yang sepenuhnya diterapkan dan proses organisasi Anda, bukan hanya satu komponen UI.

Uji Lebih Dari Jalur Bahagia

Perpustakaan pengujian Anda harus mencakup:

PDF multi‑halaman
Spreadsheet besar
Gambar CAD detail
Presentasi dengan font tidak umum
File email dengan lampiran
Gambar berukuran besar
Berkas rusak dan tidak didukung
Permintaan tidak berwenang
Sesi penayangan bersamaan
Permintaan terputus dan restart aplikasi

Pastikan kegagalan tidak mengungkapkan jalur server, jejak tumpukan, atau URL penyimpanan.

Di Mana Doconut Berperan

Doconut menyediakan kemampuan penayangan dokumen tersemat di dalam aplikasi web .NET. Aplikasi Anda menyediakan keamanan, penyimpanan, alur kerja, tata letak responsif, dan kontrol operasional di sekelilingnya.

Pemisahan ini memungkinkan tim mengganti alur kerja yang bergantung pada plugin lama tanpa berpura‑pura bahwa penanganan dokumen menjadi tanpa usaha atau tanpa tanggung jawab.

Jelajahi SDK penampil dokumen .NET Doconut yang terverifikasi, lalu gunakan halaman unduhan resmi untuk petunjuk yang sesuai dengan versi yang Anda pilih.

Kesimpulan

Pengalaman dokumen tanpa plugin mengurangi gesekan instalasi dan menjaga pengguna tetap berada di dalam aplikasi Anda. Bangun alur dokumen yang diotorisasi server, isolasi akses SDK, sediakan host penampil yang lapang, dan uji berkas nyata di beban mirip produksi.

Untuk aplikasi ASP.NET dan .NET berbasis Windows, Doconut dapat menyediakan lapisan penayangan dokumen sementara tim Anda tetap mengendalikan aplikasi serta siklus hidup dokumen.