Siebel Object Interfaces Reference > Interfaces Reference > Business Component Methods >

Pick Method

The Pick method places the currently selected record in a picklist business component into the appropriate fields of the parent business component.

NOTE:  Pick cannot be used to change the record in a read-only picklist field.

Syntax

BusComp.Pick

Returns

Not applicable

Usage

Pick must be invoked on the picklist's business component. When a record is picked on a constrained picklist using the GetPickListBusComp and Pick methods, the constraint is active. Therefore, only records that fulfill the constraint can be retrieved.

Used With

COM Data Control, COM Data Server, Java Data Bean, Mobile Web Client Automation Server, Server Script

Example

This Siebel VB example sorts the values in the Sales Stage field:

Sub BusComp_NewRecord
   Dim oBC as BusComp
   set oBC = me.GetPickListBusComp("Sales Stage")

   With oBC
      .ClearToQuery
      .SetSearchSpec "Sales Stage", "2 - Qualified"
      .ExecuteQuery ForwardOnly
      if .FirstRecord then .Pick
   End With

   set oBC = Nothing
End Sub

The following is the equivalent example in Siebel eScript:

function BusComp_NewRecord ()
{
   var oBC = this.GetPickListBusComp("Sales Stage");
   with (oBC)
   {
      ClearToQuery();
      SetSearchSpec("Sales Stage", "2 - Qualified");
      ExecuteQuery(ForwardOnly);
      if (FirstRecord())
         Pick();
   }
   oBC = null;
}

Related Topic

GetPicklistBusComp Method