Call Us: +44 (0)1748 473000

Call Us Facebook Twitter Pinterest Linked in Instagram Youtube GooglePlus

Find out how to get 2 hours free training by referring a friend? 
What's the catch?
Articles Categories Screencasts

Troubleshooting the Outlook Add-in. How do I Install - I am having problems installing - I receive error messages when installing the Outlook Addin?

Updated: 24 January 2017 09:15:24 OpenCRM::Add-in::Outlook

The below are guides to some of the most common issues people have when using or installing the Outlook Add-in


What versions of Windows / Office do you support for the OpenCRM Outlook Add-in?

The Outlook add-in is supported on any version of Office/Outlook from 2003 up to Outlook/Office 2013 (32 bit) and Windows XP up to Windows 7 (64 or 32 bit).

It should also work on Windows 8 but due to the infancy of the operating system we have come across some issues here.

Due to changes in components shipped with Office 2013, some manual intervention may be required following the standard setup process. Contact the OpenCRM support team for assistance in this instance.

Installation of the Outlook Add-in on Virtual machines and Parallels for Mac should work, but is not officially supported.

We do not support 64bit Office of any version.



Associate with OpenCRM doesn't auto-search for Contact and after conversion subject and dates are blank

You need to upgrade the Outlook Add-in to the latest version:


 When I copy and paste an email address from Outlook into OpenCRM my emails dont send, why is this?

Generally when you copy an email address from Outlook (right click - copy address) and you paste this into any data field you might notice that this copies more information than just the email address, it often copies ;

Persons Name < >

It is this format that will cause problems when you try to email from OpenCRM.

Note : When you save the record the email address will show correctly as the screen display code automatically displays the correct format and removes everything before the < bracket and everything after the > character.

The answer is to first of all check to see if the format of the email address is as above and if it is then edit the record and remove everything but the conventional format ;


Outlook Add-in - Login issue - You must specify a valid username and password - error.

One of the things that can cause a problem when you login to OpenCRM from the Outlook Add-in is you will receive an error saying "You must specify a valid username and password".

This can be caused by not having the correct username and password entered into the add-in login screen, however, one thing to bear in mind is that attempts to login from any location, including the Outlook Add-in, can trip the security checks within OpenCRM. If you enter the wrong password into the Outlook Addin login box you could LOCK your account. The same error message is returned regardless of the wrong username / password combination OR having your account LOCKED.

You should check that you are able to login to your account using the normally Web Based method to be sure that your account is accessible. Should you lock your account you will need to speak to an Administrator so that they can unlock your account.


I have a problem with the synchronisation of Contacts / Calendar in the Outlook Add-in and I want to reset the sync

Providing all of your Outlook contact data has been stored in OpenCRM, the best and simplest thing to do is to bring all of the data back down from OpenCRM. To do this, you need to do the following:

  • Back up your Contacts, Calendar and Task items using Outlooks Import/Export feature (normally located under the FILE menu).
  • Delete all Contacts / Calendar Items / Tasks from Outlook (in the folders which are set to synch with OpenCRM).
  • Navigate to the folder where the Outlook Add-in is installed - this will normally be C:/program files/opencrmoladdin/
  • Find the files OLData.xml, vtigerdata.xml, opencrmdata.xml and mapvtigerol.xml in the datausername folder under the install directory of the outlook add-in and delete them.
  • Run a new synchronisation. Without the XML file, the add-in has no knowledge of any previously synchronised data, and as the folders to synch into are empty, it will simply re-populate them with everything from OpenCRM.


How do I prevent my email client from leaving copies of messages on the server? How do I configure my email client to delete downloaded emails from the server? I am unable to receive emails and senders are getting bounce backs / rejection emails saying that my mailbox is over quota what should I do?

If using Outlook Express or Windows Mail or Live Mail:

Go to Tools then 'Account's, select your email account and click 'Properties' and then 'Advanced', under 'Delivery' ensure 'Leave a copy of messages on the server' is unchecked and click 'OK'

