GetMultipleFieldValues Method for a Business Component

The GetMultipleFieldValues method returns a value for each field specified in a property set. It also returns the following information:

  • TRUE if it finds the fields.

  • FALSE if it does not find the fields.

For more information, see SetMultipleFieldValues Method for a Business Component.

Format

BusComp.GetMultipleFieldValues(fieldNamesPropSet, fieldValuesPropSet)

The following table describes the arguments for the GetMultipleFieldValues method.

Argument Description

fieldNamesPropSet

A property set that identifies a collection of fields.

fieldValuesPropSet

A property set that provides values for the fields specified in the fieldNamesPropSet argument.

Usage

You cannot use the same instance of a property set for the fieldNamesPropSet argument and for the fieldValuesPropSet argument.

Used With

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

Examples

The following example is in Siebel eScript:

try {

  var oPsDR_Header:PropertySet = TheApplication().NewPropertySet();

  // Cannot use the same property set in GetMultipleFieldValues, must use a different 
  // one for the values. The process will not error, but the values will not be placed 
  // in the property set.

  var lPS_values:PropertySet = TheApplication().NewPropertySet();

  oPsDR_Header.SetProperty("Last Name","");

  oPsDR_Header.SetProperty("First Name","");

  oPsDR_Header.SetProperty("Middle Name","");

  var boContact = TheApplication().GetBusObject("Contact");

  var bcContact = boContact.GetBusComp("Contact");

    with (bcContact) {

      ClearToQuery();

      SetViewMode(AllView);

      ActivateMultipleFields(oPsDR_Header);

      SetSearchSpec("Last Name", "Mead*");

      ExecuteQuery(ForwardOnly);

      var isParent = FirstRecord();

      do {

        // Use a different property set for the values. If you use the same one

        // for arguments you get no values back.

        GetMultipleFieldValues(oPsDR_Header, lPS_values);

        // Get the value from the output property set.

        TheApplication().Trace("Last Name = " +
        lPS_values.GetProperty("Last Name"));

        } while (NextRecord());

      } //end with

    } //end try

  catch(e) {

   TheApplication().Trace(e.toString());

  }//end catch