# 10.9. SmartEvidence¶

Note

The implementation of SmartEvidence is experimental. While the majority of the functionality works as intended there are a few areas that still need to be sorted out, .e.g. the export of the SmartEvidence map in both HTML and Leap2A.

SmartEvidence allows you to work with competency frameworks in Mahara and associate them automatically with an evidence map for a visualisation of the competencies already gained, in progress, and not yet started.

“Competencies” is used in a wide sense here. SmartEvidence can be used for multiple purposes including competency-based assessment, graduate attributes, skills accomplishment and many more. It can also be used for self-assessment purposes.

Note

The Annotations blocktype must be enabled on the site in order to use SmartEvidence.

## 10.9.1. Overview¶

1. Click the Add framework button to upload a new SmartEvidence framework.

2. Name: Displays the name of the framework.

3. Used in collections: Shows how many times the framework has been used.

4. Self-assess: Indicates whether the framework allows self-assessment or not.

5. Active A green checkmark indicates when a framework can be used by people on the site.

6. Click the Delete button if you want to remove a framework. You can only remove frameworks that are not in use.

Note

Mahara comes with three competency frameworks pre-installed to make testing easier. You can delete them if you do not want your users to work with them.

7. Click the Manage button to change settings for a framework.

## 10.9.2. SmartEvidence framework settings¶

In the SmartEvidence framework settings you can decide whether a framework is active and which assessment statuses you want to display.

1. Click the Manage button to change settings for a framework.

2. Active framework: Switch to “Yes” if you want to allow people to use the framework. If a framework is inactive, but people had already started on it, they can continue and finish it. People who had not yet selected the framework are not able to see it though.

Note

Switching a framework to be inactive is useful if a new version of the framework is issued and those who haven’t already started under the old framework should use the new one.

3. Ready for assessment: Decide whether you want to display a number in the Smartevidence matrix of how many pages have been added to the “Ready for assessment” status.

4. Doesn’t meet the standard: Switch to “Yes” if you want to see a summary of all “Doesn’t meet the standard” assessments in an overview.

5. Partially meets the standard: Switch to “Yes” if you want to see a summary of all “Partcially meets the standard” assessments in an overview.

6. Meets the standard: You cannot change this switch. A summary of all achieved standards is always displayed.

7. Click the Save button to save your changes or click Cancel to revert them.

Note

If your assessment statuses use different language, then that is reflected in the choices.

The easiest to get started with a SmartEvidence framework is to download an existing one. You can then make any number of changes.

Note

If you created your own SmartEvidence framework files that you want to share with the community, please send them to us for review and inclusion in the downloadable ones.

## 10.9.4. Create a framework file¶

You can use any text editor to create and edit your SmartEvidence framework files. If you have an edit that supports syntaxhighlighting for JSON files, you have an advantage as you can differentiate text that you can change from prompts that Mahara needs to interpret the file more easily.

You can also use a JSON editor, e.g. JSON Editor Online or JSONedit. These make it easy for you to edit the file because you can view it without much of the JSON syntax that is required.

Note

It is best to start your framework file with the help of one of the samples as you then know the structure and have all relevant elements in the file.

### 10.9.4.1. Start of the file¶

A framework file contains a number of parameters at the beginning that allow you to customise the framework to your needs.

1. institution: The shortname of the institution in which the framework should be used is entered here. If the framework is for all institutions, all is placed here.

Note

The institution shortname can be seen by hovering over the institution name on the Institution overview page and looking at the end of the URL. The last parameter is the institution shortname.

2. name: The title of the framework as it should be shown to the users.

3. description: The description of the framework is displayed on the SmartEvidence page in a collection. It can contain basic HTML code.

4. If the HTML code in the description field requires the use of quotation marks, these need to be escaped. Otherwise, they would be interpreted as commands. The escaping is done easily by placing a backslash right in front of the quotation mark: \".

5. selfassess: Determine whether users can self-assess their competencies or whether the competencies can only be assessed by somebody else. The following two values are allowed:

• true: Users can self-assess.
• false: Users cannot perform self-assessment.
6. evidencestatuses: Currently, there are four evidence statuses that can be used in an evidence map: begun, incomplete, partialcomplete, and completed. You can decide what words are used for these statuses in the framework that you set up. This allows you to easily set up frameworks in different languages for example.

7. standards: The rest of the document holds the standards and sub-standards.

Note

Be careful when changing a matrix file and make sure not to remove any commas, quotation marks, brackets, curly braces or any other marks in sections that you use. They are required for the correct interpretation of the file.

You can check if your file contains all necessary syntax by pasting it into the JSON Formatter and Validator for example. If there are any issues and JSON cannot interpret your file, the validator specifies the places where the errors occur so you can track them down more easily and fix.

### 10.9.4.2. Standards section¶

You can define the standards after the initial information. They provide the heading level on the SmartEvidence overview page.

1. standards: Introduction of this section. You can define as many standards as you want. There is no limit.
2. shortname: Each standard needs a shortname, e.g. a number or a summary of the full title. The shortname is mandatory and a maximum of 100 characters long.
3. name: Title of the standard. It is mandatory and a maximum of 255 characters long.
4. description: The description is optional and is displayed when you hover over the name of the standard (touch-click on mobile).
5. standardid: Give each standard a natural number so they can be placed in the correct order and referred back to from the standard elements.
6. Do not place a comma after the closing curly brace of the last standard.

### 10.9.4.3. Standard elements section¶

Define all the standard elements, i.e. the individual sub-standards after the standards. They are the ones to which you can add evidence.

Note

Place all sub levels immediately after the higher level standard element so that the mapping is happening correctly.

1. standardelements: Introduction of this section. There is no limit on how many standard elements you can define.

2. shortname: The shortname is displayed on the SmartEvidence overview page. It is mandatory and a maximum of 100 characters long.

3. name: Title of the standard element. It is mandatory and a maximum of 255 characters long.

4. description: The description is optional and is displayed when you hover over the name of the standard (touch-click on mobile).

5. standardid: Provide the ID of the standard to which you want to associate a particular standard element.

6. elementid: Give your standard element an ID so you can refer to it when you have another sub level. The ID needs to be placed between quotation marks.

7. parentelementid: Provide the elementid of the parent standard element if the standard element that you set up is on a level lower. The ID needs to be placed between quotation marks.

Note

When a standard element has a lower level, it cannot be associated with evidence itself, but only the standard elements on the lower level.

### 10.9.4.4. The end of the file¶

When you defined all your standards and standard elements, you can end the file.

1. Do not put a comma after the last curly brace of the last standard element.
2. Make sure to close all angular brackets and curly braces.

### 10.9.4.5. The result¶

Once you finished the file, you can upload it into Mahara and start using it.

1. Title of the framework

2. Description of the framework

3. A standard. It cannot have evidence associated, only its lower levels.

4. A standard element.

5. A standard element with further lower level elements. It cannot have evidence associated, only its lower level.

6. A third level of elements.

Note

You can have more than 3 levels in your competency framework. The readability decreases though with many levels.