PcoPeopleFieldDatum constructor

PcoPeopleFieldDatum({
  1. required String personId,
  2. String? id,
  3. String? value,
  4. String? file,
  5. int? fileSize,
  6. String? fileContentType,
  7. String? fileName,
  8. String? fieldDefinitionId,
  9. Map<String, List<PcoResource>>? withRelationships,
  10. List<PcoResource>? withIncluded,
})

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

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: value, fieldDefinitionId
  • FIELDS USED WHEN UPDATING: value, fieldDefinitionId

Implementation

factory PcoPeopleFieldDatum(
    {required String personId,
    String? id,
    String? value,
    String? file,
    int? fileSize,
    String? fileContentType,
    String? fileName,
    String? fieldDefinitionId,
    Map<String, List<PcoResource>>? withRelationships,
    List<PcoResource>? withIncluded}) {
  var obj = PcoPeopleFieldDatum.empty();
  obj._id = id;
  obj._apiPathOverride =
      'https://api.planningcenteronline.com/people/v2/people/$personId/field_data';
  if (value != null) obj._attributes['value'] = value;
  if (file != null) obj._attributes['file'] = file;
  if (fileSize != null) obj._attributes['file_size'] = fileSize;
  if (fileContentType != null)
    obj._attributes['file_content_type'] = fileContentType;
  if (fileName != null) obj._attributes['file_name'] = fileName;
  if (fieldDefinitionId != null)
    obj._attributes['field_definition_id'] = fieldDefinitionId;

  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;
}