将 MATLAB Grader 与 Moodle 集成 - LTI 1.3

要将 MATLAB® Grader™ 添加到 Moodle™ 外部工具中，请按照本节中的步骤执行操作。

您使用的 Moodle 版本必须与 LTI 1.3 兼容。有关支持 LTI 1.3 集成的 Moodle 版本的信息，请参阅 Moodle LTI 支持。

注意

在此过程的每个步骤中，确保从本页复制并粘贴的文本中没有前导或尾随空格。否则集成可能无法正常工作。

步骤 1：以 LMS 管理员身份登录到 MATLAB Grader

注意

只有许可证管理员才能执行集成。如果您是所在大学的 LMS 管理员，请联系您的许可证管理员，以委托您担任许可证管理员，或代表您进行集成。如果您需要帮助来确定谁是您的许可证管理员，或者如果他们需要帮助来将访问权限委托给您，请联系安装支持。

登录到 MATLAB Grader 后，请使用与 LMS 管理员关联的 MathWorks® 帐户。帐户持有人还必须是管理 MathWorks 许可证的许可证管理员，并且必须已获得 MathWorks 客户支持或您所在大学的其他许可证管理员授予的 MATLAB Grader 访问权限。

登录 URL https://grader.mathworks.com，然后点击 LMS 集成。或者，您可以直接访问该页面，网址为 https://grader.mathworks.com/lti_credentials。

登录后，点击添加部署。在产品下拉列表中选择 MATLAB Grader，并在平台下拉列表中选择 Moodle。

步骤 2：以 LMS 管理员身份登录到 Moodle

以具有管理员权限的用户（特别是能够注册新 LTI 1.3/Advantage 工具的用户）身份登录到您所在大学的 Moodle 实例。

步骤 3：转至管理工具

在 Moodle 中，转至 Site Administration > Plugins > Activity modules > External tool下的 Manage Tools。此页面的 URL 可能类似于以下示例：https://sandbox.moodledemo.net/mod/lti/toolconfigure.php。

步骤 4：注册新的 LTI 1.3/Advantage 工具

  1. 在 Manage Tools 上，点击 configure a tool manually。

  2. 在 External Tool Configuration 上，在出现提示时输入以下值。

    字段名称字段值
    Tool NameMATLAB Grader LTI 1.3
    Tool URL https://learningtool.mathworks.com/v1p3/launch
    Tool DescriptionAutomatically grade MATLAB code

  3. 将 LTI version 更改为 LTI 1.3。下表使用新字段进行了更新。

  4. 在出现提示时输入以下值。

    字段名称字段值
    Public key typeKeyset URL
    Public keysethttps://learningtool.mathworks.com/lti/jwk
    Initiate login URLhttps://learningtool.mathworks.com/lti/oidc
    Redirect URI(s):https://learningtool.mathworks.com/lti/redirect
    Tool configuration usageShow in activity chooser and as a preconfigured tool
    Default launch container

    New Window

    启用此设置以符合安全性和可访问性要求。

  5. 展开 Services 并将选项设置为以下值。

    字段名称字段值
    IMS LTI Assignment and Grade ServicesUse this service for grade sync and column management
    IMS LTI Names and Role Provisioning

    要在教师可访问的报告中包含学生姓名和电子邮件地址，请将此字段设置为 Use this service to retrieve members' information as per privacy settings。

    • 同时，将隐私设置 Share launcher’s name with tool 和 Share launcher’s email with tool 设置为 Always。

    • 要在创建 LTI 1.3/Advantage 工具后启用此设置，请编辑现有的 LTI 1.3 集成，然后选择此选项。保存 LTI 1.3/Advantage 工具。

    否则，可以将此字段设置为 Do not use this service。

    Tool SettingsDo not use this service

  6. 展开 Privacy 并将选项设置为以下值。

    字段名称字段值
    Share launcher’s name with tool

    要在教师报告中显示学生姓名，请从上下文菜单中选择 Always。

    • 同时，将 IMS LTI Names and Role Provisioning 设置为 Use this service to retrieve members' information as per privacy settings。

    • 要在创建 LTI 1.3/Advantage 工具后启用此设置，请编辑现有的 LTI 1.3 集成，然后选择此选项。保存 LTI 1.3/Advantage 工具。

    否则，将此选项设置为 Never。

    Share launcher’s email with tool

    要在教师报告中显示学生电子邮件地址，请从上下文菜单中选择 Always。

    • 同时，将 IMS LTI Names and Role Provisioning 设置为 Use this service to retrieve members' information as per privacy settings。

    • 要在创建 LTI 1.3/Advantage 工具后启用此设置，请编辑现有的 LTI 1.3 集成，然后选择此选项。保存 LTI 1.3/Advantage 工具。

    否则，将此选项设置为 Never。

    Accept grades from the toolAlways
    Force SSLSelected

  7. 点击 Save Changes。

