Microsoft Office Online Cloud For Web Edit
FileCloud can integrate with your Microsoft-hosted Office online server to edit office documents.
Tips
- Please note that for using this type of web editing, users should have an Office365 account.
- When configuring Office365, please use the default 'admin' user to login into FileCloud admin UI. For security reasons, this configuration is not allowed as a normal user promoted as admin.
Support for large file sizes may vary depending on the speed between FileCloud and the relay servers.
Office 365 Office product page
Dataflow
Following diagram depicts the interaction between Microsoft Office Online cloud and an on-premises FileCloud server.
Steps:
- User selects a document file in office online from FileCloud user UI. It loads a HTML page with embedded IFRAME pointing to the Microsoft Office Online cloud.
- IFRAME loaded in the previous step loads the document specific application from the Microsoft cloud. This in turn instructs the Office Online cloud to load the document from FileCloud server.
- Since Office Online cloud supports only pre-approved URLs it cannot load the document directly from FileCloud server. So the download request is forwarded to a relay server (hosted by FileCloud).
- Relay server in turn forwards the request to FileCloud server and returns the response back. In summary, relay server serves as a bridge between Office Online cloud and FileCloud server making the communication back and forth work seamlessly.
Configuring FileCloud With Office Online Cloud
To configure FileCloud with Office Online Cloud:
- In the FileCloud admin portal's left navigation bar, scroll down and click Settings. Then, on the Settings navigation page, click Web Edit .
The Web Edit settings page opens. - Fill in the following values for the first three settings:
WOPI client: Microsoft Office Online Cloud
WOPI client zone: External HTTPS
WOPI client host: onenote.officeapps.live.com - Click Configure.
Upon successful configuration, the following notification instructs user to enable relay configuration. - Beside Enable relay, click Enable.
- When WOPI edit over cloud is selected, FileCloud uses WOPI for all document previews, since the WOPI web editor provides a more faithful reproduction of the document. To disable this behavior, disable WOPI preview in the WOPI Client Settings screen.
- Now that FileCloud server is configured with office online server, administrator might need to enable the web edit option for users.
To enable web edit in the user portal, navigate to Customizations > General > UI Features and check the option Show Online Edit Option. Click Save. - Now log in to the user portal and hover over an editable Office document. Hover over the Web Edit icon, and ensure that you see the Office icon and Microsoft Office for the Web.
- Click the icon.
The file is opened in the Office Online editor. When the Office Online web editor application loads, it prompts the user to enter an Office 365 account. Upon logging in the selected document is loaded in the editor.
Depending the browser's cookie policies, after a user logs into their Microsoft account for WOPI edit, their FileCloud session could be closed. To avoid this problem, set TONIDOCLOUD_COOKIE_SAME_SITE_TYPE to Lax.