If using Outlook:

Go to 'Tools', then 'Account Settings', select the email account and click 'Change' then click 'More Settings' then click the 'Advanced' tab, under 'Delivery' ensure 'Leave a copy of messages on the server' is unchecked and click 'OK', 'Next' and then 'Finish'


Error "System Files are out of date" when trying to install the Outlook Add-in.

Setup cannot continue because some system files are out of date on your system. Click OK if you would like setup to update these files for you now. You will need to restart Windows before you can run setup again. Click cancel to exit setup without updating system files.Setup cannot continue because some system files are out of date on your system. Click OK if you would like setup to update these files for you now. You will need to restart Windows before you can run setup again. Click cancel to exit setup without updating system files.

If you receive the above error message when trying to install the Outlook add-in, you can try the following to correct this. If you are not comfortable with this procedure, please contact the OpenCRM support team.

In the files received with the installation package, is a file called SETUP.LST.

1. Right click this file and choose "Open With" and then "Notepad"

2. Remove the following line from underneath the heading "[Setup1 Files]"

   File18=@wininet.dll,$(WinSysPath),$(DLLSelfRegister),$(Shared),4/26/13 1:10:13 PM,1766912,10.0.9200.16540

3. And rename the final line under this heading accordingly:

   File19=@opencrmdll.dll,$(AppPath),$(DLLSelfRegister),,4/26/13 11:02:34 PM,368640,

   File18=@opencrmdll.dll,$(AppPath),$(DLLSelfRegister),,4/26/13 11:02:34 PM,368640,

4. This should allow you to run the install file. You may receive a number of errors during the install process. Click "ignore" on each of these errors. The setup should then complete and the add-in should be visible and working in Outlook.


I am trying to install the Outlook add-in and get this message, what does it mean?: Outlook Add-in - Error while initialising log file

This message means that the add-in is unable to access the folder which contains its log files. This is almost always due to permissions on the required folder, or restrictive permissions on the PC or local user account.

There are a number of possible fixes to this issue:

1. Install the Add-in to a directory you have full permission on - a good example here would be the "My Documents" folder (c:/users/username/Documents in Windows Vista onwards)

2. If that doesn't work - or alternatively - ensure that the user which you are logged in as has full system administrator privileges ON THE LOCAL PC ACCOUNT (i.e. not just the domain account). Install and log in for the first time using this account. Following this, admin access can be revoked.

3. If all the above fails, you can follow these instructions to allow the add-in to write it's log files to it's installation directory.

  • Go to the Start menu and select Computer / My Computer

  • Browse to the Outlook Addin install directory this will normally be C:\Program Files\opencrmoladdin

  • Right click on the opencrmoladdin folder and select "Properties"

  • Select the "Security" tab

  • Click the "Edit" link

  • Click "Add"

  • Enter "Everyone" in the "Enter the object names to select" box and click OK

  • Select the newly added Everyone Group, tick "Full Control" and click OK

  • Click OK to close the Properties window
  • Reload Outlook and follow the instructions here to Login

Can I stop the Outlook Security Warning from popping when I use the Outlook Addin?

Outlook has a feature that allows you to be warned whenever any suspicious activity is detected.

This pop up warns you about malicious code being run on your emails, the Security warning pop up helps to stop this malicious access and gives you control to allow/disallow if the process should be carried out.

Although very helpful these warnings can be irritating if you have a third party application that needs to access the information in Outlook, such as the OpenCRM Outlook Add-in.

There are a number of options available to you......

1. Just accept that the warnings are there for your own good and click to allow access whenever they appear.

2. Add a third party add-on for Outlook that will control the pop ups - some of these add-ons have a level of programmatic control available and therefore can be intelligent, letting certain process access information without the warning whilst retaining a level of security.

3. Manage the Security warnings - so that they only appear when your Anti Virus software is not up to date or compromised. (Depends on the Operating System version).

