Common Issues and Solutions

This page covers frequently encountered issues with the SharePoint Connector and their solutions.

File Operation Issues

Cannot Upload Files

Symptoms:

• Upload fails silently or with error
• File doesn't appear after upload

Solutions:

Check	Resolution
SharePoint permissions	Grant write access
Folder exists	Create folder or upload to create
File size	Check file isn't too large
File name	Remove special characters
Connection	Test SharePoint connection

Cannot Download/Open Files

Symptoms:

• Files don't open
• Download fails
• Error when clicking file

Solutions:

Check	Resolution
SharePoint permissions	Grant read access
Browser popup blocker	Allow popups for BC
File actually exists	Verify in SharePoint
File Open Operation setting	Try different setting

Drag and Drop Not Working

Symptoms:

• Can't drag files to FactBox
• No drop indicator
• Drops but nothing happens

Solutions:

Issue	Resolution
New Outlook	Use Classic Outlook
Browser limitation	Try different browser
Permission	Check write access

Display Issues

FactBox Empty

Symptoms:

• FactBox shows no files
• Folder appears empty

Possible Causes:

Cause	Solution
Folder is empty	Upload files
Folder doesn't exist	Will create on first upload
Wrong folder path	Check mapping
Permissions	User can't see files

FactBox Not Showing

Symptoms:

• No SharePoint FactBox visible
• Integration seems missing

Solutions:

Check	Resolution
Table mapping	Create mapping for this table
Page FactBox area	Expand FactBox panel
User permissions	Assign permission set
License status	Verify licensing

Files Not Refreshing

Symptoms:

• Uploaded file not appearing
• Old file list showing

Solutions:

1. Refresh the FactBox manually
2. Navigate away and back
3. Close and reopen the page
4. Clear browser cache

Auto-Upload Issues

Documents Not Auto-Uploading

Symptoms:

• Posted documents not appearing in SharePoint
• Auto-upload seems inactive

Solutions:

Check	Resolution
Auto-upload enabled	Enable in SharePoint Setup
Table mapping exists	Create mapping for posted documents
Report Selection set	Configure report selections
Background processing	Verify Session.StartSession is not blocked

Auto-Upload Creating Wrong PDF

Symptoms:

• Wrong report format
• Missing information

Solutions:

1. Check Report Selections configuration
2. Verify correct report is assigned
3. Check custom layouts

E-Signing Issues

Cannot Send for Signature

Symptoms:

• E-sign action fails
• Error when sending

Solutions:

Check	Resolution
E-signing configured	Configure Adobe/DocuSign setup
Authenticated	Connect to signing service
Document selected	Select a file first
Valid email	Enter valid signer email

Status Not Updating

Symptoms:

• Status stays "Sent"
• Completed but shows pending

Solutions:

1. Use "Check Status" action
2. Verify connection to signing service
3. Check signing service portal directly

Performance Issues

Slow FactBox Loading

Symptoms:

• FactBox takes long to load
• Timeout messages

Solutions:

Cause	Resolution
Many files	Organize into subfolders
Large folder	Use folder navigation
Network slow	Check connectivity
SharePoint load	Try during off-peak

Batch Operations Timeout

Symptoms:

• Batch upload/transfer stops
• Timeout errors

Solutions:

1. Process smaller batches
2. Run during off-peak hours
3. Check network stability
4. Monitor background sessions

Configuration Issues

Setup Warning Messages

These are informational messages shown while entering setup values -- they do not block saving, but they usually indicate a value that will fail later:

Message	Resolution
"The base URL should always end with sharepoint.com, like https://yourcompany.sharepoint.com, something seems wrong?"	Fix URL format
"You cannot use URL encoding (Like %20 for a space) in the base folder."	Remove URL encoding
"sites/ should go into the Site Name field."	Use the Subsite Name field instead of putting sites/ in the Base Folder
"The Callback URL is missing page=70319501, this URL will result in a failure to connect. append the URL with page=70319501"	Add the required parameter

Leading and trailing slashes in the Subsite Name and Base Folder fields are trimmed automatically -- no message is shown for those.

Mapping Not Working

Symptoms:

• Folders not being created
• Wrong destination

Solutions:

1. Verify table mapping saved
2. Check Folder Name Field No. is set
3. Review mapping method
4. Test with new record

Error Symptoms

Token Expired / Authentication Failure

The connector shows: "Could not refresh the authentication to SharePoint, Please go to SharePoint Setup (alt-Q) and click Connect."

Solution: Re-authenticate by clicking Connect in SharePoint Setup.

Access Denied

Solutions:

• Verify SharePoint permissions
• Re-authenticate
• Check folder permissions

Folder Not Found

Solutions:

• Verify path configuration
• Check Base Folder setting
• Create folder if missing

Request Failed

The connector shows: "Could not contact sharepoint.com" (with the server reply appended when one is available).

Solutions:

• Check network connectivity
• Verify SharePoint is accessible
• Review error details

Quick Fixes

Disconnect and Reconnect

1. Open SharePoint Setup
2. Click "Disconnect"
3. Click "Connect"
4. Re-authenticate
5. Test

Clear User Cache

1. Close Business Central
2. Clear browser cache
3. Reopen Business Central
4. Try operation again

Verify Basics

Quick checklist:

• Internet connected
• SharePoint accessible in browser
• Logged in with correct user
• Permission set assigned
• SharePoint Setup configured
• Table mapping exists

When to Contact Support

Contact support when:

• Error persists after trying solutions
• New error not documented
• Suspected bug
• Feature not working as expected

Information to Provide

Item	Details
Error message	Exact text
When it started	Date/time
What changed	Recent changes
Steps to reproduce	How to see issue
Screenshots	If helpful
BC version	Your version
Connector version	From extension info

Related Topics

• Connection and Authentication Errors
• Folder and Mapping Issues
• Getting Help
• SharePoint Setup Page