Microsoft Office 365 einbinden

Der Services 'office365' bindet Microsoft Office 365 für die Anzeige und das kollaboratives Arbeiten mit Word-, Excel und PowerPoint-Dokumenten an.

Notwendig ist 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.

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

Der Office-Services wird über yuuvis® RAD service-manager installiert. Er muss aktiviert, eingebunden und konfiguriert werden. Mit diesen Konfigurationen werden dann Office-Dokumente im Microsoft Office 365 Dashlet geöffnet.

Office-Dokumente als Anlage einer E-Mail werden nicht im Microsoft Office 365 Dashlet geöffnet, sondern als PDF in der Inhaltsvorschau.

Aktivieren

Aktiviert wird der Office-Service über die Konfigurationsdatei <service-manager>\config\servicewatcher-sw.yml.

Ändern Sie für den Service 'office365' den Wert des Parameters instances von 0 auf 1.

Diese Änderung wird mit Zeitverzögerung aktiv. Starten Sie gegebenenfalls yuuvis® RAD service-manager neu.

Für Aktualisierungen von yuuvis® RAD 9.x auf yuuvis® RAD 10.x müssen folgende Abschnitte in der Konfigurationsdatei servicewatcher-sw.yml neu angelegt werden.

- name: office365
  type: microservice
  profiles: prod,cloud,red
  instances: 1
  memory: 1024M
  port: 7880
  path: ${appBase}/office365/office365-app.jar
  options:
  - -Dfile.encoding=UTF-8
  
- name: dashlet365
  type: webresource
  path: ${enaio.data.path}\webresource\public\dashlet365\dashlet365.zip'

Einbinden

Das Einbinden erfolgt über die Konfigurationsdatei <service-manager>\config\gateway-prod.yml im Abschnitt routing.endpoints.

routing.endpoints: 
  ...
  - name: 'dashlet365'
    url: 'http://client/dashlet365'
  - name: 'office365'
    url: 'http://office365/api'

Nach dem Speichern der Konfigurationsdatei muss der Service 'gateway' neu gestartet werden.

Konfigurieren

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

Diese Daten für die Verbindung und Authentifizierung tragen Sie in die Konfigurationsdatei <service-manager>\config\office365-prod.yml ein.

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: ${enaio.data.path}/o365
  recovery:
    enable: true 

Verschlüsselung von Konfigurationswerten

Passwörter und andere sensible Daten in der Konfigurationsdatei office365-prod.yml sollten verschlüsselt werden:

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

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

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

• Kopieren Sie das verschlüsselte Passwort mit führendem 'ENC' und mit den runden Klammern und tragen Sie es in die Konfigurationsdatei ein.

• Speichern Sie die Konfigurationsdatei.

Health Check

Der Service 'office365' führt beim Start automatisch einen Health Check aus und zeigt den Status an.

Ein Health Check kann ebenfalls über folgende Adresse ausgeführt werden:

https://<service-manager-IP>:<port>. Standard-Port des Services 'office365': 7880.

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.