快照平面文件课程示例

以下这些示例演示了课程数据馈送的构成，可满足多种使用案例所需。以下示例使用了为满足使用案例所需的最简单数据馈送。还有更多课程提要标题可用于创建课程记录 - 分析您机构的信息系统和注册商要求和规划将有助于确定正确填充 Blackboard 满足您的数据和课程生命周期目标所需的数据深度。

注意

这些示例基于集成配置 UI 中可见的默认 Blackboard 设置。更改这些配置元素将导致示例结果发生更改。有关这些设置的说明，请参阅学生信息系统框架概述和快照平面文件集成配置。此外，除非另有说明，否则假定集成已配置为对所有传入数据使用相同的数据源。

课程

课程数据是描述 Blackboard 中课程的主要信息集。在 SIS 数据课程对象的上下文中，通常称为“分区”，这会反映在现有标准中。Blackboard Snapshot Flat File 早于其中许多标准，它使用“COURSE”根据上下文引用与课程相关的记录。

操作

数据可能会提供给 Blackboard，然后进行更新、删除或修改 - 因此，您可以从最简单的数据集开始，并随着机构的数据要求的变化而进行扩充。

注意

一个不可变的 COURSE 字段是 COURSE_ID - 创建记录后，此字段不得更改，如果需要更改COURSE_ID，则必须禁用和删除该记录。这会产生影响活动记录的后果，因此，强烈建议您使用在课程生命周期内不可能发生变化的数据元素。

快照平面文件数据管理

警告

请注意，使用完全刷新或按数据源完全刷新作上传简短的更正文件可能会无意中导致数据被删除或批量禁用。为防止这种情况，我们不鼓励手动使用作类型完全刷新或按数据源完成刷新。默认情况下，这些选项在上传源文件页面上不可用。但是，如果同时启用这两个选项，请选中作类型下的复选框启用高级选项。

SIS 框架支持通过 UI Feed 上传和 Blackboard 系统提供的一组 URL 上传快照平面文件数据源。

通过系统管理员数据集成学生信息系统集成 UI 中的集成菜单，访问 HTTP 信息并上传馈送文件。

在这两种情况下，数据操作的行为是由集成配置和选定操作类型驱动的。选择的数据操作类型将控制如何“解释”馈送中的数据，每个 URL 将提供不同的结果来满足您的集成的预期目标。

操作	描述
存储	使用此操作类型时，馈送文件中包含的数据会在该集成所拥有的所有数据源中存储或更新（按配置设置）。（请参阅 SIS 框架概述，了解数据“所有权”和数据源。）
完全刷新	此操作会存储或更新在数据馈送中包含的数据，同时禁用未包含在数据馈送（与跨所有数据源的集成相关联）中的数据。您必须选择启用高级选项才能在手动上传文件时使用此选项。
删除	此操作将根据每个集成设置禁用包含在数据馈送中的记录，这些数据馈送与跨所有数据源的集成相关联。
按数据源进行完全刷新	此作对仅与集成配置的数据源关联的数据执行完全刷新。此操作会更紧密地模拟命令行快照过程，以进行数据刷新。您必须选择启用高级选项才能在手动上传文件时使用此选项。

与课程操作关联的对象包括：

警告

对象	操作
课程	存储、完全刷新、删除、按数据源进行完全刷新
课程关联	存储、完全刷新、删除、按数据源进行完全刷新
课程标准关联	存储、完全刷新、删除、按数据源进行完全刷新

可在层次结构示例区域中找到课程关联示例。

提供的示例是使用快照框架 UI 上传馈送文件功能进行演示的。要详细了解如何自动化或使用其他命令行/编程操作，请参阅快照平面文件自动化。

关于数据源密钥的提醒

所有数据对象都支持更改该数据集分组的<em>数据源密钥</em>，并可用于更改关联的数据源 - 注意：这不是基于框架的数据馈送中的必填字段，除非另有说明，否则以下示例假定集成配置为使用单个数据源。

请参阅数据源密钥管理以及关于更改课程记录的数据源一节。

关于字段映射的说明

字段映射提供了在将传入数据存储在 Blackboard 中之前更改传入数据的功能。这使您可以完全控制存储的数据，并使您能够在向您提供的学生信息系统数据不足时满足 Blackboard 的特定规则，例如：创建合适的课程名称条目。当应用于 COURSE 对象字段时，将按课程记录运行关联的脚本，在将数据存储在 Blackboard 中之前更改或提供数据。要详细了解字段映射，请参阅快照平面文件自定义字段映射。

