Skip to content

REDCap External Module to enable project users to switch between any number of the project's Data Access Groups (and/or "No assignment")

License

Notifications You must be signed in to change notification settings

lsgs/redcap-dag-switcher

Repository files navigation


DAG Switcher

Luke Stevens, Murdoch Children's Research Institute https://www.mcri.edu.au


Summary

Enable project users to switch between any number of Data Access Groups (and/or "No Assignment"):

  • Adds a table of users/DAGs to the DAGs page so users with DAG permission may enable and disable specific DAGs for each project user (except super users).
  • For users with multiple DAGs enabled, adds a display of a user's current DAG assignment in a box at the top of pages where records may be viewed (e.g. Dashboard, Export, Import, but not Project Home or Setup, or where a specific record is selected: Record Home or an Instrument).
  • Next to the display of the user's current DAG is a button that opens a dialog where the user may select an alternative DAG from those that are enabled for them (not available when a specific record is selected). Nb. Super users always see all records: DAG switching is not applicable.
  • The User Rights page indicates alongside each user's current DAG where other DAGs are enabled for the user.
  • Enables user with DAG permission to remove him or herself from a DAG, which is not possible using standard REDCap functionality.
  • From v1.1.0 it is possible to switch DAGs using an API call. Post 'token' and 'dag' (id or unique name) to your regular system API endpoint, using the following query string: ?NOAUTH&type=module&prefix=dag_switcher&page=user_dag_switch_api E.g. curl -d "token=ABCDEF0123456789ABCDEF0123456789&dag=site_a" "https://redcap.ourplace.edu/api/?NOAUTH&type=module&prefix=dag_switcher&page=user_dag_switch_api"