13.1. Setup in Mahara

In order to use LTI, you need to complete the setup in Mahara as well as on the LMS.

13.1.1. Activer LTI pour le site

You need to ensure that LTI is enabled for your Mahara site. You do that by activating it in the Plugin administration.

The LTI plugin is enabled

Le plug-in LTI est activé

The LTI plugin is enabled when there are no warning signs on the plugin page and the text at the top reads “The LTI API is enabled”.

Note

It is best to enable LTI using this method rather than enabling individual web services manually to ensure that all dependencies are set up correctly.

13.1.2. Activer LTI pour une institution

Vous pouvez activer le LTI pour une institution en tant qu’administrateur du site. Un administrateur d’institution ne peut pas paramétrer LTI pour sa propre institution.

Enable LTI for an institution

Activer LTI pour une institution

  1. Go to Administration menu → Web services → External apps.

  2. Application : Donnez un nom de l’application que vous désirez connecter. Ce nom n’est pas important au niveau technique, il vous permet juste de vous souvenir du type de connexion que vous êtes en train de créer.

  3. Sélectionnez l’institution pour laquelle vous désirez configurer l’application.

  4. Select “LTI integration” from the drop-down menu.

  5. Cliquez sur le bouton Ajouter pour créer la clé et la phrase secrète.

    Note

    If your institution does not already have the “Web services” authentication method, it will be added automatically.

  6. Cliquez sur le bouton Paramètres si vous désirez accéder à d’autres options supplémentaires à configurer.

13.1.3. Utiliser LTI avec un second système d’authentification

You can allow your account holders to log in via LTI and another authentication method within the same institution. There are two possible ways:

  1. People log in via Mahara first and only then via LTI.

  2. People log in via LTI first and then via Mahara.

The first case, people log in via Mahara initially, is the easier one as you don’t have to adjust their account settings manually. If people log in via LTI first, their authentication method needs to be adjusted so that they don’t end up with two accounts.

Techniquement, vous pouvez utiliser n’importe quelle autre méthode d’authentification que vous avez à disposition sur Mahara comme deuxième méthode, incluant MNet, en plus de LTI. Toutefois, puisque MNet ne permet pas de vous connecter depuis la page d’accueil de Mahara et que LTI est ce qui va remplacer MNet à court terme, cette dernière méthode d’authentification n’est pas mentionnée comme étant une que vous devriez alors utiliser.

Vous pouvez fixer la méthode d’authentification SAML comme parent de la méthode LTI. Ceci permet aux personnes de pouvoirs se connecter à votre serveur sous le même compte avec LTI ou SAML.

Note

Ceci n’est pour l’instant possible que pour SAML et pas pour LDAP / Active Directory, ou une méthode d’authentification tierce.

Set a parent authentication method for LTI

Utiliser une méthode d’authentification parente pour LTI

  1. Click the Manage button next to the LTI app on Administration menu → Web services → External apps.

  2. Institution : L’institution, pour laquelle vous avez créé l’application externe LTI, est affichée

  3. Auto-create accounts: Flip the switch to “Yes” if you want to allow anybody who has access to the LTI link to create an account automatically.

  4. Autorité parente : Sélectionnez la méthode d’authentification parente à la méthode LTI, permettant aux utilisateurs de se connecter sous le même compte avec ces deux méthodes.

    Note

    You can use SAML or LDAP as parent authentication methods for LTI.

13.1.3.1. Connexion par Mahara puis par LTI

Your account holders can log in via Mahara and the LMS.

  1. Ensure that the authentication method that your account holders shall use is set up for your institution.

  2. Assurez-vous aussi que les services web sont activés comme méthode d’authentification et pour votre institution.

  3. Set up the consumer secret and key for the LTI integration as described under “Enable LTI for an institution”

  4. Terminer la configuration de l’ingération avec le LMS de votre choix.

  5. Ask people to log into Mahara first, set up their accounts manually or via a CSV file, synchronize their accounts via LDAP, or have accounts auto-created by SAML on first login.

As a person:

  1. Connectez-vous à la page d’accueil

  2. Votre compte est configuré s’il n’exite pas déjà.

  3. Allez sur votre LMS

  4. Cliquez sur le lien qui vous dirige vers votre portfolio. Vous trouvez souvent ce lien dans le cours qui vous demande d’utiliser un ePortfolio, ou sur la page de votre profil dans votre LMS.

  5. Vous accédez alors au même compte que vous avez déjà créé sur Mahara.

13.1.3.2. Connexion avec LTI puis avec Mahara

If you want People to log in via LTI first and then Mahara, you need to change the authentication method of the accounts to make the second authentication method, i.e. internal, LDAP, SAML or IMAP, the primary one. If you don’t do that, a second account will be created.

