Skip to main content

快照平面文件标题描述

通过快照平面文件,可以采用最新 LEARN 数据对象进行集成。下方完整列出了支持的对象、其 UI、馈送标题命名约定及、使用描述及数据要求。

因为数据馈送是一个文本文件,因此,所有数据都采用字符串表示。在某些情况下,需要注意特定格式设置和长度。如果字段要求,需提供支持的值。系统会突出显示并注明必填字段。

用户学习对象

LEARN 对象:用户

学生信息系统 对象:人员

默认插入/更新行为:智能插入或更新

默认删除行为:禁用

Learn 字段

批处理 UID(必填)

必需:是

唯一:是

标题:external_person_key

描述:组织用户的唯一标识符。这个 ID 由机构提供并且不向用户显示。

强烈建议对每个用户来说,密钥数据是永久、不更改的标识符。良好密钥的示例是在用户申请机构时所分配的永久学生 ID。请注意,数据库无法合并不同帐户之间的数据。

最大长度为 64。

数据源密钥(必填)由集成或数据文件提供。

必需:是

唯一:否

Header: data_source_key

描述:用于建立用户元素分组的键。请注意,此密钥可通过集成配置提供,因此无需在文件中提供。

最大长度:256。接受多字节字符。

Course View

必需:是

唯一:否

标题:firstname

描述:用户已被分配名称。

最大长度为 100。接受多字节字符。

姓氏(必填)

必需:是

唯一:否

标题:lastname

描述:用户的姓氏。

最大长度为 100。接受多字节字符。

用户名(必填)

必需:是

唯一:是

标题:user_id

描述:用户名用于登录 Blackboard。用户名必须是唯一的。

最大长度为 50。接受多字节字符。

姓名发音

必填:否

唯一:否

Header: course_experience

Description: Determines which course view will appear for new courses. This field is insert only and can't be updated through the SIS framework.

Supported values: Original, Ultra, or Instructor choice.

Organization View

Required: No

Unique: No

Header: classification_key

Description: This determines the classification (subject area and the discipline) of the course. This is an Id representing the primary key for the classification.

Max length 32. Multi byte characters accepted.

Domain Name

Required: No

Unique: No

Header: domain_name

Description: The hostname of the brand to be used in notification emails before the user logs in. The value must be one of the configured hostnames for the system. Invalid values are ignored without warning and user will be created with default hostname value. Set at insert only, updates are ignored. (format e.g. blackboard.college.edu college.blackboard.com)

Max length 450

可用

必填:否

唯一:否

标题:available_ind

描述:用户账户在用户界面中是否可用。如果设置为否,则用户帐户将对管理员和教师显示为灰色。用户将无法登录系统。值可以是“Y”(表示是),也可以是“N”(表示否)。

支持的值:“Y”、“N”。

Cross Listed Course Batch Uid

Required: No

Unique: No

Header: master_course_key

Description: Parent course EXTERNAL_COURSE_KEY of which this course is a child.

Max length: 64

Description

Required: No

Unique: No

Header: description

Description: Complete description of the Course.

Max length 4000. Multi-byte characters accepted.

Duration

Required: No

Unique: No

Header: duration

Description: This is to indicate if the duration of the course availability is continuous, date range, x days from enrollment, or term-dictated.

Options are:

Supported values: "C", "R", "D", "T"

必填:否

唯一:否

Header: pace

Description: Indicates if the Course is Instructor-led or self- paced according to the Student.

Supported values: "Self", "Instructor"

End Date

Required: No

Unique: No

Header: end_date

Description: Date on which access to the Course ends.

Format: yyyymmdd

Enforce Language Pack

Required: No

Unique: No

Header: locale_enforced

Description: A flag that determines if the language pack is enforced when a user accesses the Course. If the language pack is not enforced, the user may view the Course using their preferred language pack.

Supported values: 'Y','N'

Enrollment Access Code

Required: No

Unique: No

Header: enroll_access_code

Description: This is the access code for students to use when enrolling to the course.

Max length 50.

Institution Name

必填:否

唯一:是

Header: external_association_key

Description: The external key of the node with which the course should be primarily associated. The course uses that node's tool setting defaults to create its own settings. This is the same field as "external_association_key" from the Course Association feed; except this association is the "primary" one... meaning it will copy its Tool setting defaults on course creation.

The proper minimum required headers for creating courses that are meant to be associated with an Institutional Hierarchy node are:

代词

必填:否

唯一:否

Header: primary_external_node_key

Description: This is the same field as "external_node_key" from the Course Association feed; except this is the primary association.

The proper minimum required headers for creating courses that are meant to be associated with an Institutional Hierarchy node are:

性别

必填:否

唯一:否

标题:gender

描述:用户的性别。

支持的值:“未披露”、“男性”、“女性”

住宅电话

必填:否

唯一:否

标题:h_phone_1

描述:用户的家庭电话号码。

最大长度为 50。接受多字节字符。

住宅电话 (次要)

必填:否

唯一:否

标题:h_phone_2

描述:与用户关联的额外家庭电话号码。

最大长度为 50。接受多字节字符。

职位

必填:否

唯一:否

标题:job_title

描述:用户的相关职务名称。

最大长度为 100。接受多字节字符。

中间名

必填:否

唯一:否

标题:middlename

描述:用户将提供中间名。

最大长度为 100。接受多字节字符。

手机

必填:否

唯一:否

