The Learner Portal is not available in the downloadable Lite version of Veracity.

​

Agents

Agents And XAPI

An Agent in Veracity Learning LRS is closely related to an xAPI Agent. In xAPI, an Agent is an identifier that is used within a statement to assert the "subject" part of the subject, verb, object structure. In xAPI, an Agent can be an individual or a group. In Veracity Learning LRS, an Agent is linked to a single xAPI Agent (which cannot be a group). This link is used to map xAPI data statements to logins on the Learner Portal. It is vital that these identifiers match correctly. The administrator could expose data for the wrong person by incorrectly entering these values.

The system assigns an xAPI Agent identity to a new Veracity Agent automatically. You can manually override this value to link other xAPI data to the account.

Creating Agents

You create Agents from the "Agents" page under the "Content" menu. On this page, you'll see a listing of all Agents, plus some options to create new ones.

To search for agents, click the expand icon under the title.

This will display a form where you can search Agents by several fields. Click Search to search. To reset and view all Agents, click "Clear".

To create a new Agent, click the large green "Create Agent" button. This will display a form where you can enter details about the Agent.

This form presents a few fields. Fill these out and click "Create New Agent". You'll return to the Agents page, and a new Agent will be present. You can also create multiple agents at once by uploading a spreadsheet. Click the "Upload CSV" tab to place the form in the CSV upload mode. This mode allows you to choose a Comma Separated Value (CSV) file that contains information about multiple Agents. If you need an example CSV file, click "Download a sample CSV file". This fill will show you the proper column names required.

Discovering Agents From XAPI

If you already have a body of xAPI statement, Veracity Learner LRS can scan these statements and discover Agents. Clicking "Discover Agents" will launch a background process that reads over all xAPI statements and builds Agents. The system does its best to discover first and last names, email adresses, and actor values. You'll have to manually fill in additional details.

Linking To An Actor

If you left the "Actor" field in the create Agent form blank, the system will assign one. The actor value will look something like this:

   
      {
      "objectType":"Agent",
      "name":"Rob Chadwick",
      "account":{
      "homePage":"
      
         https://lrs.io/",
      
      "name":"63397bfd-1e0f-419e-a581-286c3919ff15"
      }
      }
   

Managing Agent Passwords

1. Get Password Reset Key  - a unique code is generated. When the Agent logs in with this code, they will be logged in then prompted to reset their password. Because Veracity Learning LRS does not store the plaintext of the password, the administrator is not able to recover it to send the user. This method allows the user to set up a password that the administrator never sees.
   
2. Set Password  - The administrator can also set the password directly to some value. Again, we don't store the plain password, so if you are creating one for a user, be sure to sent it to them before entering it into the system.
   

Activities

An Activity in Veracity Learning LRS is a piece of content that a learner can experience. Activities can be used to both add additional metadata to xAPI Objects, or to list content for the Learner Portal. Like Agents, Veracity Learning LRS Activities are linked to xAPI Activities by an ID. Since the xAPI specifies a single "id" value for xAPI Activities, this link is simpler than for Agents: it's just a single value instead of a JSON object.

Like Agents, you can show a search form by clicking the expand button.

This will display a form where you can search by several different fields. Click "Search" to search, or "clear" to clear the search and return to a list of all Activities.

Creating Activities

You can create new Activities in several ways.

Linking to External Activities

Activities can be remote resources. These resources live on a different server from the LRS, and can be displayed in a popup window, a bit like a traditional LMS. To register an external link as an Activity, click the large green "Register a Link" button. This will show a form like this:

1. ID  - This is the identifier that is used to link up this activity to xAPI statements. When we see an xAPI statement where the  object.id  value is this value, Veracity Learning LRS understands that the statement is about this Activity. If you leave this value blank, we'll assume it is the same as the Launch URL. Due to the xAPI specification, this must by a fully formed URI.
   
2. Launch URL  - This is the web address where the content can be found. We assume that browsing to this location will begin the learning activity.
   
3. Title  - Used only for display purposes.
   
4. Description  - Used only for display purposes.
   
5. Public Key  - If the content supports xAPI Launch in the encrypted mode, place the public key for the content in x.509 format here.
   
6. Max Session Length  - if the content supports xAPI Launch, the session will be closed after this time, even if the content does not explicitly terminate.
   
7. Supports xAPI Launch  - If the content supports xAPI Launch, check this box. xAPI Launch is an ADL specification for an LRS to make a handshake with a Learning Record Provider(LRP) in order to exchange credentials.
   
8. Supports Tincan Launch  - Similar in purpose to xAPI Launch, but somewhat less secure
   
9. * Track xAPI Session  - Even if this content does not support either launch service, record xAPI statements when it begins and ends. The Learner Portal will create xAPI statements when the content is launched and when the content is closed by the learner. Use this only if the content is not xAPI aware.
   
10. Activity Type  - additional metadata about the xAPI Activity. Veracity Learning LRS can use this value to make some display decisions.
    
11. Launch Type  - Open in a popup window by default. We can also redirect the user in a new window. Popup is required in order for the the system to "Track xAPI Session", since we can't monitor the Agent's browser window when they leave our site.
    

Upload a ZIP File

All required configuration values for an Activity are generated automatically when a file is uploaded. The file upload size may be restricted by the webserver.

Discovering Activities from xAPI Statements

If the LRS has xAPI statements, Veracity Learning LRS can scan them to discover Activities. The system will do its best to discover the title, description, ID and activity type. These Activities are treated as external links.

Activity Display

You can even upload a thumbnail image from the upper right menu. This image will be displayed on the Learner Portal.

Classes

Create A Class

To create a new Class, click the green "Create a New Class" button. This will open a simple form in a dialog box. When you accept the title and description, a new panel will appear.

Editing A Class

Agents can be placed into multiple classes, but each Agent can only be in a Class once. To add an Agent to a Class, click the icon next to "Total Agents". This will pop up a search dialog.

You can also assign an instructor for the class. This has no function at present, but in the future will allow that Agent some administrative functions from the Learner Portal. Click the   icon next to "Instructor" and follow the same process as adding an Agent.

Assignments

Classes can be assigned Courses. These Courses will be displayed to the member Agents as assignments on the Learner portal. To add an assignment, click on the   icon next to "Assignments". This will open the Assignment Editor dialog.

You can click on "Find Courses" to find Activities from this LRS. Click on the Course card to add it to the assignment list.

When you select a course, it will appear in the assignments list. You can remove it by clicking the green "x" in the upper right. Once you've assigned or removed Courses, click "Ok" to accept the changes. Like adding Agents, you must save the Class.

Courses

Like Classes, Courses currently only exist to inform the Class/Course dashboard. In the future, Courses will help scope what Activities are presented on the Learner Portal. You can manage Courses from the Courses page under "Content" on the left side menu.

Courses are a sequenced collection of Activities. To create a new Course, choose the green "Create Course" button on the Courses page.

1. ID  - this is the unique ID for the Course. It corresponds to the xAPI  contextActivities.parent.id  value, and therefore must be a full URI.
   
2. Title  - for display purposes only.
   
3. Description  - for display purposes only.
   
4. Activity Type  - Corresponds to the xAPI  contextActivities.parent.definition.type  value, and therefore must be a full URI.
   

The plus icon will change into a choice of ways to add an Activity. This give you the choice of three methods for adding an Activity to the Course.

1. Plus  - Register a new external link.
   
2. Upload  - Upload a new .zip file of content.
   
3. Browse  - Choose an existing Activity.