Granular contact list controls for Scan to Fax using the RightFax (Advanced API) connector

If your RightFax server has a large number of contacts, the default timeout for fetching the contact list may not be long enough. Depending on the size of your contact list, this can cause the phonebook to hang or fail entirely at the MFD. The good news is that there are a couple of things you can try to get things working.

How to fix the problem

The default timeout for fetching contacts from the RightFax server is 30 seconds. To confirm that contact volume is the culprit, temporarily increase this to give the connector more time to respond.

In the PaperCut MF admin interface, go to Options > Config Editor and search for:

  system.scan.fax.contact.timeout-secs

Change the value from 30 to 300, then click Update.

Now retry the contact list lookup at the MFD. If it is able to be loaded, you’ve confirmed the issue is related to the number of contacts being returned. Note that this isn’t a long-term fix, as a several minute wait for a phonebook isn’t practical for end users.

If the timeout increase confirms the issue, you can configure the RightFax connector to only retrieve private contacts belonging to the authenticated user, rather than the full shared contact list.

Log in to the Application Server and use a text editor such as Notepad, opened as administrator, to create a new blank .txt file. Once saved, rename it to rightfax-conf.json

Open the file and paste in the following:

  {
    "contactType": "private"
  }

Save the file and move it into the following directory:

  C:\Program Files\PaperCut MF\server\bin\win\connectors\scan\fax\

When saving, make sure to set the Save as type dropdown to All Files (*.*) so the file saves with a .json extension rather than .json.txt.

Now retry the contact list lookup at the MFD and see if the phonebook loads quickly.

Setting contactType to private will only return contacts from the authenticated users personal address book. If your organisation relies on a shared, published, or master address book, those contacts will not appear with this setting in place.

Still have questions?

Let us know! We love chatting about what’s going on under the hood. Feel free to leave a comment below or visit our Support Portal for further assistance.