标题:m_phone

描述:用户的移动电话或呼机号码。

最大长度为 50。接受多字节字符。

曾用名

必填:否

唯一:否

标题:othername

描述:这是用户的备用首选姓名。

Max length: 256

密码加密类型

必填:否

唯一:否

标头:pwencryptiontype

描述:该字段确定用于对数据库密码进行加密的加密类型。

支持的值为:MD5、SSHA。

主要机构角色

必填:否

唯一:否

标题:institution_role

描述:用户的主要机构角色,决定用户对门户模块及其他项目的视图。

请参阅系统管理员面板中的“管理机构角色”,获取系统中有效机构角色的列表。

Replacement Batch Uid

Required: No

Unique: Yes

Header: new_external_course_key

Description: This field is used only on the rare occasions when a Course's or Organization's EXTERNAL KEY changes.

最大长度为 64。接受多字节字符。

替换数据源批处理 Uid

必填:否

唯一:否

Header: new_data_source_key

描述:新密钥用于建立用户元素的组。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意:替换数据源批处理 UID 的 UI 映射字段是“script.flatfile.UserReplacementDataSourceBatchUid”

行状态

必填:否

唯一:否

标题:row_status

说明:将记录的值设置为以下值之一:启用:对记录的正常访问。已禁用:记录在 UI 的某些区域可见,但可能无法更改或访问。已删除:计划删除记录。

支持的值:“enabled”、“disabled”、“deleted”

Max length 64. Multi byte characters accepted.

Start Date

Required: No

Unique: No

Header: start_date

Description: Date on which access to the Course section begins.

Format: yyyymmdd

Term

Required: No

Unique: No

Header: term_key

Description: Associated EXTERNAL_TERM_KEY

Max length 256.

Use Term Availability

Required: No

Unique: No

Header: use_term_availability_ind

Description: Flag to follow associated TERM for availability of course. If Y then the term for available_ind, startdate, and enddate are used; if N then the course settings are used.

Supported values: 'Y', 'N'

学生 ID

必填:否

唯一:否

标题:student_id

描述:通用标识符字段。这是一个仅显示字段。

最大长度为 100。接受多字节字符。

后缀

必填:否

唯一:否

标题:Suffix

描述:用户名称后缀。

最大长度为 100。接受多字节字符。

系统角色

必填:否

唯一:否

标题:system_role

描述:用户的管理员角色,描述其系统管理权限的级别。角色“无”不提供任何与自身关联的系统管理或课程创建权限,是最经常分配的角色。

系统接受以下字符串:

  • 用户管理员:“account_admin”、“accountadmin” 或 “user_admin” 系统支持:“system_support”或“syssupport”

  • System Support: "system_support" or "syssupport"

  • 课程创建者:“course_creator”或“creator”

  • 支持:“course_support”或“support”

  • 访客:"guest"

  • 无: "none"

  • 观察者:"observer"

  • 门户管理员:“portal_admin”或“portal”

  • 系统管理员:“sys_admin”、“system administrator”或“system_admin”

  • 电子商务管理员:“ecommerce_admin”

  • Card Office 管理员:“card_office_admin”

  • 商店管理员:“store_admin”

要创建用户自定义系统角色,请匹配管理员面板 > 系统角色中的“角色 ID”。如果未提供,则系统默认为无。

称谓

必填:否

唯一:否

标题:title

描述:用户偏好使用的头衔。

最大长度为 100。接受多字节字符。

网站

必填:否

唯一:否

标题:webpage

描述:用户个人网页的 URL(如果有的话)。

最大长度为 100

办公电话

必填:否

唯一:否

标题:b_Phone_1

描述:与用户关联的工作电话号码。

最大长度为 50。接受多字节字符。

工作电话 (次要)

必填:否

唯一:否

标题:b_phone_2

描述:与用户关联的其他工作电话号码。

最大长度为 50。接受多字节字符。

邮政编码

必填:否

唯一:否

标题:zip_code

描述:用户的邮政编码。

最大长度为 50。接受多字节字符。

LEARN 对象:课程/组织

学生信息系统 对象:课程或组织

默认插入/更新行为:智能插入或更新

默认删除行为:禁用

Learn 字段

批处理 UID(必填)

必需:是

唯一:是

Header: external_course_key.external_organization_key

Description: Short name used by the Institution to uniquely identify the Course or Organization section. This is not displayed to users. Can contain only letters, digits, dashes and periods. No spaces or other punctuation allowed. Must be unique for each Course and Organization, and is often the same as the COURSE_ID or ORGANIZATION_ID.

最大长度为 64。

课程 ID 或组织 ID(必填)

必需:是

唯一:是

标题:course_id 或 organization_id

描述:机构用来唯一标识课程或组织的简称(例如,math101_F99 或 ChessClub)不得使用以下字符:空格 ( ) & / ' +

最大长度为 100。必须是唯一的,且不可更改。

课程名称或组织名称(必填)

必需:是

唯一:否

标题:course_name/organization_name

说明:课程或组织的完整名称。此名称用于显示。

最大长度为 255。接受多字节字符。

数据源密钥(必填)由集成或数据文件提供。

必需:是

唯一:否

Header: data_source_key

描述:用于建立用户元素分组的键。请注意,此密钥可通过集成配置提供,因此无需在文件中提供。

最大长度:256。接受多字节字符。

Course View

必填:否

唯一:否

Header: course_experience

