**Source URL:** https://commercial.veevavault.help/en/lr/1159066/

# Troubleshooting Collaborative Authoring

This article provides information about troubleshooting collaborative authoring in your Vault, including configuration issues and user issues. The issues listed below are the most common errors and their resolution steps.

## Vault Integration Status: Connection Errors

Vault _Integration Status: Connection Errors_ appear after clicking **Authorize** in **Admin > Settings > Checkout Settings > Collaborative Authoring with Microsoft Office**.

### Unable to Retrieve Security Tokens

**Error**: _Integration Status: Connection Error: Unable to retrieve security tokens, please check Office Application Settings._

<table>
<thead>
<tr>
<th>Cause
<th>Fix

<tbody>
<tr>
<td markdown="span">Incorrect details in checkout settings. A common mistake is using the client secret _ID_ instead of the client secret _Value_.
<td markdown="block">
1. Double check the directory ID and application ID settings.
2. Generate a new client secret in Entra ID. Enter the client secret **Value** in _Checkout Settings_, then click **Authorize**.

<tr>
<td>Your tenant has Conditional Access conditions that block the app's token request.
<td>Work with your IT administrators to scope the Conditional Access Policies (CAPs) to permit the collaborative authoring app.

### Microsoft Office Edit Version Error

**Error**: _Integration Status: Connection Error: A Microsoft Office Edit Version error occurred. Please try again. If the problem persists, contact your Vault Administrator._

| Cause | Fix |
| --- | --- |
| The _Collaboration Drive_ field does not point at a real SharePoint document library, or the URL format is wrong. | Verify the document library exists in SharePoint. Correct the URL to `https://[SharePointAdminURL].com/sites/[SiteAlias]/Shared%20Documents` |
| The SharePoint site was deleted or no longer exists. | Re-create the site, or point Vault at an existing valid library. |

### Microsoft Office Error

**Error**: _Integration Status: Connection Error: A Microsoft Office error occurred. Please try again. If the problem persists, contact your Vault Administrator._

| Cause | Fix |
| --- | --- |
| SharePoint is out of storage. | Empty the SharePoint recycle bin or secure more space for the SharePoint library. |

### Invalid Collaboration Drive Specified

**Error**: _Integration Status: Connection Error: Invalid collaboration drive specified._

| Cause | Fix |
| --- | --- |
| The Entra ID App does not have the correct API permissions. | Ensure that the app has _Site.Selected_ as an Application permission with Admin consent granted. |
| The Entra ID App does not have access to the SharePoint site. | Run the PowerShell script to ensure access is granted. |

### Microsoft Office Server is Not Accepting Requests

**Error**: _Integration Status: Connection Error: The Microsoft Office Server is not accepting requests at this time. Please try your request later or if the problem persists contact your Office 365 support contact._

| Cause | Fix |
| --- | --- |
| Microsoft is unable to successfully grant an access token for an unexpected reason. | Try again. If the problem persists, open a Veeva support ticket. |

### Collaboration Drive is Not a Valid Document Library

**Error**: _Integration Status: Connection Error: The Collaboration Drive provided is not a valid document library._

| Cause | Fix |
| --- | --- |
| The Collaboration Drive URL format is wrong. | Verify the URL matches the following format: `https://[SharePointAdminURL].com/sites/[SiteAlias]/Shared%20Documents` |

### Cannot Update the Collaborative Drive While Documents are Checked Out

**Error**: _Integration Status: Connection Error: You cannot update the Collaborative Drive while there are documents currently checked out to Collaborative Authoring._

| Cause | Fix |
| --- | --- |
| An Admin is attempting to change the SharePoint site while documents are still checked out to collaborative authoring. | Check all documents back in, then reauthorize. |

## Vault Action Errors

Vault action errors appear in Vault dialogs during the user's collaborative authoring actions on individual documents, including _Edit_, _Check In_, and _Cancel Checkout_.

### Unable to Check In from Microsoft Office

**Error**: _Unable to check in from Microsoft Office - The Microsoft Office server is not accepting requests at this time. Please try again later._

| Cause | Fix |
| --- | --- |
| Microsoft is unable to successfully grant an access token for an unexpected reason. | Try again and raise a ticket with Microsoft if the issue persists. |

### Unable to Edit in Microsoft Office: Unable to Add User

**Error**: _Unable to edit in Microsoft Office - Unable to add user to the edit version of this document in Microsoft Office. Please check to make sure the user [username] has a valid account in Microsoft Office or use a different check out option._

