PcoPeopleEmail constructor

PcoPeopleEmail({
  1. required String personId,
  2. String? id,
  3. String? address,
  4. String? location,
  5. bool? isPrimary,
  6. DateTime? createdAt,
  7. DateTime? updatedAt,
  8. bool? isBlocked,
  9. Map<String, List<PcoResource>>? withRelationships,
  10. List<PcoResource>? withIncluded,
})

Create a new PcoPeopleEmail object using this endpoint: https://api.planningcenteronline.com/people/v2/people/$personId/emails

NOTES:

  • Creating an instance of a class this way does not save it on the server.
  • Call save() on the object to save it to the server.
  • Only set the id field if you know what you are doing. Save operations will overwrite data when the id is set.
  • Dummy data can be supplied for a required parameter, but if so, .save() should not be called on the object
  • FIELDS USED WHEN CREATING: address, location, isPrimary
  • FIELDS USED WHEN UPDATING: address, location, isPrimary

Implementation

factory PcoPeopleEmail(
    {required String personId,
    String? id,
    String? address,
    String? location,
    bool? isPrimary,
    DateTime? createdAt,
    DateTime? updatedAt,
    bool? isBlocked,
    Map<String, List<PcoResource>>? withRelationships,
    List<PcoResource>? withIncluded}) {
  var obj = PcoPeopleEmail.empty();
  obj._id = id;
  obj._apiPathOverride =
      'https://api.planningcenteronline.com/people/v2/people/$personId/emails';
  if (address != null) obj._attributes['address'] = address;
  if (location != null) obj._attributes['location'] = location;
  if (isPrimary != null) obj._attributes['primary'] = isPrimary;
  if (createdAt != null)
    obj._attributes['created_at'] = createdAt.toIso8601String();
  if (updatedAt != null)
    obj._attributes['updated_at'] = updatedAt.toIso8601String();
  if (isBlocked != null) obj._attributes['blocked'] = isBlocked;

  if (withRelationships != null) {
    for (var r in withRelationships.entries) {
      obj._relationships[r.key] = r.value;
    }
    obj._hasManualRelationships = true;
  }

  if (withIncluded != null) {
    obj._included.addAll(withIncluded);
    obj._hasManualIncluded = true;
  }

  return obj;
}