Description: Determines which course view will appear for new courses. This field is insert only and can't be updated through the SIS framework.

Supported values: Original, Ultra, or Instructor choice.

Organization View

Required: No

Required: No

Header: organization_experience

Description: Allows clients to select the experience they want to create their organization in. This field is insert only and can't be updated through the SIS framework.

Supported values: Original, Ultra, or Instructor choice.

classificationId

Required: No

Unique: No

Header: classification_key

Description: This determines the classification (subject area and the discipline) of the course. This is an Id representing the primary key for the classification.

Max length 450

hasDescriptionPage

必填:否

唯一:否

标题:desc_page_ind

描述:当前不支持该字段。集成不得使用此字段。

numDaysOfUse

Required: No

唯一:否

标题:days_of_use

描述:学生注册后可以访问课程的天数。对于自定进度的学习非常有用。仅在持续时间设置为“固定”且其描述课程在创建后可以使用的天数时,才能使用此值。

数字。例如:120.

serviceLevelType

必填:否

唯一:否

标题:服务水平

描述:通常不用于数据流。请忽略。

指定课程类型。

C = 社区 = 组织

F = 完整 = 课程

R = 已注册 =(不使用)

T = Test_Drive =(不使用)

S = 系统 = 功能受限的课程,用于保护组成课程的数据。

支持的值:“F”、“C”、“R”、“T”、“S”

允许访客

必填:否

唯一:否

标题:allow_guest_ind

描述:允许访客进入法庭。

支持的值:“Y”、“N”

允许旁听者

必填:否

唯一:否

页首:allow_observer_ind

描述:允许观察者进入赛道。

支持的值:“Y”、“N”

可用

必填:否

唯一:否

标题:available_ind

描述:用户账户在用户界面中是否可用。如果设置为否,则用户帐户将对管理员和教师显示为灰色。用户将无法登录系统。值可以是“Y”(表示是),也可以是“N”(表示否)。

支持的值:“Y”、“N”。

Cross Listed Course Batch Uid

Required: No

Unique: No

Header: master_course_key

Description: Parent course EXTERNAL_COURSE_KEY of which this course is a child.

Max length: 64

Description

Required: No

Unique: No

Header: description

Description: Complete description of the Course.

Max length 4000. Multi-byte characters accepted.

Duration

Required: No

Unique: No

Header: duration

Description: This is to indicate if the duration of the course availability is continuous, date range, x days from enrollment, or term-dictated.

Options are:

  • 连续式:“C”=课程始终可访问。

  • 范围:“R”=课程可在一START_DATE到END_DATE之间的几天内访问。要使课程从特定日期开始或在特定日期之前可供访问,可以相应地将结束日期或开始日期留为空白。

  • 持续时间:“D”= 注册后 N 天

  • 学期:“T”=学期口述(相关学期的持续时间控制本课程的持续时间)

Supported values: "C", "R", "D", "T"

教学进度

必填:否

唯一:否

Header: pace

Description: Indicates if the Course is Instructor-led or self- paced according to the Student.

Supported values: "Self", "Instructor"

End Date

Required: No

Unique: No

Header: end_date

Description: Date on which access to the Course ends.

Format: yyyymmdd

Enforce Language Pack

Required: No

Unique: No

Header: locale_enforced

Description: A flag that determines if the language pack is enforced when a user accesses the Course. If the language pack is not enforced, the user may view the Course using their preferred language pack.

Supported values: 'Y','N'

Enrollment Access Code

Required: No

Unique: No

Header: enroll_access_code

Description: This is the access code for students to use when enrolling to the course.

Max length 50.

注册结束日期

必填:否

唯一:否

标题:enroll_end

说明:不再提供学生注册日期。

格式:yyyymmdd

注册起始日期

必填:否

唯一:否

标题:enroll_start

说明:注册开始日期。

格式:yyyymmdd

注册类型

必填:否

唯一:否

标题:enroll_option

说明:确定注册方法。

支持的 value:“instructor”、“self”或“email”。

费用

必填:否

唯一:否

标题:成本

说明:与此课程或组织相关的费用。

数字 ,最多 11 个字符,包含 2 位小数。例如,1500.00

Institution Name

必填:否

唯一:否

标题:institution_name

描述:组织名称。

最大长度为 255。接受多字节字符。

语言包

必填:否

唯一:否

标题:位置

描述:首选语言包的标识符。该值可表示为 xx_XX,例如,法语语言包可用 fr_FR 表示

最大长度为 20。

已锁定

必填:否

唯一:否

页首:lockout_ind

说明:指示是否限制对课程或组织的访问。如果设置为“Y”,将根据 END_DATE 和 START_DATE 限制对课程或组织的访问。

支持的值:“Y”、“N”

最大磁盘使用量 (软性限制)

必填:否

唯一:否

标题:soft_limit

描述:课程配额有软限制。当课程文件夹存储达到指定的软限制 (soft limit) 且课程配额生效时,此设置会触发警告邮件。

数字。例如:10MB相当于10485760字节。

主要关联批处理 Uid

必填:否

唯一:是

Header: external_association_key

Description: The external key of the node with which the course should be primarily associated. The course uses that node's tool setting defaults to create its own settings. This is the same field as "external_association_key" from the Course Association feed; except this association is the "primary" one... meaning it will copy its Tool setting defaults on course creation.

