Mengintegrasikan SDK Penampil Dokumen dengan Penyimpanan Cloud dan Platform Kolaborasi

Integrasi SDK penampil dokumen dengan penyimpanan cloud dan platform kolaborasi memungkinkan Anda memberikan pengalaman dokumen yang mulus, aman, dan dapat dicari langsung dari aplikasi .NET Anda. Dengan Doconut—penampil dokumen universal untuk back‑end .NET—Anda dapat merender PDF, file Office, gambar CAD, dan gambar secara native, menambahkan pencarian berbasis OCR, mengaktifkan anotasi waktu nyata, dan mengontrol pencetakan, semuanya sambil menjaga data tetap berada di cloud pilihan Anda atau lingkungan on‑premise. Panduan ini menunjukkan kepada pengembang senior dan arsitek perangkat lunak cara menghubungkan Doconut ke Azure Blob, Amazon S3, atau Google Cloud Storage, serta cara mengekspos penampil melalui portal kolaboratif seperti Microsoft Teams, SharePoint, atau ruang kerja berbasis React khusus.

Mengapa Penampilan Dokumen Cloud‑Native Penting untuk Aplikasi .NET Modern

Konsistensi lintas‑platform dengan satu inti .NET

Perusahaan beralih dari alat dokumen yang hanya berbasis desktop dan mengadopsi pengalaman web‑first yang berjalan di Windows. Mesin rendering sisi‑server Doconut berjalan pada .NET 6 dan versi selanjutnya, memastikan output yang pixel‑perfect sama terlepas dari sistem operasi yang mendasarinya. Karena penampil bekerja dengan aliran (streams), Anda dapat mengambil file dari bucket cloud mana pun, memberikannya langsung ke komponen penampil Doconut, dan mengembalikan halaman yang dirender atau thumbnail ke klien tanpa pernah menulis file ke disk.

Mengurangi Latensi dan Bandwidth

Ketika sebuah dokumen berada di Azure Blob Storage, mengunduh seluruh file ke klien hanya untuk melihat halaman pertama menimbulkan latensi yang tidak perlu. Doconut mendukung pembuatan thumbnail sesuai permintaan, memungkinkan Anda meminta pratinjau resolusi rendah terlebih dahulu dan mengambil render halaman penuh hanya ketika pengguna menggulir. Pola ini sangat berguna untuk gambar CAD besar (DWG, DXF) yang dapat berukuran ratusan megabyte.

Pemrosesan Berbasis Keamanan Utama

Semua proses berat tetap berada di server. Dengan menggunakan kemampuan server‑side processing Doconut, Anda menjaga PDF rahasia, kontrak hukum, atau rekam medis tetap berada di dalam VNet pribadi Anda atau di belakang firewall perusahaan. Tidak ada SaaS pihak ketiga yang dipanggil, dan penampil tidak pernah mengalirkan byte mentah ke mesin sisi‑browser—hanya ubin gambar atau potongan HTML yang Anda hasilkan di belakang layar.

Menghubungkan Doconut ke Layanan Penyimpanan Cloud Populer

Pendekatan Integrasi Umum

Dapatkan aliran dokumen – Gunakan SDK penyedia cloud pilihan Anda (Azure Blob, Amazon S3, Google Cloud Storage) untuk mengunduh file ke dalam objek Stream.
Berikan aliran ke Doconut – Penampil Doconut menerima aliran bersama dengan opsi rendering opsional. Ini menghilangkan kebutuhan file sementara di server web.
Hasilkan token penampil – Doconut mengembalikan token yang secara unik mengidentifikasi dokumen yang dibuka untuk sesi saat ini. Token dapat dikembalikan ke front‑end sebagai JSON dan digunakan untuk permintaan render halaman atau anotasi selanjutnya.
Render halaman sesuai permintaan – Front‑end memanggil endpoint Doconut dengan token dan nomor halaman yang diinginkan; Doconut mengalirkan kembali gambar atau fragmen HTML.

