Skip Navigation
NIH | National Cancer Institute | NCI Wiki   New Account Help Tips
Skip to end of metadata
Go to start of metadata

Registering a New User

To register a new user in NBIA, from the NBIA welcome and login page, follow these steps:
  1. On the NBIA welcome page, click the Register Now link in the Register Now panel as shown below.
      Register Now
    The legal provisions page appears.
  2. Review the text on the page and click the link at the bottom to indicate your agreement and continue.
    Te registration form appears.
    User Registration page 
  3. Enter information for the new user. Required fields are preceded by an asterisk.
  4. Click Register to continue or Cancel to return to the home page.

The NBIA administrator reviews your registration and creates the new account. For more information, see Creating a New NBIA User.

Logging into NBIA

To access NBIA, navigate to https://imaging.nci.nih.gov.
  • You do not need to log in if you want only to query the public images on the NBIA image server.
  • Register and then log in to NBIA if you want to save your queries, access query history, and access secured collections.

To log in to NBIA

  1. In the User Login panel, enter your User ID and password.
    NBIA Home Page with Login panel highlighted
  2. Click Login. If your login is successful, NBIA opens the application to its home page.

    Tip

    NBIA uses popups. To prevent problems accessing the application, in your browser, enable a popup blocker exception for the NBIA site URL.

  3. If you do not have a User ID or password, click Register Now to apply for a user account. For more information, see Registering a New User.
  4. If you continue having difficulty with logging in, click I cannot access my account on the NBIA login page. An NBIA Account Help topic opens, describing help options for resolving your login problem.
  5. Follow the directions on the Login Failed pop-up message and/or on the NBIA Help Account page. Note that you can contact Application Support using the contact information on that page.

    Launching from another application?

    If you launch a search of the NBIA database from another application, you are prompted to log in to NBIA before you can continue with your search.

Using the NBIA Home Page

The NBIA home page that opens after logging in displays several panels and menu bars. The page is displayed in the following figure. Features of the page are described below.
NBIA 6.3 home page

The home page offers the options described in the following table.

Menu

Menu Option

Description

For more information, see

Home

 

Return to the NBIA Home page.

 

Search Images

Simple Search

Open the Simple Search page.

Performing a Simple Search

 Text SearchOpen the Text Search page.Performing a Text Search
 Advanced SearchOpen the Advanced Search page.Performing an Advanced Search

Manage Data Basket

 

Open the My Data Basket page. This is the same option as choosing Manage Data Basket from the menu bar.

Working with the Data Basket

Tools

List DICOM Image Viewers

Open a page displaying links to freeware DICOM image viewers.

Obtaining DICOM Viewers

 View Saved QueriesOpen the Saved Queries page.Working with Saved Queries
 View Query HistoryOpen the Query History page.Viewing Query History
 Change PasswordOpen the NCI Password Station.Changing User Password
 Create Shared ListOpen the Create Shared List page.Editing a Shared List
 Edit Shared ListOpen the Edit Shared List page.Creating a Shared List
 Search Shared ListOpen the Search Shared List page.Searching a Shared List
Admin

Perform QC

Evaluate a submission and assign a QC status.

Using the Quality Control (QC) Tool

 Approve DeletionsApprove the deletion of image series marked for deletion.
Approving Image Deletions
 Manage Shared ListDelete shared lists created by other users.Managing a Shared List
 View Submission ReportsRun reports to verify that images have been received and to monitor the status of the submitted images.Viewing Submission Reports
 Perform Online DeletionsImmediately remove images that are marked as approved for deletion.Manually Deleting Image Series
 Edit Collection DescriptionsAdd a brief description for a collection so that the NBIA user knows what data is in the collection.Editing Collection Descriptions
 Manage Workflow ItemsCreate, edit, and delete workflow items that involve changing the visibility status of an image series and/or trigger a web service call to a URL.Managing Workflow Items
 Manage Saved QueriesReview and delete saved queries.Managing Saved Queries
 User Authorization ToolManage users and the protection groups they belong to.User Authorization Tool

Help

 

Open a browser window displaying the NBIA User's Guide.

Using NBIA Online Help

Logout Log out of NBIA and return to the NBIA Home page. 

Using NBIA Online Help

The NBIA online help retrieves topics from the NBIA User's Guide. It explains how to use all of the features of the NBIA portal.

Not logged in?

You can open the user's guide without being logged into NBIA.

Click User's Guide in the top menu bar to open the NBIA User's Guide on the NCI Wiki.

On any application page, click help buttonto open the help topic that applies to features available on that NBIA page.

Performing a Simple Search

A simple search allows you to search for image studies based on a combination of the following search filters: Collection(s), Image Modality(ies), Anatomical Site, Manufacturer Model(s), Available date, Subject IDs, and Baseline Plus. The more criteria you select, the fewer results you receive. After you select your search criteria, you can create a saved query to use later.

