<li><p>Fix: <code><ahref="../reference/easy_redcap.html">easy_redcap()</a></code>: fixed to actually allow project naming. also specifically asks for uri.</p></li>
<li><p>Fix: <code><ahref="../reference/read_redcap_tables.html">read_redcap_tables()</a></code>: now handles non-longitudinal project without repeatable instruments.</p></li>
<li><p>NEW: <code><ahref="../reference/ds2dd_detailed.html">ds2dd_detailed()</a></code>: extension of the <code><ahref="../reference/ds2dd.html">ds2dd()</a></code>, which serves to preserve as much metadata as possible automatically. Depends on a group of helper functions also introduced. Of special note is the <code><ahref="../reference/guess_time_only_filter.html">guess_time_only_filter()</a></code>, which will try to guess which columns/variables should be formatted as time only formats. Supports hms time format. DETAILED INSTRUCTION AND VIGNETTE IS PENDING.</p></li>
<li><p>NEW: <code><ahref="../reference/read_redcap_instrument.html">read_redcap_instrument()</a></code> convenience function to retrieve complete instrument. Goes a little against the focused approach. DETAILED INSTRUCTION IS PENDING.</p></li>
<li><p>NEW: <code><ahref="../reference/ds2ical.html">ds2ical()</a></code> converts data set to ical format with easy glue string for summary and description. Export .ics file with <code><ahref="https://rdrr.io/pkg/calendar/man/ic_write.html"class="external-link">calendar::ic_write()</a></code>.</p></li>
<p>I believe <code>renv</code> has now been added and runs correctly. After clone, do <code><ahref="https://rstudio.github.io/renv/reference/restore.html"class="external-link">renv::restore()</a></code> to install all necessary package to modify the package.</p>
<h4id="whishes-before-cran-release-24-2-1">Whishes before CRAN release<aclass="anchor"aria-label="anchor"href="#whishes-before-cran-release-24-2-1"></a></h4>
<ul><li>Fix: <code><ahref="../reference/read_redcap_tables.html">read_redcap_tables()</a></code>: checking form names based on data dictionary to allow handling of non-longitudinal projects. Prints invalid form names and invalid event names. If invalid form names are supplied to <code><ahref="https://ouhscbbmc.github.io/REDCapR/reference/redcap_read.html"class="external-link">REDCapR::redcap_read()</a></code> (which is the backbone), all forms are exported, which is not what we want with a focused approach. Invalid event names will give an output with a rather peculiar formatting. Checking of field names validity is also added.</li>
<ul><li>New: <code><ahref="../reference/easy_redcap.html">easy_redcap()</a></code> function to ease the retrieval of a dataset with <code><ahref="../reference/read_redcap_tables.html">read_redcap_tables()</a></code> with <code>keyring</code>-package based key storage, which handles secure API set, storage and retrieval. Relies on a small helper function, <code><ahref="../reference/get_api_key.html">get_api_key()</a></code>, which wraps relevant <code>keyring</code>-functions. Includes option to cast the data in a wide format with flag <code>widen.data</code>.</li>
<li>Fix: <code><ahref="../reference/REDCap_split.html">REDCap_split()</a></code>: when using this function on its own, supplying a data set with check boxes would fail if metadata is supplied as a tibble. Metadata is now converted to data.frame. Fixed.</li>
<li>Fix: <code><ahref="../reference/read_redcap_tables.html">read_redcap_tables()</a></code>: fixed bug when supplying events.</li>
<ul><li><p>New: <code><ahref="../reference/ds2dd.html">ds2dd()</a></code> function migrating from the <code>stRoke</code>-package. Assists in building a data dictionary for REDCap from a dataset.</p></li>
<li><p>New: <code><ahref="../reference/strsplitx.html">strsplitx()</a></code> function to ease the string splitting as an extension of <code><ahref="https://rdrr.io/r/base/strsplit.html"class="external-link">base::strsplit()</a></code>. Inspiration from <ahref="https://stackoverflow.com/a/11014253/21019325"class="external-link uri">https://stackoverflow.com/a/11014253/21019325</a> and <ahref="https://www.r-bloggers.com/2018/04/strsplit-but-keeping-the-delimiter/"class="external-link uri">https://www.r-bloggers.com/2018/04/strsplit-but-keeping-the-delimiter/</a>.</p></li>
<li><p>New: <code>d2n()</code> function converts single digits to written numbers. Used to sanitize variable and form names in REDCap database creation. For more universal number to word I would suggest <code>english::word()</code> or <code><ahref="https://rdrr.io/pkg/xfun/man/numbers_to_words.html"class="external-link">xfun::numbers_to_words()</a></code>, though I have not been testing these.</p></li>
<p>To reflect new functions and the limitation to only working in R, I have changed the naming of the fork, while still, of course, maintaining the status as a fork.</p>
<p>The versioning has moved to a monthly naming convention.</p>
<p>The main goal this package is to keep the option to only export a defined subset of the whole dataset from the REDCap server as is made possible through the <code><ahref="https://ouhscbbmc.github.io/REDCapR/reference/redcap_read.html"class="external-link">REDCapR::redcap_read()</a></code> function, and combine it with the work put into the REDCapRITS package and the handling of longitudinal projects and/or projects with repeated instruments.</p>
<ul><li><p><code><ahref="../reference/read_redcap_tables.html">read_redcap_tables()</a></code><strong>NEW</strong>: this function is mainly an implementation of the combined use of <code>REDCapR::readcap_read()</code> and <code><ahref="../reference/REDCap_split.html">REDCap_split()</a></code> to maintain the focused nature of <code>REDCapR::readcap_read()</code>, to only download the specified data. Also implements tests of valid form names and event names. The usual fall-back solution was to get all data.</p></li>
<li><p><code><ahref="../reference/redcap_wider.html">redcap_wider()</a></code><strong>NEW</strong>: this function pivots the long data frames from <code><ahref="../reference/read_redcap_tables.html">read_redcap_tables()</a></code> using <code><ahref="https://tidyr.tidyverse.org/reference/pivot_wider.html"class="external-link">tidyr::pivot_wider()</a></code>.</p></li>
<li><p><code><ahref="../reference/focused_metadata.html">focused_metadata()</a></code><strong>NEW</strong>: a hidden helper function to enable a focused data acquisition approach to handle only a subset of metadata corresponding to the focused dataset.</p></li>
<ul><li>metadata handling <strong>IMPROVED</strong>: improved handling of different column names in matadata (DataDictionary) from REDCap dependent on whether it is acquired thorugh the api og downloaded from the server.</li>
</ul></div>
</div>
</main><asideclass="col-md-3"><navid="toc"><h2>On this page</h2>
</nav></aside></div>
<footer><divclass="pkgdown-footer-left">
<p></p><p>Developed by Andreas Gammelgaard Damsbo, Paul Egeler.</p>
</div>
<divclass="pkgdown-footer-right">
<p></p><p>Site built with <ahref="https://pkgdown.r-lib.org/"class="external-link">pkgdown</a> 2.0.7.</p>
