Carrot reference
Functions

findFormTasks()

Returns form-completion Tasks related to a particular Form.

This is particularly useful for reporting on completion rates.

Syntax

findFormTasks(form[, from][, until])

Parameters

Parameter

Type

Description

form

String

Name or ID of the form

from

Timestamp

Starting point of the date range to traverse (inclusive)

until

Timestamp

Ending point of the date range to traverse (exclusive)

Return Type

List <Task>

Examples

findFormTasks('1:1 Form', '-30d').countPercent{status:done}

Returns the percentage of 1:1 Form Tasks that have been completed in the past 30 days.

findFormTasks('Manager Review', '2024-01-01', '2025-01-01').count()

Returns the number of Manager Review Form Tasks that were assigned in the 2024 calendar year.