Structure of Retain XML

Following screenshot displays the structure of Retain XML:

Following is the description of the tags:

<Retain operation="retain">

This is the root tag that specifies the operation. No need to change anything within this tag. This tag has comment as a property name.

comment

This property contains the description of the operation you are performing.

<service>

This is the tag to be defined under <retain> tag. You need to define the type of activities (services) of the target environment that you want to retain during deployment of objects. This tag has the following properties: retainNewActivities, table, and field. 

retainNewActivites

This property contains the Boolean value - true or false. If the value of this property is true, new activities from the source environment will not be migrated to the target environment. If the value is false, new activities will be migrated to the target environment. If you don't specify this property then it will be treated as true.

table

This property contains the name of the table to restrict data while importing data at the target environment. 

field

This property contains the name of the field of the specified service table that you want to retain. The value of the specified field will not be altered in the target environment. For example, if the FTP account username and password are changed at the source environment and you specify the username and password in the <fields> then its value will not be changed in the target environment.