Assessment processors allow system administrators to assign scores to field responses in assessment screens like the VI-SPDAT assessments. Assessment processor scoring can be used to set up eligibility criteria to determine which programs a client is directly referred to as well as used for prioritization in the community queue.
Assessment processors are assigned to specific assessment screens. When a user completes data entry for that assessment screen in a client record, the assessment screen’s fields will be scored and used to determine eligibility.
Creating an Assessment Processor
Click on the Launchpad and navigate to Setup > Settings > Assessment Processors (figure 1).
In Assessment Processors Management, you’ll see the system processors along with any previously created custom processors.
To create a new assessment processor, click Create a New Processor.
Complete the following fields in Add New Processor:
- Display Code: the name the processor will display as in the client record history.
- Name: can be anything, but adding the name of the associated assessment here can be helpful for reference.
- Status: when “Inactive” is selected, the processor cannot be assigned to an assessment. If the processor is already assigned to an assessment when “Inactive” is selected, it will no longer be assigned to that assessment. If “Active” is later selected, it will be re-assigned to the assessment.
- Base Score: a fixed score that will be added to the assessment regardless of the specific points defined.
Click Save Changes and the Subtotals section will display.
The first layer of an assessment processor is subtotals. If applicable, multiple subtotals can be created to have individually scored sections in an assessment. These subtotals, or sections, can be added, subtracted, multiplied, or divided resulting in the overall assessment score. Otherwise, one subtotal should be created, in which all points will be calculated. See the “Order of Operations” section of this article for further details on how multiple subtotals are calculated.
To add a new subtotal, click Add New Subtotal (figure 2).
Complete the following fields in Add New Subtotal:
- Display Code: intended to be used for organizing subtotals (i.e., A, B, C). A period will be added after the code when displaying in the processor. The first character must be a letter and the field can only contain letters, numbers, and underscores.
- Description: a descriptive name for the section (i.e., “Housing History,” “Living Situation”) (this will display after the display code).
- Operation: includes subtraction, addition, division, and multiplication. This operation will be applied to the other subtotals (if applicable).
- Base Score: adds a fixed point value to the subtotal, regardless of the points and conditions configured in the next step.
Click Save Changes to generate the Points section within the created subtotal.
Points are the next layer of organization in an assessment processor. You can store as many points as applicable under each subtotal. Points reference and assign a score to one or more fields.
To add a new point, click Add New Point (figure 3).
Complete the following fields:
- Name: should be either the name of a specific field or a description of a few fields.
- Points: how many points will be assigned if the condition(s) (to be established in the next step) are met.
- Store in Details: enabling this features allows the point (and its associated conditions) to be used as a condition elsewhere in the processor.
- Display Code: if Store in Details is toggled on, this field will appear. The purpose of this field is to be descriptive of the stored point. It will be used in the picklist selection of “Assessment Point” conditions (described next). The display code must have 4 or more characters, begin with a letter, and only include letters, numbers, and underscores.
Click Save Changes.
Conditions are the last layer of assessment processor organization. Conditions define how points are assigned.
A point can have just one or a combination of conditions. Each field that should result in a score needs at least one condition.
To add a new condition click Add New Condition (figure 4).
Select a condition Type. There are two different types: “Demographics” and “Assessment Point” (figure 5).
Demographics conditions allow you to select a field from Field Editor. You must select a demographic condition at least for the first point in the processor.
- Name: Begin typing the field name and the system will auto-suggest fields from Field Editor. It’s helpful to have the associated assessment open to know the exact field display name.
- Value: choose or type the answer that will result in a point.
|Note: only fields that are in the associated assessment to which the assessment processor is assigned will generate points. Ensure the correct field is selected.|
Click Save Changes. Select the relationship between the selected field and the value (figure 6).
Click Save Changes.
Assessment Point Conditions
Assessment point conditions use data from a stored point in the processor (stored points are points that have Store in Details toggled on). The purpose of this feature is to simplify the creation of conditions that rely on fields already in the processor.
- Field: select the name of the stored point
- Value: the score upon which the condition will be built
Click Save Changes. Select the relationship between the stored point and the value (figure 7).
Click Save Changes.
Multiple conditions can be created for a single point. Use the Add New Condition button to add additional conditions to points and follow the same steps as above. When using more than one condition, you must designate And/Or logic. And means all conditions must be met in order to result in a point. Or means at least one of the conditions must be met in order to result in a point (figure 8).
For more complex sets of conditions, brackets can be used. For example, a condition may exist where a client either meets one set of criteria or another, such as a response of “Yes” to the questions “Disabling Condition” AND “Veteran Status” OR a response of “Yes” to the question “Previously in Prison” AND an age greater than 64 (figure 9).
Order of Operations
When multiple subtotals and/or points are included in an assessment processor, each score’s operation is applied to the score before it, including the base score. These operations are performed one at a time. Points are scored first, followed by subtotals.
In figure 10, the base score for the processor is 0 points. Each subtotal has a base score of “0” with an operation of “addition” and one demographic Point. Subtotal A is worth 2 points, subtotal B is worth 4 points, subtotal C is worth 10 points and subtotal D is worth 5 points.
This calculation would be expressed (((0 X (0+2)) + (0+4)) + 10) X (0+5)) .
Viewing Scores in Assessments
When a user completes an assessment with an assessment processor in a client record, a score summary will display, displaying the points for each subtotal as well as the total points (figure 11) (unless the screen is configured to not display the score).
Editing Assessment Processors
Assessment processors are editable. To edit an existing processor, click the edit icon beside it (figure 12).
Once an assessment processor is complete, the next step is to assign it to the assessment in Screen Field Editor.