Print this page

Install Primary Interop Assemblies (PIA) and Office Visual Studio Runtime manually

Knowledge Article Number 000193384
Description When the Salesforce for Outlook is being installed using the .EXE file, the installer checks your computer for prerequisites and prompts you to download and install them if they do not exist

* You can download each prerequisites by clicking on the name
  • VSTO - Microsoft Visual Studio Tools for Office Runtime 2010
    This only installs the bitness matching your Operating System. If you have Windows 7 64bit, then you only need to push out or install the 64bit MSI. The downloaded file is in the .EXE format which can be run manually as is on the computer by a Local Administrator. You can also use the /Extract switch with the downloaded .exe VSTO to get the MSI version if you would like to deploy it using automation. You can also use this link from Microsoft to download it
  • PIA - Primary Interop Assemblies (PIA) redistributable package for your version of Microsoft Outlook. This is already packaged with our SFO .EXE version and your can extract it. The PIA is only needed if you have Outlook 2007 or 2010. PIA is not needed for Office 2013 or Office 365, it is part of the Office installation package as .NET Programmability Support for Office. In all version of Office you also need to make sure the .NET Programmability Support is installed under Outlook (Control Panel | Installed Applications and locate Office installation, click on Change and Add/Remove features and expand Outlook, it is the first option you can check the box and install it)
  • Microsoft Visual C++ 2010 Redistributable (This will install both bitness on your machine x86 (32 bit) and x64 (64 bit))


Sometimes the installer is unable to complete this process hence the SFO installation fails and to be able to fix this issue you need to install these prerequisites manually before installing SFO


 
Salesforce For Outlook
(SFO) version
SFO version 2.4.x and older SFO version 2.5 thru 2.7.xSFO version 2.8.x and above
Installation OptionPer-Machine by DefaultPer-User by defaultOptional either
  1. Per-Machine
  2. Per-User
Must be installed byLocal AdministratorEnd User1.Local Administrator
2. End User
All these prerequisites must be uninstalled and installed by a Local Administrator or a user with Local Admin rights on the computer
Per-Machine” as known as "Everyone who logs in to this computer", installation is performed to allow all registered users of the computer to access and use the application.

Per-User” as known as "Me Only" installation is performed for the single user that is executing the SFO Setup – it is not available for use by any other user of the computer.


 

 

 
Resolution
First make sure Salesforce For Outlook and Microsoft Outlook are both closed, next uninstall the installed version of Microsoft Primary Interop Assemblies (PIA) and Microsoft Office Visual Studio Run-time (VSTO) from the list of installed programs in the Control Panel (if they exist)

If you are a
Outlook 2007 user, you would need
  • Microsoft Office 2007 Primary Interop Assemblies ( PIA )
  • Microsoft Visual Studio 2010 Tools for Office Runtime x64 or x86  ( VSTO )

 
User-added image
 
Outlook 2010 user, you would need
  • Microsoft Office 2010 Primary Interop Assemblies ( PIA )
  • Microsoft Visual Studio 2010 Tools for Office Runtime x64 or x86  ( VSTO )
 
User-added image
 
Outlook 2013 or Office 365 user
  • When you install SFO using the .EXE file, the installer only installs SFO and you won't get a prompt to install PIA or VSTO. If uninstalling SFO, you won't have anything to remove either unless VSTO was manually installed. The PIA is already included in the Office installation.
 


Please follow the steps below to resolve this issue:

Only the PIA is packaged in the Salesforce for Outlook .EXE file that you download from the Salesforce for Outlook download page. I also provided the direct link to the download page for each one of the prerequisites above

 
STEP 1
First you need to download the Salesforce for Outlook Installer the .EXE format

Download the Salesforce for Outlook Installer


STEP 2
Next create a new folder on your Desktop or Downloads folder and save the downloaded file into this newly created folder (In my example below I have created a folder on the C: drive called "SFO" and saved the file there)


STEP 3
Click on Start and type in CMD to open the Command Prompt. You may also open Command prompt from C:\All Programs\Accessories\Command Prompt


STEP 4
Now from the Command Prompt you can navigate to the folder that you have saved the SalesforceforOutlook.exe installation file and use the /extract command to extract its content.

For example, if you have downloaded the .exe file in a folder called SFO on the C drive, simply open Command prompt and drag and drop the file from the folder in to the Command prompt window and press the SpaceBar key on your keyboard and then type in /extract and press enter.

Or if you are familiar with MS DOS commands you can navigate to the download file location and run the same command

STEP 5
This command will extract the content in the same folder (in this example it will be extracted in the c:\sfo folder)

C:\Folder>   SalesforceforOutlook.exe   /Extract


 
User-added image

 
If you are extracting SFO 2.4.2 or earlier versions, your extracted files would be

User-added image

 
If you are extracting SFO 2.5.0 or newer versions, your extracted files would be as follows.
As you notice, there are no VSTO files. VSTO will be downloaded and installed if it is missing from your machine during the installation process prior to the SFO installation. Also its best to use the .exe file instead of the .MSI files because it the MSI format won't check your machine for prerequisites. Unless its being pushed out and deployed by the IT team
where they will need to push out the prerequisites first then push out SFO
 
User-added image
 
Note**
If needed, you must Uninstall PIA and VSTO from the Control Panel first and then reinstall them from the C:\SFO folder:

In a few case, where your sync may malfunction such as synchronizing blank records or certain field values dont sync, you may need to install VSTO manually using the vstor40_x64 (for 64bit version of Windows) or vstor40_x86 (for 32bit version of Windows)  
During the install process make sure Outlook is closed and the end user is installing the SFO application.
 



STEP 6
If you have Microsoft Office 2013 (NOT the Click-to-Run or 365, you do not need to install the PIA - The extracted files starting with O - O2007pia and O2010pia)

**NOTE
If user has Office 2013 Click to Run or Office 365, they must do an Online Repair - Do not do a Quick Repair

For Office 2013, the PIA is already part of Office installation. You need to make sure the .NET  Programmability Support option under Microsoft Outlook is selected. you can check this setting from Control Panel | Programs | Programs and Features
in the list of installed programs, locate Microsoft Office 2013 and click on Change | add Remove features and expand Microsoft Outlook and the first option is ".NET  Programmability Support" make sure the Run from my computer option is selected. If not select it and click on okay and continue to install it

 
User-added image





STEP 7
For Office 2007 and 2010 users, you can use the o2007pia.msi or o2010pia.msi file

 
  • o2010pia.msi       ==>   For Outlook 2010
  • o2007pia.msi       ==>   For Outlook 2007



STEP 8
Next comes Visual Studio Tools for Office. The number in the file name indicates the bitness of Microsoft Windows. You wont be able to install the wrong bitness on your machine but you can always check the bitness of your Windows before running this file.

 
  • x86 is for Windows 32bit
  • x64 is for Windows 64bit
Once you find out the bitness, you can run the correct file



STEP 9
Now that you have installed these files you can install the plug-in by running the SalesforceForOutlook.exe file




promote demote