Permissions: Users must have the Data Central and Study Configure privileges to configure a study in Data Central.
Before a study can be accessed within Data Central, it must be configured.
Types of Studies that Integrate with Data Central
-
EDC Study with Two-way Query Information
elluminate can pull in ODM data from the EDC systems, including query information. In addition to data review, for these studies Data Central supports management of the queries (Create, Answer, Close, Cancel, Requery) and provides the ability to communicate directly back to the EDC for any action taken on a query.
Supported two-way EDCs: Rave, InForm, and Veeva. -
EDC Study with One-way Query Information
The Data Central module can provide query information for users to review from studies from EDC systems whose query information can be mapped into the elluminate Queries table. However, Data Central does not currently support communication back to the EDC of query actions such as Create, Answer, and Close.
-
EDC Study with No Available Query Information
For these types of studies, when using Data Central, the user will not see any reference to Queries, but will be able to perform full review of the data and raise and process issues.
Study Configuration Assumptions
Before configuring a Data Central study, assumptions are made about the study's elluminate configuration. Expand any of the items below for more details:
-
Rave EDC Studies:
- Rave is being developed by eClinical Solutions (preferred, but not mandatory)
- Rave study exists and has data
- Clinical data are available through Biostats Gateway
- Operational data are available through ODM Adaptor
- Incremental data loads are available (not mandatory)
-
Rave Data Sources
- URL for Biostats Gateway and Rave ODM Adaptor imports
- Rave username for Biostats Gateway and Rave ODM Adaptor access through RWS
- Rave remote study name
- Rave environment name
- Current CRF version
-
Rave Access
- An available RWS account (e.g., ECLIN_RWS1, etc.)
- This account is for user access to Rave for processing queries, which must be done through an account that has Rave Web Services access; an iMedidata account will not work. The RWS account can be the same as the one used for Biostats Gateway and ODM Adaptor, but does not have to be.
- The elluminate Audit Log contains the required data to track activity between elluminate and Rave.
- Rave user name(s) and password(s)
- An available RWS account (e.g., ECLIN_RWS1, etc.)
-
non-Rave EDC Studies:
- The study exists and has clinical data
- Operational data are available (not mandatory)
- Query data, if available, have been mapped to Data Central internal requirements
- Incremental data loads are available (not mandatory)
Configure Data Central Studies
From the Platform Menu, select Data Central Studies under Data Review. The Data Central landing page displays a study card for each study for which Data Central is enabled.
Studies that have not yet been configured for Data Central are identified with the red triangle next to the study name, and the study name is in black text and not a hyperlink. For these studies, click the red triangle, or the gear icon and select Data Central Configuration. This opens the Data Central Configuration window.
The study name for studies that are already configured for Data Central are in blue text and a hyperlink to the Data Central study landing page.
To edit a configuration item of a study already configured, click the gear icon in the study card and select Data Central Configuration.
Overview
The first Configuration view is the Overview. This provides an overview of the status of all configurable items. As items are configured, the view of the Overview will change.
Upon initial configuration of Data Central, sections will have an alert icon indicating configuration is required. The sections can be accessed by clicking the hyperlinked item next to the alert icon, or from the left navigation. After a section has been configured a green checkmark displays next to the configuration item.
Assign Reviewer Roles
Users are assigned Reviewer Roles that dictate the actions they can perform in Data Central: Read Only, Data Manager, Medical Data Reviewer, and Medical Coder. By default, all users are set to Read Only.
Note: The ability to add additional roles is available. Your Project Manager can guide you through this process.
- Read Only (RO): Access all Data Central screens, but cannot mark data as reviewed or create and manage queries. To support collaboration, Read Only users can add comments and create issues. Users will automatically default to Read Only.
- Data Manager (DM): Full Data Central functionality, including the ability to mark data as reviewed and create and answer Rave EDC queries. For Rave studies, permissible query activity for each marking group is defined in the Role Configuration.
- Medical Coder (MC): Same scope of access and activity as DM, but permissible query actions are separately configurable for each marking group.
- Medical Data Reviewer (MDR): Same scope of access and activity as DM, but permissible query actions are separately configurable for each marking group.
Important: Remember that access to Data Central, as well as the ability to mark data as reviewed and process EDC queries, is controlled via privileges in User Management. All users with the Data Central privilege for an active study, including unlicensed users, will appear in the Reviewer Roles list.
Also, if Clean Participant Tracking is enabled, ensure that the appropriate roles are assigned.
The first time you access Reviewer Roles, or if a user has been added, a message briefly displays, showing the number of newly added users who may not have been configured, and whom action may be required.
- Click Reviewer Roles. A listing displays with users assigned to the study. By default, users are initially assigned the Read Only role.
- Check the box(es) at the left of the username(s) to be updated.
- Select the Role by clicking the associated radio button. Choose from Read Only (the default), Data Manager, Medical Coder, Medical Data Reviewer, or other custom roles (if added).
- Check Receives Role Notifications to send email notifications to the selected user(s) when a role is assigned an action (query or issue). Alternatively, check the box in the Notifications column.
- Click Save in the top right corner. A confirmation popup displays.
Important: If changes are made and not saved before moving to another configuration item, a warning displays. Click Cancel to remain on the page and save the changes, or click Continue and the changes to the Reviewer Roles are not saved.
Configure Review Plan
For details on configuring the Review Plan, see the help article within the Data Central section, Configure the Integrated Data Review Plan (IDRP) in Data Central.
Configure Subjects Listing
Use Subjects Listing settings to identify the data store and domain containing key subject information, the columns for the Subjects listing, and the fields for the Subject Details (single-record) window. For non-Rave studies, optionally identify a subject status field. Also, enable and configure the Subjects listing as a Clean Participant Tracker.
- Click Subjects Listing in the left navigation (or the hyperlink in the Overview window).
- Select the Domain from the drop-down list of available data stores and domains containing the subject information to be used by Data Central. For example, the DM (demographics) domain, a domain created in Mapper that includes fields from several domains, or a mapping specifically for the Clean Participant Tracker may be chosen.
- Select the Subject Identifier Field (that uniquely identifies a subject) from the drop-down list of variables within the selected domain.
- Select the Site Identifier Field (that uniquely identifies a site) from the drop-down list of variables within the selected domain.
- Append Default Rave Status: If the domain selected does not include a Status field, this checkbox becomes available after Query Settings have been configured. If the Status field is included in the mapped Domain (selected in the Domain field), you may choose not to select the 'Append Default Rave Status' checkbox.
-
Select fields to display in Subjects Listing: These are the columns included in the Subjects listing. Search by typing; matching fields will appear. Select all or select fields individually. The following columns display by default, but additional columns can be added:
- [Reviewer Role] Records to Review
- Reviewer Roles with >1 user assigned and >1 Data Review settings configured
- Open / In Progress (if enabled) Issues
- Answered Issues
- Open Queries (displays for studies with query information imported from the EDC)
- Answered Queries
- Subject
- Site
- Status (When not a Rave study, and a Subject Status field has not been identified, this column will not display.)
- [Reviewer Role] Records to Review
- Select fields to display in Subject Details: These are the fields included in the Subject Details (single-record view). Search by typing; matching fields will appear. Select all or select fields individually.
- Toggle Enable Subjects Listing to include Clean Status to enable the Clean Participant Tracker.
- Select the Subject Status Field from the drop-down list to identify the subject's status. This field must be one of those selected for display in the Subjects Listing (Step 6). For Rave studies, the 'Append Default Rave Status' (Step 5) may be selected instead. A selected subject status field is required for Clean Participant Tracker visualizations to display properly.
- Select the Group Assignment Field from the drop-down list to identify the cohort or group assignment. This field must be one of those selected for display in the Subjects Listing (Step 6). A selected group assignment field is required for Clean Participant Tracker visualizations to display properly.
-
System Fields: Select to include in calculation of Clean Status.
- Queries and Issues: Select the query and issue statuses to include.
- Reviewer Roles: Select the reviewer roles to include.
- Domain Fields: Select the numeric fields to be used in the calculation.
- Click Save.
Configure Data Review Settings
Use Data Review Settings to specify which data stores will be available in Data Central, how the data will appear, and which domains are designated for data review. This can be assigned by role. Identify default Subject ID, Site ID, and Visit ID fields for each data store, any overrides for specific domains, and any hidden domains.
- Click Data Review in the left navigation (or the hyperlink from the Overview window). The list of Data Stores displays below Data Review.
-
Select the Data Store for Related Forms from the drop-down list of data stores that contains the clinical data from the EDC source.
-
Click a data store shown below Data Review in the left navigation to be configured for data review. For example, Clinical.
-
Default Identifiers tab
- Select the Subject ID from the drop-down, the field that contains the subject identifier within the domain.
- Select the Site ID from the drop-down, the field that contains the site identifier within the domain.
- Optionally, select the Visit ID from the drop-down, the field that contains the visit identifier within the domain. If selected, the Visit ID will automatically populate in the Create Issue window when creating an issue.
- Click the Validate Keys button to check / validate the key configuration (including the auto configuration for keys for Rave, TrialMaster, etc.) for each domain. A separate window opens with a listing of the domain(s) and warning message(s) if there are any non-unique key combinations for the defined keys. Warning messages are informational only, no corrective action is enforced. Warning messages may include:
- One or more columns defined for this table are not present in the table. Missing key columns(s): defined key field entered such as USUBJID.
- Keys do not produce unique results. The following values are duplicated: results are listed.
- No keys defined.
- If no validation errors are found for a data store, 'No validation errors found!' displays.
- Click Close to close the Key Validation warning messages window.
- One or more columns defined for this table are not present in the table. Missing key columns(s): defined key field entered such as USUBJID.
-
Identifier Overrides tab
- Optionally, click the Identifier Overrides tab. Use Overrides to specify the site and subject identifiers for domains whose field names differ from the specified defaults; this would most likely apply to labs or other external data.
- Click the Add (plus sign) icon.
- Select the Domain from the drop-down list (from the selected Data Store).
- Select the SiteID from the drop-down list (from the selected Domain).
- Select the SubjectID from the drop-down list (from the selected Domain).
- Repeat for other domains as needed.
- To delete a row, check the box at the left of the row and click the Delete icon.
-
Review Settings tab
Tip: Checking 'Enable Data Review' will automatically check 'Show Domains' if it was not already checked. Unchecking 'Show Domains' will automatically uncheck 'Enable Data Review' if it was previously checked.Note: When a domain previously enabled for review is disabled in Data Central, all review statuses, comments, linked issues, and annotations are preserved as they were at the time of disablement. If the domain is re-enabled, users will see this preserved context, reflecting the state at the time it was disabled. While the domain is disabled, review tracking does not continue. However, if the domain remains visible, users may still be able to add comments or annotations, even though formal review is not active.
Important: If Clean Participant Tracking is enabled, ensure that each domain is enabled for data review for the appropriate data reviewer roles.
- For each role listed:
- Check Show Domains for the domains to display in Data Central.
- Check Enable Data Review to enable records to be marked as reviewed. If this is not checked, users can still view the data, but cannot mark records as reviewed.
- Click the Domain Settings icon to open a separate window.
- New Domains are automatically Visible: check to automatically include added domains.
- New Domains automatically set to Review: check to automatically enable data review for added domains.
- Show Domains: Either check Select all for Show Domains, or check individually for each Domain.
- Enable Data Review: Either check Select all for Enable all domains for data review, or check individually for each domain.
- Click Apply (bottom right).
- For each role listed:
- Repeat these steps for any of the other data stores that should be included in Data Review, such as Exception Listings.
- Click Save (top right).
Note: No updates to Keys can be completed within Data Central, Data Review Settings.
Configure Query Settings
Query Settings is only applicable for studies with query data. If the study does not have query data, skip this configuration item.
- Click Query in the left navigation (or the hyperlink from the Overview window).
- Select Show Queries in Data Central if the study has a query table and queries should be viewable in Data Central.
- Select the Data Store for Queries Table from the drop-down list, the data store that holds the query table. For Rave studies, the required entry is ODM_Mapped. For studies from another EDC, the data store must not be ODM_Mapped.
Note: This data store must be the same data store that is selected for Enable Operational Analytics from the Settings tab when creating or editing a study in elluminate, and is only required when using CTOA. - Enter the number of Open Days, the number of days that a query is allowed to remain in the state of 'Open' before it is considered overdue.
- Enter the number of Answer Days, the number of days that a query is allowed to remain in the state of 'Answered' before it is considered overdue.
- Select the Data Source for query information, the import definition name for the Operational Data Source for the study.
- Select Use Stored Credentials if the stored EDC (e.g., Rave or other EDC) credentials should be used when creating queries in Data Central; this would eliminate the need for the user to enter the EDC credentials themselves.
- Select Append elluminate username to all query text to display the username within the query text. It will display as [username].
Assign Role Query Actions
Data Central supports two-way query processing between elluminate and the Rave, InForm, and Veeva EDC systems. Rave EDC queries are classified into notification groups that reflect the roles of the query originator and the recipient(s). For example, a query initiated by a Data Manager for site personnel to answer might be considered to be in the 'DM to Site' notification group.
Assign Role Query Actions in Rave
To support EDC query workflow in Data Central, Role Configuration is used to add the notification group and then to define the actions that a role can perform on queries of a given notification group in each query status (Open, Answered, Closed, Cancelled, or None).
Notification Groups can be imported to ensure accuracy in how the notification groups have been configured at the system level, or they can be added manually.
Important: Notification Groups added to Data Central must be exactly as they are defined in Rave. Without an exact match, query processing will not work. This refers to spacing and not case – either upper or lower case will work, but any extra spaces in the elluminate definition and not the Rave definition (or vice versa) will cause the query communication to fail.
Note: The default Data Central Configuration includes the notification groups that are part of the eCS standard Rave configuration, but these can be changed.
Add Notification Groups
- Click Role Query Actions in the left navigation (or the hyperlink from the Overview window). A list of roles displays in both the left navigation and the window.
-
Click a role (e.g., Data Manager (DM)).
Notification groups can be imported or added manually. Using the import process ensures accuracy in how notification groups are configured at the system level. - To import a notification group, click the Import System Notification Groups icon.
- Select the Notification Group(s) by checking the box next to each group to be added.
- Click Import.
The Notification Groups are added for that role.
OR - To manually add a notification group, click the Add Notification Group (plus sign) icon.
- Click in the Name field and enter the notification group, such as DM to MDR, or DM to Site. These must match the notification groups used by Rave.
- Click outside of the Name field. Repeat this to add additional notification groups.
- If there is more than one notification group for a role, select the Default by clicking the radio button of the notification group.
- Repeat adding Notification Groups for each role.
Delete a Notification Group
- Click Role Query Actions in the left navigation (or the hyperlink from the Overview window). A list of roles displays in both the left navigation and the window.
- Click a role (e.g., Data Manager (DM). The list of Notification Groups displays.
- Select the Notification Group to delete.
- Click the Delete Notification Group (trashcan) icon.
- A confirmation popup displays. Click OK to confirm.
Assign Query Actions to Notification Groups
After the Notification Groups have been added to a role, the actions that role can take on a query must be defined. This process is the same regardless of whether the notification group was imported or added manually.
-
Select a Notification Group from the list of Notification Groups. For example, DM to Site.
All the query statuses (Open, Answered, Closed, Cancelled, and None) display down the left side and the possible actions display across the top. Place a checkmark in the status box to define the actions that users with this role can perform.Note: Checking the Open box for the None status allows that role to open new queries for that notification group.
- Use the arrow to minimize the Status/Actions selections.
- Return to step 1 and assign query actions for other notification groups, as appropriate.
- Click the Save button at the top right when finished.
Assign Role Query Actions for InForm or Veeva Studies
Role Query Actions are configured for each role listed in the left navigation. The Actions table lists the statuses in the left column and actions in the columns to the right.
- Click a role in the left navigation (e.g., Data Manager (DM).
-
For each Status listed in the left column, place a checkmark in the box to define the actions that users with this role can perform.
Note: Statuses and actions may differ between InForm and Veeva studies. For example, actions for Veeva studies include Open, Answer, Close and InForm studies include Open, Answer, Close, Cancel, and Reopen.
- Continue defining each role listed in the left navigation.
Configure Key Fields for a Data Central Study
Data Central must be able to uniquely identify each record in a domain to maintain the information it stores about those records. This information includes the review status, comments, annotations, and issues.
Note: When data is imported from RAVE, or other recognized EDC systems, the record ID used in the EDC is automatically used as a key field. No additional configuration is needed for domains imported from the EDC.
elluminate uses this Key field to uniquely identify the records in a given domain.
For other data, including mapped data, this key field should be identified to maintain the link between the original records and any Data Central associated information (review status, comments, annotations, issues). If Key fields are not identified, the system will be unable to track review statuses between imports / mappings if data in the underlying record changes.
Important: Without Key fields, any comments, issues, or annotations made for a record will be lost if the data, or data structure changes.
Key Study Variables
The study configuration's ETL tab allows manual specification of common Key Study Variables for the data stores.
Each Data Store is listed with a Key field, Overrides button, and Validate button.
Key Variables and Mapped Data
For domains that are created by the Mapper, it is important to note that the key fields must be maintained between mappings. If a record ID field is added as part of the mapping process, it is critical that a record will always have the same record ID, even if the data changes.
For example, a joined table created by the mapper might benefit from a concatenated field of the original record IDs from the joined domains to ensure consistency.
Key fields must be identified after a mapping has been executed and the data is available in the target data store identified in the mapping.
Define Key Columns
Defining the key columns is critical to allow the system to track unique records between imports. This is important for the Data Variance feature to work as expected.
To configure Key Columns for the domains in a data store:
- Click the Studies Home page and click the Edit icon for a study.
- Click the ETL tab.
- In the Keys field, enter the key field(s), or a comma separated list of key fields that apply to records in the domains in that data store.
- If a Domain in the data store has different key columns than those identified in step 3, click the gear icon in the Overrides column. A Domain Specific Keys window opens.
- In the Domain field, enter the domain name for the key. For keys used in multiple domains, enter a comma-separated list of domain names.
- In the Keys field, enter a comma separated list of fields that can uniquely identify the records in the domain. Common key fields will depend on the table structure but often include a recordID, or a combination of Subject ID, Visit details, or date fields.
- Click the plus sign and repeat steps 5 and 6 for each domain that has a different key.
- Click the plus sign to add a blank row to ensure the last entry was saved.
- Click Save. The Domain Specific Keys window closes.
- For each data store, click the Validate icon to check / validate the key configuration (including the auto configuration for keys for Rave, TrialMaster, etc.) for each domain. A separate window opens with a listing of the domain(s) and warning message(s) if there are any non-unique key combinations for the defined keys. Warning messages are informational only, no corrective action is enforced. Warning messages may include:
- One or more columns defined for this table are not present in the table. Missing key columns(s): defined key field entered such as USUBJID.
- Keys do not produce unique results. The following values are duplicated: results are listed.
- No keys defined.
- If no validation errors are found for a data store, 'No validation errors found!' displays.
- Click X to close the Key Validation warning messages window.
The screenshot below displays an example of using the Validate button for the Clinical data store.
Configure Data Central Best Practices
- Validate prerequisites before configuration. Begin with an active elluminate study and current clinical and operational imports. For Rave, verify Biostats Gateway and Rave ODM Adaptor connections, ensure an RWS-enabled account is available for query processing, and confirm that the study name, environment, and CRF version are correct. For non-Rave, confirm that query tables are mapped according to Data Central's internal requirements.
- Configure the Subjects Listing for stability and clarity. In Data Central Configuration → Subjects Listing, select a domain with reliable subject and site identifiers, and choose the Subject Identifier Field and Site Identifier Field that stay consistent across data reloads. Limit the listing to essential columns for better performance and focus, and for Rave studies only use Append Default Rave Status when the chosen domain lacks a dependable subject status field.
- Enable Clean Participant Tracker with consistent inputs. In Data Central Configuration → Subjects Listing → Clean Participant Tracker, select a populated Subject Status Field and Group Assignment Field that appear in the subject listing. Under System Fields, choose the query statuses, issue statuses, and reviewer roles to include. Under Domain Fields, add numeric fields used in the cleanliness calculation. The selected fields will also be displayed in the Clean Status tooltip. Data Review must be enabled for a Reviewer Role in any domain for that role to be selectable.
- Configure Data Review for each data store and designate a steward responsible for setup and maintenance. In Data Central Configuration → Data Review, set the Data Store for Related Forms to the store containing EDC clinical forms. For each Data Store, define Default Identifiers for Subject ID, Site ID, and optional Visit ID to ensure consistent context. Use the Validate Keys button to verify uniqueness and monitor any messages. Use the Identifier Overrides tab for domains where subject/site fields differ from the defaults. In the Review Settings tab, assign roles to Show Domains and Enable Data Review, and carefully use the Domain Settings gear icon to include and enable new domains automatically if appropriate.
- Configure Query Settings to align with EDC workflows and study turnaround goals. In Data Central Configuration → Query, enable Show Queries in Data Central only when a mapped queries table exists. Set the Data Store for Queries Table to ODM_Mapped for Rave studies, and for other non-Rave studies, use the store that contains the mapped Queries table. Enter Open Days and Answer Days to match study targets so overdue items are seen in the Queries listing in Data Central with red text. When allowed, enable Use Stored Credentials to avoid credential prompts and optionally Append elluminate username to all query text for traceability.
- Configure Role Query Actions to align with the study workflow. In Data Central Configuration → Role Query Actions, select the query actions each role can perform for each status. For Rave studies, import Notification Groups or add groups with names that exactly match the Rave group, and grant None → Open only to roles that need to create new queries. For InForm and Veeva studies, set query actions to the EDC’s available statuses (e.g., InForm includes Cancel and Reopen, Veeva may not). Enable only the actions required for the role so that the UI displays only valid options.
-
Avoid common pitfalls that lead to rework.
- Overview icons indicate unconfigured items. Proceed only when all items display green checks.
- Keys must be immutable and unique across loads. Avoid using unstable fields that can change or be reformatted, such as free text or labels.
- Set the Data Store for Queries Table to ODM_Mapped only for Rave. Select a different mapped data store for non-Rave studies.
- Rave Notification Group names must match exactly, or two-way processing will fail. Always import controlled lists when possible.
- Role settings in Data Central require underlying User Management privileges for access and review actions.