Following screenshot displays the structure of Retain XML:
Structure of Retain XML
Following are is the description of the tags of retain XML:
<Retain operation="retain">
This is the root tag . It also that specifies the operation. You do not have No need to change anything within this tag.
<service table="au_users" />
<service table="au_groups" />
<service table="au_filesource" >
<field fieldName="au_filepath" />
</service>Define 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 (Servicesservices) of the target environment that you want to retain during deployment to objects.
Here:
...
service table
...
Service table that you want to retain.
...
fieldName
...
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.
...
7
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.