Skip to main content

Workbooks
  • Knowledge Base
  • Customer Forum
  • Training
  • Support Portal
  • Support Processes
Login
  1. Home
  2. Support
  3. Knowledge Base
  4. Knowledge base
  5. Integrations
  6. Email Integrations
  7. Workbooks Exchange Server Sync
  8. WESS Troubleshooting
Support

Knowledge Base

Browse our knowledge base articles to quickly solve your issue.

  1. Home
  2. Support
  3. Knowledge Base
  4. Knowledge base
  5. Integrations
  6. Email Integrations
  7. Workbooks Exchange Server Sync
  8. WESS Troubleshooting
  • Welcome to the Knowledge Base
  • Introduction
    • Using the Knowledge Base
    • Editions & Licensing
      • Renewing Licences
    • Workflow
      • Queues
    • Logging In
      • Configuring Security Policies
      • Google Authentication
      • Login Protection
      • Microsoft Azure Active Directory
        • Link Workbooks to Microsoft Azure
        • Setting up User Templates
        • Locking down your Workbooks
    • Support Processes
  • Training
    • Training Videos
    • Training Courses
  • Getting Started
    • Supported browsers
    • Introduction
    • Desktop
      • Tips & Tricks on the Desktop
      • Welcome Messages & Bulletins
    • Records
      • External Links to Workbooks records
      • Tabs
        • Default Tab Views
        • Summary Timeline View
        • Overview Tab
      • Watching Records
      • Notes
    • Landing Pages
      • Bulk Actions
        • Scheduled Bulk Actions
      • Customising Views
        • Customising Columns
        • Filtering
          • Custom Filters
        • Calendar Views
        • Card View
          • Report Card View
          • Worked Examples of Card Views
      • Deleted Items
      • Edit Grids
      • Exporting Data
      • Exporting to MS Excel
    • Workbooks on Mobiles and Tablets
  • Preferences
    • Introduction to Preferences
    • Setting your Preferences
      • Email Accounts
      • Notifications & Reminders
  • Activities
    • Introduction to Activities
    • Using Activities
      • Meetings
        • Integrating Workbooks and Google Calendar
          • Installing and Managing Workbooks and Google Calendar Integration
          • Synchronising your Google Calendar with Workbooks
      • Follow-on Activities
  • Cases
    • Introduction to Cases
    • Displaying & Adding Cases
    • Managing Cases
    • Case Portal
      • Installation
        • Custom Fields
        • Case Portal Configuration
          • Company Details
          • General
            • Case Portal Reports
          • New Case
          • Help Text
          • Emails
          • Advanced Features
          • Field Mappings
          • Help Dialog
          • Product Area Questions
        • Case Portal Additional Features
          • Setting up Public/Private Activity creation
          • Setup Registration Emails from a Person
          • Automatic Emails on Case Status Change
      • Using the Case Portal
        • Case Updates - Public & Private Activities
        • Inviting a Person to the Case Portal
  • Email
    • Introduction to Email
    • Working With Emails
    • Email Signatures
    • Sending Bulk Email
    • Common Email Errors
    • Email Integrations
    • Mailing Lists
  • Forecasts & Quotas
    • Introduction to Forecasts & Quotas
    • Sales Forecasts
      • Adjusting Forecasts
      • Included Forecasts
    • Sales Quotas
  • Importing Data
    • Introduction to Importing
    • Preparing your Import Data
      • Import Templates
      • Compulsory fields for Import
    • Workbooks Import Wizard
      • Uploading your data
      • Defining Field Mappings
      • Extending your Import to other Record types
      • Checking for Duplicates
      • Running and Reviewing your Import
    • Managing your Imports
      • Undoing an Import
  • Leads
    • Introduction to Leads
    • Displaying & Adding Leads
    • Converting Leads
  • Marketing
    • Introduction to Marketing
    • Marketing Campaigns
      • Displaying & Adding Campaigns
      • Campaign Management
      • Campaign Membership
      • Tracking URLs on Campaigns
      • Integrating DotDigital and Workbooks
        • Configuring Workbooks and Dotmailer
      • Integrating MailChimp and Workbooks
        • Configuring Workbooks and MailChimp
    • Mailing Lists
      • Creating Mailing Lists
    • Products
      • Pricing Schemes
      • Supply Scheme
      • Product Bundles
    • Mailshots
      • Creating a Mailshot
    • Upload Library
      • Using the Upload Library
    • Templates
      • Creating Templates
      • Creating a Template to show multiple lines
      • Extra Template Placeholders
    • Using HubSpot with Workbooks
    • Event Management
      • Introduction to Event Management
      • Enabling the Event Management Module
      • Using Event Records
        • Event Records
        • Event Sessions
        • Event Speakers
        • Event Sponsors
        • Event Products
        • Event Tickets
        • Event Attendees
      • The Event Management Portal
        • Introduction to the Event Management Portal
        • Prerequisites for installation
        • Accessing the Plugin
        • Installing the Event Management Portal
        • Amending Event Portal Parameters
        • Adding Custom CSS to the Event Portal
      • On The Day Registration App
      • Setup On the Day Registration App
    • Compliance Records
      • Introduction to Compliance Records
      • Enabling Compliance Records
      • Creating Compliance Records
      • Using Compliance Records
    • Spotler Integration
      • What is Spotler?
      • Navigating your Spotler homepage
      • GatorMail
        • Introduction to GatorMail
        • Managing your GatorMail Account
          • Domain Setup
        • GatorMail Configuration
          • GatorMail Field Mappings
            • GatorMail Hard Bounces
          • Preference Centres & Landing Pages
            • Preference Centre Setup
        • Creating Emails in GatorMail
          • Imbedding Images and Videos
        • Sending Emails in GatorMail
          • Sending GatorMail Campaigns
            • Campaign Action Types
            • Ramp-up
            • Testing Campaigns and Emails
          • Using SendForensics
          • Understanding your Campaign results
        • Advanced Features
          • Gator Smart Forms
          • GatorMail - Dynamic Content
      • GatorLeads / Web Insights
        • Tracking Code
          • Restricting Page Tracking
        • Setting up the Plugin
        • Viewing Web Insights Data on your Form Layouts
        • Domain Names and Online Activities
        • Reporting incorrect Leads created through Web Insights
        • Reporting on Web Insights data
        • Using UTM Values
        • Why aren’t Online Activities being created in the database?
        • Why is GatorLeads recording online activities in a foreign language?
      • GatorSurvey
      • GatorWorkflow
        • Spotler Data Sync
        • Triggered Mailshots
      • GatorPopup
  • Opportunities
    • Introduction to Opportunities
    • Displaying & Adding Opportunities
    • Opportunity Line Items
    • Opportunity Relationships
  • Integrations
    • Mapping
      • Introduction to the Mapping Module
      • Using the Mapping Module
      • Using Mapping in Reports
        • Changing the size/colour of Map Pins
    • Electronic Signing Tools
      • Docusign Integration
        • DocuSign Functionality
          • Copy Document on Signature
          • Update Related Records
          • Sending Multiple Documents
          • People, Organisations & Cases with DocuSign
          • Invoice Payments with DocuSign
          • Managing DocuSign Documents
        • Setting up the DocuSign Integration
          • Authentication with DocuSign
          • Production vs Sandbox
          • Creating a Document with a DocuSign Template
          • Creating a Document with a Workbooks PDF
          • DocuSign Fields
          • DocuSign Settings
          • Form Layout Configuration
        • DocuSign - Worked Examples
          • Taking Payments
          • Updating Related Records
          • Multiple Document Sends
          • Creating a Template for Cases
          • Creating a Template for Organisations
          • Creating a Template for People
          • Unified PDF for Transaction Documents
        • DocuSign - Reporting
          • Multiple Send Report Grid
          • Document Review Report
          • Monitoring Integration Errors
      • Adobe Sign Integration
        • Introduction to Adobe Sign
        • Authentication with Adobe Sign
        • Installing the Integration
        • Integration Monitoring & Error Handling
        • Setup of Adobe Sign
        • Adobe Sign Fields & Form Layout Configuration
        • Optional Custom Fields for Adobe Sign
        • Adobe Sign Button Process
        • Using the Adobe Sign Integration
    • Creditsafe Integration
      • Installing the Creditsafe Plugin
      • Configuring Organisations to use the Creditsafe Integration
      • An example of how to use the Creditsafe Integration
    • Zapier
      • Introduction to Zapier
      • Available Triggers and Actions
      • Linking your Workbooks Account to Zapier
      • Setting up Zaps
        • Posted Invoices to Xero Invoices
        • Xero payments to Workbooks Tasks
        • New Case to Google Drive folder
        • New Case to Basecamp Project
        • New Workbooks Case to JIRA Ticket
        • Jira Issue to new Case
        • 123FormBuilder Form Entry to Case
        • Eventbrite Attendee to Sales Lead and Task
        • Facebook Ad Leads to Sales Leads
        • Wufoo Form Entry to Sales Lead
        • Posted Credit Note to Task
        • QuickBooks Online
          • Initial Setup
            • Authentication with QuickBooks Online
          • People & Organisations to QuickBooks Customers
          • POSTED Workbooks Invoice to QuickBooks Online
          • QuickBooks Online Payment to Workbooks Invoice & Task
          • QuickBooks Sales Tax Code Lookup
        • Survey Monkey responses to Tasks
      • Multistep Zaps
    • Email Integrations
      • Email Dropbox
        • Setting up your Dropbox
        • Using your Dropbox
      • Workbooks Exchange Server Sync
        • Supported email clients
        • Set Up
          • Setting up the WESS
          • Setting up the Outlook Add-In
          • Customising the WESS Add-In
          • How to change Authentication setup for WESS
            • O365 Exchange authentication Troubleshooting
        • What gets synchronised?
          • Synchronising with the WESS
          • Synchronising with the WESS Add-in
          • How to force a sync
          • Best practice
        • WESS Troubleshooting
      • Workbooks Outlook Connector
        • Introduction to the Outlook Connector
        • Before downloading the Outlook Connector
          • System Requirements
          • Enabling the Outlook Connector
        • Download/update the Outlook Connector
        • Installing the Outlook Connector
          • Uninstalling the Outlook Connector
        • Using the Outlook Connector
          • Configuring the Outlook Connector's Settings
          • Identifying Records in Workbooks created in Outlook
        • Outlook Connector Troubleshooting
    • Event & Webinar Integration Tools
      • GoToWebinar
        • Installation
          • GoToWebinar Fields & Processes
          • Setting up Process Buttons for GoToWebinar
        • Authentication
          • Multiple GoToWebinar Accounts
          • Removing GoToWebinar Accounts
        • Create/Update & Cancel Webinars from Events
        • Event Attendees as Webinar Registrants
        • Event Speakers as Webinar Panelists
        • Retrieve Webinar Data
      • ON24
        • Installation
          • ON24 Fields & Processes
          • Setting Up Process Buttons for ON24
        • Authentication with ON24
          • Removing ON24 Accounts
        • Create Webcasts from Events
        • Event Attendees as Webcast Registrants
        • Retrieve Webcast Data
          • Reporting: Survey Responses
          • Reporting: Poll Responses
        • Retrieve Survey Data
        • Engagement Hub Interactions
    • Microsoft Office
      • Azure Active Directory
      • Excel
      • Outlook
      • Power BI
      • SharePoint
        • Authentication
        • Installation
          • Custom Fields & Processes
          • SharePoint Integration Settings
        • Using the SharePoint Integration
      • Word
        • Introduction to the Word Add-in
        • Deploying the Word Add-in
        • Creating Word Add-in Templates
          • Example Word Add-in Templates
        • Using Word Add-in Templates
        • Word Add-in Tips and Tricks
    • Outreach
      • Installation
        • Outreach Fields & Processes
        • Create Outreach Custom Field Mappings
          • Configure Outreach Field Dynamic Picklist
        • Sync Outreach Mappings
      • Outreach Authentication
        • Remove Outreach Account
      • Sync People to Outreach Prospects
        • People Field Mappings
      • Sync Organisations to Outreach Accounts
        • Organisation Field Mappings
      • Sync Workbooks Opportunities to Outreach
        • Opportunity Field Mappings
      • Sync Tasks/Activities from Workbooks to Outreach
        • Follow-Up Activities created via Scheduled Process
      • Sync Outreach Sequences to Workbooks
      • Sync Outreach Sequence States to Workbooks
      • Sync Outreach Sequence Step Numbers to Workbooks
      • Sync Prospects/Accounts/Opportunities from Outreach to Workbooks
      • Sync Outreach Tasks/Calls/Meetings to Workbooks
    • Scribe/Workbooks Connector
      • Connection Setup
        • Microsoft SQL Server Connection Requirements
      • Connector Control Blocks
      • Worked Example - Create, Read, Update & Delete
    • RingCentral
      • Installation
        • RingCentral Integration Fields and Processes
      • RingCentral Authentication
        • Remove RingCentral Account
      • Creating Phone Call Activities
      • Click to Dial
  • People & Organisations
    • Introduction to People & Organisations
    • Organisations
      • Displaying & Adding Organisations
      • Customers & Suppliers
    • People
      • Displaying & Adding People
      • Adding People to Outlook
    • Relationships
      • Change Employer Wizard
      • Direct Relationships
      • Third Party Relationships
    • De-duplication and Merge
      • Workbooks Merging
      • Workbooks DQ
      • Data Quality
    • Using Postcode Lookup
    • Data Enrichment
      • Introduction to Data Enrichment
      • Setting up Data Enrichment
  • Snippets
  • Reporting
    • Introduction to Reporting
      • Creating Reports
        • Standard Workbooks Reports
        • Creating a Pre-populated Report
        • Creating a Report from a Template
          • Report Templates
        • Creating a Blank Report
        • Auto-refreshing Report Views
      • Sharing Reports
    • Using Reports
      • Reporting Explained
        • Adding Targets, Conditional Formatting and CSS Styling
          • Calculated Targets
          • Target Sets
            • Creating a Target set for Closed Cases per Customer Support Agent
            • Creating a Target set for Closed Sales amount per Sales Person by quarter
        • Reporting with multiple currencies
        • Drilling into Summary Views
        • Improving Report Performance & Run Time
      • Displaying reports within Record Views
      • Displaying Reports
        • Reporting Views (Reports on Landing Pages)
      • Adding a Report view to a Dashboard
    • Charts
      • Creating & Using Charts
        • Bar Charts
          • Targets on Bar Charts
        • Line Charts
        • Pie Charts
        • Dial Charts
    • Exporting Reports
      • Emailing Scheduled Reports
    • Advanced Reporting
      • Types of Split Columns
      • Using Calculated Columns
        • Introduction to the IF Statement
        • Introduction to the CASE Statement
        • Applying Search filters in Calculated Columns
        • Comments in Calculated Columns
        • Financial Year Reporting
        • Introduction to Date Functions in Reports
        • Using Calculated Criteria
        • Reporting on empty fields
      • Audit Reporting
  • Dashboards
    • Adding Elements to Dashboards
      • Configuring Dashboard Elements
    • Dashboard Views
    • Dashboard Fields
    • Creating a Sales Dashboard
    • Springboard
    • Adding a Dashboard as a Record Tab
  • Okta Authentication
  • Transaction Documents
    • Introduction to Transaction Documents
      • Displaying & Adding Transaction Documents
      • Copying Transaction Documents
      • Transaction Documents Fields Help
      • Transaction Documents Line Items Help
      • Printing & Sending Transaction Documents
      • Managing Transaction Document Currencies
      • Managing Transaction Document Statuses
      • Setting a Blank Default Currency on Transaction Documents
    • Credit Notes
    • Customer Orders
    • Invoices
    • Quotations
    • Supplier Orders
    • Contract Management
      • Displaying & Adding Contracts
      • Using Contracts with Cases
    • Sagelink
  • Auditing
    • Auditing
  • Configuration
    • Introduction to System Administration
      • Quick Start Wizard
    • Users & Security
      • Users
        • Setting up your Users
        • Disabling Users
        • Profile Pictures
      • User Groups
        • Capabilities
        • Creating & Modifying User Groups
      • Permissions
        • Sharing Policies & Mandatory Permissions
          • Configuring the Advanced Security Module
            • Configuring the Advanced Security Module: Segmenting Users by function
            • Configuring the Advanced Security Module: Segmenting Users by location
      • Account Settings
      • Licences & Modules
        • Multi Language
    • Database
      • Databases
      • Storage Usage
      • Prefixes & Numbering
        • Modifying Object References
      • Export Database
      • Database Settings
    • Accounting
      • Accounting Periods
      • Exchange Rates
        • Setting Exchange Rates
      • Tax Regimes
        • Setting Tax Rates
        • Sales Tax Rulesets
          • Using Sales Tax Rulesets
      • Own Organisations
        • Setting up your Own Organisation
    • Email & Integration
      • Email Settings
        • Setting up your Email Server
        • Using Workbooks Server to send Emails
      • API Keys
      • Web to Case and Web to Lead
        • Setting up a Web2Case Form
        • Setting up a Web2Lead Form
        • Using Web Forms in Workbooks
        • Editing a Web Key Form
      • Preference Centre
      • MailChimp & dotMailer
      • Loqate
      • Bank Account Validation
    • Customisation
      • Creating & Modifying Picklists
      • Desktop Preferences
      • Theme
      • Record Types
        • Creating Custom Fields
          • Dynamic Linked Items & Picklists
          • Constrained Dynamic Linked Items (DLI) & Picklists
          • Creating relationships with Dynamic Linked Items (DLIs)
          • Linking Custom Field Values
          • Showing Linked Records in Tabs
        • Report-based Custom Fields
          • Improving the Performance of Report Cells/Grids
        • Linked Fields & Reference Fields
        • Record Templates
        • Form Layouts
          • Customising an Organisation form
          • Displaying a Tab as a Side Panel
          • Card View
          • Read-only Assigned to Fields
        • Customising relationships between parties
          • Configuring Custom Party Relationships
        • Opportunity Stages
      • Custom Records
        • Enabling Custom Records
        • Creating Custom Record Types
          • Editing Custom Record Types
        • Using Custom Records
    • Automation
      • Plugins
        • Field Updater Plugin
        • File Storage Plugin
          • Using File Storage
          • Using SharePoint File Storage
        • Cognism Enrich Plugin
          • Using Cognism Enrich
        • Email to Case Plugin and Process
      • Processes
        • Process Logging
      • Workbooks Scripts
        • Script Library
        • How Workbooks Runs Scripts
        • Workbooks Script External Access
      • API Data
      • Triggers and Webhooks
        • Configuring Triggers and Webhooks
    • PDF Configuration
      • Modifying Document Templates
        • Adding Terms & Conditions to your Documents
        • Multi-line Value Tags
      • Modifying Default Colours & Images
      • Creating Custom Document Templates
  • Contact Support
    • Contacting Workbooks Support
    • Workbooks CRM Advisory Packs
    • Introduction to the Administrator Service
  • Releases & Roadmap
    • Roadmap
    • September 2022 Release
    • June 2022 Release
    • March 2022 Release
    • October 2021 Release
    • June 2021 Release
    • March 2021 Release
    • 2020 Releases
      • December 2020 Release
      • September 2020 Release
      • April 2020 Release
      • January 2020 Release
    • 2019 Releases
      • September 2019 Release
      • February 2019 - Event Management Release
      • January 2019 Release
    • 2018 Releases
      • October 2018 Release
      • May 2018 Release
      • February 2018 Release
      • January 2018 Release
    • 2017 Releases
      • November 2017 Release
      • September 2017 Release
      • June 2017 Release
      • March 2017 Release
    • 2016 Releases
      • December 2016 Release
      • August 2016 Release
      • January 2016 Release
  • Workbooks Glossary

