设立LTI
为新的机构管理设置全局属性
在此,您可以为 LTI 工具配置默认全局设置。如果要自定义各个设置,您可以在添加新的工具提供者时进行自定义。
在管理员面板的集成下,选择 LTI 工具提供者。
选择管理全局属性。
在功能可用性下,选择您的创建工具提供者链接偏好:
利用允许指向未明确排除的任何工具提供者的链接,教师可以将 LTI 链接添加到管理员在管理 LTI 工具提供者时未明确排除的任意机构管理。
利用允许指向任何工具提供者的链接,但每个新提供者均需获得批准,教师可以添加 LTI 链接,但如果这是一个新的机构管理,则需要经过管理员批准。
利用仅允许指向获得批准的工具提供者的链接,教师将不能添加 LTI 链接,除非管理员已批准机构管理。
选择是否允许任何工具提供者在“成绩中心”发布成绩。此全局设置仅适用于 LTI 1.1。对于 LTI 1.3,评分基于每个工具进行。
启用此全局设置后,Blackboard 将会接受 LTI 工具提供者发布的成绩,但仅限于在“成绩中心”列(由课程中的“工具提供者”位置创建)中发布。
对于采用此项设置的工具提供者,必须通过允许评分的位置进行配置。
在默认配置区域,可以设置有关用户数据和用户确认消息的全局选项。
为了安全起见,强烈建议仅通过 SSL 发送用户数据选项。此设置是 1.1 LTI 的专属设置。在 LTI 1.3 中,需要 SSL (TLS 2) 连接。
如果选择从不,则所有要发送的用户字段选项均将取消选中。
如果您选择仅通过 SSL 发送用户数据或通过任何连接发送用户数据,要发送的用户字段将显示三个预选字段,您可以根据机构的隐私政策进行自定义:课程中的角色、姓名和电子邮件地址。
通过在允许成员服务访问部分中选择是,该工具可以请求课程中所有用户或任意子集用户(教师和学生)。如果选择否,则工具将无法访问该信息,且选项显示用户确认消息将变为可用。通过对该选项选择是,您可以向用户显示自定义消息,例如:“您即将启动第三方 LTI 工具。”
选择提交以设置全局属性。
LTI 版本
LTI 有两个版本:v1.1 和 v1.3。每个版本都需要不同的配置步骤。添加工具 LTI 前,请确保您了解该工具所属的版本。
LTI v1.0 与已经弃用的 LTI v1.1 非常相似,但不能传递回成绩信息。如果您要添加一个 LTI v1.0 资源,请将其注册为 LTI v1.1。
当前版本是 LTI v1.3。与以前版本最大的区别在于基于 OAuth2、OpenID Connect 和 JSON Web 令牌的升级安全模型。还有 LTI Advantage,它是在 LTI v1.3 之上构建的新扩展服务包,在 LTI 规范之外演变发展。
添加 LTI 1.1 工具提供者
在管理员面板的集成下,选择 LTI 工具提供者。
选择注册 LTI 1.1 提供者。
键入提供者机构管理,例如 www.example.com。
选择提供者域的状态 - 已批准或已排除。默认设置为已批准。选择已排除可阻止用户从工具提供者添加 LTI 链接。
为提供者提供任意次要主机名(可选)。提供者可以提供此信息。
与提供者确认它们是否允许对整个站点或每个链接进行配置,并相应地选择默认配置。对于全局设置,键入工具提供者密钥和工具提供者密令。如果将默认配置保留为单独设置每个链接,则用户在创建每个链接时均需输入密钥和密令。您为各个提供者所选的任何设置会覆盖全局属性。
在工具提供者自定义参数文本框中添加工具提供者所需的任何自定义参数。
每个参数都必须位于各自所在的行中。
它们的格式必须设置为“name=value”对。
它们可以是替换变量。例如:
userNameLTI=$User.usernameuseridLTI=$User.iduserEmailLTI=$Person.email.primary它们还可以是模板变量。这些变量通过 Blackboard 参数格式中的数据进行解析,格式为
@x@user.full_name@x@。例如:crsRoleLrn=@X@membership.role@X@course_pl=@X@course.pk_string@X@
机构策略区域在全局属性中提取首选项。可以在此处管理各个设置。
为了安全起见,强烈建议仅通过 SSL 发送用户数据选项。
如果选择从不,则所有要发送的用户字段选项均将取消选中。
如果您选择仅通过 SSL 发送用户数据或通过任何连接发送用户数据,要发送的用户字段将显示三个预选字段,您可以根据机构的隐私政策进行自定义:
课程中的角色、姓名和电子邮件地址。
通过在允许成员服务访问部分中选择是,该工具可以请求课程中所有用户或任意子集用户(教师和学生)。如果选择否,则工具将无法访问该信息,且选项显示用户确认消息将变为可用。通过对该选项选择是,您可以向用户显示自定义消息,例如:“您即将启动第三方 LTI 工具。”
选择提交添加 LTI 1.1 工具。
添加 LTI 1.3/Advantage 工具
在管理员面板的集成下,选择 LTI 工具提供者。
选择注册 LTI 1.3/Advantage 工具。
输入工具供应商提供的客户端 ID 或应用程序 ID。如果您要开发自己的应用程序,可以在开发人员门户上注册,并注册应用程序以获取客户端 ID。
某些 LTI 工具支持动态注册服务,以简化注册流程(如果要求管理员自行注册工具)。如果某个工具使用“动态注册”,请在“我的应用程序”页面上选择动态注册。输入工具提供者提供的注册 URL,然后执行工具提供者要求的步骤。
选择提交。开发人员门户中的应用程序配置设置将显示在该页面上。
字段为只读字段,但是您可以将工具状态选择为已批准或已排除。
机构策略区域在全局属性中提取首选项。您可以在此处启用或停用要发送的用户字段复选框,为各个提供者管理设置:课程角色、名称和邮件地址。您也可以对每个工具分别设置允许或禁止成绩服务访问。
通过在允许成员服务访问部分中选择是,该工具可以请求课程中所有用户或任意子集用户(教师和学生)。如果选择否,则工具将无法访问该信息,且选项显示用户确认消息将变为可用。通过对该选项选择是,您可以向用户显示自定义消息,例如:“您即将启动第三方 LTI 工具。”
您为各个提供者所选的任何设置会覆盖“全局属性”。
选择提交添加 LTI 1.3/Advantage 工具。
配置展示位置:LTI 工具的显示位置
添加工具 LTI 工具提供者后,您可以设置位置,以便用户更轻松地在 Blackboard 用户界面中查找和使用该工具。工具供应商可以为 LTI 1.3 工具定义所有位置。
如果未配置位置,则学生和教师必须知道 URL 或密钥才能在课程中使用该工具,如利用 LTI 连接的教学工具中所述。
如何创建位置
在 LTI 工具提供程序的管理员工具下,转到要配置的工具提供程序,然后选择域旁边显示的菜单选项。转至管理位置。
选择创建位置。
键入一个标签。此名称将在课程中显示给用户。
如果工具通过工具菜单显示给学生,请添加描述。描述不会显示给教师。
键入一个别名。必须是唯一的,并且只能包含字母数字、下划线或短划线字符。
要将位置设为可用或不可用,请选择是或否。
选择一个类型:
注意
您不能更改现有位置的位置类型。您必须创建一个新位置来更改类型。
深度链接内容工具:允许教师和课程构建者启动 LTI 工具并从工具提供商添加内容,而不是通过 Blackboard 界面添加内容。如果工具提供者经过配置以便教师在单次导入中选择多项内容,则此工具可以节省时间并简化工作流程。
允许学生访问:授予学生权限,也可以通过工具提供者添加内容。
课程内容工具:允许教师从课程内容页面添加工具。通过 Content Market 区域添加后,该工具将成为课程大纲的一部分。
允许评分:允许教师向工具添加评分功能,例如截止日期和满分。
课程工具:此工具显示在原始课程的“课程管理”区域和 Ultra 课程的“书籍和工具”菜单中,供教师和内容构建者使用。
允许学生访问:当选定的学生可以在学生工具菜单中访问该工具时。添加描述,以帮助学生了解此工具及其用途。
可以在不访问课程的情况下打开系统工具。在原始体验中,该工具显示在我的机构标签的工具菜单中。在 Ultra 体验中,该工具显示在工具基本导航控件区域中。您还可以在“机构页面”模块放置系统工具。
通过管理员工具,管理员可以向“管理员面板”的工具和实用工具菜单中添加工具。
Ultra 扩展位置用于某些集成。仅在您的集成提供者如此告知您时,才可使用此位置。如果您的集成不需要此位置,请勿使用它。
监考工具、基本导航工具和课程导航工具是由工具提供者设置的 LTI 1.3/Advantage 仅限访问型类型,您可以访问但无法修改。
如果您希望此工具在新窗口中而不是 iframe 中启动,请选中该复选框。
通过选择浏览并上传 50 x 50 像素的图像文件,为该工具添加图标。如果此 LTI 位置位于原始课程视图的课程中,则带有链接的图标会显示在工具列表中。在 Ultra 课程视图中,带有链接的图标会显示在 Content Market 中,但不会显示在“课程内容”页面。
键入工具提供者信息。在大多数情况下,此类信息与您在创建工具时添加的信息相同,除非您为同一个注册的提供者创建多个位置。
选择提交。
警告
删除 LTI 域或位置将断开所有现有的 LTI 链接。重新添加 LTI 域或位置不会修复已断开的链接。不要删除 LTI 位置或域名,除非您确信再也不会使用它。
要将 LTI 1.1 工具迁移到 LTI 1.3,使用相同的域创建新的 LTI 工具,并接受迁移到 LTI 1.3 的提示。这将安全地处理现有链接。
管理工具访问权限和可见性
原始课程视图课程继续允许教师覆盖工具的可用性状态(如果允许)。Ultra 课程视图课程中的工具可用性始终由管理员管理。
在管理员面板的工具和实用工具下方,选择工具。
搜索要打开或关闭的工具。您将找到内部工具、构建基块工具和 LTI 工具的列表,您可以按类型进行筛选。
在“可用性”中, 选择开或关 。
您也可以对新的原始课程和所有 Ultra 课程或新的和现有课程应用更改。
选择提交。