Skip to contents

List DiGA device definitions

Usage

diga_device_definitions(
  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 device definition and columns:

resourceType

Character. FHIR resource type, always "DeviceDefinition".

id

Character. FHIR resource identifier.

url

Character. Canonical URL of the resource.

status

Character. Publication status.

description

Character. Device description text.

meta

List. Resource metadata (profile, timestamps).

identifier

List. Business identifiers.

type

List. Device type coding.

deviceName

List. Device name entries.

property

List. Device properties.

extension

List. FHIR profile extensions.

Examples

if (FALSE) dig_device_definitions() # \dontrun{}