WESS Troubleshooting

Welcome to the Workbooks Exchange Server Sync (WESS) troubleshooting guide. This guide should be used if you have received any errors when using the WESS. We have further information about what the WESS is and how you use it on our Exchange Server Sync knowledge base page.

WESS Troubleshooting Guide (Do not select)

ActiveRecord::RecordNotSaved

When a user is created within the WESS before Workbooks then this message will appear within Workbooks. To resolve this follow these steps:

1. Go to Configuration > Email Integrations > Exchange Sync

2. Within the "Users" page you should be able to see the affected user. They should have an "Exchange Email" but not a "User" name.

4. Click Configuration > choose Organisation

5. When you find the affected user within the Organisation, press the delete icon which should delete the user within the WESS.

6. In Workbooks, add the user via Configuration > Email Integrations > Exchange Sync > Users (this will add the user automatically to the WESS)

Unable to see WESS Configuration in Preferences/ Configuration menu

If you are unable to locate the WESS menu option in either of the following locations;

  • Start > Preferences > Exchange Sync


     
  • Start > Configuration > Email Integrations > Exchange Sync

it is likely that either your WESS licence has expired, or the module is not active at Database or User level.

Resolution steps:

Speak to your system administrator to provision the Exchange sync licence.

Step 1: Check you have a valid licence for WESS

  1. A System Administrator will need to navigate to Start > Configuration > Account Settings  > Licences and Modules.
  2. Select the Licences tab, and ensure that ‘Exchange Sync’ is listed.
    • If it is not there, your Workbooks Account no longer has an Active WESS Licence. To purchase new WESS licences, please contact the Workbooks Sales team by calling 0118 3030 100 or emailing sales@workbooks.com.
    • If it does appear in the list, please proceed below.
  3. Navigate to Start > Configuration > Users & Security > Users.
  4. Open the User Record for the affected User and allocate an Exchange Sync Licence
  5. Save the Record.
  6. The User will need to log out and back in again.

