How do I set up and troubleshoot an automated Retrieve Task

Retrieve can be run on a scheduled basis using the Windows task scheduler

Note: The DocuSign Customer Support team supports DocuSign products, such as Retrieve, but it is not set up to provide custom workflow support. Our Support teams are not trained for providing custom workflows. If additional assistance is needed please request a Professional Services engagement.
 


Getting Started

 


Issue(s)


Solution(s) 

Task Scheduler fails while CMD works​
 
  • Check the Action section of the Windows task. Ensure that program path hasn’t defaulted to DocuSignRetrieveApp.exe
  • If using Windows Server 2008 R2 or 2016, you may need to set the compatibility mode for the executable as well as the task to Windows 7.
 
Task Scheduler automatically selects a different executable
  • Ensure that you are using the most current version of Retrieve. 3.2.2 or older version may result in the incorrect executable being selected, you can either upgrade to the latest version or specify DocuSignRetrieve.exe.
 
Task configuration is incorrect
  • Check the program/script section of the Actions tab is DocuSignRetrieve.exe.
  • The rest of the script block needs to be added to the Add arguments section.
  • The script uses multiple quotation marks which can result in syntax errors when the task launches.
 
XML access error

ERROR: The task XML contains a value which is incorrectly formatted or out of range.
  • Confirm latest version of Retrieve.
  • Try uninstall and reinstall Retrieve.
 
Compatibility settings issue

Some versions of Windows will require that compatibility mode be enabled for Retrieve. Locate the Retrieve shortcut, right click on it, then click Properties | Compatibility tab.
Click "Run this program in compatibility mode for", then select Windows 7. Hit Apply, then run the task again.

Note that the General section of the task also has a compatibility setting, this will need to be changed to Windows 7.


 
User-added image
User-added image
 
 
401 access violation
  • 401 access violation means that the login credentials supplied are invalid. Correcting these credentials should allow the task to continue running. Keep in mind that in order to download envelopes from all users you’ll need to log in with an account administrator’s credentials.
 
Missing envelopes

Typically this indicates that your account has gone over its hourly API call limit. By default accounts are restricted to 1000 calls per hour. Retrieve makes multiple calls per envelope with a minimum of 5 along with several overhead calls.

If your CSV includes Envelope Custom Fields it can increase the required number of calls per envelope. Because of this the typical maximum number of envelopes downloaded per Retrieve query is going to be between 165 and 198 envelopes per hour. If you exceed this number there will likely not be a warning provided but the envelopes you’re looking for may appear to be missing.

The easiest way to correct this is to change the frequency of your task to execute more than once per day. 

 



Keywords:Retrieve, Automated Task, Task Scheduler, XML, CMD, Access Violation, Any Status, Compatibility