Bookshelf Home | Contents | Index | Search | PDF

Siebel ePharma Handheld Guide for Windows-Powered Devices > Synchronization Conflict Handling and Recovery > Preventing Synchronization Transaction Conflicts >

Enabling Extended Pick Processing

---

You can enable Extended Pick processing in two ways:

Configuration file parameter

The configuration file parameter applies globally throughout the application. When enabled, every handheld pick transaction is subject to pick processing. The parameter is set as follows:

DefaultHandheldSyncPickMode=Mode

Table 20 describes the settings for this parameter.

Table 20.  Configuration File Setting

Configuration File Parameter	Mode Value	Description
DefaultHandheldSyncPickMode	NoFail	Turns Extended Pick processing ON
	FailOnError	Turns Extended Pick processing OFF. This is the default behavior if the parameter is not specified in the .cfg file.

Business component user property

The user property is defined on specific business components. The syntax for setting Extended Pick on a business component and the parameter values (Table 21) follow:

HandheldSyncPickMode=Fieldname|Mode

Table 21.  Business Component User Property Parameters

Business Component User Property	Parameter	Value	Description
HandheldSyncPickMode	Fieldname	—	Specify the field name as defined in Siebel Tools.
	Mode	NoFail	Turns Extended Pick processing ON.
		FailOnError	Turns Extended Pick processing OFF.

You may apply Extended Pick processing to multiple fields in a single business component, using the following syntax:

HandheldSyncPickMode=Fieldname1|Mode1, Fieldname2|Mode2

The setting on the business component takes precedence over the setting in the configuration file. For example, you can use the business component setting to nullify the global application of Extended Pick in the configuration file. See Recommended Extended Pick Processing Settings for an example. Conversely, you can enable Extended Pick processing on specific business components if the configuration file setting has disabled the functionality.

Table 22 shows the combined effect of the settings in the configuration file and on a business component.

The business component setting always takes precedence over the setting in the configuration file.
If there is no setting on a particular business component, the configuration file setting applies.
If there is no setting in either the configuration file or on the business component, the default behavior is for Extended Pick to be turned OFF.

Table 22.  Combined Effect of Extended Pick Settings

Business Component Setting HandheldSyncPickMode=	Configuration File Setting DefaultHandheldSyncPickMode=
	NoFail	FailOnError	No Setting in .cfg file
NoFail	NoFail	NoFail	NoFail
FailOnError	FailOnError	FailOnError	FailOnError
No Setting on Business Component	NoFail	FailOnError	FailOnError

Recommended Extended Pick Processing Settings

It is recommended that you use the Extended Pick processing settings in the following way:

Turn Extended Pick processing off globally. This is specified in the configuration (.cfg) file.
Activate Extended Pick processing on the following fields for critical business components:
Pharma Professional Call - CE. Last Name|NoFail, Address|NoFail, Contact Id|NoFail, Contact Address Id|NoFail
Pharma Call Products Detailed - CE. Name|NoFail
Pharma Call Sample Dropped - CE. Name|NoFail, Lot Name|NoFail
Pharma Account Call - CE. Account Name|NoFail, Address|NoFail, Account Id|NoFail, Account Address Id|NoFail
Pharma Promotional Items Dropped - CE (Name). Name|NoFail

The ePharma Handheld application is shipped with these recommended settings.

NOTE:  When Extended Pick processing is enabled, any update conflicts that occur for that pick field are resolved using the "Client Wins" conflict resolution directive. For fields that do not have Extended Pick processing enabled or that are not pick fields, this does not apply. Please make a note of this behavior when using this feature.

Bookshelf Home | Contents | Index | Search | PDF