Step 2: Check the Module has been activated

  1. Navigate to Start > Configuration > Account Settings > Licences and Modules.
  2. Select the Modules tab, and check if the ‘Exchange Sync’ line has been ticked.


     
  3. Save & Close
  4. Log out and back into Workbooks

     

Synchronisation was disabled due to an authorisation error

If you receive an email which states ’Your synchronisation was disabled due to an authorisation error’. This is normally caused by incorrect Exchange information being supplied in the Exchange Sync section of Workbooks (Start > Preferences > Integration > Exchange Sync).

Recently Microsoft have deprecated Basic Authentication (Microsoft Exchange and Direct Logon) as detailed here - https://learn.microsoft.com/en-us/exchange/clients-and-mobile-in-exchange-online/deprecation-of-basic-authentication-exchange-online. Further info on switching authentication type can be found here https://www.workbooks.com/help/how-change-authentication-setup-wess.

Resolution steps:

Please select the how you are connecting to your Exchange Account.
 

Individual User Account

Step 1: Check your Exchange credentials are correct

  1. Navigate to Start > Preferences > Exchange Sync.
  2. Ensure the information in the highlighted fields below are correct;

​​​​​​Note: For data security reasons we do not show any passwords that are committed to the database so the Password field will be blank. This means that if any amendments are being made, or if you need to check that the password is set correctly, the correct value needs to be entered on every occasion.

