On-Prem Exchange

Addin Deployment auf Exchange 2016/2019/SE (on-premises)

Diese Anleitung beschreibt, wie das ROOMS Outlook Add-In auf einem on-premises Exchange Server (2016, 2019 oder Subscription Edition) bereitgestellt wird.

Wichtig: Einschränkung OWA / Webmail

Das Add-In funktioniert auf on-premises Exchange (2016/2019/SE) ausschliesslich mit dem Desktop Outlook Client. OWA (Webmail) wird nicht unterstützt, da OWA auf on-premises Exchange nur Outlook Add-In API Requirement Sets bis 1.6 bereitstellt. Das ROOMS Add-In benötigt jedoch mindestens Requirement Set 1.7.

Weitere Details zu den unterstützten Requirement Sets finden Sie in der Microsoft Dokumentation.

Voraussetzungen

Die Installation und Konfiguration des Wizards und IDP muss abgeschlossen sein. Die benötigten IDP-Clients (rooms und rooms-addin) werden dabei automatisch erstellt.
Der IDP muss über eine HTTPS-Adresse erreichbar sein (z.B. https://idp.example.com).

Schritt 1: Manifest herunterladen

Das Manifest wird über die IDP-URL bezogen. Ersetzen Sie <IDPURL> mit der Adresse Ihres IDP-Servers:

https://<IDPURL>/api/addin/manifest?useSso=false

Hinweis

Die URL zeigt auf den IDP-Server (z.B. idp.example.com), nicht auf den Rooms-Server.

useSso=false — generiert ein Manifest ohne M365 SSO (Login via Forms/Windows Auth). Der veraltete Parameter useOnPrem=true wird weiterhin unterstützt.
clientName — optional, Standard ist rooms-addin. Nur angeben, falls ein anderer IDP-Client verwendet wird.

Falls Ihre Umgebung Entra ID / Azure AD nutzt (Hybrid-Setup), können Sie useSso weglassen und stattdessen die O365-Anleitung verwenden — auch wenn Exchange on-premises läuft. Der Parameter steuert die Authentisierungsmethode, nicht den Standort des Exchange Servers.

Schritt 2: Deployment über Exchange Admin Center

Öffnen Sie das Exchange Admin Center (ECP) Ihres Exchange Servers (z.B. https://exchange.example.com/ecp/).
Navigieren Sie zu Organization → Add-ins.
Wählen Sie eine der folgenden Optionen:
Option A — Add from URL (empfohlen):
- Geben Sie die Manifest-URL aus Schritt 1 ein und validieren Sie diese.
Option B — Add from File:
- Laden Sie das Manifest zuerst herunter und wählen Sie die XML-Datei aus.

Weitere Informationen zum Verwalten von Add-Ins auf Exchange on-premises finden Sie in der Microsoft Dokumentation.

Schritt 3: WebView-Voraussetzungen prüfen

Das Add-In benötigt die WebView2 Runtime auf den Clients. Diese muss installiert sein, falls sie nicht bereits mit dem Betriebssystem oder Office ausgeliefert wurde.

Download: Microsoft Edge WebView2

Eine Übersicht der verwendeten WebView-Engines für verschiedene Windows- und Office-Kombinationen finden Sie in der Microsoft Dokumentation.

Optional: Anpassung der Texte im Manifest

Die im Manifest angezeigten Texte (Button-Beschriftung, Tooltip etc.) können über die ROOMS-Datenbank angepasst werden:

INSERT INTO TRANSLATING (AssemblyName, ResourceName, ResourceKey, LanguageId, OriginalValue, Value)
VALUES
  ('Addin', 'Addin', 'Addin_GroupLabel',    'de', '3volutions AG', 'Example AG'),
  ('Addin', 'Addin', 'Addin_GroupLabel',    'en', '3volutions AG', 'Example AG'),
  ('Addin', 'Addin', 'Addin_ButtonLabel',   'de', '3volutions AG', 'Raum buchen'),
  ('Addin', 'Addin', 'Addin_ButtonLabel',   'en', '3volutions AG', 'Book a resource'),
  ('Addin', 'Addin', 'Addin_SuperTitle',    'de', '3volutions AG', 'Buchen'),
  ('Addin', 'Addin', 'Addin_SuperTitle',    'en', '3volutions AG', 'Book me'),
  ('Addin', 'Addin', 'Addin_SuperTipTitle', 'de', '3volutions AG', 'Öffnet ein Fenster, das die verfügbaren Ressourcen von 3V-ROOMS anzeigt.'),
  ('Addin', 'Addin', 'Addin_SuperTipTitle', 'en', '3volutions AG', 'Opens a pane displaying available resources from 3V-ROOMS.');

Hinweis

Die Textanpassungen müssen vor dem Herunterladen des Manifests vorgenommen werden, da die Texte beim Generieren des Manifests eingebettet werden.

Referenzen

Zuletzt geändert April 21, 2026: fix(ROMSD-6040): document JobManager desired-room fallback (8378675)