Manage Data Discoverability (Tutorial)

Manage Data Discoverability (Tutorial)

At a Glance

By default, human metadata (lab results, EMR data, and survey responses) is excluded from all publicly accessible Data Apps and publications. HISE has new data discoverability features that let you explicitly choose which fields to include in the public data that becomes findable in Advanced Search.

This opt-in selection process for public data safeguards patients' privacy and supports AIFI's legal and ethical compliance with best practices in data confidentiality. If you have questions or need help, contact Support.

Step 1: Sign in and open your publication or Data App
Step 2: Review available data and (optional) make specified items  
Step 3: Mark public assets as Reviewed
Step 4: Update public assets on your Certificate of Reproducibility
Step 5: (Optional) Find your discoverable data in Advanced Search

When to Use This Feature

To promote reproducibility and transparency, under certain circumstances you might want to make specified data publicly discoverable in your publication or Data App:

Instructions

  1. Navigate to HISE, and use your organizational email address to sign in .

  2. In the top navigation menu, click COLLABORATION SPACE and then click the Data Apps heading. (Alternatively, to configure discoverable metadata in a publication, click the study space that houses your publication, and then click PUBLICATION.)

    A. Click the Data App (or publication) whose metadata you want to configure.



    B. In the Data App Details panel at left, click DATA DISCOVERABILITY.

Step 2: Review available data and (optional) make specified items discoverable

  1. On the Manage Data Discoverability page, if you have not yet opted to include any data, a message like this one appears.

  1. If you've previously selected data to be added, it appears on this page. Any data to be reviewed is marked with a Not Reviewed tag.

  1. To review all available public data, click ACTIONS > Manage Discoverability.



    A. On the Manage Data Discoverability page, in the Available Metadata section, note the number of metadata fields, indicated by a tag to the right of the heading.



    B. Scroll through the list of fields under each Available Metadata group. These categories—LAB DATA, EMR, and SURVEY DATA—correspond to the Advanced Search filters. To see the fields in each collapsible group, click the arrow (the expand icon) next to the group name.



    C. Use the checkboxes to select the fields you want to keep, or click SELECT ALL.

i. To move the items from Available [for selection] to Discoverable [by the public], click ADD.

[IMAGE showing ADD button]

ii. Click SAVE CHANGES.To confirm, click SAVE CHANGES again in the dialog box.

[IMAGE of SAVE CHANGES dialog box]

The saved items now appear in the Discoverable Metadata section of the Manage Metadata Discovery page.

Step 3: Mark public assets as Reviewed

  1. Return to the Manage Data Discoverability page for your Data App or publication.

  2. Click ACTIONS > Mark as Reviewed.

[IMAGE of Mark as Reviewed selected on ACTIONS drop-down]

  1. In the Review Data Discovery dialog box, click MARK AS REVIEWED.

[IMAGE of dialog box]

The dark-red Not Reviewed tag changes to a green Reviewed tag, and the Mark as Reviewed choice on the ACTIONS button becomes unavailable.

[IMAGE of Reviewed tag and grayed-out Mark as Reviewed choice on ACTIONS button]

Step 4: Update public assets on your Certificate of Reproducibility

  1. In the Data App Details panel, click CERTIFICATE OF REPRODUCIBILITY.

[IMAGE of link]

  1. Click View Certificate of Reproducibility, and note the tag.

[IMAGE of Certpro page with NOT REVIEWED tag]

  1. Click ACTIONS > Update Data Discoverability.

    A. If a Reviewed tag appears on the Manage Data Discoverability page, return to the Certificate of Reproducibility page and click ACTIONS > Mark as Reviewed.

    [IMAGE of ACTIONS button with Mark as Reviewed selected]

    i. To indicate that you’ve reviewed the public data in your release, in the dialog box, click MARK AS REVIEWED.
    
    [IMAGE showing dialog box]
    
    ii. To return to your certificate without marking it as reviewed, click CANCEL.
    
    [NO IMAGE]
    

    B. If a Not Reviewed tag appears on the Manage Data Discoverability page, return to Step 2 of this tutorial to review and select discoverable data (if any) and mark the data as Reviewed.

    [IMAGE of ACTIONS button expanded and Update Data Discoverability selected]

Step 5: (Optional) Find your discoverable data in Advanced Search

  1. In a new browser tab, open HISE and go to Research > Advanced Search.

[IMAGE showing Advanced Search]

  1. In the Filters panel at left, click the PUBLIC FILES tab.

[IMAGE of PUBLIC FILES tab]

  1. In the Advanced Filters field, click the arrow to open the drop-down list.

[IMAGE of Advanced Filters field with drop-down list open and Public Releases selected]

A. In the Public Releases Group, click Release Name.

[IMAGE of drop-down list open to Release Name]

B. In the Release Name dialog box, find and select the name of your Data App or publication:

[NO IMAGE]

i. In the Operator field, keep the default “equals,” or use another boolean. Then select the correct item from the Value field.

[IMAGE showing drop-down list open to Release Name values]

ii. Alternatively, click into the Value field, and type the first few letters of the name of your Data App or publication. Then select the correct name from the list.

[IMAGE of partial Data App name typed in Value field]

iii. Click APPLY.

iv. In the results window, review the publicly accessible items associated with your Data App or publication. If you see items that shouldn't be public, or if you want to add items, return to the Manage Discoverability page, as explained above.

[IMAGE showing results from Lucas's Data App]

Alternatively, select items and use the floating options menu to apply your search results as you would in any other Advanced Search (for example, select the results and add them to a file set).

[IMAGE showing items selected and floating options menu]