Outlook Plugin

Mindbreeze InSpire

Mindbreeze GmbH, A-4020 Linz, 2023.

Diese Unterlagen sind streng vertraulich. Durch die Übermittlung und Präsentation dieser Unterlagen alleine werden keine Rechte an unserer Software, an unseren Dienstleistungen und Dienstleistungsresultaten oder sonstigen geschützten Rechten begründet. Die Weitergabe, Veröffentlichung oder Vervielfältigung ist nicht gestattet.

Aus Gründen der einfacheren Lesbarkeit wird auf die geschlechtsspezifische Differenzierung, z.B. Benutzer/-innen, verzichtet. Entsprechende Begriffe gelten im Sinne der Gleichbehandlung grundsätzlich für beide Geschlechter.

Einleitung

Mit dem Outlook Add-In wird die Mindbreeze InSpire Suche in Microsofts Outlook integriert.
Ist das Add-In aktiviert, wird parallel zur Outlooksuche eine Mindbreeze Suche abgesetzt.

Das Mindbreeze Outlook Addin ist kompatibel mit Microsoft Office 2016, 2019, 2021 LTSC und Microsoft Office 365 (jeweils 32-bit und 64-bit Installationen).

Voraussetzungen

Das Outlook Addin benötigt folgende installierte Programme/Runtimes, damit das Addin installiert bzw. verwendet werden kann:

Diese Runtimes sind bei Systemen mit vollständigen Installationen von Microsoft Office und aktuellen Versionen von Windows 10 und 11 bereits vorinstalliert.

Hinweis: Es ist möglich, mithilfe des Mindbreeze Bundled Installer die benötigten Runtimes vollautomatisch mit dem Outlook Addin zu installieren.

Installation und Konfiguration

Es gibt zwei Möglichkeiten das Add-In zu Installieren. Für beide Varianten ist es notwendig, die vorausgesetzten Runtimes lokal zu installieren und das Outlook Addin Plugin auf der Appliance, dessen Client Service zum Suchen verwendet wird, zu installieren (Siehe Plugin Installieren)

In der ersten Variante kann ein Benutzer ohne Administrationsrechte über den Browser von der Insight App aus das Add-In installieren.

In der zweiten Variante kann ein Administrator einen MSI-Installer systemweit installieren und vorkonfigurieren. Weiters ist auch der Mindbreeze Bundled Installer verfügbar, der automatisch die benötigten Runtimes mit installiert.

Outlook Add-In Plugin Installation

Installieren Sie zuerst das Outlook Add-In Plugin unter „Plugins“.

Wählen Sie anschließend unter dem „Client Services“-Tab die Einstellungen des Client Service aus, der für die Suche durch das Outlook Addin verwendet werden soll. Unter „Client Resources“ wählen Sie aus dem Drop-Down Menü das Mindbreeze Outlook Addin aus und fügen Sie es mit dem „Add“-Knopf zu den Client Resources hinzu.

Installation über Browser und Client Service (Benutzer)

Client Service Konfiguration

Um das Outlook Plugin verwenden zu können, muss im Client Service die Option „External URL“ gesetzt werden. Die External URL ist jene URL, unter der das Client Service erreichbar ist. Weiters muss beim Client Service ein gültiges SSL Zertifikat eingespielt werden. (Siehe Client Service)

Plugin-Installation

Für die nächsten Schritte ist es notwendig das Outlook-Addin Plugin auf dem Client Service zu installieren, auf dem die Outlook Suche ausgeführt werden soll. (Siehe Plugin Installieren)

Download und Installation

Das Add-In kann nun am Client unter „Einstellungen“ -> „Outlook Add-In“ heruntergeladen werden.

Das Add-In kann nun installiert werden, indem der heruntergeladene ClickOnce Installer „setup.exe“ vom Benutzer ausgeführt wird. Dafür werden keine Administratorrechte benötigt. Nach der Installation und einem Neustart von Outlook steht das Outlook Add-In sofort zur Verfügung.