To perform a simple search

  • On the NBIA home page, click Simple Search or Search Images > Simple Search.
    The Simple Search page appears.
    Simple Search page
    Choose the search criteria as described in the following table.

    DescriptionSimple Search Criteria
    Results per Page

    Select the number of search results per page that you want the search to return.

    Collection(s)
    Collections are NCI-defined groupings of image data sets. Select from the collections to which you have been assigned accessibility. If none are selected, then the search returns data for all collections.
    Click the (?) icon next to the collection name to display a popup with the collection description if it exists.

    Click Collection Descriptions for more information about the collections.

    Image Modality(ies)
    Select from the available image classifications. If none are selected, then the search returns data for all modalities. 

    Specify whether to Return cases that include All or ANY Modality.

    Modality description

    Descriptive text for the modality displays when you hover the cursor over the option.

    The NBIA portal can perform ultrasound-specific searches. To launch an ultrasound image search, select US in the list of Image Modalities. When you do so, three additional search options display on the page, shown below. Configure the options appropriately for the ultrasound data you want to search.

    Image Modalities when US is selected

    • Number of frames: One ultrasound DICOM file can consist of multiple frames which you can specify in this option.
    • Specify if Ultrasound Color Data is present.
    • Specify one or more Ultrasound Image Modes.

    If you choose to view an ultrasound DICOM file in animation, the NBIA tool loops through all of the images in the file.

    Anatomical SiteTo further restrict the search, optionally choose the anatomical site of interest.
    Manufacturer ModelTo restrict manufacturer model results, uncheck All Manufacturers. Expand and display the list as needed, and select the items to restrict the search.


    Available (mm/dd/yyyy)To restrict results to the date the image became available in the system, expand the panel, enter from and to dates and select Add Criteria to perform the search.
    Subject IDTo restrict results to a comma separated list of patient IDs, expand the panel, enter the list of patient IDs, and select Add Criteria to perform the search.

    Baseline PlusExpand the panel and specify the Minimum Number of Additional Studies.

    To clear the search criteria and start over, click reset button.

    The search results appear.

    search results by subject page

    Save the Query

    You can save your search criteria to make it easier to repeat this query in the future. After you have selected one or more search criteria, the Save Query link appears at the bottom left of the page.

    To save a search query
    1. Select search criteria.
    2. In the box above the Save Query link, enter a name for your query.




    3. Click Save Query.
      The query is saved. You can see it by selecting Tools > View Saved Queries.

    For more information, see Managing Saved Queries.

    Navigation Tips

    • Click the down arrow next to a column title to sort the column by that item.
    • Click the arrows at the bottom of the table to display the first, previous, next, or last page of results.
    • Click the page number links to move to a specific page of results.

    The Search Results (Studies for Subject) page shows studies associated with the subject that you selected on the Search Results by Subject page. Each study, identified by Study Instance ID, Description, and Date, is followed by a table with rows for each image series in the study. At the top and bottom of the page, breadcrumbs in the format Search >> Study show the level of the data on the page. Clicking Search in those breadcrumbs returns you to your original search results.

     

    The following table describes the data available for each study and image series in that study.

    Field

    Description

    DICOM Web Viewer link

    Click this link to see all study images in the DICOM Web Viewer, which is provided by Oviyam. The features of the viewer are explained in the Oviyam documentation Exit Disclaimer logo   as well as Using the Oviyam Viewer for NBIA.

    Series

    Series identification number

    Description

    Description of the Series

    Modality

    Image modality

    Manufacturer

    Name of the manufacturer of the image series

    Images

    Displays the number of images in the series. This number includes visible images that meet the search criteria.

    Thumbnails

    Click this link to display thumbnails of the series' images. For more information, see Search Results (Images for Series).

    Cine Mode

    Click cine mode button in a series record to launch an animation of the series. This feature is only available when two or more thumbnails are available for the series. For more information, see Viewing Image Animation.

    DICOMClick DICOM button to open a new window that displays DICOM metadata about the first image in the series. 
    Each image series can have multiple images whose thumbnails display in this search results page. While each image has its own DICOM file whose attributes may vary slightly from the others in the series, the DICOM file that opens displays values for only the first image in the series. These values represent the values for all images in the series.

    Add to Basket


     

    • Click add to data basket to select the series and remove from basket to clear it.
    • To mark all series in the search results as records you want to add to your data basket, click the basket icon in the column header or click add found to basket

    For more information, see Managing the Data Basket

    Add a Study series to BasketTo mark only the series in the search results of a particular study as records you want to add to your data basket, click the basket icon in that study's column header

Performing a Text Search

A text search allows for searching of many of the database text fields, DICOM image tag data, and annotation files that are not available in the normal Simple and Advanced searches. For example, you can find all patients associated with the term glioma, as shown below.

To perform a text search

  1. On the NBIA home page, click Text Search or Search Images > Text Search.
    The Text Search page appears.

    empty text search fields

  2. Select the number of search results per page that you want the search to return.
  3. In the box at the top of the page, enter a text string.
    Use Lucene conventions Exit Disclaimer logo for wildcards. Do not use colons as NBIA automatically filter them from the criteria. Lucene designates colons as fields. Since the text search searches all fields, colons are not necessary.
  4. Click Submit.
    The search results appear.
    search results from search term of brain

    Navigation Tips

    • Click the down arrow next to a column title to sort the column by that item.
    • Click the arrows at the bottom of the table to display the first, previous, next, or last page of results.
    • Click the page number links to move to a specific page of results.

    The following table describes each item in the search results table.

    Search ResultDescription
    Collection IDCollection identifier
    Subject ID

    Click the Subject ID to view all study images for this subject in a DICOM web viewer, a single series' thumbnails, or the DICOM header for the first image in the series. See Search Results (Studies for Subject).

    Hit

    The field in the study where the text string you entered as your search criteria appears

    Total StudiesTotal number of studies for the subject
    Total SeriesTotal number of image series for the subject
    basket

    Add the images for a single series or the entire study to your data basket. When you have marked a record for addition to the data basket, it is highlighted in yellow.

    • Click add to data basket to select the record and remove from basket to clear it.
    • To mark all records in the search results as records you want to add to your data basket, click the basket icon in the column header or click add found to basket.

    For more information, see Managing the Data Basket.

Performing an Advanced Search

An advanced search allows you to search against multiple combinations of values within Collections, Patient, Study,  Series, or Image objects. You can build search criteria based on data values or ranges at the image series level.

To perform an advanced search

  1. On the NBIA home page, click Advanced Search or Search Images > Advanced Search.
    The Advanced Search page appears.

    Advanced Search criteria
  2. Select the number of search results per page that you want the search to return.
  3. From the Match options, select ALL to find image series that meet all of your search criteria or select ANY Criteria to find image series that meet any of your search criteria.
  4. From the first Criteria list, select an NBIA entity. Your selection here determines the options available for the rest of the search criteria.
  5. Select options from the lists or enter text into the box as needed to perform your search. If you enter text into the box, click the Add icon (plus sign button) for each set of criteria you define.
    As soon as you specify the final criterion, the criteria you selected appear in the box below the criteria and the search results appear to the right.

    Modality searches

    Modality searches only support the CT and MR modalities.

     

    advanced search results page

    Navigation Tips

    • Click the down arrow next to a column title to sort the column by that item.
    • Click the arrows at the bottom of the table to display the first, previous, next, or last page of results.
    • Click the page number links to move to a specific page of results.

    The following table describes each item in the search results table.

    Search ResultDescription
    Collection IDCollection identifier
    Subject ID

    Click the Subject ID to view all study images for this subject in a DICOM web viewer, a single series' thumbnails, or the DICOM header for the first image in the series. See Search Results (Studies for Subject).

    Matched Studies

    Total number of studies for this subject that match the search criteria

    Total StudiesTotal number of studies for the subject
    Matched SeriesTotal number of image series for the subject that match the search criteria
    Total SeriesTotal number of image series for the subject
    basket

    Add the images for a single series or the entire study to your data basket. When you have marked a record for addition to the data basket, it is highlighted in yellow.

    • Click add to data basket to select the record and remove from data basket to clear it.
    • To mark all records in the search results as records you want to add to your data basket, click the basket icon in the column header or click add found to basket.

    For more information, see Managing the Data Basket.

  6. To further refine your results, select new search criteria. These new criteria filter your existing results and as with the previous search, the criteria you selected appear in a box below the criteria. Click the close button to delete the record from the page or click reset button  to delete all criteria and start over.

Creating Saved Queries

To save a search query
  1. On the Simple Search page, click Save Query at the bottom left of the page.
    A box appears where you enter the name of the new query.

    Box for query name appears above the Save Query link

  2. Enter the name of the query.

  3. Click Save Query again.
    The query is saved. You can see it by selecting Tools > View Saved Queries.

Working with Saved Queries

While performing a Simple Search, you can save your choice of Collection(s), Image Modality(ies), and Anatomical Site as a named query. You can then run that query in the future or edit it, if you want to change any of the search criteria. That edited query can either update your original query or become a new query with a new name.

The following procedures are associated with saved search queries.

Editing Saved Queries

You can view your saved queries and then edit and resubmit them. You can also view your query history.

