git clone git@github.com:forcedotcom/dataloader.git
git submodule init
git submodule update
mvn clean package -DskipTests
The build will include the appropriate eclipse swt jar by detecting the operating system type. If you would like to manually specify the eclipse swt jar, take a look at the pom.xml file to see a full list of available profiles.
Note: salesforce.com officially supports dataloader on Windows XP and Windows 7. The other platforms that dataloader can be compiled for are unofficial.
The build will generate a windows installer exe in the target directory when executing the build in a windows environment. If you are packaging the windows installer for distribution, you must use the following command to specify the win32 profile because the installer is packaged with a 32-bit JRE.
mvn clean package -P win32,-win64 -DskipTests
To run the Data Loader GUI, run the command
java -jar target/dataloader-31.0.0-uber.jar
Use the command below to run the Data Loader GUI on Mac
java -jar target/dataloader-31.0.0-uber.jar -XstartOnFirstThread
To run Data Loader from the command line, use the command:
java -cp target/dataloader-31.0.0-uber.jar -Dsalesforce.config.dir=CONFIG_DIR com.salesforce.dataloader.process.ProcessRunner
The command-line version runs with whatever properties you have in your config.properties file, but you can also pass paramters at runtime as arguments to the program.
For example, the following command sets the operation to insert regardless of what settings are contained in the config.properties file:
java -cp target/dataloader-31.0.0-uber.jar -Dsalesforce.config.dir=CONFIG_DIR com.salesforce.dataloader.process.ProcessRunner process.operation=insert
The process-conf.xml file can be used to define properties for multiple processes. Look at src/main/nsis/samples/conf/process-conf.xml for examples on how to configure it. The way to run a process defined in process-conf.xml is to specify process name on command line like this:
java -cp target/dataloader-31.0.0-uber.jar -Dsalesforce.config.dir=CONFIG_DIR com.salesforce.dataloader.process.ProcessRunner process.name=opportunityUpsertProcess
mvn verify -fn
To run installer tests on windows, you can add the skip parameter in the pom.xml under the maven-surefire-plugin configuration to skip functional tests. To run installer tests on windows use the command
mvn verify -P win32,-win64
If you are running on Windows 7, you will need to run cmd.exe as Administrator for the tests to work properly.
For more information, see the wiki, or the Data Loader Developer's Guide.
Questions can be directed to the open source forum.