Dateien auf Share direkt aus Confluence heraus öffnen mit Zuara User Makro

Einleitung

Hatten Sie bereits einmal das Problem, dass Sie eine Datei aus Confluence aus verlinken wollten, die auf einem Share liegt? Die meisten Browser verhindern dies aus Sicherheitsgründen und je nach Browser ist die Syntax der geforderten URL unterschiedlich. Zuara hat ein Benutzermakro entwickelt, das es ermöglicht, Office Dateien wie Word, Excel, PowerPoint, die auf einem Share liegen, direkt zu verlinken und zu öffnen. Das Makro funktioniert mit allen Browsern und auf allen Betriebssystemen. Da die Confluence Cloud generell keine Benutzermakros unterstützt, funktioniert das Makro nur auf Server-Instanzen von Confluence.

Das Makro

Beispiel-Code des Makros für Excel-Dateien

## Macro title: excellink
## Macro has a body: Y
## Body processing: rendered
## Output: inline
##
## Developed by: Zuara Ltd., Sebastian Fiechter
## Date created: 23/06/2020
## Internet Explorer User-Agents: https://www.whatismybrowser.com/guides/the-latest-user-agent/internet-explorer
## Installed by: YOUR NAME
## @noparams
#set($userAgent = $req.getHeader("User-Agent"))
#if ($userAgent.contains('MSIE') == false && $userAgent.contains('Trident') == false)
#set($startIndex = $body.indexOf('href="file://'))
#if ($startIndex > -1)
#set($nsi = $startIndex+13)
#set($endIndex =$body.indexOf('"', $nsi))
#set($link = $body.substring($startIndex, $endIndex))
#if ($link.contains('.xls'))
## search for href="file:// and replace with href="ms-excel:nft|u|file://
#set($body= $body.replaceAll("href=\"file://", "href=\"ms-excel:nft|u|file://"))
#end
#end
#end
$body

Anpassung für weitere Dateitypen

Möchten Sie das Makro für andere Dateitypen als Excel Dateien erstellen, können Sie einfach die oben im Code die Dateiendung sowie den URI Schema-Namen ersetzen (Hinweis: Die Dateiendung xls funktioniert für xlsx-Dateien, doc auch für docx, usw.).

Programm	Dateiendung	URI Schema-Name
Excel	xls	ms-excel
PowerPoint	ppt	ms-powerpoint
Project	mpp	ms-project
Word	doc	ms-word

Eine Liste mit weiteren URI Schema-Namen finden Sie hier: https://docs.microsoft.com/en-us/office/client-developer/office-uri-schemes.

Installation

Öffnen Sie die folgende URL auf Ihrer Confluence-Instanz:

https://<IHRE-INSTANZ>/admin/usermacros.action

Klicken Sie auf Benutzermakro erstellen:

Tragen Sie die folgenden Informationen ein und Speichern Sie das Makro:

Nutzung

Möchten Sie eine Datei auf einem Share verlinken, gehen Sie nach folgender Anleitung vor. 1. Fügen Sie das oben erstellte Makro auf Ihrer Confluence Seite ein.

2. Erstellen Sie einen Text und fügen Sie eine Verknüpfung ein:

3. Wählen Sie Webverknüpfung und tragen Sie den Pfad zur Datei ein, mit dem Präfix file:// vorangestellt:

4. Voilà: Sie haben eine Verknüpfung auf Ihre Excel-Datei auf dem Share angelegt!

Haben Sie Fragen oder Anregungen zum diesem Blog-Beitrag? Dürfen wir Sie unterstützen? Schreiben Sie uns auf hallo@zuara.ch oder rufen Sie uns an: 031 302 60 00.