Disallowed Collections and Saved Queries

If you save a query when you have access to a collection then subsequently lose that access, you do not lose the saved query. However, records from a disallowed collection are not included in the search results.

To view, edit, and resubmit saved queries

  • Select Tools > View Saved Queries.
    The Saved Queries page appears.

    Saved Queries page

    The query table is sorted in descending order by Last Executed date by default. You can also sort by Query Name by clicking on the down arrow next to the column title.

    The following table describes the information about your saved queries on this page.

Saved Query

Description

Query Name

The name of the query displays as a link. The default is that the criteria themselves do not display. The link toggles whether the criteria for the saved query displays. Click the link to display/not display the criteria selected for the query.

Last Executed

The most recent date and time you executed the query displays. The time is displayed for the Eastern Time (US and Canada) time zone.

New Data Available

An icon (new data available icon) appears if new data is available for the saved query. Click the icon to display the results (new data only) on the Search Results page.

Resubmit Query

Click this button to open the Simple Search page showing all available results of the currently saved search criteria. A message appears in the lower left corner identifying the source of the search results.

message says these are the results of the CR saved query

Edit Query

Click this button to open the Simple Search page with the currently saved search criteria selected. In the lower left corner of the page, the Save Query section provides the options to update the saved query with new criteria or to save these criteria as a new saved query, with a box for the new query name.

Select an option and click Save Query.

edit query section of Simple Search page

Check Box

Click the check box to mark the query for deletion. You can click the check box in the header to select all queries or you can select queries individually. Click Remove Selected Items. The Manage Saved Queries page displays a message indicating success or failure and any additional actions that are required.

You can also perform the following action on the Saved Queries page.

ActionDescription
View Query HistoryClick the Query History tab. The View Query History page appears. For more information, see Viewing Query History.

Viewing Query History

To view query history
  • Select Tools > View Query History link
    or
    Click the Query History tab from the Saved Queries page.
    The Query History page appears. The Query History page displays a table of the last twenty queries that you executed. These include saved queries that you resubmitted as well as queries you have not saved.
    query history page

The Query History page contains the following information:

Field Name

Description

Query Name

The name of the query displays as a link. The link toggles whether the criteria for the executed query is displayed. The text of the link can appear three different ways depending on the situation.

  • If the query was not saved, No Name Provided displays as the link.
  • If the query is a saved query that has not been edited since the last execution date, the name of the saved query is displayed.
  • If the query is a saved query that has been edited since the last execution date, the name of the saved query is displayed with an asterisk. The asterisk refers to a message at the bottom of the page which is a warning to you that the results are based on the criteria that were used at the time the query was run, not the criteria that is currently saved for the query.

Last Executed

The date and time that you executed the query. The time is displayed for the Eastern Time (US & Canada) time zone.

Resubmit Query

Click the Resubmit Query button to submit the query using the saved criteria. The results display on the Search Results page (see Initiating Searches from Other Applications).

Click the Saved Queries tab to view, edit, or resubmit saved queries (see Managing Saved Queries).

Search Results Studies for Subject

The Search Results (Studies for Subject) page shows studies associated with the subject that you selected on the Search Results by Subject page. Each study, identified by Study Instance ID, Description, and Date, is followed by a table with rows for each image series in the study. At the top and bottom of the page, breadcrumbs in the format Search >> Study show the level of the data on the page. Clicking Search in those breadcrumbs returns you to your original search results.

 

The following table describes the data available for each study and image series in that study.

Field

Description

DICOM Web Viewer link

Click this link to see all study images in the DICOM Web Viewer, which is provided by Oviyam. The features of the viewer are explained in the Oviyam documentation Exit Disclaimer logo   as well as Using the Oviyam Viewer for NBIA.

Series

Series identification number

Description

Description of the Series

Modality

Image modality

Manufacturer

Name of the manufacturer of the image series

Images

Displays the number of images in the series. This number includes visible images that meet the search criteria.

Thumbnails

Click this link to display thumbnails of the series' images. For more information, see Search Results (Images for Series).

Cine Mode

Click cine mode button in a series record to launch an animation of the series. This feature is only available when two or more thumbnails are available for the series. For more information, see Viewing Image Animation.

DICOMClick DICOM button to open a new window that displays DICOM metadata about the first image in the series. 
Each image series can have multiple images whose thumbnails display in this search results page. While each image has its own DICOM file whose attributes may vary slightly from the others in the series, the DICOM file that opens displays values for only the first image in the series. These values represent the values for all images in the series.

Add to Basket


 

  • Click add to data basket to select the series and remove from basket to clear it.
  • To mark all series in the search results as records you want to add to your data basket, click the basket icon in the column header or click add found to basket

For more information, see Managing the Data Basket

Add a Study series to BasketTo mark only the series in the search results of a particular study as records you want to add to your data basket, click the basket icon in that study's column header

Creating a Shared List

You can create a shared list by clicking Tools > Create Shared List link or by putting a series in the data basket, as explained below.

Who can create a shared list?

Anyone can create a shared list. Once you do so, you must record the exact name of the shared list to distribute to others who may want to use the list. That is the only way they can access it.

To create a shared list

You can create a shared list from the Tools menu or the data basket. Procedures for both methods follow.

Menu Option:

  1. Click Tools > Create Shared List.
    The Create Shared List page appears.
    Create Shared List page
  2. Do the following:
    1. Enter a Name for the list (required).
    2. Optionally, add a description and a URL. The URL links to relevant or more detailed information about the list.
    3. Click Browse to upload a file in comma separated value format (.csv) that includes all of the series instance IDs you want to be in the shared list. This file should have one series instance UID per line.
  3. Click Submit.
    The image series from the uploaded file is added to the data basket.

Data Basket

  1. Add an image series that you want to include in the shared list to the data basket.
  2. Click the Create Shared List button.
  3. Do the following:
    1. Enter a Name for the list (required).
    2. Optionally, add a description and a URL. The URL links to relevant or more detailed information about the list.
    3. Click Browse to upload a file in comma separated value format (.csv) that includes all of the series instance IDs you want to be in the shared list. This file should have one series instance UID per line.
  4. Click Submit.
    The image series from the uploaded file is added to the data basket.

Access to your list

NBIA warns you that not all public users will have access to your list if the list contains any non-public image series.

Searching a Shared List

Any user can search for a shared list.

To search for a shared list

  1. Click Tools > Search Shared List.
    The Search Shared List page appears.
    Search Shared List page
  2. Enter the name of an existing shared list. To retrieve the list, you must know the exact name given to the shared list.
  3. Click Submit to launch the search or Reset to clear the field and start again.

If the search is successful, NBIA adds the image series in the shared list to the data basket. If the shared list includes series for which you do not have visibility rights, NBIA informs you that the displayed shared list is not complete.

Editing a Shared List

You can edit the list only by uploading a .csv file with all the series instance IDs for the list. You can only edit/delete shared lists you have created yourself.

Shared List

From the data basket, you can export image series instance IDs to a .csv file for later use in creating or editing a shared list. See Exporting a Shared List for more information.

