Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

The ELA / Math Modal allows User to enter integration metadata, define benchmark criteria for percentile rank / raw score, and complete field mapping for required / custom fields.

Figma https://www.figma.com/file/pbkupX2noQxD6SE6C7EtIv/Admin---Integrations?type=design&node-id=297-10527&mode=design&t=nIVk0v0dogxiMlgC-0

Epic:
Azure devops macro
linkhttps://rethinkfirst.visualstudio.com/RethinkFirst/_workitems/edit/195465

UI Description: Add New Integration

...

User Story

As an internal employee at RethinkEd, I need to enter an new ELA or Math Assessment with metadata, criteria for benchmarks and field mapping so that we will have a bank of Assessments.

UI Description: Add New Integration

  1. Subject dropdown:

    • Description: The subject selection for the new assessment

    • Required: Yes

    • Type of Input: dropdown selection

    • Validation Criteria: From the list, ELA or Math need to be selected

      • Contains alphabetical list: Attendance, Behavior, ELA, Math.

  2. Company dropdown:

    Description:

    • Description: Company dropdown is a smart search containing an alphabetical ordered list of all companies that have at least one integration for the selected subject

    • Required: Yes

    • Type of input: Smart search results from dropdown or text entered for a new company

      • Search results are optimized to appear within 2 seconds under normal load conditions.

    • Company drop down contains a field for text enter custom entry

    • Custom additions become part of the alphabetical ordered list

  3. Assessment Name:

    • Required text entry field with no character limitations

    • Optional text entry field with no character limit. Validation Criteria: Selection is a selection from the smart search dropdown or a text entry

  4. Assessment Name:

    • Description: Name of the Assessment

    • Required: Yes

    • Type of Input: Text entry with no character limits

    • Validation Criteria: Text entry with at least 3 characters

  5. Description:

    • Description: Text entry field for user to provide a description of the Assessment

    • Required: No

    • Type of input: Text entry

    • Validation Criteria: Text entry with at least 3 characters; no character limit but Description will be truncated on the Assessment list

User Interaction and Validation Notes: Add New Integration

  1. Subject dropdown:

    • Subject drop down is single select, required field

    • User select ELA to add a new English Language Arts integration

    • User selects Math to enter a new Math integration

  2. Company dropdown

    • Users can refine the companies displayed by typing in the search bar or selecting options from dropdown filters.

    • The search function should validate input and return relevant results.

    • Users select Custom and text enter a new Company

  3. Assessment Name:

    • Users can click inside of field and text enters name of assessment

  4. Description:

    • Clicking inside the field makes it active .and user types

UI Description: Integration Settings

...

Benchmark Tab

  1. Quantity

    fielddropdown contains

    Field

    • Description: Selects the number of lines to include for Benchmark Label, Percentile Range or Raw Score, and Tier Mapping

    • Required: Yes

    • Type of input: Dropdown selection

    • Validation Criteria: One item is selected from the possible choices: 3, 4, 5, or 6

      • 3 is the default

      • The default shows three lines containing: Benchmark label, Percentile Range and Tier Mapping

      Scoring type
  2. Scoring type

    • Description: Selection determines the heading for ranges and how the data are classified

    • Required: Yes

    • Type of input: Drop down; single select from options: Percentile Range, Raw Score

      • The results of the selection show different information for the heading and ranges for Tier mapping

      • Raw Score selection requires additional entries for Maximum and Minimum score

      • Percentile Range is the default

  3. Benchmark

    label is optional select from dropdown or text entry
  4. Scoring Type: If Percentile range is selected, then Percentile Range is the heading

    • Tier 1 has a locked maximum value of 100%

    • Tier 3 has a locked minimum value of 0%

  5. Scoring Type: If Raw Score is selected, then user must enter a value for minimum score (Min Score) and maximum score (Max Score)

  6. Default Score ranges are determined by an equal division from Min Score value to Max Score value for the number selected in Quantity field

  7. Tier 1 has a locked maximum value that matches the value entered for Max Score

  8. Tier 3 has a locked minimum value that matches the value entered for Min Score

    Label

    • Description: A small text description to further explain the Tier Levels.

      • Contains a growing bank of benchmark labels

      • Each custom entry becomes part of an alphabetical ordered list

    • Required: No

    • Type of Input: Smart select from an alphabetical ordered list and a text entry option

    • Validation: A selection from the list or a custom text entry with a minimum of 3 characters

  9. Percentile Range (Scoring Type: Heading and Ranges ):

    • Description: Heading (Percentile Range) shown with dropdown selection ranges for Tier Mapping

    • Required: Yes

    • Type of input: dropdown selection

    • Validation: Ranges selected for each of the lines selected. Must be all inclusive and mutually exclusive in descending order from the first to the last line

  10. Raw Score (Scoring Type: Additional Fields, Heading and Ranges)

    • Description: Heading (Score Ranges) shown with dropdown selection ranges for Tier Mapping and 2 additional fields used to determine maximum and minimum score.

    • Required: Yes

    • Type of input: dropdown selection

    • Validation: Raw Score selected from dropdown

      • Shows the additional fields for Maximum and Minimum Score and the heading labeled: Score Ranges

  11. Tier Mapping

    • Description: Identifies the Tier which correlates to each of the Benchmarks and/or Percentile Range or Score ranges

    • Required: Yes

    • Type of input: dropdown selection

    • Validation: The default setting is for 3 lines and the order is: Tier 1, Tier 2, Tier 3. If changes are made to the Quantity field, then the topmost line is locked at Tier 1 and the bottom-most line is locked at Tier 3. All tiers must be included.

Start here

Field Mapping Tab

  1. Upload Sample Template button upload the heading of the data set selected and prefills the Select field drop down with those headings

    • Required Fields: If Percentile Range is selected from Scoring Type, then the required fields are: StudentID, CompletionDate, PercentileRank, ScaledScore

    • Required Fields: If Raw Score is selected from Scoring Type, then the required fields are: StudentId, CompletionDate, RawScore,

    • Show Tooltip: Optional checkbox with default as unchecked

      • Clicking checkbox for Show Tooltip opens a text box

      • User text enters Tooltip contents

    • Select Field: Dropdown contains the headings from Unload Sample Template

      • User clicks on Select field dropdown arrow and makes a selection

    • Add Note: Clicking Add note opens an optional text enter box

      • User types note and selects Save to have note appear

      • Users can remove note by clicking Cancel

    • Add Custom Field: Opens an additional line to Custom enter the Field, optional text entry field description, Show Tooltips checkbox, Select field dropdown, and Add Note.

    • Save button: Saves all work completed

    • Cancel button: Removes all work completed and restores to the default for all fields

...