课程作示例

在较高层级上，您可以确定三种 SIS 集成数据馈送模式，这些模式可以应用于所有课程数据操作，而选择的模式取决于您可以提供的数据。

使用单个馈送文件，您可以利用单独的过程来存储和更新记录（存储），以禁用（删除）记录
使用单个馈送文件，您可以存储、更新和禁用（完全刷新）记录
利用文件组合，您可以用一种文件进行存储，用另一种文件进行禁用。

最后，这不是学生信息系统提要模式，但值得一提的是，您还可以使用 UI 中可用的<数据源管理>工具仅基于 DSK 禁用和删除。当以此方式管理 SIS 提供的数据时，应格外谨慎。当删除从未或不再通过学生信息系统提供的数据或测试作的结果时，这非常有用。

只是基础知识：课程

所有课程帐户都需要一组基本信息来建立帐户。要了解详情，请参阅快照平面文件数据格式和快照平面文件标题描述。

注意

如果您当前使用的是 UI 批处理工具，现在切换到使用 SIS 框架并使用最小课程数据，则 SIS 框架的 UI 上传功能可让您更好地记录和报告数据上传，而无需更改您的数据收集过程。

数据简介

在 Blackboard 中创建课程帐户所需的最少数据集或标题包括：

EXTERNAL_COURSE_KEY - 此课程记录的唯一标识符。

DATA_SOURCE_KEY- 记录中数据集的唯一标识符。注意：这是在源中或通过集成配置提供的）

COURSE_ID - 课程的 ID - 用作课程的唯一显示标识符。COURSE_NAME 课程标题。

每个集成配置的 SIS 框架提供非必填字段的默认值或忽略非必填字段。课程馈送非必填的两个有用字段为 AVAILABLE_IND 和 ROW_STATUS。以下使用案例中将对此进行介绍。

注意

快照平面文件标题描述对上述每个标题进行了详细介绍。

添加课程信息

添加课程信息有两种情况。第一种情况是额外存储课程信息，从而导致添加或更新记录，这会在数据馈送中相应显示。第二种是刷新 Blackboard 中已存在的 COURSE 信息，从而添加数据文件中显示的新记录或更新现有记录，同时禁用 COURSE 数据文件中不存在的现有 Blackboard 记录。

存储操作示例

示例 #1：创建课程

您希望在不影响现有帐户的情况下将课程添加到 BLACKBOARD。您已将集成配置为对所有传入数据使用相同的数据源。

先决条件

无。

最低数据馈送要求

EXTERNAL_COURSE_KEY

COURSE_ID

COURSE_NAME

解决方案

创建 COURSES.txt 数据文件，其中包含您希望添加到系统中的每门课程的必填标题和关联数据。例如：

EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME

testCourse1|Course.1.1.SP2013|Test Course 1

testCourse2|Course.2.1.SP2013|Test Course 2

testCourse3|Course.3.1.FA2013|Test Course 3

使用该 UI，利用存储操作，通过课程数据类型上传此文件。将创建课程帐户，您可以通过系统管理员课程工具对其进行查找。

后置条件

创建Course.1.1.SP2013、Course.2.1.SP2013和Course.3.1.FA2014的COURSE记录。

示例 #2：更新课程

您创建了课程帐户，现在需要对其进行更改。例如：上面的示例在课程名称中不包含该术语。

先决条件

无 - 现有课程将会更新，馈送中的所有新课程数据都将创建新课程。

解决方案

创建 COURSES.txt 数据文件，其中包含您希望更新到系统中的每门课程的必填标题和关联数据。例如：

EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME

testCourse1|Course.1.1.SP2013|Test Course 1 (SP2013)

testCourse2|Course.2.1.SP2013|Test Course 2 (SP2013)

注意

由于 STORE 仅对文件中包含的数据进行作，因此之前提交的 Course.3.1.FA2013 记录不受影响。

使用该 UI，利用存储操作，通过课程数据类型上传此文件。文件中的课程记录将会更新。

后置条件

Course.1.1.SP2013 和 Course.2.1.SP2013 的 COURSE 记录已更新，以在COURSE_NAME中包含该学期

Course.3.1.FA2014的课程记录不受影响。

课程：完成刷新课程作

警告

请注意，使用作完全刷新或按数据源完成刷新上传简短的更正文件可能会无意中导致许多课程意外禁用。为防止这种情况，我们不鼓励手动使用作类型完全刷新或按数据源完成刷新。默认情况下，这些选项在上传源文件页面上不可用。但是，如果同时启用这两个选项，请选中作类型下的复选框启用高级选项。