To edit a shared list

  1. Click the Edit Shared List link under Tools on the menu bar.
    The Edit My Shared List page appears, displaying a list of shared lists you have created.
    Edit My Shared List page
  2. Click the name of the shared list you want to edit.
    List details appear.
    expanded Edit My Shared List page showing details about the list
  3. In the description field, optionally enter a comment about the list or your edit.
  4. In the URL field, optionally enter a web address that provides more information about the shared list.
  5. Click Browse to locate the file you want to upload. Doing this replaces the current shared list.

To delete a shared list

  1. Click Tools > Edit Shared List.
    The Edit My Shared List page appears, displaying a list of Shared Lists you have created.
  2. In the row of the shared list you want to delete, click .

Because editing a shared list is only possible by replacing it, you might consider backing up a shared list when you create it. To do so, export the shared list as a file when you create it. See Exporting a Shared List.

Managing a Shared List

Users with the appropriate administrative privileges can delete shared lists created by other users.

Permissions

This administrative feature is available only to logged in users who have "manage visibility" privileges, as defined in UPT. For more information, see Creating a New NBIA User.

 To delete a shared list, follow these steps:

  1. Click Admin > Manage Shared List.
    The Manage Shared List page appears.
    Manage Shared List page with a user name dropdown option only
  2. Select a user name from the list.
    That user's shared list(s) appear.
    Manage Shared List page displaying a selected user's shared list
  3. Click the name link to review the shared list's details or click delete button to delete shared the shared list.


Managing the Data Basket

Click Manage Data Basket from the top menu bar to display the My Data Basket page. This page displays a table of all the items in your data basket, shown in the following figure.

My Data Basket page

The following table describes each item in the data basket table.

Data Basket Field

Description

Subject ID

Subject identification number

Study UID

Study identification number

Study DateDate of Study
Study DescriptionDescription of the Study

Series ID

Series identification number

Series DescriptionDescription of the Series

Number of Images

Number of Images for series

Image Size (in MB)

Size of the image file in megabytes

Annotation File Size (in MB)

Size of the annotations file in megabytes. This column is N/A if there are no annotations.

Remove

To remove the item from the basket.

The total size of your data basket and the estimated download time displays at the bottom of the My Data Basket page (previous figure).

To delete all items from your basket, click the Empty Data Basket link. You can continue to add items to your data basket from the Search Results pages.

Deletion details

If the series you mark for deletion is part of a Shared List, a message appears alerting you to that fact. The message also includes the name of the shared list and the shared list creator's email address. This gives you the opportunity to back out of the deletion. For more information see Working With Shared Lists.

Download Manager

The Download Manager allows you to replicate items in your data basket, downloading them to your local machine. It is a Java program and requires that you install a Java Runtime Environment (JRETM) on your machine to run it. You can download the JRE. The Download Manager does not limit the total size of the download.

JRE

You must have version 8 or higher of the Java Runtime Environment (JRE) installed to be able to open the Download Manager.

  • If JRE 8 is installed, the Download Manager attempts to start. To run the application, you must click Run in the Warning dialog box indicating the application's digital signature cannot be verified. Before doing so, you can select the More Information... link at the bottom of the dialog to view a more detailed report of any security issues. Then you can evaluate whether you want to run the application.
  • If JRE is installed but the version is older than version 6, the browser automatically attempts to upgrade the JRE to version 8.
  • If the JRE is not installed, when you click the Download Manager button, the browser prompts you for what it should do with the JNLP file. The Data Basket page includes a link to a page where you can download the JRE.

    Exit Disclaimer logo
  • If Download Manager fails to work properly this could be a JRE version issue, Download Manager has been tested successfully with Version 8 Update 101.

Java Security settings

Java Security may block the installation of the Download Manager. You may see a window like the following.

Application blocked by Java Security due to a certificate problem

To resolve this issue, do the following.

  1. Select Start menu > Configure Java.
    The Java Control Panel appears.
  2. Select the Security tab.
  3. Click Edit Site List and then enter https://imaging.nci.nih.gov as the location.
  4. Click OK.
  5. Click the JNLP file to run the Download Manager again.
    A message window appears, asking you if you want to run this application.
  6. Select I accept the risk and want to run this application. 
  7. Click Run.
    Download Manager successfully launches.

    NBIA Download Manager

Removing items

The Download Manager initially lists everything in your data basket. You can remove items you do not want to download from the Download Manager. When you remove an item from the Download Item, you do NOT also remove it from the data basket.

To download objects using the Download Manager

Mac OS X

The following instructions apply to Windows PCs but you can also use the Download Manager on Mac OS X. Exit Disclaimer logo

  1. At the top of the My Data Basket page, click the Download Manager link. You are prompted to open or save the NBIA Download Manager. Open it in the  JRETM you installed. If you have any issues opening the NBIA Download Manager, see the note about Java Security settings.

     

         

 

The Download Manager lists all items you selected in the data basket. You can hover your mouse over the Patient ID, Study Instance, and Series Instance columns to reveal the complete corresponding IDs. You can also resize a column by selecting and dragging the column border.

  1. Click Browse to navigate to the destination where you want the images/annotations to be downloaded.

  2. Click Start to begin the download. You can monitor the download in the Progress column. The Status column indicates when the download for each item is complete.

    At any point in the process, you can click the Pause and Resume buttons to temporarily stop and restart the process.

    NBIA Download Manager, Downloads Complete

    Note that files downloaded this way are not compressed. The downloaded files are stored in a child folder under the destination folder such as Collection name/patient id/study instance UID/series instance UID/image SOP instance UID.

Deleting items

The Download Manager initially lists everything in your data basket. If you do not want to download any of those items, select them and then click Delete. When you remove an item from the Download Item, you do NOT also remove it from the data basket.

Network error?

If network errors occur during large downloads, Download Manager retries the files a configurable number of times.

Viewing Submission Reports

Permissions

This administrative feature is available only to logged in users who have "manage visibility" privileges, as defined in UPT. For more information, see Creating a New NBIA User.

When a site submits images to NBIA, a user with admin privileges can run various reports to verify that the images have been received and to monitor the status of the submitted images. This is accomplished in NBIA by generating a report with this information.

To view submission reports, follow these steps:

  1. Click Admin > View Submission Reports.
    The Submission Reports page appears.
    Submission Reports page
    The Collection//Site section displays all collections for which you, as an Admin, have permissions to view.
  2. Select a collection.
  3. Enter a valid date range or select one by clicking the calendar icons.
  4. Click the report type you want to run: Accrual, Image, or Annotation.
    The search begins and may take a few moments.

To assist in viewing the reports, use the following icons:

  • In the report results in the upper right segment of the page, click the Help button (help button) to learn details about the report type you selected.
  • Click the arrow at the left of the section to hide (hide button) or show (show button) the results.
  • To view an expanded view of the image report results, click the Expand icon (expand icon) preceding each row of the New Image or Corrected summaries.

