#Anteprima file Office v1.8.11+

Il plugin Anteprima file Office consente di visualizzare in anteprima i file in formato Office nelle applicazioni NocoBase, come Word, Excel e PowerPoint.
Si basa su un servizio online pubblico fornito da Microsoft, che permette di incorporare in un'interfaccia di anteprima i file accessibili tramite un URL pubblico, consentendo agli utenti di visualizzare questi file nel browser senza doverli scaricare o utilizzare le applicazioni Office.

#Manuale utente

Per impostazione predefinita, il plugin è in uno stato disabilitato. Può essere utilizzato dopo essere stato abilitato nel gestore dei plugin, senza necessità di ulteriori configurazioni.

Dopo aver caricato correttamente un file Office (Word / Excel / PowerPoint) in un campo file di una collezione, faccia clic sull'icona del file corrispondente o sul collegamento per visualizzarne il contenuto nell'interfaccia di anteprima a comparsa o incorporata.

#Principio di funzionamento

L'anteprima incorporata da questo plugin si affida al servizio online pubblico di Microsoft (Office Web Viewer). Il processo principale è il seguente:

• Il frontend genera un URL accessibile pubblicamente per il file caricato dall'utente (inclusi gli URL firmati S3);

• Il plugin carica l'anteprima del file in un iframe utilizzando il seguente indirizzo:

  https://view.officeapps.live.com/op/embed.aspx?src=<URL pubblico del file>

• Il servizio Microsoft richiede il contenuto del file da questo URL, lo renderizza e restituisce una pagina visualizzabile.

#Note

• Poiché questo plugin dipende dal servizio online di Microsoft, si assicuri che la connessione di rete sia normale e che sia possibile accedere ai relativi servizi Microsoft.
• Microsoft accederà all'URL del file fornito e il contenuto del file verrà temporaneamente memorizzato nella cache del suo server per il rendering della pagina di anteprima. Pertanto, esiste un certo rischio per la privacy. Se ha dubbi al riguardo, si consiglia di non utilizzare la funzione di anteprima fornita da questo plugin¹.
• Il file da visualizzare in anteprima deve essere un URL accessibile pubblicamente. In circostanze normali, i file caricati su NocoBase genereranno automaticamente collegamenti pubblici accessibili (inclusi gli URL firmati generati dal plugin S3-Pro), ma se il file ha permessi di accesso impostati o è memorizzato in un ambiente di rete interna, non potrà essere visualizzato in anteprima².
• Il servizio non supporta l'autenticazione tramite login o risorse in archivi privati. Ad esempio, i file accessibili solo all'interno di una rete interna o che richiedono il login non possono utilizzare questa funzione di anteprima.
• Dopo che il contenuto del file è stato acquisito dal servizio Microsoft, potrebbe essere memorizzato nella cache per un breve periodo. Anche se il file sorgente viene eliminato, il contenuto dell'anteprima potrebbe rimanere accessibile per un certo lasso di tempo.
• Esistono limiti consigliati per le dimensioni dei file: si raccomanda che i file Word e PowerPoint non superino i 10 MB e i file Excel non superino i 5 MB per garantire la stabilità dell'anteprima³.
• Attualmente non esiste una descrizione ufficiale chiara della licenza per l'uso commerciale di questo servizio. Valuti autonomamente i rischi durante l'uso⁴.

#Formati di file supportati

Il plugin supporta solo l'anteprima dei seguenti formati di file Office, in base al tipo MIME o all'estensione del file:

• Documenti Word: application/vnd.openxmlformats-officedocument.wordprocessingml.document (.docx) o application/msword (.doc)
• Fogli di calcolo Excel: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (.xlsx) o application/vnd.ms-excel (.xls)
• Presentazioni PowerPoint: application/vnd.openxmlformats-officedocument.presentationml.presentation (.pptx) o application/vnd.ms-powerpoint (.ppt)
• Testo OpenDocument: application/vnd.oasis.opendocument.text (.odt)

Per i file in altri formati non verrà abilitata la funzione di anteprima di questo plugin.