Office 365 Services

enaio® 12.0

The office services 'office365-client' enable the integration of Office 365 as a dashlet in enaio® client, enaio® webclient and enaio® webclient as a desktop application for collaborative work with Word, Excel and PowerPoint documents.

You must have an OPTIMAL SYSTEMS license and one of the following Microsoft licenses: Microsoft 365 Business Standard or higher, Microsoft 365 Apps for Business, Microsoft 365 Apps for Enterprise, Office 365 E3 or Office 365 E5, and the corresponding Microsoft accounts for the users.

The Office versions require Office files in XML format. If previous file formats are to be edited, then conversion is offered and the converted files are created as variants.

The Office service is installed via enaio® service-manager.

File Sizes

A timeout of 60 seconds as well as a size limit for file transfers are predefined for displaying and editing files.

Application	Mode	Size limit	Comment
Word	View	-	The only limit in terms of the file size is imposed by the timeout.
Word	Edit	100 MB
Excel	View	25 MB
Excel	Edit	25 MB
PowerPoint	View	-	The only limit in terms of the file size is imposed by the timeout.
PowerPoint	Edit	300 MB	There is an additional size limit of typically 100 MB for files embedded in PowerPoint files. The size limit for embedded '.wav' files is 100 KB.

Configuration

You need the following data from OPTIMAL SYSTEMS GmbH for the configuration: OPTIMAL SYSTEMS tenant ID and OPTIMAL SYSTEMS tenant secret. This data will be provided at your request.

Special characters are not allowed for tenant IDs.

Follow these steps to configure the integration of Office 365:

Services configuration via the configuration files application-prod.yml of enaio® gateway and office365-prod.yml of enaio® service-manager.
Dashlet configuration for enaio® client in enaio® enterprise-manager.

Services Configuration

Configuration values such as user name and password can be specified in the encrypted configuration file.

The configuration file application-prod.yml of enaio® gateway is extended by the endpoint of the Office service:

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

The configuration file office365-prod.yml of enaio® service-manager is populated with the OPTIMAL SYSTEMS tenant data you received from OPTIMAL SYSTEMS GmbH on request and a path to a working directory:

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: directory
  recovery:
    enable: true
                                                            

Dashlet Configuration

The dashlet configuration for enaio® client takes places via enaio® enterprise-manager:

Application server > Server > Settings > Server properties > Category: Services > Dashletn:

Home URL:

Copy

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

Copy the URL and enter it with the enaio® gateway address of your installation.

Title: Office 365

You can enter any title for the dashlet.

Dashlet titles cane by localized using enaio® administrator: Setup > Dashlet name
Load at start

No, the dashlet should not be loaded at startup.

Office 365 in enaio® webclient and enaio® webclient as a desktop application

enaio® webclient and enaio® webclient as a desktop application automatically integrate Office 365 if the Office service is installed.

Dashlets are not yet available at this time in enaio® mobile and, in general, are also not available on mobile devices; including enaio® webclient on mobile devices.

Proxy Configuration

If a proxy is set up in the network, it is possible to include a proxy configuration in the 'office365-client' service if the proxy itself cannot be configured accordingly to allow a connection to Microsoft Office 365.

The configuration is carried out via the office365-prod.yml file located in the \config\ directory of enaio® service-manager.

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

Parameters:

host	Address
port	Port
username	User name
password	Password

User name and password are only necessary if the proxy requires them.

Health Check

The 'office365-client' service automatically performs a health check at startup and displays the status.

A health check can also be carried out via the Home button in the Details view of the service in enaio® services-admin.

The page shows an overview of the configuration.

You can perform the health check using the Start system health check button.

The result will be displayed. It can be saved using the Download TXT report button.