The results display Count by Day details of the submissions. For example, for each day in the time frame, you can view a list of affected patient IDs, study instance UIDs and series instance UIDs.

Accrual Report

After you have submitted a query for viewing accrual reports, NBIA displays the results on a page shown in the following figure.
accrual report

Fields that appear on the report are described in the following table.

Submitted Files Counts Fields

Description

New Image

An image that does not exist in the system at the time of submission

Corrected Image

An Image that has been successfully submitted more than once. The time of the original image submission does not affect whether a subsequent image is considered as "corrected". Each time, an image is re-submitted in the time frame, the count is incremented.

New Patient

A patient that had no images submissions prior to the start of the date range, but at least one image submission within the date range

Updated Patient

A patient that had at least one image submission prior to the start of the date range, and at least one image submission within the date range

Corrected Patient

A patient that has at least one image submission in the time frame that has been corrected.

New Study

A study that had no image submissions prior to the start of the date range, but has at least one image submission within the date range

Updated Study

A study that had at least one image submission prior to the start of the date range, and at least one image submission within the date range

Corrected Study

A study that has at least one image submission in the time frame that has been corrected.

New Series

A series that no image submissions prior to the start of the date range, but has at least one image submission within the date range

Updated Series

A series that had at least one image submission prior to the start of the date range, and at least one image submission within the date range

Corrected Series

A series that has at least one image submission in the time frame that has been corrected

Report content

The reports contain a count of patient/study, series or images that have been affected during the date range in the specified collection/site. The exception to this is that affected counts will not be available for submissions made against versions of NBIA older than 4.3.

Image Submission Report

After you have submitted a query for viewing image submission results, NBIA displays the report on a page as shown in the following figure.

Image submission results display a count of patients, studies or series for or to which an image was submitted during the specified date range in the collection or site you selected. Fields that appear on the report are described in the following table.

Submitted Files Counts Fields

Description

New Image

An image that does not exist in the system at the time of submission

Corrected Image

An Image that has been successfully submitted more than once. The time of the original image submission does not affect whether a subsequent image is considered as "corrected". Each time, an image is re-submitted in the time frame, the count is incremented

Affected Patient/Study/Series

A patient/study/series is one for which there was at least one new image submission

Corrected Patient/Study/Series

A patient/study/series that has at least one image submission that has been corrected in the time frame.

Report content

The reports contain a count of patient/study, series or images that have been affected during the date range in the specified collection/site. The exception to this is that affected counts will not be available for submissions made against versions of NBIA older than 4.3.

Annotation Submission Report

After you have submitted a query for viewing annotation submission results, NBIA displays the report on a page as shown in the following figure.
annotation submission report

The annotation submission report contains a count of annotations submitted and affected patient/study/series during the specified date range for that collection site. Fields that appear on the report are described in the following table.

Submitted Files Counts Fields

Description

Annotation

An annotation that has never been submitted in the system prior to the start of the date range

Corrected Image

A patient/study/series is one for which there was at least one new annotation submission

Report content

The reports contain a count of patient/study, series or images that have been affected during the date range in the specified collection/site. The exception to this is that affected counts will not be available for submissions made against versions of NBIA older than 4.3.

Using the Quality Control Tool

Permissions

This administrative feature is available only to logged in users who have "manage visibility" privileges, as defined in UPT. For more information, see Creating a New NBIA User.

When an image is uploaded to NBIA, it is not made public immediately. A curator takes it through a quality control process to ensure that no private patient data is available, the image is of good quality, and so forth. Using the NBIA QC tool as a curator, you can define search criteria to locate image series for you to evaluate. You can then evaluate the submission and assign the QC status to an image or image series.

QC tool search visibility

The QC tool allows a curator to search "non-visible" or "not reviewed" images, whereas a regular user using the search tool can only see approved public images.

Classic Search

To perform a classic search

  1. Click Admin > Perform QC. This opens the QC Tool page to the Classic tab, shown below. You can specify basic search criteria on this tab. You can construct more specific search criteria on the Dynamic tab.

    QC Tool, Classic View

    Do not click your browser's Back or Refresh button while following these steps. This logs you out.

  2. Check the QC Status for the series you want to locate. The options are described in the following table:

    Submitted Object Status

    Description

    Not VisibleNo images in the series are visible.

    Not Yet Reviewed

    This status (selected by default) is automatically assigned to an image upon submission to the NBIA database.

    First Review to Seventh A configurable user-defined stage in the workflow of an image series.

    To Be Deleted

    Selected image series are to be deleted from the system.

    VisibleAll images in the series are visible.
    DownloadableTest the visibility of images in the series. This allows for downloading when set.  It also separates the test cases from released cases.
  3. In the Collection(s) field, select one collection (site) that you want to search. You cannot search multiple collections (sites) at one time.

  4. In the Batch Number field, select the batch number of the images/series for which you want to search.
  5. In the Confirmed as COMPLETE field, select Yes to search for a set of images/series that has been confirmed as complete, or No to search for a set of images/series that is ongoing.
  6. In the Released field, select Yes to search for images/series that have been released or No to search for images/series that have not been released.

  7. To restrict results to a list of patient IDs, in the Patient ID panel, enter the list of patient IDs and select Add Criteria to perform the search. Separate multiple patient IDs with commas.
    Patient ID field with patient IDs. 

  8. In the From and To boxes, enter the most recent submission date range by selecting a date in the calendar or by using the format mm/dd/yyyy.

  9. Click Submit. NBIA searches for image series that match the criteria you define.

See also Understanding QC Tool Search Results.

Dynamic Search

To perform a dynamic search

  1. Click Admin > Perform QC. Select the Dynamic tab, shown in the following figure. The Dynamic tab allows you to construct specific search criteria.

    Do not use the back button nor the refresh button in these steps, either of which will return the page back to the previous page.

    QC Tool, Dynamic View

  2. Check the QC Status for the series you want to locate. The status options are described in the following table.

    QC Status

    Description

    Not VisibleNo images in the series are visible.

    Not Yet Reviewed

    This status (selected by default) is automatically assigned to an image upon submission to the NBIA database.

    First Review to Seventh A configurable user-defined stage in the workflow of an image series.
    To Be DeletedSelected image series are to be deleted from the system.

    Visible

    All images in the series are visible.

    DownloadableTest the visibility of images in the series. This allows for downloading when set.  It also separates the test cases from released cases.
  3. In the Batch Number field, select the batch number of the images/series for which you want to search.
  4. In the Confirmed as COMPLETE field, select Yes to search for a set of images/series that has been confirmed as complete, or No to search for a set of images/series that is ongoing.
  5. In the Released field, select Yes to search for images/series that have been released or No to search for images/series that have not been released.
  6. In the From and To boxes, enter the most recent submission date range by selecting a date in the calendar or by using the format mm/dd/yyyy.
  7. For each criterion you select, click the green (+) symbol. This confirms the selection and displays the criterion above the first Submit button.
  8. To select more criteria, do so in the Construct Criteria section. Options under the drop-down arrows change according to the group you select. You can also specify the Boolean AND or OR to express relationships among criteria.
  9. Click Submit. NBIA searches for image series that match the criteria you define.

