把黑板上学习

部署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以通过黑板学习集成读取数据。

1. 登录到https://developer.blackboard.com/．
2. 选择我的应用程序并选择+图标创建新应用。或者，导航到:https://developer.blackboard.com/portal/applications/create．
3. 完成必需的字段并选择注册应用程序并生成API密钥．
4. 复制并保存应用程序ID，应用程序的关键和秘密显示在屏幕上。使用这些细节服务认证在配置集成时。
5. 以管理员身份登录“黑板学习”应用。
6. 导航到系统管理员．
7. 选择REST API的集成下集成表格
8. 选择创建集成．

9. 填写必需的字段:

   1. 粘贴应用程序ID你在上面的步骤4中选择的。
   2. 在。中输入管理员用户名学习用户字段。
   3. 选择是的为终端用户访问和授权作为用户．

配置OAuth客户端

配置OAuth客户端通过Blackboard Learn集成回写数据。

1. 登录到https://developer.blackboard.com/．
2. 选择我的应用程序并选择+图标创建新应用。或者，导航到:https://developer.blackboard.com/portal/applications/create．
3. 完成必需的字段并选择注册应用程序并生成API密钥．
4. 复制并保存应用程序ID，应用程序的关键和秘密显示在屏幕上。使用这些细节服务操作验证在配置集成时。
5. 以管理员身份登录“黑板学习”应用。
6. 导航到系统管理员．
7. 选择REST API的集成下集成表格
8. 选择创建集成．

9. 填写必需的字段:

   1. 粘贴应用程序ID你在上面的步骤4中选择的。
   2. 在。中输入管理员用户名学习用户字段。
   3. 选择是的为终端用户访问和授权作为用户．

将集成添加到Citrix Workspace Microapps中

将Blackboard Learn集成到Citrix Workspace Microapps中，以连接到您的应用程序。已预先选择身份验证选项。确保在完成流程时选择了这些选项。这提供了具有预先配置的通知和动作的开箱即用的微应用程序，可以在您的工作区中使用。

遵循以下步骤:

1. 从Microapp集成页面,选择添加新的集成和从Citrix提供的模板添加新集成．
2. 选择“黑板学习”瓷砖。
3. 输入一个集成的名字的集成。
4. 输入连接器参数．
   • 输入实例基URL：
   • 选择一个图标，或者将其保留为默认图标。

5. 下服务认证中,选择OAuth 2.0从身份验证方法菜单并完成身份验证细节。已预先选择身份验证选项。确保在完成流程时选择了这些选项。使用OAuth 2.0安全协议为委派访问生成请求/授权令牌。建议您始终使用OAuth 2.0作为您的服务认证方法可用。OAuth 2.0可确保您的集成符合您配置的MicroApp的最大安全性符合性。

   1. 选择客户端凭证从格兰特类型菜单。
   2. 选择授权头从令牌授权菜单。
   3. 的标记的URL肾上腺素:https:// {host_name} .com/learn/api/public/v1/oauth2/token
   4. 确保在范围内输入以下内容:读
   5. 输入您的客户机ID．客户端ID是表示授权服务器唯一的客户端注册信息的字符串。你收集这个作为应用程序的关键配置OAuth服务器时。
   6. 输入您的客户的秘密．客户端秘密是在设置目标应用程序集成时发出的唯一字符串。你收集这个作为秘密配置OAuth服务器时。

6. 下服务操作验证,使使用独立用户认证在操作切换。服务操作身份验证在服务操作级别进行身份验证。已预先选择身份验证选项。确保在完成流程时选择了这些选项。

   1. 选择OAuth 2.0从身份验证方法菜单并完成身份验证细节。
   2. 选择授权头从令牌授权菜单。
   3. 的授权网址肾上腺素:https:// {host_name} .com/learn/api/public/v1/oauth2/authorizationcode
   4. 的标记的URL肾上腺素:https:// {host_name} .com/learn/api/public/v1/oauth2/token
   5. 确保在范围内输入以下内容:写
   6. 输入您的客户机ID．客户端ID是表示授权服务器唯一的客户端注册信息的字符串。你收集这个作为应用程序的关键配置OAuth客户端。
   7. 输入您的客户的秘密．客户端秘密是在设置目标应用程序集成时发出的唯一字符串。你收集这个作为秘密配置OAuth客户端。
