ExamNovaDocumentation
Offline readyChangelog
Prepare eligible participants

People, students, guardians, and roster imports

Create or synchronize only the identities and relationships ExamNova needs for assessment delivery and reporting.

Institute administratorIntegration administrator
Who does thisInstitute or integration administrator
Before you startAcademic structure and external identifier rules are ready
Successful outcomeEligible participants are mapped without duplicating the source system
Assessment integration flowExternal IDs enter through validated runs; only finalized results leave through controlled exports.SourceValidateMap IDsConflict reportAssessmentPublished resultExport
Assessment integration flow. External IDs enter through validated runs; only finalized results leave through controlled exports.

What this means in plain language

ExamNova needs enough identity and enrolment context to assign exams and show permitted results. The school system remains authoritative for the broader student record.

Step-by-step

  1. Choose the approved manual, CSV, or REST process and download the current template when using CSV.
  2. Provide a stable source-system name and external ID for synchronized records.
  3. Validate the run before committing it. Resolve missing parents, duplicate identifiers, and invalid academic references.
  4. Create student and guardian relationships only when they are required for assessment access.
  5. Review created, updated, skipped, and failed rows. Save the run report for audit purposes.
  6. Sign in with a test student or guardian account to verify the permitted portal view.
ExamNova students screen
Live seeded-demo screen. Administrators manage assessment-facing student profiles and imports.
ExamNova parent portal
Live seeded-demo screen. Guardians see only linked children and permitted published information.
ExamNova roles list
Live seeded-demo screen. Roles support job-specific access rather than shared accounts.
ExamNova institute users screen
Live seeded-demo screen. Administrators manage staff and portal access within the active institute.
ExamNova guardians screen
Live seeded-demo screen. Administrators manage assessment-specific guardian relationships.
ExamNova selected-child result view
Live seeded-demo screen. A guardian can review only an explicitly linked child.
ExamNova parent portal on a mobile viewport
Live seeded-demo screen. The child switcher and result summary reflow for narrow screens.

How to know it worked

Common mistakes

  • Using email addresses as permanent external IDs when they can change.
  • Re-importing corrected rows without the original idempotency context.
  • Treating a guardian link as permission to view unpublished results.

If something goes wrong

  • Compare the source system and external ID before merging apparent duplicates.
  • Download failed-row reports and correct the source rather than editing around repeated import errors.
  • Check both relationship status and publication state when a guardian cannot see a result.
Privacy and security: Import only the minimum assessment data required. Protect CSV files as confidential records and remove temporary copies according to policy.

What to do next

Build and approve reusable questions in the Question Bank.