See also Understanding QC Tool Search Results.

Understanding QC Tool Search Results

Curators use the QC tool to work with images that are not yet available to the public.

After you submit search criteria in the QC tool, you can do the following on the search results page.

QC Tool

Viewing Image Series

Your search results appear in a table in the QC Images by Series section of the QC Tool page.

QC Images by Series showing one result

In addition to viewing image series details in the table, you can view them as thumbnails or in the DICOM viewer.

Viewing Thumbnails

In the Thumbnails column, click View to see image series details.

The Series Details page appears, displaying the first image in the series on the left and the DICOM tags for the image on the right. If there is more than one image in the series and DICOM tags for each image, you can view an animated slide show of the images in the series. For more information about the controls in the animated slide show, see Viewing Image Animation. The DICOM tags change when you view a different image in the series.

If the image series modality is Ultrasound, you can view each image in the series in multi-frame, as shown below. You can move to other images in the series by selecting them from the drop-down list.


Series Details page

If the collection you selected for viewing includes sequence information, the annotations show the sequence data identified by a (>) to the left of the Element column, as shown below.

Series Details page showing arrows that indicate sequence data

Viewing Image Series in the DICOM Viewer

In the DICOM Viewer column, click View to open the image series in the Oviyam DICOM viewer. For more information, see Using the Oviyam Viewer for NBIA.

Changing Image Series Status

As a curator, you may need to change the status of one or more images or image series. You can change the status of one or more selected images or image series individually or as a batch update.

Before you can change the status of an image or image series, you must use the QC Tool to find it. You must then select the image or image series you want to change.

Status options include:

QC Status

Description

Not Yet Reviewed

This status (selected by default) is automatically assigned to an image upon submission to the NBIA database.

Visible

All images in the series are visible.

Not Visible

No images in the series are visible.

To Be Deleted

Selected image series are to be deleted from the system.

First Review to SeventhA configurable user-defined stage in the workflow of an image series.
DownloadableTest the visibility of images in the series. This allows for downloading when set.  It also separates the test cases from released cases.

If you change the status of an image series, the change is also reflected in any shared lists to which the image series belongs. If you attempt to change the status of an image series that is in a shared list, an alert message appears, detailing to which shared lists the selected image series belong(s).

To change image series status

  1. Select Admin > Perform QC. The QC Tool page appears.
    Scroll down to the QC Images by Series section.

    QC Tool, QC Images by Series and Perform Bulk QC Operations

  2. Select the image(s) or series for which you want to change the status.
    • To select a single image in a series, click View in the Thumbnails column, then use the cine tool to locate the image you want to change.
    • To select a single series, select the box in the search results table corresponding to the image series you want to change.
    • For a bulk update, select multiple image series in the search results table or click Check All, which is above and below the search results table.

      Selecting images to QC

      The Check All and Uncheck All buttons in the QC Images by Series section of the QC Tool page apply to all of the results of your search. The box to the left of the Submission Date column only selects the series in that row of the results table.

  3. In the Perform Bulk QC Operations section, select the new status you want to assign to the selected image or series.
  4. In the Change Log box, describe the nature of the image status change. This text will be part of the QC Status report you can generate to track changes in visibility. See Generating a QC Status Report.
  5. Click Update to update the selected image(s) or series.

After the image series' status has been changed, the status column of the image series in the search results table on the QC Tool page also changes.

Generating a QC Status History Report

To view the status change log from the QC Tool page search results, select the series you want to appear in the report and then click Generate Report.

The QC Status History Report appears, displaying all changes that have been made to the status of the series you selected.

QC Status History Report

Click Back to QC Tool to close this window and return to the QC tool.

Generating a QC Status Report

To view the status change log from the QC Tool page search results, select the series you want to appear in the report and then click Generate Report.

The QC Status History Report appears, displaying all changes that have been made to the status of the series you selected.

QC Status History Report Page

Click Back to QC Tool to close this window and return to the QC tool.

Approving Image Deletions

Permissions

This administrative feature is available only to logged in users who have "manage visibility" privileges, as defined in UPT. For more information, see Creating a New NBIA User.

This function is part of a two-tier deletion process. You, as a super curator, can approve the deletion of image series that have been identified as "To be deleted".

To approve series deletions, follow these steps:

  1. Click Admin > Approve Deletions.
    The Approve Deletions page appears.
  2. From the Collection(s) list, select a collection (site).
  3. Optionally, enter Patient IDs. Separate multiple IDs by commas.
  4. Click Submit to initiate a search for the series marked for deletion.
  5. From the results, click View to review the detail for an individual series. From the page that opens, click Delete to approve the deletion. Click the Skip button to go to the next series.

    Tip

    If you click Skip, this signals that you do not approve the deletion. If that is so, you should generate a report to see who requested the deletion and work with that person to resolve any deletion disagreement.

  6. For batch deletion, select the checkbox for one or more series and click Delete to approve the deletion.

Image series approved for deletion are still visible in the system, identified as "To Be Deleted". They are removed from the system at a system-configured time, such as at midnight (called an "off-line deletion"), unless a manual deletion (called an "online deletion") is performed. For more information, see Manually Deleting Image Series.

About deletions

  • After an image series is approved for deletion, the action cannot be reversed.
  • Any new image submissions to a series identified "To be deleted" will be successful, but the status of the series does not change.
  • Images submitted to files that are "Deleted" are quarantined.

Manually Deleting Image Series

Permissions

This administrative feature is available only to logged in users who have "manage visibility" privileges, as defined in UPT. For more information, see Creating a New NBIA User.

This function is part of a two-tier deletion process. You, as a Delete Admin, can execute the online deletion of image series that are "approved for deletion". This function immediately removes images that are approved for deletion rather than waiting for the next scheduled system-wide deletion job.

To manually delete series, follow these steps:

  1. Click Admin > Perform Online Deletion.
    A list of image series that have been approved for deletion appears.
  2. Click Delete to execute the real time series removal.

    Deleting individual series?

    All series listed in this page are deleted. There is no way to specify individual series for online deletion.

Editing a Collection Description

Permissions

This administrative feature is available only to logged in users who have "manage visibility" privileges, as defined in UPT. For more information, see Creating a New NBIA User.

This feature allows you as an administrator to enter a brief description for a collection so the NBIA user knows what type of data comprises the collection.

To edit a collection description, follow these steps:

  1. Click Admin > Edit Collection Description.
    The Edit Collection Descriptions page appears.
  2. From the Select Collection Name list, select a collection name.
  3. In the text box, enter a description or edit an existing description for the collection. Use the text formatting tools to format the text, if you like. If appropriate, you can add a hyperlink to a resource such as a wiki with a longer description.

The description displays on the simple/advanced search screen when you click the (?) button next to the collection name.

Creating a clickable link

To make a link clickable in this section, select Rich for Toolbar Selection, select Source  and create a link as shown in the following example:

         <span contenteditable="false"><a href="https://www.google.com" target="_blank"><span>Link To Be Created</span> </a></span></p>

