Force.com Migration Tool Guide

Force.com Migration Tool
Installing the Force.com Migration Tool
Using the Force.com Migration Tool
Entering Salesforce Connection Information
Constructing a Project Manifest
Creating Retrieve Targets
Retrieving Metadata from a Salesforce Organization
Editing Metadata
Deleting Files from an Organization
Deploying Changes to a Salesforce Org
Checking the Status of a Task
Common Migration Issues
Glossary
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Entering Salesforce Connection Information

In order to retrieve or deploy metadata components, you need to edit build.properties to point to a Salesforce organization:

  1. Go to the location where you extracted the Force.com Migration Tool files and open the sample subdirectory.
  2. Open build.properties in a text editor and do either of the following.
    • To use a username and password for login, substitute a valid Salesforce username and password. If you’re using a security token, paste the 25-digit token value at the end of your password.
    • To use an active Salesforce session for login, uncomment the sf.sessionId property and substitute a valid session ID. Also, make sure to comment out the sf.username and sf.password properties.
Parameter Value
sf.username The Salesforce username for login. The username associated with this connection must have the “Modify All Data” permission. Typically, this is only enabled for System Administrator users. When connecting to a sandbox instance your sandbox name is appended to your username. For example, if your production username is foo@salesforce.com, and one of your sandboxes is called bar, then your sandbox username is foo@salesforce.com.bar.
sf.password The password you use to log into the organization associated with this project. If you are using a security token, paste the 25-digit token value to the end of your password.
sf.serverurl The salesforce server URL. Use https://login.salesforce.com to connect to a production or Developer Edition organization. To connect to a sandbox instance, change this to https://test.salesforce.com.
sf.sessionId The ID of an active Salesforce session. A session is created after a user logs in to Salesforce successfully with a username and password. Use a session ID for logging into an existing session instead of creating a new session.

In the build.properties file, you can specify values for either the sf.password and sf.serverurl property pair, or the sf.sessionId property, but not both. In the build.xml file, your targets can contain all three parameters (password, serverurl, and sessionId). Either the username and password or the session ID will be used for authentication.

Note