Theme
On the "Theme" tab, you can:
- Make application rebranding according to your
company/organization colors.
- After making the desired changes click the "Confirm"
button.
- If you want to discard your changes, click the "Cancel"
button.
Language Bundles
In the "Language bundles" tab, users can customize the application interface text according to their needs
- change labels' names, create new hints, modify notifications' content.
There are 5 default language bundles in the system.
A language bundle is a file consisting of the key/value pair properties.
Each property is connected to one or multiple UI components based on a property key.
Note that it is not possible to delete default language bundles, but you can create new ones based on them.
Also, it is not possible to have two active bundles of the same type simultaneously.
There are two ways to create a custom language bundle:
- Changing the language bundle by editing one-by-one property value.
- Downloading the language bundle, editing the file offline using the desired text editor, and importing it into the application.
Note: The keys must not be changed. Otherwise, the changes will not be visible.
To create a new language bundle by editing one-by-one property value:
- Click the "Pencil" icon for the language bundle based on which you want to create a new one.
- Search the property value or key you want to change.
- Choose the desired key from the list. If you cannot find the key for the desired property value,
you can use preview key mode to easily find it.
For more information on how to use it, please visit the Preview keys mode.
- Edit the text.
- Confirm or discard the changes you made in the property value field.
Note: In one language bundle, you can edit as many property values as you want.
All of them will be displayed when you activate the language bundle.
- Click the "Save as" button to save a new language bundle.
To create a new language bundle by uploading a file:
- Download the language bundle and edit the file by changing the property values.
Note: The downloaded file will be saved in
.properties format.

- Load the file by clicking the "Load from properties file" button.
The "Choose file" dialog will appear. Choose a modified .properties file and confirm your choice.
- Click the "Save as" button to create a new language bundle or the "Save" button to update the existing one.

Once you create a new language bundle, it will have an inactive status.
To activate a new language bundle:
- Click the "Activate language" button.
- Click the "Yes" button in the pop-up window.
Note: Once you activate the language bundle, it will be applied globally, and the currently active
bundle of the same type will be deactivated.
Example of how the message looks before and after changes.
Before
After
You can reactivate the default language bundle at any time. If you want to delete a custom language bundle:
- Click the "Trash can" icon.
- Click the "Yes" button in the pop-up window.
After deleting a custom language bundle that was active, the default bundle will be activated automatically.
Preview keys mode
To easier modify the language bundles, you can use the option to display property keys.
- Click the "Activate preview keys mode" button.

- Open the page that contains the value you want to change. Then click the button to preview language bundle keys.
The example is displayed in the following picture.
- Find the value you want to change, language bundle type, and the property key. Then continue following the steps for creating custom language bundles.
The example is marked in the following picture.

Once you want to turn off the keys preview mode, click the "Deactivate keys preview mode" button in the "Language bundles" tab.