Karena alur kerja hanya bergantung pada aliran, mengganti kode Azure dengan Amazon S3 atau Google Cloud Storage hanya memerlukan perubahan pada panggilan cloud‑SDK yang membuat aliran; sisanya dari pipeline Doconut tetap identik.

Menangani Penyimpanan Multi‑Tenant

Di DMS SaaS, setiap tenant mungkin memiliki bucket atau prefiks terpisah. Karena Doconut bekerja dengan aliran, Anda dapat menentukan bucket yang tepat pada waktu runtime, membuka dokumen, dan menjaga token tetap terikat pada klaim pengguna saat ini. Caching internal Doconut (IDistributedCache) dapat dikonfigurasi untuk menggunakan Redis atau Azure Cache for Redis, memastikan permintaan berulang untuk halaman yang sama menggunakan memori alih‑alih merender ulang.

Mengaktifkan Anotasi Waktu Nyata dan OCR dalam Alur Kerja Kolaboratif

Plugin Anotasi: Mengubah Penampil Statis menjadi Pusat Review

Doconut dilengkapi dengan Annotation Plugin yang memungkinkan pengguna menyorot teks, menambahkan catatan tempel, atau menggambar bentuk bebas. Setelah dokumen dibuka, Anda memperoleh manajer anotasi dari penampil, menambah atau memodifikasi objek anotasi, dan menyimpan status anotasi sebagai XML. Menyimpan XML bersama rekaman dokumen memungkinkan riwayat review berversi, dan memuat XML pada pembukaan berikutnya mengembalikan keadaan visual yang tepat.

Pencarian Berbasis OCR untuk PDF yang Dipindai

Kontrak, kwitansi, atau gambar medis yang dipindai sering kali berupa PDF hanya gambar. Search Plugin Doconut secara otomatis menjalankan OCR di server ketika Anda mengaktifkannya dalam konfigurasi penampil. Mesin OCR berada di dalam tumpukan sisi‑server, sehingga teks yang diekstrak tidak pernah keluar dari lingkungan terlindungi Anda. Setelah OCR selesai, Anda dapat memanggil API pencarian untuk mengambil nomor halaman yang cocok dan persegi pembatas, yang dapat disorot oleh UI. Karena OCR berjalan di server, Anda juga dapat mengindeks teks yang diekstrak ke Azure Cognitive Search, Elasticsearch, atau layanan pencarian lain apa pun untuk menyediakan pencarian teks penuh instan di seluruh repositori Anda.

Kolaborasi melalui Token Berbagi

Dalam integrasi Teams atau SharePoint, Anda biasanya menghasilkan token berumur pendek yang menyandi ID dokumen, izin pengguna, dan cap waktu. String token Doconut yang dikembalikan dari panggilan OpenDocument dapat dibungkus dalam JWT atau disimpan dalam entri cache. Ketika pengguna lain mengklik tautan berbagi, token yang sama digunakan untuk menghidupkan kembali penampil, mempertahankan anotasi dan lapisan OCR untuk semua orang yang terlibat.

Konversi Sisi‑Server yang Aman dan Pencetakan Terkontrol dengan Doconut

Banyak perusahaan perlu mengonversi file Word, Excel, atau CAD yang masuk menjadi PDF untuk pengarsipan, atau menegakkan kebijakan “cetak‑hanya‑jika‑disetujui”. Converter Plugin Doconut menangani skenario ini tanpa memerlukan Microsoft Office atau layanan pihak ketiga. Anda memanggil API konversi di server, memberikan jalur file sumber (atau aliran) dan format output yang diinginkan. Konversi berjalan sepenuhnya di back‑end, menghasilkan PDF yang dapat disimpan di repositori dokumen Anda.

