readFields

The readFields function attempts to return fields that match all of the given filter. The specified attributes of the fields are returned for each matching field.

Results

The readFields function may return 1 or many field objects. See the documentation on the fieldObject for a list of the data fields that could potentially be returned.

Note: The data fields returned depend on the type of data you ask for in your request.

Syntax

fieldObject[] fields = bApi.readFields(filter fieldsFilter, pageNumber);

Parameters

Name Type Required Comments
filter fieldsFilter Yes The filter used to return only specific fields.
pageNumber int Yes Retrieves the next “batch” of objects as the value specified increases from 1. In order to obtain an entire set of objects for a given call, you should increase the number value assigned to pageNumber until no more objects are returned.
pageSize int No Allows you to set a limit for the page size in order to improve performance speed. If set, the pageSize minimum is 10 and the maximum is 5,000.

PHP Code Example

<?php
/**
 * This example will read the details of any fields in your account that have
 * the name 'name' in them (example: firstname, lastname).
 */
 
$client = new SoapClient('https://api.bronto.com/v4?wsdl', array('trace' => 1, 
                                 'features' => SOAP_SINGLE_ELEMENT_ARRAYS));
 
try {
  $token = "YOUR_TOKEN_HERE";
 
  print "logging in\n";
  $sessionId = $client->login(array('apiToken' => $token))->return;
 
  $session_header = new SoapHeader("http://api.bronto.com/v4",
                   'sessionHeader',
                   array('sessionId' => $sessionId));
  $client->__setSoapHeaders(array($session_header));
 
 
  // filter on fields that contain 'name'
  $filter = array('name' => array('operator' => 'Contains',
                  'value' => 'name',
                   ),
          );
 
  print "reading all fields that contain the string 'name'\n";
  $fields = $client->readFields(array('pageNumber' => 1,
                    'filter' => $filter,
                    )
                  )->return;
 
  // print matching results
  foreach ($fields as $field) {
    print "Field name: " . $field->name . "; type: " . $field->type . "\n";
  }
 
} catch (Exception $e) {
  print "uncaught exception\n";
  print_r($e);
}