7. 的启用请求速率限制启用切换。离开60为的请求数量和1分钟为时间间隔．
8. 请求超时被设定为120默认情况下。
9. (可选)使日志记录为了支持目的，切换到保持24小时的日志记录。
10. 选择保存继续。

配置服务操作参数

在配置了上面的模板之后，您需要正确地配置服务动作。为我的成绩microapp,更新他们的主机名在里面视图在黑板上按钮的我的成绩页面．

遵循以下步骤:

1. 从Microapp集成页面，导航到黑板学习集成并选择我的成绩microapp。
2. 选择页面，然后是我的成绩页面。
3. 在页面构建器中，选择视图在黑板上元素，然后是行动标签在右窗格中。
4. 下行动中,选择去URL．

5. 在URL模板领域,取代主机名使用实例主机名。此表格用于:https：// {host_name} / webapps / bb-social-learning-bblearn / execute / mybb？cmd = display＆toolid = mygradesonmybb _____ mygradestool

   完成后，离开屏幕。更改将自动为构建器保存。

编辑表属性

要完成集成的配置，您需要更改下面列出的端点的数据类型。

遵循以下步骤:

1. 从Microapp集成页面，选择Blackboard旁边的菜单学习集成，然后编辑．的数据加载屏幕上打开。如果不是,选择数据加载从左侧导航栏。

2. 为每一个端点在下表中列出的，您需要更改数据类型在给定的菜单中属性．

   端点	属性	数据类型的变化
   课程公告	身体	二进制
   用户成绩	显示得分	双
   年级的得分	分数可能	双

3. 对于每个端点，选择端点和旁边的菜单编辑．
4. 在编辑数据端点屏幕，滚动到页面的底部。在桌子下数据结构，选择铅笔图标来编辑表格。
5. 在编辑表属性屏幕上,改变数据类型通过从菜单中选择新值。对于每个端点所做的每个更改，请选择保存然后应用．
6. 对其他数据端点重复上述操作。

现在可以设置和运行第一次数据同步了。有关同步规则、不满足其调度和否决规则的同步的完整信息，请参见同步数据．

有关API端点和表实体的更多细节，请参见学习连接器规格．

笔记

分页限制被设置为100。管理员可以基于api将这个限制扩展到200个。

由于API调用的限制，增量同步设置为仅保留课程的会员和课程公告．其余的端点将作为全同步的一部分被触发。

使用Blackboard Learn微应用程序

现有的应用集成与开箱即用的微应用一起出现。从这些微应用开始，并根据您的需要定制它们。

请注意

为我的成绩microapp，则管理员需要更新文件中的“host_name”视图在黑板上按钮的我的成绩页面．有关完整的步骤，请参见配置服务操作参数．

课程注册:注册一门课程。

通知或页面	用例的工作流
新课程报名通知书	当一个学生注册一门课程时，注册的学生会收到一个通知。
课程注册详细信息页面	提供已注册课程的只读视图，包括课程和教师详细信息。
课程列表页面	提供可用课程列表。
课程详细信息页面	查看课程详细信息，讲师详细信息，与快速注册选项。

创建课程公告：允许教师为课程发布创建公告。

通知或页面	用例的工作流
创建课程公告页面	提供一个表单，用于为具有以下详细信息的课程创建公告:课程(课程下拉菜单)、标题、消息和发布日期。

教练观点:允许教师查看课程成员和成绩。

通知或页面	用例的工作流
课程详细信息页面	允许教师查看可用课程的列表。
会员详细信息页面	允许教师查看在课程中注册的成员列表。
级详细信息页面	允许讲师查看特定课程成员的成绩。

我的课程:查看课程公告和课程附件

通知或页面	用例的工作流
新课程通知通知书	当有新的通知时，注册这门课的学生会收到一个通知。
课程公告详情页	为课程提供了一个只读的新公告，详细信息。
我的课程页面	提供用户注册的课程列表。
课程详细信息页面	提供课程的公告和附件列表。
公告详细信息页面	查看课程公告及其详细信息。
附件详细信息页面	查看和下载附件。

我的成绩：允许学生查看课程成绩。

通知或页面	用例的工作流
新等级通知	当新成绩公布时，注册这门课程的学生会收到通知。
我的成绩页面	允许学生通过选择课程来查看成绩。