4. Manage Security warnings - to supress them at all times

Managing Security Warnings

If you would like to manage the way that Security Warnings are displayed you should follow these steps;

(Example is for Outlook 2013)

Select - FILE > Options > Trust Center > Trust Center Settings > Programmatic Access

You can select to display the Security Warnings whenever your Anti Virus software is inactive or out of date - this is generally the default and the preferred method.

Note : This relies on Outlook being able to detect your Anti Virus software - some Windows environments, such as Remote Desktop and Terminal Services session do not support this feature.

You can set Outlook to always warn you of any suspicious activity OR you can turn off the Security warnings completely.

Note : Turning off the Security warnings is not advised - if you do decide that this is the setting that suits you best, make sure that you have suitable Anti Virus software and Malware protection in place.

If you set these options to Never warn me.... you will no longer receive the security pop ups.

Rate This Article
  • 1 star
  • 2 star
  • 3 star
  • 4 star
  • 5 star
Feedback and Comments
captcha code  

You may also be interested in:


Twitter Feed

OpenCRM #Cloud tech gives you the opportunity to hire from anywhere, but how do you #manage teams in so many places?


Software Add-ons Ltd
1 Battalion Court
Colburn Business Park
North Yorkshire
United Kingdom
+44 (0)1748 473000
+44 (0)870 125 5962
Reg #:
England & Wales 05387424

marker Find on Google Maps


Business Efficiency –…

One of the main purposes of using a CRM is to promote your business efficiency – let you concentrate on running your business whilst the CRM takes care of processes and data management. Because of this, we are mindful that shortcuts and ease of use are keys to a successful CRM implementation and as a result we are always developing enhancements here and there to make the user experience that much slicker. As we prepare to launch the latest updates to...

Avoiding Holiday Chao…

Year end is here, hooray, you made it! But along with all the reporting and financial fun (not) that you have to tackle at this time of the year, there’s one more job that needs to be managed: the holiday rush. No, that the Christmas holiday rush, but the one where everyone suddenly remembers that they have a few days of holiday to use up and are desperate to organise “just a few days off.” In the last month of the financial year…and...

Being Part of the Com…

This can be a very difficult balance, do you do this just to gain some recognition or is a genuine effort to add something to your community or the place where you work? My son came to me recently as a coach of an under 8’s football team and asked if we would like to sponsor the kids with a new strip. After a short conversation, we decided that we would be delighted to and it would be a great thing...

Cloud Perspectives – …

Cloud storage is a big step towards streamlining your business. It allows you to store your client details and other information in a manner that is accessible from anywhere, at any time. You can build up a great web of data by interlinking Companies and Contacts with all manner of actions, sales details and support requests, helping you build a complete customer profile. Just like those clients, your own business is not a static entity - you are constantly evolving. Staff...

Having the Right Pers…

It is a common pitfall, especially in the tech industry, to assume that known tasks are therefore easy tasks. That just because you know how to do something (and that everyone in your office knows how to do the same thing), it is actually common knowledge. What do I mean by this? Let me give you an example: I was recently having a conversation with one of our developers about a new piece of software I wanted to introduce and had been...

An Alternative Use of…

Every business has a reason to have a CRM solution. It doesn’t mean that every company will have one or that every company will use them in the same way. Often, different people in the same company will use their CRM differently because they have different reasons for needing one. This means that every CRM solution out there needs to be flexible enough to meet a wide variety of business needs, some simple and others complex. Over the last 12 years, we’ve...

Getting Back To Basic…

Is Nostalgia Making A Comeback? I was surprised to hear that a Finnish manufacturer is set to release a revamped version of the classic Nokia 3310 phone. Although it has been out of circulation for the past 12 years, many people will remember this phone fondly and if you compare its solid build and long-lasting battery life with the phones of today then perhaps that’s not just for nostalgic reasons. The 3310 was a significant step on the journey of innovation and...