| Cause | Fix |
| --- | --- |
| This is an external user and Vault is not configured to auto-invite external users, and the user does not exist in the Entra ID directory. | Add the user as a guest user in the Entra ID directory.

or

Update the _Checkout Settings_ to auto-invite external users. Make sure that Entra ID has _Directory.ReadWrite.All_ and _User.Invite.All_ permissions. |
| The user has an invalid email for use with Microsoft Office: either the Vault email does not match the Microsoft 365 account email, or the user has no Microsoft 365 account or Office 365 license. | Confirm the email on the Vault user matches the intended Microsoft account, and that the Microsoft account is licensed for Office 365. |

### Unable to Edit in Microsoft Office: No Permission

**Error**: _Unable to edit in Microsoft Office - Vault does not have permission to access the specified Collaboration Drive._

| Cause | Fix |
| --- | --- |
| This is an external user and the SharePoint setting _Allow only users in specific security groups to share externally_ is enabled. | Microsoft does not support Entra ID app sharing with the _Allow only users in specific security groups to share externally_ setting. Use a different security mechanism to limit external sharing. |
| The error occurs for specific documents (not all) when there is a lock on the document in SharePoint. | Clear the lock on the document in SharePoint. This needs to be performed by a SharePoint administrator or the SharePoint site owner. |

### Unable to Edit in Microsoft Office: Microsoft Office Edit Version Error

**Error**: _Unable to edit in Microsoft Office - A Microsoft Office Edit Version error occurred. Please try again. If the problem persists, contact your Vault Administrator._

| Cause | Fix |
| --- | --- |
| A user manually deleted the document in SharePoint while it was checked out to collaborative authoring. | Manually restore the deleted document from the SharePoint recycle bin (retained for approximately 90 days).

or

Cancel checkout on the Vault document. This ignores Graph API errors and returns the document to a usable state. |

### Unable to Cancel Checkout from Microsoft Office

**Error**: _Unable to cancel checkout from Microsoft Office - A Vault or Microsoft Office error occurred. Please try again. If the problem persists, contact your Vault Administrator._

| Cause | Fix |
| --- | --- |
| The checkout coincided with a Vault restart for maintenance or downtime, leaving the checkout in a corrupted state. | Submit a support ticket requesting _Office Edit Version Cleanup_. |

### No Collaborative Authoring Actions Available

In the circumstances below, collaborative authoring actions are not available for the document.

| Cause | Fix |
| --- | --- |
| The user is trying to use collaborative authoring on a non-supported file type. Only DOCX, XLSX, XLSM, and PPTX are supported. Older Microsoft Office file types (DOC, XLS, PPT) are not supported, and macro-enabled Microsoft Word file types (DOCM) are not supported. | Confirm the file type. Collaborative authoring's _Edit_ action is not displayed for unsupported types. |
| The user does not have _Edit Document_ permission. | Confirm the user's role on the document and in what states the role should have _Edit Document_ permission. |

## PowerShell Configuration Script Errors

PowerShell configuration script errors can occur when running the provided PowerShell scripts.

### Failed to Grant Permission to Site

**Error**: _Granting Collaborative Authoring Entra ID app permission to the SharePoint Site... Write-Error: Failed to grant permission to site._

| Cause | Fix |
| --- | --- |
| The user running the PowerShell script is not an _Owner_ in the SharePoint site's membership. This should only occur when updating an existing site (migrating from the legacy configuration). | Add the user as an _Owner_ on the SharePoint site, then rerun the PowerShell script. |

### Failed to Create Admin App

**Error**: _Creating temporary Entra ID admin app... Write-Error: Failed to create admin app._

| Cause | Fix |
| --- | --- |
| An incorrect value was provided for the tenant domain. | Check that the tenant domain value is correct and try again. |

### Failed to Create SharePoint Site

**Error**: _Creating SharePoint site... Write-Error: Failed to create SharePoint site_

| Cause | Fix |
| --- | --- |
| An incorrect value was provided for the SharePoint Admin URL. | Check that the SharePoint Admin URL is correct and try again. |

## Microsoft Office Errors During Checkout & Editing

Microsoft Office errors may occur when a user is checking out or editing a document due to issues with Microsoft Office. These errors are unrelated to Vault functionality or configuration.

### File Moved to a New Location

**Error**: _We can't open your file. Your file has moved to a new location._

| Cause | Fix |
| --- | --- |
| A location name was changed on the SharePoint side (such as a site rename or library move). | Work with your SharePoint administrator to undo the change. |

