InitOptions
| Attribute | Type | Description | Default |
|---|---|---|---|
| dsn* | string | The DSN tells the SDK where to send the events. If this is not set, the SDK will not send any events. | |
| session_identifier* | string | Value that can identify the proctored session in the source platform. | |
| allowed_languages | [locale.languages][] | This will limit language options for users to select from the supported list | All supported languages |
| language | [locale.languages] | Explicitly set the SDK language | Browser default if its not supported then fallback to English (en-US). |
Error
| Attribute | Type | Description | Default |
|---|---|---|---|
| code | string | This will identify predefined error by code. Ref Error Code section | |
| message | string | Message will contain reason for the error. | |
| Type | Warning/Critical | Error could be of type warning or critical. When critical error is raised it will impact core proctoring feature delivery. | |
| ValidationErrors | ValidationError[] |
Validation Error
| Attribute | Type | Description | Default |
|---|---|---|---|
| path | string | Path of the attribute | |
| message | string | validation error message | |
| code | string | Validation error code |
Session Type Definitions
session.constant.type
Its of type enum which contains following values.RecordedRecordedAndReviewLiveDynamic
session.constant.state
Its of type enum which contains following values.initregisteredrunningpausedsuspendedterminatedstoppedcompleted
SessionOptions
| Attribute | Type | Description | Default |
|---|---|---|---|
| type | session.constant.type | ||
| identifier | string | unique session identifier from the source system. It will be the session external id in the Talview platform. |
SessionOutput
| Attribute | Type | Description | Default |
|---|---|---|---|
| uuid | GUID | Reference Talview identifier for client application to track. | |
| state | session.constant.state | ||
| attendee | Attendee | ||
| workflow_step | Workflow | If not passed then system will generate email based on identifier. e.g: Att0001@dnd.talview.com | |
| identifier | string | unique session identifier from the source system. It will be the session external id in the Talview platform. |
Attendee Type Definitions
Attendee
| Attribute | Type | Description | Default |
|---|---|---|---|
| identifier* | string | unique user identifier from the source system. It will be the external id in the Talview platform. | |
| first_name | string | ||
| last_name | string | ||
| middle_name | string | ||
string | If not passed then system will generate email based on identifier. e.g: Att0001@dnd.talview.com | ||
| country_code | string (3) | ISO country code | |
| country | string | Country code is passed then system will auto identify the country otherwise system will identify country code from country. | |
| phone | string (15) | E164 format | |
| id | int | Talview unique id generated for the course |
Workflow Type Definitions
Exam Workflow
| Attribute | Type | Description | Default |
|---|---|---|---|
| identifier* | string | Unique identifier for the exam from the calling application. It will be the external id in the Talview platform. | |
| name | string | Name of the exam | If name is not passed then external id will be used. |
| flow_id | int | This is the proctor session onboarding flow identifier. | if not passed then detail flow will be mapped based on project DSN |
| duration | int | duration of the exam in min | |
| resource | [{string,string}] | Array of key value pair to persist additional info related to exam. | |
| course | [Course] | ||
| id | int | Talview unique id generated for the course |
Course
| Attribute | Type | Description | Default |
|---|---|---|---|
| id | int | Talview unique id generated for the course | |
| name | string | Name of the Course the exam is part of. | Exam workflow name |
| identifier | string | Unique identifier for the course from the calling application. If not set then exam identifier will be used. | Exam workflow external id |
| resource | [{string,string}] | Array of key value pair to persist additional info related to course. |
Locale
| Attribute | Type | Description | Default |
|---|---|---|---|
| language | string | based on browser info | |
string | ISO 4217 currency codes | based on browser info | |
string | Timezone | based on browser info |