The proper minimum required headers for creating courses that are meant to be associated with an Institutional Hierarchy node are:

  • external_course_key

  • course_id

  • course_name

  • external_association_key

  • primary_external_node_key

  • primary_external_node_key

  • Primary Node Batch Uid

必填:否

唯一:否

Header: primary_external_node_key

Description: This is the same field as "external_node_key" from the Course Association feed; except this is the primary association.

The proper minimum required headers for creating courses that are meant to be associated with an Institutional Hierarchy node are:

  • external_course_key

  • course_id

  • course_name

  • external_association_key

  • primary_external_node_key

Max length: 256

Replacement Batch Uid

Required: No

Unique: Yes

Header: new_external_course_key

Description: This field is used only on the rare occasions when a Course's or Organization's EXTERNAL KEY changes.

最大长度为 64。接受多字节字符。

替换数据源批处理 Uid

必填:否

唯一:否

Header: new_data_source_key

描述:新密钥用于建立用户元素的组。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意:替换数据源批处理 UID 的 UI 映射字段是“script.flatfile.UserReplacementDataSourceBatchUid”

行状态

必填:否

唯一:否

标题:row_status

说明:将记录的值设置为以下值之一:启用:对记录的正常访问。已禁用:记录在 UI 的某些区域可见,但可能无法更改或访问。已删除:计划删除记录。

支持的值:“enabled”、“disabled”、“deleted”

在目录中显示

必填:否

唯一:否

标题:catalog_ind

说明:确定课程或组织是否出现在课程目录中。

支持的值:“Y”、“N”

源课程复制密钥,源组织复制密钥

必填:否

唯一:否

标头:template_course_key.template_organization_key

描述:用于复制作业的内容源外部键。

Max length 64. Multi byte characters accepted.

Start Date

Required: No

Unique: No

Header: start_date

Description: Date on which access to the Course section begins.

Format: yyyymmdd

Term

Required: No

Unique: No

Header: term_key

Description: Associated EXTERNAL_TERM_KEY

Max length 256.

Use Term Availability

Required: No

Unique: No

Header: use_term_availability_ind

Description: Flag to follow associated TERM for availability of course. If Y then the term for available_ind, startdate, and enddate are used; if N then the course settings are used.

Supported values: 'Y', 'N'

LEARN 对象:课程和组织成员资格

注意

课程和组织需要相同的字段。标题将特定于正在创建的是课程还是组织,注意构建数据馈送时的区别。

学生信息系统 对象:课程或组织成员资格(注册和员工作业)

默认插入/更新行为:智能插入或更新

默认删除行为:禁用

Learn 字段

课程批次 UID 或组织批次 UID(必填)

必需:是

唯一:否

标题:external_course_key 或 external_organization_key

描述:这与用于标识课程或组织的密钥相同。

最大长度为 64。接受多字节字符。

数据源密钥(必填)由集成或数据文件提供。

必需:是

唯一:否

Header: data_source_key

描述:用于建立用户元素分组的键。请注意,此密钥可通过集成配置提供,因此无需在文件中提供。

最大长度为 256。接受多字节字符。

用户批处理 Uid(必填)

必需:是

唯一:否

标题:external_person_key

描述:这是用于标识用户的 external_person_key。

最大长度:64。接受多字节字符。

hasCartridgeAccess

必填:否

唯一:否

头部:hascartridgeaccess

说明:此字段不受支持,并且要删除。请忽略。新集成不得使用此字段,如果现有集成采用此字段,则应立即停止采用。

可用

必填:否

唯一:否

标题:available_ind

描述:在 Blackboard Learn 中建立注册可用性。

支持的值:“Y”、“N”

图像 URL

必填:否

唯一:否

标题:Image_URL

说明:此字段不受支持,并且要删除。请忽略。新集成不得使用此字段,如果现有集成采用此字段,则应立即停止采用。

包含在名册中

必填:否

唯一:否

标题:roster_ind

说明:指示用户是否显示在花名册中的标志。

支持的值:“Y”、“N”

引言

必填:否

唯一:否

标题:介绍

描述:课程中用户主页的介绍信息。

最大长度为 4000。接受多字节字符。

备注

必填:否

唯一:否

标题:批注

描述:与此用户相关的信息,可能会影响课程或组织参与。

不受限制。接受多字节字符。

个人信息

必填:否

唯一:否

标题:pinfo

描述:用户主页的个人信息。

不受限制。接受多字节字符。

主要教师

必填:否

唯一:否

标题:primary_instructor

描述:表示成员身份是主要讲师。成员必须是标记为“视为教师”的课程角色。如果成员不是教师或没有此标记,则不会显示此选项。如果在分配课程角色时该课程角色没有“视为教师”标记,则会拒绝成员记录中的 Y。

支持的值:“Y”、“N”

接收电子邮件

必填:否

唯一:否

标题:receive_email_ind

说明:标记是否为此用户启用了电子邮件。

支持的值:“Y”、“N”

替换数据源批处理 Uid

必填:否

唯一:否

Header: new_data_source_key

说明:用于建立数据元素分组的新键。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意:替换数据源批处理 UID 的 UI 映射字段为“script.flatfile.MemberReplacementDataSourceBatchUid”

角色

必填:否

唯一:否

标题:role

描述:用户在课程中的角色。

支持的值:"Instructor", "teaching_assistant", "course_builder", "Grader", "Student", "guest", "none"

行状态

必填:否

唯一:否

标题:row_status