Step 2: Run the Sync again

Allow the Sync to Run again. If the error persists ask your Authorised Support Contact to escalate this to the Workbooks Support team.

 

​​​​​​Note: Pressing the ‘Sync now’ button triggers a ‘Save’ action and then runs a synchronisation. Therefore, if the ‘Sync now’ button is pressed it saves a blank password and the synchronisation will be unsuccessful.

Impersonation User

Step 1: Check the Impersonation User credentials are correct

  1. Navigate to Start > Configuration > Email & Integration > Exchange Sync.
  2. Ensure the information in the highlighted fields below are correct;
     


     
  3. Allow the Sync to Run again.

​​​​​​Note: For data security reasons we do not show any passwords that are committed to the database so the Password field will be blank. This means that if any amendments are being made, or to check if the password is set correctly, the correct value needs to be entered on every occasion.

 

Step 2: Clear any saved Exchange passwords in Workbooks

If the error still persists, on the same screen, open the affected Users Exchange Sync Record By selecting their name after following the path Start > Configuration > Email and Integration > Exchange Sync and press the Save and Close button. This will clear any password that has previously been entered by the User.
 

 

Allow the Sync to Run again. If the error persists ask your Authorised Support Contact to escalate this to the Workbooks Support team.

Your Password has expired, please change it before continuing

