Q - Bank SRS v.04.pdf

36
QBank and Passages v.04 Page 1 of 36 Software Requirements Specifications QBank and Passages Prepared for Academic Approach VER .04 Abstract: The purpose of this document is to provide development direction for all functionality related to QBank & Passages in the ALMS v6 online portal. Version Date Description Author(s) Company .01 06/05/15 Initial Draft Johanna Capecci RDI/A .02 06/09/15 Updated version after review with AA team. Minor updates highlighted in light yellow. Johanna Capecci RDI/A .03 06/14/15 Updated version after comments from AA team. Minor updates highlighted in light yellow, also added OER Question Type and re-added in Selection Question Type. Johanna Capecci RDI/A .04 06/18/15 Updated version after review with AA team to address final questions. Minor updates (added OER constraints, updates to Selection type to accommodate for >1 word to under line, and passage filters updated, all , highlighted in light yellow. Later-phased items highlighted in light blue Johanna Capecci RDI/A

Transcript of Q - Bank SRS v.04.pdf

  • QBank and Passages v.04

    Page 1 of 36

    Software Requirements Specifications

    QBank and Passages

    Prepared for Academic Approach

    VER .04

    Abstract: The purpose of this document is to provide development direction for all functionality related to

    QBank & Passages in the ALMS v6 online portal.

    Version Date Description Author(s) Company

    .01 06/05/15 Initial Draft Johanna Capecci RDI/A

    .02 06/09/15 Updated version after review with AA team. Minor updates

    highlighted in light yellow.

    Johanna Capecci RDI/A

    .03 06/14/15 Updated version after comments from AA team. Minor

    updates highlighted in light yellow, also added OER Question

    Type and re-added in Selection Question Type.

    Johanna Capecci RDI/A

    .04 06/18/15 Updated version after review with AA team to address final

    questions. Minor updates (added OER constraints, updates

    to Selection type to accommodate for >1 word to under line,

    and passage filters updated, all , highlighted in light yellow.

    Later-phased items highlighted in light blue

    Johanna Capecci RDI/A

  • QBank and Passages v.04

    Page 2 of 36

    Document Contents

    Introduction .................................................................................................................................................................... 3

    Theme 01- QBank Summary View ................................................................................................................................ 4

    Theme 02- Creating / Editing a Question .................................................................................................................... 14

    Theme 03- Passage Summary View ............................................................................................................................ 33

    Theme 04- Creating / Editing a Passage ..................................................................................................................... 34

  • QBank and Passages v.04

    Page 3 of 36

    Introduction

    Functional Decomposition

    The work effort for the market site initiative has been decomposed into the following themes:

    Theme Theme Name Description Applicable Role Type (Internal AA, Student, Parent, Internal Teacher, Internal

    Tutor, External User)

    01 QBank Summary View

    The View User sees on clicking into QBank module, and views all questions within network

    Internal Teachers (with permissions)

    Internal Tutors (with permissions)

    All Other Internal AA (with permissions)

    External Users (with permissions)

    02 Creating / Editing a Question The step wizard that enables Users with permissions to create or edit a question

    Internal Teachers (with permissions)

    Internal Tutors (with permissions)

    All Other Internal AA (with permissions)

    External Users (with permissions)

    03 Passage Summary View The View User sees on clicking into the Passage module, and views all questions within network

    Internal Teachers (with permissions)

    Internal Tutors (with permissions)

    All Other Internal AA (with permissions)

    External Users (with permissions)

    04 Creating / Editing a Passage The step wizard that allows Users with permissions to create or edit a passage

    Internal Teachers (with permissions)

    Internal Tutors (with permissions)

    All Other Internal AA (with permissions)

    External Users (with permissions)

    Admin Panel- Applicable Permissions Regarding QBank and Passages

    ID Permission Name Permission Options Comments

    01

    Access QBank

    Can view / export own questions Export = later phase

    02 Can create / edit new questions

    03 Can delete questions

    04 Can create / edit questions where assessment type = fixed form

    Fixed form questions are designated at the question level and should NOT be allowed to be added to create an assessment for anyone that is not AA and does not have permissions.

    05 Can delete fixed form questions

    06 Can view / export all questions Export = later phase

    07

    Access Passages

    Can view passages

    08 Can create / edit passages

    09 Can delete passages

    10 Can create / edit passages where assessment type = fixed form

  • QBank and Passages v.04

    Page 4 of 36

    Theme-01: QBank Summary View

    Interaction 01A- QBank Summary Page

    A- Takes User to create new

    question, per Interaction 02A.

    B- Button not actionable unless at

    least 1 questions are selected.

    On-click, routes User to Create

    Assessment workflow per

    Assessment specs.

    C- Button not actionable unless at

    least 1 question is selected. Exports

    selected questions in csv. Note that

    User can only export questions he /

    she has created OR that are public

    (institution & dept shared) OR if he /

    has the permission to export all

    questions.

    D- User filters through questions.

    Note that if filter shows a drop

    down, User can smart-type within

    drop down options, OR can click

    dropdown icon to browse and

    select filter options. Filter options

    default to ALL.

    D.1- Clicks Select for Standard

    System, taken to Interaction 01B

    D.2- Clicks Select for Curriculum

    Category, taken to Interaction 01D

    D.3- Clicks Select for Test

    Applicability, taken to Interaction 01C

    D.4- Selects subject dropdown:

    (universal custom field, designated in

    admin panel) Math, English, Reading,

    Science, Social Studies

    D.5- Status Options: (1) Draft, (2)

    Active, (3) Inactive, (4) Ready for

    Review

    D.6- Shows me OR any User in

    institution that has created a question

    and has made question public

    D.7- Assigned to filter will only show

    IF User type = Internal AA User

    A B C

    D

    E

    G H I J K

    L M N

    F

    O

    D.8- Chooses from the following question types

    o Multiple Choice- Single Answer

    o Multiple Choice- Multi Answer

    o Free Form

    o Fill in the Blank

    D.9- Shows questions with passages

    .1

    .2

    .3

    .4

    .5

    .6

    .7

    .8

    .9

    Later Phase

    Custom

    fields- later

    phase

    Category

  • QBank and Passages v.04

    Page 5 of 36

    Interaction 01A- QBank Summary Page (Continued)

    E- Searches through QBank by:

    Question Name

    Standard System and

    Substandards

    Keyword

    Answer Set

    Affiliated Tags

    F- Takes User to Advanced Search

    interaction, per Interaction 01E.

    G- User can check each individual

    question to activate Create

    Question and Create

    Assessment buttons (per Items

    A and B on previous page). User

    can click on the top checkbox to

    select / deselect all.

    H- Questions with passages will be

    flagged in a column

    I- Shows assigned status

    J- Shows question name. On hover,

    will show the full question name

    since real estate will likely be an

    issue.

    K- Shows the subject (custom field)

    the question is assigned to

    L- IF there is 1 assessment, show

    assessment name. If there is >1

    assessment, show # and link it.

    Clicking link takes User to pop-up

    window in Interaction 01F. (Later

    Phase)

    M- IF there is 1 tag, show tag name.

    If there is >1 tag, show # and link

    it. Clicking link takes User to

    pop-up window in Interaction

    01G. (Later Phase)

    N- IF there is 1 standard, show standard name. If there is >1 standard, show # and link it. Clicking link takes User to pop-up window in

    Interaction 01H. (Reserve for Later Phase)

    O- When User hovers over a row, the view, edit and delete icons will show. On click of view icon, User view question and answer attributes per

    Interaction 01I. On click of edit icon, User taken to edit question per Interaction 02A. On click of delete icon, User will be asked if he / she

    is sure question should be deleted, per the following:

    Later Phase

    J

    Custom

    fields- later

    phase

  • QBank and Passages v.04

    Page 6 of 36

    Interaction 01B- Standard System Filter Interactions

    Use same as designed for files / lessons SRS.

  • QBank and Passages v.04

    Page 7 of 36

    Interaction 01C- Test Category (Formerly called Test Applicability) Filter Interactions

    Use same as designed for files / lessons SRS.

  • QBank and Passages v.04

    Page 8 of 36

    Interaction 01D- Curriculum Category Filter Interactions

    Use same as designed for files / lessons SRS.

  • QBank and Passages v.04

    Page 9 of 36

    Interaction 01E- Advanced Search- Later Phase

    In the event the User wants to search

    for specific things, he / she can

    search by the following attributes:

    A- Question Content

    B- Answer Content

    C- Tags / Keywords

    D- REMOVE, standard search already

    applied

    A

    B

    C

    D

  • QBank and Passages v.04

    Page 10 of 36

    Interaction 01F- Assessments Pop Out Page Later Phase (also add to roadmap a popout that shows assessment rosters)

    A

    B C D E

    F G

    A- Closes pop out

    B- Shows the status of the

    assessment (assessment statuses

    discussed in assessments specs)

    C- Shows title of assessment

    D- Shows category of assessment

    (assessment categories discussed

    in assessments specs)

    E- User can view test type the

    assessment is assigned to (test

    type discussed in assessments

    specs)

    F- User can view the assessment.

    Viewing the assessment is

    discussed in assessment specs.

    G- User can edit the assessment.

    Editing the assessment is

    discussed in assessment specs.

  • QBank and Passages v.04

    Page 11 of 36

    Interaction 01G- Clicking # of Tags to See List in Pop Out- Later Phase

    Save for Later Phase: User can

    view all keywords tagged to each

    question during question creation.

    Question Creation is discussed in

    Theme 02.

  • QBank and Passages v.04

    Page 12 of 36

    Interaction 01H- Clicking Standards to see Standard Tree Later Phase

    Later Phase: Hover over text of standard

    at every opportunity when standard

    abbreviation is shown

  • QBank and Passages v.04

    Page 13 of 36

    Interaction 01I- View Question Popout from Summary Page

    A

    B

    User views all question attributes in a

    popout. All fields are DISPLAY ONLY.

    If User wants to edit, he / she can go

    back to the summary page and click

    the Edit button.

    A- Field ONLY visible to Internal AA

    with permissions to view fixed

    form questions.

    B- User views passage associated to

    question and aligned text or

    anchors that may be tied to the

    question.

    C- Later Phase: Add Edit button so

    User can edit passage directly

    from this page. Passage record

    will update across the board for

    passage.

    Item Category Fixed Form

  • QBank and Passages v.04

    Page 14 of 36

    Theme-02: Create / Edit New Question

    Interaction 02A- Step 1: Multiple Choice: Single Correct Answer

    Multiple Choice: Multi-Answer Note: Red indicates required field.

    A- Can only select one of the following:

    o Multiple Choice- Single Answer

    o Multiple Choice- Multi Answer

    o Free Form

    o Fill in the Blank

    o Selection (Added Back In)

    o Open Ended Response

    B- Shows whatever is listed in the custom

    fields. User can select >1 subject. Note

    that User can search and filter through

    drop-down options or browse.

    C- Shows whatever is listed in the custom

    fields. User can select >1 grade. Note that

    User can search and filter through drop-

    down options or browse.

    D- Shows whatever is listed in the custom

    fields. User can select >1 difficulty. Note

    that User can search and filter through

    drop-down options or browse.

    E- Discussed in Interaction 01B

    F- Discussed in Interaction 01D

    G- Discussed in Interaction 01C

    H- Alphanumeric constraint, max 1000 char

    I- WYSIWYG editor shows regular and HTML

    formatting views. IF Math or Science is

    chosen, math WYSIWYG options populate

    in addition to the standard WYSIWYG

    options.

    J- User can choose image from local machine

    to upload and insert into question, along

    with content. User should be able to scale

    the picture size.

    K- Question has 1500 character constraint

    L- Item Category field visible to AA Internal

    User Role Type ONLY. QBank items

    designated as Fixed form should NOT be

    allowed to be added to create an

    assessment for any end User except AA w/

    permissions. Item Categories as follows:

    QBank, Fixed Form, PD

    M- On-click, takes User to Step 2

    N- On-click, User previews question

    O- On-click, saves. Default status will be

    Draft and the question will be private

    (two fields that the User fills out in step 6)

    until the User is ready to activate that

    question and / or make it public. User gets

    success message saying Question

    successfully saved and stays on page.

    A

    B

    C

    E

    F G

    H

    I J

    K

    O N

    M

    k

    L

    D

    Confirm Standards

    Category

    Custom fields-

    later Phase

  • QBank and Passages v.04

    Page 15 of 36

    Interaction 02E- Step 2: Multiple Choice: Single Correct Answer

    A- On-click, Generates another answer row for

    User to add

    B- WYSIWYG editor shows regular and HTML

    formatting views. IF Math or Science is

    chosen, math WYSIWYG options populate

    in addition to the standard WYSIWYG

    options

    C- User can choose an image from local

    machine to upload and insert into question,

    along with content. User should be able to

    scale the picture size.

    D- User can click the x and remove the

    answer. Note that system must enforce that

    at least TWO answer choices are available

    for multiple choice: single correct answer.

    E- User can click to choose the correct answer

    out of the answer set defined. System to

    enforce that only one answer is correct.

    F- User can sort where the answer displays as

    a default.

    G- User can assign an explanation to each

    answer set, explaining why it is / is not the

    correct answer, 1500 word constraint.

    H- User can click and choose and the incorrect

    designation will turn to correct. All other

    answer choices will turn to incorrect.

    I- User can provide general answer

    commentary for all answer sets, 1500 word

    constraint.

    J- On-click, takes User to next step

    K- On-click, User previews question

    L- On-click, saves. Default status will be

    Draft and the question will be private (two

    fields that the User fills out in step 6) until

    the User is ready to activate that question

    and / or make it public. User gets success

    message saying Question successfully

    saved and User stays on the page.

    A

    B C

    D

    E

    F

    G

    H

    I

    J

    K L

    Confirm Standards

  • QBank and Passages v.04

    Page 16 of 36

    Interaction 02F- Step 2: Multiple Choice: Multi-Correct Answer

    A- On-click, Generates another answer row for

    User to add

    B- WYSIWYG editor shows regular and HTML

    formatting views. IF Math or Science is

    chosen, math WYSIWYG options populate

    in addition to the standard WYSIWYG

    options

    C- User can choose an image from local

    machine to upload and insert into question,

    along with content. User should be able to

    scale the picture size

    D- User can click the x and remove the

    answer. Note that system must enforce that

    at least TWO answer choices are available

    for multiple choice: multi-correct answer.

    E- User can click to choose the correct answer

    out of the answer set defined. System to

    enforce that AT LEAST one answer is

    correct. There can be as many correct

    answers as the User wants. User can click

    to turn the correct answer designation into

    incorrect, and the checkbox icon will turn

    into an x.

    F- User can sort where the answer displays as

    a default.

    G- User can assign an explanation to each

    answer set, explaining why it is / is not the

    correct answer, 1500 word constraint.

    H- User can provide general answer

    commentary for all answer sets, 1500 word

    constraint.

    I- On-click, takes User to next step

    J- On-click, User previews question

    K- On-click, saves. Default status will be

    Draft and the question will be private (two

    fields that the User fills out in step 6) until

    the User is ready to activate that question

    and / or make it public. User gets success

    message saying Question successfully

    saved and User stays on the page.

    A B C

    D

    E

    F

    G

    H

    I

    J K

    Confirm Standards

  • QBank and Passages v.04

    Page 17 of 36

    Interaction 02G- Step 1: Free-Form (Constructive Response)

    There is a minor difference between the Step 1

    Interaction for Free Form vs. other question types.

    Differences as follows:

    A- User either chooses: alpha, numeric or

    alphanumeric in drop down. Dropdown defaults

    to alphanumeric.

    This controls how the student (test taker) sees

    the question in the assessment. When taken

    online, the system will enforce that the student

    enter an answer in the constraint provided at the

    question level.

    B- Field should only allow numbers (numeric

    constraint).

    C- User chooses between words and characters.

    A

    B C

  • QBank and Passages v.04

    Page 18 of 36

    Interaction 02H- Step 2: Free-Form (Constructive Response)

    For free-form (Constructive Response) questions,

    User will not input answer options. Question-creator

    will only view a lone commentary field to input details

    into, 1500 character constraint.

    Confirm Standards

  • QBank and Passages v.04

    Page 19 of 36

    Interaction 02I- Step 1: Fill in the Blank- PHASE 2.

    There is a minor difference between the Step 1

    interaction for Fill in the Blank vs. other question

    types. Differences as follows:

    A- There is instructional text that informs the User

    how to identify areas in the question that

    require variable text. User must enter anchors

    for answer sets using [blank].

    B- User enters in [blank] and system knows that

    each answer set should have the number of

    variables (blanks) defined.

    A

    B B

    Confirm Standards

  • QBank and Passages v.04

    Page 20 of 36

    Interaction 02J- Step 2: Fill in the Blank- PHASE 2

    User enters the correct answer to the

    question with a hyphen. Example of

    how the test looks at the assessment

    level below:

    The [blank] indicator will trigger the

    ____ format when the question is

    posed to the student taking it during an

    assessment.

  • QBank and Passages v.04

    Page 21 of 36

    Interaction 02K- Open Ended Response: Step 1

    Open Ended Response will provide 4

    options in constraints:

    02K.1- Must Equal Decimal

    When User selects this option, adds

    field requesting value, in decimal

    format. During grading, system to

    enforce that any value entered equals

    the decimal point value entered.

    02K.2- Specific Value Constraint

    When User selects this option,

    system adds field requesting specific

    value. During grading, system to

    enforce that value matches verbatim.

    02K.3- Range of Values

    When User selects this option, adds

    two fields:

    - From

    - To

    System enforces, when grading, that

    value is in between the two values in

    the from and to.

    02K.4- Can be One of Many Values

    When User selects this option, adds

    two fields prompting User to enter

    specific values. There must be at

    least two unique values in order for

    the User to proceed to Step 2. User

    can add additional values by pressing

    the add icon.

    System enforces, when grading, that

    the value entered by the test-taker is

    at least one the values allowed by the

    question-creator.

  • QBank and Passages v.04

    Page 22 of 36

    Interaction 02L- Open Ended Response: Step 2

    For OER questions, User will input answer options in

    Step 1. Question-creator will only view a lone

    commentary field to input details into, 1500

    character constraint.

    Confirm Standards

  • QBank and Passages v.04

    Page 23 of 36

    Interaction 02M- Selection (Added Back in Scope)

    A- User will get instructions in The Question Textbox requesting to identify answers by putting after each answer set. The words that precede the command will be those that will show in the answer set at the assessment level. In the adjacent example, the answer set would be

    - Though Chippy misbehaves - appreciated

    User will have the ability to add additional answer selections when proceeding to Step 2.

    B- System to enforce constraint that at least two

    sets of words or phrases have the

    designation.

    A

  • QBank and Passages v.04

    Page 24 of 36

    Interaction 02N- Selection: Step 2

    For Selections, the answers set at the question

    level will prepopulate as selections in the

    answer. They will inherit the formatting in the

    question that was set with the designations

    in Step 1.

    A- In addition to the answers designated during Step 1, User can also add another answer to the set by clicking Add.

    B- Answer set read only and inherits formatting from question in Step 1

    C- User can select the answer as correct, incorrect, or sort, per the functionality defined in Multiple Choice. If the User deletes the answer choice, it removes the in step 1. There can be >1 correct answer for Selection Type.

    D- Answer set read only and inherits formatting from question in Step 1

    E- User can select the answer as correct, incorrect, or sort, per the functionality defined in Multiple Choice. If the User deletes the answer choice, it removes the in step 1. There can be >1 correct answer for Selection Type.

    F- F is an example of the User adding his / her own answer set in addition to the answers designated during Step 1. A WYSIWYG will appear allowing User to format the additional answer.

    G- User enters the content of the additional answer.

    H- User sets correct / incorrect and sorts default order of additional answer.

    B

    A

    C

    D E

    E

    F

    E

    G

    E H

    E

  • QBank and Passages v.04

    Page 25 of 36

    Interaction 02O- Assign Passage to Question

    A- Takes User to Create New Passage

    interaction. Once the passage is created,

    User is returned to this workflow.

    When User goes into Create New Passage

    interaction, the question gets saved in

    Draft status, and Private.

    B- User sees another category called

    Passage Features. On-click, presents the

    folder structure listed in 02O.1.

    C- User searches by keyword (tags) and

    passage name. Can further filter down

    using the standard system, curriculum

    category, test applicability, and subject

    filters.

    D- User can chooses only one passage to

    associate the question to. Once one

    passage is chosen, all other checkboxes

    are disabled.

    E- Takes User to Interaction 01F

    F- Takes User to Interaction 02P

    G- Takes User to Interaction 01G

    H- Takes User to Interaction 01H

    I- Takes User to Interaction 02Q

    A

    B

    C D

    E F G H

    Later Phase Later Phase

    I

  • QBank and Passages v.04

    Page 26 of 36

    Interaction 02O.1- Folder Structure for Passage Features Filters Folder 1 Level 2 Level 3 Level 4

    ACT Passages Reading Passage Type Prose

    ACT Passages Reading Passage Type Social Science

    ACT Passages Reading Passage Type Humanaties

    ACT Passages Reading Passage Type Natural Science

    ACT Passages Reading Difficulty Uncomplicated/Somewhat Challenging

    ACT Passages Reading Difficulty More Challenging

    ACT Passages Reading Difficulty Complex

    ACT Passages Reading Difficulty Highly Complex

    ACT Passages Reading Text Type Informational

    ACT Passages Reading Text Type Literary

    ACT Passages Science Passage Format Data Representation

    ACT Passages Science Passage Format Research Summaries

    ACT Passages Science Passage Format Conflicting Viewpoints

    ACT Passages Science Data Presentations Simple

    ACT Passages Science Data Presentations Complex

    ACT Passages Science Data Presentations Mixed

    ACT Passages Science Experiments Simple

    ACT Passages Science Experiments Moderately Complex

    ACT Passages Science Experiments Complex

    ACT Passages Science Content Area Biology

    ACT Passages Science Content Area Earth/Space Sciences

    ACT Passages Science Content Area Physics

    ACT Passages Science Content Area Chemistry

    SAT Passages (Current) Reading Passage Content Fiction

    SAT Passages (Current) Reading Passage Content Nonfiction

    SAT Passages (Current) Reading Passage Type Single

  • QBank and Passages v.04

    Page 27 of 36

    Folder 1 Level 2 Level 3 Level 4

    SAT Passages (Redesigned) Reading Passage Content U.S. and World Literature

    SAT Passages (Redesigned) Reading Passage Content History/Social Studies

    SAT Passages (Redesigned) Reading Passage Content Science

    SAT Passages (Redesigned) Reading Text Type Single

    SAT Passages (Redesigned) Reading Text Type Paired

    SAT Passages (Redesigned) Writing/Language Arts Passage Content History/Social Studies

    SAT Passages (Redesigned) Writing/Language Arts Passage Content Science

    SAT Passages (Redesigned) Writing/Language Arts Passage Content Career

    SAT Passages (Redesigned) Writing/Language Arts Passage Content Humanities

    SAT Passages (Redesigned) Writing/Language Arts Text Type Argument

    SAT Passages (Redesigned) Writing/Language Arts Text Type Informative/Explanatory Text

    SAT Passages (Redesigned) Writing/Language Arts Text Type Non-Fiction Narrative

  • QBank and Passages v.04

    Page 28 of 36

    Interaction 02P- Questions Associated to Passage Popout

    When User clicks the eye icon, he / she is taken to the view question interaction, outlined in Interaction 01I.

  • QBank and Passages v.04

    Page 29 of 36

    Interaction 02Q- Passage Preview

  • QBank and Passages v.04

    Page 30 of 36

    Interaction 02R- Associate Question with Passage

    Clarification Point for AA and dev- if User does not align any question text to passage, Step 3 assigns the question to the passage. Step 4 is Optional. User does not have to align text with the passage. If the User does not align text with the passage, then system knows not to populate the question by the aligned area of the passage during assessment taking and will populate the question at the end of the passage.

    A- If User clicks Words / Lines then the User

    can highlight a word or a group of words to

    align the passage content to. User can only

    highlight one word / group of words at a time.

    B- If User clicks Anchor radio then then he /

    she can choose where the anchor should be

    placed. Only one anchor can be placed per

    question.

    C- User can add a description that shows in

    context with the question and passage.

    When the question / passage combo is

    viewed in the assessment and the question

    with the associated passage is presented, the

    test-taker will view this description regarding

    the passage at the question level.

    D- On-click, takes User to Step 5: Choose

    Standards

    A B

    C

    D

    Confirm Standards

  • QBank and Passages v.04

    Page 31 of 36

    Interaction 02S- Confirm Standards

    A- User views all the standards and sub-standards

    selected in step 1. He / she can remove accordingly

    and add by using the filters in B.

    C- User views all the standards inherited by the

    passage selected. He / she can remove inherited

    passage standards.- REMOVE THIS

    REQUIREMENT PER AA

    D- Checkbox defaults to enabled- REMOVE THIS

    REQUIREMENT PER AA

    E- User moves to Step 6.

    A B

    C

    D E

    Category

  • QBank and Passages v.04

    Page 32 of 36

    Interaction 02T- Review and Publish

    A- Status defaults to Draft

    B- The Assign To field is only visible to

    Users with Internal AA role type that

    have permissions to access qbank.

    Note that when a question is

    assigned to an AA User, he / she will

    receive a notification on the portal

    saying

    C- User has ability to tag a passage.

    Any tags pertaining to an associated

    passage will be inherited here, and

    the User can remove the tag at the

    question level.

    D- Field is only visible IF User is in the

    role type Internal AA User. The

    Category field will providing another

    layer of help in grouping items so

    that its easier to filter / select by

    category designation when the AA

    User accesses the products module.

    This will be a custom field managed

    in admin panel.

    E- If Visibility = Private AND User =

    Internal AA, then the question is only

    viewed to others with Internal AA

    role type. If Visibility = Public AND

    User = Internal AA, then the question

    is published to anyone that has

    access to that QBank item.

    If Visibility = Public AND User =

    Teacher, Tutor OR External AA, the

    question is shared with all other like

    Users in the same institution AND

    department.

    If Visibility = Private AND User =

    Teacher, Tutor, OR External AA, the

    question is only visible to the

    question author.

    A

    B

    C

    D

    E

    Custom

    field:

    later

    Phase

  • QBank and Passages v.04

    Page 33 of 36

    Theme-03: Passage Summary View Interaction 03A- Passage Summary Page

    A- User filters through passages.

    Note that if filter shows a drop

    down, User can smart-type

    within drop down options, OR

    can click dropdown icon to

    browse and select filter options.

    Filter options default to ALL.

    A.1- Clicks Select for Standard

    System, taken to Interaction 01B

    A.2- Clicks Select for Curriculum

    Category, taken to Interaction 01D

    A.3- Clicks Select for Test

    Applicability, taken to Interaction

    01C

    A.4- Selects subject dropdown

    (universal custom field, designated

    in admin panel)

    A.5- Status Options: (1) Draft, (2)

    Active, (3) Inactive, (4) Ready for

    Review

    A.6- Author Shows me OR any

    User in institution that has created a

    passage and has made it public &

    active

    A.7- Assigned to filter will only

    show IF User type = Internal AA

    User

    A.8- Add Passage Features filter

    to list, per Interaction O.1.

    B- Searches by:

    Passage Name

    Standard System and

    Substandards

    Keyword

    Affiliated Tags

    C- IF there is 1 assessment, show

    assessment name. If there is

    >1 assessment, show # and link

    it. Clicking link takes User to

    Interaction 01F.

    D- Takes User to Interaction 02P.

    A

    B

    C D E F

    G

    E- IF there is 1 tag, show tag name. If there is >1 tag, show # and link it. Clicking link takes User to pop-up window in Interaction 01G.

    F- IF there is 1 standard, show standard name. If there is >1 standard, show # and link it per Interaction 01H.

    G- When User hovers over a row, the view, edit and delete icons will show. On click of view icon, User views passage attributes per

    Interaction 02Q. On click of edit icon, User taken to edit passage per Interaction 04A. On click of delete icon, User will be asked if he /

    she is sure question should be deleted.

    Category

    Custom field: later Phase

    Note: Add Passage Features filter here

    as well, per O.1

  • QBank and Passages v.04

    Page 34 of 36

    Theme-04: Create / Edit Passage Interaction 04A- Step 1: Enter Passage Information

    A- Shows whatever is listed in the custom fields.

    User can select >1 subject. Note that User

    can search and filter through drop-down

    options or browse.

    B- Shows whatever is listed in the custom fields.

    User can select >1 grade. Note that User can

    search and filter through drop-down options or

    browse.

    C- Discussed in Interaction 01B

    D- Discussed in Interaction 01D

    E- Discussed in Interaction 01C

    F- WYSIWYG editor shows regular and HTML

    formatting views. IF Math or Science is

    chosen, math WYSIWYG options populate in

    addition to the standard WYSIWYG options.

    G- User can choose an image from local machine

    to upload and insert into question, along with

    content. User should be able to scale the

    picture size.

    H- Passage text has no constraint.

    I- On-click, takes User to Step 2

    J- On-click, User previews question

    K- On-click, saves. Default status will be Draft

    and the question will be private (two fields

    that the User fills out in step 6) until the User is

    ready to activate that question and / or make it

    public. User gets success message saying

    Question successfully saved and stays on

    page.

    L- Add Item Category options in the passage

    area as well: QBank, Fixed Form, PD. IF User

    = AA AND has permissions to see fixed form

    passages, then he / she will be able to

    categorize is as such. In order to see Item

    Category, User must be role type: Internal AA.

    A

    B

    C

    D

    E

    E F

    E

    G

    E H

    E

    I

    J

    E

    K

    E

    Add Item Category options here

    ellhere so passage cn

    Note: Add Passage Features

    filter here as well, per O.1

    Category

  • QBank and Passages v.04

    Page 35 of 36

    Interaction 04B- Step 2: Tag Passage- Phase 2

    04B.1- User highlights passage, then is prompted to click Tag

    04B.2- User adds tags and clicks Add when tagging complete.

    04B.3- When tagged, User views pop-out on-hover of Tagged icon

    and can view the tags relevant to that passage.

    04B.4- Business Justification for Passage Tagging

    The purpose of this is so that AA can start compiling a record of

    snippets of passage with specific tags. This can be used for

    reporting later in Build 2 or can be used for more intricate,

    smarter, and predictive features in assessment / question

    creation later.

  • QBank and Passages v.04

    Page 36 of 36

    Interaction 04C- Step 3: Review & Publish Passage

    A- Status defaults to Draft

    B- The Assign To field is only visible to

    Users with Internal AA role type that

    have permissions to access passages.

    Note that when a passage, he / she will

    receive a notification on the portal saying

    C- User has ability to tag a passage. Any

    tags pertaining to an associated passage

    will be inherited here, and the User can

    remove the tag at the question level.

    D- Field is only visible IF User is in the role

    type Internal AA User. The Category

    field will providing another layer of help in

    grouping items so that its easier to filter /

    select by category designation when the

    AA User accesses the products module.

    This will be a custom field managed in

    admin panel.

    E- If Visibility = Private AND User = Internal

    AA, then the question is only viewed to

    others with Internal AA role type. If

    Visibility = Public AND User = Internal

    AA, then the question is published to

    anyone that has access to that QBank

    item.

    If Visibility = Public AND User = Teacher,

    Tutor OR External AA, the question is

    shared with all other like Users in the

    same institution AND department.

    If Visibility = Private AND User =

    Teacher, Tutor, OR External AA, the

    question is only visible to the question

    author.

    A

    B

    C

    D

    E