Understanding retrieve

Use the retrieveCode target to retrieve classes and triggers from your sandbox or production organization. During the normal deploy cycle, you would run retrieveCode prior to deploy, in order to obtain the correct directory structure for your new classes and triggers. However, for this example, deploy is used first, to ensure that there is something to retrieve.

To retrieve classes and triggers from an existing organization, use the retrieve ant task as illustrated by the sample build target ant retrieveCode:

1<target name="retrieveCode">
2   <!-- Retrieve the contents listed in the file codepkg/package.xml into the codepkg directory -->
3   <sf:retrieve username="${sf.username}" password="${sf.password}" 
4        serverurl="${sf.serverurl}" retrieveTarget="codepkg" unpackaged="codepkg/package.xml"/>
5</target>

The file codepkg/package.xml lists the metadata components to be retrieved. In this example, it retrieves two classes and one trigger. The retrieved files are put into the directory codepkg, overwriting everything already in the directory.

The properties for the retrieve task are as follows: