module_teal_data: Execute and validate 'teal_data_module'

In teal: Exploratory Web Apps for Analyzing Clinical Trials Data

Execute and validate teal_data_module

Description

This is a low level module to handle teal_data_module execution and validation. teal_transform_module() inherits from teal_data_module() so it is handled by this module too. srv_teal() accepts various data objects and eventually they are all transformed to reactive teal.data::teal_data() which is a standard data class in whole teal framework.

Usage

ui_teal_data_module(id, data_module = function(id) NULL)

srv_teal_data_module(
  id,
  data_module = function(id) NULL,
  modules = NULL,
  validate_shiny_silent_error = TRUE,
  is_transform_failed = reactiveValues()
)

ui_validate_reactive_teal_data(id)

srv_validate_reactive_teal_data(
  id,
  data,
  modules = NULL,
  validate_shiny_silent_error = FALSE,
  hide_validation_error = reactive(FALSE)
)

Arguments

id	(character(1)) shiny module instance id.
data_module	(teal_data_module)
modules	(teal_modules or teal_module) For datanames validation purpose
validate_shiny_silent_error	(logical) If TRUE, then shiny.silent.error is validated and
is_transform_failed	(reactiveValues) contains logical flags named after each transformator. Help to determine if any previous transformator failed, so that following transformators can be disabled and display a generic failure message.
data	(teal_data, teal_data_module, or reactive returning teal_data) The data which application will depend on.

Value

reactive teal_data

data validation

Executed teal_data_module() is validated and output is validated for consistency. Output data is invalid if:

1. teal_data_module() is invalid if server doesn't return reactive. Immediately crashes an app!

2. reactive throws a shiny.error - happens when module creating teal.data::teal_data() fails.

3. reactive returns qenv.error - happens when teal.data::teal_data() evaluates a failing code.

4. reactive object doesn't return teal.data::teal_data().

5. teal.data::teal_data() object lacks any datanames specified in the modules argument.

teal (observers in srv_teal) always waits to render an app until reactive teal_data is returned. If error 2-4 occurs, relevant error message is displayed to the app user. Once the issue is resolved, the app will continue to run. teal guarantees that errors in data don't crash the app (except error 1).

Note

ui_teal_data_module was renamed from ui_teal_data.

srv_teal_data_module was renamed from srv_teal_data.

teal documentation built on Aug. 21, 2025, 5:58 p.m.