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 | ||
---|---|---|
|
UI Description: Add New Integration
...
Figma Link
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
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.
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
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
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
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
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
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
Assessment Name:
Users can click inside of field and text enters name of assessment
Description:
Clicking inside the field makes it active .and user types
UI Description: Integration Settings
...
Benchmark Tab
Quantity
fielddropdown containsField
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
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
Benchmark
label is optional select from dropdown or text entryScoring 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%
Default Score ranges are determined by an equal division from Min Score value to Max Score value for the number selected in Quantity field
Tier 1 has a locked maximum value that matches the value entered for Max Score
Tier 3 has a locked minimum value that matches the value entered for Min ScoreDescription: 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
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
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
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.
Scoring Type: If Raw Score is selected, then user must enter a value for minimum score (Min Score) and maximum score (Max Score)
Label
Start here
Field Mapping Tab
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
...