Skip to main content

Document Export Failed Error 'Value cannot be null. Parameter name: source'

Updated yesterday

The cause of this error is due to the Broker Service which integrates Access Capture to the target system (in most cases this is Dimensions)

The Broker Service contains a collection of config files. And it is in the Readsoft Broker Service.exe.config file that contains the user credentials, to connect the Broker Service to the Access Document Management solution.

**It is when these user credentials within the config file are invalid; that you will usually see a Document Export Failed error such as Value cannot be null. Parameter name: source

Unless you are an Access Hosted Client, you will be able to resolve this internally by following these steps:

Prerequisites:

  • Access to the correct server which hosts the Access Readsoft Broker Service

  • Permissions to stop and start a Windows Service

  • Permissions to modify files within the directory of the Access Readsoft Broker Service

Once you have the the above prerequisites follow these steps:

  1. On the PC which hosts the Access Readsoft Broker Service locate the service's directory

    • **tip** The Access Readsoft Broker Service is often named this, but can be named Readsoft Broker Service followed by the customername

      1. Open services.msc on the PC and find the service

      2. Right-Click the service, then click Properties

      3. Follow the Path to executable for the directory of the Broker Service

  2. On the services' directory open the file Readsoft Broker Service.exe.config

  3. Search the text in the file for the following value: <ADM>

  4. This will take you to the correct Node which stores the Access Document Management user credentials

  5. Update the UserName and/or Password within the stored credentials fields accordingly

  6. Save changes to the Readsoft Broker Service.exe.config file

  7. You should then stop and start the Broker Service within the services app

  8. Now you should be able to re-process your export failed document.


Another possible cause is that the password is correct but there have been too many logins to Workspace with that account name and password. It can often happen that the credentials configured for the Capture Broker Service are for an account which someone else is also using for their day-to-day Workspace login. When too many logins have occurred from different IP addresses (any client machine and Capture's broker service server have separate IP addresses) Workspace locks the account and requires the user to manually login to confirm they are not a robot. As only a 'Human' can do this, the broker service ends up failing to authenticate because it cannot validate it's a Human. To resolve this, login to Workspace with this account and tick the "I'm not a robot" checkbox then logout. Once that it done, re-verify the invoice in Capture.

**please note that any re-verified documents will send a duplicate transaction to the target system**

If Two Factor Authentication is switched on, either for a Workspace Login or for your domain, then Capture users will see the reported error as it can no longer file the image in Access Document. There are three ways to resolve this:

  1. If 2FA has been applied to individual logins then remove it from the above Access Workspace login that capture is using - this is the simplest solution and would require no further changes.

  2. Create a new Access Workspace user account in the normal way without 2FA, assign a Member Role to Access Document and then provide the engineer dealing with the case with the email address and password so that they can update the Capture configuration accordingly.

  3. If 2FA has been applied to the domain then a new Access Workspace user name account must be created, assign a Member Role to Access Document and then provide the engineer dealing with the case with the user name and password so that they can update the Capture configuration accordingly.

It is essential when choosing options 2 or 3, that you can login to Access Workspace as the new user using only the email address or user name and a password. If Access Workspace requires that you update a temporary password, that must be completed. then log out and login again until all that is needed to login is the email/user name and password.

In the case of solution 2 or 3 a new case will need to be raised with Access as the Capture configuration updates must be made by Access.

If you are an Access Hosted Client, please see the following Get support in Access Capture and reference the title of this article

Did this answer your question?