COMPLETE REFRESH操作方式不同于 STORE。完全刷新执行两项操作，相当于对馈送文件中的数据以及集成拥有 LEARN 中的记录进行比较 - 存储新记录、更新现有记录或禁用 LEARN 中不在数据文件中的记录。

示例：完全刷新

您的学生信息系统提供的数据包含应存在于 BLACKBOARD 中的课程的完整快照。此数据包含要添加的 COURSE 记录、要更新的 COURSE 记录以及自以前的 COMPLETE REFRESH作以来已删除的记录，这些作应根据配置（禁用或删除）进行适当处理。

先决条件

无。

最低数据馈送要求

EXTERNAL_COURSE_KEY

COURSE_ID

COURSE_NAME

解决方案

从我们第一个 COURSE 存储作的数据开始，将 Course.1.2.SP2013 添加到数据馈送中，并删除 Course.3.1.FA2013：

EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME

testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)

testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)

testCourse2|Course.2.1.SP2013|Test Course 2 (SP2013)

请注意，如果其他课程记录由此集成管理，则由于上述数据馈送中不存在，它们将被禁用或删除。

后置条件

Course.1.1.SP2013的 COURSE 记录将保留并更新，以将该部分包含在COURSE_NAME中

Course.1.2.SP2013的 COURSE 记录将添加到 Blackboard

Course.2.1.SP2013的课程记录将保留，不受影响。

Course.3.1.FA2013 的 COURSE 记录由于数据馈送中不存在，因此根据集成配置将其标记为已禁用或准备删除。

课程：按数据源完成刷新

警告

按数据源进行完全刷新会执行完全刷新操作，但会将受影响的数据限定为仅与集成的数据源相关联的数据。

示例：按数据源完成刷新

您的学生信息系统提供的数据包含应存在于 BLACKBOARD 中的课程的完整快照。此数据包含要添加的 COURSE 记录、要更新的 COURSE 记录以及自以前的 COMPLETE REFRESH作以来已删除的记录，这些作应根据配置（禁用或删除）进行适当处理。此外，使用集成中定义的同一数据源，作为刷新中的所有数据的目标，并且仅影响与此数据源密钥相关的数据。

先决条件

无。

最低数据馈送要求

EXTERNAL_COURSE_KEY

COURSE_ID

COURSE_NAME

解决方案

使用我们上次商店作的数据，并从数据馈送中删除 Course.2.1.SP2013：

EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME

testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)

testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)

后置条件

Course.1.1.SP2013 和 Course.1.2.SP2013 的 COURSE 记录将被保留，不受影响。

Course.2.1.SP2013的 COURSE 记录被标记为已禁用或准备根据集成配置进行删除。

如果其他课程记录由此集成管理，则它们不会因上述数据馈送中缺失而被禁用或删除，除非它们具有与集成指定的相同数据源。

课程可用性

警告

课程可用性设置允许将 LEARN 中的帐户设置为对学生可见（可用）或不可见（不可用）。请注意，这与禁用课程不同，这不仅使学生和教师无法使用该课程，还意味着该课程无法用于其他作，例如成员资格管理。添加此数据馈送标题不会影响上面演示的存储、完全刷新、按数据源进行完全刷新（用于创建课程记录）的用法。

注意，未提供可用性设置时，默认集成设置会应用于在创建/更新操作中可用的对象。

示例：课程帐户可用性

您的学生信息系统控制 LEARN 访问可用性，数据馈送指示用户的可用性设置，以控制他们何时有权访问 Blackboard，并且您希望在 PERSON 创建/更新时控制此访问设置。

先决条件

无。

最低数据馈送要求

EXTERNAL_COURSE_KEY

COURSE_ID

COURSE_NAME

AVAILABILITY_IND

解决方案

将AVAILABLE_IND标头添加到数据馈送中，并提供单个字符 Y 表示可用，提供 N 表示不可用。

后置条件

存储

仅更新 Course.1.1.SP2013 和 Course.1.2.SP2013 的 COURSE 记录（它们之前已创建）并创建 Course.5.1.FA2013。

完全刷新

更新 Course.1.1.SP2013 和 Course.1.2.SP2013 的 COURSE 记录（它们之前已创建）并创建 Course.5.1.FA2013。所有其他记录将被禁用或标记为删除，因为它们在上述数据馈送中不存在。

按数据源进行完全刷新

