findAnswersByAssessment()
Returns individual form answers for a specific question scoped to a specific assessment cycle, optionally filtered by date range.
This is the answer-level equivalent of findResponsesByAssessment() — useful when you want to aggregate scores or values from a single question across all participants in a given review cycle.
Syntax
findAnswersByAssessment(question, assessment[, from][, until])
Parameters
Parameter | Type | Description |
|---|---|---|
question | StringString | Name or ID of the question/field to retrieve answers for |
assessment | StringString | Name or ID of the assessment cycle |
from | TimestampTimestamp | Starting point of the date range to traverse (inclusive) |
until | TimestampTimestamp | Ending point of the date range to traverse (exclusive) |
Return Type
ListList <FormAnswerFormAnswer>
Examples
findAnswersByAssessment('managerReviewRating', 'Q3 2024 Performance Review').mean{answerValue}
Returns the average manager review rating across all participants in the Q3 2024 cycle.
findAnswersByAssessment('managerReviewRating', 'Q3 2024 Performance Review').groupBy{target.department}.mean{answerValue}
Breaks down the average manager review rating by department for the specified cycle.