supplement_rxsTrees_from_txs.RdSometimes, 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")
)The parsed full Rxs project object, containing a list of Rxs trees.
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()).
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.
Whether to call explode_vector_to_values
if there are vectors among the added values.
Whether to the chatty or silent.
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.
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.