Custom types
Creating a custom type
In the "Custom types" tab, users can create custom type and define value for the "Dropdown" type of custom user properties.
- Click on the "Custom types" tab.
- Click the "New custom type" button to create the "Dropdown" type of custom user properties.
The new pop-up window will show up, where you should:
- Enter the name of the custom type. The name must be unique.
- Enter the description (optional).
- Click save to create a custom type.
- At any moment, you can cancel the creation of a new custom type by clicking the cancel button.
Creating a value of the custom type
Once you create a custom type, you should add new values. To do so:
- Click the show values icon (eye) to display a table of values for the wanted custom type.
- Click the "Add new value" button.
The new pop-up will show up, where you should:
- Enter the name of the value. The name must be unique.
- Enter the description (optional).
- Click save to add a new value to a custom type.
Editing and deleting custom types and their values
- At any moment, you can edit the existing custom type by clicking on the "pen" icon.
- You can delete the existing type only if there are no custom user properties of this type. In case
you want to delete the type, first you will need to delete the custom user property of this type.
- You can export the list of custom types as XLS, PDF, CSV, and XML files.
- At any moment, you can edit the existing value by clicking on the "pen" icon.
- You can delete the existing value only if there are no custom user properties of this type. In case
you want to delete the value, first you will need to delete the custom user property of this type.
- You can export the list of values as XLS, PDF, CSV, and XML files.
Jobs Dashboard
On the "Jobs Dashboard" tab you can create jobs that will be executed at the scheduled time, as many times as you mark.
The job allows you to automatically import the data from an external system into the YouTestMe GetCertified and export data from the YouTestMe GetCertified to an external system.
Creating a New Job
Click on the "New job" button.
A dialog will appear to enter all the necessary information to create and schedule a new job.
New job dialog consists of the following three sections:
- Job information - General information about the job, including type, name and description.
- Schedule settings - Parameters of the schedule, start time, end time, repeat interval, and the number of repeats.
- Job parameters - Specific job parameters related to the type of job.
Job Information
This part of the dialog is the same for each job regardless of the type you choose.
- Type - Choose whether you want to import or export data.
- Name - Enter the job name.
- Description - Optionally enter the job description.
Schedule Settings
This part of the dialog is the same for each job regardless of the type you choose.
- Start time - Choose the start time, the time when the job will execute for the first time. If the chosen start time is in the past, the first
execution will occur next time according to schedule (multiply of the repeat interval if job repeats) or will not occur if the job does not repat.
- Repeat - Check the "Repeat" option to repeat the job periodically in equal time intervals after the start time.
If it is unchecked, job will execute only once at the start time.
- Repeat forever - Check the "Repeat forever" option to repeat the job indefinitely or until the end time if specified.
- Number of repeats - If "Repeat forever" is unchecked, chose the number of repeats after the first job execution at the start time. If you choose three times, the job will be repeated three times in equal intervals after the start time and executed four times in total.
- End time - Optionally, choose the "End time." After the chosen time, the job will no longer execute, even if there are remaining repeats.
- Repeat interval - Specify the "Repeat interval," the time between two consecutive job executions. It could be at least 1 minute.
Job parameters
Importing data job parameters
To create a new "Import data" job, do the following:
- Resource - Choose the type of data to import. You can choose between:
- Users
- Tests
- Testing sessions
- Session candidates
- Location - Choose the "Location" from which the files with data will be imported:
- Choose "File system" to import data from files located in the folder on the server's file system.
- Choose "SFTP server" to import data from files located in the SFTP server folder. For the SFTP server, additional parameters have to be specified.
- Folder - Enter the absolute path to the folder in the chosen location to import files from.
- File names - Enter the regex expression to match the names of the files to import from the folder. For example, the regex expression "Users_.*\.csv" will match all the files whose name starts with "Users_" with the ".csv" extension.
- Modified only - Check the "Modified only" option to import only files created or modified after the previous job execution, or leave it unchecked to import all files from the folder satisfying the "File names" regex expression.
- File type - The only supported File type currently is CSV.
- Delimeter - Enter the character to use for separating entries in CSV file.
- Skip lines - Enter the number of lines in the CSV file to skip before reading. Usually, it is set to one to skip the first line, which represents the header.
Export data job parameters
- Resource - Choose the type of data to export referred to as "Resource." Currently, only the "Test results" (Completion statuses) option is available.
- Modified only - Check "Modified only" to export only records created or modified after the previous job execution. Otherwise, all records will be exported.
- Location - Choose the "Location" from which the files with data will be imported:
- Choose the "File system" to export the file to the folder located on the server's file system.
- Choose "SFTP server" to export the file to the SFTP server folder. For the SFTP server, additional parameters have to be specified.
- Folder - Enter the absolute path to the folder in the chosen location to export data to.
- File name - Enter the file name prefix of the file to export. The name of the exported file will be in the format: #{file_name}_#{timestamp}.#{file_type_extension}.
- File type - The only supported File type currently is the CSV.
- Delimiter - Enter the character to use for separating entries in the CSV file.
SFTP server parameters
- Location - Choose the "SFTP server."
- Host - Enter the hostname of the SFTP server.
- Port - Enter the port of the SFTP server.
- Username - Enter the username of the SFTP server user.
- Password - Enter the password of the SFTP server user.
The rest of the options are the same for each location and type.
Jobs list
Once you create a Job, you will see it in the table where all created jobs are saved and details about each.
For each job listed in the table, the following actions can be executed:
- Excecute the job immediately, disregarding the current schedule.
- Preview complete excecution history and logs of a job.
- Edit job.
- Use the previously created job as a template, so you can change only a few pieces of information and save it as a new job.
- Delete the job.
Execution history and logs
To preview the complete execution history and logs for all jobs in the system:
- Click on the "Execution history and logs" to see the details about executed jobs.
- See the job type.
- See the time when the job is excecuted.
- See the number of errors occured during excecution.
- Preview a log.
Job excuted notification
After each job execution, the system administrators will receive the notification.
To ensure that the system administrator will receive the notification, you need to enable it under "Notifications" tab.
For more information on how to enable Job executed notification, visit Notifications .
Webex settings
To set up the Webex integration, choose the "Webex settings" tab on the "System
settings" page.
"Client ID" and "Client Secret" need to be configured.
You can find this information after you register the integration on the hosting Webex account.
You should log in with the Webex hosting account on https://developer.webex.com/.
Click on the profile icon and choose "My Webex Apps".
Click on "Create a New App."
- Enter integration name.
- Enter Contact email.
- Choose icon.
- Enter Description.
- Enter Redirect URI, use the Redirect URI parameter from Webex Settings .
- Select all "Meetings" Scopes.
- Click "Add integration."
Once you create an integration, you will get the "Client ID" and "Client
Secret."
- Copy "Client ID" in the GetCertified Application under the "Webex
settings" tab.
- Copy "Client Secret."
- Click the "Save" button.
- Click the "Get token" button, and you will be redirected to the Webex page, where
you should log in again with the hosting Webex account.
- Once you are logged in, click the "Accept" button.
Once you accept, the "Validate token" button will appear in the GetCertified
application, which is an indication that you have access to this token.
Proctoring settings
Please note that the Proctoring service can be enabled only upon your request. For
more information,
contact the YouTestMe team at sales@youtestme.com.
Upon activation, you will be provided with all the necessary parameters for configuring the
proctoring service.
In case you request the proctoring service before the application delivery, all settings will
already be configured.
- To configure the Proctoring service, choose the "Proctoring
settings" tab on the "System settings" page.
- Enter the "Proctoring server URL" This
parameter represents the Web address of the Proctoring server and is provided by YouTestMe.
- Enter the "Secret key" provided by YouTestMe.
- Enter the "Session template" name. This
parameter represents the name of the proctoring session template
created in the Proctoring application. The session template
specifies additions (5) and metrics (6) of the Proctoring session.
Enter the "default" for the default session template.
* In the newer versions of the Proctoring service,
this is the only way to specify the proctoring session. Chosen additions (5) and
metrics (6) will not be considered.
- Choose the "Session metrics" from the
dropdown menu. The session metrics represent the events that the service tracks and penalizes
during the proctoring
session. * This configuration will be considered
only for the older versions of the Proctoring service.
- Choose the "Session additions" from the
dropdown menu. The session additions represent the
additional proctoring features that will be included in the
proctoring session. * This configuration will be
considered only for the older versions of the Proctoring service.
- Enter the "API address." provided by YouTestMe. Typically, it is a combination of
the URL address
of the YouTestMe GetCertified application and one of the endpoints
(/proctoringResultsNew, /proctoringResults) the
version of the Proctoring service.
- Click the "Confirm" button if you want to
save the Proctoring configuration.
- To reset the changes you have made, click the "Cancel"
button.
Proctorio settings
Please note that the Proctorio can be enabled only upon your request.
For more information, contact the YouTestMe team at sales@youtestme.com.
Upon the activation, you will be provided with the necessary
parameters to configure the integration with Proctorio.
- To configure the integration with Proctorio
automated proctoring service, choose the "Proctorio
settings" tab on the "System settings" page.
- Enter the "API endpoint" This parameter
represents the URL of the Proctorio API endpoint and is provided by YouTestMe or Proctorio.
- Enter the "Secret key" provided by YouTestMe or Proctorio.
- Enter the "Consumer key" provided by YouTestMe or Proctorio.
- Choose the "Exam settings" from the dropdown
menu. Exam settings enable you to choose the Proctorio features you want to add and control
during the proctoring session.
- Click the "Confirm" button if you want to
save the Proctorio integration settings.
- To reset the changes you have made, click the "Cancel"
button.
Additional modules
On the "Additional modules" tab, by enabling the next
options, you can:
- Hide user's private information.
- Configure SFTP Protocol and automatically receive test
results on your FTP server.
- Show or hide passed and failed labels through the
application.
- Allow users to register in the application without
the administrator's approval.
System support
The "System support" tab serves to enable customized
support. You can provide useful information such as support email,
support phone number, and an additional description for users
support page.
- Describe the purpose of email and phone.
- Provide desired support email.
- Provide desired support phone number.
- Here you can define useful details about support contact.
For example, expected email response time to customers' issues or
business hours when support is available, etc.
- The "Confirm" button will apply the changes.
- The "Cancel" button will delete everything
entered before saving.
Single sign-on
GetCertified can act as a Service Provider through the SAML
2.0 protocol, which allows the exchange of authorization data with an
Identity Provider. GetCertified supports OneLogin, Okta, SSO
Circle, and many other Identity Providers.
SAML 2.0 based Single Sign-on (SSO) can be configured for
multiple identity providers simultaneously. You need to create an
SSO configuration and define the parameters of the identity
provider. Each created SSO configuration you create has an assertion consumer
service end-point that will process the SAML response.
- To access the Single sign-on configuration
panel, choose the "Single Sign-on" tab on the "System
settings" page.
- By clicking the "Add new configuration" button, a
new pop-up
window
will appear where you can enter the parameters of the new SSO
configuration.
- All existing Single sign-on configurations are displayed
in the table with their names, descriptions, statuses, and available actions.
- By clicking the edit icon, a pop-up window
will appear, where you can change the parameters of the
selected SSO configuration.
- SSO configuration can be deleted by clicking the trash can
icon.
When creating a new
or updating an existing SSO configuration, you need to enter the parameters for configuring the service
provider's side.
When creating a new
or updating an existing SSO configuration, you need enter the parameters for configuring the service provider's side.
GetCertified provides the parameters that you need to configure the identity
provider's side.
- Enter the "Name" of the SSO configuration.
The name must be unique for each SSO configuration since it
identifies the SSO configuration.
- Optionally enter the "Description" of the SSO
configuration.
- Choose the "Status" of the SSO configuration.
If the status is "Enabled," users will be able to
sign in with the identity provider specified in the configuration.
Otherwise, they will not be able to do so.
- Use the provided "Service provider Entity ID" URL
to configure the service provider on the identity provider's side.
The value represents the service provider's identifier.
- Use the provided "Assertion consumer service URL"
to configure the service provider on the identity provider side.
The field's value represents the end-point URL, where the
SAML response from the identity provider will be returned.
- Choose the "Assertion consumer service
binding" that is suitable for the identity provider. The field's
value represents the SAML protocol binding when
returning the SAML response from the identity provider.
- Enter the "Identity provider Entity ID," identifier of the provider entity.
The entered value must be an URL.
- Enter the "Single sign-on service URL," an
URL of the identity provider's single sign-on service end-point, where the service provider will
send the authentication request.
- Choose the "Single sign-on service binding,"
a SAML protocol binding when the service provider sends
the authentication request to the identity provider.
- Input the "Certificate," the public x509
certificate of the identity provider. The certificate must be in a
string format without headers. Use the tool on the following link
to convert the certificate to a string format without headers.
- Enter the "Username attribute," the name of
the assertion in the SAML response whose value will be used as the
GetCertified user's username.
- Enter the "Email attribute," the name of the
assertion in the SAML response whose value will be used as
the GetCertified user's email.
- Optionally enter the "First name attribute,"
the name of the assertion in the SAML response whose value will be
used as the GetCertified user's first name.
- Optionally enter the "Last name attribute,"
the name of the assertion in the SAML response whose value will be
used as the GetCertified user's last name.
LRS settings
The LRS settings assure the manager of a test to send each candidate's test results into the LRS
system and track each candidate's success.
The given explanation is just an example of the Yet Analytics Learning Record Store
integration with GetCertified. You can use any other Learning Record Store
that supports Tin Can API (xAPI).
Before you start configuring LRS parameters in the system settings, you need to log in to the LRS
system. To set up your LRS parameters :
- Visit the Yet
Analytics link.
- Sign up to receive the verification email.
After the successful signing up into the LRS system, you can log in to the LRS.
To do so :
- Enter your email.
- Enter password.
- Click the "Sign in" button.
If you forgot the password:
- Click on the "Reset password" link.
Note: After you log in with your LRS user credentials, you will
receive your API endpoint, API key, and API secret key to make the LRS integration with GetCertified
possible.
When you log in to the LRS, you can see the LRS parameters you will insert to finish the configuration
process.
To preview your LRS parameters:
- Click "LRS SETTINGS."
- Click "Info."
The pop-up window will open, and there you can see all the needed parameters you will insert in the
GetCertified.
To configure learning record store parameters, go to the "System settings" page, find
the "LRS settings" tab, and fill the following fields:
- API endpoint - insert the endpoint URL LRS has provided you.
- API key - insert the key, which provides you authentification.
- API secret key - insert the secret key used for the authentication process as well.
- Click the "Confirm" button to save the configuration.
- Click the "Cancel" button to revert the changes.