QUESTIONNAIRES / PRESENTATION

Ordering

Ask the learner to put a sequence in the correct order.

1. What the learner does and sees

Ask the learner to put a sequence in the correct order.

Use it for procedures, timelines, phases, priorities, or any content where the complete order is part of the answer.

2. Create in Studio

This is the normal path if you are creating the course visually. You don't need to write JSON or execute commands.

  1. Abre Studio.Use the hosted editor or the Studio you have integrated into your project.
  2. Add the activity.In Add content, abre Games and choose Ordering.
  3. Edita visualmente.Change statements, responses, and options with editor controls. The JSON remains as an advanced view, not a requirement for use.
  4. Check the learner View.Play the activity before downloading or saving the course.

3. Content requirements

  • In Studio it is created as a question of type Ordering.
  • Each sequence must have at least three elements.
  • solution.order must contain all identifiers exactly once.
  • The activity requires embedded solutions.

4. Valid data example

This block shows a complete and valid questionnaire for this presentation. It is used to understand the format or to walk through the CLI; If you use Studio, the editor generates this structure for you.

quiz.json
{
  "schema": "https://p2lrn.org/schema/native-questionnaire/0.4.0",
  "version": "0.4.0",
  "title": "Order the water cycle",
  "language": "en",
  "grading": {
    "mode": "embedded-key"
  },
  "questions": [
    {
      "id": "q1",
      "type": "ordering",
      "prompt": "Order the stages",
      "points": 3,
      "items": [
        {
          "id": "i1",
          "text": "Evaporation"
        },
        {
          "id": "i2",
          "text": "Condensation"
        },
        {
          "id": "i3",
          "text": "Precipitation"
        }
      ],
      "solution": {
        "order": [
          "i1",
          "i2",
          "i3"
        ]
      }
    }
  ]
}

5. How to read the example

items contains the visible elements. solution.order declares the correct sequence using its identifiers.

6. Create by CLI — advanced alternative

Use this tour only if you are generating the course by code. Requires Toolkit installed via NPM. The file quiz.json It must contain a valid questionnaire like the example above.

Terminal
p2lrn-create add-questionnaire ./workspace ./quiz.json \
  --key quiz \
  --title "Ordering" \
  --renderer "https://p2lrn.org/renderer/questionnaire/ordering"

p2lrn-create build ./workspace ./course.p2lrn --strict-profiles

--renderer Select the preferred presentation. It does not create a second copy of the questions: the content remains the native questionnaire.

7. Technical presentation identifier

Typically Studio sets this up for you. You only need this identifier when you select presentation from code, CLI, or the viewer.

Technical identifier

https://p2lrn.org/renderer/questionnaire/ordering

Profile

https://p2lrn.org/profile/native-questionnaire

Content type

application/vnd.p2lrn.questionnaire+json

8. Interaction and accessibility

The learner can reorder by dragging and also has controls to raise or lower elements.

9. Completion and scoring

The current order is compared to the solution. When the sequence is correct, the activity communicates the result.

To save the result on your platform, see Events and Host Adapter.

10. Try the example

Open the demo package in the real viewer and check the interaction before integrating it.