说明:将记录的值设置为以下值之一:启用:对记录的正常访问。已禁用:记录在 UI 的某些区域可见,但可能无法更改或访问。已删除:计划删除记录。

支持的值:“enabled”、“disabled”、“deleted”

网站 1 描述

必填:否

唯一:否

Header: link_description_1

描述:用户网站的描述

最大长度为 255

网站 1 名称

必填:否

唯一:否

标题:link_name_1

描述:链接到用户网站时使用的名称

最大长度为 100

网站 1 URL

必填:否

唯一:否

标题:link_url_1

描述:用于链接到用户网站的 URL

最大长度为 100

网站 2 描述

必填:否

唯一:否

标题:link_description_2

描述:用户网站的描述

最大长度为 255

网站 2 名称

必填:否

唯一:否

标题:link_name_2

描述:链接到用户网站时使用的名称

最大长度为 100

网站 2 URL

必填:否

唯一:否

标题:link_url_2

描述:用于链接到用户网站的 URL

最大长度为 100

网站 3 描述

必填:否

唯一:否

标题:link_description_3

描述:用户网站的描述

最大长度为 255

网站 3 名称

必填:否

唯一:否

标题:link_name_3

描述:链接到用户网站时使用的名称

最大长度为 100

网站 3 URL

必填:否

唯一:否

标题:link_url_3

描述:用于链接到用户网站的 URL

最大长度为 100

LEARN 对象:术语

学生信息系统 对象:术语

默认插入/更新行为:智能插入或更新

默认删除行为:禁用

Learn 字段

批处理 UID(必填)

必需:是

唯一:是

标题:external_term_key

描述:机构用来唯一标识学期的简称。它不向用户显示。只能包含字母、数字、破折号和句点。不得使用空格或其他标点符号。

最大长度为 256。接受多字节字符。

数据源密钥(必填)由集成或数据文件提供。

必需:是

唯一:否

Header: data_source_key

描述:用于建立术语元素分组的键。请注意,此密钥可通过集成配置提供,因此无需在文件中提供。

最大长度为 256。接受多字节字符。

姓名(必填)

必需:是

唯一:否

标题:name

描述:术语的名称。

最大长度为 333

daysOfUse

必填:否

唯一:否

标题:days_of_use

描述:学生在注册后可以访问课程的天数。对于自定进度的学习非常有用。

数字。

可用

必填:否

唯一:否

标题:available_ind

描述:确定学期可用性。如果设置为“N”,则关联的对象将不可用。

支持的值:“Y”、“N”

描述

必填:否

唯一:否

标题:description

描述:术语描述

不受限制。

持续时间

必填:否

唯一:否

标题:duration

说明:计划学期可用性窗口。

选项包括:

  • 连续:该学期始终可访问。

  • 范围:学期在一个 START_DATE 与 END_DATE 之间的天数内有效。要使学期从特定日期开始(或在特定日期之前)有效,可以将结束日期(或开始日期)留为空白。

  • 固定:学期在一定天数内有效 (DAYS_OF_USE)。

支持的值:连续、范围、固定

End Date

必填:否

唯一:否

标题:end_date

说明:这是该学期停止可供访问的日期。

格式:yyyymmdd

Parent Term Batch Uid

Required: No

Unique: No

Header: external_parent_term_key

Description: The EXTERNAL_TERM_KEY representing the parent Term of which this Term is a child. Used to establish Term hierarchy relationships. If the value is "NONE", any existing parent Term association will be removed. Parent Term association is only supported for non-Annual Term types. If the Term type does not support a parent, the association is ignored. If the Term type is set to Annual or UNSPECIFIED, any existing parent Term association is removed. If the referenced parent Term does not exist or the association is invalid, the Term is still created or updated but the parent relationship is not applied.

Max length 256. Multi byte characters accepted.

Term Type

Required: No

Unique: No

Header: term_type

Description: Specifies the type of the Term.

Options are:

  • Annual: 'a' = Academic year or calendar-aligned term.

  • Semester: 's' = Standard academic semester.

  • Trimester: 't' = Three-term academic structure.

  • Quarter: 'q' = Four-term academic structure.

  • Intersession: 'i' = Short term between primary terms.

  • Module: 'm' = Sub-term within a larger term.

  • Unspecified: 'u' = Clears the Term type.

  • Supported values: "a", "s", "t", "q", "i", "m", "u"

替换批处理 Uid

必填:否

唯一:是

标题:new_external_term_key

说明:此字段仅在极少数情况下使用术语 EXTERNAL KEY 更改。

最大长度为 256。接受多字节字符。

替换数据源批处理 Uid

必填:否

唯一:否

Header: new_data_source_key

说明:用于建立数据元素分组的新键。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意:替换数据源批处理 UID 的 UI 映射字段为“script.flatfile.TermReplacementDataSourceBatchUid”

行状态

必填:否

唯一:否

标题:row_status

描述:将记录的值设置为以下值之一:

  • 已启用:对记录的正常访问。

  • 已禁用:记录在 UI 的某些区域可见,但可能无法更改或访问。

  • 已删除:计划删除记录。

支持的值:“enabled”、“disabled”、“deleted”

开始日期

必填:否

唯一:否

标题:start_date

说明:这是该学期开始可供访问的日期。

格式:yyyymmdd

LEARN对象:中学机构角色关联

学生信息系统 对象:用户二级机构角色

默认插入/更新行为:智能插入或更新

