PcoCalendarTag class
This class represents a PCO Calendar Tag Object
- Application: calendar
- Id: tag
- Type: Tag
- ApiVersion: 2021-07-20
- Is Deprecated: false
- Is Collection Only: false
- Default Endpoint: https://api.planningcenteronline.com/calendar/v2/tags
- Create Endpoint: NONE
Instantiation
- This object cannot be created through the API.
- Instantiate from existing
JSON
data using thePcoCalendarTag.fromJson()
constructor. - Load an instance from the API using one of the static methods defined on this class.
Usage
- Fields exposed by the API are readable through getter methods.
- Fields writable by the API are exposed through setter methods.
- Original
json
data is exposed through the read-onlyattributes
map. - Additional data is available through the read-only
links
andrelationships
maps. - Available relationships / includes are exposed through typed getters.
Description
An organizational tag that can be applied to events.
Applied tags can be used to filter events on the calendar or filter events for reports, iCal feeds, kiosk, and the widget.
Attributes (and permissions)
id
(ro) -> PCO:id
color
(ro) -> PCO:color
createdAt
(ro) -> PCO:created_at
name
(ro) -> PCO:name
position
(ro) -> PCO:position
updatedAt
(ro) -> PCO:updated_at
Edges and Actions
Outbound Edges:
eventinstance-tag-event_instances
: https://api.planningcenteronline.com/calendar/v2/tags/1/event_instancesevent-tag-events
: https://api.planningcenteronline.com/calendar/v2/tags/1/eventstaggroup-tag-tag_group
: https://api.planningcenteronline.com/calendar/v2/tags/1/tag_group
Inbound Edges:
tag-eventinstance-tags
: https://api.planningcenteronline.com/calendar/v2/event_instances/1/tagstag-event-tags
: https://api.planningcenteronline.com/calendar/v2/events/1/tagstag-organization-tags
: https://api.planningcenteronline.com/calendar/v2/tagstag-taggroup-tags
: https://api.planningcenteronline.com/calendar/v2/tag_groups/1/tags
Actions: NONE
Raw Data Object Example
{
"type": "Tag",
"id": "1",
"attributes": {
"color": "string",
"created_at": "2000-01-01T12:00:00Z",
"name": "string",
"position": 1.42,
"updated_at": "2000-01-01T12:00:00Z"
},
"relationships": {}
}
- Inheritance
-
- Object
- PcoResource
- PcoCalendarTag
Constructors
-
PcoCalendarTag({String? id, String? color, DateTime? createdAt, String? name, double? position, DateTime? updatedAt, Map<
String, List< ? withRelationships, List<PcoResource> >PcoResource> ? withIncluded}) -
Create a new PcoCalendarTag object. This object cannot be created with the API
factory
- PcoCalendarTag.empty()
- Create an empty instance of this class. This is only useful when an endpoint requires related or included data.
-
PcoCalendarTag.fromJson(Map<
String, dynamic> data, {List<Map< ? withIncluded})String, dynamic> >
Properties
- api → PlanningCenter
-
planning center resources must be tied to an api
no setterinherited
- apiEndpoint → String
-
no setterinherited
- apiPath → String
-
PcoResources include their own path as a link object
but this might be null if we haven't created/fetched the object yet
Child classes should redefine this getter to allow for manual path overrides
no setteroverride
- apiVersion → String
-
child classes can override these getters which will allow
methods in this class to see static variables from child classes
no setteroverride
-
attributes
→ ReadOnlyMapView<
String, dynamic> -
contains the underlying attributes returned by the api
and allows a user to access arbitrary data in the attributes by actual api name
no setterinherited
- canCreate → bool
-
no setteroverride
- canDestroy → bool
-
no setteroverride
- canUpdate → bool
-
no setteroverride
- color → String
-
no setter
-
createAllowed
→ List<
String> -
no setteroverride
- createdAt → DateTime
-
no setterinherited
- createPathTemplate → String
-
no setteroverride
- defaultPathTemplate → String
-
no setteroverride
- fetched ↔ bool
-
indicate whether an item is full or partial
getter/setter pairinherited
- hashCode → int
-
The hash code for this object.
no setterinherited
- id → String?
-
no setterinherited
-
included
→ List<
PcoResource> -
contains included items parsed into objects
no setterinherited
- includedTagGroup → PcoCalendarTagGroup?
-
no setter
-
links
→ ReadOnlyMapView<
String, dynamic> -
contains the links data returned by the api if present
no setterinherited
- name → String
-
no setter
- needsSave → bool
-
no setterinherited
- pcoApplication ↔ String
-
latefinalinherited
- position → double
-
no setter
-
relationships
→ ReadOnlyMapView<
String, List< PcoResource> > -
contains relationships parsed into objects
even though the api sends relationship objects as Maps or Lists
we always put them into lists for consistency
no setterinherited
- resourceType ↔ String
-
all planning center resources must have a
type
latefinalinherited - runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- slug → String
-
no setterinherited
-
updateAllowed
→ List<
String> -
no setteroverride
- updatedAt → DateTime
-
no setterinherited
Methods
-
coerceDouble(
dynamic a) → double -
inherited
-
coerceInt(
dynamic a) → int -
inherited
-
delete(
) → Future< PlanningCenterApiResponse< PlanningCenterApiData> > -
inherited
-
filteredAttributes(
List< String> allowedKeys) → Map<String, dynamic> -
inherited
-
fromJson(
Map< String, dynamic> data, {List<Map< ? withIncluded}) → dynamicString, dynamic> > -
Takes a full JSON:API Response Object (the contents of a "data" field)
will clear and update id, apiPath, attributes and
_relationships
inherited -
getEventInstances(
{PcoCalendarEventInstanceQuery? query}) → Future< PcoCollection< PcoCalendarEventInstance> > -
Will get a collection of PcoCalendarEventInstance objects (expecting many)
using a path like this:
https://api.planningcenteronline.com/calendar/v2/tags/1/event_instances
-
getEvents(
{PcoCalendarEventQuery? query}) → Future< PcoCollection< PcoCalendarEvent> > -
Will get a collection of PcoCalendarEvent objects (expecting many)
using a path like this:
https://api.planningcenteronline.com/calendar/v2/tags/1/events
-
getTagGroup(
{PcoCalendarTagGroupQuery? query}) → Future< PcoCollection< PcoCalendarTagGroup> > -
Will get a collection of PcoCalendarTagGroup objects (expecting many)
using a path like this:
https://api.planningcenteronline.com/calendar/v2/tags/1/tag_group
-
handleIncludes(
List< Map< included) → voidString, dynamic> > -
This function populates the relationships with typed resource objects
based on the data in the
included
map of the json.inherited -
handleItem(
Map< String, dynamic> data) → PcoResource? -
inherited
-
handleRelationships(
Map< String, dynamic> items, [List<Map< included = const []]) → Map<String, dynamic> >String, List< PcoResource> > -
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
save(
{Map< String, PcoResource> ? withRelated, List<PcoResource> ? withIncluded}) → Future<PlanningCenterApiResponse< PlanningCenterApiData> > -
Many Planning Center endpoints allow or require additional relationships and/or included items
to be sent with a create/update operation. Since these cannot always be determined by the automatic
code generation, they may be included as arguments to the save operation.
inherited
-
toCreateResource(
) → Map< String, dynamic> -
create the attributes Map for this object without the
id
field using only the attributes allowed in create (post) operationsinherited -
toDataMap(
{Map< String, PcoResource> ? withRelated, List<PcoResource> ? withIncluded}) → Map<String, dynamic> -
create a json-api Map for this object automatically selecting create or update
based on the existence of the
id
field. Will result in something like this:inherited -
toIdResource(
) → Map< String, dynamic> -
returns the simplest representation of this resource with
only the type and the id:
inherited
-
toJson(
{dynamic includeAttributes = true, dynamic includeRelationships = false}) → Map< String, dynamic> -
Some api requests only want the type and id of an object.
In those cases, set
includeAttributes
to false or call toIdResource instead.inherited -
toString(
) → String -
A string representation of this object.
inherited
-
toUpdateResource(
) → Map< String, dynamic> -
create the attributes Map for this object using only
the attributes allowed in update (patch) operations
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Properties
-
canInclude
→ List<
String> -
possible includes with parameter ?include=a,b
no setter
-
canOrderBy
→ List<
String> -
possible orderings with parameter ?order=
no setter
-
canQuery
→ List<
String> -
possible queries using parameters like ?where
key
=value or ?wheregt|lt
=valueno setter
Static Methods
-
get(
{String? id, PcoCalendarTagQuery? query, bool getAll = false, bool includeTagGroup = false}) → Future< PcoCollection< PcoCalendarTag> > -
Will get a
PcoCollection
of PcoCalendarTag objects (expecting many) using a path like this:/calendar/v2/tags
-
getAll(
{String? id, PcoCalendarTagQuery? query, bool includeTagGroup = false}) → Future< PcoCollection< PcoCalendarTag> > -
Will get a
PcoCollection
containing ALL PcoCalendarTag objects (expecting many) using a path like this:/calendar/v2/tags
-
getAllFromEvent(
String eventId, {String? id, PcoCalendarTagQuery? query, bool includeTagGroup = false}) → Future< PcoCollection< PcoCalendarTag> > -
Will get a
PcoCollection
containing ALL PcoCalendarTag objects (expecting many) using a path like this:/calendar/v2/events/$eventId/tags
-
getAllFromEventInstance(
String eventInstanceId, {String? id, PcoCalendarTagQuery? query, bool includeTagGroup = false}) → Future< PcoCollection< PcoCalendarTag> > -
Will get a
PcoCollection
containing ALL PcoCalendarTag objects (expecting many) using a path like this:/calendar/v2/event_instances/$eventInstanceId/tags
-
getAllFromTagGroup(
String tagGroupId, {String? id, PcoCalendarTagQuery? query, bool includeTagGroup = false}) → Future< PcoCollection< PcoCalendarTag> > -
Will get a
PcoCollection
containing ALL PcoCalendarTag objects (expecting many) using a path like this:/calendar/v2/tag_groups/$tagGroupId/tags
-
getFromEvent(
String eventId, {String? id, PcoCalendarTagQuery? query, bool getAll = false, bool includeTagGroup = false}) → Future< PcoCollection< PcoCalendarTag> > -
Will get a
PcoCollection
of PcoCalendarTag objects (expecting many) using a path like this:/calendar/v2/events/$eventId/tags
-
getFromEventInstance(
String eventInstanceId, {String? id, PcoCalendarTagQuery? query, bool getAll = false, bool includeTagGroup = false}) → Future< PcoCollection< PcoCalendarTag> > -
Will get a
PcoCollection
of PcoCalendarTag objects (expecting many) using a path like this:/calendar/v2/event_instances/$eventInstanceId/tags
-
getFromTagGroup(
String tagGroupId, {String? id, PcoCalendarTagQuery? query, bool getAll = false, bool includeTagGroup = false}) → Future< PcoCollection< PcoCalendarTag> > -
Will get a
PcoCollection
of PcoCalendarTag objects (expecting many) using a path like this:/calendar/v2/tag_groups/$tagGroupId/tags
-
getSingle(
String id, {PcoCalendarTagQuery? query, bool includeTagGroup = false}) → Future< PcoCalendarTag?> -
Will get a single
PcoCalendarTag
object using a path like this:/calendar/v2/tags/[id]
-
getSingleFromEvent(
String eventId, String id, {PcoCalendarTagQuery? query, bool includeTagGroup = false}) → Future< PcoCalendarTag?> -
Will get a single
PcoCalendarTag
object using a path like this:/calendar/v2/events/$eventId/tags/[id]
-
getSingleFromEventInstance(
String eventInstanceId, String id, {PcoCalendarTagQuery? query, bool includeTagGroup = false}) → Future< PcoCalendarTag?> -
Will get a single
PcoCalendarTag
object using a path like this:/calendar/v2/event_instances/$eventInstanceId/tags/[id]
-
getSingleFromTagGroup(
String tagGroupId, String id, {PcoCalendarTagQuery? query, bool includeTagGroup = false}) → Future< PcoCalendarTag?> -
Will get a single
PcoCalendarTag
object using a path like this:/calendar/v2/tag_groups/$tagGroupId/tags/[id]
Constants
- kApiVersion → const String
- kColor → const String
- kCreatedAt → const String
- kCreatePathTemplate → const String
- kDefaultPathTemplate → const String
- kId → const String
- kName → const String
- kPcoApplication → const String
- kPosition → const String
- kTypeId → const String
- kTypeString → const String
- kUpdatedAt → const String