.. include:: /shortcuts.rstext .. index:: single: SmartEvidence .. _smartevidence: SmartEvidence ------------------------------------------- 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. 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. Set up a SmartEvidence framework ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Refer to the :ref:`SmartEvidence administration ` for more details on how to set up SmartEvidence frameworks. .. index:: single: SmartEvidence; Select a framework .. _smartevidence_select: Select a framework ~~~~~~~~~~~~~~~~~~~~~~ When an institution allows SmartEvidence, any member in that institution can work with the frameworks that are available. The framework is selected on the collection's *Edit* screen for institution or personal collections. .. note:: Your institution administrator needs to allow SmartEvidence in the :ref:`institution settings ` before you can use this feature. .. figure:: /images/collection_create.* :alt: Create a collection #. On the *Portfolios* page, click the *Add* button. In the modal that comes up, click the *Collection* button. On the next screen... #. **Collection name**: Provide a title for your collection. #. **Collection description**: Optionally, you can write a short description about your collection. You do not have a visual editor, but just a plain text box. #. **Tags**: :index:`Enter tags ` to find your collection more easily at a later stage. You can choose from your existing tags by starting to type a letter and then selecting the tag you want to use. You can also type a new tag, and it is added to your list of tags. .. seealso:: You can find more information on how to use the tag selector in the :ref:`'Tags' section `. #. **Page navigation bar**: Choose whether you wish to display a tabbed navigation or not. If you choose not to, you will have to include the :ref:`navigation ` block for you to go from one page to the next on the individual pages that belong to this collection. #. **SmartEvidence framework**: Select the framework that you want to associate with your collection. You can change the collection as long as you have not put an annotation onto a page within the collection. #. Click the *Next: Edit collection pages* button or click *Cancel* if you want to abort adding your collection. Add an annotation ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Refer to the section :ref:`'Write an annotation' ` for more information on how to add an annotation and associate it with a standard. You can add as many annotations to a page for different standards as you wish. When you place an annotation onto the SmartEvidence map, it is automatically added to your page. Give feedback on an annotation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ There are two ways of giving feedback on an annotation. #. Anyone who can comment on the collection can **provide feedback** to the portfolio author on an annotation. #. Staff members or institution administrators can **assess** the evidence linked to the annotation unless the SmartEvidence framework is a self-assessment one when only the portfolio authors can assess themselves. .. note:: The staff or institution administrators need to be in the same institution as the portfolio author in order to assess the portfolio. Refer to the section :ref:`'Respond to an annotation' ` for more details. .. _smartevidence_map: SmartEvidence map ~~~~~~~~~~~~~~~~~~~~~~~~~~~ The SmartEvidence map, which is displayed as the first page in a collection that is associated with a framework, is modelled after an evidence map. It visualizes which areas of the framework have already been completed and where there is still more work to be done. .. figure:: /images/smartevidence_map.* :alt: SmartEvidence map with competencies in different states of completion #. Click the *Prev* (Previous) button to go to a page in the collection that comes before the first one shown if there are many pages in the collection. #. Click the *Next* button to go to a page in the collection that comes after the last one shown if there are many pages in the collection. #. The titles of the pages are displayed. #. The assessment statuses that the site administrator decided to display for a summary view. This can be changed in the :ref:`settings for each framework `. .. note:: The 'Meets the standard' option cannot be removed. It is always displayed. However, the other statuses don't have to be displayed. The numbers in the columns indicate how many times a particular status has been used for a particular standard. #. |new in Mahara 22.10| **Sum of statuses**: :index:`A ` summary of all the statuses across all pages that are in the collection. The count is only updated when the page is reloaded. .. seealso:: Site administrators can view and download that data in the :ref:`SmartEvidence report `. #. Heading for the standard group. #. Click the *Collapse* icon |retractable| to only show the heading of the standard group. Click the *Uncollapse* icon |retracted| to show all items in the group. #. The shortname of a standard or sub-standard is displayed. Click it an a full description is shown. #. A grey dot |smartevidence_nothing| means that the page has not been associated with the selected standard. .. note:: Everybody but the portfolio author sees a grey line. #. The blue circle |smartevidence_begun| indicates that this page is ready for assessment for the selected standard. #. The white cross on red background |smartevidence_no| means that the evidence displayed on the page is not sufficient to demonstrate this particular standard. #. The yellow half moon |smartevidence_partial| shows that this page still needs some work before it can be marked as fulfilling the standard. #. The white checkmark on green background |smartevidence_completed| is displayed when the assessor agreed that the page fulfills the criteria for this particular standard. .. index:: single: SmartEvidence; Copy SmartEvidence collection .. _smartevidence_copy: Copy a SmartEvidence collection ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can copy a SmartEvidence collection. When doing so, the annotations are retained, but the feedback on the annotations is not. You can then make changes to the collection and update the annotations before submitting the new collection for assessment.