getFromPerson static method
Will get a PcoCollection
of PcoPeopleFieldDatum objects (expecting many)
using a path like this: /people/v2/people/$personId/field_data
Getting a PcoCollection
is useful even when retrieving a single object
because it contains error data and helper functions.
Additional options may be specified by using the query
argument, but some
query options are also available as boolean flags in this function call too.
Implementation
static Future<PcoCollection<PcoPeopleFieldDatum>> getFromPerson(
String personId, {
String? id,
PcoPeopleFieldDatumQuery? query,
bool getAll = false,
bool includeAllRelated = false,
bool includeFieldDefinition = false,
bool includeFieldOption = false,
bool includeTab = false,
}) async {
query ??= PcoPeopleFieldDatumQuery();
if (getAll) query.getAll = true;
if (includeAllRelated) query.include.addAll(PcoPeopleFieldDatum.canInclude);
if (includeFieldDefinition) query.include.add('field_definition');
if (includeFieldOption) query.include.add('field_option');
if (includeTab) query.include.add('tab');
var url = '/people/v2/people/$personId/field_data';
if (id != null) url += '/$id';
return PcoCollection.fromApiCall<PcoPeopleFieldDatum>(url,
query: query, apiVersion: kApiVersion);
}