Skip to content
  • There are no suggestions because the search field is empty.

Linking Assessments to Program Enrollments 

Learn how to link an assessment recorded at the agency level to an active program enrollment, and how to unlink it, in Clarity Human Services.

Table of Contents

Overview

Users can link an existing agency-level assessment to an active program enrollment.

In the client's program enrollment, the Program assessments header in the Assessments workspace has an Action Menu (three dots) icon with a Link from Assessment option. 

  • If they have an access role that allows them to modify the client program.
  • If there is an assessment available to link.
Link from Assessments

Note: You can only link assessments recorded at the same agency as the enrollment. Ensure that you are switched into the correct agency, and that the same agency provided both the assessment(s) and enrollment.

What System Administrators need to do: For an assessment to be available to link, a System Administrator must complete both of the following in the program's setup. These steps are required.

  • Enable the Program Assessments setting.
  • Add the assessment under Program Resources > Program Assessments.

If these steps are not completed, no assessments are available to link, and the Link from Assessment option does not appear. For setup steps, refer to How to Set Up a Program: Detailed Instructions. 

If the user does not have the appropriate access or there is no assessment to link, the user will not see the action menu icon with the option to “Link from Assessment.”

Linking Assessments

When the user clicks the “Link from Assessment” option, a panel opens up on the right side of the screen titled “Link from Assessment.”

The panel will have two columns:

  • “Name” - Assessment Name
    • Users can sort the list alphabetically by Assessment Name.
  • “Date Completed” - The date the client completed the assessment
    • There is a default sort to display the most recently completed assessments first.

Link from Assessments Modal

For Assessments that have been marked as “Private," a Privacy (lock) icon displays.

Link from Assessments Page

The panel displays only assessments that are not linked to the current enrollment.

To link the assessment, the user can select the checkbox to the left of each displayed Assessment row, then click Save. 
 
Clicking Save links the checked assessments, and they appear in the program enrollment's Assessments workspace and the client's History workspace. To close the panel without linking, click Cancel or the X icon. 
 
Link Assessment_Checked
 

Note: The workspace displays any assessments the client has completed in a different program within the same agency as the current program enrollment, as long as the assessment type is enabled for the current program.

Unlinking Assessments

Users can unlink an assessment from an active program enrollment. This option will only appear for users with the Delete Agency Assessment or Delete Any Agency Assessment access right enabled. Refer to Rights Glossary for Access Roles.

Next to each assessment on the list, “Unlink from Program” appears in the action menu for users with the appropriate access and for assessments linked to a program.

Unlink Assessment from Program

 Click Confirm to unlink the assessment from the program enrollment, or Cancel to keep it linked. 

The pop-up reads: “Are you sure you want to unlink [assessment name] assessment from [program name that the assessment is linked to]?”

Confirm Unlink

When the user clicks Confirm, the assessment will be unlinked from the program enrollment.

Note: Unlinking an assessment from the program does NOT delete the assessment; it only deletes the program linkage.

Icons & Tooltips

Icon

Icon/Tooltip Name

Tooltip

Icon Location

 Action Menu Icon.Aug25.1

 

Action menu, also known as:

  • three dots
  • kebab

"Show more actions"

All Screens: typically on the far right of a screen or section. 

Column Selector icon.Nov25

 

Column Selector

"Show/hide fields"

All Screens: typically paired with a search bar

Privacy Icon.Private.Nov25

 

Confirm Unlink

(no tooltip)

Shown on Unlink Confirm popup

Link Icon

 

Link from Assessment

(no tooltip)

Action Menu: on a program enrollment's Assessments tab

Save Icon

 

Save

(no tooltip)

Shown on Link from Assessments panel