Versions Compared

Key

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

...

  1. Title

    • Description: The name or headline of the activity.

    • 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 resource to ensure easy identification and searchability.

  2. Short Description

    • Description: A concise summary of the activity, highlighting its main points or features.

    • Required: YesNo.

    • Type of Input: Textarea.

    • 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.

  3. Subject

    • Description: The subject area of the activity.

    • Required: Yes.

    • Type of Input: Dropdown menu.

    • Dropdown Values (single select):

      • SEL

      • Mental Health

  4. Activity Type

    • Description: The category that best describes the nature or format of the activity.

    • Required: Yes.

    • Type of Input: Dropdown menu.

    • Dropdown Values:

      • Quiz

      • Instruction

  5. Grade

  6. Tier

  7. Domain

  8. Main Topic

  9. KeywordsDuration

    • Description: User-defined tags or keywords that describe the resource, aiding in search and categorization. After input, the text is parsed into individual words or phrases, each displayed as a removable tagThe category that best describes the time it takes to complete the activity.

    • Required: NoYes.

    • Type of Input: Text input with tag conversion.

      Validation Criteria:

    • Input is free-form text, converted into tags upon submission or pressing the enter key.

    • Each tag is visually represented in a way that allows for easy removal, typically with an "x" or similar icon in the corner of the tag.

    • There's no strict minimum, but ideally, a limit on the maximum number of keywords (e.g., 10 to 20) to prevent over-tagging and maintain focus.

    • Special characters might be restricted or allowed based on the tagging system's design and the search functionality's capabilities.

      : Dropdown menu.

    • Dropdown Values:

      • 0-5 mins

      • 5-10 mins

      • 10-15 mins

      • 15-30 mins

      • Asynchronous

  10. Grade

    • Description: The grade for which the activity 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

  11. Tier

    • Description: The Tier for which the activity applies to.

    • Required: Yes

    • Type of Input: Dropdown menu

    • Dropdown values (multi-select):

      • Tier 1

      • Tier 2

      • Tier 3

  12. Domain (Subject: SEL)

    • Description: The Domain for which the activity applies to.

    • Required: Yes

    • Type of Input: Dropdown menu

    • Dropdown values (single-select):

      • Awareness of Self & Others

      • Self-Management

      • Social Skills

      • Social Awareness

      • Self-Care

  13. Domain (Subject: Mental Health)

    • Description: The Domain for which the activity applies to.

    • Required: Yes

    • Type of Input: Dropdown menu

    • Dropdown values (single-select):

      • Mental Wellness, Healthy Identities, Kindness to Animals, Online Safety, Anxiety, Depression, Substance Use Disorders, Reducing the Risk of Suicide, Preventing Violence, Human Trafficking, Trauma: Emotions, Trauma: Resilience, Trauma: Stress Management, Trauma: Support Systems

  14. Main Topic (Subject: SEL)

    • Description: The Main Topic associated with the Domain of the activity.

    • Required: Yes

    • Type of Input: Dropdown menu

    • Dropdown values (single select):

      • Awareness of Self & Others: Emotions, Growth Mindset, Learning Skills, Values, Wants & Needs, Self-Knowledge

      • Self-Management: Stress Management, Self-Control, Resilience, Problem Solving, Goal Setting, Focus

      • Social Skills: Respect, Relationships, Friendship, Fairness, Cooperation, Conflict Resolution

      • Social Awareness: Support Systems, Cultural Competence, Social Contributions, Safe & Ethical Behavior, Empathy, Actions & Consequences

      • Self-Care: Self-Efficacy, Self-Compassion, Self-Advocacy, Optimism, Mindfulness, Healthy Boundaries

User Interaction and Validation Notes

  • Title and Short Description fields are required to proceed. These fields are crucial for basic identification and understanding of the resourceactivity.

  • For the Type field Subject, Activity Type, Duration, Grade, Tier, Domain, and Main Topic fields, users must select from the predefined options. This ensures consistency and reliability in filtering and searching resources for an activity across the platform.

  • The Keywords field is designed to enhance searchability and categorization. Users can type keywords, which, upon submission or pressing the enter key, become individual tags. Each tag should be removable, offering flexibility in refining the resource's descriptors Main Topic field only displays when the user selects the Subject as SEL.

  • 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.

For the "Resource Activity Metadata" functionality within the Resource Activity Builder section, the workflow is a crucial aspect that dictates how users interact with both new and existing resourcesactivities.

This workflow ensures that the system is intuitive and that users with the appropriate permissions can effectively manage resource activity metadata. Below is a detailed description of the workflow process:

...

Activity Metadata Workflow Description

  1. Accessing the Page:

    • When a user navigates to the "Resource Activity Metadata" page, they can either be creating a new resource activity or editing an existing one. The system differentiates these scenarios based on whether a resource an activity ID is provided (for editing) or not (for creating).

  2. Initial State:

    • New ResourceActivity: If the user is adding a new resourceactivity, all fields on the "Resource Activity Metadata" page are presented as empty, ready for the user to input the new information.

    • Existing ResourceActivity: If the user is editing an existing resourceactivity, the system retrieves all current metadata for that resource activity from the server and populates the fields accordingly. This ensures that the user can see the existing information and make any necessary updates.

  3. Editing Metadata:

    • Users can make changes to any of the metadata fields, regardless of whether they are creating a new resource activity or editing an existing one. This includes updating the title, short description, subject, activity type, duration, grade, tier, domain, and keywordsmain topic, among others.For the Keywords field, users can add new keywords or remove existing ones by clicking on the "x" or similar icon on the tag representation of each keyword.

    • If the user changes the subject from SEL to Mental Health, the Main Topic dropdown menu will be hidden

    • If the user changes the subject from Mental Health to SEL, the Main topic dropdown menu will display

  4. 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.

  5. 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 resource's metadata on the server. For a new resourcesactivity, this action creates a new record; for an existing resourcesactivity, it updates the existing record with the new metadata.

  6. Access Control:

    • The form for editing or adding metadata is accessible only to users who have the "Edit Resources" permission. This ensures that only authorized personnel can modify resource activity information, maintaining the integrity and security of the content on the portal.

  7. Confirmation and Redirect:

    • After successfully saving the metadata, the user may receive a confirmation message, and the system could redirect them to either the resource activity listing page, the resource activity detail view, or another relevant page. This action provides clear feedback that the operation was successful and guides the user on what to do next.

...

This workflow emphasizes user-friendly interaction, data integrity, and proper access control, ensuring that the Resource Activity Metadata management process is efficient, secure, and intuitive. It accommodates both the creation of new resources activities and the modification of existing ones, with clear pathways and feedback mechanisms for users throughout the process.