You will receive the above error, in the email configuration section of the Configuration Menu or the Users Preferences menu, if the Workbooks Password for that User has expired or the Workbooks User has not been Activated.

 

Resolution steps:

Step 1: Check the account has been activated

If it's affecting a new User, ensure they have activated their User Record by clicking on the Activate link within the automatic email sent by Workbooks. You will be able to see if this has been done by going to Start > Configuration > Users & Security > Users - if the email says 'pending activation' next to it, then they haven't done this yet.

 

 

Once the user has activated their account and logs into Workbooks for the first time, they will be prompted to create a new password.

Step 2: Check the User can log into Workbooks

If the account has been activated and the User is unable to log into Workbooks, they should reset their password using the Forgotten Password link on the Workbooks login screen.

 

Alternatively, a System Administrator can manually change the password for that User, and should then notify the User of their new password.

Step 3: Re-enable the WESS Synchronisation

You should re-enable to WESS Synchronisation by going to Start > Preferences > Exchange Sync or Start > Configuration > Email Integrations > Exchange Sync and check that it is synchronising successfully.

'COM object that has been separated from its underlying RCW cannot be used.'

If the WESS synchronisation is failing with the error ‘COM object that has been separated from its underlying RCW cannot be used.', this is likely to be because the synchronisation has timed out due to a significantly large number of records attempting to be synchronised.

 

