Page History

This guide explains how to use the administrative features of TCIANBIA.

Administration Functions Overview

Administration privileges for TCIA are assigned by The Cancer Imaging Archive Support group, who can be reached at help@cancerimagingarchive.net or +1.385.275-8242 (ASK-TCIA).

Security applies to all administration tools in TCIANBIA. When you log into TCIANBIA, only the administration tools for which you have been granted permissions are visible in the Admin menu. Their use is described on this page.

Return to top of page

Creating a New

...

NBIA User

Only a TCIA an NBIA administrator can create new users for TCIANBIA.

Before TCIA Before NBIA users can be created, an administrator with access to the User Authorization Tool must register the NCIA application and assign an admin user to the NCIA application there. The  The administrator can then assign users to TCIA to NBIA and roles to each user. The following table describes the role structure in TCIANBIA.

The roles you assign allow a user to perform tasks in TCIA. Additionally, an administrator can perform the following tasks:

...

For more information about creating new TCIA users/user groups and performing other tasks in the User Authorization Tool, see the User Authorization Tool documentation.

Return to top of page

Using the QC Tool

Return to top of page

Deleting Image Series

As an administrator, you can assist in the two-tier process of deleting TCIA data. To do so, you must have been granted specific roles. For more information about the roles and the deletion processes, see TCIA 6 - NBIA Administrator's Guide and Manually Deleting Image Series.

Approving Image Deletions

Return to top of page

Manually Deleting Image Series

Return to top of page

Viewing Submission Reports

Return to top of page

Accrual Report

Return to top of page

Image Submission Report

Return to top of page

Annotation Submission Report

Return to top of page

Editing a Collection Description

Return to top of page

Managing Workflow Items

Return to top of page

Managing Saved Queries

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

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 TCIA users.
   

2. The following information is listed for each query.

   Info
   icon false title 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 Name	Description
   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. Image Modified
   Last Executed	Lists the date and time that the query was run.
   New Data Available	Image Modifiedindicates that new data is available.
   Query Creator	User 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.
   

2. Check the box next to the Query Creator column of a query to be removed. You can delete multiple queries at once.

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

   

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

Return to top of page

Using the User Authorization Tool

Administrators use the User Authorization tool to manage data access by users, user groups, protection groups, and roles.

Topics in this section include:

• TCIA 6 - NBIA Administrator's Guide
• Managing Users
• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide

Accessing the User Authorization Tool

To access and use the User Authorization Tool, you must be a TCIA administrator.

1. Log in to TCIA.
2. Select Admin > User Authorization Tool.
   The User Authorization Tool appears, open to the User tab.
   

Return to top of page

Managing Users

Once a user submits data, an administrator adds the user to TCIA. The administrator must create the user in LDAP to manage data access privileges.

Managing users involves:

• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide

Adding a User to TCIA

1. Select Admin > User Authorization Tool.
   

2. Select the User tab.

3. Click .
   The User Details dialog box appears.
   
4. Add the user's Login Name. The login name is not case-sensitive.
5. Add a valid Email address of the user.

6. To activate the user, select Active Status. To deactivate the user in TCIA, clear Active Status.

7. Click  to save the changes. 
   The user is added to TCIA and the table on the User tab.

Return to top of page

Finding a User

To find a user on the User tab, narrow the list by adding one or more characters to one or more column header boxes.

In the following example, the displayed users have 5523 as part of their login name and nlsc in their email address.

Return to top of page

Updating User Information

1. Select Admin > User Authentication Tool.
2. Select the User tab.

3. Find the user whose information you want to update.

4. Click .
   The User Details window appears.
   

5. Update the Email address as needed. The Login Name cannot be updated.

6. For an active user, maintain Active Status. To deactivate the user in TCIA, clear Active Status.

7. Click Save to save the changes.
   The user information is updated in the table.

Return to top of page

Deactivating a User

A user cannot be deleted from TCIA, only deactivated.

1. Select Admin > User Authentication Tool.

2. Select the User tab.

3. Find the user you want to deactivate.

4. Click .
   The User Details window appears.
   

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

Return to top of page

Managing Protection Groups

A TCIA 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).

...

• Adding a Protection Group
• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide

Adding a Protection Group

1. From the Protection Group tab, click Add Protection Group.
   The Add Protection Group window appears.
   

   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. Info title No Special Characters Do not use special characters such as # or \ in group names.
   Protection Group Description	Add a description (optional).

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

Return to top of page

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 TCIA. The protection element identifies the collection, as well as the site, associated with the data.

...

1. On the Protection Group tab, find the protection group.
2. Click  in the Assign Protection Element column.
   The Add Protection Element(s) to Protection Group window appears.
   

3. Click Available Protection Elements.

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

   Info
   title Narrowing a List
   To narrow a list, type the name or part of the name next to the magnifying glass icon ().

5. Click  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

   • NCIA.SportInjury is the collection.

   • ACL is the site.

     Info
     title 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.

Return to top of page

Removing Protection Elements from a Protection Group

1. On the Protection Group tab, find the protection group.
2. Click  in the Remove Protection Element(s) column.
   The Remove Protection Element(s) from Protection Group window appears.
   
   The Protection Group Name cannot be changed.

