GiftDesignation

Represents a designation that can be assigned to a gift transaction. This object is available in API version 59.0 and later.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

Special Access Rules

This object is available only if the Fundraising Access license is enabled and the Fundraising User system permission is assigned to users.

Fields

AverageTransactionAmount

Type: currency
Properties: Create, Filter, Nillable, Sort, Update
Description: The average value of all paid gift transactions related to the related gift designation. Data Processing Engine calculates this value by dividing the gift designation’s total transaction amount by its total transaction count. You can schedule this calculation to run on a regular basis.

CurrentYearTransactionCount

Type: int
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The count of the current year’s paid transactions related to the related gift designation. Data Processing Engine calculates this value by counting the gift designation’s paid gift transactions with a transaction date in this calendar year. You can schedule this calculation to run on a regular basis.

CurrentYearTrxnAmount

Type: currency
Properties: Create, Filter, Nillable, Sort, Update
Description: The value of the current year’s paid transactions related to the related gift designation. Data Processing Engine calculates this value by adding the amounts of the gift designation’s paid gift transactions with a transaction date this calendar year. You can schedule this calculation to run on a regular basis.

Description

Type: textarea
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The description of the gift designation.

FirstPaidTransactionDate

Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date of the first paid gift transaction related to the related gift designation. Data Processing Engine calculates this value by finding the date of the first paid gift transaction related to the gift designation. You can schedule this calculation to run on a regular basis.

HighestTransactionAmount

Type: currency
Properties: Create, Filter, Nillable, Sort, Update
Description: The highest transaction value associated with the related gift designation. Data Processing Engine calculates this value by finding the amount of the largest paid gift transaction related to the gift designation. You can schedule this calculation to run on a regular basis.

IsActive

Type: boolean
Properties: Create, Defaulted on create, Filter, Group, Sort, Update
Description: Indicates if the gift designation is active (true) or not (false).
Default value: true

IsDefault

Type: boolean
Properties: Create, Defaulted on create, Filter, Group, Sort, Update
Description: Indicates whether the unrestricted gift amount is to be allocated to this designation as default (true) or not (false). There can only be a single designation with this set to true at a time.
Default value: false

LastPaidTransactionDate

Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date of the most recent paid gift transaction related to the related gift designation. Data Processing Engine calculates this value by finding the date of the most recent related paid gift transaction related to the gift designation. You can schedule this calculation to run on a regular basis.

LastReferencedDate

Type: dateTime
Properties: Filter, Nillable, Sort
Description: The timestamp when the current user last accessed this record indirectly, for example, through a list view or related record.

LastTwoYearTrxnAmount

Type: currency
Properties: Create, Filter, Nillable, Sort, Update
Description: The value of the gift transactions completed two calendar years ago related to the related gift designation. Data Processing Engine calculates this value by adding the amounts of all paid gift transactions related to the gift designation with a transaction date from two calendar years ago. You can schedule this calculation to run on a regular basis.

LastTwoYearTrxnCount

Type: int
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The count of gift transactions made two calendar years ago that are related to the related gift designation. Data Processing Engine calculates this value by counting all paid gift transactions related to the gift designation with a transaction date from two calendar years ago. You can schedule this calculation to run on a regular basis.

LastViewedDate

Type: dateTime
Properties: Filter, Nillable, Sort
Description: The timestamp when the current user last viewed this record or list view. If this value is null, and LastReferenceDate is not null, the user accessed this record or list view.

LastYearTransactionCount

Type: int
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The count of gift transactions related to the related gift designation and made last calendar year. Data Processing Engine calculates this value by counting all paid gift transactions related to the gift designation with a transaction date in the last calendar year. You can schedule this calculation to run on a regular basis.

LastYearTrxnAmount

Type: currency
Properties: Create, Filter, Nillable, Sort, Update
Description: The value of gift transactions related to the related gift designation and completed last calendar year. Data Processing Engine calculates this value by adding the amounts of all paid gift transactions related to the gift designation with a transaction date from the last calendar year. You can schedule this calculation to run on a regular basis.

LowestTransactionAmount

Type: currency
Properties: Create, Filter, Nillable, Sort, Update
Description: The value of the smallest paid transaction related to the related gift transaction. Data Processing Engine calculates this value by finding the smallest paid gift transaction amount related to the related gift designation. You can schedule this calculation to run on a regular basis.

Name

Type: string
Properties: Create, Filter, Group, idLookup, Sort, Update
Description: The name of the gift designation.

OwnerId

Type: reference
Properties: Create, Defaulted on create, Filter, Group, Sort, Update
Description: ID of the owner of this object.

This field is a polymorphic relationship field.
Relationship Name: Owner
Relationship Type: Lookup
Refers To: Group, User

TotalTransactionAmount

Type: currency
Properties: Create, Filter, Nillable, Sort, Update
Description: The total value of all gift transactions related to the related gift designation. Data Processing Engine calculates this value by adding the total amounts of all paid gift transactions related to the gift designation. You can schedule this calculation to run on a regular basis.

TotalTransactionCount

Type: int
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The count of all paid transactions related to the related gift designation. Data Processing Engine calculates this value counting the paid gift transactions related to the gift designation. You can schedule this calculation to run on a regular basis.

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

GiftDesignationChangeEvent (API Version 64.0): Change events are available for the object.
GiftDesignationFeed: Feed tracking is available for the object.
GiftDesignationHistory: History is available for tracked fields of the object.
GiftDesignationOwnerSharingRule (API Version 64.0): Sharing rules are available for the object.
GiftDesignationShare: Sharing is available for the object.