Kevin Suter
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.