Understanding Brillium's Data Object Structure

Brillium is built upon a standard object architecture that provides a traversable relationship between workspaces, assessments, topics, questions, and associated results.

The Basics

Brillium is built upon a standard object architecture that provides a traversable relationship between objects, such as account workspaces, assessments, question groups, questions, and associated results.

The object relationships are illustrated in the following diagram:

Brillium Object StructureWorkspaces

Account workspaces are created for assessments authors, result and report viewers, and users that will download results. Workspaces are accessed using an Account ID and Password.  All objects (i.e. assessments, results, etc.) in Brillium reside under one or more account workspaces.

Each account must have a unique ID. Workspaces represent a single user or group.  The specific needs of a specific organization will help to dictate how account structure is planned. Normally, account workspaces are created for each assessment author or each collection of assessments created for a specific purpose (i.e. assessment organization by language, regions, topic, etc.)

Primary Account Workspaces

The Primary Account Workspace is the account that sit at the top of the object hierarchy.  They do not exist below any object in the data hierarchy. The Primary Account Workspace is the designated account for the application administrator and maintains access to all objects in the data hierarchy for a particular account subscription.

A Workspace is any account created and controlled by a “parent” account. This could be the Primary Account Workspace or any other Workspace. The number of Workspaces available within the application is only limited by the number of Brillium Author licenses purchased. Each author license provides access to a single Workspace. Each Workspace may create additional Workspaces, thereby creating a multi-level hierarchy that can be used to assign security privileges to Workspaces under its control. A Workspace can be designated as a “template” Workspace to facilitate the creation of additional Workspaces and assessments.


The term assessment refers to tests, quizzes, exams, surveys, etc., and are all objects owned by Workspaces.  Each Workspace may create an unlimited number of assessments, each identified by a unique assessment ID across the Brillium subscription.


Topics are objects owned by assessments and contain a collection of questions. Topics are used to organize and logically group assessment questions into assessment knowledge areas.  For example, a hotel management assessment might have oneTopic about housekeeping issues and a different Topic regarding front desk activities.  The questions contained within each Topic may be presented randomly or sequentially. Large banks of questions can be created within each Topic regardless of the number of questions that are presented to respondents.  


Questions are organized into Topicss, and may be created in unlimited numbers. Questions are classified as Test Question Types, Survey Question Types, and Content Types.

  • Test Question Types  - have an associated correct answer and a point-value
  • Survey Question Types - do not have an associated correct answer or a point-value
  • Content Types - present only  question or content (such as image or video) and do not have associated distractors/answer choices.  

Additionally, there are 2 types of Branching Question Types:

  • Test Branching Question – which functions like a test question type, with an associated pint-value and correct answer.
  • Survey Branching Question  - which functions as a survey type question, with no associated point-value or correct answer and are commonly used when designing dynamic, responsive surveys.


Respondents are end-users designated to complete a test or survey created in Brillium. The only limitation to the number of respondents who can take assessments within Brillium is the number of Respondent licenses purchased under the subscription.

Mobile Device Support

Brillium delivers assessments to mobile devices (phones, tablets, etc.) in a “mobile optimized” delivery format. Brillium will optimize the layout of the assessment to support the varied screen sizes of mobile devices.