Skip to main content

Step-by-step guide

Use Test Builder

Test Builder is a four-part teacher workflow: maintain the Item Bank, Build Test, Preview & Export, then use Results & Follow-up. Generated tests, answer files, packets, and analysis stay local and require teacher review.

Teacher goal

Where do I start when I need to build, export, check, and follow up on a local test?

Use this guide when this is the task in front of you. Stop if the selected class, learner, role, school year, file, or output does not match.

In-app path

  1. Test Builder

Get ready

Check the starting point

These are the minimum conditions for the workflow to make sense.

Before you start

Estimated time: About 10–20 minutes

  • A saved class, subject, and term when the test is class-linked
  • The item types, component, and AI-use choice
  • A teacher review step for generated content and manual-check items

You should see

Test Builder shows the intended class, subject, term, item bank, build readiness, preview, and results stages without skipping locked steps.

Steps

Complete the task in order

Review choice points, save or preview behavior, and any stop condition before continuing.

  1. Test Builder item bank with class, subject, filters, and item actions.View full size
    Sample data only. The item bank context controls which questions are available to the test. Captured July 12, 2026.

    Step 1

    Open the item bank in the correct context

    Choose Test Builder and confirm the class, subject, and term. Review the item bank filters before creating, importing, selecting, or editing any item.

    Expected result: The item bank context controls which questions are available to the test.

  2. Test Builder item-authoring view with prompt, answer, metadata, and save controls.View full size
    Sample data only. The item editor is the review point for question and answer correctness. Captured July 12, 2026.

    Step 2

    Author and review each item

    Enter the prompt, item type, choices or expected answer, points, competency or tags, and any explanation required by the editor. Save only after checking language, answer correctness, accessibility, and learner appropriateness.

    Expected result: The item editor is the review point for question and answer correctness.

  3. Test Builder import view with source selection, extracted-item preview, and validation guidance.View full size
    Sample data only. Imported items remain a teacher-review draft until warnings and answers are checked. Captured July 12, 2026.

    Step 3

    Import items and resolve every warning

    Use Import items for a supported local source, then review extracted questions, warnings, duplicates, and answer choices. OCR or imported text requires teacher verification; do not save a question merely because extraction completed.

    Expected result: Imported items remain a teacher-review draft until warnings and answers are checked.

  4. Build Test screen with a not-ready state and required corrections.View full size
    Sample data only. The readiness panel prevents an incomplete test from being exported. Captured July 12, 2026.

    Step 4

    Select items and read build readiness

    Choose only the intended active items, then open Build test. If the screen says the test is not ready, resolve the listed missing title, structure, item, answer, or settings requirement before continuing.

    Expected result: The readiness panel prevents an incomplete test from being exported.

  5. Ready Build Test screen with selected items, total points, and preview controls.View full size
    Sample data only. A ready build has a reviewed structure and complete selected items. Captured July 12, 2026.

    Step 5

    Configure a ready test

    Set the test title, instructions, item order, points, and supported paper or formative settings. Confirm total items and points match the intended assessment before previewing.

    Expected result: A ready build has a reviewed structure and complete selected items.

  6. Preview and export view with separate learner-paper, answer-key, and packet actions.View full size
    Sample data only. Separate previews protect learners from answer leakage. Captured July 12, 2026.

    Step 6

    Preview learner paper and answer key separately

    Open Preview and export, then inspect the learner paper and answer key as separate outputs. Confirm the learner paper does not expose answers and that the answer key matches item numbering and alternate-form order.

    Expected result: Separate previews protect learners from answer leakage.

  7. Test structure preview with sections, numbering, readiness, and manual-review guidance.View full size
    Sample data only. The structure preview is the last content check before versioned output. Captured July 12, 2026.

    Step 7

    Review test structure and manual-check items

    Check section order, item numbering, points, page flow, directions, and any item that needs manual teacher review. Resolve flagged items before creating versions or packets.

    Expected result: The structure preview is the last content check before versioned output.

  8. Alternate test form created with version identity and review actions.View full size
    Sample data only. Every alternate form needs its own order and answer-key check. Captured July 12, 2026.

    Step 8

    Create and verify alternate forms

    Create an alternate form only from the reviewed base test. Record the version label and verify item order, answer-key mapping, and learner/version matching before use.

    Expected result: Every alternate form needs its own order and answer-key check.

  9. Local packets view with generated learner paper, answer key, and review packet.View full size
    Sample data only. Packets are local assessment files and still require teacher inspection. Captured July 12, 2026.

    Step 9

    Create local review packets

    Generate local packets only after the test and answer key are reviewed. Open the learner paper, answer key, and packet documents and check that local teacher-copy labeling is honest.

    Expected result: Packets are local assessment files and still require teacher inspection.

  10. Test Builder Results workspace with the selected test, version, learner coverage, and follow-up actions.View full size
    Sample data only. Results must be tied to the intended test version and class before answer entry. Captured July 12, 2026.

    Step 10

    Open Results in the intended test version

    Choose Results, select the intended generated test and version, then confirm the learner coverage and follow-up state before recording answers. Stop when the class has no learners or the version is not the one issued.

    Expected result: Results must be tied to the intended test version and class before answer entry.

  11. Results workspace with learner answers matched to the selected test version.View full size
    Sample data only. Learner and version matching protects scoring accuracy. Captured July 12, 2026.

    Step 11

    Record or import learner answers

    Open Results and choose the correct test version before entering answers. Confirm learner identity and version for every row; save only the answers you reviewed.

    Expected result: Learner and version matching protects scoring accuracy.

  12. Scan review with uncertain marks and teacher confirmation controls.View full size
    Sample data only. No uncertain scan result should be silently accepted. Captured July 12, 2026.

    Step 12

    Review uncertain scan marks

    For scanned answer sheets, open the scan-review queue and inspect every uncertain or conflicting mark. Correct only from visible evidence and keep manual-review items for teacher scoring.

    Expected result: No uncertain scan result should be silently accepted.

  13. Results analysis with class performance and follow-up information.View full size
    Sample data only. Analysis is useful only after answer and learner coverage are trustworthy. Captured July 12, 2026.

    Step 13

    Read results and analysis as decision support

    After answers are verified, review class results, item performance, and follow-up suggestions. Treat incomplete learner coverage and manually scored items as analysis limits.

    Expected result: Analysis is useful only after answer and learner coverage are trustworthy.

  14. Item insights with performance indicators for reviewed test items.View full size
    Sample data only. Statistics guide teacher review; they do not replace content judgment. Captured July 12, 2026.

    Step 14

    Inspect item insights before reusing questions

    Use Item insights to identify unusually easy, difficult, or weakly discriminating items. Review the actual prompt and teaching context before editing or retiring an item.

    Expected result: Statistics guide teacher review; they do not replace content judgment.

  15. Generated tests history showing the same Grade 1 English Term 1 scope and selected local test record.View full size
    Sample data only. The selected history row must agree with the active class, subject, and term before files are opened or reused. Captured July 12, 2026.

    Step 15

    Open generated history and inspect the files

    Use Generated tests to locate the intended test and verify its class scope, item count, versions, exported-file count, results, and reuse status. Choose Export files only from the selected matching row.

    Expected result: The selected history row must agree with the active class, subject, and term before files are opened or reused.

  16. Rendered actual Test Builder learner paper for fictional Grade 5 Mathematics, Version A, with three questions and the local non-official footer.View full size
    Sample data only. The learner paper contains no answer key and visibly identifies itself as a local teacher-owned document. Captured July 12, 2026.

    Step 16

    Open the actual learner paper and keep answers separate

    Open every exported learner paper, answer key, checking sheet, structure summary, and packet that will be used. On the learner paper, verify the test identity, version, item numbering, page layout, absence of answers, and the footer stating that it is a local teacher-owned DOCX and not an official DepEd template.

    Expected result: The learner paper contains no answer key and visibly identifies itself as a local teacher-owned document.

