getFromServiceTypeAndPlan static method

Future<PcoCollection<PcoServicesItem>> getFromServiceTypeAndPlan(String serviceTypeId, String planId, { String? id, PcoServicesItemQuery? query, bool getAll = false, bool includeAllRelated = false, bool includeArrangement = false, bool includeItemNotes = false, bool includeItemTimes = false, bool includeKey = false, bool includeMedia = false, bool includeSelectedAttachment = false, bool includeSong = false, })

Will get a PcoCollection of PcoServicesItem objects (expecting many) using a path like this: /services/v2/service_types/$serviceTypeId/plans/$planId/items

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<PcoServicesItem>> getFromServiceTypeAndPlan(
  String serviceTypeId,
  String planId, {
  String? id,
  PcoServicesItemQuery? query,
  bool getAll = false,
  bool includeAllRelated = false,
  bool includeArrangement = false,
  bool includeItemNotes = false,
  bool includeItemTimes = false,
  bool includeKey = false,
  bool includeMedia = false,
  bool includeSelectedAttachment = false,
  bool includeSong = false,
}) async {
  query ??= PcoServicesItemQuery();
  if (getAll) query.getAll = true;
  if (includeAllRelated) query.include.addAll(PcoServicesItem.canInclude);
  if (includeArrangement) query.include.add('arrangement');
  if (includeItemNotes) query.include.add('item_notes');
  if (includeItemTimes) query.include.add('item_times');
  if (includeKey) query.include.add('key');
  if (includeMedia) query.include.add('media');
  if (includeSelectedAttachment) query.include.add('selected_attachment');
  if (includeSong) query.include.add('song');
  var url = '/services/v2/service_types/$serviceTypeId/plans/$planId/items';
  if (id != null) url += '/$id';
  return PcoCollection.fromApiCall<PcoServicesItem>(url,
      query: query, apiVersion: kApiVersion);
}