Sometimes, you forget to extract one or more entities. In such cases, it can be more efficient to create a spreadsheet with the omitted entities and then add those into the existing full Rxs project object. For that purpose, the tabulated extraction spreadsheet (txs) format exists. This is a rectangular table with the following columns: source_identification_entity_id, source_identification_value, parent_entity_id, entity_id, and value.

supplement_rxsTrees_from_txs(
x,
txs_specs,
stopOnErrors = FALSE,
explode_vector_to_values = FALSE,
silent = metabefor::opts$get("silent") ) ## Arguments x The parsed full Rxs project object, containing a list of Rxs trees. txs_specs The txs specifications, as a link to a publicly readable Google spreadsheet, an Excel file (if you have openxlsx installed), an SPSS dataset (if you have haven installed), or a comma separated values file (which will be read with read.csv()). stopOnErrors Whether to throw an error or show a warning (or just use cat to show a message is silent = metabefor::opts$get("silent")) when encountering errors.

explode_vector_to_values

Whether to call explode_vector_to_values if there are vectors among the added values.

silent

Whether to the chatty or silent.

## Value

Invisibly, the full Rxs project object. Note that the Rxs trees will be changed in place given data.tree's pass-by-reference logic; so you can discard the result.

## Details

If source_identification_entity_id is empty (i.e. does not contain any non-whitespace characters), source_identification_value will be assumed to be the name of the relevant Rxs tree in the full Rxs project object.