#Перегляд файлів Office v1.8.11+

Плагін перегляду файлів Office призначений для попереднього перегляду файлів у форматах Office, таких як Word, Excel, PowerPoint тощо, у додатках NocoBase.
Він базується на загальнодоступному онлайн-сервісі від Microsoft, який дозволяє вбудовувати файли, доступні за публічною URL-адресою, в інтерфейс перегляду. Це дозволяє користувачам переглядати ці файли в браузері без необхідності завантаження або використання програм Office.

#Посібник користувача

За замовчуванням цей плагін перебуває у стані вимкнено. Його можна використовувати після активації в менеджері плагінів, додаткове налаштування не потрібне.

Після успішного завантаження файлу Office (Word / Excel / PowerPoint) у поле файлу в колекції, натисніть на відповідну іконку файлу або посилання, щоб переглянути вміст файлу у спливаючому або вбудованому вікні перегляду.

#Принцип роботи

Попередній перегляд, вбудований у цей плагін, покладається на публічний онлайн-сервіс Microsoft (Office Web Viewer). Основний процес:

• Фронтенд генерує публічно доступну URL-адресу для завантаженого користувачем файлу (включаючи підписані URL-адреси S3);

• Плагін завантажує попередній перегляд файлу в iframe, використовуючи наступну адресу:

  https://view.officeapps.live.com/op/embed.aspx?src=<Публічна URL-адреса файлу>

• Сервіс Microsoft запитує вміст файлу за цією URL-адресою, рендерить його та повертає сторінку для перегляду.

#Примітки

• Оскільки цей плагін залежить від онлайн-сервісу Microsoft, переконайтеся, що мережеве з'єднання стабільне і є доступ до відповідних сервісів Microsoft.
• Microsoft отримає доступ до наданої вами URL-адреси файлу, а вміст файлу буде короткочасно кешуватися на їхніх серверах для рендерингу сторінки перегляду. Таким чином, існує певний ризик для конфіденційності. Якщо у вас є сумніви щодо цього, рекомендуємо не використовувати функцію перегляду, яку надає цей плагін¹.
• Файл для перегляду повинен мати публічно доступну URL-адресу. За замовчуванням файли, завантажені в NocoBase, автоматично генерують доступні публічні посилання (включаючи підписані URL-адреси, створені плагіном S3-Pro), але якщо для файлу встановлено права доступу або він зберігається у внутрішній мережі, попередній перегляд буде неможливим².
• Сервіс не підтримує автентифікацію або ресурси у приватному сховищі. Наприклад, файли, доступні лише у внутрішній мережі або такі, що потребують входу в систему, не можуть використовувати цю функцію перегляду.
• Після того, як вміст файлу буде отримано сервісом Microsoft, він може бути закешований на короткий час. Навіть якщо вихідний файл буде видалено, вміст попереднього перегляду може залишатися доступним протягом певного часу.
• Існують рекомендовані обмеження щодо розміру файлів: для файлів Word і PowerPoint рекомендується не перевищувати 10 МБ, а для файлів Excel — 5 МБ, щоб забезпечити стабільність перегляду³.
• Наразі немає офіційного чіткого опису ліцензії на комерційне використання цього сервісу. Будь ласка, самостійно оцінюйте ризики при використанні⁴.

#Підтримувані формати файлів

Плагін підтримує попередній перегляд лише для наступних форматів файлів Office, виходячи з MIME-типу або розширення файлу:

• Документи Word: application/vnd.openxmlformats-officedocument.wordprocessingml.document (.docx) або application/msword (.doc)
• Таблиці Excel: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (.xlsx) або application/vnd.ms-excel (.xls)
• Презентації PowerPoint: application/vnd.openxmlformats-officedocument.presentationml.presentation (.pptx) або application/vnd.ms-powerpoint (.ppt)
• Текст OpenDocument: application/vnd.oasis.opendocument.text (.odt)

Для файлів інших форматів функція перегляду цього плагіна не буде активована.