Chapter 3. Metadata

Table of Contents

3.1. Locating Metadata
3.2. Queries
3.2.1. Add Query
3.2.2. Edit Query
3.2.3. Reply to Query
3.2.4. Delete Query
3.2.5. Multiple Queries Dialog
3.3. Add a Data Reason
3.4. Mark a Data Value as Missing
3.5. Resolving Queries
3.6. Managing Documents
3.6.1. Supported Document Types
3.6.2. Reviewing Documents
3.6.3. Adding Documents
3.6.4. Downloading Documents
3.7. Sharing Links

3.1. Locating Metadata

Paper CRFs and eCRFs display the Q, R, and M in different locations.

eCRFs display the metadata buttons for each field on the same row as the field. Since all the buttons are visible, metadata on an eCRF can be quickly and easily viewed by scrolling through the fields.

Paper CRFs only display one set of Q, R, and M. These are located on the right side of the window. The buttons show and allow you to alter the metadata for the field that currently has the focus. Blue, green, and orange borders on a field indicate that the field has metadata, allowing you to quickly see the metadata on a paper CRF. A red border on a field indicates that there is an error on the field.

3.2. Queries

Queries are used to request corrections or clarifications about the data. There are four query dialogs: Add Query, Edit Query, Reply to Query, and Delete Query. The following sections explain in detail how to use these dialogs.

For studies where multiple queries per field are enabled, there is an additional dialog where users can add a new query or choose an existing query to reply to, edit, or delete. Further details are provided in Multiple Queries Dialog.

3.2.1. Add Query

To add a query to a field, click Q. If there is no query on a field, the Add Query dialog opens. Select an appropriate category from the dropdown menu, and provide the query detail in the provided text field. Once complete, click Apply to add a query to the field.

3.2.2. Edit Query

To edit a query, click Q. If the query is resolved, the Edit Query dialog open. Otherwise, the Reply to Query dialog opens. Click Edit, and the Edit Query dialog opens. Select an appropriate category and status from the dropdown menu, and provide the query detail in the provided text field. Once complete, click Apply to finish editing the query.

3.2.3. Reply to Query

If a query is already resolved, it cannot be replied to. Otherwise, to reply to an outstanding query on a field, click Q. The Reply to Query dialog opens, displaying the query detail. Enter the query reply content in the provided text field. Once complete, click Apply.

3.2.4. Delete Query

Queries are rarely deleted. Once a query is created, it should be resolved, perhaps as irrelevant.

If it is necessary to delete an existing query, click Q. If the query is outstanding or pending, the Reply to Query dialog opens. Click Edit, and the Edit Query dialog opens. Click Delete, the Delete Query dialog opens. In the Delete Query dialog, click Delete to finish deleting the query on the field. At each step please ensure that the query really should be deleted.

3.2.5. Multiple Queries Dialog

In a study with multiple queries per field enabled, click Q for a field with an existing query to see the following multiple queries dialog:

The icons used in the multiple queries dialog are:

  • Reply

  • Edit

  • Delete

  • Add

Additionally, there is another difference between single and multiple query-enabled study query dialogs. In single query-enabled studies there are navigation buttons at the bottom of the dialogs to get from one dialog to another. These aren’t present on multiple query-enabled study query dialogs. Instead, the multiple query-enabled study query dialogs have a back arrow at the left top corner. The back arrow returns you to the Multiple Queries dialog.

3.3. Add a Data Reason

Reasons are a way to provide additional information about existing data or to explain why data is changed. For each data field, the user can add a new reason or edit an existing reason using the Reason for Data Value dialog.

To add a reason to a field, click R next to the field. The Reason for Data Value dialog opens. Select an appropriate status from the dropdown menu and enter reason detail in the provided text field. Click Apply to add the reason to the field.

In some cases, the Reason for Data Value dialog may open automatically when a data value is changed. In these cases, a reason is required before the data change is accepted. If the data change was made in error, click Revert to Old in the Add Reason dialog to discard the data change.

To edit an existing reason, click R to open the Reason for Data Value dialog. Change the reason status and/or detail and click Apply to finish editing and close the dialog.

To delete an existing reason, click R to open the Reason for Data Value dialog. Click Delete and then click Confirm Delete to confirm that the reason should be deleted.

3.4. Mark a Data Value as Missing

Missing value codes provide a way to mark a data value as missing. Users may select a missing value for any data field that is not essential to indicate that the data value will not be entered.

To mark a data value as missing, click M next to the input field. The Missing Value dialog opens. Select an approriate missing value from the dropdown menu, and click Apply to finish.

After marking a data value as missing, the field value is set to the missing value code and the field is disabled. Disabled fields can still be tabbed to, however editing the field is not possible.

To enter data in a field that has been marked as missing, click M next to it. In the Missing Value dialog, select the No Code (Reset) option from the dropdown menu, and click Apply to finish. This enables the field for data entry and resets the field value to blank. No Code (Reset) can also be used at any time to clear a data value currently on that field.

3.5. Resolving Queries

Queries can be resolved via Q on the field.

Click Q, and then click Edit for the query that is to be resolved. Select an appropriate Status from the dropdown menu, and add Detail and Note in the provided text areas as needed. Once complete, click Apply to resolve the query.

3.6. Managing Documents

DFweb allows users to attach documents to a plate, which accommodates adding more data and information in other formats.

3.6.1. Supported Document Types

DFweb allows user to upload, view and download PDFs, images, audio, and video. Specifically for images, DFweb supports JPG, JPEG, PNG, BMP, DICOM, DIC, and DCM format; for audio, DFweb supports MP3, and WAV format; for video, DFweb supports MP4, and AVI format. The file size limit is 25 MB.

3.6.2. Reviewing Documents

Navigate to the Manage Documents dialog to review documents. This is available via the Manage Documents menu item under the CRF Menu (without documents) or (with documents), in the top right corner of the plate. Click to choose from the dropdown menu items:

The number next to Manage Documents indicates the number of existing documents for this plate. Click Manage Documents to open the Manage Documents dialog. Below is an example of the Manage Documents dialog.

In the Manage Documents dialog, users can review documents. To review a document, click to expand the collapsible content:

Click to collapse the content.

Many document types can be previewed or played without downloading first, including PDF, JPG, JPEG, PNG, BMP, MP3, WAV, and MP4 format. For DICOM, DIC, DCM, AVI or other formats, they must be downloaded first.

3.6.3. Adding Documents

Navigate to the Manage Documents dialog by following the instructions in Reviewing Documents.

Click Choose Files to open the file browser and select one or more files from your computer. Once complete, click Upload to add the file(s).

3.6.4. Downloading Documents

Navigate to Manage Documents dialog by following the instructions in Reviewing Documents.

Click to the right of the file name to download that particular file. Click the large at the top of the dialog next to the Manage Documents title to download in a zip file all the documents listed.

3.7. Sharing Links

The ability to share links minimizes the time and effort to navigate to a particular page.

Click the Application Menu, , and then select Copy URL from the dropdown menu. The copied URL can be re-visited at a future time, or shared with others.

When using a copied URL, the user is redirected to the login page first, where they are required to login. After successful login, the user is taken to the linked page.