Salesforce Transport 2.x Installation Guide

This page walks you through the installation process for the full binary and source distribution of the Salesforce transport for Mule 2.x.

Prerequisites

You must ensure that you have met the following prerequisites before you install the Salesforce transport.

Installing the Binary

1. Download the Salesforce Transport ZIP and unpack it to any location (hereafter referred to as ZIP_HOME).
2. Copy the contents of the ZIP_HOME/lib/user directory to your MULE_HOME/lib/user directory.
3. Copy the ZIP_HOME/examples/salesforce directory to your MULE_HOME/examples/ directory.
4. Proceed to Salesforce Transport 2.x Example to run an example.

Installing from Source

1. Check out the latest Salesforce transport code from Subversion at: https://svn.muleforge.org/mule-transport-sfdc. Details on how to use Subversion can be found [here].
2. Change to the directory where you checked out the Salesforce transport code, for example: C:\muleforge\mule-transport-sfdc (hereafter referred to as MULE_SFDC_HOME).
3. Change to the MULE_SFDC_HOME\branches\sfdc-2.2.x directory.
4. Run mvn install at the command prompt to build the Salesforce transport. You can optionally skip the unit tests by running mvn -Dmaven.test.skip=true install.
5. Change to the examples directory under MULE_SFDC_HOME\branches\sfdc-2.2.x, and then run mvn install at the command prompt to build the Salesforce transport examples.
6. Change to the dist directory under MULE_SFDC_HOME\branches\sfdc-2.2.x, and then run mvn assembly:assembly at the command prompt to build the Salesforce distribution.
7. Open the Salesforce distribution ZIP from the dist\target directory under MULE_SFDC_HOME\branches\sfdc-2.2.x and unpack it to any location (hereafter referred to as ZIP_HOME).
8. Copy the contents of the ZIP_HOME/lib/user directory to your MULE_HOME/lib/user directory.
9. Copy the ZIP_HOME/examples/salesforce directory to your MULE_HOME/examples/ directory.
10. Proceed to Salesforce Transport 2.x Example to run an example.

Installing a Different Version of the Salesforce Partner WSDL

The Salesforce transport ships with the partner WSDL (API 14.0). To use a custom partner WSDL, download a copy of the file using the following steps:

1. If you have not already done so, download and install Axis.
2. Set up the Axis variables AXISCLASSPATH, AXIS_HOME, and AXIS_LIB as follows:

   
   AXISCLASSPATH=C:\axis-1_4\lib\axis.jar;C:\axis-1_4\lib\commons-discovery.jar;C:\
   axis-1_4\lib\commons-logging.jar;C:\axis-1_4\lib\jaxrpc.jar;C:\axis-1_4\lib\saaj
   .jar;C:\axis-1_4\lib\log4j-1.2.8.jar;C:\axis-1_4\lib\xml-apis.jar;C:\axis-1_4\li
   b\xercesImpl.jar;C:\axis-1_4\lib\commons-logging-1.0.4.jar;C:\axis-1_4\lib\commo
   ns-discovery-0.2.jar;C:\axis-1_4\lib\wsdl4j-1.5.1.jar
   AXIS_HOME=C:\axis-1_4
   AXIS_LIB=C:\axis-1_4\lib
   
   

3. Log in to Salesforce.com as an administrator or as a user who has the "Modify All Data" permission.
4. Click Setup, and then under App Setup, click Develop.
5. Click API to display the WSDL download page.
6. Right-click Download Partner WSDL to display your browser's save options, and then save the partner WSDL to a local directory.
7. Copy the batch script wsdl2jar.cmd from your MULE_HOME\examples\salesforce directory to the directory where you downloaded the WSDL in the previous step.
8. Edit wsdl2jar.cmd to point to your WSDL file name and WSDL version.
9. In the WSDL directory, open a command prompt and run wsdl2jar.cmd.
10. Edit the dependency on the Salesforce partner API in the Salesforce transport POM file to point to your newly created JAR. For example:

            <dependency>
                <groupId>com.sforce.soap.partner</groupId>
                <artifactId>salesforce-partner</artifactId>
                <version>15.0</version>
            </dependency>