Review

Check these before relying on the work

These checks cover saved, previewed, generated, and teacher-review states.

  • Scope and structure match

    Class, subject, term, purpose, component, item order, versions, and total points match the teacher's assessment plan.

  • Ready items are reviewed

    Every selected item has a clear stem, answer or manual-check path, competency, difficulty, and supported scope.

  • No answer leakage

    Learner papers contain no answer key, checking mark, or teacher-only analysis.

  • Manual-check work stays manual

    Enumeration, Matching type, Essay / written response, and any unresolved scan mark require teacher review.

  • Version claims are accurate

    A shuffled form is not described as fully equivalent when item-family readiness has warnings.

  • Actual DOCX files are inspected

    Open the exported learner papers, answer files, and packet documents before printing or classroom use.

Blocked states and recovery

Fix the blocker before continuing

Use the direct recovery action when GuroAssist is waiting for setup, data, access, policy, or file readiness.

  • Scope or active items are missing

    Choose the class, subject, term, and at least one ready active item before generating.

    After recovery: The intended class appears in the workspace header and the task uses that class.

    Review class setup
  • Item needs review

    Missing answers, invalid choices, unsupported scope, or unresolved import warnings keep an item from safe use.

    After recovery: No unresolved scan or manual-check item remains, and the reviewed result is ready to save.

    Troubleshoot this blocker
  • Paid is required for generated files

    Local item work is available as supported, but test and packet file generation requires Paid.

    After recovery: Paid access and any required credits are shown as available for this action.

    Open activation help
  • Equivalent alternate forms are not ready

    Resolve every item-family warning or use the clearly labeled shuffled alternate form.

    After recovery: The blocker is no longer shown, and the intended next action is available for teacher review.

    Troubleshoot this blocker
  • Results have unresolved answers

    Blank answers, manual-check items, low-confidence marks, unknown learners, and version mismatches stay in review before analysis.

    After recovery: The intended learner is selected and the learner-dependent action is available.

    Review roster help

Safety note

Test Builder produces local teacher materials and analysis aids. The teacher remains responsible for item quality, version claims, checked answers, remediation decisions, and every file used in class.

Finish

Verify the result

Do not treat a saved screen or generated filename as proof that the work is ready.

You’re done when

Test Builder shows the intended class, subject, term, item bank, build readiness, preview, and results stages without skipping locked steps.

Glossary

Expand the terms used in this guide

Use the plain-language meaning here, then follow the exact label in GuroAssist.

AI
Artificial intelligence; optional draft help that still requires teacher review.

Guide details

Guide verification

Use these details to confirm that this guide matches the GuroAssist version and school year you are using.

Verification
Verified with GuroAssist 1.0.0.0
Last reviewed
July 11, 2026
Screenshots
Captured July 12, 2026
Applies to
2026–2027

Was this helpful?

Choose an answer or report a guide that needs attention. No class, learner, or free-text data is sent by these buttons.