Setelah PDF ada, Anda dapat mengaktifkan Controlled Printing langsung di UI penampil. Doconut menyediakan metode untuk mengatur izin cetak untuk token dokumen tertentu. Ketika pengguna mengklik tombol cetak, Doconut memeriksa flag tersebut dan menghasilkan aliran gambar yang dapat dicetak atau mengembalikan pesan “pencetakan dinonaktifkan” yang ramah. Pendekatan ini menghilangkan kebutuhan JavaScript khusus untuk memblokir dialog cetak browser.

Audit Aktivitas Pencetakan

Karena permintaan cetak melewati middleware Doconut, Anda dapat menautkan ke pipeline logging ASP.NET Core untuk menangkap siapa yang mencetak apa dan kapan. Simpan entri audit dalam tabel SQL atau teruskan ke sistem SIEM untuk pelaporan kepatuhan—krusial untuk solusi teknologi hukum atau kesehatan di mana setiap akses dokumen harus dapat dilacak.

Praktik Terbaik untuk Skalabilitas dan Kinerja di Lingkungan Lintas‑Platform

Manfaatkan caching terdistribusi – Cache ubin‑halaman internal Doconut dapat didukung oleh Redis, Azure Cache, atau implementasi IDistributedCache apa pun. Sertakan hash versi dokumen dalam kunci cache untuk menghindari penyajian gambar usang setelah konversi.
Gunakan pekerjaan latar belakang untuk konversi massal – Saat mengintegrasikan arsip besar, antrikan tugas konversi dengan Hangfire atau Azure Functions. Kelas penampil Doconut bekerja dengan pekerja IHostedService karena menerima aliran dan mengembalikan token tanpa memerlukan konteks HTTP.
Sesuaikan resolusi gambar per perangkat – Perangkat seluler mendapat manfaat dari ImageResolution yang lebih rendah (150‑200 DPI), sementara workstation desktop dapat meminta 300 DPI untuk detail CAD. Sesuaikan resolusi berdasarkan string user‑agent atau pengaturan sisi‑klien.
Aktifkan pemuatan lambat anotasi – Simpan XML anotasi dalam tabel terpisah dan muat hanya ketika pengguna membuka panel anotasi. Ini mengurangi beban awal dan mempercepat rendering halaman pertama.
Pantau jejak memori – Rendering halaman CAD resolusi tinggi dapat intensif memori. Konfigurasikan .NET GC untuk menggunakan mode server dalam produksi (<gcServer enabled="true"/>) dan tetapkan batas waktu yang wajar untuk mencegah pekerjaan rendering yang tidak terkendali.
Terapkan CDN untuk aset statis – Bundle JavaScript dan CSS penampil bersifat statis. Layani mereka dari Azure CDN, CloudFront, atau Cloudflare untuk mengurangi milidetik pada pemuatan halaman awal, terutama untuk tim yang tersebar secara global.

Dengan mengikuti pedoman ini, Anda dapat mendukung ribuan pengguna bersamaan di seluruh benua sambil menjaga latensi di bawah 200 ms untuk halaman pertama—sebuah tolok ukur yang ditargetkan banyak portal perusahaan.

Memulai dengan Cepat menggunakan Trial Gratis Doconut

Cara tercepat untuk mengevaluasi Doconut adalah mengunduh trial gratis dari situs resmi, menambahkan paket NuGet ke proyek ASP.NET Core baru, dan mengikuti panduan cepat. Dalam hitungan menit Anda akan memiliki penampil fungsional yang dapat mengambil dokumen dari Azure Blob, mengaktifkan anotasi, menjalankan pencarian berbasis OCR, dan melakukan konversi sisi‑server yang aman. Untuk instruksi langkah‑demi‑langkah, kunjungi dokumentasi Doconut dan mulailah membangun pengalaman dokumen cloud‑native Anda hari ini.

Siap mengubah alur kerja dokumen Anda? Daftar sekarang untuk trial gratis Doconut dan lihat betapa mudahnya memberikan pengalaman dokumen yang aman, dapat dicari, dan kolaboratif dalam aplikasi .NET apa pun.