Skip to contents

List DiGA questionnaires

Usage

diga_questionnaires(
  params = list(),
  safe = TRUE,
  refresh = FALSE,
  flatten = FALSE,
  flatten_mode = "json"
)

Arguments

params

Named list of FHIR search parameters:

_count

Maximum bundle size per request (integer, default 1000).

_profile

FHIR profile URL used to restrict resource type (character).

safe

Logical; if TRUE (default), apply rate-limiting and cache GET responses to tools::R_user_dir("bunddev", "cache").

refresh

Logical; if TRUE, ignore cached responses and re-fetch from the API (default FALSE).

flatten

Logical; if TRUE, simplify nested list columns according to flatten_mode. Default FALSE keeps list columns as-is.

flatten_mode

How to handle list columns when flatten = TRUE:

"drop"

Remove list columns entirely. Use when nested data is not needed.

"json"

Convert each list element to a JSON string. Preserves all data in a text-queryable format. This is the default.

"unnest"

Expand list columns into multiple rows via tidyr::unnest_longer(). Warning: this can significantly increase the number of rows.

Value

A tibble with one row per questionnaire and columns:

resourceType

Character. FHIR resource type, always "Questionnaire".

id

Character. FHIR resource identifier.

url

Character. Canonical URL of the resource.

status

Character. Publication status.

name

Character. Computer-friendly name.

title

Character. Human-readable title.

meta

List. Resource metadata (profile, timestamps).

identifier

List. Business identifiers.

item

List. Questionnaire items and groups.

extension

List. FHIR profile extensions.