Dart

Populi Search People

See more Populi Examples

Demonstrates the Populi searchPeople task. Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // This example assumes the Chilkat API to have been previously unlocked.
  // See Global Unlock Sample for sample code.

  // First load the previously obtained API token.
  // See Get Populi Access Token for sample code showing how to get the API token.
  final xml = CkXml();
  xml.loadXmlFile('qa_data/tokens/populi_token.xml');
  final String accessKey;
  try {
    accessKey = xml.getChildContent('access_key');
  } on ChilkatException {
    print('Did not find the access_key');
    return;
  }

  final rest = CkRest();

  // Connect using TLS.
  // A single REST object, once connected, can be used for many Populi REST API calls.
  // The auto-reconnect indicates that if the already-established HTTPS connection is closed,
  // then it will be automatically re-established as needed.
  final bAutoReconnect = true;
  try {
    rest.connect('yourcollege.populi.co', 443, true, bAutoReconnect);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  rest.authorization = accessKey;

  rest.addQueryParam('task', 'searchPeople');
  rest.addQueryParam('search_term', 'Robert');
  rest.addQueryParam('limit', '10');

  final String responseBody;
  try {
    responseBody = rest.fullRequestFormUrlEncoded('POST', '/api/index.php');
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // We should expect a 200 response if successful.
  if (rest.responseStatusCode != 200) {
    print('Request Header: ');
    print(rest.lastRequestHeader);
    print('----');
    print('Response StatusCode = ${rest.responseStatusCode}');
    print('Response StatusLine: ${rest.responseStatusText}');
    print('Response Header:');
    print(rest.responseHeader);
    print('Response Body:');
    print(responseBody);
    return;
  }

  xml.loadXml(responseBody);
  print(xml.getXml());

  // Sample response:
  // Use this online tool to generate parsing code from sample XML: 
  // Generate Parsing Code from XML

  // <?xml version="1.0" encoding="UTF-8"?>
  //  <response>
  // 	<person>
  // 		<id>11111</id>
  // 		<first_name>Robert</first_name>
  // 		<last_name>McStudent</last_name>
  // 		<middle_name>Kensington</middle_name>
  // 		<preferred_name>Bobby</preferred_name>
  // 		<is_user>1</is_user>
  // 		<primary_email>r.mcstudent@myschool.edu</primary_email>
  // 	</person>
  // 	<person>
  // 		<id>2222</id>
  // 		<first_name>Robert</first_name>
  // 		<last_name>McBoardmember</last_name>
  // 		<middle_name/>
  // 		<preferred_name/>
  // 		<is_user>0</is_user>
  // 		<primary_email>robert@gmail.com</primary_email>
  // 	</person>
  // </response>

  var i = 0;
  var id = 0;
  var firstName = '';
  var lastName = '';
  var middleName = '';
  var preferredName = '';
  var isUser = 0;
  var primaryEmail = '';

  i = 0;
  final countI = xml.numChildrenHavingTag('person');
  while (i < countI) {
    xml.i = i;
    id = xml.getChildIntValue('person[i]|id');
    firstName = xml.getChildContent('person[i]|first_name');
    lastName = xml.getChildContent('person[i]|last_name');
    middleName = xml.getChildContent('person[i]|middle_name');
    preferredName = xml.getChildContent('person[i]|preferred_name');
    isUser = xml.getChildIntValue('person[i]|is_user');
    primaryEmail = xml.getChildContent('person[i]|primary_email');
    i++;
  }
}