README

用于查看已通过测试的扩展，显示实际和正确答案，以及每个答案的得分。

使用方法

运行composer require "oat-sa/extension-lti-test-review"将代码包含到项目中。使用扩展管理器或CLI安装扩展：php tao/scripts/installExtension.php ltiTestReview。

LTI调用

要启动特定交付执行的审查，使用以下端点

https://YOUR_DOMAIN/ltiTestReview/ReviewTool/launch?execution=YOUR_DELIVERY_EXECUTION_URI

上述端点没有execution参数（https://YOUR_DOMAIN/ltiTestReview/ReviewTool/launch）将使用启动数据中的lis_result_sourcedid字段来确定交付执行。

要启动用户最新交付执行的审查，使用以下端点

https://YOUR_DOMAIN/ltiTestReview/ReviewTool/launch1p3?delivery=YOUR_DELIVERY_URI

用户ID应提供在for_user声明中

{
  "https://purl.imsglobal.org/spec/lti/claim/message_type": "LtiSubmissionReviewRequest",
  "https://purl.imsglobal.org/spec/lti/claim/for_user": {
    "user_id": "<string>"
  }
}

请求审查的交付执行可以通过resource_link_id声明（将启动由user_id、delivery_id和resource_link_id指定的最新交付执行）

{
  "https://purl.imsglobal.org/spec/lti/claim/resource_link": {
    "id": "unique_Id"
  }
}

为了向后兼容，以下端点允许选择确切的交付执行，其ID必须提供在自定义声明中

https://YOUR_DOMAIN/ltiTestReview/ReviewTool/launch1p3

{
  "https://purl.imsglobal.org/spec/lti/claim/custom": {
    "execution": "<delivery_execution_id>"
  }
}

LTI选项

有各种模式可用于审查测试。默认情况下，最简单的模式被应用，只显示测试通过的情况，学生的答案和没有得分。

以下自定义参数控制模式

当您使用IMS仿真器时，您必须删除前缀custom_。

默认值

默认情况下，选项show_score和show_correct是关闭的。要默认开启它们，您可以更改平台配置，在文件config/ltiTestReview/DeliveryExecutionFinderService.conf.php中。

return new oat\ltiTestReview\models\DeliveryExecutionFinderService([
    'show_score' => false,
    'show_correct' => false
]);

注意：这将为整个平台设置这些选项的默认值。如果您默认开启它们，您仍然可以使用LTI自定义参数禁用它们。

custom_review_layout、custom_section_titles和custom_item_tooltip的默认值从config/ltiTestReview/ReviewPanel.conf.php读取。

return new oat\oatbox\config\ConfigurationService(array(
    'config' => array(
        'reviewLayout' => 'default',
        'displaySectionTitles' => true,
        'displayItemTooltip' => false
    )
));

注意：这将为整个平台设置这些选项的默认值。如果您默认开启它们，您仍然可以使用LTI自定义参数禁用它们。