Event scheduling integration¶
Event scheduling integration can be used to add enrolments and schedule events between Janison Insights and an external system.
The following table shows the functions that can be used for each event scheduling element, as part of integration customisation.
| Element | Endpoint | Data Structure | Functions |
|---|---|---|---|
| User | /user |
user { userName (string), firstName (string, optional), middleName (string, optional), lastName (string, optional), dateOfBirth (string, optional), gender (string, optional), expiry (string, optional), addressLine1 (string, optional), addressLine2 (string, optional), town (string, optional), county (string, optional), country (string, optional), postCode (string, optional), email (string, optional), phone (string, optional), centres (Array[baseResource], optional), tests (Array[baseResource], optional), href (string, optional), id (integer, optional), reference (string) } |
GET (All) – Gets a list of users. Supports paging using $top and $skip parameters, sorting using $orderBy parameter and filtering using $filter parameter. POST (New User) – Creates a new user that does not already exist. GET (by Id) – Returns a single user that matches a specified ID. PUT (by Id) – Updates a single user by a known ID. |
| Candidate | /candidate |
candidate { firstName (string), middleName (string, optional), lastName (string), dateOfBirth (string), uln (string, optional), gender (string), expiry (string, optional), addressLine1 (string, optional), addressLine2 (string, optional), town (string, optional), countyID (string, optional), countryID (string, optional), postCode (string, optional), email (string, optional), phone (string, optional), retired (boolean, optional), centres (Array[baseResource]), tests (Array[baseResource]), href (string, optional), id (integer, optional), reference (string) } |
GET (All) – Gets a list of candidates. Supports paging using $top and $skip parameters, sorting using $orderBy parameter and filtering using $filter parameter. GET (By Id) – Returns a single candidate that matches a specified ID. POST (New Candidate) – Creates a new candidate that does not already exist. PUT (Updated Candidate) – Updates an existing candidate by ID. DELETE (By Id) – Retires the candidate by ID. |
| Test | /test |
test { name (string, optional), testpackages (Array[baseResource], optional), href (string, optional), id (integer, optional), reference (string, optional) } |
GET (All) – Gets a list of tests. Supports paging using $top and $skip parameters, sorting using $orderBy parameter and filtering using $filter parameter. GET (By Id) – Returns a single test that matches a specified ID. |
| Test Packages | /testpackage |
testpackage { name (string, optional), components (Array[baseResource], optional) } |
GET (All) – Gets a list of test packages. Supports paging using $top and $skip parameters, sorting using $orderBy parameter and filtering using $filter parameter. GET (By Id) – Returns a single test package that matches a specified ID. |
| Component | /component |
component { name (string, optional), type (string, optional), href (string, optional), id (integer, optional), reference (string, optional) } |
GET (All) – Gets a list of components. Supports paging using $top and $skip parameters, sorting using $orderBy parameter and filtering using $filter parameter. GET (By Id) – Returns a single component that matches a specified ID. |
| Centre | /centre |
centre { name (string), addressLine1 (string), addressLine2 (string, optional), town (string), county (string), country (string), postCode (string, optional), tests (Array[baseResource]), centreAdminUser (baseResource), href (string, optional), id (integer, optional), reference (string, optional) } |
GET (All) – Gets a list of centres. Supports paging using $top and $skip parameters, sorting using $orderBy parameter and filtering using $filter parameter. GET (By Id) – Returns a single centre that matches a specified ID. POST (New Candidate) – Creates a new centre that does not already exist. PUT (Updated Candidate) – Updates an existing centre by ID. DELETE (By Id) – Retires the centre by ID. |
| Test Schedule (a group of candidates on a date) | /testschedule |
testschedule { testPackageId (integer, optional), testPackage (baseResource), centre (baseResource), candidate (baseResource, optional), candidates (Array[baseResource]), testPackageDate (string), extendValidityPeriod (boolean, optional), roomReference (string, optional), testSessionId (integer, optional), href (string, optional), id (integer, optional), reference (string, optional) } |
POST (New Scheduled Candidate) – Creates a series of new enrolments based on a list of candidates and a test package ID. DELETE (By Id) – Retires the planned test schedule by ID. |
| Test Schedule Component | /testschedulecomponent |
testschedulecomponent { testScehdule (entityRef, optional), components (Array[entityRef], optional), href (string, optional), id (integer, optional), reference (string, optional) } |
POST (Set Test Schedule Component for Schedule ID) – Sets the components for a scheduled test package. Used to reschedule a single component of a test package when the candidate is required to resit the test. A new version of the test is then randomly selected and allocated. |
| Result | /result |
result { candidate (baseResource, optional), testPackage (baseResource, optional), centre (baseResource, optional), components (Array[resultComponent], optional), finalScaleScore (string, optional), overallCEFRGrade (string, optional), testPackageCompletionDate (string, optional), completed (boolean, optional), voided (boolean, optional), href (string, optional), id (integer, optional), reference (string, optional) } resultComponent { scaleScore (string, optional), CEFRGrade (string, optional), dateCompleted (string, optional), keycode (string, optional), includedInTotal (boolean, optional), rawScore (integer, optional), completed (boolean, optional), voided (boolean, optional), name (string, optional), type (string, optional), href (string, optional), id (integer, optional), reference (string, optional) } |
GET (All) – Gets a list of results. Supports paging using $top and $skip parameters, sorting using $orderBy parameter and filtering using $filter parameter. GET (by Id) – Returns a single result based on a specified candidate's result ID. |