Focus Areas Meta-data Details | Goals & Interventions
- Mary DelPiano
- Andrew Estrada
Figma Link
Epic:
User Story
As a user, I need to enter Focus Area metadata details so that the Focus Areas can be located and displayed in the CMS Authoring Tool and the Intervention Library.
UI Description
Title
Description: The name or headline of the Focus Area.
Required: Yes.
Type of Input: Text field.
Validation Criteria: Must contain at least 3 characters and no more than 255 characters. It should accurately reflect the content or subject of the Focus Area to ensure easy identification and searchability.
Short Description
Description: A concise summary of the Focus Area, highlighting its main points or features.
Required: Yes.
Type of Input: Text area.
Validation Criteria: A minimum of 10 characters and a maximum of 500 characters. This constraint ensures the description is brief yet informative enough to convey the resource's value or purpose.
Subject
Description: The subject area of the Focus Area.
Required: Yes
Type of Input: Dropdown menu.
Dropdown Values (single select):
ELA
Math
SEL
Behavior
Grade
Description: The grade for which the Focus Area applies to.
Required: Yes
Type of Input: Dropdown menu
Dropdown values (multi-select):
Pre-K, Kindergarten, 1st Grade, 2nd Grade, 3rd Grade, 4th Grade, 5th Grade, 6th Grade, 7th Grade, 8th Grade, 9th Grade, 10th Grade, 11th Grade, 12th Grade, Not Applicable
Intervention Strategy
Description: The Intervention Strategy that the Focus Area belongs to.
Required: Yes
Type of Input: Dropdown menu with search functionality.
Dropdown values (single-select):
List of all Created Interventions Strategies for the specified Subject
User Interaction and Validation Notes
Title should be required to proceed. This field is crucial for basic identification and understanding of the Focus Area. Short Description is optional to save the work.
For the Subject, Grade, Intervention Strategy fields, users must select from the predefined options. This ensures consistency and reliability in filtering and searching for a Focus Area across the platform.
Grade: Grade(s) should display in consecutive numerical order. If there is a grade range, the grades should be separated with an “ndash”.
Behavior Subject Selected: Grade field is pre-filled with Pre-K - Grade 12 and disabled.
Validation for text fields should include checks for prohibited characters or patterns that might interfere with the system's functionality or the database's integrity.
Focus Area Metadata Workflow Description
Accessing the Page:
When a user navigates to the "Focus Area" page, they can either be creating a new Focus Area or editing an existing one. The system differentiates these scenarios based on whether a Focus Area ID is provided (for editing) or not (for creating).
Initial State:
New Focus Area: If the user is adding a new focus area, all fields on the left panel of the "Focus Area Builder" page are presented as empty, ready for the user to input the new information.
Existing Focus Area: If the user is editing an existing Focus Area, the system retrieves all current metadata for that Focus Area from the server and populates the fields accordingly. This ensures that the user can see the existing information and make any necessary updates.
Editing Metadata:
Users can make changes to any of the metadata fields, regardless of whether they are creating a new focus area or editing an existing one. This includes updating the title, short description, subject, grade, among others.
Validation and Feedback:
Before submission, the system validates all input based on the specified criteria for each field. If any field does not meet its validation requirements, the system displays an appropriate error message, prompting the user to correct the input.
This step ensures data integrity and prevents the submission of incomplete or incorrect metadata.
Saving Changes:
Once all fields are correctly filled out and validated, the user can save the changes by clicking the "Save" button.
Upon saving, the system updates the metadata on the server. For a new Focus Area, this action creates a new record; for an existing Focus Area, it updates the existing record with the new metadata.
Access Control:
The form for editing or adding metadata is accessible only to users who have the "Edit Goals & Interventions" permission. This ensures that only authorized personnel can modify Focus Area information, maintaining the integrity and security of the content on the portal.
Confirmation and Redirect:
After successfully saving the metadata, the user may receive a confirmation message, and the system will stay on the page displayed. This action provides clear feedback that the operation was successful and guides the user on what to do next. The user can close the Focus Area Builder to return to the Focus Area table.