Technical Notes, Zetadocs

FIX: Zetadocs Fails to search due to "The remote server returned an error 429"

ZTN4582

This Zetadocs technical note applies to:

  • Zetadocs 11.1 on premises installation
  • Zetadocs Extension cloud installation
  • Using SharePoint online as Archiving option for capture
  • Systems which have a large user base or have mulitple document libraries

Symptom

Users intermittently receive an error message when trying to search or archive in the capture factbox: "Failed to search for documents".

There is an error message in the logs stating:

The remote server returned an error: (429)

After a short period of time, this will clear and the product will work again.

Cause

The above error message is being returned from SharePoint online and is due to a SharePoint query limitation. SharePoint Online will limit the amount of requests made each minute.

This throttling limit on SharePoint is based on the amount of licences you have within SharePoint. 

Please see the Microsoft documentation to understand more regarding throttling within SharePoint Online:

https://learn.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online

Resolution

To work around this limitation within SharePoint, please reduce the number of queries you make to SharePoint or look at upgrading your licence with SharePoint Online to increase the amount of requests that can be made.

To reduce the amount of queries you make, this could be done in 1 of 2 ways:

  1. Reduce the amount of document libaries you have within the SharePoint site you are using for Archiving. Zetadocs will search any document libary which has the 'Zetadocs' content type enabled. Look at reducing the amount of document libaries that we are searching, by combining the documents in to fewer document libaries.
  2. Turn on the option in the general settings "Load without document list to improve page load times". This option will stop Zetadocs from sending a search request when you open a page, this will significantly reduce the amount of queries to SharePoint. Please note, that you will need to manually click the 'refresh' button within the factbox to load the factbox documents for that record.

Last updated: 3rd of February 2023 (BB) 

Keywords: Zetadocs capture, Factbox, failed to search for documents, SharePoint online

Registry Editor warning

WARNING: Using Registry Editor incorrectly can cause serious problems that may require you to reinstall your operating system. Equisys cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved.