字段定义方法
Note
本文档采用 AI 辅助机器翻译。译文仅供参考，不保证准确性；此内容的英文版为官方权威版本。
本页面介绍了可包含在成绩提取有效负载中的通用字段定义。应放在“数据值”字段中的实际字段定义位于每个“描述”单元格的底部。
课程字段
字段 | 描述 |
|---|---|
主键 | 课程的内部 Blackboard 标识符。该值是一个自动递增的整数，在创建课程时由 Blackboard 模式生成，通常在 Blackboard 之外没有任何意义。
|
外部课程键 | 非面向用户的唯一标识符，一般通过快照或类似集成填充。如果某个课程是通过 GUI 创建的，则“外部课程密钥”将与“课程 ID”匹配。此字段也称为批处理 UID。
|
分类 | 此课程分类的标题。
|
课程 ID | 课程的唯一且面向用户的标识符。
|
可用性 | 如果课程记录可用，则为“Y”；如果不可用，则为“N”。
|
类型 | 普通课程为“FULL”，组织为“COMMUNITY”。内部课程可能存在其他值，例如“SYSTEM”;但是，这些课程的成绩将不存在。
|
创建日期 | 创建课程的日期。
|
修改日期 | 上次修改课程的日期。请注意，这仅指对课程记录本身的修改，不涉及任何内容、作业等。
|
称谓 | 课程面向用户的标题或“课程名称”。
|
类别 ID | 课程的所有课程类别 ID（如果有）的分隔列表。子分隔符在提取属性中配置。示例（假设管道子分隔符）： 数学|代数
|
类别名称 | 课程的所有课程类别名称（如果有）的分隔列表。子分隔符在提取属性中配置。示例（假设管道子分隔符）： 数学|代数
|
用户字段
字段 | 描述 |
|---|---|
主键 | 用户的内部 Blackboard 标识符。此值是创建用户时由我的 Blackboard 架构生成的自动递增整数，通常在我的 Blackboard 之外没有意义。
|
外部人员密钥 | 非面向用户的唯一标识符，一般通过快照或类似集成填充。如果通过 GUI 创建用户，则“外部人员密钥”将与“用户 ID”匹配。此字段也称为批处理 UID。
|
办公电话 1 | 用户的主要办公电话。
|
办公电话 2 | 用户的次要办公电话。
|
公司 | 用户所在的公司。
|
国家 | 用户地址所在的国家/地区。
|
部门 | 用户所在的部门。
|
电子邮件 | 用户的电子邮件地址。
|
姓氏 | 用户的姓或“姓氏”。
|
名字 | 用户的名字。
|
住宅电话 1 | 用户的主要住宅电话。
|
住宅电话 2 | 用户的次要住宅电话。
|
可用性 | 如果用户记录可用，则为“Y”；如果不可用，则为“N”。
|
职位名称 | 用户的职位。
|
上次登录日期 | 用户上次成功登录系统的日期。如果用户从未登录过，则此值将为空。
|
中间名 | 用户的中间名。
|
移动电话 | 用户的手机号码。
|
学生 ID | 用户记录的学生 ID 属性。并不是说不能保证这个值在系统中是唯一的。只有用户名和外部人员密钥是保证的唯一字段。
|
称谓 | 用户称谓。例如：Mrs. Dr.
|
用户 ID | 用户的唯一且面向用户的标识符。也称为用户名。
|
机构角色 ID | 用户所有机构角色 Id 的列表，以冒号分隔。主角色 ID 将排在第一位，然后是该用户的所有辅助角色 ID（如果有）。 Staff:Observer:Role_13
|
机构角色名称 | 用户所有机构角色名称的列表，以冒号分隔。主要角色名称将排在前面，然后是该用户的所有辅助角色名称（如果有）。 Staff:Observer:Role 13
|
主要机构角色 ID | 用户的主要机构角色的 ID。
|
主要机构角色名称 | 用户的主要机构角色的名称。
|
次要机构角色 ID | 用户的所有次要角色 ID（如果有）的列表，以冒号分隔。 Observer:Role_13
|
次要机构角色名称 | 用户所有次要角色名称（如果有）的列表，以冒号分隔。 Observer:Role 13
|
系统角色 ID | DEFAULT 域中用户所有系统角色 ID 的列表，以冒号分隔。主系统角色 ID 将排在第一个位置，然后是该用户的所有辅助系统角色 ID（如果有）。 N：U：C
|
系统角色名称 | DEFAULT 域中用户的所有系统角色名称的列表，以冒号分隔。主系统角色名称将排在前面，然后是该用户的所有辅助系统角色名称（如果有）。 无：UserAdministrator：课程管理员
|
主要系统角色 ID | 用户的主要系统角色的 ID。
|
主要系统角色名称 | 用户的主要系统角色的名称。
|
次要系统角色 ID | 用户在 DEFAULT 域中的所有次要系统角色 ID（如果有）的列表，以冒号分隔。 U：C
|
次要系统角色名称 | 用户在 DEFAULT 域中的所有次要系统角色名称（如果有）的列表，以冒号分隔。 用户管理员：课程管理员
|
成绩字段
本部分中的字段用于在 Blackboard Learn 成绩中心的特定项目（或列）上访问与学生的成绩相关的信息。
字段 | 描述 |
|---|---|
主键 | 成绩的内部 Blackboard 标识符。此值是创建用户时由我的 Blackboard 架构生成的自动递增整数，通常在我的 Blackboard 之外没有意义。
|
尝试成绩 | 针对注册的可评分项目的最新尝试所取得的可视成绩。如果成绩不是作业或评估，则只有一次尝试。
|
尝试分数 | 针对注册的可评分项目的最近一次尝试所取得的分数（含小数）。
|
尝试日期 | 创建尝试的日期。对于评估和作业，这是学生创建项目的日期。对于手动输入的成绩（即直接在成绩中心电子表格中输入），这是教师提供成绩的日期。请注意，这不应与讲师输入的覆盖日期混淆，后者是不同的字段。
|
尝试状态 | 尝试状态的数字表示形式：
|
手动评分 | 学生的手动覆盖成绩的显示值。如果未手动覆盖成绩，则此值将为空。
|
手动分 | 学生的手动覆盖成绩的分数（含小数）。如果未手动覆盖成绩，则此值将为空。
|
显示成绩 | 显示在成绩中心中的成绩值。此值考虑了多次尝试和手动覆盖的成绩。在大多数情况下，这是要包含在数据提取中的值。
|
显示分数 | 成绩中心中成绩的分数值（含小数）。此值考虑了多次尝试和手动覆盖的成绩。在大多数情况下，这是要包含在数据提取中的值。
|
免除指示器 | 如果成绩已被教师免除，则为“Y”，否则为“N”。
|
空成绩指示器 | 如果成绩不存在，则为“Y”，否则为“N”。
|
手动/覆盖成绩指示器 | 如果成绩已被教师手动覆盖，则为“Y”；否则为“N”。
|
覆盖日期 | 教师覆盖成绩的日期。请注意，这与通过成绩中心电子表格手动分配的成绩不同，而是指定（添加或更新）实际覆盖成绩的日期。
|
成绩中心项字段
本部分的字段适用于成绩中心的项（或列）。
字段 | 描述 |
|---|---|
主键 | 可评分项的内部 Blackboard 标识符。此值是创建用户时由我的 Blackboard 架构生成的自动递增整数，通常在我的 Blackboard 之外没有意义。
|
外部成绩指示器 | 如果该项是课程的外部成绩，则为“Y”，否则为“N”。请注意，每门课程只能有一个项目标记为外部成绩。
|
显示描述 | 可评分项的面向用户的描述。
|
显示列名 | 显示列名是 Blackboard 成绩中心的必填值，除非提供了显示标题，否则最终用户将看到该值。
|
满分 | 十进制数字，表示可评分项的满分分数。
|
显示标题 | 显示标题不是必填项；但是，如果为成绩中心的某个项目提供了显示标题，那么最终用户看到的将是该标题，而不是“显示列名”。
|
成员字段
字段 | 描述 |
|---|---|
主键 | 注册的内部 Blackboard 标识符。此值是创建用户时由我的 Blackboard 架构生成的自动递增整数，通常在我的 Blackboard 之外没有意义。
|
可用性 | 如果注册记录可用，则为“Y”；如果不可用，则为“N”。
|
注册日期 | 用户注册课程的日期。请注意，如果集成未显式提供注册日期，则此值可能为 null。
|
修改日期 | 上次修改注册记录的日期。
|
上次访问日期 | 用户上次访问课程的日期。如果用户尚未访问课程，则此值将为 null。
|
静态数据字段
字段 | 描述 |
|---|---|
静态值 | 允许在列映射中包含静态内容，其中 XXX 是要包含的静态内容的值。 该字段允许在静态值中包含特殊字符。特殊字符需要配置为其编码值。例如： PROCESSSTATUS=：：static：：I%7C 将在提取文件中写入值“I|”，列标题为 PROCESSSTATUS。
|
特殊派生值
本部分中的字段是特殊字段，其值来源于其他字段。
字段 | 描述 |
|---|---|
Grade.PERCENTAGE_SCORE | 只有在可以计算的情况下，此值才会包含所得分数除以可能获得的分数。如果无法计算该值，则为 ERROR。 |
Grade.LETTER_GRADE | 只有出现字母时，该值才会成为模式值。否则，它将为空白。 |
Item.EXTERNAL_SEQNUM | 此值将是外部序列映射中指定的值。 |
User.OPTIONAL_DATA:XXX | 此值将是 XXX 中指定的用户注册可选数据的值。 例如：如果入站预配将可选数据字段 COHORT 与用户注册数据一起传递，则要包含在数据提取中的实现将为： User.OPTIONAL_DATA: COHORT |
Grade.OPTIONAL_DATA:XXX | 此值将是 XXX 中指定的成绩可选数据的值。 例如：如果入站预配将可选数据字段学期与可评分项一起传递，则要包含在数据提取中的实现将为： Grade.OPTIONAL_DATA:PartTerm |
Grade.getCategoryName | 此值将作为成绩类别名称（如“作业”）。 |
User.EXTRACTOR_BATCH_UID | 此值将是批准提取的用户的 batch_uid。 |
User.EXTRACTOR_USER_ID | 此值将是批准提取的用户的用户 ID。 |
User.EXTRACTOR_FULLNAME | 此值将是批准提取的用户的全名。 |
User.EXTRACTOR_EMAIL | 此值将是批准提取的用户的电子邮件地址。 |
User.GRADER_FULLNAME | 此值将是可评分项目的最后一个评分者的全名。 |
User.GRADER_EMAIL | 此值将是可评分项目的最后一个成绩者的电子邮件。 |
Course.TERM_CODE | 此值将是与课程区域相关联的学期的名称。 |
X::regEx:Y | 该值将是 Y 为字段 X 指定的正则表达式的结果。 例如：Course.get批Uid：：regEx：^.*？_（.*？） 其中课程批_uid为 202210_12345 将返回 12345 |
Grade.getPostedDate | 此值将是发布日期（对于 Ultra 课程）。 |
Term.getSourceId | 此值将是与课程相关联的学期的源 ID。 |