步骤 5：从 Moodle 中获取工具配置详细信息

保存更改后，您将返回到 Manage Tools，您可以在其中看到当前在您的 Moodle 实例中配置的工具列表。查找新创建的 MATLAB Grader LTI 1.3 条目。

  1. 在工具条目上，点击 View configuration details 以查看有关 MATLAB Grader 安装的信息。

  2. 复制列出的字段值，您在下一步中需要此信息。

    以下示例是您可能会看到的信息类型。不要复制这些特定的示例值。

    • Platform ID：https://sandbox.moodledemo.net

    • Client ID： nnzajGSuLlx6LJK

    • Deployment ID：1

    • Public keyset URL： https://sandbox.moodledemo.net/mod/lti/certs.php

    • Access token URL： https://sandbox.moodledemo.net/mod/lti/token.php

    • Authentication request URL： https://sandbox.moodledemo.net/mod/lti/auth.php

  3. 复制此信息后，点击 Cancel。

步骤 6：在 MATLAB Grader 中注册 LMS 信息

在 LMS 集成页面上：

  1. 在步骤 6 下，在出现提示时提供您在步骤 5 中复制的值。

    字段名称字段值
    Client ID使用步骤 5 中的 Client ID 值。
    Deployment ID使用步骤 5 中的 Deployment ID 值。
    Issuer使用步骤 5 中的 Platform ID 值。
    Public keyset URL使用步骤 5 中的 Public keyset URL 值。
    Auth token endpoint: 使用步骤 5 中的 Access token URL 值。
    OIDC auth request endpoint使用步骤 5 中的 Authentication request URL 值。

  2. 点击 Submit。

集成现已完成，教师可以将 MATLAB Grader 中的内容添加到其 LMS 课程中。

对 MATLAB Grader LMS 与 Moodle 的集成进行故障排除

Moodle 集成失败的常见原因如下：

  • URL 在公共互联网上或不受防火墙保护。这些失败包括 SSO 挑战。

  • 未提供 SSL 证书或 SSL 证书是自签名的。

  • Moodle 服务器未发送完整的 SSL 证书链。

  • URL 未使用 HTTPS 协议。

  • Moodle 服务器配置在非标准端口号上。Moodle 服务器可以在防火墙的代理服务或端口映射后进行配置，以确保对服务器的公共访问始终通过端口 443。

  • 您的 Apache® 配置不允许使用所有必需的标头。请参阅文章“'Authorization' header sent with request, but missing from apache_request_headers()”。

  • MATLAB Grader 不支持最新版本的 LTI 1.3 中的提交审查消息（已在 Moodle 中实现）。

    直接从 Moodle 成绩簿点击 MATLAB Grader 作业的链接可能会产生意外结果，或者链接可能不起作用。请始终从 Moodle 教学大纲/活动列表视图中点击作业。

如果您有非标准的 Moodle 安装，可能需要进行一些配置更改，以允许 MATLAB Grader 服务器和您的服务器相互成功通信。

获得帮助

在您使用 LTI 1.3 将 MATLAB Grader 与 LMS 集成过程中的任何阶段，如果需要帮助，都可以联系 MathWorks 技术支持。

另请参阅

主题