Office 365 Services

Die Office-Services 'office365-client' und 'office365-dashlet' ermöglichen das Einbinden von Office 365 als Dashlet in enaio® client, enaio® webclient und enaio® webclient als Desktop-Anwendung für ein kollaboratives Arbeiten mit Word-, Excel und PowerPoint-Dokumenten.

Notwendig ist eine Lizenz von OPTIMAL SYSTEMS und eine der folgenden Microsoft-Lizenzen: Microsoft 365 Business Standard und höher, Microsoft 365 Apps for business, Microsoft 365 Apps for enterprise, Office 365 E3 oder Office 365 E5 und entsprechende Microsoft-Konten für die Benutzer.

Die Office-Versionen benötigen Office-Dateien im XML-Format. Sollen vorherige Dateiformate bearbeitet werden, dann wird die Konvertierung angeboten und die konvertierten Dateien werden als Varianten angelegt.

Die Office-Services werden über enaio® service-manager installiert und benötigen den Service 'dms'.

Dateigrößen

Für das Anzeigen und Bearbeiten von Dateien ist ein Timeout von 60 Sekunden und zusätzlich eine Größenbegrenzungen für die Dateiübertragung vorgegeben.

Konfiguration

Für die Konfiguration benötigen Sie folgende Daten von OPTIMAL SYSTEMS GmbH: OPTIMAL SYSTEMS-Tenant-ID und OPTIMAL SYSTEMS-Tenant-Secret. Die Daten erhalten Sie auf Anfrage.

Für Tenant-IDs sind keine Sonderzeichen erlaubt.

Mit folgenden Schritten konfigurieren Sie das Einbinden von Office 365:

• Services-Konfiguration über die Konfigurationsdateien application-prod.yml von enaio® gateway und office365-prod.yml von enaio® service-manager.

• Dashlet-Konfiguration für enaio® client in enaio® enterprise-manager.

Services-Konfiguration

Die Konfigurationsdatei application-prod.yml von enaio® gateway wird um die Endpunkte der Office-Services erweitert:

proxy:
  services:
    endpoints:
      - endpoint:
          name: office365
          url: 'http://localhost:8099'
      - endpoint:
          name: dashlet365
          url: 'http://localhost:8091'

In die Konfigurationsdatei office365-prod.yml von enaio® service-manager werden die OPTIMAL SYSTEMS-Tenant-Daten eingetragen, die Sie von OPTIMAL SYSTEMS GmbH auf Anfrage erhalten haben und ein Pfad zu einem Arbeitsverzeichnis:

tenant:
  id: OS-Tenant-ID
  secret: OS-Tenant-Secret
  provider-url: https://provider.prod.enaio.io/
  host-url: https://host.prod.enaio.io/
  working-dir: C:\\data\\office
  recovery:
    enable: true

Verschlüsselung von Konfigurationswerten

Die Konfigurationswerte der Datei office365-prod.yml aus dem Verzeichnis \config\ von enaio® service-manager können verschlüsselt werden:

• Öffnen Sie die Eingabeaufforderung als Administrator und wechseln Sie in das Verzeichnis \service-manager\tools\encryption\.

• Führen Sie folgenden Befehl aus: encode.bat "value" -W

  Der verschlüsselte Wert wird mit führendem 'ENC' und in runden Klammern angezeigt: ENC(encryptedvalue)

• Kopieren Sie den verschlüsselten Wert mit führendem 'ENC' und mit den runden Klammern und tragen Sie diesen in die Konfigurationsdatei ein.

• Speichern Sie die Konfigurationsdatei und starten Sie den Service gegebenenfalls neu.

Wenn der zu verschlüsselnde Wert Anführungszeichen enthält oder mit einem Backslash endet, dann müssen diese Zeichen durch einen Backslash maskiert werden.
Beispiel: encode.bat "passwordwith\"quotation\"marks" -W

Dashlet-Konfiguration

Die Dashlet-Konfiguration für enaio® client erfolgt über enaio® enterprise-manager:

Applikationsserver > Server > Einstellungen > Servereigenschaften > Kategorie: Services > Dashletn:

• Home-URL:

  Kopieren

  http://<gateway-IP>/dashlet365/?id={OBJECTIDENT}&allowedExtensions=&locale={localename}&sessionguid={sessionguid}

  Kopieren Sie die URL und tragen Sie diese mit der enaio® gateway-Adresse Ihrer Installation ein.

• Titel: Office 365

  Sie können einen beliebigen Dashlet-Titel angeben.

  Dashlet-Titel können über enaio® administrator lokalisiert werden: Einrichtung > Dashlet-Bezeichner

• Beim Start laden

  Nein, das Dashlet darf beim Start nicht geladen werden.

Office 365 in enaio® webclient und enaio® webclient als Desktop-Anwendung

enaio® webclient und enaio® webclient als Desktop-Anwendung binden Office 365 automatisch ein, wenn die Office-Services installiert sind.

Dashlets stehen aktuell noch nicht in enaio® mobile zur Verfügung und allgemein nicht auf mobilen Endgeräten, einschließlich enaio® webclient auf mobilen Endgeräten.

Proxy-Konfiguration

Falls im Netzwerk ein Proxy eingerichtet ist, ist es möglich, eine Proxy-Konfiguration in den Service 'office365-client' einzubinden, falls der Proxy selbst nicht entsprechend konfiguriert werden kann, um eine Verbindung mit Office 365 zu erlauben.

Die Konfiguration erfolgt über die Datei office365-prod.yml aus dem Verzeichnis \config\ von enaio® service-manager.

connection:
  proxy:
    host: proxyServer
    port: proxyPort 
    username:proxyUsername
    password: proxyPassword

Parameter:

Benutzername und Passwort sind nur notwendig, wenn der Proxy das erfordert.

Health Check

Der Service 'office365-client' bietet einen Health Check an. Der Health Check kann über die Home-Schaltfläche der Details-Ansicht des Services in enaio® services-admin ausgeführt werden oder über folgende Adresse: https://<service-manager-admin-IP>:<port>. Standard-Port des Services 'office365-client': 8099.

Die Seite zeigt einen Überblick über die Konfiguration an.

Den Health Check starten Sie über die Schaltfläche Start system health check.

Das Ergebnis wird angezeigt. Es kann über die Schaltfläche Download TXT report gespeichert werden.