Introduction

Gold-Vision document storage allows users to view and store documents in an external repository. The Sharepoint Online integration allows for your Gold-Vision documents to be stored in a Sharepoint Online “site” and accessed through the product. The integration is capable of the following:-

• Automatically create folders in your Sharepoint Online site and link them to Gold-Vision items
• Allow users to upload, view, edit and delete files stored in Sharepoint Online
• Allow users to create and delete sub-folders from Sharepoint Online
• Access templates for document production
• Seamless document production and document editing

Prerequisites

You will require the below in order to set up the Sharepoint Online integration.

• A “site” within your Sharepoint Online implementation dedicated to Gold-Vision documents
• A “site” or subfolder of the above for storing template documents
• A login to Sharepoint Online with access rights to the above site

Setup

There are five steps involved in setting up a Sharepoint Online integration, summarised below.

1. Enabling Sharepoint Online Integration
2. Authenticating with Sharepoint Online
3. Configuring the Integration
4. Document Storage Sections
5. Test the Integration

Enable SharePoint Online Integration

The first step is to install and enable the Sharepoint Online integration through the storefront.

1. Open the Settings menu
2. Click on Integrations 
3. The integrations store front will load
4. Find and click on Sharepoint Online 
5. Click the Install button
6. Follow the on-screen install instructions until install is complete
7. Next you will need to enable the integration
8. Select the “Manage” tab under the integration area
9. Click Configure next to the Sharepoint Online  integration
10. Check the Enabled box
11. Save 

Authenticate with SharePoint Online

You will now need to authenticate with Sharepoint Online in order for Gold-Vision to communicate.  To authenticate you will need to create a new Azure AD social authentication token.  

1. Open the Settings menu
2. Click on Social Authentication
3. The Social Authentication tokens list will load
4. Click Actions then New 
5. Select Azure AD from the list of providers (if Sharepoint Online does not appear you either have not enabled the integration above or you already have a valid token)
6. You will be taken to Sharepoint Online / O365 to log in and authorise Gold-Vision
7.  Once you have authorised Gold-Vision you will see a token in the Social Authentication list from above

Configure the Integration

The final setup to set up the Sharepoint Online integration is to configure it.

1. Open the Settings menu
2. Select Document Storage
3. Select the Sharepoint Online option that is now visible.
4. Select a Document Library (click Load to load a list of options)
5. Select a Template Library
6. Optional: You may enter a sub-folder in you don’t wish to store your Gold-Vision documents in the root of the document library selected above.
7. Click ‘Save‘.

Document Storage Sections

You will also need to ensure a “Documents” section has been designed onto the screens where you would like to see and store documents.

1. Open Settings 
2. Select Screen Designer 
3. Select the item type / screen design to add Document storage to
4. Locate the page you wish to add a document section to
5. Click Add Section
6. Select Document Storage section
7. Save the screen design

Test the Integration

It is a good idea to test the integration is working as expected.  Follow the steps below.

Please ensure a Document Storage section is present on the Account screen design (see above for how to do this) 

1. Open the New menu
2. Select New Account
3. Enter a Name and Save 
4. Locate the Document Storage section
5. There should be a folder matching the account name present
6. Click on the folder to open it
7. Click Upload File (under three dots menu)
8. Select a file (recommend a Word document)
9. Check the file is uploaded to the folder
10. Click on the file name
11. You should be taken to the file in Sharepoint Online in a new window

Done

You’ve completed the Sharepoint Online integration setup and can now access your linked folder documents from Gold-Vision.