默认删除行为:禁用

Learn 字段

数据源密钥(必填)由集成或数据文件提供。

必需:是

唯一:否

Header: data_source_key

描述:用于建立用户元素分组的键。请注意,此密钥可通过集成配置提供,因此无需在文件中提供。

最大长度为 256。接受多字节字符。

辅助机构角色 ID(必填)

必需:是

唯一:否

标题:role_id

描述:此关联的辅助机构角色的标识符。

用户批处理 Uid(必填)

必需:是

唯一:否

标题:external_person_key

描述:用于此关联的用户 external_person_key (batch_uid)。

最大长度为 64。

替换数据源批处理 Uid

必填:否

唯一:否

Header: new_data_source_key

说明:用于建立数据元素分组的新键。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意:替换数据源批 UID 的 UI 映射字段为“script.flatfile.SecondaryInstRoleReplacementDataSourceBatchUid”

行状态

必填:否

唯一:否

标题:row_status

说明:将记录的值设置为以下值之一:启用:对记录的正常访问。已禁用:记录在 UI 的某些区域可见,但可能无法更改或访问。已删除:记录计划在未来由管理员手动删除。该行不会通过任务自动删除。

支持的值:“enabled”、“disabled”、“deleted”

学习对象:观察者协会

学生信息系统 对象:观察者协会

默认插入/更新行为:智能插入或更新

默认删除行为:禁用

Learn 字段

数据源密钥(必填)由集成或数据文件提供。

必需:是

唯一:否

Header: data_source_key

描述:用于建立用户元素分组的键。请注意,此密钥可通过集成配置提供,因此无需在文件中提供。

最大长度:256。接受多字节字符。

观察学生(必填)

必需:是

唯一:否

标题:external_user_key

描述:用于此关联的用户 external_person_key (batch_uid)。在机构中具有“学生”这个机构角色的某个用户的唯一标识符。这个 ID 由机构提供并且不向用户显示。

最大长度为 64。接受多字节字符。

观察者(必填)

必需:是

唯一:否

标题:external_observer_key

描述:用于此关联的旁听者 external_person_key (batch_uid)。在机构中具有“旁听者”这个系统角色的某个用户的唯一标识符。

最大长度为 64。接受多字节字符。

替换数据源批处理 Uid

必填:否

唯一:否

Header: new_data_source_key

说明:用于建立数据元素分组的新键。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意:替换数据源批处理 UID 的 UI 映射字段为“script.flatfile.AssociateObserverReplacementDataSourceBatchUid”。

行状态

必填:否

唯一:否

标题:row_status

说明:将记录的值设置为以下值之一:启用:对记录的正常访问。已禁用:记录在 UI 的某些区域可见,但可能无法更改或访问。已删除:计划删除记录。

支持的值:“enabled”、“disabled”、“deleted”

学习对象:类别

学生信息系统 对象:课程类别

默认插入/更新行为:智能插入或更新

默认删除行为:禁用

Learn 字段

dataSourceBatchUid(必填)

必需:是

唯一:否

Header: data_source_key

描述:用于建立类别元素分组的键。

接受多字节字符。

title (必填)

必需:是

唯一:否

标题:title

说明:类别的名称,因为它将在 UI 中向用户显示。

最大长度为 255。接受多字节字符。

批处理 UID(必填)

必需:是

唯一:是

标题:external_category_key

描述:必须是唯一的。请注意,此字段与 UI 中的“类别助记”字段相对应。

最大长度为 64。接受多字节字符。

描述

必填:否

唯一:否

标题:description

描述:类别描述。

frontPageInd

必填:否

唯一:否

标题:frontpage_ind

描述:确定类别是否显示在目录的首页上。

支持的值:“Y”、“N”

isAvailable

必填:否

唯一:否

标题:available_ind

描述:在 Blackboard Learn 中建立类别可用性。

支持的值:“Y”、“N”

isRestricted

必填:否

唯一:否

标题:restrict_ind

描述:标记课程或组织是否仅限于成员。

支持的值:“Y”、“N”

parentBatchUid

必填:否

唯一:否

标题:parent_category_key

描述:EXTERNAL_CATEGORY_KEY 表示这个子类别所属的父类别。

最大长度为 64。

rowStatus

必填:否

唯一:否

标题:row_status

说明:将记录的值设置为以下值之一:启用:对记录的正常访问。已禁用:记录在 UI 的某些区域可见,但可能无法更改或访问。已删除:计划删除记录。字符串。

支持的值:“enabled”、“disabled”、“deleted”

替换批处理 Uid

必填:否

唯一:是

标题:new_external_category_key

说明:指定当前密钥的替换。

最大长度为 64。接受多字节字符。

替换数据源批处理 Uid

必填:否

唯一:否

Header: new_data_source_key

说明:用于建立数据元素分组的新键。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意:替换数据源批处理 UID 的 UI 映射字段为“script.flatfile.CourseCatReplacementDataSourceBatchUid”

学习对象:主语

学生信息系统对象:实体

默认插入/更新行为:智能插入或更新

默认删除行为:禁用

学习领域:主题

批处理 UID(必需)

必需:是

唯一:是

标题:external_subject_key

描述:机构用于唯一标识该主题的简称。它不向用户显示。只能包含字母、数字、连字符和句点。不允许使用空格或其他标点符号。必须在所有学科、课程和机构中唯一,并且通常与 SUBJECT_ID 相同。

