Get Form Completion Status — get_form_completion_status • sardine

Gets the completion status for specific forms across all participants, useful for identifying which participants need follow-up.

Usage

get_form_completion_status(
  project,
  forms,
  event = NULL,
  status = c("complete", "incomplete", "not_started", "unverified")
)

Arguments

project: A redcap_project object
forms: Character vector of form names to check
event: Character. Event name for longitudinal projects (default: NULL)
status: Character vector. Which statuses to include: "complete", "incomplete", "not_started", "unverified". Default is all statuses.

Value

A data frame with participant IDs and their completion status for each form

Examples

if (FALSE) { # \dontrun{
project <- redcap_project()

# Get all completion statuses
completion <- get_form_completion_status(
  project,
  forms = c("demographics", "baseline_survey")
)

# Only incomplete forms (for follow-up)
incomplete <- get_form_completion_status(
  project,
  forms = c("follow_up_1", "follow_up_2"),
  status = c("incomplete", "not_started")
)
} # }