mvn clean install -DskipTests
The Linux 64 bit profile is used by default. In order to use the windows profile, add the parameter -Denv=win32
. 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. You must use the -Denv=win32
parameter if you are building the windows installer.
To run the Data Loader GUI, run the command
java -jar target/dataloader-24.0.0-jar-with-dependencies.jar
Use the command below to run the Data Loader GUI on Mac
java -jar target/dataloader-24.0.0-jar-with-dependencies.jar -XstartOnFirstThread
To run Data Loader from the command line, use the command:
java -cp target/dataloader-24.0.0-jar-with-dependencies.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-24.0.0-jar-with-dependencies.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-24.0.0-jar-with-dependencies.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 -Denv=win32
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.