### Access Denied

**Error**:

* _Access Denied - [username] does not have permissions to access this resource._
* _Access Denied - You do not have access to view this file. Would you like to request for permission on SharePoint?_

| Cause | Fix |
| --- | --- |
| The Site User ID does not match between SharePoint and Entra ID. This is typically a user metadata caching issue on the Entra ID side. | Run the Microsoft diagnostic for Site User ID Mismatch from the Microsoft 365 Admin Center. Search the knowledge base in the Microsoft Customer Service Hub for **fix-site-user-id-mismatch** and **access-denied-or-need-permission-error-sharepointonline-or-onedrive-for-business for more information.** |

### Continuous Microsoft Login Loop

| Cause | Fix |
| --- | --- |
| Microsoft Office credentials failing or malfunctioning on the user's device. The user enters their email on the Microsoft login page but is not logged in for collaborative authoring; they are continuously returned to the same login page. This error is seen primarily in Project Vault. | Try opening Microsoft Word in the browser. If it works, restart the device and retry **Edit in Desktop Application**.

If it is still failing, run the Microsoft Office Sign-In Troubleshooting Tool. Select **No** to most prompts asking if sign-in was successful; this purges Office credentials. Retry **Edit in Desktop Application** after the tool completes. |

## Automatic Mentioning Errors

Automatic mentioning errors are displayed in the _Grant Access_ dialog in Microsoft Office. They include the following errors:

* _These recipients don't have access to this item. They will not be able to see or reply to your mention unless you give them access._
* _You do not have permission to grant access to this item. The following people mentioned will not be notified._

<table>
<thead>
<tr>
<th>Cause
<th>Fix

<tbody>
<tr>
<td>The mentioned user was not granted edit access for the document in SharePoint because of a workflow configuration issue or limit.
<td markdown="block">
Verify against the automatic mentioning configuration requirements:

* The workflow must have a collaborative authoring _System Action_ step. Manual checkouts do not support automatic @mentioning.
* The user must have _Edit Document_ and _Download Source_ role permissions per the Sharing Settings at the time the _System Action_ step runs.
* The user must hold the participant role that receives the workflow task before the _System Action_ checkout step, or use the _Add Participant_ action on the workflow after the checkout step. Adding a user only to Sharing Settings, or only to a workflow participant role, is not supported.
* External or Guest users are not supported, which is a Microsoft limitation.
* Sessions with 100 or more participants or task assignees are not supported.

<tr>
<td markdown="span">The mentioned user was not granted _Edit_ access for the document in SharePoint because of a missing permission in the Entra ID app.
<td markdown="span">The Entra ID app must have the _User.Read.All_ Application permission with Admin consent granted.

<tr>
<td>The user's email in Vault does not match their user account email in Entra ID.
<td markdown="span">Reconcile the email values. Ensure **Send Notification upon Check Out Completion** is configured on the _System Action_ step. The notification email contains a CSV with per-user results for diagnosis.

## Workflow Errors

Workflow errors may occur due to issues with the collaborative authoring workflow configuration.

### Document Cannot be Updated

**Error**: _[Document Number] cannot be updated because it does not meet the following criteria for entering the state: Content must not be checked out for docVersion._

| Cause | Fix |
| --- | --- |
| A _Check In from Microsoft Office_ _System Action_ is followed by a state change action in a workflow, and the next state has _Content is not checked out_ entry criteria. The collaborative authoring check-in is asynchronous for performance reasons (to avoid large delays on bulk workflows), so the state change executes before the check-in completes. | Remove the entry criteria, or insert a manual task between the _Check In_ _System Action_ and the state change action so the user proceeds only when check-in is complete. |

### Unable to Perform Checkout

**Error**: _Unable to perform checkout at this time. This document is locked by another user._

| Cause | Fix |
| --- | --- |
| A lifecycle entry action is configured to check the document out when it reaches a specific state (for example, _In Authoring_) at the same time that a workflow _System Action_ also checks it out for automatic mentioning. The system attempts two checkouts in succession and the second checkout fails. | Remove the lifecycle entry action. The workflow's _System Action_ already performs the checkout. |

## Troubleshooting Using the Collaborative Authoring Error Log

In addition to using the troubleshooting information in this article, Admins can access the _Collaborative Authoring Error Log_, which provides raw diagnostic strings to help Admins further investigate collaborative authoring errors. The log allows Admins to confirm or deepen a diagnosis they already started from a user support request. See Collaborative Authoring Error Log for information about reviewing errors in the log.