更新了 Course.1.1.SP2013 和 Course.1.2.SP2013 的 COURSE 记录（它们之前已创建），并创建了 Course.5.1.FA2013，并将可用性显式设置为 Y，从而使课程可用。

如果其他课程记录由此集成管理，则它们不会因上述数据馈送中缺失而被禁用或删除，除非它们具有与集成指定的相同数据源。按数据源进行完全刷新仅对集成数据源的记录进行操作。

禁用课程记录

在 Blackboard 中禁用 COURSE 记录将使所有用户都无法访问该记录（禁用状态将覆盖可用性设置），并且还使 UI作无法访问该记录 - 例如：您无法通过 UI 管理已禁用 COURSE 的大多数属性。系统管理员可以在系统管理面板中查看和重新启用已禁用的课程，否则：它通常是“不可见的”。此外，要从我的 Blackboard 中删除记录，必须首先禁用该记录。

注意

禁用记录并随后删除会从 Blackboard 中删除对该记录的所有引用 - 建议仅在您的业务和/或法律实践确定一段时间后删除禁用记录，否则可能需要活动记录。此外：由于无法访问残疾人课程，如果人们仍然需要访问，他们将咨询您的帮助台，并且会在为时已晚之前注意到持续的需求。

禁用记录可能遵循两种模型：通过 REFRESH作上的源数据排除来禁用，以及通过使用源头ROW_STATUS禁用。

重要

上述使用 REFRESH作的 COURSE作演示了通过排除“隐式”禁用，以下案例和示例通过使用 ROW_STATUS 演示了这一点。

示例：禁用课程记录

政策规定，您需要在 5 年后从 Blackboard 中完全删除课程。为了为此做好准备，您可以计划使用 ROW_STATUS 标头显式禁用课程一段时间。这确保没有人仍然依赖该课程，因为他们将无法再访问该课程。

先决条件

课程存在或课程将被创建，row_status 按数据馈送中的说明进行了设置。

最低数据馈送要求

EXTERNAL_COURSE_KEY

COURSE_ID

COURSE_NAME

ROW_STATUS

解决方案

将ROW_STATUS标头添加到数据馈送中，并提供 ENABLED表示已启用，为已禁用提供 DISABLED。

EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|ROW_STATUS

testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)|enabled

testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)|enabled

testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|disabled

后置条件

存储

仅创建或更新 Course.1.1.SP2013、Course.1.2.SP2013 和 Course.5.1.FA2013的 COURSE 记录，并显式更新ROW_STATUS。

完全刷新

Course.1.1.SP2013、Course.1.2.SP2013 和 Course.5.1.FA2013 的 COURSE 记录将创建或更新，并明确更新ROW_STATUS。由于上述数据馈送中不存在此集成拥有的所有其他课程记录将被禁用或标记为删除。

按数据源进行完全刷新

创建或更新Course.1.1.SP2013、Course.1.2.SP2013 和 Course.5.1.FA2013的 COURSE 记录，并显式更新ROW_STATUS。

课程合并

课程合并提供了在我的 Blackboard 中将课程的多个部分显示为单个课程的功能。这是通过以父子关系合并课程来实现的。父项会显示给参与该课程的用户，子区域/课程会采用成员身份等。然后，教师只需提供单个课程的内容，Blackboard 系统就会在课程标识符方面与学生信息系统保持配对，从而促进 Blackboard 和学生信息系统之间课程相关信息的通信。

示例：课程合并

英语系有四个入门级课程，每个课程都需要多个分区，以容纳所需的学生教师比率。他们希望为教师提供单个课程来管理其课程。

最低数据馈送要求

EXTERNAL_COURSE_KEY

COURSE_ID

COURSE_NAME

MASTER_COURSE_KEY

解决方案

将ROW_STATUS标头添加到数据馈送中，并提供 ENABLED表示已启用，为已禁用提供 DISABLED。

EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|MASTER_COURSE_KEY

testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)|

testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)|testCourse1

testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|

将 MASTER_COURSE_KEY 留空意味着该课程没有“父”课程，或者换个说法，该课程未与父课程合并。

后置条件

存储

仅创建或更新 Course.1.1.SP2013、Course.1.2.SP2013 和 Course.5.1.FA2013 的 COURSE 记录，从而在 Course.1.1.SP2013（父）和 Course.1.2.SP2013 之间建立父子关系。

完全刷新