The WESS Synchronises People and Organisation Records with the following logic; 

  1. It looks for a View called ‘Exchange Sync’ within People and Organisation records and synchronises the Records found in those Views.
  2. It then synchronises the ‘My People’ or ‘My Organisation’ Landing Page Views also.

Resolution steps:

Reduce the number of records being Synchronised

You’ll need to reduce the number of items in the Views by amending the filters in the View. It is up to you which records you choose to exclude, for example, you might want to exclude any records which are not assigned to you, i.e. those that you Watch.

 

 

Additionally, you could include a field on the record called Exchange Sync which is ticked/unticked based on whether you want to synchronise it or not. You would then be able to apply that filter to the My People/Organisation and Exchange Sync Views.

 

 

You’ll need to allow the Synchronisation to run again and if it fails with the same error, further filters will need to be applied.

 

If the further reduction of records in the synchronisation does not resolve this please ask the Authorised Support Contact to contact the Support team.

‘Access is not permitted from this location’ Error message received by the WESS.

The synchronisation fails with an error message that states that ‘Access is not permitted from this Location.’

 

Within Workbooks, it is possible to apply a restriction on the locations that a User can log into the database, all of which is governed by stating allowed IP addresses or ranges on the User Group Record. These restrictions are generally put in place for security reasons, so removing them is not necessarily appropriate, therefore an additional permitted IP access location needs to be added to the User Group.

 

