Difference between revisions of "Aggregate Functions"

From LongJump Support Wiki
imported>Aeric
imported>Aeric
Line 1: Line 1:
__TOC__
===Overview===
These functions give you the ability to select a group of records from an arbitrary object and
These functions give you the ability to select a group of records from an arbitrary object and
produce an aggregate value (SUM, COUNT, MAX, MIN, AVG), without having to write Java code.
produce an aggregate value (SUM, COUNT, MAX, MIN, AVG), without having to write Java code.
 
<span id="SUM"/><span id="AVG"/><span id="MAX"/><span id="MIN"/><span id="COUNT"/>
===Functionality===
:{| border="1" cellpadding="5" cellspacing="1"
:{| border="1" cellpadding="5" cellspacing="1"
! Methods !! Field Types
! Methods !! Field Types
|-
|-
| SUM(<em>object_id, object_field, criteria</em>) || number, currency, boolean
| SUM(object_id, object_field, criteria</em>) || number, currency, boolean
|-
|-
| AVG(<em>object_id, object_field, criteria</em>) || number, currency, boolean
| AVG(object_id, object_field, criteria</em>) || number, currency, boolean
|-
|-
| MAXIMUM(<em>object_id, object_field, criteria</em>) || number, currency, date
| MAXIMUM(object_id, object_field, criteria</em>) || number, currency, date
|-
|-
| MINIMUM(<em>object_id, object_field, criteria</em>) || number, currency, date
| MINIMUM(object_id, object_field, criteria</em>) || number, currency, date
|-
|-
| COUNT(<em>object_id, criteria</em>) || n/a
| COUNT(object_id, criteria) || n/a
|}
|}
where:
where:
Line 36: Line 33:
the entire set of records in an [[Object]], regardless of user capabilities.}}
the entire set of records in an [[Object]], regardless of user capabilities.}}


===Availability===
;Availability:


The Aggregate Functions are available here:
The Aggregate Functions are available here:

Revision as of 20:21, 10 February 2012

These functions give you the ability to select a group of records from an arbitrary object and produce an aggregate value (SUM, COUNT, MAX, MIN, AVG), without having to write Java code.

Methods Field Types
SUM(object_id, object_field, criteria) number, currency, boolean
AVG(object_id, object_field, criteria) number, currency, boolean
MAXIMUM(object_id, object_field, criteria) number, currency, date
MINIMUM(object_id, object_field, criteria) number, currency, date
COUNT(object_id, criteria) n/a

where:

  • object_id - Object Name or Object Identifier
  • object_field - Field in the specified object
Restriction: A Lookup field cannot be used.
  • criteria: - A condition that specifies the object records that are part of the collection.
  • Syntax is same as searchRecords() API of JAVA/REST criteria

The relevant information is here (only the page title is inappropriate): JAVA_API:Filter_Expressions_in_JAVA_APIs

  • Criteria must contain at least one index field. If index is combination of fields, the criteria must contain first field in that index. (It does not need to be a unique index, but an index is required, for performance.)
Note: The maximum number indexes currently allowed in an index definition is 5.
Considerations
  • The SUM() of a boolean field gives a count of values that are yes/true.
  • The AVG() of a boolean field gives the percentage that are yes/true.

Notepad.png

Note: The results doenot take into account user-security restrictions. These functions operate on the entire set of records in an Object, regardless of user capabilities.

Availability

The Aggregate Functions are available here:

  • Validations
  • Data Policies
  • Criteria (Action Based - Add, Updae, Delete, Import Record, Ownership Change, Workflow State Change)
  • Add/Update Record Action
  • Calendar Data Policies - Criteria Not Support
  • Calendar Data Policies - Add/Update Record Actions Aggregate functions will be evaluated.
  • Default Values
  • Formula Fields

They are not available here:

  • Layout Rules
  • Custom Access Criteria
  • Reports