How Do I Use SharePoint as a Connection Method in Lasernet FO Connector?

This article explains how to use SharePoint as a connection method in Lasernet FO Connector.

Prerequisites

The user will require a SharePoint tenant URL.

This can be configured in Organization administration > Document management > Document management parameters > SharePoint.

Steps

To use SharePoint as a connection method in Lasernet FO Connector, follow these steps:

1. Navigate to Lasernet > Setup > Administration > Connections.

2. Create a new Connection.

• Connection type: Storage

• Type: SharePoint

If your SharePoint tenant URL has been configured in Organization administration (as a prerequisite), you can enable Use default settings to use this SharePoint connection.

3. Set up the Connection based on the following information:

• SHAREPOINT: Tenant URL.

• Advanced authentication: Authentication using a certificate and a client ID. Keep the toggle button set to No.

• Graph setup in Lasernet: Indicates that the SharePoint connection in the Lasernet configuration uses MS Graph, and that path references should include the Library name.

• Subsite (optional): Subsite name.

• Web site URL: Website URL with subsite.

• Folder: Folder for processed files.

• Compress files: Keep files compressed for this storage. Each file will be stored as a .zip file. Keep the toggle button set to No.

The SHAREPOINT connection should not include the site, as this can be selected in the Subsite (optional) field. The customer can also verify the SHAREPOINT connection through standard Dynamics 365 FO via Organization administration > Document management > Document management parameters > SharePoint.

Lasernet Developer Settings

4. Open your Lasernet Developer and ensure your configuration has a SharePoint Output module.

5. Configure your SharePoint Output module and test the connection.

The following is an example of graph settings via SharePoint 365 Connection Properties within Lasernet Developer:

This will complete the SharePoint connection setup.

Potential Error Message

The following messages may be displayed in Lasernet FO Connector:

Warning

Invalid ‘Connection string’

Error

Unable to create SharePoint proxy Exception has been thrown by the target of an invocation. One or more errors occurred. The private key is not present in the X509 certificate

The error “private key is not present in certificate x.509” appears due to the requirement of a private key if you are trying to sign in with a certificate. Review the Microsoft documentation here: Use Azure service principals with Azure PowerShell | Microsoft Learn

Additional SharePoint certificate details can be found here:  Create new certificates - SharePoint Server | Microsoft Learn

If the customer is using ADAL authentication, note that Microsoft recently ended support for ADAL, so we recommend using MSAL instead: Microsoft End of Support for SharePoint and Dataverse AAD Authentication type ADAL in June 2023