Siebel Consumer Goods Handheld Guide > Synchronization Conflict Handling and Recovery with Handheld > Preventing Synchronization Transaction Conflicts with Siebel Handheld >

Extended Insert Processing in Siebel Handheld

When the server executes an insert transaction and the insert fails, there are two ways the insert failure can be handled:

• A record is logged that indicates the insert failed, and synchronization continues. This is the default insert behavior. The Conflict Administration screen can be used to recover the data.
• The insert failure is logged, including details of the failure, and synchronization is interrupted. This is the extended insert behavior. Extended insert behavior guarantees that, should an insert fail, data loss does not occur since synchronization is stopped until the circumstances causing the failure are resolved.

NOTE:  If Extended Insert processing takes place, synchronization is interrupted. The synchronization process continues to fail until the problem is resolved. End users must contact their system administrators to recover from the failure. The recovery effort may involve modifying transactions queued for processing, modifying data on the server, or reentering transactions through the Siebel Handheld application.

Enabling Extended Insert Processing

You can, optionally, have a setting with the following setting name:

DefaultHandheldInsertMode.

This parameter, when enabled, applies globally throughout the application. When enabled, every failed insert interrupts synchronization.

You can enable Extended Insert processing through the Settings view in the Administration-Mobile screen.

Table 19 shows the settings for this parameter.

• Business component user property.

  The user property is defined on specific business components. The setting in the business component takes precedence over the setting defined in the Settings view. Table 20 shows the syntax for setting the Extended Insert on a business component and the parameter values.

  HandheldInsertFailMode=Mode

Table 21 shows the combined effect of the setting in the Settings view and the setting on a business component.

• The business component setting always takes precedence over the settings defined in the Administration-Mobile > Settings view.
• If there is no setting on a particular business component, the Applications Settings value applies.
• If there is no setting in either the Settings view or on the business component, the default behavior is for Extended Insert to be disabled.