Referenz:OfficeFileHandler

Diese Erweiterung ist derzeit Teil der BlueSpice Roadmap und befindet sich in der Entwicklung.

Anzeige von Office-Dateien

Diese Funktion ermöglicht es, Microsoft Office- und OpenDocument-Dateien, die an eine Wiki-Seite angehängt sind, direkt als Vorschaubild (Thumbnail) im Wiki anzuzeigen. Die Dokumente werden seitenweise gerendert, sodass Benutzer einzelne Seiten eines mehrseitigen Dokuments betrachten können, ohne das Originaldokument herunterladen oder eine externe Anwendung öffnen zu müssen.

Neben den klassischen Microsoft-Formaten (DOC, XLS, PPT) werden auch die modernen OOXML-Formate (DOCX, XLSX, PPTX) sowie OpenDocument-Formate (ODT, ODS, ODP) unterstützt. Damit wird ein Ersatz für einen Teil des Confluence OfficeConnectors geschaffen.

Begriff	Definition
MediaHandler	MediaWiki-Komponente, die für einen bestimmten MIME-Typ die Darstellung (Thumbnails, Metadaten) übernimmt.
Backend-Service	Eigenständiger Microservice, der Office-Dokumente via z. B. LibreOffice in Bilder konvertiert.
Thumbnail	Vorschaubild einer einzelnen Dokumentseite in einem vom Wiki darstellbaren Bildformat (z. B. JPEG).

Beschreibung des Features

Unterstützte Dateiformate

Die Erweiterung registriert MediaHandler für die folgenden MIME-Typen:

Kategorie	Format	Dateierweiterung	MIME-Typ
Textverarbeitung	Microsoft Word (alt)	.doc	application/msword
Textverarbeitung	Microsoft Word (OOXML)	.docx	application/vnd.openxmlformats-officedocument.wordprocessingml.document
Textverarbeitung	OpenDocument Text	.odt	application/vnd.oasis.opendocument.text
Tabellenkalkulation	Microsoft Excel (alt)	.xls	application/vnd.ms-excel
Tabellenkalkulation	Microsoft Excel (OOXML)	.xlsx	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Tabellenkalkulation	OpenDocument Spreadsheet	.ods	application/vnd.oasis.opendocument.spreadsheet
Präsentation	Microsoft PowerPoint (alt)	.ppt	application/vnd.ms-powerpoint
Präsentation	Microsoft PowerPoint (OOXML)	.pptx	application/vnd.openxmlformats-officedocument.presentationml.presentation
Präsentation	OpenDocument Presentation	.odp	application/vnd.oasis.opendocument.presentation

Funktionsweise

1. Upload: Bei der Installation werden die oben genannten Dateiendungen automatisch zur Upload-Whitelist hinzugefügt, sodass Benutzer Office-Dokumente hochladen können.
2. Metadaten-Ermittlung: Beim Upload wird das Dokument an den Backend-Service gesendet. Dieser liefert Seitenanzahl und Seitenabmessungen als JSON zurück. Falls der Service nicht erreichbar ist, werden Fallback-Werte verwendet.
3. Thumbnail-Erzeugung: Wenn ein Vorschaubild einer bestimmten Seite angefordert wird, sendet die Erweiterung das Dokument via HTTP-Anfrage an den Backend-Service mit den Parametern Seitennummer, Ausgabeformat (JPEG) und gewünschter Größe. Das zurückgelieferte Bild wird als Thumbnail gespeichert und über die MediaWiki-Thumbnail-Infrastruktur ausgeliefert.
4. Mehrseitige Dokumente: Die Erweiterung unterstützt die Navigation durch mehrseitige Dokumente (z. B. PowerPoint-Präsentationen, mehrseitige Word-Dokumente) analog zur bereits existierenden Erweiterung PdfHandler.
5. Caching: Metadaten (Seitenanzahl) werden über den MediaWiki-WANObjectCache mit einer TTL von einem Monat gecacht. Thumbnails werden im MediaWiki-Thumbnail-Cache gespeichert und bei erneutem Aufruf direkt ausgeliefert.

Bearbeitung von Office-Dateien

Die Erweiterung bietet die Funktion, Office-Dokumente (Word, Excel, PowerPoint) direkt aus dem Wiki heraus zu bearbeiten und die Änderungen automatisch als neue Dateiversion zurück ins Wiki speichern tz können. Es werden zwei sich ergänzende Integrationswege umgesetzt:

1. WebDAV + MS Office URI Schemes – Öffnet Dateien in der lokal installierten Microsoft Office Anwendung (Word, Excel, PowerPoint). Geeignet für Umgebungen mit Microsoft Office Desktop-Clients.
2. WOPI (Web Application Open Platform Interface) – Öffnet Dateien in einem webbasierten Editor direkt im Browser. Unterstützt werden Collabora Online und OnlyOffice Docs als Editor-Anwendungen. Geeignet für heterogene Umgebungen und Szenarien ohne lokale Office-Installation.

Begriff	Definition
WebDAV	Web Distributed Authoring and Versioning – ein Netzwerkprotokoll (RFC 4918) zur Bereitstellung von Dateien über HTTP(S), das Lesen, Schreiben und Sperren unterstützt.
WOPI	Web Application Open Platform Interface – ein REST-basiertes Protokoll zur Anbindung von webbasierten Dokumenten-Editoren an einen Datei-Speicher.
MS Office URI Schemes	Von Microsoft definierte Protokoll-Handler (z.B. ms-word:), die es ermöglichen, Office-Anwendungen über einen Link im Browser zu starten.
Collabora Online	Ein quelloffener, webbasierter Office-Editor auf Basis von LibreOffice. Wird als Dienst neben dem Wiki betrieben.
OnlyOffice Docs	Ein quelloffener, webbasierter Office-Editor. Wird als Dienst neben dem Wiki betrieben.
Locking (Dateisperre)	Mechanismus, der verhindert, dass mehrere Benutzer gleichzeitig dieselbe Datei überschreiben.
Dateiversion / Revision	Jede Speicherung einer Datei erzeugt eine neue Version. Ältere Versionen bleiben im Wiki nachvollziehbar erhalten.

PDF-Ausschluss - Start

---

Feedback zur Dokumentation ist im Community-Forum möglich.

PDF-Ausschluss - Ende

Kategorien helfen, Seiten im Wiki zur organisieren. Jede Kategorie ist im gesamten Wiki verfügbar.