Installation über MSI Setup (Administrator)

Im Outlook Plugin Paket finden Sie eine MSI-Setup Datei. Das MSI Setup installiert das Outlook Add-In systemweit. Das Setup setzt mehrere Runtimes voraus, die am Rechner installiert sein müssen, damit das Addin funktioniert (Siehe Voraussetzungen). Weiters ist es notwendig das Outlook-Addin Plugin auf dem Client Service zu installieren, auf dem die Outlook Suche ausgeführt werden soll (Siehe Plugin Installieren).

Nach der Installation muss die Client-Service URL in den Einstellungen eingegeben werden, damit das Outlook Addin funktioniert. Es wird empfohlen als Administrator vor der Installation alle Einstellungen via der System-Registry einzustellen. Siehe dazu Systemweite Konfiguration.

Hinweis: Das MSI Setup ist silent (kein Install-Wizard) und installiert das Add-In sofort ohne weitere Nachfrage. Nach erfolgreicher Installation ist das Outlook Add-In für alle Benutzer des Systems aktiv.

Installation über Mindbreeze Bundled Installer (Administrator)

Weiters gibt es den Mindbreeze Bundled Installer. Dieser beinhaltet den MSI Installer, sowie alle benötigten Runtimes. (Siehe MSI Setup und Voraussetzungen).

Hinweis: Der Mindbreeze Bundled Installer zeigt standardmäßig einen Installation-Wizard an. Für eine silent-Installation können Sie den Installer mit folgenden Parametern auf der Kommandozeile ausführen:

MindbreezeOutlookAddin-BundledInstaller-<version>.exe /silent /install

Konfiguration in Microsoft Outlook

Das folgende Kapitel erklärt die Aktivierung und Einstellung des Add-Ins in Microsoft Outlook.

Das Add-In findet man im Menüpunkt „Add-Ins“. Dort werden die Punkte „Mindbreeze Suche deaktivieren“ und „Einstellungen“ angezeigt.

Mindbreeze Suche deaktivieren/aktivieren

Mit dieser Schaltfläche aktiviert bzw. deaktiviert man das Add-In.

Einstellungen

In den Einstellungen wird die gewünschte Client URL angegeben.
Beispiel: https://demo.mindbreeze.com/apps/client

Außerdem können Sie mit „Enable Logging“ die interne Diagnostik aktivieren. Damit werden Log-Dateien in das Verzeichnis %APPDATA%\Mindbreeze\log\ geschrieben.

Installiert und aktiviert.

Ist die Konfiguration des Add-Ins abgeschlossen, kann das Outlook Add-In verwendet werden.

Deinstallieren des Add-Ins

Wird das Add-In nicht mehr benötigt, kann es unter „Programm deinstallieren oder ändern“ deinstalliert werden. Wenn das Addin über den Client Service installiert wird, dann kann das Addin auch ohne Administratorrechte deinstalliert werden. Ansonsten werden Administratorrechte benötigt.

Suchen sie dazu nach folgendem Programm:

Systemweite Konfiguration

Das Mindbreeze Outlook Add-In speichert Konfigurationseinstellungen in der Windows Registry des Benutzers (HKEY_CURRENT_USER). Ein Administrator hat die Möglichkeit, Voreinstellungen in der Windows Registry der Maschine (HKEY_LOCAL_MACHINE) zu setzen.

Falls ein Benutzer eigene Einstellungen gespeichert hat, werden die Einstellungen des Benutzers verwendet, ansonsten werden die Einstellungen der Maschine verwendet.

Der Registry-Pfad der Benutzereinstellungen lautet:

HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins\Mindbreeze.OutlookAddin.Config

Der Registry-Pfad für lokalen Maschineneinstellungen lautet:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Outlook\Addins\Mindbreeze.OutlookAddin.Config

Wenn 32-Bit Versionen von Microsoft Outlook verwendet werden, lautet der Registry Pfad stattdessen:

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Office\Outlook\AddIns\Mindbreeze.OutlookAddin.Config