F4312: [Luyten] [Continued] item Sets in item navigation breadcrumb with dynamic headingEdit

Description
As a candidate 
I want to be able to flag an individual item within a group
So that I can clearly identify which item I need to re-visit

Current situation: This is a follow up feature from F4002, which includes navigation breadcrumbs for items within item sets. The Medical Council of Canada (MCC) create Item Sets in Item Authoring in order to ensure that items on the same topic (e.g. about a particular patient scenario) are delivered together. When items are in an item set, if one item from the set is added to a test, then the rest of the items are added too. This ensures that when creating a test, test creators cannot forget any of these items and, because if they did, then it could mean that the questions no longer make sense. Item sets also help control the order that the items within the set are delivered in by allowing item authors to say whether the order is fixed or not. Again, some item sets must be delivered in a specific order for the items to make sense (and not give away answers): 

Example item set (note, these would be delivered on separate pages, not as a group where all are on one page)

Item one:
Q:Which country's flag is displayed in the image?
A: France

Item two: 
Q: What is the capital of France?
A: Paris

Item three: 
Q: What is the name of the famous art gallery in Paris?
A: Louvre

My understanding is that item sets are known about up until the point that the test is generated, so that the items are in the correct place in the Page XML. I don't think that delivery knows about item sets as it just follows the Page XML. This means that in delivery, items are treated as unique items, each getting a breadcrumb with their own number (1, 2, 3, 4, 5).


Objective: This feature is to make it clearer to candidates that some items are in an item set (to them, this mean that the questions are about the same topic). We want to indicate this via different numbering for item within a set and by a change in the breadcrumb UI.


Acceptance criteria:
  1. Item Set Numbering will be included in the following areas.
    1. Result APIs
    2. Section Feedback
    3. Quality Review panel
  2. Test creator will be able to select an option in Test Profiles > Delivery Presentation, to "Show" or "Hide" the item set header. 
    1. This option will be greyed out when Item Set Numbering is disabled, and will be available when Item Set numbering is enabled.
      1. When Item Set Numbering is disabled, the item set header will not display in HTML Delivery. 
    2. Selecting show will display text boxes which the user can add text to for the Item set label  and item label  
    3. Text boxes can not be empty when item set header option is set to "show"
      1. Error message will display if user attempts save changes when the text boxes are blank.
  3. Item set header will be displayed across all items within an item set, displaying the Item Set label, item label and the item number out of the set in HTML Delivery.
    1. Font settings will not be editable. Font settings will be as per the mock-up.
    2. Colour of the item set header will match the background and border colour that is selected in the test profile in delivery. 
  4. Wording for Item Set Numbering option will be changed from 'Enabled' & 'Disabled' to 'Enable' & 'Disable'
  5. Wording change: "Question 1 of 4" to "Question 1/4"
Accessibility: 
  1. Current situation
    1. Items in Surpass have a top level heading (<h1>) which is hidden off screen and only available to screen readers. The heading uses the .screen-reader-only CSS class.
      1. When Item Set Numbering is disabled in Test profile:
        1. The heading text reads: "Question #" where # is the number of the current item.
      2. When Item Set Numbering is enabled in the Test Profile:
        1. The heading text reads: "Question #.#" where #.# is the number of the item set item*
          1. *This functionality is introduced in defect fix DE34787 
    Objective
    1. When Item Set Numbering and Item Set Header is enabled in the Test Profile:
      1. Apply the Item set name and Item name values to the existing heading element.
      2. Expose the heading in the UI.
        1. Remove the .screen-reader-only CSS class.
        2. Apply new CSS design to heading.

    Acceptance criteria
    1. Heading should be marked up as top level H1.
    2. Maintain functionality to move focus H1 when Item is loaded.
      1. H1 has tabindex="-1"
Mockup:



Not for consideration:
  1. Word Doc Export (Item Authoring) - Not needed as this in an item level thing, numbering is a test level thing.
  2. Paper Mark Screen - Not required because the setting is going to be in Test Profiles and doesn't apply to test intended to be completed on paper. Unlike Printable Test
  3. Flash Results Screen > OMR Upload - Not required because the setting is going to be in Test Profiles and doesn't apply to test intended to be completed on paper. Unlike Printable Test
  4. Test Admin > Candidate Review > This is because HTML Tests cannot be reviewed via Candidate Review
  5. Mark Screen (Flash) > Mark Script Dialog > Question drop down - this should be inherited when HTML equivalent of this is implemented as we are using a delivery style UI for this. 
  6. Re-Mark Screen > View Responses Dialog > Question drop down - this should be inherited when HTML equivalent of this is implemented as we are using a delivery style UI for this. 
  7. Audit Screen > View Responses Dialog > Question drop down - this should be inherited when HTML equivalent of this is implemented as we are using a delivery style UI for this. 
  8. Moderate Screen > View Responses Dialog > Question drop down -  this should be inherited when HTML equivalent of this is implemented as we are using a delivery style UI for this.
  9. SecureMarker > Script Review - not for consideration as SecureMarker does not currently have a concept of item item numbering
  10. Moderate Screen > Quintile Analysis Report
  11. Audit Screen > Quintile Analysis Report
  12. Reporting > Rescoring > Rescoring Event > Item Position in Test Form
  13. Reporting > Analytical Data > Test Form > Items Delivered > Item Position
  14. Reporting > Analytical Data > Test Form > Items Delivered > Raw Data Extract > Presented Order
  1. Item set header header will not be viewable in:
    • Item preview
    • Printable tests.
    • Marking screens 
Questions:
can we have text to be question 1/4 instead of 1 of 4? if 1 of 4 then we will need aliasing - Mockup will show what using the / will look like
Will we need a character limit for editing text in item set header? Text box should be a standard size (30 characters?) and then a tooltip to be provided. 
What will the UI look like in Item Authoring? - UI now affected in Test Profiles
Will this need to be editable for item labels or at an item set level? - Item Set level
If its editable at Item set level then how will it be in sink with test profile - Background and borders should match whatever is selected as test profile in delivery.
Also if we are going to configure it at item set level and suppose that multiple item sets are there in a section,
then there be different header format for different item set in same test so will it be fine - Changing this setting in at the test profile level will keep the same formatting for multiple item sets within a test.

Status
Completed (in Live Service) * - CPM

Owner
Nayan Mistry

Creation Date
03/09/2018

Last Updated
28/02/2019 08:53:36
NOT SET

% Development Complete
100.0%

Primary Affected Product

Current Workarounds

Desired Outcome

Demonstration Media