Siebel CRM Desktop for Microsoft Outlook Administration Guide > Administering Siebel CRM Desktop > Changing the Behavior of Siebel CRM Desktop >
Controlling How Siebel CRM Desktop Deletes Records During Synchronization
You can control how Siebel CRM Desktop deletes records during a synchronization. The delete confirmation feature allows the user to cancel, during synchronization, a deletion that the user made in Microsoft Outlook. If you enable this feature, then Siebel CRM Desktop does the following work:
- Displays the Confirm Synchronization tab on the Synchronization Control Panel dialog box.
- Uses the Confirm Synchronization tab to allow the user to confirm the delete operation. If the user deletes records in Microsoft Outlook, then Siebel CRM Desktop displays the Confirm Synchronization tab during synchronization. If the user confirms, then Siebel CRM Desktop removes the deleted records from the Siebel database on the Siebel Server. For more information, see How the Number of Deleted Records Determines Delete Confirmation.
To control how Siebel CRM Desktop deletes records during synchronization
- Use an XML editor to open the connector_configuration.xml file.
- To display the Confirm Synchronization tab on the Synchronization Control Panel dialog box, you do the following:
- Add the following code to the root tag of the connector_configuration.xml file:
<features deletion_confirmation_mode="enable"/>
For more information, see Setting the Delete Confirmation Mode Attribute.
- Specify the objects that Siebel CRM Desktop displays in the Delete on Siebel list in the Confirm Synchronization tab.
For more information, see Specifying the Type of Object the User Can Confirm for Deletion.
- To suppress display of the Confirm Synchronization tab on the Synchronization Control Panel dialog box, add the following code to the root tag of the connector_configuration.xml file:
<features deletion_confirmation_mode="suppress"/>
How the Number of Deleted Records Determines Delete Confirmation
The number of records that the user has deleted determines whether or not Siebel CRM Desktop displays the Confirm Synchronization tab. For example:
- If the user deletes three or more accounts, ten or more contacts, or five or more opportunities, then Siebel CRM Desktop displays the Confirm Synchronization tab.
- If the user deletes only one or two accounts, then Siebel CRM Desktop does not display the Confirm Synchronization tab.
Table 12 lists the minimum number of records that the user must delete to cause Siebel CRM Desktop to display the Confirm Synchronization tab. For information on how to configure this behavior, see Specifying the Type of Object the User Can Confirm for Deletion.
Table 12. Threshold at Which Siebel CRM Desktop Displays the Confirm Synchronization Tab
|
Number of Deleted Records |
Account |
3 |
Account.Account_Note |
10 |
Account.Assignment_Group.Association |
5 |
Account.Business_Address (HOR) |
10 |
Account.Business_Address.Association (SIA) |
10 |
Account.Contact.Association |
20 |
Account.Industry.Association |
5 |
Account.Position.Association |
20 |
Action |
20 |
Action.Contact.Association |
100 |
Action.Employee.Association |
100 |
Action_Exception_Squeezzed |
Not applicable |
Assignment_Group |
Not applicable |
Attachment |
10 |
Business_Address (SIA) |
10 |
Contact |
10 |
Contact.Business_Address.Association (SIA) |
10 |
Contact.Contact_Note |
10 |
Contact.Contact_Sync_Owner |
Not applicable |
Contact.Personal_Address (HOR) |
10 |
Contact.Position.Association |
20 |
Currency |
Not applicable |
Defaults |
Not applicable |
Employee |
Not applicable |
Employee.Position.Association |
Not applicable |
Industry |
Not applicable |
Internal_Division |
Not applicable |
Internal_Product |
Not applicable |
Opportunity |
5 |
Opportunity.Assignment_Group.Association |
5 |
Opportunity.Contact.Association |
20 |
Opportunity.Internal_Division.Association |
5 |
Opportunity.Opportunity_Note |
10 |
Opportunity.Opportunity_Product |
5 |
Opportunity.Position.Association |
20 |
Position |
Not applicable |
Sales_Method.Sales_Cycle_Def |
Not applicable |
Setting the Delete Confirmation Mode Attribute
To control the Confirm Synchronization Tab on the Synchronization Control Panel dialog box, you use the deletion_confirmation_mode attribute of the connector_configuration.xml file. Table 13 describes the values you can use for the deletion_confirmation_mode attribute.
Table 13. Values for the Delete Confirmation Mode Attribute
|
|
suppress |
Disables delete confirmation. Siebel CRM Desktop does not display the Confirm Synchronization tab in the Synchronization Control Panel. |
enable |
Enables delete confirmation. Siebel CRM Desktop displays the Confirm Synchronization tab in the Synchronization Control Panel. It displays the Revert Deletions button and the Accept Deletions button. |
revert_only |
Siebel CRM Desktop displays the Confirm Synchronization tab in the Synchronization Control Panel, but enables only the Revert Deletions button. It displays but does not enable the Accept Deletions button. This is the default setting. |
user_confirm |
Siebel CRM Desktop displays the Confirm Synchronization tab in the Synchronization Control Panel, but displays only the Accept Deletions button. It displays but does not enable the Revert Deletions button. |
The following example sets the deletion_confirmation_mode attribute to revert_only. The ellipses (. . .) indicates code that this book omits from this example for brevity: <root>
<features deletion_confirmation_mode="revert_only"
. . .
</features>
Specifying the Type of Object the User Can Confirm for Deletion
You can specify the type of object that Siebel CRM Desktop displays in the Delete on Siebel list in the Confirm Synchronization tab. For example, you can specify Siebel CRM Desktop to display only opportunity records. To specify the type of object the user can confirm for deletion
- Use an XML editor to open the connector_cinfiguration.xml file.
- Locate the object type that Siebel CRM Desktop must display in the Delete on Siebel list in the Confirm Synchronization tab list.
For example, for opportunities, locate the following object type:
type id="Opportunity"
- In the object you located in Step 2 add the synchronizer tag.
For example, add the following tag:
<synchronizer name_format=":[:(Name):]" threshold="5">
For more information, see Setting the Synchronizer Tag.
- Repeat Step 2 through Step 3 for each type of object that Siebel CRM Desktop must display in the Delete on Siebel list.
Setting the Synchronizer Tag
The synchronizer tag in the connector_configuration.xml file controls the type of records that Siebel CRM Desktop displays in the Delete on Siebel list in the Confirm Synchronization tab list. It includes a threshold attribute. In the following example, the threshold attribute set to 5 causes Siebel CRM Desktop to display the Confirm Synchronization tab only if the user deleted five or more opportunities since the last synchronization: <type id="Opportunity" state_field="ObjectState">
<view label="#obj_opportunity" label_plural="#obj_opportunity_plural" small_icon="type_image:Opportunity:16" normal_icon="type_image:Opportunity:24" large_icon="type_image:Opportunity:48"></view>
<synchronizer name_format=":[:(Name):]" threshold="5">
<links>
</links>
<natural_keys>
</natural_keys>
</synchronizer>
</type>
Table 14 describes the values for the threshold attribute of the synchronizer tag.
Table 14. Values for the Threshold Attribute of the Synchronizer Tag
|
|
0 |
Siebel CRM Desktop does not display delete confirmation for the object type. |
1 |
Siebel CRM Desktop displays delete confirmation for the object type. |
Any value greater than 1 |
If you specify any value that is greater than one, then Siebel CRM Desktop does the following:
- If the value you specify is greater than the number of deleted objects, then Siebel CRM Desktop does not display delete confirmation for the object.
- If the value you specify is less than or equal to the number of deleted objects, then Siebel CRM Desktop displays delete confirmation for the object.
|
|