把黑板上学习
部署Blackboard Learn集成,以学生身份注册新课程并查看课程及其相关细节,以教师身份创建课程公告并查看课程成员和成绩。
注意:
有关黑板学习的盒外显微照片的综合细节,请参阅使用Blackboard Learn微应用程序.
检查先决条件
你需要这些工件在Citrix Workspace Microapps中添加集成:
- 基URL:
https:// {host_name} . com
- 授权网址:
https:// {host_name} .com/learn/api/public/v1/oauth2/authorizationcode
- 标记的URL:
https:// {host_name} .com/learn/api/public/v1/oauth2/token
- 客户机ID:客户端ID是表示授权服务器唯一的客户端注册信息的字符串。你收集这个作为应用程序的关键配置OAuth服务器时。
- 秘密:客户端秘密是在设置目标应用程序集成时发出的唯一字符串。你收集这个作为秘密配置OAuth客户端。
注意:
我们建议您始终使用OAuth 2.0作为您的服务身份验证方法。OAuth 2.0确保您的集成符合配置microapp的最大安全遵从性。
配置Citrix网关支持单点登录,这样一旦用户登录,他们就会自动再次登录,而无需再次输入他们的凭证。有关配置单点登录的更多信息,请参见Citrix网关服务https://docs.citrix.com/en-us/citrix-gateway-service/.
创建用户帐户
集成需要定期访问Blackboard实例。我们建议创建一个专用用户帐户:黑板上合作伙伴账户https://docs.blackboard.com/partners/become-a-partner.
需要以下权限:完全管理员权限。
API访问
黑板api是默认启用的,我们需要黑板开发人员AMI或黑板合作伙伴帐户来访问这些api。可以对特定资源发出的API请求的数量是有限的。我们建议检讨以下资料:https://docs.blackboard.com/learn/rest/admin/groups-quotas-rates
重要的
分页限制被设置为100。管理员可以基于api将这个限制扩展到200个。
Blackboard Learn开发服务器支持多达10000个API调用/站点/24小时。
Blackboard Learn生产服务器支持多达75000个API调用/Site/24小时。
由于API调用的限制,增量同步设置为仅保留课程的会员和课程公告.其余的端点将作为全同步的一部分被触发。
OAuth服务器配置
配置OAuth Server以通过黑板学习集成读取数据。
- 登录到https://developer.blackboard.com/.
- 选择我的应用程序并选择+图标创建新应用。或者,导航到:
https://developer.blackboard.com/portal/applications/create
. - 完成必需的字段并选择注册应用程序并生成API密钥.
- 复制并保存应用程序ID,应用程序的关键和秘密显示在屏幕上。使用这些细节服务认证在配置集成时。
- 以管理员身份登录“黑板学习”应用。
- 导航到系统管理员.
- 选择REST API的集成下集成表格
- 选择创建集成.
填写必需的字段:
- 粘贴应用程序ID你在上面的步骤4中选择的。
- 在。中输入管理员用户名学习用户字段。
- 选择是的为终端用户访问和授权作为用户.
配置OAuth客户端
配置OAuth客户端通过Blackboard Learn集成回写数据。
- 登录到https://developer.blackboard.com/.
- 选择我的应用程序并选择+图标创建新应用。或者,导航到:
https://developer.blackboard.com/portal/applications/create
. - 完成必需的字段并选择注册应用程序并生成API密钥.
- 复制并保存应用程序ID,应用程序的关键和秘密显示在屏幕上。使用这些细节服务操作验证在配置集成时。
- 以管理员身份登录“黑板学习”应用。
- 导航到系统管理员.
- 选择REST API的集成下集成表格
- 选择创建集成.
填写必需的字段:
- 粘贴应用程序ID你在上面的步骤4中选择的。
- 在。中输入管理员用户名学习用户字段。
- 选择是的为终端用户访问和授权作为用户.
将集成添加到Citrix Workspace Microapps中
将Blackboard Learn集成到Citrix Workspace Microapps中,以连接到您的应用程序。已预先选择身份验证选项。确保在完成流程时选择了这些选项。这提供了具有预先配置的通知和动作的开箱即用的微应用程序,可以在您的工作区中使用。
遵循以下步骤:
- 从Microapp集成页面,选择添加新的集成和从Citrix提供的模板添加新集成.
- 选择“黑板学习”瓷砖。
- 输入一个集成的名字的集成。
- 输入连接器参数.
- 输入实例基URL:
- 选择一个图标,或者将其保留为默认图标。
下服务认证中,选择OAuth 2.0从身份验证方法菜单并完成身份验证细节。已预先选择身份验证选项。确保在完成流程时选择了这些选项。使用OAuth 2.0安全协议为委派访问生成请求/授权令牌。建议您始终使用OAuth 2.0作为您的服务认证方法可用。OAuth 2.0可确保您的集成符合您配置的MicroApp的最大安全性符合性。
- 选择客户端凭证从格兰特类型菜单。
- 选择授权头从令牌授权菜单。
- 的标记的URL肾上腺素:
https:// {host_name} .com/learn/api/public/v1/oauth2/token
- 确保在范围内输入以下内容:读
- 输入您的客户机ID.客户端ID是表示授权服务器唯一的客户端注册信息的字符串。你收集这个作为应用程序的关键配置OAuth服务器时。
- 输入您的客户的秘密.客户端秘密是在设置目标应用程序集成时发出的唯一字符串。你收集这个作为秘密配置OAuth服务器时。
下服务操作验证,使使用独立用户认证在操作切换。服务操作身份验证在服务操作级别进行身份验证。已预先选择身份验证选项。确保在完成流程时选择了这些选项。
- 选择OAuth 2.0从身份验证方法菜单并完成身份验证细节。
- 选择授权头从令牌授权菜单。
- 的授权网址肾上腺素:
https:// {host_name} .com/learn/api/public/v1/oauth2/authorizationcode
- 的标记的URL肾上腺素:
https:// {host_name} .com/learn/api/public/v1/oauth2/token
- 确保在范围内输入以下内容:写
- 输入您的客户机ID.客户端ID是表示授权服务器唯一的客户端注册信息的字符串。你收集这个作为应用程序的关键配置OAuth客户端。
- 输入您的客户的秘密.客户端秘密是在设置目标应用程序集成时发出的唯一字符串。你收集这个作为秘密配置OAuth客户端。
- 的启用请求速率限制启用切换。离开60为的请求数量和1分钟为时间间隔.
- 请求超时被设定为120默认情况下。
- (可选)使日志记录为了支持目的,切换到保持24小时的日志记录。
- 选择保存继续。
配置服务操作参数
在配置了上面的模板之后,您需要正确地配置服务动作。为我的成绩microapp,更新他们的主机名
在里面视图在黑板上按钮的我的成绩页面.
遵循以下步骤:
- 从Microapp集成页面,导航到黑板学习集成并选择我的成绩microapp。
- 选择页面,然后是我的成绩页面。
- 在页面构建器中,选择视图在黑板上元素,然后是行动标签在右窗格中。
- 下行动中,选择去URL.
在URL模板领域,取代
主机名
使用实例主机名。此表格用于:https:// {host_name} / webapps / bb-social-learning-bblearn / execute / mybb?cmd = display&toolid = mygradesonmybb _____ mygradestool
完成后,离开屏幕。更改将自动为构建器保存。
编辑表属性
要完成集成的配置,您需要更改下面列出的端点的数据类型。
遵循以下步骤:
- 从Microapp集成页面,选择Blackboard旁边的菜单学习集成,然后编辑.的数据加载屏幕上打开。如果不是,选择数据加载从左侧导航栏。
为每一个端点在下表中列出的,您需要更改数据类型在给定的菜单中属性.
端点 属性 数据类型的变化 课程公告 身体 二进制 用户成绩 显示得分 双 年级的得分 分数可能 双 - 对于每个端点,选择端点和旁边的菜单编辑.
- 在编辑数据端点屏幕,滚动到页面的底部。在桌子下数据结构,选择铅笔图标来编辑表格。
- 在编辑表属性屏幕上,改变数据类型通过从菜单中选择新值。对于每个端点所做的每个更改,请选择保存然后应用.
- 对其他数据端点重复上述操作。
现在可以设置和运行第一次数据同步了。有关同步规则、不满足其调度和否决规则的同步的完整信息,请参见同步数据.
有关API端点和表实体的更多细节,请参见学习连接器规格.
笔记
分页限制被设置为100。管理员可以基于api将这个限制扩展到200个。
由于API调用的限制,增量同步设置为仅保留课程的会员和课程公告.其余的端点将作为全同步的一部分被触发。
使用Blackboard Learn微应用程序
现有的应用集成与开箱即用的微应用一起出现。从这些微应用开始,并根据您的需要定制它们。
请注意
为我的成绩microapp,则管理员需要更新文件中的“host_name”视图在黑板上按钮的我的成绩页面.有关完整的步骤,请参见配置服务操作参数.
课程注册:注册一门课程。
通知或页面 | 用例的工作流 |
---|---|
新课程报名通知书 | 当一个学生注册一门课程时,注册的学生会收到一个通知。 |
课程注册详细信息页面 | 提供已注册课程的只读视图,包括课程和教师详细信息。 |
课程列表页面 | 提供可用课程列表。 |
课程详细信息页面 | 查看课程详细信息,讲师详细信息,与快速注册选项。 |
创建课程公告:允许教师为课程发布创建公告。
通知或页面 | 用例的工作流 |
---|---|
创建课程公告页面 | 提供一个表单,用于为具有以下详细信息的课程创建公告:课程(课程下拉菜单)、标题、消息和发布日期。 |
教练观点:允许教师查看课程成员和成绩。
通知或页面 | 用例的工作流 |
---|---|
课程详细信息页面 | 允许教师查看可用课程的列表。 |
会员详细信息页面 | 允许教师查看在课程中注册的成员列表。 |
级详细信息页面 | 允许讲师查看特定课程成员的成绩。 |
我的课程:查看课程公告和课程附件
通知或页面 | 用例的工作流 |
---|---|
新课程通知通知书 | 当有新的通知时,注册这门课的学生会收到一个通知。 |
课程公告详情页 | 为课程提供了一个只读的新公告,详细信息。 |
我的课程页面 | 提供用户注册的课程列表。 |
课程详细信息页面 | 提供课程的公告和附件列表。 |
公告详细信息页面 | 查看课程公告及其详细信息。 |
附件详细信息页面 | 查看和下载附件。 |
我的成绩:允许学生查看课程成绩。
通知或页面 | 用例的工作流 |
---|---|
新等级通知 | 当新成绩公布时,注册这门课程的学生会收到通知。 |
我的成绩页面 | 允许学生通过选择课程来查看成绩。 |