If you want to edit the link, select the Source button and set contenteditable to true.

Managing Workflow Items 

Permissions

This administrative feature is available only to logged in users who have "manage visibility" privileges, as defined in UPT. For more information, see Creating a New NBIA User.

A workflow is a business process that, in the case of NBIA, an image series must pass through before it is published. Since it is a business process, these steps must be defined first within an organization. NBIA allows you to change the visibility status of an image series. This visibility change is part of the definition of a workflow item. Workflow items can also trigger a web service call to a URL. When you define a workflow item, you specify a name for it, the type of action that will take place during it (such as a visibility change), which image collection and site are involved, and the URL of a web service if the information resulting from this workflow item should be sent to one.

You can create, edit, and delete workflow items.

Creating a Workflow Item

  1. Select Admin > Manage Workflow Items.
    The Manage Workflow Items page appears.
    Manage Workflow Items page
  2. Click Create Workflow.
    The Workflow Item page appears.

    Workflow Item page

  3. In the Name box, specify a name for the new workflow item. The name cannot be longer than 50 characters.

  4. From the Type list, select Visibility Change or New Series.


    • Select the Visibility Change option when editing an existing workflow item. A visibility change occurs when the workflow item triggers a web service call to the URL you have entered in the URL field on this page.

    • Select the New Series option if you want the result of this workflow item to create a new image series. You can add this new series to a collection in the next step.

  5. From the Collection list, select an existing image collection to which this workflow item should apply. Existing image collections are in the Collection list.  If you need to create a new collection to apply to this workflow item, enter it in the New Collection for List box and then click Add to Collection List.
  6. From the Site list, select an existing site. Existing sites are in the Site list. If you need to create a new site to apply to this workflow item, enter it in the New Site for List box and then click Add to Site List.
  7. To send information in this workflow item to a web service, enter the web service's URL in the URL box.
  8. Click Save.
    The new workflow item appears on the Manage Workflow Items page.

Editing a Workflow Item

You can edit a workflow item's name, collection/site, and

  1. Select Admin > Manage Workflow Items.
    The Manage Workflow Items page appears.
    Manage Workflow Items page
  2. Click the Edit button in the row of the workflow item you want to edit.
    The Workflow Item page appears, showing the values already set for the workflow item you selected.
    Workflow Item page
  3. Edit the name, type, collection, site, or URL as needed, consulting Creating a Workflow Item for details on these steps.
  4. Click Save.

Deleting a Workflow Item

  1. Select Admin > Manage Workflow Items.
    The Manage Workflow Items page appears.
    Manage Workflow Items page
  2. Click delete button in the row of the workflow item you want to delete.
    You are prompted to confirm the deletion.

Creating Workflow items

  1. Select Admin > Manage Workflow Items.
    The Manage Workflow Items page appears.
    Manage Workflow Items page
  2. Click Create Workflow.
    The Workflow Item page appears.

    Workflow Item page

  3. In the Name box, specify a name for the new workflow item. The name cannot be longer than 50 characters.

  4. From the Type list, select Visibility Change or New Series.


    • Select the Visibility Change option when editing an existing workflow item. A visibility change occurs when the workflow item triggers a web service call to the URL you have entered in the URL field on this page.

    • Select the New Series option if you want the result of this workflow item to create a new image series. You can add this new series to a collection in the next step.

  5. From the Collection list, select an existing image collection to which this workflow item should apply. Existing image collections are in the Collection list.  If you need to create a new collection to apply to this workflow item, enter it in the New Collection for List box and then click Add to Collection List.
  6. From the Site list, select an existing site. Existing sites are in the Site list. If you need to create a new site to apply to this workflow item, enter it in the New Site for List box and then click Add to Site List.
  7. To send information in this workflow item to a web service, enter the web service's URL in the URL box.
  8. Click Save.
    The new workflow item appears on the Manage Workflow Items page.

Managing Saved Queries

You can review and delete queries saved by users in NBIA.

Permissions

This administrative feature is available only to logged in users who have "manage visibility" privileges, as defined in UPT. For more information, see Creating a New NBIA User.

Reviewing Saved Query Information

To review a saved query

  1. Select Admin > Manage Saved Queries.
    The Manage Saved Queries page appears listing all the queries saved by NBIA users.
    Manage Saved Queries page
  2. The following information is listed for each query.

    Sorting the table

    By default the table is sorted by Query Name, but you can also sort by the Last Executed or Query Creator columns.

    Column NameDescription
    Query Name

    Click the name of the query to display the Criteria Selected by the user. The selected field name(s) and data are listed.

    Query Name Criteria Selected

    Last ExecutedLists the date and time that the query was run.
    New Data AvailableNew Data icon. Exclamation pointindicates that new data is available.
    Query CreatorUser name of the person who saved the query.

Deleting a Saved Query

To delete a saved query

  1. Select Admin > Manage Saved Queries.
    The Manage Saved Queries page appears.
    Manage Saved Queries page
  2. Check the box next to the Query Creator column of a query to be removed. You can delete multiple queries at once.

    Removing All Saved Queriese

    To remove all of the saved queries, check the box next to column name, Query Creator. All queries are selected.

    Delete Saved Queries page

  3. Click Remove Selected Items.
    You are prompted to confirm the deletion and the selected queries are removed.

Managing Users

Once a user submits data, an NBIA administrator uses the User tab to add the user to NBIA. A user must be created in LDAP for an NBIA administrator to manage data access privileges.

What to do if the user is not in LDAP

To be added to LDAP, a user must submit a request to Application Support.

Adding a User to NBIA

To add a user to NBIA

  1. From the User tab, click Add User.
    The User Details dialog box appears.
    Entering User Details
  2. Add the user's Login Name. The login name is not case-sensitive.
  3. Add a valid Email address of the user.
  4. To activate the user, select Active Status. To deactivate the user in NBIA, clear Active Status.
    Click x to return without saving.

  5. Click Save to save the changes.
    The user is added to NBIA and the table.

Finding a User

To find a user on the User tab, add term(s) to one or more column header boxes on the User tab to narrow the list.

In the following example, the displayed users have 5523 in the Login Name and nlsc in the Email.

Example of a column search

Updating User Information

To update user information

  1. Find the user on the User tab.

  2. Click Edit User icon.
    The User Details dialog box appears.
    The Login Name cannot be updated.

  3. Update the Email address as needed.

  4. For an active user, maintain Active Status. To deactivate the user in NBIA, clear Active Status.

    Click x to return without saving.

  5. Click Save to save the changes.

    The user information is updated in the table.

Deactivating a User

A user cannot be deleted from NBIA, only deactivated.

To deactivate a user

  1. Find the user on the User tab.

  2. Click Edit User icon.
    The User Details dialog box appears.

  3. Clear the Active Status box and then click Save.
    The user's Active Status value changes to False.

Managing Protection Groups

An NBIA administrator uses the Protection Group tab to add protection groups and assign protection elements to limit data access and visibility by image collection and site(s).

Protection elements are created automatically