3. Click Included Protection Elements, and select the elements to remove.

   Info
   title Narrowing a List
   To narrow a list, type the name or part of the name next to the magnifying glass icon ().

   Click x to return without saving.

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

Return to top of page

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.

Type of Search	Performing 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 characters you entered are returned. 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. Image Modified
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. Image Modified

Return to top of page

Updating a Protection Group Description

1. On the Protection Group tab, find the protection group you want to update.

2. Click .
   The Protection Group Details window appears.

3. Update the group description.
   Note that you cannot update the protection group name.

4. Click  to save the changes.

Return to top of page

Deleting a Protection Group

1. On the Protection Group tab, find the protection group you want to delete.

2. Click .
   The Protection Group Details window appears.

3. Click .
   The row is removed from the table.

Return to top of page

Managing User Groups

TCIA administrators create user groups to limit data access and visibility by protection group and user role. Before or after creating user groups, you can assign users and roles to protection groups.

Managing user groups involves:

• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide

Viewing Protection Groups and Roles Associated with a User Group

1. Select Admin > User Authentication Tool.

2. Select the User Group tab.

   

3. Click the arrow in the first column to see the protection group(s) and role(s) associated with the user group in that row.
   
   The row expands to show the protection group(s) and role(s) associated with that user group.
   

Return to top of page

Modifying Protection Groups and Roles for a User Group

1. View the protection group(s) and role(s) for a selected user group.
2. Click .
   The Modify Authorization for Selected User Group window appears.
   
3. To change the roles associated with this protection group, open the Role list. Click or clear the checkboxes you want to add or remove, respectively. Click .
4. To remove this protection group from this user group, click .

Return to top of page

Assigning a Protection Group and Role to a User Group

You can associate a user group with a protection group and one or more roles.

...

1. Select Admin > User Authentication Tool.

2. Select the User Group tab.

   

3. In the row associated with the user group whose access you want to specify, click .
   The Add Protection Group to Selected User Group window appears.

4. Open the Protection Group list and click one protection group to select it. 

   Info
   title Narrowing a List
   To narrow the list of protection groups, type the name or part of the name next to the magnifying glass icon (). All protection groups with the characters you entered are returned.

    
   The list closes and shows your selection in the window.

5. Open the Role list and and click the box to the left of each role you want to assign to the selected protection group. 

   Info
   title Narrowing a List
   To narrow the list of roles, type the name or part of the name next to the magnifying glass icon (). All protection groups with the characters you entered are returned.

   
   The list closes and shows your selection(s) in the window.

6. Click .
   The user group is now associated with the selected protection group and roles.

Return to top of page

Deleting a User Group

Deleting a user group does not delete the users in it.

...

1. Select Admin > User Authentication Tool.

2. Select the User Group tab.

   

3. In the row of the user group you want to delete, click .
   The Delete the Following Group? window appears.
4. Click .
   The user group no longer appears in the list.

Return to top of page

Adding Protection Groups and Assigning Roles

A TCIA administrator creates protection groups to limit data access and visibility by image collection and site(s). Administrators add users to protection groups and can then further manage their access by assigning them one or more roles. Users can only access the protection group data in the way that the role specifies.

...

Topics in this section include:

• TCIA 6 - NBIA Administrator's Guide
• TCIA 6 - NBIA Administrator's Guide with Roles
• TCIA 6 - NBIA Administrator's Guide

Adding a Protection Group

1. Select Admin > User Authentication Tool.
2. Select the Protection Group tab.
3. Scroll down to the bottom of the page and click .
   The Protection Group Details window appears.
   

4. Enter a name for the new group and optionally, a description.

   Info
   title No Special Characters
   Do not use special characters such as # or \ in group names.

5. Click .
   The protection group appears on the Protection Group tab.

Return to top of page

Assigning a User to a Protection Group with Roles

...

1. Select Admin > User Authentication Tool.

2. Select the User Authorization tab.

   

3. Select a user from the list.
   A page listing the protection groups and access roles associated with the selected user opens.
   

4. Click .
   The Grant Access to Selected User window opens.
   

5. From the Protection Group list, select the group to which you want to assign the user.

6. From the Role list, select the access role that the user should have in that protection group.
   The following table lists and describes the access roles available in TCIA.

   Anchor accessrole accessrole Access Role	Description of Access 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.

7. Click Save to save the changes.

   The row is added to the table.

   Info
   title 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.

Return to top of page

Changing a User's Access Role Within a Protection Group

1. Select Admin > User Authentication Tool.

2. Select the User Authorization tab.

   

3. Select a user from the list.
   A page listing the protection groups and access roles associated with the selected user opens.
   

4. In the row of the protection group you want to change, click .
   The Grant Access to Selected User dialog box opens.
   

   

5. To change the user's access to roles in this protection group, click the down arrow to open the Role list. Select the boxes next to roles you want to assign to the selected user. Clear the boxes next to roles you do not want the user to have. Click  to save your changes.

   To delete a role, open the Role list, select a role, and click .

   The User Authentication tab appears.

Return to top of page

Resolving Errors in the User Authorization Tool

The following table lists and describes how to resolve error messages returned by the User Authorization Tool (UAT). Error messages appear in a red box.

Return to top of page