#Pratinjau File Office v1.8.11+

Plugin Pratinjau File Office digunakan untuk melihat pratinjau file berformat Office di aplikasi NocoBase, seperti Word, Excel, PowerPoint, dan lainnya.
Plugin ini berbasis layanan daring publik yang disediakan oleh Microsoft, yang memungkinkan file yang dapat diakses melalui URL publik untuk disematkan ke dalam antarmuka pratinjau, sehingga pengguna dapat melihat file tersebut di peramban tanpa perlu mengunduh atau menggunakan aplikasi Office.

#Panduan Pengguna

Secara default, plugin ini berada dalam status dinonaktifkan. Plugin dapat digunakan setelah diaktifkan di pengelola plugin, tanpa memerlukan konfigurasi tambahan.

Setelah berhasil mengunggah file Office (Word / Excel / PowerPoint) ke bidang file dalam sebuah koleksi, klik ikon atau tautan file yang sesuai untuk melihat konten file dalam antarmuka pratinjau yang muncul atau disematkan.

#Prinsip Implementasi

Pratinjau yang disematkan oleh plugin ini bergantung pada layanan daring publik Microsoft (Office Web Viewer). Proses utamanya adalah sebagai berikut:

• Frontend menghasilkan URL yang dapat diakses secara publik untuk file yang diunggah oleh pengguna (termasuk URL bertanda tangan S3);

• Plugin memuat pratinjau file dalam iframe menggunakan alamat berikut:

  https://view.officeapps.live.com/op/embed.aspx?src=<URL File Publik>

• Layanan Microsoft akan meminta konten file dari URL tersebut, merendernya, dan mengembalikan halaman yang dapat dilihat.

#Catatan

• Karena plugin ini bergantung pada layanan daring Microsoft, pastikan koneksi jaringan normal dan layanan terkait Microsoft dapat diakses.
• Microsoft akan mengakses URL file yang Anda berikan, dan konten file akan disimpan sementara dalam cache server mereka untuk merender halaman pratinjau. Oleh karena itu, terdapat risiko privasi tertentu. Jika Anda memiliki kekhawatiran mengenai hal ini, disarankan untuk tidak menggunakan fitur pratinjau yang disediakan oleh plugin ini¹.
• File yang akan dipratinjau harus berupa URL yang dapat diakses secara publik. Dalam keadaan normal, file yang diunggah ke NocoBase akan secara otomatis menghasilkan tautan publik yang dapat diakses (termasuk URL bertanda tangan yang dihasilkan oleh plugin S3-Pro), namun jika file memiliki pengaturan izin akses atau disimpan dalam lingkungan jaringan internal, file tersebut tidak dapat dipratinjau².
• Layanan ini tidak mendukung autentikasi login atau sumber daya dalam penyimpanan pribadi. Misalnya, file yang hanya dapat diakses dalam jaringan internal atau memerlukan login tidak dapat menggunakan fitur pratinjau ini.
• Setelah konten file diambil oleh layanan Microsoft, konten tersebut mungkin disimpan dalam cache untuk waktu yang singkat. Meskipun file sumber dihapus, konten pratinjau mungkin masih dapat diakses untuk jangka waktu tertentu.
• Terdapat batasan ukuran file yang direkomendasikan: File Word dan PowerPoint disarankan tidak melebihi 10MB, dan file Excel disarankan tidak melebihi 5MB untuk memastikan stabilitas pratinjau³.
• Saat ini, tidak ada deskripsi lisensi penggunaan komersial resmi yang jelas untuk layanan ini. Harap evaluasi risikonya sendiri saat menggunakan⁴.

#Format File yang Didukung

Plugin ini hanya mendukung pratinjau untuk format file Office berikut, berdasarkan tipe MIME atau ekstensi file:

• Dokumen Word: application/vnd.openxmlformats-officedocument.wordprocessingml.document (.docx) atau application/msword (.doc)
• Tabel Excel: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (.xlsx) atau application/vnd.ms-excel (.xls)
• Presentasi PowerPoint: application/vnd.openxmlformats-officedocument.presentationml.presentation (.pptx) atau application/vnd.ms-powerpoint (.ppt)
• Teks OpenDocument: application/vnd.oasis.opendocument.text (.odt)

Format file lainnya tidak akan mengaktifkan fitur pratinjau dari plugin ini.