Resolution steps:

Allow the User access to the WESS IP address

  1. A System Administrator will need to navigate to Start > Configuration > Users & Security > User Groups and add the column for ‘Permitted IP Addresses’;
     

  2. There will be at least one row which contains a value in this new column.
     

  3. Follow the path Start > Configuration > Users & Security > Users > Affected User name and identify which of the restricted Groups the user is a member of.
  4. Open the IP restricted Group from the User Groups tab of the Person Record, maximise the Login Restrictions hidden reveal and add the IP value of ‘23.97.212.108’ to the allowed list ensuring all values are separated by commas;
     

‘500 Bad response’ message being received when trying to set up the WESS

A ‘500 bad response’ error message is being received in the initial synchronisation.

 

This happens when the Connection between the Exchange Sync Service and the Exchange Server has ended the connection because it is not a supported connection for the Exchange Server.

 

Resolution steps:

Step 1: Check Compatibility of Exchange Server

Review the ‘Workbooks Exchange Sync’ Knowledge Base page to ensure that the Exchange Server is compatible with the Workbooks Exchange Service. If not, engage your Exchange Provider to discuss if a Server Migration can take place.

Step 2 Check Exchange Setup has been completed

  1. Check that your IT department have completed the Exchange setup, as per our ‘Set up and configuration of the Workbooks Exchange Server Sync (WESS)’ Knowledge Base page. The necessary information can be found in the section named ‘Configuring your Exchange Server’.
  2. If everything is compatible and setup as per the documentation then please ask your Authorised Support Contact to ask the Workbooks Support team to investigate this further.
  • Best practice
  • Workbooks Outlook Connector

© 2023 Workbooks.com - privacy & terms
  • Linkedin
  • Twitter
  • Youtube
  • Facebook