NBIA now automatically creates protection elements when data is submitted based on the image collection and site(s).

Adding a Protection Group

To create a protection group

  1. From the Protection Group tab, click Add Protection Group on the Protection Group tab.

    The Add Protection Group dialog box opens.
    Adding a Protection Group

    The following table lists and describes protection group information.

    Name

    Description

    Protection Group Name

    Start the name with "NCIA” and enter your name of choice.

    NBIA vs NCIA

    While the name of NCIA (National Cancer Imaging Archive) has been changed to NBIA (National Biomedical Imaging Archive), until notified otherwise, the acronym in the User Authorization Tool remains NCIA.

    Protection Group Description

    Add a description (optional).

    Click x to return without saving.

  2. Click Save to save the changes.
    The protection group is added to the table.

Associating Protection Elements with a Protection Group

Once you create the necessary protection group(s), assigning the associated protection element(s) is the beginning of setting up security for a collection's visibility in NBIA. The protection element identifies the collection, as well as the site, associated with the data.

Data Access and Protection Elements

If the protection element is set to Public, a user can be assigned the Public role and have access. For limited access to the data, assign a user to a protection group and a role that allows the user data access.

To associate a protection element

  1. Find the protection group on the Protection Group tab.
  2. Click Assign Protection Group icon in the Assign Protection Element column.
    The Add Protection Element(s) to Protection Group dialog box opens.
    Assigning Protection Elements to a Protection Group
  3. Click Available Protection Elements.

  4. Select the elements to be associated with the protection group.

    Narrowing a List

    To narrow a list, type the name or part of the name next to the magnifying glass icon (Magnifying Glass Icon to narrow list of Protection Elements).

    Click x to return without saving.

  5. Click Add to save the changes.

  6. The Associated Protection Element(s) column lists the elements that you added.

    In the following example protection element, NCIA.SportInjury//ACL

    1. NCIA.SportInjury is the collection.
    2. ACL is the site.

      Multiple Sites

      If there are multiple sites for a collection, you might want to create a protection group for each site. This process would grant access to verify submissions per site.

Removing Protection Elements from a Protection Group

To remove an element from a group

  1. Find the protection group on the Protection Group tab.
  2. Click Remove Protection Element Icon in the Remove Protection Element(s) column.
    The Remove Protection Element(s) from Protection Group dialog box opens.
    Remove Protection Elements from Protection Group
    The Protection Group Name cannot be changed.
  3. Click Included Protection Elements, and select the elements to remove.

    Narrowing a List

    To narrow a list, type the name or part of the name next to the magnifying glass icon (Magnifying Glass Icon to narrow list of Protection Elements).

    Click x to return without saving.

  4. Click Remove to save the changes.
    The protection element(s) is no longer listed in the Associated Protection Elements column.

Finding a Protection Group

On the Protection Group tab, you can perform a global search or a column search both described in the following table.

 You can perform both searching techniques to further filter a list, but do not forget to clear the search boxes to expand the list.

Type of SearchPerforming a Search
Global Search

You can search for a term or part of a term in all the protection group columns in the table. All protection groups with the partial/term, are returned for the search.

In the following example, a Global Search of colonography finds protection groups with the word in the Protection Group name and the Associated Protection Elements.

Global Search for Protection Group
Column Search

You can also find protection groups in the table by adding a term to a column header or more than one column header to further narrow the list.

In the following example, bbb in the Protection Group column and demo in the Description column, displays two results.

Column Search for Protection Group

Updating a Protection Group Description

To update the assigned role(s)

  1. Find the protection group on the Protection Group tab.
  2. Click Edit Protection Group, and the Protection Group Details dialog box opens.
    The Protection Group name cannot be updated

  3. Update the group Description.

    Click x to return without saving.

  4. Click Save to save the changes.

Deleting a Protection Group

To delete a row from the table

  1. Find the protection group on the Protection Group tab.
  2. Click Edit Protection Group, and the Protection Group Details dialog box opens.

    Click x to return without deleting.

  3. Click Delete, and the row is removed from the table.

Adding Protection Groups and Assigning Roles

Once protection groups are set up, an NBIA administrator uses the User Authorization tab to add protection group(s) with associated role(s) to a user account. With this combination, the user can only access the protection group data in the way specified by the role.

For example, John Smith needs to be a curator within the Mouse Astrocytoma protection group, so user johnsmith is assigned to protection group NCIA Mouse Astrocytoma as role CURATOR.

NBIA vs NCIA

While the name of NCIA (National Cancer Imaging Archive) has been changed to NBIA (National Biomedical Imaging Archive), until notified otherwise, the acronym in the User Authorization Tool remains NCIA.

Assigning a User to a Protection Group

To assign a user to a protection group and assign roles

  1. From the User Authorization tab, select a user from the list.

    Super Administrator

    If you add a Super Administrator to one protection group, the Super Administrator rights extend to all of the protection groups.

    Select a user to add to protection group(s)

  2. Click Add Protection Group and Access Role.
    The Grant Access to Selected User dialog box opens.
    Assign Protection Group(s) and Role(s) to user
  3. Click Protection Group,and select the protection group(s) as necessary.

    Narrowing a List

    To narrow a list, type the name or part of the name next to the magnifying glass icon (ADD).

  4. Click Roles, and assign roles using the same technique.
    The following table lists and describes the roles available in NBIA.

    RoleDescription of Role
    NCIA ADMIN

    Access the User Authorization Tool to manage users

    NCIA CURATE

    Add or modify curation data

    NCIA DELETE_ADMIN

    Super Administrator role for deletions

    NCIA MANAGE_COLLECTION_DESCRIPTION

    Manage collection descriptions

    NCIA MANAGE_VISIBILITY_STATUS

    Access the Quality Control (QC) Tool

    NCIA READ

    Public role for searching

    NCIA SUPER_CURATOR

    Super Administrator role for approving deletions

    NCIA VIEW_SUBMISSION_REPORT

    Access the Submission Reports option to verify submissions.

    Click x to return without saving.

  5. Click Save to save the changes. 

    The row is added to the table.

    Working with the Table

    To adjust how the table is sorted, click the arrows in the column header. To narrow the list, type the name or part of the name in the column header. You can also enter information in multiple column headers to further narrow the list.

Updating Protection Group Access

To update the assigned role(s)

  1. From the User Authorization tab, click Update Access icon, and the Grant Access to Selected User dialog box opens.
    The Login Name and Protection Group cannot be updated
  2. Click Roles, and select the role(s) as necessary.

    Updating access to Protection Group

    Narrowing a List

    To narrow a list, type the name or part of the name next to the magnifying glass icon (ADD).

    Click x to return without saving.

  3. Click Update to save the changes.
    The changes are in the Associated Access Role(s) column

Deleting a Protection Group with Roles

To delete a row from the table

  1. From the User Authorization tab, click Update Access icon, and the Grant Access to Selected User dialog box opens.

    Click x to return without deleting.

  2. Click Delete.

    Update and Delete Access

    The row is removed from the table.

 

  • No labels