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.