创建或更新Course.1.1.SP2013、Course.1.2.SP2013和Course.5.1.FA2013的COURSE记录，从而在Course.1.1.SP2013（父）和Course.1.2.SP2013之间建立父子关系。由于上述数据馈送中不存在此集成拥有的所有其他课程记录将被禁用或标记为删除。

按数据源进行完全刷新

创建或更新Course.1.1.SP2013、Course.1.2.SP2013和Course.5.1.FA2013的COURSE记录，从而在Course.1.1.SP2013（父）和Course.1.2.SP2013之间建立父子关系。

课程模板

创建课程时可以使用课程模板，以便在外观、成绩簿、内容结构等方面提供一致性。使用模板创建的课程是该模板的一个镜像，课程数据馈送中显示的特定课程设置除外。您可以使用任何课程来用于此目的。

重要

模板仅在创建课程时使用。要创建课程，然后通过更新源提供模板，您可以通过设置系统管理员→ 学生信息系统集成 →（您的集成）⧩ → 高级配置 → 课程 ⧩ → 字段映射 →源课程复制密钥并选中更新时更改复选框（默认情况下未选中）来执行此作。

示例：课程模板

警告

数学系要求所有数学课程都具有相似的外观和感觉，具有相似的内容布局，并填充了一些核心内容。

先决条件

已创建课程框架，其中包含所需的内容、布局和设置。

最低数据馈送要求

EXTERNAL_COURSE_KEY

COURSE_ID

COURSE_NAME

TEMPLATE_COURSE_KEY

解决方案

将TEMPLATE_COURSE_KEY标题添加到数据馈送中，并提供代表模板的课程external_course_key。

EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|TEMPLATE_COURSE_KEY

testCourse1|Course.6.1.SP2013|Test Course 1.1 (SP2013)|testCourseTemplate.SP2013

testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|

将TEMPLATE_COURSE_KEY留空意味着该课程不需要模板。

后置条件

存储

仅创建或更新 Course.6.1.SP2013 和 Course.5.1.FA2013 的 COURSE 记录，使用 testCourseTemplate.SP2013 模板创建 Course.6.1.SP2013。

完全刷新

仅创建或更新 Course.6.1.SP2013 和 Course.5.1.FA2013 的 COURSE 记录，使用 testCourseTemplate.SP2013 模板创建 Course.6.1.SP2013。所有其他记录将被禁用或标记为删除，因为它们在上述数据馈送中不存在。

按数据源进行完全刷新

仅创建或更新 Course.6.1.SP2013 和 Course.5.1.FA2013 的 COURSE 记录，使用 testCourseTemplate.SP2013 模板创建 Course.6.1.SP2013。

如果其他课程记录由此集成管理，则它们不会因上述数据馈送中缺失而被禁用，除非它们具有与集成指定的相同数据源。按数据源进行完全刷新仅对集成数据源的记录进行操作。

完整示例

将上述标题组合成单个文件，我们可以一次解决大多数使用案例。

先决条件

为了使模板复制操作成功完成，要求先前一定没有创建过 testCourse8。

注意

为了保持服务器速度并防止不必要的数据库负载，可以在群集中并发运行的学生信息系统驱动的复制任务数量有限制。您可以在系统管理员→日志→系统任务状态中查看这些任务的状态

testCourse8|Course.8.SP2013|Test Course 8 (SP2013)|Y|ENABLED||testCourseTemplate.SP2013

testCourse9.1|Course.9.1.FA2013|Test Course 5.2 (FA2013)|Y|DISABLED||

后置条件

存储

仅创建或更新 Course.1.1.SP2013、Course.1.2.SP2013 和 Course.5.1.FA2013 的 COURSE 记录，结果如下：

所有课程的可用性都设置为 Y，表示课程可用。

Course.1.1.SP2013 和 Course.1.2.SP2013 设置为 ENABLED，而 Course.5.1.FA2013 设置为 DISABLED。

在 Course.1.1.SP2013（家长）和 Course.8.1.SP2013 和 Course.8.2.SP2013 之间建立父子关系。

创建Course.8.SP2013时，模板testCourseTemplate.SP2013中的内容和设置将复制到Course.8.SP2013中。

完全刷新

结果与存储作相同，但由于所有其他记录在数据馈送中不存在，因此将被禁用或标记为删除。

按数据源进行完全刷新

结果与商店作相同，但如果其他课程记录由此集成管理，则它们不会因上述数据馈送中缺失而被禁用，除非它们具有与集成指定的相同数据源。按数据源进行完全刷新仅对集成数据源的记录进行操作。

了解更多信息