Siebel Consumer Goods Handheld Guide > Siebel Handheld Application Administration > Setting Up Users in Siebel Handheld Applications >

About Business Component Filters

Business component filters are used in some cases to restrict the size of extractions that otherwise might be excessive. They suppress the extraction of business component records. Use business component filters with discretion because excessive filtering can cause server data integrity problems.

Business component filters can be specified at either the application level or the user level, but not at the component level. They must not be specified at the user level outside of your test environment, and when tested they must be migrated to the application level.

If you are configuring synchronization for Handheld applications, a suggested practice, is to start with no business component filters at all. Attempt a synchronization and even if it fails due to excessive data extraction volumes, view the extraction results to determine the business components for which the data extraction was excessive. If any business component extraction is found to be excessive, you can reduce the extraction by adjusting the existing search specs specified in Siebel Tools (applets and business components), or Handheld application settings (for example, in DefaultBusObj), and selection filters (business object filters). If nothing else works, a business component filter can be used to force a reduction in the result set for a particular business component.

Setting Business Component Filters for Siebel Handheld Application Users

The Business Components Filters view tab in the Application Administration view contains the synchronization filter settings for business components. If you wish to add or remove business component filter settings for users, you do so in this view.

To add a business component filter setting

1. Navigate to the Administration - Mobile screen, then the Application Administration view.
2. In the Handheld Applications list, select the appropriate application, then click the Business Component Filters view tab.
3. Click New, then enter the required information.

   Some fields in the Business Component Filters view are described in the following table:

   Field	Comments
   Owner	Read only. Contains the Handheld application to which the business component will be associated. For example, Siebel <Application name> for CE.
   Business Component	A text box. Enter the business component name.
   Name	A text box. Enter the business component filter name. For example, Filter 1.
   Query	A text box. Enter the syntax for the query. For example, [Start Date] <=Today() For more information about developing queries, see Data Filtering for Siebel Handheld Applications

To remove a business component filter setting

1. Navigate to the Administration - Mobile screen, then the Application Administration view.
2. In the Handheld Applications list, select the appropriate application, then click the Business Component Filters view tab.
3. Select the filter setting record you wish to remove.
4. From the Business Component Filters menu, choose Delete Record.