最大长度为 64。必须是唯一的。接受多字节字符。

主题 ID(必填)

必需:是

唯一:是

标题:subject_id

描述:机构用于唯一标识该主题的简称。该值必须遵循 {SubjectTitle}__{SubjectIdentifier} 格式,主题标题和标识符之间需连续两个下划线。主题标题仅可包含字母、数字、连字符(-)、句号(.)和下划线(_),主题标识符仅可包含字母和数字。以下字符不可使用:空格( )、&、.、/、'、+。例如:CHEM__abc123。

最大长度为 100。必须是唯一的,且不可更改。

主题名称(必填)

必需:是

唯一:否

标题:subject_name

描述:主题的全名。此名称用于显示。

最大长度为 255。接受多字节字符。

数据源密钥(必填)由集成或数据文件提供。

必需:是

唯一:否

Header: data_source_key

描述:用于确定主题元素分组的键。请注意,这可能由集成配置提供,因此文件中不需要。

最大长度:256。接受多字节字符。

可用

必填:否

唯一:否

标题:available_ind

说明:确定 Blackboard 的主题可用性。

支持的值:“Y”、“N”

描述

必填:否

唯一:否

标题:description

描述:主题的完整描述。

最大长度为 4000。接受多字节字符。

学科分类

必需:是

唯一:否

标题:subject_type

描述:用于表示该课程在学习管理系统中的课程分类。选项包括:

  • 本科:“U” = 表示本科水平的课程。

  • 研究生:“G” = 研究生水平课程。

  • 发展性课程:“D” = 学科指代发展性或补救性课程。

  • 本科不可转学分:“N” = 该学科代表不可转学分的本科课程。

  • 本科可转学分:“T” = 该学科代表可转移的本科课程。

  • 专业课程:“P”=学科表示专业或继续教育课程。

支持的值:“U”、“G”、“D”、“N”、“T”、“P”

替换批处理 Uid

必填:否

唯一:是

标题:new_external_subject_key

描述:该字段仅在极少数情况下使用,即当主体的外部密钥发生变化时。

最大长度为 64。必须是唯一的。接受多字节字符。

替换数据源批处理 UID。

必填:否

唯一:否

Header: new_data_source_key

描述:新键用于确定主体元素的分组。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意:用于替换数据源批处理 UID 的 UI 映射字段是“script.flatfile.SubjectReplacementDataSourceBatchUid”。

行状态

必填:否

唯一:否

标题:row_status

说明:将记录的值设置为以下值之一:启用:对记录的正常访问。已禁用:记录在 UI 的某些区域可见,但可能无法更改或访问。已删除:计划删除记录。

支持的值:“enabled”、“disabled”、“deleted”

学习对象:类别成员资格

学生信息系统 对象:类别成员资格

默认插入/更新行为:智能插入或更新

默认删除行为:禁用

Learn 字段

批处理 UID(必填)

必需:是

唯一:是

描述:自动填充。不在数据馈送中使用。

类别批处理 UID(必填)

必需:是

唯一:否

标题:external_category_key

描述:用于添加课程/组织的类别的外部密钥 (batch_uid)。

最大长度为 64。

课程批次 UID 或组织批次 UID(必填)

必需:是

唯一:否

标题:external_course_key

描述:external_organization_key 是进行分类的课程或组织的外部密钥 (batch_uid)。

最大长度为 64。

数据源密钥(必填)由集成或数据文件提供。

必需:是

唯一:否

Header: data_source_key

描述:用于建立用户元素分组的键。请注意,此密钥可通过集成配置提供,因此无需在文件中提供。

接受多字节字符。

可用

必填:否

唯一:是

标题:available_ind

描述:在 Blackboard Learn 中建立类别可用性。

支持的值:“Y”、“N”

替换数据源批处理 Uid

必填:否

唯一:否

Header: new_data_source_key

说明:用于建立数据元素分组的新键。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意:替换数据源批处理 UID 的 UI 映射字段为“script.flatfile.CourseCatMemReplacementDataSourceBatchUid”

行状态

必填:否

唯一:否

标题:row_status

说明:将记录的值设置为以下值之一:启用:对记录的正常访问。已禁用:记录在 UI 的某些区域可见,但可能无法更改或访问。已删除:计划删除记录。

支持的值:“enabled”、“disabled”、“deleted”

LEARN 对象:层次结构节点

学生信息系统 对象:层次结构节点

默认插入/更新行为:智能插入或更新

默认删除行为:清除

Learn 字段

这些是创建机构层次结构节点所需的相应最少标题:

  • external_node_key

  • data_source_key

  • parent_node_key

  • 名称

批处理 UID(必填)

必需:是

唯一:是

标题:external_node_key

描述:机构用于唯一标识层次结构节点的标识符。它不向用户显示。只能包含字母、数字、破折号和句点。不得使用空格或其他标点符号。

最大长度为 255。接受多字节字符。

数据源密钥(必填)由集成或数据文件提供。

必需:是

唯一:否

Header: data_source_key

描述:用于建立用户元素分组的键。请注意,此密钥可通过集成配置提供,因此无需在文件中提供。

最大长度为 255。接受多字节字符。

父批处理 UID(必需)

必需:是

唯一:否

标题:parent_node_key

描述:此节点的父 external_node_key (batch uid)。

最大长度为 64。

姓名(必填)

必需:是

唯一:否

标题:name