The following describes the work flow and includes the steps that you need to take in order to allow a person to log in via both authentication methods if they logged in via LTI first.

  1. Ensure that the authentication method that people shall use is set up for your institution.

  2. Assurez-vous aussi que les services web sont activés comme méthode d’authentification et pour votre institution.

  3. Set up the consumer secret and key for the LTI integration as described under “Enable LTI for an institution”

  4. Terminer la configuration de l’ingération avec le LMS de votre choix.

  5. People go to the LMS and click the link to the portfolio, which creates an account for them.

    Avertissement

    If you leave things here and don’t continue with the next steps, and people log in via the Mahara homepage, they will have a second account created.

  6. Change the authentication method of the account to the non-LTI one. In the case of single sign-on via the SAML plugin, you will also need to provide a remote username.

    Voir aussi

    Consultez les pages sur la modification de la méthode d’authentification pour les comptes internes et LDAP et pour les comptes qui nécessitent un nom d’utilisateur distant.

13.1.4. Confirm LTI assessment settings

Before any learners can use the activity that you set up in the LMS, you need to confirm the activity settings as a teacher.

Set the submission criteria

Set the submission criteria

  1. Email tutors on student submission: Set this to “Yes” if course tutors / teachers / assessors shall be informed when a submission has been made.

  2. Keep portfolio locked after grading: Set this to “Yes” if you don’t want learners to make any changes to their portfolio once grading is done. The default setting is “No”.

    Note

    This option will keep the portfolio locked from editing, and learners can’t delete any of the submitted artefacts or make changes to them or delete the portfolio itself from their account. They can still make a copy or change artefacts that are not affected by the locking.

  3. Archive when graded: If you want or need to keep a copy of the graded portfolio to comply with assessment regulations, you can set this option to “Yes”. An archive is made automatically after you finished grading and placed on the Mahara server. Administrators can view the archives in the “Archived submissions”, and a server administrator can download all archives from a folder within the content file structure of Mahara.

    Avertissement

    SmartEvidence collections cannot yet be archived properly as Leap2A.

  4. Click the Save and allow submissions button to confirm the settings and allow your learners to submit their portfolios.

    Note

    You can change the assignment settings until the first learner submitted their portfolio. After that, they are locked in.

    Currently, learners cannot re-submit portfolios to the same activity once you’ve completed grading. They can also not make any changes to the portfolio while it is being assessed.

13.1.5. Submit a portfolio as learner

As a learner, you can submit any of your portfolios to an assignment in your learning management system (LMS).

Note

Any portfolio you submit is locked. Depending on the assignment settings, you may be able to edit the portfolio again after grading.

Submit a portfolio for assessment via your LMS

Submit a portfolio for assessment via your LMS

  1. Click the link to the assignment in your LMS. Mahara opens either in a new tab or embedded as iframe depending on the assignment settings.

  2. If you don’t already have a portfolio that you can submit for this particular assignment, click the create one link. You are taken to Pages and collections where you can create a new portfolio. Once you are finished, click the assignment link in your LMS again to be taken to the correct submission screen.

  3. If you do have a portfolio to submit, select it from the drop-down menu. You can select an entire collection or a page when it is not part of a collection.

  4. Click the Submit button to confirm your choice.

    Note

    By clicking the Submit button, your portfolio is locked from editing.

  5. You receive a confirmation on screen that lets you know when you submitted the portfolio.

    Note

    If you want to or are asked by your assessor to make changes to your submitted portfolio, you can revoke the submission, make the changes, and then submit it again to the same activity.

    revoke submission

    This is only possible when the assessor has not yet graded your portfolio.

Once your portfolio has been assessed and a grade given, you can see the result in Mahara after having clicked on the assignment link in the LMS.

View grade in Mahara

View grade in Mahara

  1. Review when you submitted your portfolio.

  2. View the number of points you received on your portfolio.

  3. View who assessed your portfolio.

  4. Shows the time when the portfolio was assessed.

13.1.6. Assess a portfolio as teacher

Once learners have submitted portfolios for assessment, as a teacher, you can click the link to the assignment in the LMS and be taken to Mahara, where you see all the submitted portfolios.

View portfolios that require assessment

View portfolios that require assessment

  1. First name: The first name of the portfolio author.

  2. Last name: The last name of the portfolio author.

  3. Portfolio title: Title of the submitted portfolio.

  4. Time submitted: Time when the author submitted their portfolio.

  5. Click the Grade link to be taken to the portfolio itself and give it a grade.

  6. Grade: Grade given for this portfolio out of 100 points.

  7. Time graded: Time when the grade was submitted.

  8. Graded by: Teacher who graded the portfolio.

When you click the Grade link, you are taken to the portfolio and can review it. As usual, you can leave comments on the content where available and on a page itself. Once you are ready to give the grade, you can select it above the comments section.

Grade a portfolio

Grade a portfolio

  1. The name of the assignment is displayed.

  2. The course title from the LMS is listed.

  3. The time when the learner submitted the portfolio is shown.

  4. Grade: Select a grade between 0 and 100 points from the drop-down menu.

    Note

    If the learner should make changes before you can give a final grade, do not enter a grade here but give the learner feedback, e.g. private feedback on a page, and let them know what to change. They can then revoke their submission, make the changes, and resubmit their portfolio to the same assignment.

  5. Click the Submit button to lock the grade in. You cannot revoke your decision.

  6. The grade is also entered into the gradebook in the LMS.