描述:节点名称

最大长度:255

描述

必填:否

唯一:否

标题:description

描述:节点的描述

最大长度:1000。

替换批处理 Uid

必填:否

唯一:是

标题:new_external_node_key

描述:此字段仅在极少数情况下使用节点的外部键更改。

最大长度为 255。必须是唯一的。接受多字节字符。

替换数据源批处理 Uid

必填:否

唯一:否

Header: new_data_source_key

说明:用于建立数据元素分组的新键。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意:替换数据源批处理 UID 的 UI 映射字段为“script.flatfile.NodeReplacementDataSourceBatchUid”

LEARN 对象:层次结构用户关联

学生信息系统 对象:用户关联

默认插入/更新行为:智能插入或更新

默认删除行为:清除

Learn 字段

将用户关联到机构层次结构节点所需的最少标题如下:

  • external_user_key

  • external_node_key

  • external_association_key

  • data_source_key

数据源密钥(必填)由集成或数据文件提供。

必需:是

唯一:否

Header: data_source_key

描述:用于建立用户元素分组的键。请注意,此密钥可通过集成配置提供,因此无需在文件中提供。

最大长度为 255。接受多字节字符。

批处理 UID(必填)

必需:是

唯一:是

标题:external_association_key

说明:关联 ID,它是用户与节点关联的唯一标识符。通常,用户批处理 UID 和节点批处理 UID 值的串联,以确保在可以将用户分配给多个节点时的唯一性。

最大长度为 64。

节点批处理 UID(必填)

必需:是

唯一:否

标题:external_node_key

说明:此关联的节点,也是节点标识符,可在 GUI 的“编辑节点”区域中找到

最大长度:64。

用户批处理 Uid(必填)

必需:是

唯一:否

标题:external_user_key

描述:将与此节点关联的用户 external_person_key (batch_uid)。

最大长度:64。

替换批处理 Uid

必填:否

唯一:是

标题:new_external_association_key

说明:此字段仅在极少数情况下使用关联的外部键更改。

最大长度为 64。接受多字节字符。

替换数据源批处理 Uid

必填:否

唯一:否

Header: new_data_source_key

说明:用于建立数据元素分组的新键。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意:替换数据源批处理 UID 的 UI 映射字段为“script.flatfile.UserAssociationReplacementDataSourceBatchUid”

LEARN对象:层次课程关联

学生信息系统 对象:课程关联

默认插入/更新行为:智能插入或更新

默认删除行为:清除

Learn 字段

将课程关联到机构层次结构节点所需的最少标题如下:

  • external_course_key

  • external_node_key

  • external_association_key

  • data_source_key

批处理 UID(必填)

必需:是

唯一:是

标题:external_association_key

描述:每个课程和节点关联必须具有标识此关系的唯一值。批处理 UID 是课程-节点关系的唯一标识符。

最大长度为 64。

课程批次 UID(必填)

必需:是

唯一:否

标题:external_course_key

描述:将与此节点关联的课程 external_course_key (batch_uid)。

最大长度为 64。

数据源密钥(必填)由集成或数据文件提供。

必需:是

唯一:否

Header: data_source_key

描述:用于建立元素分组的键。请注意,此密钥可通过集成配置提供,因此无需在文件中提供。

最大长度为 255。接受多字节字符。

节点批处理 UID(必填)

必需:是

唯一:否

标题:external_node_key

说明:此关联的节点。

最大长度为 64。接受多字节字符。

主要关联指标

必填:否

唯一:否

标题:is_primary_association

说明:当可以指定其他关联时,将此关联指定为主关联的标志。

支持的值:“Y”、“N”。

替换批处理 Uid

必填:否

唯一:是

标题:new_external_association_key

说明:此字段仅在极少数情况下使用关联的外部键更改。

最大长度为 64。接受多字节字符。

替换数据源批处理 Uid

必填:否

唯一:否

Header: new_data_source_key

说明:用于建立数据元素分组的新键。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意:替换数据源批处理 UID 的 UI 映射字段为“script.flatfile.CourseAssociationReplacementDataSourceBatchUid”

LEARN 对象:目标关联

学生信息系统 对象:目标关联

默认插入/更新行为:智能插入或更新

默认删除行为:清除

Learn 字段

批处理 UID(必填)

必需:是

唯一:是

标题:此字段没有标题,是自动填充字段。 请在集成馈送中忽略。

描述:课程与目标(标准)之间关系的唯一标识符。

最大长度为 64。

课程批次 UID(必填)

必需:是

唯一:否

标题:course_key

描述:将关联目的的课程的唯一标识符 (external_course_key)。

最大长度为 64。

数据源密钥(必填)由集成或数据文件提供。

必需:是

唯一:否

Header: data_source_key

描述:用于建立用户元素分组的键。请注意,此密钥可通过集成配置提供,因此无需在文件中提供。

最大长度为 255。接受多字节字符。

子目标集(必填)

必需:是

唯一:否

标题:std_sub_doc_key

描述:要关联到课程的目标(标准)的唯一标识符。

最大长度为 64。

替换数据源批处理 Uid

必填:否

唯一:否

Header: new_data_source_key

说明:用于建立数据元素分组的新键。使用指定替换数据源密钥指定的小组替换用于关联数据的现有数据源。注意:替换数据源批处理 UID 的 UI 映射字段为“script.flatfile.GoalAssociationReplacementDataSourceBatchUid”